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
- Mettez à jour et testez la version 15.05.27 dans votre environnement dev ou test sur Pantheon.
- 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.
- 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é.
- 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".
- 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.
- Effectuez un nouveau rendu et publiez la révision de votre modèle.
- 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 :
Les nœuds devraient maintenant s'afficher correctement. |