Definere og behandle plattformhendelser

Ved å bruke plattformhendelser kan utgivere sende tilpassede hendelsesdata via Apex, en prosess, en flyt, Pub/Sub API eller andre API-er. Abonnenter kan motta tilpassede hendelsesmeldinger fra Salesforce eller et eksternt system ved bruk av Apex, Pub/Sub API-klienter, prosesser eller flyter. Basert på hendelsesmeldingsdata kan abonnenter behandle tilpasset forretningslogikk, som å sende en e-postmelding eller logge en sag. Et programvaresystem som overvåker en skriver, kan for eksempel utføre et API-kall for å publisere en hendelse når det er lite blekk igjen. Den tilpassede skriverhendelsen kan inneholde tilpassede felt for skrivermodellen, serienummeret og blekknivået. Hendelsen behandles i Salesforce av en Apex-utløser som oppretter en bestilling på en ny blekkpatron.

Plattformhendelser forenkler prosessen med kommunikasjon om hendelser og svarer på dem uten uten å skrive kompleks logikk. Utgivere og abonnenter kommuniserer med hverandre via hendelser. Flere abonnenter kan lytte på samme hendelse og utføre ulike handlinger.

Definere plattformhendelsen

Slik definerer du en plattformhendelse i Salesforce Classic eller Lightning Experience:

1. Skriv inn Plattformhendelser i Hurtigsøk-feltet i Oppsett, og velg Plattformhendelser.
2. Klikk på Ny plattformhendelse på Plattformhendelser-siden.
3. Fyll ut standardfeltene, og legg eventuelt til en beskrivelse.
4. I Publiseringsalternativ velger du når hendelsesmeldingen skal publiseres i en transaksjon.
   • Publiser etter bekreftelse fører til at hendelsesmeldingen publiseres bare etter at en transaksjon har blitt vellykket bekreftet. Velg dette alternativet hvis abonnenter baserer seg på data som publiseringstransaksjonen bekrefter. En prosess kan for eksempel publisere en hendelsesmelding og opprette en oppgavepost. En annen prosess som abonnerer på hendelsen, utløses og forventer å finne oppgaveposten. En annen grunn til å velge denne virkemåten er når du ikke vil at hendelsesmeldingen skal publiseres hvis transaksjonen mislykkes.
   • Publiser umiddelbart fører til at hendelsesmeldingen publiseres når publiseringskallet utføres. Velg dette alternativet hvis du vil at hendelsesmeldingen skal publiseres uavhengig av om transaksjonen lykkes. Velg også dette alternativet hvis utgiveren og abonnenter er uavhengige og abonnenter ikke baserer seg på data fra utgiveren. Virkemåten med umiddelbare publisering er for eksempel egnet for en hendelse som brukes til logging. Med dette alternativet kan en abonnent motta hendelsesmeldingen før data er bekreftet av publiseringstransaksjonen.
5. Klikk på Lagre.
6. Klikk på Nytt i den relaterte listen Tilpassede felt og relasjoner for å legge til et felt.
7. Følg veiviseren for tilpassede felt for å konfigurere feltegenskapene for å konfigurere feltegenskapene.

Merk

• Hvis du endrer virkemåten for publiseringen, kan du forvente en 5-minutters forsinkelse før endringen trer i kraft.
• I Lightning Experience vises ikke plattformhendelser i objektbehandlingens liste over standardobjekter og tilpassede objekter og er ikke tilgjengelig i Skjemabygger.

En plattformhendelse er en spesiell type Salesforce-enhet som på mange måter ligner en sObject-enhet. En hendelsesmelding er en forekomst av en plattformhendelse, på samme måte som en post er en forekomst av et tilpasset objekt. Til forskjell fra tilpassede objekter kan du ikke oppdatere eller slette hendelsesposter. Du kan heller ikke vise hendelsesposter i Salesforce-brukergrensesnittet, og plattformhendelser har ikke sideoppsett. Når du sletter en plattformhendelsesdefinisjon, slettes den permanent.

Standardfelt

Plattformhendelser inkluderer standardfelt. Disse feltene vises på siden Ny plattformhendelse.

Tilpassede felt

I tillegg til standardfeltene kan du legge til tilpassede felt i den tilpassede hendelsen. Tilpassede felt for plattformhendelser støtter disse felttypene.

• Avmerkingsboks
• Dato
• Dato/klokkeslett
• Tall
• Tekst
• Tekstområde (lang tekst)

