Consulta i connettori supportati per Application Integration.
Caricare e scaricare le integrazioni
Puoi scaricare le integrazioni come file JSON e salvarlo 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.
L'intera integrazione in un formato file offre i seguenti vantaggi:- Puoi copiare l'integrazione da un progetto all'altro senza fatica.
- Puoi aggiornare in modo programmatico il file di integrazione per modifiche ripetitive, come la ridenominazione di attività o la modifica dinamica dei nomi delle variabili.
Scaricare un'integrazione
Per scaricare un'integrazione, segui questi passaggi:
- Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
- Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Elenco delle integrazioni.
- Seleziona un'integrazione esistente. L'integrazione viene aperta nell'editor di integrazione.
- Fai clic sul menu a discesa Versioni e seleziona la versione da scaricare.
- Nella barra degli strumenti del designer, fai clic su
Il file INTEGRATION_NAME.json viene salvato automaticamente nella cartella dei download predefinita del browser web.
(menu Azioni) e seleziona Scarica.
Carica un'integrazione
Per caricare un'integrazione, segui questi passaggi:
- Nella console Google Cloud, vai alla pagina Application Integration (Integrazione di applicazioni).
- Nel menu di navigazione, fai clic su Integrations (Integrazioni). Viene visualizzata la pagina Elenco delle integrazioni.
- Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.
Se stai creando una nuova integrazione:
- Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
- Seleziona una regione per l'integrazione.
- Fai clic su Crea.
L'integrazione viene aperta nell'editor di integrazione.
- Nella barra degli strumenti del designer, fai clic su (menu Azioni) e seleziona Carica.
- Nella finestra di dialogo del browser di file, seleziona il file che vuoi caricare, quindi fai clic su Apri.
Viene creata una nuova versione dell'integrazione utilizzando il file caricato.
Download e caricamento tramite API
Puoi utilizzare le API di integrazione per caricare o scaricare un'integrazione.
Scarica l'integrazione utilizzando l'API
Per scaricare un'integrazione, invia una richiestaGET
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
.
Carica integrazione utilizzando l'API
Per caricare un'integrazione, invia una richiestaPOST
alla seguente API:
https://integrations.googleapis.com/v1/projects/$YOUR_GOOGLE_PROJECT_ID/locations/$PROJECT_LOCATION/integrations $INTEGRATION_NAME/versions/$INTEGRATION_VERSION}:upload
L'esempio seguente 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
.
Considerazioni
Quando utilizzi la funzione di caricamento o download, tieni presente quanto segue:
- Il caricamento di un'integrazione crea una nuova versione dell'integrazione. Ad esempio, se hai un'integrazione denominata 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 disponi di un'integrazione esistente in cui caricare un file, devi prima creare una nuova integrazione e poi caricarlo. In questo caso, la nuova integrazione creata sarà alla versione 1 e l'integrazione caricata sarà alla versione 2.
- I dettagli dei profili di autenticazione configurati per un'integrazione non saranno disponibili nel file scaricato. Dopo aver caricato il file, devi riconfigurare i profili di autenticazione nell'integrazione caricata.