Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
El martes 8 de septiembre de 2015, lanzamos una versión trimestral del portal de servicios para desarrolladores de Apigee Edge para nube privada.
El nombre anterior del producto “Portal de servicios para desarrolladores locales de Apigee Edge” o “OPDK” ahora es “Portal de servicios para desarrolladores de Apigee Edge para la nube privada”.
Si tienes preguntas, ve a 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 quieres conectar 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 todas las funciones de SmartDocs sean compatibles. Consulta las 4.15.07.00: Notas de la versión de Apigee Edge para la nube privada para obtener más información.
Funciones nuevas
Disponibilidad general de SmartDocs
SmartDocs pasará de estar beta a 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, así como la 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 en el menú Contenido > SmartDocs en Drupal.
- Lo que se conoció como la autenticación de "token personalizado" ahora se denomina "clave de API".
- Objetos de “seguridad” de autenticación definidos a nivel de revisión
- Configuración de la autenticación de cliente a nivel de plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.
Para ver más descripciones de funciones, consulta esta entrada de blog.
Si deseas ver la documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período beta, las funciones y capacidades nuevas en 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 cambios en las páginas existentes o nuevas.
Ten en cuenta que, si bien puedes procesar y publicar SmartDocs dentro de tu portal para desarrolladores, SmartDocs se generan a partir del modelo de API que se encuentra en los servicios de administración de API perimetral 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 como existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si has estado importando documentos de Swagger o WADL, vuelve a importarlos a una revisión nueva.
- Si has mantenido tu modelo de API mediante el módulo de SmartDocs, exporta como archivo JSON de SmartDocs y, luego, impórtalo a tu modelo nuevo mediante el archivo adjunto.
- Configura las propiedades de seguridad de la revisión de tu modelo. En la página Contenido > SmartDocs > modelo, selecciona Configuración de seguridad.
- Verifica cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs) haciendo clic en Configuración en la columna Operaciones.
- Actualiza las plantillas personalizadas para usar la v6 de los elementos de CSS y JS, y realiza cambios para que reflejen cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Si quieres obtener información sobre la actualización de plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
- Vuelve a renderizar y publica la revisión del modelo.
- Después de validar la documentación nueva, actualiza tu portal de production a la versión 15.05.27.
Si eres cliente de una empresa 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 configurar el formato de día en la monetización El formato de fecha ahora se puede configurar en Monetización en la configuración de monetización para los formatos de fecha europeo y de 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 hacían las llamadas. |
| DEVSOL-603 | La página del plan de conflictos tiene un formato incorrecto Cuando compras un plan que se superpone con un plan existente, la página que se muestra ahora tiene el 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 el valor vacío Se corrige el problema por el que no se pueden editar los parámetros de la plantilla 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 | Error en la importación de SmartDocs para mostrar mensajes fáciles de usar |
| DEVSOL-1013 | 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 del perfil ya no se inhabilitará, y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
| DEVSOL-1244 | No habilitar el módulo indicador de entorno para las versiones de OPDK |
| DEVSOL-1273 | "DevConnect Mint" aparece dos veces en la lista Modules En Modules, "Dev Connect Mint" se mostró dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Admite archivos JSON/YAML o importación de URL tanto para Swagger como de WADL Los archivos WADL ahora se pueden importar a través de URL y se pueden subir archivos de 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, en el menú de configuración de administrador. |
| DEVSOL-1340 | Quitar la versión beta cuando se pasa a la fase de DG |
| DEVSOL-1390 |
Se actualizó la biblioteca perimetral del SDK de PHP para corregir el problema de llamar a __toString() Error irrecuperable: Llamada a un miembro function format() en un no objeto en /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/librarias/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 solicitar al usuario SmartDocs ahora importa el ejemplo de swagger de la tienda de mascotas 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 Drupal cron, 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 perimetral no funciona para minimizar los problemas de solución de problemas. |
| DEVSOL-1422 | Quita el formulario de configuración de SMTP del perfil de Apigee El proceso de instalación ya no te preguntará si quieres configurar SMTP. En su lugar, 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 de forma correcta. |
| DEVSOL-1427 |
Agrega hooks al módulo de apps para desarrolladores de Devconnect a fin de permitir modificar 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 para desarrolladores. |
| DEVSOL-1464 | Error irrecuperable cuando se guarda la configuración de Auth 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 | Vínculo del menú Crear "APIs" y 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 denominado "APIs", que se vincula a cualquier modelo con métodos publicados. |
| DEVSOL-1486 | Las llamadas de SmartDocs se pueden autenticar con una clave predefinida Habilita la autenticación con claves de API proporcionadas de forma previa y por el usuario. |
| DEVSOL-1499 | No se analiza el código HTML en las descripciones de los parámetros de SmartDocs El código HTML ahora se analiza en las descripciones de los parámetros de SmartDocs. |
| DEVSOL-1507 | No se pueden agregar varios parámetros a una API con Add Method Ahora puedes agregar varios parámetros a una API de SmartDocs cuando editas el método. |
| DEVSOL-1509 | No se ve una forma de editar el campo "muestra" para la API de SmartDocs Ahora puedes configurar el "Tipo de MIME del cuerpo", la "Documentación del cuerpo" y la "Muestra del cuerpo" cuando edites una página de SmartDocs. |
| DEVSOL-1534 | El tipo de contenido no se propagó en el resultado de SmartDocs Ahora se propagará el tipo de contenido en la página del método de SmartDocs. |
| DEVSOL-1554 | Comparación de fechas no válidas en la monetización En la pestaña del plan comprado 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 está enviando una versión anterior de los módulos de Drupal Se actualizaron los módulos 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 procesan correctamente. |
| DEVSOL-1562 | Genera 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 SmartDocs genera un error irrecuperable Se solucionó el problema por el que, a veces, la edición de un método de SmartDocs generaba un error. |
| DEVSOL-1567 | Se muestra la opción"Agregar modelo" en el menú Administrador superior Se corrigió el problema por el que se mostraba el elemento de menú "Agregar modelo" en el menú Administrador superior. |
| DEVSOL-1576 | La vista de la 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ú muestra el nombre interno del modelo en lugar del nombre visible. Si estás actualizando la versión y cambiaste esta vista, deberás revertirla para ver estos cambios siguiendo 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 la opción “revertir”, entonces reemplazaste el código con tu propio cambio. Haz clic en "revertir" para que la vista vuelva al estado predeterminado. Tenga en cuenta que esto quitará los cambios que haya realizado en esta vista. |
| DEVSOL-1578 | Renderiza los modelos de Weather y Petstore en las instalaciones del sitio Tanto los modelos de Petstore como los de Petstore se importan en los sitios nuevos. |
| DEVSOL-1584 | No se pueden comprar los planes Se corrigió el problema por el que el formulario de compra de los 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 del tema responsivo de Apigee. |
| DEVSOL-1597 | No se puede cambiar la configuración de tiempo de espera del desarrollador Se corrigió un error en el que la configuración del tiempo de espera de la conexión perimetral no se aplicaba correctamente. |
| DEVSOL-1620 |
Actualizaciones de seguridad y del módulo me, indicador de entorno y módulos de funciones https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Asegúrate de que arg_separator.output tenga el valor '&' para evitar fallas en reCAPTCHA Se solucionó un problema relacionado con la plataforma en el que se produjo un error en el uso de reCAPTCHA de Google. |
| DEVSOL-1651 | El tema base de Apigee falla si el módulo smartdocs no está habilitado El tema apigee_base ya no depende de que se habilite el módulo SmartDocs. |
| DEVSOL-1654 |
Modifica la versión de admin_views para recoger una corrección de seguridad crítica
|