Definizione e gestione degli eventi piattaforma

Utilizzando gli eventi piattaforma, i publisher possono inviare dati di eventi personalizzati tramite Apex, un processo, un flusso, l'API Pub/Sub o altre API. Gli abbonati possono ricevere messaggi di evento personalizzati da Salesforce o da un sistema esterno utilizzando Apex, client API Pub/Sub, processi o flussi. In base al dati dei messaggi degli eventi, gli abbonati possono elaborare una logica aziendale personalizzata, ad esempio inviare un messaggio email o registrare un caso. Ad esempio, un sistema software che monitora una stampante può effettuare una chiamata API per pubblicare un evento quando l'inchiostro è in esaurimento. L'evento stampante personalizzato può contenere campi personalizzati per il modello, il numero di serie e il livello d'inchiostro della stampante. L'evento viene elaborato in Salesforce da un trigger Apex che genera un ordine per la nuova cartuccia.

Gli eventi piattaforma semplificano il processo di comunicazione e di recepimento delle modifiche senza bisogno di scrivere logica complessa. Gli autori pubblicazione e gli abbonati comunicano tra loro attraverso gli eventi. Più abbonati possono ascoltare lo stesso evento ed eseguire azioni diverse.

Definizione dell'evento piattaforma

Per definire un evento piattaforma in Salesforce Classic o Lightning Experience:

1. Da Imposta, immettere Eventi piattaforma nella casella Ricerca veloce, quindi selezionare Eventi piattaforma.
2. Nella pagina Eventi piattaforma, fare clic su Nuovo evento piattaforma.
3. Compilare i campi standard e, se si desidera, aggiungere una descrizione.
4. Per il comportamento di pubblicazione, scegliere il momento in cui il messaggio di evento viene pubblicato in una transazione.
   • Pubblica dopo il commit per fare pubblicare il messaggio di evento dopo la corretta esecuzione del commit. Selezionare questa opzione se gli abbonati utilizzano dati di cui la transazione di pubblicazione esegue il commit. Ad esempio, un processo pubblica un messaggio di evento e crea un record operazione. Viene generato un secondo processo che è abbonato all'evento e dovrebbe trovare il record operazione. Un altro motivo per scegliere questo comportamento è quando non si desidera che il messaggio di evento venga pubblicato se la transazione non riesce.
   • Pubblica subito per fare pubblicare il messaggio di evento quando viene eseguita la chiamata di pubblicazione. Selezionare questa opzione se si desidera che il messaggio di evento venga pubblicato indipendentemente dall'esito della transazione. Inoltre, scegliere questa opzione se l'autore della pubblicazione e gli abbonati sono indipendenti e se gli abbonati non utilizzano i dati di cui l'autore della pubblicazione esegue il commit. Ad esempio, il comportamento di pubblicazione immediata è adatto a un evento utilizzato per scopi di registrazione. Con questa opzione, un abbonato può ricevere un messaggio di evento prima che la transazione dell'autore della pubblicazione esegua il commit.
5. Fare clic su Salva.
6. Per aggiungere un campo, nell'elenco correlato Relazioni e campi personalizzati, fare clic su Nuovo.
7. Per impostare le proprietà del campo, seguire la procedura guidata per i campi personalizzati.

Nota

• Se si modifica il comportamento di pubblicazione, la modifica diventerà effettiva nell'arco di 5 minuti al massimo.
• in Lightning Experience, gli eventi piattaforma non sono inclusi nell'elenco degli oggetti standard e personalizzati del Gestore oggetti e non sono disponibili nel Generatore di schemi.

Un evento piattaforma è un'entità speciale di Salesforce, molto simile a un sObject. Un messaggio di evento è un'istanza di un evento piattaforma come un record è un'istanza di un oggetto personalizzato. A differenza degli oggetti personalizzati, non è possibile aggiornare o eliminare i record degli eventi. Inoltre, non è possibile visualizzare i record degli eventi nell'interfaccia utente di Salesforce e gli eventi piattaforma non dispongono di layout di pagina. Quando si elimina la definizione di un evento piattaforma, l'eliminazione è definitiva.

Campi standard

Gli eventi piattaforma contengono campi standard. Questi campi compaiono nella pagina Nuovo evento piattaforma.

Campi personalizzati

Oltre ai campi standard è possibile aggiungere dei campi personalizzati all'evento personalizzato. I campi personalizzati degli eventi piattaforma supportano solo questi tipi di campi.

• Casella di controllo
• Data
• Data/ora
• Numero
• Testo
• Area di testo (lungo)

Il numero massimo di campi che è possibile aggiungere a un evento piattaforma è uguale a quello per gli oggetti personalizzati. Vedere Funzioni di Salesforce e allocazioni nelle varie versioni.

