‫15.05.27.00 - یادداشت‌های انتشار «درگاه خدمات توسعه‌دهنده Apigee»

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

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

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

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

ویژگی‌های جدید

دردسترس عموم بودن SmartDocs

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

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

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

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

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

اگر قبلاً در دوره بتا از «سندهای هوشمند» استفاده کرده‌اید، ویژگی‌ها و قابلیت‌های جدید در نسخه دردسترس عمومی نیازمند این است که «سندهای هوشمند» را در درگاه توسعه‌دهنده ارتقا دهید.

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

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

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

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

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

اشکالات رفع شد

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

شناسه مشکل شرح
DEVSOL-487 قالب روز در «درآمدزایی» باید توسط سرپرستان پیکربندی شود
قالب تاریخ اکنون در «درآمدزایی» در تنظیمات درآمدزایی برای قالب‌های تاریخ اروپایی و ایالات متحده قابل پیکربندی است.
DEVSOL-603 صفحه «طرح تعارض» قالب‌بندی ضعیفی دارد
هنگام خرید طرحی که با طرح موجود هم‌پوشانی دارد، صفحه‌ای که نشان داده می‌شود اکنون به‌خوبی برای کاربر قالب‌بندی شده است.
DEVSOL-642 پیکربندی‌های سطح مشتری را از تنظیمات امنیتی به تنظیمات الگو منتقل کنید
DEVSOL-709 SmartDocs: پارامتر الگوی نشانی وب پس‌از ارسال درخواست با مقدار خالی قابل‌ویرایش نیست
این مشکل را برطرف می‌کند که باعث می‌شود پارامترهای الگو پس‌از ارسال درخواست از SmartDocs پس‌از حذف پارامتر الگو در مستندات روش، غیرقابل‌ویرایش شوند.
DEVSOL-1013 نشانی‌های ایمیل کاربر «درگاه توسعه‌دهندگان» را قابل‌ویرایش کنید
فیلد نشانی ایمیل در صفحه ویرایش نمایه دیگر غیرفعال نخواهد بود و توسعه‌دهندگان می‌توانند نشانی‌های ایمیل خود را تغییر دهند.
DEVSOL-1273 «DevConnect Mint» دوبار در فهرست «واحدها» نشان داده می‌شود
در بخش «واحدها»، «Dev Connect Mint» دوبار نمایش داده می‌شد. اکنون این مشکل رفع شده است.
DEVSOL-1313 پشتیبانی از وارد کردن فایل JSON/YAML یا نشانی وب برای Swagger و WADL
اکنون می‌توان فایل‌های WADL را ازطریق نشانی وب وارد کرد و فایل‌های Swagger را بارگذاری کرد.
DEVSOL-1339 تغییر مکان‌های منو «سرپرست SmartDocs»
‫SmartDocs اکنون در منو محتوا قرار دارد و تنظیمات smartdocs در منو سرپرست تنظیمات قرار دارد.
DEVSOL-1340 حذف نسخه بتا هنگام رفتن به GA
‫SmartDocs اکنون در منو محتوا قرار دارد و تنظیمات smartdocs در منو سرپرست تنظیمات قرار دارد.
DEVSOL-1390 کتابخانه PHP SDK Edge به‌روزرسانی شده است تا مشکل فراخوانی __toString()‎
کتابخانه PHP SDK Edge به‌روزرسانی شده است تا مشکل فراخوانی __toString()‎ در شیء DeveloperRatePlan را که این خطا را ایجاد می‌کند برطرف کند: {quote} خطای مهلک: فراخوانی تابع عضو format()‎ در غیرشیء در /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php در خط ۲۲۱ {quote} این اشکالی است که فقط مشتریان «درآمدزایی» را که کد سفارشی دارند و روش toString()‎ را فراخوانی می‌کنند تحت تأثیر قرار می‌دهد.
DEVSOL-1398 «مدل فروشگاه حیوانات خانگی SmartDocs» هنگام نصب بدون درخواست از کاربر وارد می‌شود
اکنون SmartDocs نمونه swagger فروشگاه حیوانات خانگی را درطول نصب سایت (http://petstore.swagger.io/v2/swagger.json) به‌جای مدل آب‌وهوا وارد می‌کند تا نمونه جامع‌تری از استفاده از SmartDocs داشته باشد.
DEVSOL-1407 وقتی توسعه‌دهندگان زیادی وجود داشته باشد، Cron ناموفق می‌شود
هنگام اجرای Drupal cron، تعداد زیاد توسعه‌دهندگان باعث بروز مشکل مهلت زمانی شد. وقتی سازمانی بیش‌از ۲۰۰ کاربر داشته باشد، اکنون از فرایند دسته‌ای استفاده می‌شود.
DEVSOL-1470 ایجاد پیوند منو «میاناهای برنامه‌سازی کاربردی» و نمای مربوطه
«اسناد هوشمند» در «درگاه توسعه‌دهندگان» اکنون به‌طور پیش‌فرض با پیوندی به اسناد هوشمند ارائه‌شده در منو اصلی با نام «میاناهای برنامه‌سازی کاربردی» ارائه می‌شود که به هر مدلی با روش‌های منتشرشده پیوند می‌دهد.

مشکلات شناخته‌شده

این نسخه شامل مشکلات شناخته‌شده زیر است:

شناسه مشکل شرح
DEVSOL-1558
صفحه‌های روش «مستندات هوشمند نمونه Petstore» در نصب جدید به‌درستی پرداز نمی‌شود
صفحه‌های روش Petstore نمونه در SmartDocs در نصب جدید به‌درستی پرداز نمی‌شود. برای رفع این مشکل:
  1. در منو Drupal، محتوا > SmartDocs را انتخاب کنید.
  2. مدل «نمونه فروشگاه حیوانات خانگی» را انتخاب کنید.
  3. در بخش به‌روزرسانی گزینه‌ها، گره‌های پردازش و انتشار را انتخاب کنید.
  4. برای انتخاب همه گره‌ها، روی چارگوش انتخاب انتخاب / لغو انتخاب همه کلیک کنید.
  5. روی به‌روزرسانی کلیک کنید.

اکنون گره‌ها باید به‌درستی پرداز شوند.