Connector Builder

Le Connector Builder est un outil d\'intégration API sans code qui vous permet de connecter n\'importe quelle application ou n\'importe quel service personnalisé Cloud. Créez des connecteurs personnalisés (packages) pour diverses applications ou services Web qui utilisent des API et utilisez-les dans vos automatisations.

Remarque :
  • Le Connector Builder est disponible avec AWS et GCP pour Cloud et On-Premises.
  • Connector Builder nécessite la licence Enterprise Platform. Pour plus d\'informations sur les versions prises en charge par cette fonctionnalité, voir Enterprise Platform.

Présentation

Les connecteurs ou packages dans la Control Room sont à la base de tout type d\'automatisation. Un package est créé pour effectuer certaines tâches et la Control Room comprend plusieurs packages à cet effet. Bien que la Control Room fournisse différents packages, vous pouvez créer et utiliser vos packages ou utiliser des packages tiers qui ne sont actuellement pas disponibles dans la Control Room pour vos automatisations. Un connecteur est un package qui relie la Control Room à toute application via une API et qui peut effectuer une ou plusieurs opérations dans cette application : par exemple, créer ou mettre à jour des ressources. Vous remarquerez que connecteur et package sont utilisés de manière interchangeable. Ils font tous deux référence à l\'intégration personnalisée que vous créez avec Connector Builder.

Vous pouvez également importer des fichiers de définition d\'API en utilisant Connector Builder pour créer des connecteurs personnalisés. Connector Builder prend en charge les versions Open API 2.x et 3.x.

Flux de fichiers dans le Connector Builder

Le Connector Builder prend désormais en charge la diffusion de fichiers, ce qui vous permet de créer des packages personnalisés pour les opérations basées sur les fichiers, que vous pouvez utiliser dans des API Tasks. La diffusion de fichiers permet aux packages de gérer des fichiers directement depuis la source de données. La diffusion d\'un fichier binaire à partir de la source élimine la nécessité de télécharger et de charger des fichiers individuellement.

Remarque :
  • Il n\'y a aucune restriction concernant le type et la taille du fichier.
  • Actuellement, les paramètres de corps GraphQL ne sont pas pris en charge.
Actions avec le téléchargement de fichier
Pour les actions impliquant le téléchargement de fichiers, cochez la case Diffuser le(s) fichier(s) lors du téléchargement. Une fois cette case cochée, le système diffuse le fichier pour le téléchargement et vous pouvez attribuer une variable de fichier à ce flux de fichiers. Cette case à cocher est disponible pour toutes les méthodes HTTPS.
Actions avec le chargement de fichier
Pour les actions qui impliquent le chargement de fichiers, ajoutez un paramètre de corps pertinent selon les exigences du fournisseur d\'API. Les paramètres d\'action sur la page de l\'éditeur affichent une option pour parcourir les fichiers.
Si le fournisseur d\'API nécessite un fichier binaire en entrée, sélectionnez Binaire comme type de corps de la requête. Lorsque vous sélectionnez Binaire, cela garantit que le système utilise un flux de fichiers pour le chargement.
Si le fournisseur d\'API exige un paramètre form data dans la requête, sélectionnez Données de formulaire comme type de requête et ajoutez une clé avec le type Fichier. Ceci vous permet de sélectionner une variable de fichier comme entrée pour le chargement en utilisant l\'action que vous créez.

Vous pouvez également combiner les packages personnalisés avec les packages compatibles avec le flux de fichiers préconstruits dans votre flux de travail des API Tasks. Voir File streaming using file variable pour plus d\'informations sur les packages intégrés qui prennent en charge les flux de fichiers.

Avantages

Le Connector Builder est utile dans les scénarios suivants :

  • Pour créer des packages non disponibles dans la Control Room.
  • Pour créer des packages en utilisant des API privées (internes).
  • Pour inclure des actions supplémentaires aux Packages existants disponibles dans la Control Room.
  • Pour créer des packages personnalisés si les Packages disponibles dans la Control Room ne répondent pas à vos besoins.

Exemple de flux de travail

L\'exemple suivant illustre la création, la modification, la configuration des actions et la personnalisation de connecteurs personnalisés :

  1. Créer un connecteur personnalisé
  2. Configurer une action dans l\'éditeur de connecteur
  3. Utilisation de l\'éditeur de connecteur
  4. Publier un connecteur personnalisé
Flux de travail du Connector Builder
Remarque : Lorsque vous créez des packages à l\'aide de l\'outil Connector Builder, vous devez gérer les packages. La gestion des packages comprend la mise à jour des packages, la publication des packages, la correction des éventuelles erreurs et la gestion des versions de package.

Ressources