Campo di sistema ReplayId :

A ogni messaggio di evento viene assegnato un ID opaco contenuto nel campo ReplayId. Il valore del campo ReplayId, compilato dal sistema quando l'evento viene consegnato agli abbonati, si riferisce alla posizione dell'evento nello stream dell'evento. Non è garantito che i valori Replay ID siano contigui per gli eventi consecutivi. Un abbonato può memorizzare un valore replay ID e utilizzarlo in un nuovo abbonamento per recuperare gli eventi compresi nel periodo di conservazione. Ad esempio, un abbonato può recuperare gli eventi che ha perso dopo un errore di connessione. Gli abbonati non devono elaborare nuovi replay ID in base a un replay ID memorizzato per fare riferimento ad altri eventi dello stream.

Campo di sistema EventUuid

Un identificativo univoco universale (UUID) che identifica un messaggio evento piattaforma. Nei client API Pub/Sub, il campo ID evento contiene il valore UUID dell'evento e non è dotato di versione. In altri client abbonato, il campo EventUuid è disponibile nell'API versione 52.0 e successive. La versione API corrisponde alla versione con cui è stato salvato un trigger Apex o alla versione specificata in un endpoint abbonato CometD.

Suffisso nome API per gli eventi piattaforma personalizzati

Quando si crea un evento piattaforma, il sistema aggiunge il suffisso __e per creare il nome API dell'evento. Ad esempio, se si crea un evento con il nome oggetto Low Ink, il nome API è Low_Ink__e. Il nome API si usa ogni volta che si indica l'evento a livello di programmazione, ad esempio in Apex. I nomi API degli eventi piattaforma personalizzati, ad esempio AssetTokenEvent, non includono un suffisso.

Abbonati agli eventi

L'elenco correlato Abbonamenti mostra tutti i trigger, i processi e i flussi attivati da eventi piattaforma che sono abbonati a un evento piattaforma. Gli abbonati API Pub/Sub, gli abbonati CometD, ad esempio il proprio client CometD o il componente Lightning empApi, non sono elencati in questa pagina.

L'elenco mostra l'ID duplicato dell'ultimo evento elaborato dal sistema (campo Ultimo ID elaborato) e dell'ultimo evento pubblicato (campo Ultimo ID pubblicato). Conoscere l'ultimo ID duplicato elaborato è utile quando vi è un intervallo tra gli eventi pubblicati ed elaborati, ad esempio quando un trigger contenente logica complessa provoca un ritardo nell'elaborazione di batch di eventi in entrata di grandi dimensioni.

Nota per gli eventi piattaforma a volume elevato, il valore del campo Ultimo ID pubblicato non è disponibile ed è sempre visualizzato come Non disponibile.

Inoltre, l'elenco Abbonamenti mostra lo stato di ciascun abbonato, che può essere uno dei seguenti.

• Running: l'abbonato sta ascoltando attivamente gli eventi. Se si modifica l'abbonato, l'abbonamento continua a elaborare gli eventi.
• Error— L'abbonato è stato disconnesso e ha smesso di ricevere gli eventi pubblicati. Un trigger raggiunge questo stato quando supera il numero massimo di tentativi con il EventBus.RetryableException. Gli errori delle asserzioni e le eccezioni non gestite dei trigger non provocano lo stato di errore. Per evitare di raggiungere questo stato, si consiglia di limitare i tentativi a meno di nove. Quando si corregge e si salva il trigger, o nel caso di un trigger di pacchetto gestito, se si distribuisce nuovamente il pacchetto il trigger riprende automaticamente dall'alto, iniziando dai nuovi eventi. Inoltre, l'abbonamento di un trigger si può riprendere nella pagina dei dettagli dell'abbonamento a cui si accede dalla pagina dell'evento piattaforma.
• Suspended: l'abbonato è disconnesso e non può ricevere eventi perché un amministratore Salesforce lo ha sospeso o a causa di un errore interno. L'abbonamento di un trigger si può riprendere nella pagina dei dettagli dell'abbonamento a cui si accede dalla pagina dell'evento piattaforma. Per riprendere un processo, disattivarlo e quindi riattivarlo. Se si modifica l'abbonato, l'abbonamento riprende automaticamente dall'alto, iniziando dai nuovi eventi.

Nota nell’elenco correlato Abbonamenti compare un solo abbonato "Processo" per tutte le interviste dei flussi in pausa abbonate all'evento piattaforma. I processi e i flussi attivati da eventi piattaforma sono invece elencati singolarmente.

