Pianifica trigger

L'attivatore Pianifica ti consente di eseguire l'integrazione periodicamente a intervalli di tempo specifici. Questo attivatore è utile quando vuoi eseguire l'integrazione automaticamente senza alcun intervento manuale. Ad esempio, puoi utilizzare l'attivatore Pianifica per il seguente tipo di attività:

  • Caricare file a intervalli regolari da un sistema a un altro
  • Invio di promemoria via email periodici
  • Sincronizzazione del database a intervalli regolari

Prima di iniziare

Assicurati di assegnare il ruolo IAM Apigee Integration Invoker all'agente di servizio Apigee ( service-PROJECT_ID @gcp-sa-apigee.iam.gserviceaccount.com ) nel progetto Google Cloud.

Per saperne di più sull'assegnazione dei ruoli IAM, consulta Gestire l'accesso in Google Cloud.

Aggiungi un trigger di pianificazione

Per aggiungere un attivatore di pianificazione a un'integrazione nuova o esistente:
  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 del designer dell'integrazione, fai clic su +Aggiungi un'attività/un attivatore > Attivatori per visualizzare l'elenco degli attivatori disponibili.
  5. Fai clic e posiziona l'elemento Pianifica trigger nel designer.

Configura un trigger di pianificazione

Fai clic sull'elemento Pianifica trigger nell'editor di integrazione per visualizzare il riquadro di configurazione dell'attivatore.

Puoi configurare l'attivatore Pianifica utilizzando una delle seguenti modalità:

  • Di base: fornisce un'interfaccia utente per configurare la frequenza di esecuzione.
  • Avanzata: utilizza un'espressione cron per configurare la frequenza dell'esecuzione.

In modalità Base, puoi scegliere di eseguire l'integrazione a un orario specifico o a intervalli orari. Se vuoi eseguire l'integrazione in un momento specifico, seleziona Esegui in un momento specifico dal menu a discesa Ore e imposta le seguenti proprietà:

  • Ora: l'ora (nel formato 24 ore) in cui deve essere eseguita l'integrazione.
  • Giorni: i giorni in cui deve essere eseguita l'integrazione. Puoi scegliere di eseguire l'integrazione ogni giorno, in giorni della settimana specifici, in un giorno specifico del mese e così via.
  • Mesi: i mesi in cui deve essere eseguita l'integrazione. Puoi eseguire l'integrazione ogni mese o scegliere mesi specifici.

In modalità Avanzata, puoi specificare la frequenza dell'esecuzione utilizzando un'espressione cron. L'espressione cron contiene cinque valori che devono essere specificati nel seguente ordine:

  • Minuto (0-59)
  • Ora (0-23)
  • Giorno del mese (1-31)
  • Mese, uno dei seguenti valori:
    • Un numero da 1 a 12
    • L'abbreviazione del mese di tre lettere (ad es. Gen, Feb, Mar e così via)
  • Giorno della settimana, utilizzando uno dei seguenti valori:
    • Un numero da 0 a 6 che inizia con la domenica come 0
    • L'abbreviazione di un giorno di tre lettere (ad es. Lun, Mar, Mer e così via).

Ad esempio, per eseguire l'integrazione il primo giorno di ogni mese, utilizza l'espressione cron * * 1 * *.

Best practice

Come best practice, disattiva gli attivatori di pianificazione quando non sono più necessari. Se lasci attivo un trigger di pianificazione ridondante, questo continuerà ad attivare automaticamente l'integrazione.

Per disattivare un attivatore di pianificazione, puoi eseguire una delle seguenti operazioni:

  • Annulla la pubblicazione dell'integrazione contenente l'attivatore Pianifica. L'integrazione non sarà più attiva e il trigger non verrà eseguito.
  • Sostituisci Pianifica trigger con un altro attivatore e pubblica nuovamente l'integrazione. La versione attiva ripubblicata dell'integrazione non utilizzerà l'attivatore Pianifica.
  • Elimina la versione corrente dell'integrazione. Puoi trovare l'opzione Elimina sotto l'elenco delle versioni, accanto al nome dell'integrazione.