Maksimalt antall felt som du kan legge til i en plattformhendelse, er det samme som for et tilpasset objekt. Se Tildelinger av Salesforce-funksjoner etter utgave.

ReplayId-systemfelt:

Hver hendelsesmelding tildeles en ugjennomsiktig ID som finnes i ReplayId-feltet. Verdien i ReplayId-feltet, som fylles ut av systemet når hendelsen leveres til abonnenter, refererer til posisjonen til hendelsen i hendelsesstrømmen. Gjentagelses-ID-verdier garanteres ikke å være sammenhengende for etterfølgende hendelser. En abonnent kan lagre en gjentagelses-ID og bruke den på ny abonnering til å hente hendelser som er inne oppbevaringsvinduet. En abonnent kan for eksempel hente manglende hendelser etter en tilkoblingsfeil. Abonnenter må ikke beregne nye gjentagelses-ID-er basert på en lagret ID for å referere til andre hendelser i strømmen.

EventUuid-systemfelt

En universelt unik identifikator (UUID) som identifiserer en melding om en plattformhendelse. I Pub/Sub API-klienter inneholder hendelses-ID-feltet hendelses-UUID-verdien og er ikke versjonert. I andre abonnentklienter er EventUuid-feltet tilgjengelig i API-versjon 52.0 og nyere. API-versjonen tilsvarer versjonen som en Apex-utløser lagres med, eller versjonen som er angitt i et CometD-abonnentsluttpunkt.

API-navnsuffiks for tilpassede plattformhendelser

Når du oppretter en plattformhendelse, føyer systemet til __e-suffikset for å opprette API-navnet på hendelsen. Hvis du for eksempel oppretter en hendelse med objektnavnet Low Ink, er API-navnet Low_Ink__e. API-navnet brukes når du refererer til hendelsen programmatisk, for eksempel i Apex. API-navn for standard plattformhendelser, som AssetTokenEvent, inneholder ikke et suffiks.

Hendelsesabonnenter

Den relaterte listen Abonnementer viser alle utløsere, prosesser og hendelsesutløste flyter som abonnerer på en plattformhendelse. Pub/Sub API-abonnenter, CometD-abonnenter, som din egen CometD-klient eller empApi Lightning-komponenten, er ikke oppført på denne siden.

Listen viser ID-en for ny avspilling for hendelsen som siste behandlet (ID-feltet for siste behandling) og hendelsen som sist ble publisert (ID-feltet for siste publisering). Å vite hvilken ID for ny avspilling som sist ble behandlet, er nyttig når det er en åpning mellom hendelsene som er publiserte og som er behandlede. En utløser kan for eksempel inneholde kompleks logikk som fører til en forsinkelse i behandlingen av store grupper med innkommende hendelser.

Merk For plattformhendelser med høyt volum er ikke ID-verdien for sist publisert tilgjengelig, og den vises alltid som Ikke tilgjengelig.

Abonnementer-listen viser også statusen til hver abonnent, som kan være en av følgende.

• Running: Abonnenten lytter aktivt på hendelser. Hvis du endrer abonnenten, fortsetter abonnementet til å behandle hendelser.
• Error: Abonnenten ble koblet fra og sluttet å motta publiserte hendelser. En utløser når denne tilstanden når den overskrider antall maksimale gjentagelser med EventBus.RetryableException. Utløserdeklarasjonsfeil og ubehandlede unntak fører ikke til feilstatusen. Vi anbefaler å begrense antall nye forsøk til færre enn ni ganger for å unngå å nå denne statusen. Når du retter opp og lagrer utløseren, eller hvis du distribuerer pakken på nytt for en utløser i en administrert pakke, gjenopptar utløseren automatisk fra tipset, og starter fra nye hendelser. Du kan gjenoppta et utløserabonnement på abonnementsdetaljsiden som du får tilgang til fra plattformhendelsessiden.
• Suspended: Abonnenten kobles fra og kan ikke motta hendelser fordi en Salesforce-administrator har suspendert den eller på grunn av en intern feil. Du kan gjenoppta et utløserabonnement på abonnementsdetaljsiden som du får tilgang til fra plattformhendelsessiden. Gjenoppta en prosess ved å deaktivere den og så aktivere den på nytt. Hvis du endrer abonnenten, gjenopptas abonnementet automatisk fra tipset ved å starte fra nye hendelser.

Merk Bare én "Behandle"-abonnent vises i den relaterte listen Abonnementer for alle midlertidig stansede flytintervjuer som abonnerer på plattformhendelsen. Prosesser og plattformhendelsesutløste flyter er oppført individuelt.

