15.05.27.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 2 de junio de 2015, lanzamos una nueva versión en la nube del Portal de servicios para desarrolladores de Apigee.

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.

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-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-642 Mueve la configuración a nivel del cliente de la configuración de seguridad a la configuración de plantillas
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-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-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 durante la fase de DG
SmartDocs ahora se encuentra en el menú de contenido, y la configuración de smartdocs está en el menú de configuración de administrador.
DEVSOL-1390 La biblioteca de Edge del SDK de PHP se actualizó para corregir el problema de llamar a __toStringString()
Se actualizó la biblioteca de PHP SDK Edge para corregir el problema de llamar a __toApigeeString() en el objeto DeveloperRatePlan que crea el siguiente error: {cita} Error irrecuperable: Call to a member function format() en un no objeto en /Applications/MAMP/htdocs/ordnance/presupuesto de los clientes.
DEVSOL-1398 Modelo de Petstore de SmartDocs importado durante 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 ejecutaba cron de Drupal, una gran cantidad de desarrolladores causaron un problema de tiempo de espera. Cuando una organización tiene más de 200 usuarios, ahora se usa un proceso por lotes.
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.

Problemas conocidos

Esta versión tiene los siguientes problemas conocidos:

ID del problema Descripción
DEVSOL-1558
Las páginas de métodos de SmartDocs de ejemplo de Petstore no se renderizan correctamente en una instalación nueva
Las páginas del método de Petstore de ejemplo en SmartDocs no se procesan correctamente en una instalación nueva. Para solucionar este problema, haz lo siguiente:
  1. En el menú de Drupal, selecciona Contenido > SmartDocs.
  2. Selecciona el modelo “Petstore Example”.
  3. En Opciones de actualización, selecciona Procesar y publicar nodos.
  4. Haz clic en la casilla de verificación Seleccionar o anular la selección de todos los nodos para seleccionar todos los nodos.
  5. Haz clic en Actualizar.

Los nodos deberían renderizarse correctamente.