15.05.27.00 - یادداشت‌های انتشار پورتال خدمات توسعه‌دهنده Apigee

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

در روز سه شنبه، 2 ژوئن 2015، نسخه ابری جدید پورتال خدمات توسعه دهنده Apigee را منتشر کردیم.

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

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

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

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

SmartDocs از نسخه بتا به در دسترس بودن عمومی فارغ التحصیل می شود. به روز رسانی ها و ویژگی های جدید عبارتند از:

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

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

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

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

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

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

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

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

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

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

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

اشکالات زیر در این نسخه رفع شده است.

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

مسائل شناخته شده

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

شناسه شماره توضیحات
DEVSOL-1558
Petstore مثال صفحات روش SmartDocs در نصب جدید به درستی ارائه نمی شوند
نمونه صفحات روش Petstore در SmartDocs در نصب جدید به درستی ارائه نمی شود. برای رفع این مشکل:
  1. Content > SmartDocs را در منوی Drupal انتخاب کنید.
  2. مدل "Petstore Example" را انتخاب کنید.
  3. Render را انتخاب کنید و گره‌ها را در زیر گزینه‌های به‌روزرسانی منتشر کنید.
  4. برای انتخاب همه گره ها، روی کادر انتخاب Select / Unselect all کلیک کنید.
  5. روی Update کلیک کنید.

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