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

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

در سه‌شنبه 8 سپتامبر 2015، نسخه فصلی پورتال خدمات توسعه‌دهنده Apigee Edge را برای Private Cloud منتشر کردیم.

نام محصول قبلی «پرتال خدمات توسعه‌دهنده داخلی Apigee Edge» یا «OPDK» اکنون «پرتال خدمات توسعه‌دهنده Apigee Edge برای ابر خصوصی» است.

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

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

الزامات Apigee Edge برای پورتال

اگر این نسخه از پورتال را به نصب Edge for Private Cloud متصل می‌کنید، باید آن را به نسخه 4.15.07.00 یا جدیدتر متصل کنید تا مطمئن شوید که همه ویژگی‌های SmartDocs پشتیبانی می‌شوند. برای اطلاعات بیشتر به 4.15.07.00 - Apigee Edge برای یادداشت‌های انتشار Private Cloud مراجعه کنید.

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

در دسترس بودن عمومی 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-584 پارامتر مسیر در اولین استفاده به خاطر سپرده نمی شود
پارامتر مسیر هنگام برقراری تماس همیشه به خاطر نمی ماند.
DEVSOL-603 صفحه طرح تضاد قالب بندی ضعیفی دارد
هنگام خرید طرحی که با یک طرح موجود همپوشانی دارد، صفحه نشان داده شده اکنون به خوبی برای کاربر قالب بندی می شود.
DEVSOL-709 SmartDocs: پارامتر قالب URL پس از ارسال درخواست با مقدار خالی قابل ویرایش نیست
مشکلی را برطرف می کند که پارامترهای قالب را پس از ارسال درخواست از SmartDocs پس از حذف پارامتر الگو در مستندات روش، غیر قابل ویرایش می کند.
DEVSOL-723 نمایش پیام‌های کاربر پسند در عدم ورود SmartDocs
DEVSOL-1013 آدرس های ایمیل کاربران Dev Portal را قابل ویرایش کنید
فیلد آدرس ایمیل در صفحه ویرایش نمایه دیگر غیرفعال نخواهد شد و توسعه دهندگان می توانند آدرس ایمیل خود را تغییر دهند.
DEVSOL-1244 ماژول Environment Indicator را برای نسخه های OPDK فعال نکنید
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، بتا را حذف کنید
DEVSOL-1390

کتابخانه PHP SDK Edge برای رفع مشکل فراخوانی __toString() به روز شده است.
کتابخانه PHP SDK Edge برای رفع مشکل فراخوانی __toString() در شی DeveloperRatePlan به روز شده است که این خطا را ایجاد می کند:

خطای مرگبار: فراخوانی فرمت تابع عضو () روی یک غیر شی در /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php در خط 221

این یک اشکال است که فقط بر مشتریان کسب درآمد با کد سفارشی که متد ()toString را فراخوانی می‌کنند، تأثیر می‌گذارد.

