Attività di approvazione

L'attività Approvazione consente di configurare integrazioni basate sull'approvazione. Inoltre, ti consente di controllare il flusso di un'integrazione.

Puoi utilizzare l'attività Approvazione per inviare email di richiesta di approvazione a uno o più utenti dell'integrazione. L'email include un link all'integrazione in cui gli utenti possono approvare o rifiutare manualmente la richiesta.

Durante l'esecuzione di un'integrazione, quando il controllo raggiunge l'attività di approvazione, l'esecuzione viene interrotta e tutte le attività successive all'attività di approvazione vengono sospese. L'integrazione riprende l'esecuzione solo quando un utente approva o rifiuta la richiesta di approvazione, nella console Google Cloud o utilizzando l'API.

Un'attività di approvazione può essere utilizzata per i seguenti scopi:

  • Sospendere e creare un ramo di un'integrazione in base all'approvazione o al rifiuto dell'utente.
  • Sospendere un'integrazione per un periodo di tempo specificato.
  • Da utilizzare come punto di interruzione per eseguire il debug dell'integrazione.

Confronta le attività di approvazione, sospensione e timer

Tutte e tre le attività (Approvazione, Sospendi e Timer) svolgono una funzione simile di messa in pausa e ripresa di un'integrazione. Tuttavia, esistono sottili differenze tra di loro. La tabella seguente descrive le differenze tra le tre attività.

Attività approvazione Sospensione attività Attività timer
Riprende quando un utente approva o rifiuta la richiesta nell'interfaccia utente di Integrations o utilizzando l'API. Supporta il ripristino manuale e automatico di un'integrazione. Se non viene eseguito alcun intervento manuale per revocare la sospensione, l'integrazione riprenderà automaticamente l'esecuzione dopo la scadenza del limite di tempo di sospensione. Supporta solo la ripresa automatica di un'integrazione. L'esecuzione dell'integrazione riprende automaticamente dopo la scadenza del limite di tempo della sospensione.
Può riprendere un'integrazione dalla UI di Integrations o chiamando il metodo suspensions.resolve. Consulta Approva o rifiuta utilizzando l'API. Può riprendere un'integrazione chiamando il metodo suspensions.lift. Supporta solo la ripresa automatica di un'integrazione.
Gli utenti ricevono una notifica quando un'integrazione viene messa in pausa (sospesa). Gli utenti non ricevono alcuna notifica quando un'integrazione viene messa in pausa (sospesa). Gli utenti non ricevono alcuna notifica quando un'integrazione viene messa in pausa (sospesa).
Supporta una variabile di output (booleana), che consente di eseguire controlli condizionali prima di riprendere un'integrazione. Tuttavia, la variabile di output può avere solo il valore true o false. Supporta una variabile di output (stringa), che consente di eseguire controlli condizionali prima di riprendere un'integrazione. Puoi impostare qualsiasi valore per la variabile di output. Non supporta variabili di output.

Configura l'attività di approvazione

Per configurare l'attività Approvazione:

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

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrazioni.

    Viene visualizzata la pagina Integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione nella barra degli strumenti dell'integrazione.
    4. Fai clic su Crea. L'integrazione appena creata si apre nell'editor delle integrazioni.

  4. Nella barra di navigazione dell'editor delle integrazioni, fai clic su Attività per visualizzare l'elenco delle attività e dei connettori disponibili.
  5. Fai clic e posiziona l'elemento dell'attività Approvazione nell'Editor integrazioni.
  6. Fai clic sull'elemento dell'attività Approvazione nel designer per visualizzare il riquadro di configurazione dell'attività Approvazione.
  7. Configura i campi visualizzati utilizzando le proprietà di configurazione per l'attività, come descritto nella tabella seguente.

    Tutte le modifiche alle proprietà vengono salvate automaticamente.

Proprietà di configurazione

La tabella seguente descrive le proprietà di configurazione dell'attività Approvazione.

