15.05.27 - یادداشت های انتشار ابر Apigee Edge

شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات

در روز سه‌شنبه، ۲ ژوئن ۲۰۱۵، نسخه ابری جدیدی از Apigee Edge را منتشر کردیم.

اگر سوالی دارید، با پشتیبانی Apigee Edge تماس بگیرید.

برای مشاهده‌ی فهرستی از تمام یادداشت‌های انتشار Apigee Edge، به یادداشت‌های انتشار Apigee مراجعه کنید.

ویژگی‌ها و پیشرفت‌های جدید

در ادامه به ویژگی‌ها و بهبودهای جدید این نسخه اشاره خواهیم کرد.

دسترسی عمومی به SmartDocs

SmartDocs در حال گذر از مرحله بتا به نسخه عمومی است. به‌روزرسانی‌ها و ویژگی‌های جدید عبارتند از:

• پشتیبانی از Swagger 2.0، شامل وارد کردن از طریق فایل یا URL، شامل پشتیبانی از اشیاء امنیتی با نام سفارشی.
• بهبود طراحی بصری در قالب‌هایی که SmartDocs را تولید می‌کنند.
• بهبودهای قابلیت استفاده و گردش کار در پورتال توسعه‌دهندگان، که از طریق منوی محتوا > اسناد هوشمند در دروپال قابل دسترسی است.
• آنچه که پیش از این به عنوان احراز هویت «توکن سفارشی» شناخته می‌شد، اکنون «کلید API» نامیده می‌شود.
• اشیاء «امنیتی» احراز هویت که در سطح ویرایش تعریف شده‌اند.
• پیکربندی احراز هویت کلاینت در سطح الگو. نسخه‌های جدید دیگر هیچ یک از اعتبارنامه‌های کلاینت SmartDocs از پیش پیکربندی‌شده را بازنشانی نمی‌کنند.

برای توضیحات بیشتر در مورد ویژگی‌ها، به این پست وبلاگ مراجعه کنید.

برای مستندات SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.

ویرایشگر پروکسی API جدید بتا

نسخه بتای جدیدی از ویرایشگر پروکسی API در دسترس است. برای دسترسی، هنگام ویرایش یک پروکسی API موجود، روی پیوند «دسترسی به نسخه بتا» کلیک کنید. می‌توانید بین ویرایشگرهای «کلاسیک» و «بتا» جابه‌جا شوید.

سیاست جدید OAuthV2

سیاست جدید DeleteOAuthV2Info به شما امکان می‌دهد کدهای مجوز و توکن‌های دسترسی را حذف کنید. برای اطلاعات بیشتر، به سیاست Delete OAuthV2 Info مراجعه کنید.

موجودیت‌های جدید در سیاست موجودیت‌های دسترسی

سیاست موجودیت دسترسی، دسترسی به موجودیت‌های جدید زیر را فراهم می‌کند: consumerkey-scopes، authorizationcode، requesttoken و verifier. برای اطلاعات بیشتر، به سیاست موجودیت دسترسی مراجعه کنید.

نمایش گواهی‌های SSL که نزدیک به انقضا هستند

صفحه گواهینامه‌های SSL در رابط کاربری مدیریت (Admin > SSL Certificates) نشان می‌دهد که گواهینامه‌های SSL بسته به انتخاب شما در فیلد کشویی جدید انقضا، چه زمانی در عرض 10، 15، 30 یا 90 روز منقضی می‌شوند.

نام برنامه توسعه‌دهنده در رابط کاربری مدیریت نمایش داده می‌شود

برنامه‌های توسعه‌دهنده در اج هم یک نام داخلی دارند که تغییر نمی‌کند و هم یک نام نمایشی که می‌توانید آن را تغییر دهید. در صفحه برنامه توسعه‌دهنده در رابط کاربری مدیریت (Publish > Developer Apps > app name)، «نام» داخلی برنامه به همراه «نام نمایشی» نمایش داده می‌شود و شناسایی بصری برنامه‌ها را با نام‌های داخلی آنها برای عیب‌یابی و مدیریت API آسان‌تر می‌کند.