Inoltre, le informazioni sugli abbonati all'evento vengono presentate nell'oggetto EventBusSubscriber. È possibile interrogare questo oggetto per ottenere dettagli sugli abbonati.

Sospensione o ripresa dell'abbonamento di un trigger Apex:

riprende l'abbonamento del trigger sospeso dove è stato interrotto a partire dal primo messaggio di evento disponibile memorizzato nel bus degli eventi. Se si desidera ignorare messaggi di evento che causano errori o non sono più necessari, è possibile riprendere un abbonamento dal passaggio più complesso, iniziando dai nuovi messaggi di evento.

Per gestire l'abbonamento di un trigger:

1. Nell'elenco correlato Abbonamenti, fare clic su Gestisci accanto al trigger Apex.
2. Nella pagina dei dettagli dell'abbonamento, scegliere l'azione appropriata.
   • Per sospendere un abbonamento in corso, fare clic su Sospendi.
   • Per riprendere un abbonamento sospeso iniziando dal primo messaggio di evento disponibile nel bus degli eventi, fare clic su Riprendi.
   • Per riprendere un abbonamento sospeso iniziando dai nuovi messaggi di evento, fare clic su Resume from Tip (Riprendi da suggerimento).

Gli abbonamenti di flussi e processi non si possono gestire tramite l'elenco correlato Abbonamenti.

Nota

• Dopo la modifica di un abbonato, l'abbonamento riprende automaticamente. Per ulteriori informazioni, vedere la sezione Abbonati agli eventi.
• Se si fa clic su Riprendi per un trigger con stato di errore, il trigger salta gli eventi che sono stati tentati di ripetere con EventBus.RetryableException. L'abbonamento inizia con gli eventi non elaborati inviati dopo lo stato di errore e che si trovano nel periodo di conservazione.

Considerazioni su Eventi piattaforma

• Protezione a livello di campo: tutti i campi degli eventi piattaforma sono di sola lettura per impostazione predefinita e non è possibile limitare l'accesso a un campo specifico. Le autorizzazioni della protezione a livello di campo non si applicano e il messaggio di evento contiene tutti i campi.
• Imposizione degli attributi dei campi: i record degli eventi piattaforma vengono convalidati per verificare che vengano applicati gli attributi dei campi personalizzati. Gli attributi dei campi includono gli attributi Obbligatorio e Predefinito, la precisione dei campi numerici e la lunghezza massima dei campi di testo.
• Eliminazione definitiva delle definizioni degli eventi: quando si elimina la definizione di un evento, l'eliminazione è definitiva e la definizione non si può ripristinare. Prima di eliminare la definizione di un evento, eliminare i trigger associati. Vengono eliminati anche gli eventi pubblicati che utilizzano quella definizione.
• Ridenominazione degli oggetti evento: oggetto evento rinominato. Prima di rinominare un evento, eliminare i trigger associati. Se il nome dell'evento viene modificato dopo che i client hanno effettuato l'abbonamento a quell'evento, i client abbonati devono riabbonarsi all'argomento aggiornato. Per riabbonarsi al nuovo evento, aggiungere il trigger per l'oggetto evento rinominato.
• Nessuna scheda associata: agli eventi piattaforma non è associata alcuna scheda perché non è possibile visualizzare i record degli eventi nell'interfaccia utente di Salesforce.
• Nessun supporto SOQL: non è possibile sottoporre a query i messaggi degli eventi con SOQL.
• Nessun supporto per le pagine dei record nel Generatore di app Lightning: quando si crea una pagina di record nel Generatore di app Lightning, gli eventi piattaforma che sono stati definiti compaiono nell'elenco degli oggetti di quella pagina. Tuttavia, non è possibile creare una pagina di record Lightning per gli eventi piattaforma poiché i record degli eventi non sono disponibili nell'interfaccia utente.
• Eventi piattaforma nella disinstallazione di un pacchetto: quando si disinstalla un pacchetto con l'opzione Salva una copia dei dati di questo pacchetto per 48 ore dopo la disinstallazione abilitata, gli eventi piattaforma non vengono esportati.
• Volume degli eventi in installazioni e aggiornamenti di un pacchetto: l'installazione di un pacchetto gestito o non gestito che contiene un evento piattaforma a volume standard causa il salvataggio del tipo di evento come volume elevato nell'organizzazione abbonata. L'aggiornamento di un pacchetto gestito non modifica il volume degli eventi nell'organizzazione abbonata.
• Nessun supporto nelle versioni Professional Edition e Group Edition: gli eventi piattaforma non sono supportati nelle organizzazioni Professional Edition e Group Edition. In queste organizzazioni, l'installazione di un pacchetto contenente oggetti evento piattaforma non riesce.