Estás viendo la documentación de Apigee Edge.
Ir 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 Private Cloud".
Si tienes preguntas, comunícate con el equipo de asistencia de Apigee Edge.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta las 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 Private Cloud, 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. Las actualizaciones y las funciones nuevas incluyen lo siguiente:
- Se agregó compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y con objetos de seguridad con nombres personalizados.
- Se realizaron mejoras en el diseño visual de las plantillas que generan SmartDocs.
- Mejoras en la usabilidad y el flujo de trabajo en el portal para desarrolladores, disponibles a través del menú Content > SmartDocs en Drupal.
- Lo que se conocía como autenticación con "token personalizado" ahora se denomina "clave de API".
- Son objetos de "seguridad" de autenticación definidos a nivel de la revisión.
- Es la configuración de la autenticación del cliente a nivel de la plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.
Para obtener más información sobre las funciones, consulta esta entrada de blog.
Para obtener documentación sobre SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período beta, las nuevas funciones y capacidades de la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Las páginas de SmartDocs que ya se publicaron en tu portal para desarrolladores seguirán funcionando, pero debes seguir el proceso de actualización antes de editar o publicar cualquier cambio en las páginas existentes o nuevas.
Ten en cuenta que, si bien puedes renderizar y publicar SmartDocs dentro de tu portal para desarrolladores, los SmartDocs se generan a partir del modelo de API que reside en los servicios de administración de APIs de Edge de Apigee. Todos los cambios que realices en un modelo de API en Edge serán los mismos en todos tus entornos de Pantheon (de manera similar a cómo existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a la disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos de desarrollo o prueba en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si importaste documentos de Swagger o WADL, vuelve a importarlos en una revisión nueva.
- Si mantuviste tu modelo de API a través del módulo de SmartDocs, expórtalo como JSON de SmartDocs y, luego, impórtalo a tu nuevo modelo con un archivo adjunto.
- Establece las propiedades de seguridad de la revisión de tu modelo. En la página Content > SmartDocs > model, selecciona Security Settings.
- Haz clic en Configuración en la columna Operaciones para verificar cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs).
- Actualiza las plantillas personalizadas para que usen la versión 6 de los recursos CSS y JS, y realiza los cambios necesarios para reflejar los nombres de los 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 publicar la revisión del modelo.
- Después de validar la nueva documentación, actualiza tu portal de producción a la versión del 27/05/15.
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 | Description |
|---|---|
| DEVSOL-487 | Los administradores deben poder configurar el formato de día en Monetización Ahora se puede 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 | El parámetro de ruta de acceso no se recuerda en el primer uso El parámetro de ruta de acceso no siempre se recordaba cuando se realizaban llamadas. |
| DEVSOL-603 | La página de conflicto de planes tiene un formato deficiente Cuando se compra un plan que se superpone con uno existente, la página que se muestra ahora tiene un formato adecuado para el usuario. |
| DEVSOL-709 | SmartDocs: El parámetro de plantilla de URL no se puede editar después de enviar la 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 tras borrar el parámetro de plantilla en la documentación del método. |
| DEVSOL-723 | Mostrar mensajes fáciles de entender en caso de falla en la importación de SmartDocs |
| DEVSOL-1013 | Habilitar la edición de las direcciones de correo electrónico de los usuarios del portal para desarrolladores El campo de dirección de correo electrónico de la página de edición del perfil ya no estará inhabilitado y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
| DEVSOL-1244 | No habilitar el módulo Environment Indicator para las versiones de OPDK |
| DEVSOL-1273 | "DevConnect Mint" aparece dos veces en la lista de módulos En Módulos, "Dev Connect Mint" se mostró dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Se admite la importación de archivos o URLs JSON/YAML para Swagger y WADL Ahora se pueden importar archivos WADL a través de URLs y subir archivos Swagger. |
| DEVSOL-1339 | Cambia las ubicaciones del menú de administrador de SmartDocs SmartDocs ahora se encuentra en el menú de contenido, y la configuración de SmartDocs está en el menú de administrador de configuración. |
| DEVSOL-1340 | Quitar la versión beta cuando se lance la versión GA |
| DEVSOL-1390 |
Se actualizó la biblioteca Edge del SDK de PHP para corregir el problema de llamar a __toString() Error fatal: Llamada a una función miembro format() en un no objeto 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 Monetization que tienen código personalizado que llama al método toString(). |
| DEVSOL-1398 | El modelo de Petstore de SmartDocs se importa durante la instalación sin solicitarle al usuario SmartDocs ahora importa el ejemplo de Swagger de Petstore 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 | Falla de Cron cuando hay muchos desarrolladores Cuando se ejecutaba Cron de Drupal, una gran cantidad de desarrolladores causaba 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 | Los errores de conexión no son evidentes cuando se instala 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 deseas configurar SMTP. En cambio, esto se puede hacer después de que se complete la instalación siguiendo la práctica estándar de Drupal de habilitar el módulo SMTP y configurarlo correctamente. |
| DEVSOL-1427 |
Se agregaron hooks al módulo de Devconnect Developer Apps para permitir la modificación de los datos de Analytics # hook_devconnect_developer_apps_analytics_chart_data_alter() # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() Permiten que los módulos personalizados alteren el gráfico de estadísticas de la app para desarrolladores. |
| DEVSOL-1464 | Error fatal al guardar la configuración de autenticación para 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 plantilla asociado. |
| DEVSOL-1470 | Crea el vínculo del menú "APIs" y la vista correspondiente SmartDocs del portal para desarrolladores ahora 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 Permite la autenticación con claves de API proporcionadas previamente y por el usuario. |
| DEVSOL-1499 | El código HTML no se analiza en las descripciones de los parámetros de SmartDocs Ahora se analiza el código HTML 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 cómo editar el campo "sample" de una API de SmartDocs Ahora puedes establecer "Body MIME type", "Body documentation" y "Body sample" cuando editas una página de SmartDocs. |
| DEVSOL-1534 | El tipo de contenido no se completa en el resultado de SmartDocs El tipo de contenido ahora se completa 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 con la monetización habilitada, nunca se mostró 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 Los módulos media_youtube y features se actualizaron 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 SmartDocs PetStore 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 de SmartDocs genera un error fatal Se corrigió un 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ú de administrador superior Se solucionó el problema por el que se mostraba el elemento de menú "Agregar modelo" en el menú de administrador superior. |
| 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 la versión y cambiaste esta vista, deberás revertirla para ver estos 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 sobrescribiste el código con tu propio cambio. Haz clic en "Revert" para volver a la vista predeterminada. 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 del sitio Los modelos de Petstore y Weather SmartDocs se importan en los sitios nuevos. |
| DEVSOL-1584 | No se pueden comprar planes Se corrigió el problema por el que no se enviaba el formulario de compra de planes de monetización para la versión en la nube 15.05.27.00 y 15.06.08.00 si usabas el tema adaptable de Apigee o un subtema del tema adaptable de Apigee. |
| DEVSOL-1597 | No se puede cambiar la configuración de tiempo de espera del desarrollador Se corrigió un error por el que no se aplicaba correctamente la configuración de tiempo de espera de conexión de Edge. |
| DEVSOL-1620 |
Actualizaciones del módulo Me, del indicador de entorno y de 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 se interrumpa reCAPTCHA Se corrigió un problema relacionado con la plataforma en el que se interrumpió el uso de Google reCAPTCHA. |
| DEVSOL-1651 | El tema base de Apigee falla si el módulo de SmartDocs no está habilitado El tema apigee_base ya no depende de que el módulo de SmartDocs esté habilitado. |
| DEVSOL-1654 |
Se aumentó la versión de admin_views para incluir una corrección de seguridad crítica
|