Creare flussi guidati dagli eventi da zero

In un flusso guidato dagli eventi, si identifica un evento in un'applicazione di origine che innesca un flusso per completare le azioni in una o più applicazioni di destinazione.

Informazioni su questa attività

Per creare un flusso guidato dagli eventi, si deve innanzitutto specificare l'evento che lo innesca. L'evento potrebbe essere qualcosa che accade in un'applicazione, oppure si potrebbe decidere di avviare il flusso in base a una pianificazione. Si aggiungono quindi le azioni da completare in una o più applicazioni di destinazione. È inoltre possibile aggiungere utility di toolbox per elaborare i dati in ingresso o in uscita dalle applicazioni del flusso. Le seguenti restrizioni e comportamenti si applicano ai flussi guidati dagli eventi.

• È possibile aggiungere un massimo di 10 azioni a un flusso.
• Le azioni vengono completate nell'ordine indicato nel flusso.
• Se una delle azioni fallisce, le azioni successive del flusso non vengono completate, ma le azioni precedenti non vengono invertite.

Suggerimento: si può anche chiedere all'agente di integrazione di creare un flusso per voi. Per aprire l'agente, fare clic sull'icona dell'agente di integrazione , quindi descrivere lo scenario. L'agente chiede tutte le informazioni necessarie, quindi invita l'utente a connettersi alle applicazioni e a mappare i dati. L'agente può anche aggiungere i nodi If, For each e Log dalla Toolbox, ma i filtri per il nodo If non vengono popolati automaticamente. Se si ha un flusso aperto nell'editor e si richiedono altre azioni, queste vengono aggiunte al flusso aperto. Se si desidera utilizzare l'agente per creare un altro flusso, chiudere prima il flusso esistente.

Per creare un flusso guidato dagli eventi, completare i seguenti passaggi.

1. Nella pagina iniziale di App Connect Designer, fare clic su Crea un flusso guidato dagli eventi.
   In alternativa, dalla pagina Progettazione, fai clic su Crea > Flusso basato su eventi.
   Si apre l'editor di flusso.
2. Inserire un nome che identifichi lo scopo del flusso.
   

   Man mano che si procede con il flusso, App Connect salva automaticamente le modifiche. Se ci si allontana dal flusso, questo viene salvato come bozza di flusso da completare in un altro momento.

3. Aggiungere un evento per attivare il flusso.
   Si può scegliere di ricevere eventi in streaming da un'applicazione sorgente, di eseguire il polling di un'applicazione per gli eventi o di configurare una pianificazione per gli eventi di un'applicazione.
   • Per eseguire lo streaming di eventi da un'applicazione di origine, fare clic su un'applicazione nella scheda Applicazioni e API, quindi fare clic sull'oggetto e sul tipo di evento per cui si desidera eseguire lo streaming di eventi. Ad esempio, per inviare notifiche di eventi a App Connect ogni volta che un partecipante si iscrive a un evento in Eventbrite, fare clic su Eventbrite, quindi su Partecipanti e Nuovo partecipante.
     Assicurarsi che nell'elenco Account sia selezionato il conto corretto.

     
     Il nodo evento viene aggiunto al flusso.

     

     Alcune applicazioni utilizzano URL di callback webhook per inviare notifiche di eventi al flusso. URL Per alcune applicazioni, come Eventbrite, il callback URL è registrato automaticamente con l'applicazione, mentre per altre è necessario registrarlo manualmente. Per ulteriori informazioni, vedere URL di callback dei webhook.

   • Per eseguire il polling di un'applicazione di origine per gli oggetti nuovi o aggiornati, fare clic su un'applicazione nella scheda Applicazioni e API, quindi fare clic su Configura altri eventi. Nel pannello Seleziona l'evento da configurare, fare clic sull'oggetto da monitorare e sul tipo di evento. Ad esempio, per attivare il flusso ogni volta che viene creato un nuovo account in Salesforce, fare clic su Salesforce > Configura altri eventi, quindi su Account e Nuovi account.
     
     Il nodo evento viene aggiunto al flusso. Assicurarsi che nell'elenco Account sia selezionato l'account corretto, quindi configurare gli intervalli di polling. Per ulteriori informazioni, vedere Configurazione degli eventi polled per attivare i flussi.

     
   • Per configurare il flusso in modo che venga eseguito a intervalli regolari o a date e orari specifici, aprire la scheda Casella degli strumenti, quindi fare clic su Pianificazione.
     

     Il nodo Scheduler viene aggiunto al flusso. Definire una pianificazione per l'esecuzione del flusso. Per ulteriori informazioni, vedere Configurazione del flusso per l'esecuzione a orari programmati.

     In questo esempio, viene definita una pianificazione per attivare il flusso al suo primo avvio e poi ogni giorno su base oraria.

     
