15.05.27.00 : Notes de version du portail des services pour les développeurs Apigee

Vous consultez la documentation d'Apigee Edge.
Consultez la documentation Apigee X.
en savoir plus

Le mardi 2 juin 2015, nous avons lancé une nouvelle version cloud du portail de services pour les développeurs Apigee.

Pour toute question, consultez le service client Apigee.

Pour obtenir la liste de toutes les notes de version d'Apigee Edge, consultez les notes de version d'Apigee.

Nouvelles fonctionnalités

Disponibilité générale de SmartDocs

SmartDocs passe de la version bêta à la disponibilité générale. Voici quelques-unes des mises à jour et des nouvelles fonctionnalités:

  • Prise en charge de Swagger 2.0, y compris l'importation par fichier ou URL, et compatibilité avec les objets de sécurité portant un nom personnalisé.
  • Améliorations apportées à la conception visuelle des modèles qui génèrent des SmartDocs.
  • Amélioration de la facilité d'utilisation et des workflows dans le portail des développeurs, via le menu Contenu > SmartDocs de Drupal.
  • Le processus d'authentification par "jeton personnalisé" s'appelle désormais "clé API".
  • Objets "sécurité" de l'authentification définis au niveau de la révision
  • Configuration de l'authentification du client au niveau du modèle. Les nouvelles révisions ne réinitialisent plus les identifiants client SmartDocs préconfigurés.

Pour obtenir d'autres descriptions de fonctionnalités, consultez cet article de blog.

Pour la documentation sur SmartDocs, consultez Utiliser SmartDocs pour documenter des API.

Processus de mise à niveau de SmartDocs

Si vous avez déjà utilisé SmartDocs pendant la phase bêta, vous devez mettre à niveau SmartDocs dans votre portail des développeurs pour profiter des nouvelles fonctionnalités de la version en disponibilité générale.

Toutes les pages SmartDocs déjà publiées sur votre portail des développeurs continueront de fonctionner, mais vous devrez suivre le processus de mise à jour avant de modifier ou de publier des modifications apportées à des pages nouvelles ou existantes.

Gardez à l'esprit que bien que vous puissiez afficher et publier des SmartDocs sur votre portail des développeurs, les SmartDocs sont générés à partir du modèle d'API qui réside dans les services de gestion d'API Edge d'Apigee. Toutes les modifications que vous apportez à un modèle d'API dans Edge sont les mêmes dans tous vos environnements Pantheon (de la même manière que les développeurs existent dans les environnements Pantheon).

Pour passer de la version bêta de SmartDocs à la disponibilité générale

  1. Mettez à jour et testez la version 15.05.27 dans votre environnement dev ou test sur Pantheon.
  2. Créez un modèle pour remplacer tout modèle d'API existant que vous utilisez.
    • Si vous avez importé des documents Swagger ou WADL, réimportez-les dans une nouvelle révision.
    • Si vous avez géré votre modèle d'API via le module SmartDocs, exportez-le au format JSON SmartDocs et importez-le dans votre nouveau modèle à l'aide d'un fichier en pièce jointe.
  3. Définissez les propriétés de sécurité de la révision de votre modèle. Sur la page Contenu > SmartDocs > Modèle, sélectionnez Paramètres de sécurité.
  4. Vérifiez toute authentification préconfigurée sur la page des paramètres du modèle (Contenu > SmartDocs) en cliquant sur Paramètres dans la colonne "Opérations".
  5. Mettez à jour les modèles personnalisés pour utiliser la version 6 des éléments CSS et JS, et apportez les modifications nécessaires pour refléter les nouveaux noms d'objets, tels que authSchemes et apiSchema. Pour en savoir plus sur la mise à jour des modèles SmartDocs, consultez Utiliser SmartDocs pour documenter des API.
  6. Effectuez un nouveau rendu et publiez la révision de votre modèle.
  7. Après avoir validé la nouvelle documentation, mettez à jour votre portail de production vers la version 15.05.27.

Si vous êtes un client Edge Enterprise et que vous avez des questions ou des préoccupations concernant le processus de mise à niveau, veuillez envoyer un e-mail à marsh@apigee.com et cnovak@apigee.com. Sinon, veuillez faire appel à la communauté Apigee pour obtenir une réponse optimale.

