Consultez la liste des connecteurs compatibles avec Application Integration.

Importer et télécharger des intégrations

Vous pouvez télécharger vos intégrations sous forme de fichier JSON et l'enregistrer dans votre système local. De ce fait, une intégration est disponible dans un fichier que vous pouvez importer directement dans un autre projet d'intégration sans aucune modification. L'importation d'une intégration crée une nouvelle version de l'intégration dans le projet dans lequel le fichier est importé.

L'intégration complète dans un format de fichier vous offre les avantages suivants :
  • Vous pouvez copier votre intégration d'un projet à un autre sans effort.
  • Vous pouvez mettre à jour par programmation le fichier d'intégration pour les modifications répétitives, telles que le changement de nom des tâches ou la modification dynamique des noms de variables.

Télécharger une intégration

Pour télécharger une intégration, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations. La page Integrations (Intégrations) s'affiche.
  3. Sélectionnez une intégration existante. Cela entraîne son ouverture dans l'éditeur d'intégrations.
  4. Cliquez sur la liste déroulante Versions et sélectionnez la version que vous souhaitez télécharger.
  5. Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Télécharger.

    Le fichier INTEGRATION_NAME.json est automatiquement enregistré dans le dossier de téléchargement par défaut de votre navigateur Web.

API

Pour télécharger une intégration, envoyez une requête GET à l'API suivante : GET https://integrations.googleapis.com/v1/projects/*/locations/*/integrations/*/versions/*:download
https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION:download

L'exemple suivant montre comment télécharger une version spécifique d'une intégration :

curl -v -s \
-H "Content-Type: application/json" -H "Authorization: Bearer $TOKEN" \
-H "X-GFE-SSL: yes" \
-X GET "https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11:download"

Pour en savoir plus, consultez la page projects.locations.integrations.versions.download.

Importer une intégration

L'importation d'une intégration crée une nouvelle version de l'intégration dans le projet dans lequel le fichier est importé. Par exemple, si vous avez une intégration nommée IP-Test à la version 5 et que vous importez un fichier d'intégration dans IP-Test, une nouvelle version 6 est créée pour cette intégration.

Si vous ne disposez pas déjà d'une intégration dans laquelle vous pouvez importer un fichier, vous devez d'abord créer une nouvelle intégration, puis importer le fichier. Dans ce cas, la nouvelle intégration que vous créez sera dans la version 1 et l'intégration importée dans la version 2.

Si vous souhaitez importer une intégration existante, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Google Cloud, accédez à la page Application Integration.

    Accéder à Application Integration

  2. Dans le menu de navigation, cliquez sur Intégrations. La page Integrations (Intégrations) s'affiche.
  3. Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.

    Si vous créez une intégration :

    1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
    2. Sélectionnez une région pour l'intégration.
    3. Cliquez sur Créer.

    Cela entraîne l'ouverture de l'intégration dans l'éditeur d'intégrations.

  4. Dans la barre d'outils du concepteur, cliquez sur (menu d'actions), puis sélectionnez Importer.
  5. Dans la boîte de dialogue de l'explorateur de fichiers, sélectionnez le fichier que vous souhaitez importer, puis cliquez sur Ouvrir.

    Une nouvelle version de l'intégration est créée à l'aide du fichier importé.

API

Pour importer une intégration, envoyez une requête POST à l'API suivante :
  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload
  

L'exemple suivant montre comment importer une intégration :

  curl -v -s -H "Content-Type: application/json"  -H "Authorization: Bearer $TOKEN"  \
  -X POST -d '{"content": 
    "{\"name\":\"projects/450954726404/locations/us-east1/integrations/test-workflow/versions/0e90d453-5fcf-4aae-b164-2e8344d1ac11\",
    \"origin\":\"UI\",
    \"snapshotNumber\":\"3\",
    \"updateTime\":\"2022-01-06T04:26:58.137Z\",
    \"lockHolder\":\"abc@test.com\",
    \"createTime\":\"2022-01-06T04:26:42.734Z\",
    \"lastModifierEmail\":\"abc@test.com\",
    \"state\":\"DRAFT\",
    \"triggerConfigs\":[{\"label\":\"API Trigger\",\"startTasks\":[{\"taskId\":\"1\"}],
    \"properties\":{\"Trigger name\":\"rj-test-workflow_API_1\"},\"triggerType\":\"API\",\"triggerNumber\":\"1\",\"triggerId\":\"api_trigger/rj-test-workflow_API_1\"}],\"taskConfigs\":[{\"task\":\"EmailTask\",\"taskId\":\"1\",\"taskExecutionStrategy\":\"WHEN_ALL_SUCCEED\",\"displayName\":\"Send Email\"}]}"}' 
    \https://integrations.googleapis.com/v1/projects/demo-project/locations/us-east1/integrations/test-integration/versions:upload
  

Pour en savoir plus, consultez la page projects.locations.integrations.versions.upload.

Étape suivante