Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
Во вторник, 8 сентября 2015 г., мы выпустили ежеквартальную версию портала услуг разработчиков Apigee Edge для частного облака.
Прежнее название продукта «Портал услуг для локальных разработчиков Apigee Edge» или «OPDK» теперь называется «Портал услуг для разработчиков Apigee Edge для частного облака».
Если у вас есть вопросы, обратитесь в службу поддержки клиентов Apigee .
Список всех примечаний к выпуску Apigee Edge см. в Примечаниях к выпуску Apigee .
Требования Apigee Edge для портала
Если вы подключаете эту версию портала к установке Edge для частного облака, вам необходимо подключить его к версии 4.15.07.00 или более поздней, чтобы гарантировать поддержку всех функций SmartDocs. Дополнительную информацию см. в разделе 4.15.07.00 — примечания к выпуску Apigee Edge для частного облака .
Новые возможности
Общая доступность SmartDocs
SmartDocs переходит от бета-версии к общедоступной версии. Обновления и новые функции включают в себя:
- Поддержка Swagger 2.0, включая импорт по файлу или URL-адресу, включая поддержку объектов безопасности с собственными именами.
- Улучшения визуального дизайна в шаблонах, генерирующих SmartDocs.
- Улучшения удобства использования и рабочего процесса на портале разработчиков, доступные через меню «Содержимое» > «SmartDocs» в Drupal.
- То, что раньше называлось аутентификацией «Пользовательский токен», теперь называется «Ключ API».
- Объекты «безопасности» аутентификации, определенные на уровне версии.
- Настройка аутентификации клиента на уровне шаблона. Новые версии больше не сбрасывают предварительно настроенные учетные данные клиента SmartDocs.
Дополнительные описания функций см. в этой записи блога .
Документацию SmartDocs см. в разделе Использование SmartDocs для документирования API .
Процесс обновления SmartDocs
Если вы уже использовали SmartDocs в период бета-тестирования, новые функции и возможности общедоступной версии требуют обновления SmartDocs на портале разработчика.
Любые страницы SmartDocs, которые уже были опубликованы на вашем портале разработчика, продолжат работать, но вы должны следовать процессу обновления, прежде чем редактировать или публиковать какие-либо изменения на существующих или новых страницах.
Имейте в виду, что, хотя вы можете отображать и публиковать SmartDocs на своем портале разработчика, SmartDocs генерируются на основе модели API, которая находится в службах управления API Edge Apigee. Любые изменения, которые вы вносите в модель API в Edge, будут одинаковыми во всех ваших средах Pantheon (аналогично тому, как разработчики существуют в средах Pantheon).
Для обновления бета-версии SmartDocs до общедоступной версии
- Обновите и протестируйте выпуск 15.05.27 в своей среде разработки или тестирования на Pantheon.
- Создайте новую модель, чтобы заменить любую существующую модель API, которую вы использовали.
- Если вы импортировали документы Swagger или WADL, импортируйте их еще раз в новую версию.
- Если вы поддерживали свою модель API через модуль SmartDocs, экспортируйте ее в формате SmartDocs JSON и импортируйте в новую модель, используя вложение файла.
- Установите свойства безопасности версии вашей модели. На странице Содержимое > SmartDocs > модель выберите Настройки безопасности .
- Проверьте любую предварительно настроенную аутентификацию на странице настроек модели ( Содержимое > SmartDocs ), нажав «Настройки» в столбце «Операции».
- Обновите все пользовательские шаблоны, чтобы использовать ресурсы CSS и JS версии 6, и внесите изменения, отражающие любые новые имена объектов, такие как authSchemes и apiSchema. Информацию об обновлении шаблонов SmartDocs см. в разделе «Использование SmartDocs для документирования API» .
- Выполните повторную визуализацию и опубликуйте версию модели.
- После проверки новой документации обновите рабочий портал до версии 15.05.27.
Если вы являетесь корпоративным клиентом Edge и у вас есть вопросы или сомнения по поводу процесса обновления, отправьте электронное письмо по адресу marsh@apigee.com и cnovak@apigee.com. В противном случае, пожалуйста, используйте сообщество Apigee для получения наилучшего ответа.
Исправлены ошибки
В этом выпуске исправлены следующие ошибки.
| Идентификатор проблемы | Описание |
|---|---|
| ДЕВСОЛ-487 | Формат дня в монетизации должен настраивать администраторы. Формат даты теперь можно настроить в разделе «Монетизация» в настройках монетизации для форматов даты в Европе и США. |
| ДЕВСОЛ-584 | Параметр пути не запоминается при первом использовании Параметр пути при звонках не всегда запоминался. |
| ДЕВСОЛ-603 | Страница «План конфликта» плохо отформатирована При покупке плана, который пересекается с существующим планом, отображаемая страница теперь имеет удобный формат для пользователя. |
| ДЕВСОЛ-709 | SmartDocs: параметр шаблона URL-адреса недоступен для редактирования после отправки запроса с пустым значением Устраняет проблему, из-за которой параметры шаблона становятся недоступными для редактирования после отправки запроса из SmartDocs после удаления параметра шаблона в документации метода. |
| ДЕВСОЛ-723 | Показывать понятные пользователю сообщения об ошибке импорта SmartDocs |
| ДЕВСОЛ-1013 | Сделайте адреса электронной почты пользователей портала разработки доступными для редактирования. Поле адреса электронной почты на странице редактирования профиля больше не будет отключено, и разработчики смогут изменить свои адреса электронной почты. |
| ДЕВСОЛ-1244 | Не включайте модуль индикатора среды для выпусков OPDK. |
| ДЕВСОЛ-1273 | «DevConnect Mint» дважды отображается в списке модулей. В разделе «Модули» дважды отображалось «Dev Connect Mint». Теперь это исправлено. |
| ДЕВСОЛ-1313 | Поддержка импорта файлов JSON/YAML или URL-адресов для Swagger и WADL. Файлы WADL теперь можно импортировать через URL-адрес, а файлы Swagger можно загружать. |
| ДЕВСОЛ-1339 | Изменение местоположения меню администратора SmartDocs SmartDocs теперь находится в меню контента, а настройки SmartDocs — в меню администратора настроек. |
| ДЕВСОЛ-1340 | Удалить бета-версию при переходе в GA |
| ДЕВСОЛ-1390 | Библиотека PHP SDK Edge была обновлена, чтобы устранить проблему с вызовом __toString(). Неустранимая ошибка: вызов функции-члена format() для объекта, не являющегося объектом, в /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php в строка 221 Эта ошибка затрагивает только клиентов монетизации, использующих собственный код, вызывающий метод toString(). |
| ДЕВСОЛ-1398 | Модель SmartDocs Petstore импортируется при установке без запроса пользователя. SmartDocs теперь импортирует пример swagger зоомагазина во время установки сайта ( http://petstore.swagger.io/v2/swagger.json ) вместо модели погоды, чтобы иметь более исчерпывающий пример использования SmartDocs. |
| ДЕВСОЛ-1407 | Cron не работает, когда разработчиков много При запуске Drupal cron у большого количества разработчиков возникала проблема с тайм-аутом. Если в организации более 200 пользователей, теперь используется пакетный процесс. |
| ДЕВСОЛ-1410 | Ошибки подключения не проявляются при установке Dev Portal В программу установки добавлено улучшенное сообщение об ошибках, когда соединение управления Edge не работает, чтобы свести к минимуму проблемы с устранением неполадок. |
| ДЕВСОЛ-1422 | Удалить форму конфигурации SMTP из профиля Apigee В процессе установки больше не спрашивается, хотите ли вы настроить SMTP, вместо этого это можно сделать после завершения установки, следуя стандартной практике Drupal по включению модуля SMTP и его правильной настройке. |
| ДЕВСОЛ-1427 | Добавьте перехватчики в модуль Devconnect Developer Apps, чтобы разрешить изменение аналитических данных. #ook_devconnect_developer_apps_analytics_chart_data_alter() #ook_devconnect_developer_app_analytics_datapoints_params_alter() #ook_devconnect_developer_app_analytics_datapoints_alter() Это позволяет пользовательским модулям изменять диаграмму аналитики приложений разработчика. |
| ДЕВСОЛ-1464 | Неустранимая ошибка при сохранении настроек аутентификации для модели При удалении схемы безопасности теперь появляется флажок, позволяющий выбрать, нужно ли также удалить связанную схему аутентификации шаблона. |
| ДЕВСОЛ-1470 | Создать ссылку на меню «API» и соответствующий вид. Портал разработки SmartDocs теперь по умолчанию поставляется со ссылкой на отображаемую документацию SmartDocs в главном меню под названием «API», которая ссылается на любые модели с опубликованными методами. |
| ДЕВСОЛ-1486 | Вызовы SmartDocs могут аутентифицироваться с помощью заранее определенного ключа. Обеспечивает аутентификацию как с помощью заранее предоставленных, так и предоставленных пользователем ключей API. |
| ДЕВСОЛ-1499 | HTML-код не анализируется в описаниях параметров SmartDocs HTML-код теперь анализируется в описаниях параметров SmartDocs. |
| ДЕВСОЛ-1507 | Невозможно добавить несколько параметров в API с помощью метода добавления. Теперь вы можете добавить несколько параметров в API SmartDocs при редактировании метода. |
| ДЕВСОЛ-1509 | Не вижу способа редактировать поле «образец» для API SmartDocs. Теперь вы можете установить «Тип MIME тела», «Документацию тела» и «Образец тела» при редактировании страницы SmartDocs. |
| ДЕВСОЛ-1534 | Тип контента не заполняется в выходных данных SmartDocs Тип контента теперь заполняется на странице метода SmartDocs. |
| ДЕВСОЛ-1554 | Недопустимое сравнение дат в монетизации. На вкладке приобретенного плана для порталов разработчиков с включенной монетизацией кнопка «Отмена» никогда не отображалась для плана с будущей датой начала. |
| ДЕВСОЛ-1556 | Поставляются старые версии модулей Drupal Модуль media_youtube и функции обновлены до последней версии. |
| ДЕВСОЛ-1558 | Страницы методов SmartDocs не отображаются для примера PetStore При новых установках примеры методов SmartDocs PetStore теперь отображаются правильно. |
| ДЕВСОЛ-1562 | Создайте представление для каждой модели SmartDocs. При создании новой модели для этой модели по умолчанию создается новое представление. |
| ДЕВСОЛ-1565 | Редактирование метода SmartDocs приводит к фатальной ошибке. Исправлена проблема, из-за которой редактирование метода SmartDocs иногда приводило к ошибке. |
| ДЕВСОЛ-1567 | «Добавить модель» отображается в верхнем меню администратора. Исправлена проблема, из-за которой пункт меню «Добавить модель» отображался в верхнем меню администратора. |
| ДЕВСОЛ-1576 | В представлении документации API отображается имя модели, а не отображаемое имя. На странице документации API, которая отображается при нажатии «API» в меню, вместо отображаемого имени отображалось внутреннее имя модели. Если вы обновляете версию и изменили это представление, вам нужно будет вернуться к своему представлению, чтобы увидеть эти изменения, выполнив следующие действия: # Войдите в систему как администратор # Перейдите в раздел «Структура» > «Представления» # Щелкните раскрывающийся список рядом с «Редактировать». в разделе «Модели SmartDocs», чтобы просмотреть все операции. # Если вы видите «revert», значит, вы перезаписали код своими собственными изменениями. Нажмите «Вернуть», чтобы вернуть вид в состояние по умолчанию. Обратите внимание, что при этом будут удалены все изменения, внесенные вами в это представление. |
| ДЕВСОЛ-1578 | Визуализация моделей Weather и Petstore при установке на месте. Модели Petstore и Weather SmartDocs импортируются на новые сайты. |
| ДЕВСОЛ-1584 | Планы нельзя приобрести Исправлена проблема, из-за которой форма покупки планов монетизации не отправлялась для облачных выпусков 15.05.27.00 и 15.06.08.00, если вы использовали адаптивную тему Apigee или ее подтему. |
| ДЕВСОЛ-1597 | Невозможно изменить настройки тайм-аута разработчика Исправлена ошибка, из-за которой настройки таймаута подключения Edge применялись неправильно. |
| ДЕВСОЛ-1620 | Я, индикатор среды и обновления модуля функций. https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| ДЕВСОЛ-1648 | Убедитесь, что arg_separator.output имеет значение «&», чтобы предотвратить поломку reCAPTCHA. Исправлена проблема, связанная с платформой, из-за которой было нарушено использование Google reCAPTCHA. |
| ДЕВСОЛ-1651 | Тема Apigee Base не работает, если модуль smartdocs не включен Тема apigee_base больше не зависит от включенного модуля SmartDocs. |
| ДЕВСОЛ-1654 | Улучшите версию admin_views, чтобы получить критическое исправление безопасности
|