Proprietà Tipo di dati Descrizione
Recipients Array di stringhe Indirizzi email a cui viene inviata la notifica quando l'attività viene sospesa. Inserisci più indirizzi email separati da una virgola.
Custom notification message Stringa Messaggio personalizzato da includere nella notifica via email quando l'attività viene sospesa. Il valore può essere un valore letterale o una variabile. Se il messaggio personalizzato è disponibile in una variabile, fai clic su VAR e seleziona la variabile.
Reminder frequency (in hours) Numero intero Frequenza delle notifiche di promemoria.

Se la sospensione non è stata risolta, puoi inviare notifiche via email di promemoria per chiedere agli utenti autorizzati di risolvere la sospensione.

Time until expiration (in hours) Numero intero Periodo di tempo della sospensione.

Se la sospensione non viene risolta entro il limite di tempo, viene rifiutata per impostazione predefinita.

On expiration Booleano Azione da intraprendere dopo la scadenza della sospensione.

Puoi scegliere di rifiutare la sospensione o di revocarla. Per impostazione predefinita, la sospensione viene rifiutata.

isApproved (Approval) Booleano Variabile di output che contiene lo stato della sospensione dopo la risoluzione.

La variabile isApproved è impostata su True se la sospensione viene approvata e su False se la sospensione viene rifiutata.

Rispondi a una richiesta di approvazione utilizzando l'API

Per approvare o rifiutare una richiesta di approvazione in attesa senza la console Google Cloud , chiama il metodo projects.locations.integrations.executions.suspensions.resolve.

Per approvare o rifiutare una richiesta, devi disporre dell'autorizzazione integrations.suspensions.resolve. Per elencare le sospensioni, devi disporre anche dell'autorizzazione integrations.suspensions.list. Il ruolo Application Integration Approver (roles/integrations.suspensionResolver) contiene entrambe le autorizzazioni, così come il ruolo Application Integration Admin (roles/integrations.integrationAdmin).

Se l'integrazione utilizza un account di servizio run-as, concedi il ruolo Utente service account (roles/iam.serviceAccountUser) su quel account di servizio. Questo requisito diventa effettivo man mano che procede l'implementazione descritta in Concedi ruolo Utente dell'account di servizio.

  1. Per trovare la richiesta in attesa, elenca le sospensioni dell'esecuzione utilizzando il metodo projects.locations.integrations.executions.suspensions.list: 
    curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions"

    Nella risposta, individua la sospensione il cui taskId è l'ID della tua attività di approvazione e il cui state è PENDING. La risposta include anche le sospensioni delle attività di sospensione e di altre attività di approvazione nella stessa esecuzione. Prendi nota del valore name della sospensione, che termina con l'ID sospensione.

  2. Per approvare o rifiutare la richiesta, chiama il metodo suspensions.resolve: 
    curl -X POST \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d '{
      "suspension": {
        "eventExecutionInfoId": "EXECUTION_ID",
        "integration": "INTEGRATION_NAME",
        "taskId": "TASK_ID",
        "state": "STATE"
      }
    }' \
    "https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions/EXECUTION_ID/suspensions/SUSPENSION_ID:resolve"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del tuo progetto Google Cloud .
  • LOCATION: la regione dell'integrazione.
  • INTEGRATION_NAME: il nome dell'integrazione.
  • EXECUTION_ID: l'ID dell'esecuzione sospesa.
  • TASK_ID: l'ID dell'attività di approvazione (taskId della sospensione).
  • SUSPENSION_ID: l'ID della sospensione dal name della sospensione.
  • STATE: lo stato della risoluzione. Utilizza LIFTED per approvare la richiesta (imposta isApproved su true) o REJECTED per rifiutarla (imposta isApproved su false).

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da intraprendere se l'attività non va a buon fine a causa di un errore temporaneo. Per informazioni su come utilizzare una strategia di gestione degli errori e per conoscere i diversi tipi di strategie di gestione degli errori, consulta Strategie di gestione degli errori.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi