Vous consultez la documentation d'Apigee Edge.
Consultez la
documentation Apigee X. en savoir plus
Le mardi 8 septembre 2015, nous avons publié une version trimestrielle du portail de services pour les développeurs Apigee Edge pour le cloud privé.
L'ancien nom de produit "Portail de services pour les développeurs sur site Apigee" ou "OPDK" a été remplacé par "Portail de services pour les développeurs Apigee Edge pour le cloud privé".
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.
Configuration requise pour Apigee Edge pour le portail
Si vous connectez cette version du portail à une installation Edge for Private Cloud, vous devez ensuite la connecter à la version 4.15.07.00 ou ultérieure pour vous assurer que toutes les fonctionnalités de SmartDocs sont prises en charge. Pour plus d'informations, consultez la page 4.15.07.00 - Notes de version d'Apigee Edge pour le cloud privé.
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-584 | Paramètre de chemin non mémorisé lors de la première utilisation Le paramètre de chemin d'accès lors des appels n'était pas toujours mémorisé. |
| 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-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-723 | Afficher des messages conviviaux en cas d'échec de l'importation SmartDocs |
| 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-1244 | Ne pas activer le module d'indicateur d'environnement pour les versions d'OPDK |
| 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 lorsque vous passez à GA |
| DEVSOL-1390 |
La bibliothèque PHP SDK Edge a été mise à jour afin de résoudre le problème lié à l'appel de __toString() Erreur fatale: appel à une fonction membre format() sur un objet non-objet dans /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/library/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php à la ligne 221 Il s'agit d'un bug qui n'affecte que les clients de la monétisation qui disposent d'un code personnalisé appelant la méthode toString(). |
| DEVSOL-1398 | Modèle d'animaux SmartDocs importé lors de l'installation sans invite d'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 plus exhaustif d'utilisation 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 causaient 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-1410 | Erreurs de connexion non visibles lors de l'installation du portail de développement Amélioration des messages d'erreur destinés au programme d'installation lorsque la connexion à la gestion Edge ne fonctionne pas afin de réduire les problèmes de dépannage. |
| DEVSOL-1422 | Supprimer le formulaire de configuration SMTP du profil Apigee Le processus d'installation ne vous demande plus si vous souhaitez configurer SMTP. Vous pouvez le faire une fois l'installation terminée en suivant la pratique standard de Drupal consistant à activer le module SMTP et à le configurer correctement. |
| DEVSOL-1427 |
Ajoutez des hooks au module d'applications de développeur Devconnect pour permettre la modification des données d'analyse # hook_devconnect_developer_apps_analytics_chart_data_alter(). # hook_devconnect_developer_app_analytics_datapoints_params_alter() # hook_devconnect_developer_app_analytics_datapoints_alter() Ils permettent aux modules personnalisés de modifier le graphique d'analyse d'applications du développeur. |
| DEVSOL-1464 | Erreur fatale lors de l'enregistrement des paramètres d'authentification d'un modèle Lorsqu'un schéma de sécurité est supprimé, une case à cocher permet désormais de sélectionner si le schéma d'authentification de modèle associé doit également être supprimé. |
| DEVSOL-1470 | Créer un lien vers le menu "API" et la vue correspondante |
| DEVSOL-1486 | Les appels SmartDocs peuvent s'authentifier avec une clé prédéfinie Active l'authentification avec des clés API prédéfinies et fournies par l'utilisateur. |
| DEVSOL-1499 | Code HTML non analysé dans les descriptions de paramètres SmartDocs Le code HTML est désormais analysé dans les descriptions de paramètres SmartDocs. |
| DEVSOL-1507 | Impossible d'ajouter plusieurs paramètres à une API avec l'option "Ajouter une méthode" Vous pouvez désormais ajouter plusieurs paramètres à une API SmartDocs lorsque vous modifiez la méthode. |
| DEVSOL-1509 | Aucun moyen de modifier le champ "exemple" pour une API SmartDocs Vous pouvez désormais définir le type MIME du corps, la documentation du corps et l'échantillon du corps lorsque vous modifiez une page SmartDocs. |
| DEVSOL-1534 | Le type de contenu n'est pas renseigné dans la sortie SmartDocs Le type de contenu est désormais renseigné sur la page de méthode SmartDocs. |
| DEVSOL-1554 | Comparaison des dates non valides dans la monétisation Dans l'onglet des forfaits achetés pour les portails pour développeurs où la monétisation est activée, le bouton "Annuler" ne s'affiche jamais pour un plan dont la date de début est située dans le futur. |
| DEVSOL-1556 | Ancienne version des modules Drupal disponible La dernière version du module media_youtube et des fonctionnalités a été mise à jour. |
| DEVSOL-1558 | Les pages de méthode SmartDocs ne s'affichent pas pour l'exemple PetStore Lors des nouvelles installations, les exemples de méthodes SmartDocs pour PetStore s'affichent désormais correctement. |
| DEVSOL-1562 | Générer une vue pour chaque modèle SmartDocs Lorsque vous créez un modèle, une vue est créée par défaut pour ce modèle. |
| DEVSOL-1565 | La modification de la méthode SmartDocs génère une erreur fatale Résolution du problème où la modification d'une méthode SmartDocs générait parfois une erreur. |
| DEVSOL-1567 | "Ajouter un modèle" s'affichait dans le menu "Administration" en haut de l'écran Correction du problème d'affichage de l'élément de menu "Ajouter un modèle" dans le menu "Administration" supérieur. |
| DEVSOL-1576 | La vue "Documentation" de l'API affiche le nom du modèle, et non le nom à afficher La page de documentation de l'API qui s'affiche lorsque vous cliquez sur "API" dans le menu affichait le nom interne du modèle au lieu du nom à afficher. Si vous effectuez une mise à jour vers cette version et que vous avez modifié cette vue, vous devrez rétablir l'affichage pour voir ces modifications en procédant comme suit: # Connectez-vous en tant qu'administrateur # Accédez à Structure > Vues # Cliquez sur le menu déroulant à côté de "Modifier" dans "Modèles SmartDocs" pour afficher toutes les opérations. # Si "revers" s'affiche, cela signifie que vous avez écrasé le code en ajoutant votre propre modification. Cliquez sur "Rétablir" pour rétablir l'état par défaut de la vue. Notez que toutes les modifications apportées à cette vue seront supprimées. |
| DEVSOL-1578 | Affichez les modèles Weather et animaux de compagnie lors des installations sur le site Les modèles SmartDocs de Weather et de Weather sont importés sur les nouveaux sites. |
| DEVSOL-1584 | Impossible d'acheter des forfaits Correction d'un problème empêchant l'envoi du formulaire d'achat des forfaits de monétisation pour les versions cloud 15.05.27.00 et 15.06.08.00 si vous utilisiez le thème Apigee Responsive ou un sous-thème du thème Apigee Responsive. |
| DEVSOL-1597 | Impossible de modifier les paramètres de délai d'inactivité pour les développeurs Un bug dans lequel les paramètres de délai avant expiration de la connexion Edge n'étaient pas correctement appliqués a été corrigé. |
| DEVSOL-1620 |
Mises à niveau de l'indicateur d'environnement et du module de fonctionnalités https://www.drupal.org/project/me https://www.drupal.org/project/environment_indicator |
| DEVSOL-1648 | Assurez-vous que arg_separator.output est bien "&" pour éviter le dysfonctionnement de reCAPTCHA Un problème lié à la plate-forme a entraîné l'interruption de l'utilisation de reCAPTCHA de Google. |
| DEVSOL-1651 | Le thème Apigee Base échoue si le module SmartDocs n'est pas activé Le thème apigee_base n'est plus dépendant de l'activation du module SmartDocs. |
| DEVSOL-1654 |
Version améliorée de admin_views pour récupérer le correctif de sécurité critique
|