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

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

در سه‌شنبه ۸ سپتامبر ۲۰۱۵، نسخه فصلی «درگاه خدمات توسعه‌دهنده Apigee Edge برای ابر خصوصی» را منتشر کردیم.

نام محصول قبلی «Apigee Edge On-premises Developer Services Portal» یا «OPDK» اکنون «Apigee Edge Developer Services Portal for Private Cloud» است.

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

برای مشاهده فهرستی از همه یادداشت‌های انتشار 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، ازجمله وارد کردن براساس فایل یا نشانی وب، ازجمله پشتیبانی از اشیاء امنیتی با نام سفارشی.
• بهبودهای طراحی دیداری در الگوهایی که «سند هوشمند» تولید می‌کنند.
• بهبودهای گردش کار و قابلیت استفاده در «درگاه توسعه‌دهندگان»، که ازطریق منو «محتوا > 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-584	پارامتر مسیر در اولین استفاده به‌خاطر آورده نمی‌شود پارامتر مسیر هنگام برقراری تماس همیشه به‌خاطر آورده نمی‌شد.
DEVSOL-603	صفحه «طرح تعارض» قالب‌بندی ضعیفی دارد هنگام خرید طرحی که با طرح موجود هم‌پوشانی دارد، صفحه‌ای که نشان داده می‌شود اکنون به‌خوبی برای کاربر قالب‌بندی شده است.
DEVSOL-709	SmartDocs: پارامتر الگوی نشانی وب پس‌از ارسال درخواست با مقدار خالی قابل‌ویرایش نیست این مشکل را برطرف می‌کند که باعث می‌شود پارامترهای الگو پس‌از ارسال درخواست از SmartDocs پس‌از حذف پارامتر الگو در مستندات روش، غیرقابل‌ویرایش شوند.
DEVSOL-723	نمایش پیام‌های کاربرپسند درصورت ناموفق بودن «وارد کردن SmartDocs»
DEVSOL-1013	نشانی‌های ایمیل کاربر «درگاه توسعه‌دهندگان» را قابل‌ویرایش کنید فیلد نشانی ایمیل در صفحه ویرایش نمایه دیگر غیرفعال نخواهد بود و توسعه‌دهندگان می‌توانند نشانی‌های ایمیل خود را تغییر دهند.
DEVSOL-1244	واحد «نشانگر محیط» برای نسخه‌های OPDK فعال نشود
DEVSOL-1273	«DevConnect Mint» دوبار در فهرست «واحدها» نشان داده می‌شود در بخش «واحدها»، «Dev Connect Mint» دوبار نمایش داده می‌شد. اکنون این مشکل رفع شده است.
DEVSOL-1313	پشتیبانی از وارد کردن فایل JSON/YAML یا نشانی وب برای Swagger و WADL اکنون می‌توان فایل‌های WADL را ازطریق نشانی وب وارد کرد و فایل‌های Swagger را بارگذاری کرد.
DEVSOL-1339	تغییر مکان‌های منو «سرپرست SmartDocs» ‫SmartDocs اکنون در منو محتوا قرار دارد و تنظیمات smartdocs در منو سرپرست تنظیمات قرار دارد.
DEVSOL-1340	حذف نسخه بتا هنگام رفتن به GA
DEVSOL-1390	کتابخانه PHP SDK Edge به‌روز شده است تا مشکل فراخوانی __toString() را برطرف کند کتابخانه PHP SDK Edge به‌روز شده است تا مشکل فراخوانی __toString() در شیء DeveloperRatePlan را که باعث ایجاد این خطا می‌شود برطرف کند: خطای مهلک: فراخوانی تابع عضو format()‎ در یک غیرشیء در /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php در خط ۲۲۱ این یک اشکال است که فقط مشتریان «درآمدزایی» را تحت‌تأثیر قرار می‌دهد که با کد سفارشی متد toString() را فراخوانی می‌کنند.
DEVSOL-1398	مدل SmartDocs Petstore در نصب بدون درخواست از کاربر وارد شد اکنون SmartDocs نمونه swagger petstore را درطول نصب سایت (http://petstore.swagger.io/v2/swagger.json) به‌جای مدل آب‌وهوا وارد می‌کند تا نمونه جامع‌تری از استفاده از SmartDocs داشته باشد.
DEVSOL-1407	وقتی توسعه‌دهندگان زیادی وجود داشته باشد، Cron ناموفق می‌شود هنگام اجرای Drupal cron، تعداد زیاد توسعه‌دهندگان باعث بروز مشکل مهلت زمانی می‌شود. وقتی سازمانی بیش‌از ۲۰۰ کاربر داشته باشد، اکنون از فرایند دسته‌ای استفاده می‌شود.
DEVSOL-1410	خطاهای اتصال هنگام نصب «درگاه توسعه‌دهندگان» آشکار نیست پیام‌های خطای بهتری به نصب‌کننده اضافه شد تا درصورت کار نکردن اتصال مدیریت Edge، مشکلات عیب‌یابی به حداقل برسد.
DEVSOL-1422	برداشتن فرم «پیکربندی SMTP» از نمایه Apigee فرایند نصب دیگر از شما نمی‌پرسد که آیا می‌خواهید SMTP را پیکربندی کنید یا نه، بلکه این کار را می‌توانید پس‌از تکمیل نصب با پیروی از رویه استاندارد Drupal برای فعال کردن واحد SMTP و پیکربندی صحیح آن انجام دهید.
DEVSOL-1427	افزودن قلاب به واحد «برنامه‌های توسعه‌دهنده Devconnect» برای امکان تغییر دادن داده‌های Analytics واحد 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	خطای مهلک هنگام ذخیره تنظیمات «اصالت‌سنجی» برای مدل وقتی «طرح امنیتی» حذف می‌شود، اکنون چارگوش انتخابی برای انتخاب اینکه آیا طرح اصالت‌سنجی «الگو» مرتبط نیز باید حذف شود ارائه می‌دهد.
DEVSOL-1470	ایجاد پیوند منو «میاناهای برنامه‌سازی کاربردی» و نمای مربوطه «اسناد هوشمند» در «درگاه توسعه‌دهندگان» اکنون به‌طور پیش‌فرض با پیوندی به اسناد هوشمند ارائه‌شده در منو اصلی با نام «میاناهای برنامه‌سازی کاربردی» ارائه می‌شود که به هر مدلی با روش‌های منتشرشده پیوند می‌دهد.
DEVSOL-1486	تماس‌های SmartDocs می‌توانند با کلید ازپیش تعریف‌شده اصالت‌سنجی کنند اصالت‌سنجی را با کلیدهای API ازپیش تأمین‌شده و کاربر تأمین‌شده فعال می‌کند.
DEVSOL-1499	کد HTML در شرح پارامترهای SmartDocs تجزیه نمی‌شود اکنون کد HTML در شرح پارامترهای SmartDocs تجزیه می‌شود.
DEVSOL-1507	نمی‌توانید پارامترهای متعددی را به «میانای برنامه‌سازی کاربردی» با «روش افزودن» اضافه کنید اکنون هنگام ویرایش روش می‌توانید پارامترهای متعددی را به «میانای برنامه‌سازی کاربردی» SmartDocs اضافه کنید.
DEVSOL-1509	راهی برای ویرایش فیلد «نمونه» برای «میانای برنامه‌سازی کاربردی SmartDocs» نمی‌بینید اکنون می‌توانید هنگام ویرایش صفحه SmartDocs، «نوع MIME بدنه»، «مستندات بدنه»، و «نمونه بدنه» را تنظیم کنید.
DEVSOL-1534	نوع محتوا در برونداد SmartDocs تکمیل نمی‌شود اکنون نوع محتوا در صفحه روش SmartDocs تکمیل می‌شود.
DEVSOL-1554	مقایسه تاریخ نامعتبر در «درآمدزایی» در برگه طرح خریداری‌شده برای پورتال‌های توسعه‌دهنده فعال‌شده برای درآمدزایی، دکمه «لغو» هرگز برای طرحی با تاریخ شروع در آینده نمایش داده نمی‌شد،
DEVSOL-1556	نسخه قدیمی واحدهای Drupal ارسال می‌شود واحدها و رسانه‌های YouTube به جدیدترین نسخه به‌روز شده است.
DEVSOL-1558	صفحه‌های روش SmartDocs برای نمونه PetStore ارائه نمی‌شود در نصب‌های جدید، روش‌های نمونه SmartDocs PetStore اکنون به‌درستی ارائه می‌شود.
DEVSOL-1562	تولید نما برای هر مدل SmartDocs وقتی مدل جدیدی ایجاد می‌کنید، نمای جدیدی به‌طور پیش‌فرض برای آن مدل ایجاد می‌شود.
DEVSOL-1565	روش «ویرایش سندهای هوشمند» خطای مهلکی تولید می‌کند مشکلی برطرف شد که در آن ویرایش روش «سندهای هوشمند» گاهی باعث تولید خطا می‌شد.
DEVSOL-1567	«افزودن مدل» در منو سرپرست بالا نمایش داده می‌شود مشکل نمایش گزینه منو «افزودن مدل» در منو سرپرست بالا برطرف شد.
DEVSOL-1576	«نمای مستندات API» نام مدل را نمایش می‌دهد، نه نام نمایشی صفحه «مستندات API» که هنگام کلیک کردن روی «میاناهای برنامه‌سازی کاربردی» در منو نشان داده می‌شود، نام داخلی مدل را به‌جای نام نمایشی نشان می‌داد. اگر درحال به‌روزرسانی به نسخه پخش هستید و این نما را تغییر داده‌اید، باید نما را به حالت قبلی برگردانید تا این تغییرات را با دنبال کردن این مراحل ببینید: # به‌عنوان سرپرست وارد سیستم شوید # به «ساختار > نماها» بروید # روی منو کرکره‌ای کنار «ویرایش» در «مدل‌های SmartDocs» کلیک کنید تا همه عملیات را ببینید. # اگر «برگرداندن» را می‌بینید، یعنی کد را با تغییر خودتان رونویسی کرده‌اید. برای برگرداندن نما به حالت پیش‌فرض، روی «برگرداندن» کلیک کنید. توجه داشته باشید که با این کار، هر تغییری که در این نما ایجاد کرده‌اید برداشته خواهد شد.
DEVSOL-1578	پردازش هر دو مدل «آب‌وهوا» و «فروشگاه حیوانات خانگی» در نصب‌های سایت هر دو مدل «مستندات هوشمند» «فروشگاه حیوانات خانگی» و «آب‌وهوا» در سایت‌های جدید وارد می‌شوند.
DEVSOL-1584	طرح‌ها قابل خرید نیستند رفع مشکل عدم ارسال فرم خرید طرح‌های درآمدزایی برای انتشار ابری نسخه‌های 15.05.27.00 و 15.06.08.00 درصورت استفاده از موضوع «پاسخ‌گوی Apigee» یا موضوع فرعی موضوع «پاسخ‌گوی Apigee».
DEVSOL-1597	تنظیمات مهلت زمانی توسعه‌دهنده تغییر نمی‌کند اشکالی که در آن تنظیمات مهلت زمانی اتصال Edge به‌درستی اعمال نمی‌شد برطرف شد.
DEVSOL-1620	من، نشانگر محیط، و ارتقاهای واحد ویژگی‌ها به‌روزرسانی امنیتی با اهمیت متوسط برای واحد من و به‌روزرسانی‌های واحد برای نشانگر محیط و ویژگی‌ها. اطلاعات بیشتر: https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator https://www.drupal.org/project/features
DEVSOL-1648	برای جلوگیری از خرابی reCAPTCHA، مطمئن شوید arg_separator.output روی «&» تنظیم شده باشد مشکل مربوط به پلاتفرمی که در آن استفاده از Google reCAPTCHA خراب شده بود برطرف شده است.
DEVSOL-1651	اگر واحد smartdocs فعال نباشد، زمینه Apigee Base ازکار می‌افتد زمینه apigee_base دیگر به فعال بودن واحد SmartDocs وابسته نیست.
DEVSOL-1654	نسخه admin_views را ارتقا دهید تا اصلاح امنیتی حیاتی را دریافت کنید واحدهای همیاری زیر به‌روزرسانی شدند: نماهای سرپرست انتقال Redirect Redis مشاهده عملیات انبوه