Créez un flux pour une API à l'aide d' IBM® App Connect Enterprise Designer.
A propos de cette tâche
Vous pouvez définir des modèles, des opérations et des flux pour une API. Pour plus d'informations sur les API, voir Développement de solutions d'intégration à l'aide d'API REST.
La procédure de cette tâche décrit comment créer un nouveau flux. Par ailleurs, si vous avez accès à un flux existant qui répond partiellement à vos besoins, vous pouvez importer le flux comme décrit dans Importation d'un flux, puis le modifier dans l'éditeur d'API comme décrit dans cette rubrique.
Vous pouvez également créer un nouveau flux à l'aide d'un modèle IBM App Connect Enterprise Designer, comme décrit dans Création d'un flux à partir d'un modèle.
Procédure
- Accédez à l'éditeur d'API en utilisant l'une des méthodes suivantes :
- Dans le menu de navigation de la barre latérale, cliquez sur Home pour ouvrir la page Home.
- Cliquez sur Créer des flux pour une API pour ouvrir l'éditeur d'API.
- Dans le menu de navigation latéral, cliquez sur « Design » pour ouvrir la page « Design ». Tous les flux que vous avez créés auparavant sont affichés.
- Cliquez sur Créer pour ouvrir le menu.
- Sélectionnez pour ouvrir l'éditeur API.
L'éditeur API s'ouvre. Les onglets Designer, OpenAPI et Batch sont visibles.
- Sélectionnez l'onglet Designer.
- Dans Nom du modèle, entrez un nom pour votre modèle ; par exemple, myModel.
- Cliquez sur Créer un modèle pour ouvrir la page de configuration de myModel.
L'onglet Propriétés et l'onglet Opérations sont visibles.
- Sélectionnez l'onglet Propriétés.
- Dans la section "Ajouter des propriétés à votre modèle", entrez une propriété pour votre modèle dans Nom de la propriété ; par exemple CustomerName.
- Sélectionnez un type pour la propriété ; par exemple, Chaîne.
À l'étape 9, vous avez la possibilité d'ajouter d'autres propriétés à partir d'une application si vous la sélectionnez dans la page Catalogue. Pour tous les nœuds de connecteur de concepteur pour lesquels vous n'avez pas créé de compte dans la section Création de comptes, vous devez créer un compte avant d'ajouter la propriété en effectuant l'étape 8.
- Optionnel : Créez un compte et configurez le connecteur en utilisant l'une des méthodes suivantes :
- S'il existe des comptes, ils sont répertoriés dans un menu intitulé Comptes :
- Cliquez sur la flèche vers le bas pour faire défiler le menu et sélectionnez .
- Entrez vos données d'identification.
- Sélectionnez l'action que vous souhaitez que le connecteur effectue. Par exemple, pour le connecteur Slack, vous pouvez sélectionner
- Saisissez les informations nécessaires pour configurer le connecteur.
- Cliquez sur Connecter pour créer votre compte.
Pour plus d'informations sur l'identification des détails de connexion, voir les guides pratiques des applications.
- S'il n'y a pas de compte existant, créez un nouveau compte en suivant les étapes suivantes :
- Cliquez sur Connexion.
- Entrez vos données d'identification.
- Cliquez sur Connexion.
- Sélectionnez l'action que vous souhaitez que le connecteur effectue. Par exemple, pour le connecteur Slack, vous pouvez sélectionner
- Saisissez les informations nécessaires pour configurer le connecteur.
- Cliquez sur Connect pour ajouter le connecteur configuré à votre flux.
- Facultatif : ajoutez d'autres propriétés à l'aide de l'une des méthodes suivantes :
- Ajoutez d'autres propriétés en cliquant sur Add property et en saisissant des valeurs pour Property name ; par exemple, OrderNumber et en sélectionnant des valeurs pour le type dans le menu déroulant ; par exemple, Number.
- Ajoutez d'autres propriétés en cliquant sur Sélectionner des propriétés à partir d'applications, et en sélectionnant une application dans la liste. Par exemple, les flux remboursables par anticipation (Callable Flows). Vous pouvez également vous connecter à d'autres applications en cliquant sur Applications et en sélectionnant une application sur la page Catalogue. Par exemple, Slack.
When you finish adding all of your required properties, click Ajouter un bien.
- Dans la page de configuration du modèle, sélectionnez l'onglet Opérations.
- Cliquez sur Sélectionner une opération à ajouter pour ouvrir le menu déroulant.
- Sélectionnez une opération. Par exemple, si vous avez saisi myModel dans Nom du modèle à l'étape 3, vous pouvez sélectionner l'option de menu .
- Cliquez sur Mettre en œuvre le flux pour ouvrir le flux dans une fenêtre d'édition.
La fenêtre de l'éditeur s'ouvre. Un nœud de demande et un nœud de réponse sont affichés.
- Modifiez le flux selon vos besoins en cliquant sur les nœuds pour ouvrir une page de configuration.
- Pour le nœud Request, cliquez sur Exemple de données pour afficher le tableau Contexte et données d'échantillonnage. Mettez à jour les valeurs de CustomerName et OrderNumber en fonction des besoins. Par exemple, "Smith" et "123."
Fermez la page de configuration en cliquant sur x.
- Pour le nœud Réponse, mettez à jour les champs comme il se doit. Si vous le souhaitez, cliquez sur Données de l'échantillon, Insérer une correspondance ou Insérer une fonction et sélectionnez les options souhaitées dans les menus déroulants.
Fermez la page de configuration en cliquant sur x pour revenir à la fenêtre d'édition où le flux est sauvegardé automatiquement.
- Cliquez Done.
Le flux est prêt à être testé. L'état est affiché comme "Draft (prêt à être déployé)"
- Renommer le flux en modifiant le champ nom.
Etape suivante
Testez votre flux API comme décrit dans la section Test d'un flux pour une API.