4.15.07.00: Notas de la versión del portal de servicios para desarrolladores de Apigee

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

  1. Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Pantheon.
  2. 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.
  3. Configura las propiedades de seguridad de la revisión de tu modelo. En la página Contenido > SmartDocs > modelo, selecciona Configuración de seguridad.
  4. 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.
  5. 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.
  6. Vuelve a renderizar y publica la revisión del modelo.
  7. 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()
Se actualizó la biblioteca perimetral del SDK de PHP para corregir el problema de llamar a __toString() en el objeto DeveloperRatePlan que crea este error:

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
El módulo devconnect_developer_apps ahora proporciona tres hooks nuevos:

# 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
Actualizaciones de seguridad moderadas para el módulo me y actualizaciones del módulo para el indicador y las funciones del entorno. Más información:

https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator

https://www.drupal.org/project/features

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
Se actualizaron los siguientes módulos de contribución:

  • Vistas administrativas
  • Migra
  • Redireccionamiento
  • Redis
  • Operaciones masivas de vistas