Il trigger di pianificazione ti consente di eseguire l'integrazione periodicamente a intervalli di tempo specifici. Questo trigger è utile quando vuoi eseguire automaticamente l'integrazione senza alcun intervento manuale. Ad esempio, puoi utilizzare il trigger di pianificazione per il seguente tipo di attività:
- Caricamento di file da un sistema a un altro a intervalli regolari
- Invio di promemoria periodici via email.
- Sincronizzazione del database a intervalli regolari
Prima di iniziare
Assicurati di assegnare il ruolo IAM Invoker di integrazione Apigee all'agente di servizio Apigee (
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
) nel tuo progetto Google Cloud.
Per saperne di più sull'assegnazione dei ruoli IAM, consulta Gestire l'accesso in Google Cloud.
Aggiungi un attivatore di pianificazione
Per aggiungere un attivatore di pianificazione a un'integrazione nuova o esistente, segui questi passaggi:- Nell'interfaccia utente di Apigee, seleziona la tua organizzazione Apigee.
- Fai clic su Sviluppa > 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 dall'elenco delle regioni supportate.
- Fai clic su Crea.
In questo modo viene aperta l'integrazione nel designer dell'integrazione.
- Nella barra di navigazione del designer dell'integrazione, fai clic su + Aggiungi un'attività/un attivatore > Trigger per visualizzare l'elenco dei trigger disponibili.
- Fai clic sull'elemento Pianifica trigger e posizionalo 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 il trigger di pianificazione utilizzando una delle seguenti modalità:
- Di base: fornisce un'interfaccia utente per configurare la frequenza dell'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 a un orario specifico dal menu a discesa Orari e imposta le seguenti proprietà:
- Ora: l'ora (in 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 specifici della settimana, in un giorno del mese specifico 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, utilizzando uno dei seguenti valori:
- Un numero da 1 a 12
- Un'abbreviazione di tre lettere del mese (ad es. Gen, Feb, Mar e così via).
- Giorno della settimana, con uno dei seguenti valori:
- Un numero compreso tra 0 e 6 che inizia con domenica come 0
- Un'abbreviazione di tre lettere di un giorno (ad es. lun, mar, mer, ecc.)
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 trigger di pianificazione, puoi eseguire una delle seguenti operazioni:
- Annulla la pubblicazione dell'integrazione contenente il attivatore di pianificazione. L'integrazione non sarà più attiva e il trigger non verrà eseguito.
- Sostituisci il attivatore di pianificazione con un attivatore diverso e pubblica nuovamente l'integrazione. La versione attiva e ripubblicata dell'integrazione non utilizzerà l'attivatore di pianificazione.
- Elimina la versione corrente dell'integrazione. Puoi trovare l'opzione Elimina sotto l'elenco delle versioni accanto al nome dell'integrazione.