Bugs résolus

Les bugs suivants sont résolus dans cette version.

ID du problème Description
DEVSOL-487 Les administrateurs doivent pouvoir configurer le format de la date dans la section "Monétisation"
Le format de la date peut désormais être configuré dans la section "Monétisation" des paramètres de monétisation pour les formats de date européens et américains.
DEVSOL-603 La page du plan en conflit est mal mise en forme
Lorsque vous achetez un plan qui chevauche un plan existant, la page affichée est désormais correctement mise en forme pour l'utilisateur.
DEVSOL-642 Déplacer les configurations au niveau du client des paramètres de sécurité vers les paramètres des modèles
DEVSOL-709 SmartDocs: paramètre de modèle d'URL non modifiable après l'envoi d'une requête avec une valeur vide
Correction du problème qui rendait les paramètres de modèle non modifiables après l'envoi de la requête à partir de SmartDocs après la suppression du paramètre de modèle dans la documentation de la méthode.
DEVSOL-1013 Rendre les adresses e-mail des utilisateurs du portail des développeurs modifiables
Le champ d'adresse e-mail de la page de modification du profil ne sera plus désactivé, et les développeurs pourront modifier leur adresse e-mail.
DEVSOL-1273 "DevConnect Mint" s'affiche deux fois dans la liste des modules
Sous "Modules", "Dev Connect Mint" s'est affiché deux fois. Ce problème est maintenant résolu.
DEVSOL-1313 Prise en charge de l'importation de fichiers JSON/YAML ou d'URL pour Swagger et WADL
Vous pouvez désormais importer des fichiers WADL via une URL, et des fichiers Swagger.
DEVSOL-1339 Modifier l'emplacement du menu "Administration" de SmartDocs
SmartDocs se trouve désormais dans le menu "Contenu" et les paramètres des documents intelligents dans le menu d'administration des paramètres.
DEVSOL-1340 Supprimer la version bêta en accédant à GA
SmartDocs se trouve désormais dans le menu "Contenu" et les paramètres SmartDocs dans le menu d'administration des paramètres.
DEVSOL-1390 La bibliothèque Edge du SDK PHP a été mise à jour afin de résoudre le problème d'appel de __toString()
La bibliothèque __toString() du SDK PHP a été mise à jour pour résoudre le problème lié à l'appel de __toString() sur l'objet DeveloperRatePlan qui crée l'erreur suivante: {citation} Erreur fatale: appel à une fonction membre format() sur un objet non objet dans /Applications/MAMP/ApigeeMintdocs/ordMint/doc-root/php
DEVSOL-1398 Modèle d'animaux domestiques SmartDocs importé lors de l'installation sans invite de l'utilisateur
SmartDocs importe désormais l'exemple de publicité pour animaux lors de l'installation du site (http://petstore.swagger.io/v2/swagger.json) au lieu du modèle météo afin de disposer d'un exemple d'utilisation plus exhaustif de SmartDocs.
DEVSOL-1407 Cron échoue en présence de nombreux développeurs
Lors de l'exécution de Drupal Cron, un grand nombre de développeurs ont causé un problème de délai d'inactivité. Lorsqu'une organisation compte plus de 200 utilisateurs, un traitement par lot est désormais utilisé.
DEVSOL-1470 Créer un lien vers le menu "API" et la vue correspondante

Problèmes connus

Cette version contient les problèmes connus suivants:

ID du problème Description
DEVSOL-1558
Les exemples de pages de méthode SmartDocs pour Petstore ne s'affichent pas correctement dans une nouvelle installation
Les exemples de pages de méthode animaux de compagnie dans SmartDocs ne s'affichent pas correctement dans une nouvelle installation. Pour résoudre ce problème :
  1. Sélectionnez Contenu > SmartDocs dans le menu Drupal.
  2. Sélectionnez le modèle "Petstore Example" (Exemple pour animaux de compagnie).
  3. Sélectionnez Afficher et publier les nœuds sous Options de mise à jour.
  4. Cochez la case Sélectionner / Désélectionner tout pour sélectionner tous les nœuds.
  5. Cliquez sur Update (Mettre à jour).

Les nœuds devraient maintenant s'afficher correctement.