Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
El martes 8 de septiembre de 2015, lanzamos una versión trimestral del portal de servicios para desarrolladores de Apigee Edge para la nube privada.
El nombre anterior del producto "Portal de servicios para desarrolladores de Apigee Edge On-premises" o "OPDK" ahora es "Portal de servicios para desarrolladores de Apigee Edge para la nube privada".
Si tienes preguntas, visita la Asistencia al cliente de Apigee.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta Notas de la versión de Apigee.
Requisitos de Apigee Edge para el portal
Si conectas esta versión del portal a una instalación de Edge para la nube privada, debes conectarla a la versión 4.15.07.00 o posterior para asegurarte de que se admitan todas las funciones de SmartDocs. Consulta las notas de la versión 4.15.07.00 de Apigee Edge para la nube privada para obtener más información.
Nuevas funciones
Disponibilidad general de SmartDocs
SmartDocs pasará de la versión beta a la disponibilidad general. Entre las actualizaciones y funciones nuevas, se incluyen las siguientes:
- Compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y compatibilidad con objetos de seguridad con nombres personalizados.
- Mejoras en el diseño visual de las plantillas que generan SmartDocs.
- Mejoras en la usabilidad y el flujo de trabajo del portal para desarrolladores, disponibles en el menú Contenido > SmartDocs de Drupal
- Lo que se conocía como autenticación de "token personalizado" ahora se denomina "clave de API".
- Objetos de "seguridad" de autenticación definidos a nivel de la revisión
- Configuración de la autenticación del cliente a nivel de la plantilla Las revisiones nuevas ya no restablecen ninguna credencial de cliente de SmartDocs preconfigurada.
Para obtener más descripciones de las funciones, consulta esta entrada de blog.
Para obtener documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período de la versión beta, las funciones y capacidades nuevas de la versión de disponibilidad general requieren que actualices SmartDocs en tu portal de desarrollador.
Las páginas de SmartDocs que ya se hayan publicado en tu portal para desarrolladores seguirán funcionando, pero debes seguir el proceso de actualización antes de editar o publicar cambios en páginas existentes o nuevas.
Ten en cuenta que, si bien puedes renderizar y publicar SmartDocs en tu portal para desarrolladores, estos se generan a partir del modelo de API que se encuentra en los servicios de administración de APIs de Edge de Apigee. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todos tus entornos de Pantheon (similar a la forma en que los desarrolladores existen en todos los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a la versión general
- Actualiza y prueba la versión 15.05.27 en tus entornos de dev o prueba en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si has estado importando documentos Swagger o WADL, vuelve a importarlos en una revisión nueva.
- Si has estado manteniendo tu modelo de API a través del módulo de SmartDocs, expórtalo como JSON de SmartDocs y, luego, impórtalo a tu modelo nuevo con el archivo adjunto.
- Establece las propiedades de seguridad de la revisión de tu modelo. En la página Contenido >
SmartDocs > modelo, selecciona Configuración de seguridad.
- Para verificar la autenticación preconfigurada en la página de configuración del modelo (Contenido >
SmartDocs), haz clic en Configuración en la columna Operaciones.
- Actualiza las plantillas personalizadas para usar la versión 6 de los recursos de CSS y JS, y realiza cambios para reflejar los nombres de objetos nuevos, como authSchemes y apiSchema. Para obtener información sobre cómo actualizar las plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
- Vuelve a renderizar y publica la revisión del modelo.
- Después de validar la nueva documentación, actualiza tu portal de producción a la versión 15.05.27.
Si eres cliente empresarial de Edge y tienes preguntas o inquietudes sobre el proceso de actualización, envía un correo electrónico a marsh@apigee.com y cnovak@apigee.com. De lo contrario, usa la comunidad de Apigee para obtener la mejor respuesta.
Fallas corregidas
En esta versión, se corrigieron los siguientes errores.
| ID del problema | Descripción |
|---|---|
| DEVSOL-487 | Los administradores deben poder configurar el formato de día en Monetización Ahora puedes configurar el formato de fecha en Monetización, en la configuración de monetización, para los formatos de fecha de Europa y EE.UU. |
| DEVSOL-584 | No se recordaba el parámetro de ruta de acceso en el primer uso No siempre se recordaba el parámetro de ruta de acceso cuando se realizaban llamadas. |
| DEVSOL-603 | La página del plan en conflicto tiene un formato incorrecto Cuando se compra un plan que se superpone con uno existente, la página que se muestra ahora tiene un formato agradable para el usuario. |
| DEVSOL-709 | SmartDocs: El parámetro de plantilla de URL no se puede editar después de enviar una solicitud con un valor vacío Se corrigió el problema que hacía que los parámetros de plantilla no se pudieran editar después de enviar la solicitud desde SmartDocs después de borrar el parámetro de plantilla en la documentación del método. |
| DEVSOL-723 | Se muestran mensajes fáciles de entender en caso de que falle la importación de SmartDocs |
| DEVSOL-1013 | Se podrán editar las direcciones de correo electrónico de los usuarios del portal para desarrolladores El campo de dirección de correo electrónico en la página de edición de perfil ya no estará inhabilitado y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
| DEVSOL-1244 | No habilites el módulo de indicador de entorno para las versiones de OPDK |
| DEVSOL-1273 | “DevConnect Mint” aparece dos veces en la lista de módulos En Módulos, se mostraba “Dev Connect Mint” dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Compatibilidad con la importación de archivos JSON/YAML o URLs para Swagger y WADL Ahora se pueden importar archivos WADL a través de URLs y subir archivos Swagger. |
| DEVSOL-1339 | Cambio de ubicación del menú Administrador de SmartDocs Ahora SmartDocs se encuentra en el menú Contenido, y la configuración de SmartDocs se encuentra en el menú Administrador de configuración. |
| DEVSOL-1340 | Cómo quitar la versión beta cuando se pasa a la versión GA |
| DEVSOL-1390 |
Se actualizó la biblioteca de PHP SDK Edge para corregir el problema de llamar a __toString(). Error fatal: Llamada a una función miembro format() en un objeto no en /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php en la línea 221. Este es un error que solo afecta a los clientes de Monetización con código personalizado que llama al método toString(). |
| DEVSOL-1398 | Se importó el modelo de Petstore de SmartDocs en la instalación sin solicitarle al usuario Ahora SmartDocs importa el ejemplo de Petstore Swagger durante la instalación del sitio (http://petstore.swagger.io/v2/swagger.json) en lugar del modelo del clima para tener un ejemplo más exhaustivo del uso de SmartDocs. |
| DEVSOL-1407 | Cron falla cuando hay muchos desarrolladores Cuando se ejecuta cron de Drupal, una gran cantidad de desarrolladores causaría un problema de tiempo de espera. Cuando una organización tiene más de 200 usuarios, ahora se usa un proceso por lotes. |
| DEVSOL-1410 | No se mostraban errores de conexión cuando se instalaba el portal para desarrolladores Se agregaron mejores mensajes de error al instalador cuando la conexión de administración de Edge no funciona para minimizar los problemas de solución de problemas. |
| DEVSOL-1422 | Se quitó el formulario de configuración de SMTP del perfil de Apigee El proceso de instalación ya no te pregunta si quieres configurar SMTP. En su lugar, puedes hacerlo después de que se complete la instalación siguiendo la práctica estándar de Drupal de habilitar el módulo de SMTP y configurarlo correctamente. |
| DEVSOL-1427 |
Se agregaron hooks al módulo devconnect_developer_apps para permitir la alteración de los datos de análsis # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() Estos permiten que los módulos personalizados alteren el gráfico de estadísticas de la app del desarrollador. |
| DEVSOL-1464 | Error fatal cuando se guarda la configuración de autenticación de un modelo Cuando se borra un esquema de seguridad, ahora se muestra una casilla de verificación para seleccionar si también se debe borrar el esquema de autenticación de la plantilla asociado. |
| DEVSOL-1470 | Crea el vínculo del menú "APIs" y la vista correspondiente Ahora, el portal para desarrolladores de SmartDocs incluye de forma predeterminada un vínculo a la documentación renderizada de SmartDocs en el menú principal llamado "APIs", que vincula a cualquier modelo con métodos publicados. |
| DEVSOL-1486 | Las llamadas a SmartDocs se pueden autenticar con una clave predefinida Habilita la autenticación con claves de API proporcionadas previamente y por el usuario. |
| DEVSOL-1499 | El código HTML no se analizaba en las descripciones de los parámetros de SmartDocs Ahora, el código HTML se analiza en las descripciones de los parámetros de SmartDocs. |
| DEVSOL-1507 | No se pueden agregar varios parámetros a una API con el método Add Ahora puedes agregar varios parámetros a una API de SmartDocs cuando editas el método. |
| DEVSOL-1509 | No veo una forma de editar el campo "sample" para una API de SmartDocs Ahora puedes configurar el "Body MIME type", "Body documentation" y "Body sample" cuando edites una página de SmartDocs. |
| DEVSOL-1534 | El tipo de contenido no se propaga en el resultado de SmartDocs Ahora se propaga el tipo de contenido en la página del método de SmartDocs. |
| DEVSOL-1554 | Comparación de fechas no válida en Monetización En la pestaña del plan comprado de los portales para desarrolladores habilitados para la monetización, nunca se mostraba el botón "Cancelar" para un plan con una fecha de inicio futura. |
| DEVSOL-1556 | Se envía una versión anterior de los módulos de Drupal Se actualizó el módulo media_youtube y features a la versión más reciente. |
| DEVSOL-1558 | Las páginas de métodos de SmartDocs no se renderizan para el ejemplo de PetStore En las instalaciones nuevas, los métodos de ejemplo de PetStore de SmartDocs ahora se renderizan correctamente. |
| DEVSOL-1562 | Genera una vista para cada modelo de SmartDocs Cuando creas un modelo nuevo, se crea una vista nueva de forma predeterminada para ese modelo. |
| DEVSOL-1565 | La edición del método SmartDocs genera un error fatal Se corrigió el problema por el que, a veces, la edición de un método de SmartDocs generaba un error. |
| DEVSOL-1567 | Se muestra"Agregar modelo" en el menú principal de administración Se corrigió el problema por el que se mostraba el elemento de menú "Agregar modelo" en el menú principal de administración. |
| DEVSOL-1576 | La vista de documentación de la API muestra el nombre del modelo, no el nombre visible La página de documentación de la API que se muestra cuando se hace clic en “APIs” en el menú mostraba el nombre interno del modelo en lugar del nombre visible. Si actualizas a la versión y cambiaste esta vista, deberás revertirla para ver los cambios. Para ello, sigue estos pasos: # Accede como administrador # Ve a Estructura > Vistas # Haz clic en el menú desplegable junto a "Editar" en "Modelos de SmartDocs" para ver todas las operaciones. # Si ves "revert", significa que reemplazaste el código con tu propio cambio. Haz clic en "Revertir" para volver a establecer la vista en el estado predeterminado. Ten en cuenta que se quitarán todos los cambios que hayas realizado en esta vista. |
| DEVSOL-1578 | Renderiza los modelos de Petstore y Weather en las instalaciones de sitios Se importan los modelos de SmartDocs de Petstore y Weather en sitios nuevos. |
| DEVSOL-1584 | No se pueden comprar planes Se corrigió el problema por el que el formulario de compra de planes de monetización no se enviaba para la versión de Cloud 15.05.27.00 y 15.06.08.00 si usabas el tema responsivo de Apigee o un subtema de este. |
| DEVSOL-1597 | No se puede cambiar la configuración del tiempo de espera del desarrollador Se corrigió un error en el que no se aplicaba correctamente la configuración del tiempo de espera de la conexión de Edge. |
| DEVSOL-1620 |
Actualizaciones de módulos de Me, indicador de entorno y funciones https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Asegúrate de que arg_separator.output sea "&" para evitar que reCAPTCHA
falle Se corrigió un problema relacionado con la plataforma en el que fallaba el uso de Google reCAPTCHA. |
| DEVSOL-1651 | El tema Apigee Base falla si el módulo SmartDocs no está habilitado El tema apigee_base ya no depende de que el módulo SmartDocs esté habilitado. |
| DEVSOL-1654 |
Se actualizó la versión de admin_views para incorporar una corrección de seguridad crítica
|