4. Per aggiungere la prima azione al flusso, fare clic su Aggiungi nodo (+), quindi selezionare un'applicazione e un'azione appropriata.
   Assicurarsi che sia selezionato l'account corretto per l'applicazione di destinazione. Se non ci sono account collegati, è possibile aggiungerne uno. Per ulteriori informazioni, vedere Connessione agli account.
5. Popolare i campi dell'azione con i valori che si desidera passare all'applicazione di destinazione. È possibile specificare dati statici in testo semplice, oppure dati dinamici aggiungendo mappature dai nodi precedenti del flusso. È anche possibile applicare funzioni (espressioni JSONata ) per trasformare i dati o utilizzare altri meccanismi integrati per definire valori personalizzati.
   • Per inserire manualmente testo, mappature ed espressioni JSONata nei campi o per definire valori personalizzati, vedere Configurazione delle azioni.
   • Per riempire automaticamente i campi dell'azione con le mappature intelligenti suggerite, utilizzare Mapping Assist. Per ulteriori informazioni, vedere Semplificazione della mappatura e della trasformazione dei dati con suggerimenti basati sull'intelligenza artificiale.

   È possibile utilizzare dati di esempio per testare le mappature man mano che vengono aggiunte. Per ulteriori informazioni, vedere Prova delle mappature con dati di esempio.

   Nell'esempio seguente, un'azione Salesforce Retrieve leads viene utilizzata per recuperare i dettagli dei nuovi lead creati in Salesforce dall'ultima volta che il flusso è stato attivato. Per definire questo comportamento, fare clic su Aggiungi condizione e selezionare Created date e is greater than dai primi due campi. Fare quindi clic nel terzo campo e fare clic su Inserisci una mappatura per aprire l'elenco Mappature disponibili. Dall'elenco, selezionare Previous event time, che rappresenta l'ora in cui è stata attivata la pianificazione precedente. È inoltre possibile configurare il numero massimo di elementi da recuperare e le condizioni di errore.

   

   Suggerimento: Dopo aver completato i campi per l'azione, è possibile utilizzare i dati di esempio generati automaticamente o personalizzati per testare l'azione e verificarne l'effetto. Assicuratevi di usare un account non di produzione per testare l'azione, perché l'azione viene completata sull'applicazione di destinazione a cui siete connessi. Per ulteriori informazioni, vedere Prova delle azioni con dati di esempio.
6. Opzionale: Aggiungere altre applicazioni e azioni di destinazione.
7. Opzionale: Utilizzare una o più utilità del toolbox per fornire un'elaborazione specializzata.
   Ad esempio, aggiungere un nodo If per fornire un'elaborazione condizionale o un nodo For each per elaborare gli elementi recuperati. Per ulteriori informazioni, vedere Aggiunta di un'elaborazione speciale a un flusso (utilità del Toolbox).

   In questo esempio, viene utilizzato un nodo For each per scorrere i record di Salesforce recuperati e creare i corrispondenti record di lead in Insightly. Fare clic sul simbolo (+), passare alla scheda Casella degli strumenti, quindi fare clic su Per ciascuno per selezionare la raccolta di elementi da elaborare e le opzioni di elaborazione.

   

   Quindi, fare clic su Aggiungi nodo (+) nel riquadro Per ogni nodo, e dalla scheda Applicazioni, fare clic su Insightly > Lead > Crea lead. Fare clic su Inserisci una mappatura per popolare i singoli campi con le mappature che rappresentano l'output elaborato dal nodo Salesforce.

   

   Fare clic su Visualizza suggerimenti per passare alla modalità di anteprima in linea, che inserisce un'anteprima delle mappature suggerite nei campi corrispondenti. Esaminare le mappature di anteprima per verificare che siano adatte alle proprie esigenze, quindi fare clic su Applica 15 suggerimenti per popolare i campi.

   
8. Opzionale: è possibile aggiungere un flusso di cattura degli errori per gestire gli errori nel flusso guidato dagli eventi.
   Per ulteriori informazioni, vedere Configurazione di un flusso catch per gestire gli errori nei flussi event-driven o API.
9. Prima di testare o distribuire il flusso, correggere eventuali errori di convalida nel flusso.
   Per ulteriori informazioni, vedere Convalida del flusso.