Attività approvazione

L'attività Approvazione ti consente di configurare le integrazioni basate sull'approvazione. Ti consente anche di controllare il flusso di un'integrazione.

Puoi utilizzare l'attività Approvazione per inviare email di richiesta di approvazione a uno o più utenti di integrazione. L'email include un link all'integrazione, che consente agli utenti di approvare o rifiutare manualmente la richiesta.

Durante l'esecuzione dell'integrazione, quando il controllo raggiunge l'attività Approval, l'esecuzione viene interrotta e tutte le attività dopo l'attività Approval vengono sospese. L'integrazione riprende l'esecuzione solo quando un utente approva o rifiuta manualmente la richiesta di approvazione.

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

  • Sospendere e ramificare un'integrazione in base all'approvazione o al rifiuto dell'utente.
  • Per sospendere un'integrazione fino a una durata specificata.
  • Da utilizzare come punto di interruzione per eseguire il debug dell'integrazione.

Confronta l'attività di approvazione, l'attività di sospensione e l'attività Timer

Tutte e tre le attività (Approvazione, Sospensione e Timer) svolgono una funzione simile per mettere in pausa e riprendere un'integrazione. Tuttavia, esistono sottili differenze. La tabella seguente descrive le differenze tra le tre attività.

Attività approvazione Sospensione attività Attività timer
Non supporta la ripresa automatica di un'integrazione e richiede un intervento manuale per riprendere l'integrazione. Supporta la ripresa sia manuale che automatica di un'integrazione. Se non viene effettuato alcun intervento manuale per revocare la sospensione, l'esecuzione dell'integrazione riprenderà automaticamente dopo la scadenza del limite di tempo della sospensione. Supporta solo la ripresa automatica di un'integrazione. L'esecuzione dell'integrazione riprende automaticamente al termine del limite di tempo per la sospensione.
Impossibile riprendere un'integrazione tramite una chiamata API. Devi risolvere manualmente la sospensione utilizzando la UI Integrazioni. Può riprendere un'integrazione utilizzando l'API Suspensions per le integrazioni. 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 notifiche quando un'integrazione viene messa in pausa (sospesa). Gli utenti non ricevono notifiche quando un'integrazione viene messa in pausa (sospesa).
Supporta una variabile di output (booleana), che consente di eseguire controlli condizionali prima di ripristinare 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 le variabili di output.

Configurare l'attività Approvazione

Per configurare l'attività Approvazione:

  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppa > 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 dall'elenco delle regioni supportate.
    3. Fai clic su Crea.

    Viene aperta l'integrazione nel designer dell'integrazione.

  4. Nella barra di navigazione integration designer, fai clic su +Aggiungi un'attività/un attivatore > Tasks per visualizzare l'elenco delle attività disponibili.
  5. Fai clic sull'elemento dell'attività Approvazione e posizionalo nell'editor dell'integrazione.
  6. Fai clic sull'elemento attività Approvazione nel designer per visualizzare il riquadro di configurazione dell'attività di approvazione.
  7. Configura i campi visualizzati utilizzando le proprietà di configurazione per l'attività, come descritto nella tabella riportata di seguito.

    Tutte le modifiche apportate 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 String 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) Integer Frequenza delle notifiche di promemoria.

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

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

Se la sospensione non viene risolta entro i tempi previsti, 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 con lo stato della sospensione dopo la risoluzione.

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

Strategia di gestione degli errori

Una strategia di gestione degli errori per un'attività specifica l'azione da eseguire se l'attività non riesce 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 l'articolo sulle strategie di gestione degli errori.