DEVSOL-1398 مدل SmartDocs Petstore هنگام نصب بدون درخواست کاربر وارد شد
SmartDocs اکنون نمونه petstore swagger را در حین نصب سایت ( http://petstore.swagger.io/v2/swagger.json ) به جای مدل آب و هوا وارد می کند تا نمونه جامع تری از استفاده از SmartDocs داشته باشد.
DEVSOL-1407 Cron زمانی که توسعه دهندگان زیادی وجود دارد شکست می خورد
هنگام اجرای Drupal cron، تعداد زیادی از توسعه‌دهندگان باعث ایجاد مشکل در زمان‌بندی می‌شوند. وقتی یک سازمان بیش از 200 کاربر داشته باشد، اکنون از یک فرآیند دسته ای استفاده می شود.
DEVSOL-1410 خطاهای اتصال هنگام نصب Dev Portal آشکار نمی شوند
هنگامی که اتصال مدیریت Edge کار نمی کند، برای به حداقل رساندن مشکلات عیب یابی، پیام خطای بهتری به نصب کننده اضافه شد.
DEVSOL-1422 فرم پیکربندی SMTP را از نمایه Apigee حذف کنید
فرآیند نصب دیگر از شما نمی‌پرسد که آیا می‌خواهید SMTP را پیکربندی کنید، در عوض این کار را می‌توان پس از اتمام نصب و پیروی از تمرین استاندارد دروپال برای فعال کردن ماژول SMTP و پیکربندی صحیح آن انجام داد.
DEVSOL-1427

قلاب هایی را به ماژول Devconnect Developer Apps اضافه کنید تا امکان تغییر داده های تجزیه و تحلیل را فراهم کنید
ماژول devconnect_developer_apps اکنون سه قلاب جدید را ارائه می دهد:

# hook_devconnect_developer_apps_analytics_chart_data_alter()

# hook_devconnect_developer_app_analytics_datapoints_params_alter()

# hook_devconnect_developer_app_analytics_datapoints_alter()

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

DEVSOL-1464 خطای مرگبار هنگام ذخیره تنظیمات Auth برای یک مدل
هنگامی که یک طرح امنیتی حذف می شود، اکنون یک چک باکس برای انتخاب اینکه آیا طرح تأیید الگوی مرتبط نیز باید حذف شود، می دهد.
DEVSOL-1470 پیوند منوی "APIs" و نمای مربوطه را ایجاد کنید
Dev Portal SmartDocs اکنون به طور پیش‌فرض با پیوندی به اسناد رندر شده SmartDocs در منوی اصلی به نام "APIs" ارائه می‌شود که به هر مدلی با روش‌های منتشر شده پیوند می‌دهد.
DEVSOL-1486 تماس های SmartDocs می توانند با یک کلید از پیش تعریف شده احراز هویت شوند
احراز هویت را با کلیدهای API از پیش عرضه شده و ارائه شده توسط کاربر فعال می کند.
DEVSOL-1499 کد HTML در توضیحات پارامتر SmartDocs تجزیه نشده است
کد HTML اکنون در توضیحات پارامتر SmartDocs تجزیه شده است.
DEVSOL-1507 با افزودن روش نمی توان چند پارامتر را به یک API اضافه کرد
اکنون می توانید هنگام ویرایش روش، چندین پارامتر را به یک SmartDocs API اضافه کنید.
DEVSOL-1509 راهی برای ویرایش فیلد «نمونه» برای SmartDocs API نمی بینید
اکنون می‌توانید «نوع MIME بدن»، «مستندات بدنه» و «نمونه بدنه» را هنگام ویرایش صفحه SmartDocs تنظیم کنید.
DEVSOL-1534 نوع محتوا در خروجی SmartDocs پر نشده است
اکنون نوع محتوا در صفحه روش SmartDocs پر شده است.
DEVSOL-1554 مقایسه تاریخ نامعتبر در کسب درآمد
در برگه طرح خریداری‌شده برای پورتال‌های توسعه‌دهنده فعال، دکمه «لغو» هرگز برای طرحی با تاریخ شروع آینده نمایش داده نمی‌شود.
DEVSOL-1556 نسخه قدیمی ماژول های دروپال در حال ارسال است
ماژول media_youtube and features به آخرین نسخه به روز شده است.
DEVSOL-1558 صفحات روش SmartDocs برای مثال PetStore ارائه نمی شوند
در نصب های جدید، نمونه روش های SmartDocs PetStore اکنون به درستی ارائه می شود.
DEVSOL-1562 برای هر مدل SmartDocs یک نمای ایجاد کنید
هنگام ایجاد یک مدل جدید، یک نمای جدید به طور پیش فرض برای آن مدل ایجاد می شود.
DEVSOL-1565 ویرایش روش SmartDocs یک خطای Fatal ایجاد می کند
مشکلی که در آن ویرایش یک روش SmartDocs گاهی اوقات باعث ایجاد خطا می‌شد، برطرف شد.
DEVSOL-1567 "افزودن مدل" در بالای منوی مدیریت نمایش داده می شود
مشکل نمایش آیتم منوی «افزودن مدل» در منوی بالای مدیریت برطرف شد.
DEVSOL-1576 API Documentation View نام مدل را نمایش می دهد نه نام نمایشی
صفحه مستندات API که با کلیک روی "APIs" در منو نشان داده می شود، به جای نام نمایشی، نام داخلی مدل را نشان می دهد. اگر به نسخه به‌روزرسانی می‌کنید و این نمای را تغییر داده‌اید، برای مشاهده این تغییرات با دنبال کردن این مراحل باید نمای خود را برگردانید: # به عنوان مدیر وارد شوید # به ساختار > بازدیدها بروید # روی منوی کشویی کنار «ویرایش» کلیک کنید. در "SmartDocs Models" برای دیدن همه عملیات. # اگر "بازگشت" را مشاهده کردید، پس کد را با تغییر خود بازنویسی کرده اید. برای بازگرداندن نما به حالت پیش فرض روی "بازگشت" کلیک کنید. توجه داشته باشید که با این کار هر تغییری که در این نما ایجاد کرده اید حذف می شود.
DEVSOL-1578 هر دو مدل Weather و Petstore را در نصب سایت ارائه دهید
هر دو مدل Petstore و Weather SmartDocs در سایت‌های جدید وارد شده‌اند.
DEVSOL-1584 طرح ها قابل خرید نیستند
اگر از طرح زمینه پاسخگوی Apigee یا موضوع فرعی تم پاسخگوی Apigee استفاده می‌کردید، مشکلی که در آن فرم خرید طرح‌های کسب درآمد برای انتشار ابری در 15.05.27.00 و 15.06.08.00 ارسال نمی‌شد، برطرف شد.
DEVSOL-1597 تنظیمات مهلت زمانی توسعه دهنده را نمی توان تغییر داد
اشکالی که در آن تنظیمات مهلت زمانی اتصال Edge به درستی اعمال نشده بود، رفع شد.
DEVSOL-1620

من، نشانگر محیط و ارتقاء ماژول ویژگی ها
به‌روزرسانی امنیتی نسبتاً مهم برای ماژول me و به‌روزرسانی‌های ماژول برای نشانگر و ویژگی‌های محیطی. اطلاعات بیشتر:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

DEVSOL-1648 مطمئن شوید که arg_separator.output '&' باشد تا از شکستن reCAPTCHA جلوگیری شود
یک مشکل مرتبط با پلتفرم که در آن استفاده از Google reCAPTCHA شکسته شده بود، برطرف شد.
DEVSOL-1651 اگر ماژول smartdocs فعال نباشد، طرح زمینه Apigee Base ناموفق است
تم apigee_base دیگر به فعال بودن ماژول SmartDocs وابسته نیست.
DEVSOL-1654

نسخه ضربه گیر admin_views برای رفع مشکل امنیتی مهم
ماژول های مشارکت زیر به روز شدند:

  • دیدگاه های اداری
  • مهاجرت کنید
  • تغییر مسیر
  • ردیس
  • عملیات انبوه را مشاهده می کند