Informasjon om hendelsesabonnementer vises også i EventBusSubscriber-objektet. Du kan spørre dette objektet for å finne detaljer om abonnementer.

Suspendere eller fortsette et Apex-utløserabonnement:

Gjenoppta et suspendert utløserabonnement der det ble avbrutt, med start fra den tidligste tilgjengelige hendelsesmeldingen som er lagret i hendelsesbussen. Hvis du vil omgå hendelsesmeldinger som forårsaker feil eller ikke lenger er nødvendige, kan du gjenoppta et abonnement fra tipset og starte med nye hendelsesmeldinger.

Slik behandler du et utløserabonnement:

1. Klikk på Behandle ved siden av Apex-utløseren i den relaterte listen Abonnementer.
2. Velg den riktige handlingen på detaljsiden for abonnementet.
   • Klikk på Suspender for å suspendere et abonnement som pågår.
   • Hvis du vil gjenoppta et suspendert abonnement ved å starte fra den tidligste hendelsesmeldingen som er tilgjengelig i hendelsesbussen, og klikker på Fortsett.
   • Hvis du vil gjenoppta et suspendert abonnement ved å starte fra nye hendelsesmeldinger, klikker du på Fortsett fra tips.

Du kan ikke behandle abonnementer for flyter og prosesser via den relaterte listen Abonnementer.

Merk

• Når du har endret en abonnent, gjenopptas abonnementet automatisk. Hvis du vil ha mer informasjon, kan du se delen Hendelsesabonnenter.
• Hvis du klikker på Gjenoppta for en utløser som er i feiltilstand, hopper utløseren over hendelsene som ble prøvd på nytt med EventBus.RetryableException. Abonnementet starter med de ikke-behandlede hendelsene sendt etter feilstatusen og som er i oppbevaringsvinduet.

Viktige punkter om plattformhendelser

• Feltnivåsikkerhet: Alle plattformhendelsesfelt er som standard skrivebeskyttede, og du kan ikke begrense tilgang til et bestemt felt. Tillatelser for feltnivåsikkerhet brukes ikke, og hendelsesmeldingen inneholder alle felt.
• Håndheving av feltattributter: Plattformhendelsesposter valideres for å sikre at attributtene til postens tilpassede felt håndheves. Feltattributter inkluderer attributtene Nødvendig og Standard, presisjonen til tallfelt og maksimal lengde av tekstfelt.
• Permanent sletting av hendelsesdefinisjoner: Når du sletter en hendelsesdefinisjon, fjernes den permanent og kan ikke gjenopprettes. Før du sletter hendelsesdefinisjonen må du slette de tilknyttede utløserne. Publiserte hendelser som bruker definisjonen, slettes også.
• Endre navn på hendelsesobjekter: Slett de tilknyttede utløserne før du gir nytt navn til en hendelse. Hvis navnet på hendelsen endres etter at klienter har abonnert på denne hendelsen, må klientene som abonnerer, abonnere på nytt på det oppdaterte emnet. For å abonnere på nytt på den nye hendelsen legger du til utløseren for hendelsesobjektet med det nye navnet.
• Ingen tilknyttet fane: Plattformhendelser har ingen tilknyttet fane fordi de ikke kan vise hendelsesposter i brukergrensesnittet i Salesforce.
• Ingen SOQL-støtte: Du kan ikke spørre hendelsesmeldinger med SOQL.
• Ingen støtte for postsider i Lightning-appbyggeren: Når du oppretter en postside i Lightning-appbyggeren, vises plattformhendelser som du har definert, i listen over objekter for siden. Du kan imidlertid ikke opprette en Lightning-postside for plattformhendelser fordi hendelsesposter ikke er tilgjengelige i brukergrensesnittet.
• Når du avinstallerer en pakke med alternativet Lagre en kopi av dataene i denne pakken i 48 timer etter avinstallering aktivert, eksporteres ikke plattformhendelser.
• Hendelsesvolum i pakkeinstallasjoner og -oppgraderinger: Installering av en administrert eller uadministrert pakke som inneholder en plattformhendelse med standardvolum, fører til at hendelsestypen lagres som høyt volum i abonnentorganisasjonen. Oppgradering av en administrert pakke endrer ikke hendelsesvolumet i abonnentorganisasjonen.
• Ingen støtte i Professional og Group Edition – Plattformhendelser støttes ikke i organisasjoner med Professional og Group Edition. Installering av en pakke som inneholder plattformhendelsesobjekter, mislykkes i disse organisasjonene.