شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
در روز سه‌شنبه، ۸ سپتامبر ۲۰۱۵، ما نسخه سه‌ماهه پورتال خدمات توسعه‌دهندگان Apigee Edge برای فضای ابری خصوصی را منتشر کردیم.
نام قبلی محصول «پورتال خدمات توسعه‌دهندگان Apigee Edge در محل» یا «OPDK» اکنون «پورتال خدمات توسعه‌دهندگان Apigee Edge برای فضای ابری خصوصی» است.
اگر سوالی دارید، با پشتیبانی Apigee Edge تماس بگیرید.
برای مشاهده‌ی فهرستی از تمام یادداشت‌های انتشار Apigee Edge، به یادداشت‌های انتشار Apigee مراجعه کنید.
الزامات Apigee Edge برای پورتال
اگر این نسخه از پورتال را به نصب Edge برای Private Cloud متصل می‌کنید، باید آن را به نسخه ۴.۱۵.۰۷.۰۰ یا بالاتر متصل کنید تا از پشتیبانی همه ویژگی‌های SmartDocs اطمینان حاصل شود. برای اطلاعات بیشتر به یادداشت‌های انتشار Apigee Edge برای Private Cloud، نسخه ۴.۱۵.۰۷.۰۰ مراجعه کنید.
ویژگی‌های جدید
دسترسی عمومی به SmartDocs
SmartDocs در حال گذر از مرحله بتا به نسخه عمومی است. به‌روزرسانی‌ها و ویژگی‌های جدید عبارتند از:
- پشتیبانی از Swagger 2.0، شامل وارد کردن از طریق فایل یا URL، شامل پشتیبانی از اشیاء امنیتی با نام سفارشی.
- بهبود طراحی بصری در قالب‌هایی که SmartDocs را تولید می‌کنند.
- بهبودهای قابلیت استفاده و گردش کار در پورتال توسعه‌دهندگان، که از طریق منوی محتوا > اسناد هوشمند در دروپال قابل دسترسی است.
- آنچه که پیش از این به عنوان احراز هویت «توکن سفارشی» شناخته می‌شد، اکنون «کلید API» نامیده می‌شود.
- اشیاء «امنیتی» احراز هویت که در سطح ویرایش تعریف شده‌اند.
- پیکربندی احراز هویت کلاینت در سطح الگو. نسخه‌های جدید دیگر هیچ یک از اعتبارنامه‌های کلاینت SmartDocs از پیش پیکربندی‌شده را بازنشانی نمی‌کنند.
برای توضیحات بیشتر در مورد ویژگی‌ها، به این پست وبلاگ مراجعه کنید.
برای مستندات SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.
فرآیند ارتقاء SmartDocs
اگر در طول دوره بتا از SmartDocs استفاده می‌کردید، برای دسترسی به ویژگی‌ها و قابلیت‌های جدید در نسخه عمومی، باید SmartDocs را در پورتال توسعه‌دهندگان خود ارتقا دهید.
هر صفحه SmartDocs که قبلاً در پورتال توسعه‌دهندگان شما منتشر شده است، به کار خود ادامه خواهد داد، اما قبل از ویرایش یا انتشار هرگونه تغییر در صفحات موجود یا جدید، باید روند به‌روزرسانی را دنبال کنید.
به خاطر داشته باشید که اگرچه می‌توانید SmartDocs را درون پورتال توسعه‌دهندگان خود رندر و منتشر کنید، SmartDocs از مدل API تولید می‌شوند که درون سرویس‌های مدیریت API Edge شرکت Apigee قرار دارد. هر تغییری که در یک مدل API در Edge ایجاد کنید، در تمام محیط‌های Pantheon شما یکسان خواهد بود (مشابه نحوه حضور توسعه‌دهندگان در محیط‌های Pantheon).
برای ارتقا از نسخه بتای SmartDocs به نسخه عمومی
- نسخه ۱۵.۰۵.۲۷ را در محیط‌های توسعه یا آزمایش خود در Pantheon به‌روزرسانی و آزمایش کنید.
- یک مدل جدید ایجاد کنید تا جایگزین هر مدل API موجودی شود که قبلاً استفاده می‌کردید.
- اگر اسناد Swagger یا WADL را وارد کرده‌اید، دوباره آنها را به یک نسخه جدید وارد کنید.
- اگر مدل API خود را از طریق ماژول SmartDocs نگهداری می‌کردید، آن را به صورت SmartDocs JSON خروجی بگیرید و با استفاده از پیوست فایل، به مدل جدید خود وارد کنید.
- ویژگی‌های امنیتی نسخهٔ اصلاح‌شدهٔ مدل خود را تنظیم کنید. در صفحهٔ «محتوا > اسناد هوشمند > مدل» ، «تنظیمات امنیتی» را انتخاب کنید.
- با کلیک روی تنظیمات در ستون عملیات، هرگونه احراز هویت از پیش پیکربندی شده را در صفحه تنظیمات مدل ( محتوا > اسناد هوشمند ) بررسی کنید.
- هرگونه قالب سفارشی را برای استفاده از نسخه ۶ از دارایی‌های CSS و JS به‌روزرسانی کنید و تغییراتی ایجاد کنید تا نام‌های جدید اشیاء، مانند authSchemes و apiSchema، را منعکس کند. برای اطلاعات بیشتر در مورد به‌روزرسانی قالب‌های SmartDocs، به بخش «استفاده از SmartDocs برای مستندسازی APIها» مراجعه کنید.
- نسخه اصلاح‌شده مدل خود را دوباره رندر و منتشر کنید.
- پس از تأیید مستندات جدید، پورتال تولید خود را به نسخه 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 | آدرس‌های ایمیل کاربران پورتال توسعه‌دهندگان را قابل ویرایش کنید فیلد آدرس ایمیل در صفحه ویرایش پروفایل دیگر غیرفعال نخواهد شد و توسعه‌دهندگان می‌توانند آدرس‌های ایمیل خود را تغییر دهند. |
| DEVSOL-1244 | ماژول شاخص محیط را برای نسخه‌های 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() برطرف شود. خطای مهلک: فراخوانی تابع عضو format() روی یک غیر شیء در /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php در خط ۲۲۱ این یک اشکال است که فقط مشتریان کسب درآمد را با کد سفارشی که متد toString() را فراخوانی می‌کند، تحت تأثیر قرار می‌دهد. |
| DEVSOL-1398 | مدل SmartDocs Petstore هنگام نصب بدون اعلان کاربر وارد شد SmartDocs اکنون به جای مدل آب و هوا، مثال petstore swagger را در حین نصب سایت ( http://petstore.swagger.io/v2/swagger.json ) وارد می‌کند تا مثال جامع‌تری از استفاده از SmartDocs داشته باشد. |
| DEVSOL-1407 | وقتی تعداد توسعه‌دهندگان زیاد باشد، کرون از کار می‌افتد هنگام اجرای کرون دروپال، تعداد زیاد توسعه‌دهندگان باعث ایجاد مشکل تایم اوت می‌شود. وقتی یک سازمان بیش از ۲۰۰ کاربر دارد، اکنون از یک فرآیند دسته‌ای استفاده می‌شود. |
| DEVSOL-1410 | خطاهای اتصال هنگام نصب پورتال توسعه‌دهندگان (Dev Portal) آشکار نمی‌شوند پیام‌های خطای بهتری به نصاب اضافه شد وقتی اتصال مدیریت Edge کار نمی‌کند تا مشکلات عیب‌یابی به حداقل برسد. |
| DEVSOL-1422 | فرم پیکربندی SMTP را از پروفایل Apigee حذف کنید فرآیند نصب دیگر از شما نمی‌پرسد که آیا می‌خواهید SMTP را پیکربندی کنید، در عوض این کار را می‌توان پس از اتمام نصب و طبق روال استاندارد دروپال مبنی بر فعال کردن ماژول SMTP و پیکربندی صحیح آن انجام داد. |
| DEVSOL-1427 | برای امکان تغییر داده‌های تحلیلی، قلاب‌هایی را به ماژول 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 | ایجاد لینک منو "APIها" و نمای مربوطه SmartDocs پورتال توسعه‌دهندگان اکنون به‌طور پیش‌فرض با پیوندی به مستندات رندر شده SmartDocs در منوی اصلی با نام "APIs" ارائه می‌شود که به هر مدلی با متدهای منتشر شده پیوند می‌دهد. |
| DEVSOL-1486 | فراخوانی‌های SmartDocs می‌توانند با یک کلید از پیش تعریف‌شده احراز هویت شوند. احراز هویت را با کلیدهای API از پیش ارائه شده و همچنین کلیدهای API ارائه شده توسط کاربر فعال می‌کند. |
| DEVSOL-1499 | کد HTML در توضیحات پارامترهای SmartDocs تجزیه نشده است کد HTML اکنون در توضیحات پارامترهای SmartDocs تجزیه و تحلیل می‌شود. |
| DEVSOL-1507 | نمی‌توان چندین پارامتر را با استفاده از Add Method به یک API اضافه کرد اکنون می‌توانید هنگام ویرایش متد، چندین پارامتر به API SmartDocs اضافه کنید. |
| DEVSOL-1509 | راهی برای ویرایش فیلد "sample" برای API مربوط به SmartDocs نمی‌بینم. اکنون می‌توانید هنگام ویرایش یک صفحه SmartDocs، «نوع MIME بدنه»، «مستندات بدنه» و «نمونه بدنه» را تنظیم کنید. |
| DEVSOL-1534 | نوع محتوا در خروجی SmartDocs پر نمی‌شود اکنون نوع محتوا در صفحه متد SmartDocs پر می‌شود. |
| DEVSOL-1554 | مقایسه تاریخ نامعتبر در کسب درآمد در تب طرح خریداری‌شده برای پورتال‌های توسعه‌دهندگان با قابلیت کسب درآمد، دکمه «لغو» هرگز برای طرحی با تاریخ شروع آینده نمایش داده نشد، |
| DEVSOL-1556 | نسخه قدیمی ماژول‌های دروپال در حال ارسال است ماژول media_youtube و ویژگی‌ها به آخرین نسخه به‌روزرسانی شده‌اند. |
| DEVSOL-1558 | صفحات متد SmartDocs برای مثال PetStore رندر نمی‌شوند در نصب‌های جدید، متدهای نمونه SmartDocs PetStore اکنون به درستی رندر می‌شوند. |
| DEVSOL-1562 | برای هر مدل SmartDocs یک نما ایجاد کنید هنگام ایجاد یک مدل جدید، به طور پیش فرض یک نمای جدید برای آن مدل ایجاد می شود. |
| DEVSOL-1565 | ویرایش متد SmartDocs خطای مهلک ایجاد می‌کند مشکلی که باعث می‌شد ویرایش متد SmartDocs گاهی اوقات خطا ایجاد کند، برطرف شد. |
| DEVSOL-1567 | نمایش "افزودن مدل" در منوی بالای مدیریت مشکل نمایش گزینه «افزودن مدل» در منوی بالای مدیریت برطرف شد. |
| DEVSOL-1576 | نمای مستندات API نام مدل را نمایش می‌دهد، نه نام نمایشی را صفحه مستندات API که هنگام کلیک روی «APIها» در منو نشان داده می‌شود، به جای نام نمایشی، نام داخلی مدل را نشان می‌داد. اگر در حال به‌روزرسانی به نسخه جدید هستید و این نما را تغییر داده‌اید، باید نمای خود را با دنبال کردن این مراحل به حالت اولیه برگردانید: # به عنوان مدیر وارد شوید # به ساختار > نماها بروید # برای مشاهده همه عملیات، روی منوی کشویی کنار «ویرایش» در «مدل‌های SmartDocs» کلیک کنید. # اگر «بازگرداندن» را می‌بینید، کد را با تغییر دلخواه خود بازنویسی کرده‌اید. برای بازگرداندن نما به حالت پیش‌فرض، روی «بازگرداندن» کلیک کنید. توجه داشته باشید که این کار هرگونه تغییری را که در این نما ایجاد کرده‌اید، حذف می‌کند. |
| DEVSOL-1578 | رندر کردن مدل‌های آب و هوا و فروشگاه حیوانات خانگی در محل نصب هر دو مدل Petstore و Weather SmartDocs در سایت‌های جدید وارد شده‌اند. |
| DEVSOL-1584 | طرح ها قابل خریداری نیستند مشکلی که باعث می‌شد فرم خرید طرح‌های کسب درآمد برای نسخه‌های ابری ۱۵.۰۵.۲۷.۰۰ و ۱۵.۰۶.۰۸.۰۰ در صورت استفاده از قالب واکنش‌گرای Apigee یا یکی از زیرقالب‌های آن ارسال نشود، برطرف شد. |
| DEVSOL-1597 | نمی‌توان تنظیمات زمان‌بندی توسعه‌دهنده را تغییر داد اشکالی که در آن تنظیمات زمان‌بندی اتصال Edge به درستی اعمال نمی‌شد، برطرف شد. |
| DEVSOL-1620 | ارتقاء ماژول‌های من، نشانگر محیط و ویژگی‌ها https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | مطمئن شوید که arg_separator.output برابر با '&' است تا از خرابی reCAPTCHA جلوگیری شود. یک مشکل مربوط به پلتفرم که در آن استفاده از Google reCAPTCHA با مشکل مواجه می‌شد، برطرف شده است. |
| DEVSOL-1651 | اگر ماژول smartdocs فعال نباشد، قالب Apigee Base از کار می‌افتد. قالب apigee_base دیگر به فعال بودن ماژول SmartDocs وابسته نیست. |
| DEVSOL-1654 | نسخه جدید admin_views برای رفع مشکل امنیتی حیاتی منتشر شد
|