Caricare e scaricare integrazioni

Puoi scaricare le integrazioni come file JSON e salvarle nel tuo sistema locale. Di conseguenza, l'intera integrazione è disponibile in un file, che puoi caricare direttamente in un altro progetto di integrazione senza alcuna modifica. Il caricamento di un'integrazione crea una nuova versione dell'integrazione nel progetto in cui viene caricato il file.

Avere un'intera integrazione in un formato file offre i seguenti vantaggi:
  • Puoi copiare l'integrazione da un progetto a un altro senza troppa fatica.
  • Puoi aggiornare il file di integrazione in modo programmatico per modifiche ripetitive, ad esempio la ridenominazione delle attività o la modifica dinamica dei nomi delle variabili.

Scaricare un'integrazione

Per scaricare un'integrazione, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Application Integration.

    Vai ad Application Integration

  2. Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire la pagina Integrazioni.
  3. Seleziona un'integrazione esistente. Si apre l'integrazione nell'editor integrazioni.
  4. Fai clic sul menu a discesa Versioni e seleziona la versione da scaricare.
  5. Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Scarica.

    Il file INTEGRATION_NAME.json viene salvato automaticamente nella cartella di download predefinita del browser web.

API

Per scaricare un'integrazione, invia una richiesta GET alla seguente API: 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'esempio seguente mostra come scaricare una versione specifica di un'integrazione:

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"

Per ulteriori informazioni, vedi projects.locations.integrations.versions.download.

Caricare un'integrazione

Il caricamento di un'integrazione crea una nuova versione dell'integrazione nel progetto in cui viene caricato il file. Ad esempio, se hai un'integrazione con il nome IP-Test alla versione 5 e carichi un file di integrazione in IP-Test, viene creata una nuova versione 6 per l'integrazione.

Se non hai un'integrazione esistente in cui caricare un file, devi prima crearne una nuova e poi caricarlo. In questo caso, la nuova integrazione che crei sarà alla versione 1 e l'integrazione caricata sarà alla versione 2.

Se hai un'integrazione esistente che vuoi caricare, seleziona una delle seguenti opzioni:

Console

  1. Nella console Google Cloud, vai alla pagina Application Integration.

    Vai ad Application Integration

  2. Fai clic su Integrazioni nel menu di navigazione a sinistra per aprire la pagina Integrazioni.
  3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Fai clic su Crea.

    Si apre l'integrazione nell'editor integrazioni.

  4. Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Carica.
  5. Nella finestra di dialogo del browser dei file, seleziona il file che vuoi caricare e fai clic su Apri.

    Viene creata una nuova versione dell'integrazione utilizzando il file caricato.

API

Per caricare un'integrazione, invia una richiesta POST alla seguente API: 
  https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload

Il seguente esempio mostra come caricare un'integrazione:

  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

Per ulteriori informazioni, vedi projects.locations.integrations.versions.upload.

Passaggi successivi