نسخه کلاسیک گزارش‌های سفارشی از رابط کاربری مدیریت حذف می‌شود

نسخه کلاسیک اختیاری گزارش‌های تحلیلی سفارشی دیگر در رابط کاربری مدیریت موجود نیست.

فرآیند ارتقاء SmartDocs

اگر در طول دوره بتا از SmartDocs استفاده می‌کردید، برای دسترسی به ویژگی‌ها و قابلیت‌های جدید در نسخه عمومی، باید SmartDocs را در پورتال توسعه‌دهندگان خود ارتقا دهید.

هر صفحه SmartDocs که قبلاً در پورتال توسعه‌دهندگان شما منتشر شده است، به کار خود ادامه خواهد داد، اما قبل از ویرایش یا انتشار هرگونه تغییر در صفحات موجود یا جدید، باید روند به‌روزرسانی را دنبال کنید.

به خاطر داشته باشید که اگرچه می‌توانید SmartDocs را درون پورتال توسعه‌دهندگان خود رندر و منتشر کنید، SmartDocs از مدل API تولید می‌شوند که درون سرویس‌های مدیریت API Edge شرکت Apigee قرار دارد. هر تغییری که در یک مدل API در Edge ایجاد کنید، در تمام محیط‌های Pantheon شما یکسان خواهد بود (مشابه نحوه حضور توسعه‌دهندگان در محیط‌های Pantheon).

برای ارتقا از نسخه بتای SmartDocs به نسخه عمومی

1. نسخه ۱۵.۰۵.۲۷ را در محیط‌های توسعه یا آزمایش خود در Pantheon به‌روزرسانی و آزمایش کنید.
2. یک مدل جدید ایجاد کنید تا جایگزین هر مدل API موجودی شود که قبلاً استفاده می‌کردید.
   • اگر اسناد Swagger یا WADL را وارد کرده‌اید، دوباره آنها را به یک نسخه جدید وارد کنید.
   • اگر مدل API خود را از طریق ماژول SmartDocs نگهداری می‌کردید، آن را به صورت SmartDocs JSON خروجی بگیرید و با استفاده از پیوست فایل، به مدل جدید خود وارد کنید.
3. ویژگی‌های امنیتی نسخهٔ اصلاح‌شدهٔ مدل خود را تنظیم کنید. در صفحهٔ «محتوا > اسناد هوشمند > مدل» ، «تنظیمات امنیتی» را انتخاب کنید.
   
4. با کلیک روی تنظیمات در ستون عملیات، هرگونه احراز هویت از پیش پیکربندی شده را در صفحه تنظیمات مدل ( محتوا > اسناد هوشمند ) بررسی کنید.
   
5. هرگونه قالب سفارشی را برای استفاده از نسخه ۶ از دارایی‌های CSS و JS به‌روزرسانی کنید و تغییراتی ایجاد کنید تا نام‌های جدید اشیاء، مانند authSchemes و apiSchema، را منعکس کند. برای اطلاعات بیشتر در مورد به‌روزرسانی قالب‌های SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.
6. نسخه اصلاح‌شده مدل خود را دوباره رندر و منتشر کنید.
7. پس از تأیید مستندات جدید، پورتال تولید خود را به نسخه 15.05.27 به‌روزرسانی کنید.

اگر شما مشتری سازمانی Edge هستید و در مورد فرآیند ارتقا سؤال یا نگرانی دارید، لطفاً به آدرس‌های marsh@apigee.com و cnovak@apigee.com ایمیل بزنید. در غیر این صورت، لطفاً برای بهترین پاسخ از انجمن Apigee استفاده کنید.

اشکالات برطرف شد

اشکالات زیر در این نسخه برطرف شده‌اند.