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 la nube privada".
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 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 4.15.07.00: Notas de la versión de Apigee Edge para la nube privada para obtener más información.
Nuevas funciones
Disponibilidad general de SmartDocs
SmartDocs pasa de la versión Beta a la disponibilidad general. Las actualizaciones y las funciones nuevas incluyen lo siguiente:
- 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 en el portal para desarrolladores, disponibles a través del menú Contenido > SmartDocs en 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 las credenciales de cliente de SmartDocs preconfiguradas.
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 beta, las nuevas funciones y capacidades en la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Cualquier página de SmartDocs que ya se haya publicado en tu portal para desarrolladores seguirá 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, SmartDocs se genera a partir del modelo de API que reside 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 (de manera similar a cómo existen los desarrolladores en los entornos de Pantheon).
Para actualizar de la versión beta de SmartDocs a la disponibilidad general, haz lo siguiente
- Actualiza y prueba la versión 15.05.27 en tus dev o test entornos 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, exporta como SmartDocs JSON y, luego, importa 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 cualquier 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 CSS y JS, y realiza cambios para reflejar cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Para obtener información sobre la actualización de las plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
- Vuelve a renderizar y publicar la revisión de tu modelo.
- Después de validar la documentación nueva, actualiza tu producción portal 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 Monetization Ahora, el formato de fecha se puede configurar en Monetization en la configuración de monetización para los formatos de fecha europeos y estadounidenses. |
| DEVSOL-584 | El parámetro de ruta no se recuerda en el primer uso El parámetro de ruta cuando se realizan llamadas no siempre se recordaba. |
| DEVSOL-603 | La página de conflicto de planes tiene un formato incorrecto Cuando se compra un plan que se superpone con un plan 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 corrige el problema que hace que los parámetros de la plantilla no se puedan editar después de enviar la solicitud desde SmartDocs después de borrar el parámetro de la plantilla en la documentación del método. |
| DEVSOL-723 | Mostrar mensajes fáciles de usar en caso de falla de importación de SmartDocs |
| DEVSOL-1013 | Permitir 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 perfil ya no estará inhabilitado, y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
| DEVSOL-1244 | No habilitar 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, "Dev Connect Mint" se mostraba dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Admitir la importación de archivos o URLs JSON/YAML para Swagger y WADL Ahora, los archivos WADL se pueden importar a través de la URL y los archivos de Swagger se pueden subir. |
| DEVSOL-1339 | Cambiar 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 pasa a la disponibilidad general |
| DEVSOL-1390 |
Se actualizó la biblioteca de Edge del SDK de PHP para corregir el problema de llamar a
__toString() Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 Este es un error que solo afecta a los clientes de Monetization con código personalizado que llama al método toString(). |
| DEVSOL-1398 | El modelo de SmartDocs Petstore 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 meteorológico 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 | 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 | Quitar 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 |
Agregar hooks al módulo de aplicaciones para desarrolladores de Devconnect para permitir la modificación de los
datos de estadísticas # 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 modifiquen el gráfico de estadísticas de aplicaciones de la aplicación para desarrolladores. |
| DEVSOL-1464 | Error fatal cuando se guarda 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 la plantilla asociada. |
| DEVSOL-1470 | Crear un vínculo de 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 se vincula a cualquier modelo con métodos publicados. |
| DEVSOL-1486 | Las llamadas de SmartDocs pueden autenticarse con una clave predefinida Permite la autenticación con claves de API predefinidas y proporcionadas por el usuario. |
| DEVSOL-1499 | El código HTML no se analiza 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 Agregar método Ahora puedes agregar varios parámetros a una API de SmartDocs cuando editas el método. |
| DEVSOL-1509 | No se puede editar el campo "muestra" de una API de SmartDocs Ahora puedes establecer el "tipo de MIME del cuerpo", la "documentación del cuerpo" y la "muestra del cuerpo" cuando editas una página de SmartDocs. |
| DEVSOL-1534 | El tipo de contenido no se propaga en el resultado de SmartDocs Ahora, el tipo de contenido se propaga en la página del método de SmartDocs. |
| DEVSOL-1554 | Comparación de fechas no válida en Monetization En la pestaña de planes comprados para los portales para desarrolladores habilitados para la monetización, nunca se mostró el botón "Cancelar" para un plan con una fecha de inicio futura, |
| DEVSOL-1556 | Se envía la 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 SmartDocs PetStore ahora se renderizan correctamente. |
| DEVSOL-1562 | Generar una vista para cada modelo de SmartDocs Cuando se crea 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ó el problema por el que la edición de un método de SmartDocs a veces generaba un error. |
| DEVSOL-1567 | "Agregar modelo" en el menú de administrador superior Se corrigió 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 realizas la actualización a la versión y cambiaste esta vista, deberás revertirla para ver estos cambios. Para ello, sigue estos pasos: # Inicia sesión 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 "revertir", entonces significa que reemplazaste el código con tu propio cambio. Haz clic en "revertir" para volver a colocar la vista en el estado predeterminado. Ten en cuenta que esto quitará cualquier cambio que hayas realizado en esta vista. |
| DEVSOL-1578 | Renderizar los modelos de Weather y Petstore en las instalaciones del sitio Los modelos de SmartDocs de Petstore y Weather se importan 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 15.05.27.00 y 15.06.08.00 de la nube si usabas el tema responsivo de Apigee o un subtema del tema responsivo de Apigee. |
| DEVSOL-1597 | No se puede cambiar la configuración de tiempo de espera para desarrolladores 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 |
Yo, indicador de entorno y actualizaciones de módulos de funciones https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Asegurarse de que arg_separator.output sea '&' para evitar la interrupción de reCAPTCHA Se corrigió un problema relacionado con la plataforma en el que se interrumpía 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 |
Aumentar la versión de admin_views para obtener la corrección de seguridad crítica
|