Automatisere dataoverføring med aktiveringsutløste flyter
Koble Data 360-aktiveringer til eksterne systemer automatisk med MuleSoft for Flow Integration-koblinger eller en HTTP-oppkallhandling.
Nødvendige utgaver
| Se støttede versjoner. |
| Nødvendige brukertillatelser | |
|---|---|
| For å opprette, redigere, lagre, slette og aktivere en aktiveringsutløst flyt | Tidligere Data Cloud-markedsføringsadministrator ELLER Data Cloud-aktiveringsleder ELLER Data Cloud-arkitekt ELLER Data Cloud-aktiveringsspesialist ELLER Behandle flyt ELLER Alle disse tillatelsene:
|
Du kan koble til et eksternt målsystem ved å bruke aktiveringsutløste flyter på to måter:
- MuleSoft Connectors: MuleSoft-koblinger er tilgjengelig i Flow Builder. Når du konfigurerer en handling i flyten, kan du velge blant disse koblingene. Hvis du vil finne de støttede handlingene og den nødvendige tilleggslisensen for hver kobling, kan du se Tredjepartskoblinger.
- Eksterne tjenester (HTTP-oppkall): Du kan koble til via et HTTP-oppkall, som bruker eksisterende Salesforce Platform-funksjonalitet som Eksterne tjenester og Navngitt legitimasjon. Før du oppretter flyten, konfigurerer du en navngitt legitimasjon ved å bruke plattformens mulighet til å konfigurere API-endepunktene og godkjenningsdetaljene for det eksterne systemet. Når du legger til en handling i flyten, velger du alternativet Opprett HTTP-oppkall og velger deretter den navngitte legitimasjonen du tidligere konfigurerte. Hvis du vil vite mer om opprettelse og behandling av eksterne tjenester, kan du se Registrere en ekstern tjeneste.
Hvis du vil opprette en aktiveringsutløst flyt, må du opprette en aktivering for et segment eller opprette en aktivering for gruppedemo i Data 360. Aktiveringsutløste flyter støtter bare aktiveringsmåltypen Data 360.
Aktiveringsutløste flyter støtter følgende godkjenningsmetoder når de kobles til andre API-baserte destinasjoner:
- OAuth 2.0
- Godkjenningskodeflyt: Anbefales for apper der brukermedvirkningen skjer via en nettleser.
- Client Credentials Flow (Klientlegitimasjonsflyt): Anbefales for server-til-server-interaksjoner uten brukerengasjement. Håndhold mellom Salesforce og det eksterne målsystemet for å hente og oppdatere tokener må være i samsvar med standarder for å kunne bruke klientlegitimasjon.
- Grunnleggende godkjenning: Brukeren oppgir et brukernavn og passord.
- API-nøkler: API-tilgang ved å oppgi en unik nøkkel i HTTP-forespørselen.
Se Viktige punkter om aktiveringsutløste flyter for å få mer informasjon om godkjenning.
- Opprette flyten
Opprett en aktiveringsutløst flyt. - Feilsøke og vise flytmålinger og rapporter
Konfigurer organisasjonen til å vise målinger og rapporter for aktiveringsutløste flyter slik at du kan overvåke og feilsøke flytkjøringer. - Viktige punkter om aktiveringsutløste flyter
Vis flere viktige punkter om aktiveringsutløste flyter.
Se også:
Opprette flyten
Opprett en aktiveringsutløst flyt.
- Gå til Flyter-fanen i Automatisering-appen, og klikk på Ny.
- Søk etter og velg Aktiveringsutløst flyt.
-
Velg Data 360-aktiveringen som utløser flyten, fra aktiveringsbiblioteket.
Aktiveringsutløste flyter støtter bare aktiveringer som er opprettet med Data 360 som aktiveringsmåltype. Selv om listen over tilgjengelige aktiveringer i Flow Builder kan vise aktiveringer med andre måltyper som Marketing Cloud, fører valg av en som ikke er av måltypen Data 360, til en feil når du prøver å lagre flyten. Du må forhåndsvise at aktiveringen du velger, har måltypen Data 360.
- I Start-elementet kan du eventuelt konfigurere utgangsregler og gjenoppføringsbetingelser. Utgangsregler avslutter en flyt hvis bestemte betingelser oppfylles. Utgangsregler er nyttige i situasjoner der en brukers forhold endres over tid. Gjenoppføringsbetingelser bestemmer om en bruker har rett til å gå tilbake til samme flyt igjen.
-
Klikk på
, og velg Handling.
-
Velg en handlingsgruppe i søkepanelet. Velg enten en kobling eller velg Annet for å opprette et HTTP-oppkall (ekstern tjeneste).
- Hvis du vil bruke en MuleSoft-kobling, velger du den ønskede koblingen og konfigurerer tilkoblingsdetaljene eller velger en eksisterende tilkobling.
- Hvis du vil bruke en ekstern tjeneste, velger du en eksisterende ekstern tjeneste eller oppretter HTTP-oppkall ved å velge den forhåndskonfigurerte navngitte legitimasjonen og bruke PUSH / PUT-metoden sammen med URL-adressen til API-sluttpunktet og JSON-eksempelforespørselen.
-
Velg en handling, og tilordne feltene som kreves av det eksterne systemet, til dataene som er tilgjengelig fra aktiveringsdataene som utløses.
Du kan tilordne aktiveringsdata opptil fem nivåer dypt for relaterte attributter.
- Hvis du trenger å bruke aktiveringsdatarelaterte attributter, må du først transformere de relaterte attributtene til en støttet type, som en Apex eller -objekt. Hvis den eksterne tjenesten for eksempel krever en Apex, bruker du et transformasjons- eller tildelingselement til å opprette en Apex.
- For å identifisere Apex som kreves for handlingen, oppretter du en ny ressurs. I vinduet Ny ressurs kopierer du den eksisterende verdien i Apex. Når du har kopiert verdien, avbryter eller lukker du vinduet.
- Legg til et transformasjonselement før handlingselementet.
- I transformasjonselementet velger du $ActivationData som datakilde og velger Apex-Defined for måldatatypen. Lim inn Apex i Apex. Klikk på Opprett.
- Konfigurer resten av flyten.
- Aktiver flyten.
Feilsøke og vise flytmålinger og rapporter
Konfigurer organisasjonen til å vise målinger og rapporter for aktiveringsutløste flyter slik at du kan overvåke og feilsøke flytkjøringer.
Hvis du støter på uventet virkemåte:
- Kontroller publiseringsstatusen til segmentet som ble brukt til å opprette Data 360-aktiveringen.
- Hvis segmentpubliseringsstatusen er Vellykket, kontrollerer du Segmentantallet og tilsvarende Aktiveringsantall i Publiseringshistorikk-tabellen i Segmentgrensesnittet i Data 360 eller Aktiveringshistorikk-tabellen i Aktiveringsgrensesnittet i Data 360.
- Hvis publiseringsstatusen for segmentet og antall aktiveringer er Vellykket, skal den tilhørende aktiveringen utløse den aktiveringsutløste flyten.
- Etter at en aktivering utløser en aktiveringsutløst flyt, men før selve flyten fullfører utførelsen, oppretter vi en forekomstpost for flytversjon. Etter hvert som flyten kjører sporer forekomstposten for flytversjoner oppføringer, utganger og feil for en bestemt flytversjon.
- Når du viser en aktiveringsutløst flyt i Flow Builder, kan du velge individuelle elementer på lerretet og se målinger for dette elementet.
Hvis du vil vise detaljene for flytkjøringer, kan du også opprette en Flytelementkjøring-rapport. Aktiveringsutløste flyter krever at du distribuerer datastrømmer for DMO-ene FlowRun og FlowElementRun. Disse datastrømmene aktiverer logging av kjøringshistorikk for flyter. Flytkjøringshistorikk kan spørres og kan hjelpe deg å forstå detaljene om flytkjøringer, og bidra til å feilsøke eventuelle problemer.
- Installer pakken Salesforce Data Cloud - Flow Integration for alle brukere.
- Velg Datastrømmer-fanen i Data 360-appen og klikk på Ny.
- Velg Installerte datasett og pakker i vinduet Ny datastrøm, og klikk på Neste.
- Velg Data Cloud-flyt fra Datasett-listen
- Merk av i avmerkingsboksen ved siden av Flow_Inntaks for å velge alle datastrømmer, og klikk deretter på Neste.
- Velg Ny kobling som koblingsnavn.
- Skriv inn Flytkjøringinntak som koblingsnavn, og klikk på Lagre.
- Klikk på Neste for å gå gjennom trinnene til du kan distribuere datastrømmen, og klikk deretter på Distribuer.
- Distribuer deretter Flytpost-strømmene. Skriv inn Tillatelsessett i Hurtigsøk-feltet i Oppsett, og velg den.
- Klikk på tillatelsessettet Data Cloud Salesforce-kobling.
- Klikk på Apptillatelser i Apper-delen.
- Velg Vis flyter under Flyt- og Flytorkestrering, og klikk deretter på Lagre og bekreft.
- Velg Datastrømmer-fanen i Data 360-appen og klikk på Ny.
- Velg Salesforce CRM i vinduet Ny datastrøm, og klikk deretter på Neste.
- Velg Flyter under Tilpassede pakker, og klikk deretter på Neste.
- Klikk på Neste for å gå gjennom trinnene til du kan distribuere datastrømmen, og klikk deretter på Distribuer.
- Hvis du vil opprette en rapport, går du til fanen Rapporter i appen Data 360 og klikker på Ny rapport.
- Velg Flytelement med Flytelementkjøring i Data Cloud-kategorien, og klikk deretter på Start rapport.
-
Legg til disse kolonnene i Disposisjon-fanen:
- Flytelement: Info – Navn
- Flytelement: Info - Flytversjon
- Flytelement: Info - Feilårsak
- Flytelement: Info – Feildeskrivelse
- Flytelementkjøring: Info - Scheduled DateTime (Info - planlagt dato/klokkeslett)
- Flytelementkjøring: Info - Completed DateTime (Info - dato/klokkeslett for fullført)
- I Filtre-fanen legger du til et tomt filter med er lik-operatoren for Flytversjon.
- Klikk på Lagre.
- For å få flytversjons-IDen som kreves for rapportfilteret, velger du den aktiveringsutløste flyten i Lightning Automatisering.
- Velg den aktuelle flytversjonen på Relatert-fanen.
-
Kopier flytversjons-IDen på adresselinjen i nettleseren. IDen begynner med
10v. - Lim inn flytversjons-ID-en i filteret i rapporten du opprettet tidligere, og klikk på Bruk.
Viktige punkter om aktiveringsutløste flyter
Vis flere viktige punkter om aktiveringsutløste flyter.
Viktige punkter om grenser
Grensen for aktiveringsutløste flyter avhenger av lisensen din. Frekvensgrenser måles i handlinger per time. Handlinger defineres ved utføring av en enkelt bane i en flyt, inkludert når flyten starter og når flyten gjenopptas. Flyter gjenopptas etter å ha ventet på at noe skal skje, som en ventelementvarighet som utløper eller mottar en engasjementshendelse.
En flyt uten vent-elementer utføres for eksempel i én handling. En flyt med et vent-element utføres i to handlinger, med den første handlingen som inkluderer alt opp til vent-elementet, og den andre handlingen som inkluderer alt etter at flyten gjenopptas.
I tillegg til grensen for handling per time er det en grense for samtidighet som bestemmer antall flytkjøringer som utføres per time. Generelt sett deles den totale grensen for samtidighet jevnt mellom eventuelle kjørende flyter.
| Grense for utførelse | Samtidig tråder |
|---|---|
| 150 000 handlinger per time | 2 |
| Starter: 1 000 000 handlinger per time | 14 |
| Marketing Cloud Neste, Data 360: 15 000 000 handlinger per time | 210 |
Bruk formelen (actions per hour * time to execute in seconds) / 3600 = required
concurrency per hour til å finne ut om flyten overskrider grensen for samtidighet som kreves for å maksimere antall handlinger per time.
En organisasjon som er klargjort med 15 millioner handlinger per time, har for eksempel en flyt med én enkelt handling som tar i snitt 40 millisekunder å utføre. (15,000,000 * 0.04) /
3600 = 167. Fordi 167 er under grensen for samtidighet på 210, kan flyten utføre 15 000 000 handlinger per time.
Hvis en annen flyt har én enkelt handling, men det tar i gjennomsnitt 150 millisekunder å utføre på grunn av en handling i en ekstern tjeneste, bruker du formelen (15,000,000 * 0.15) / 3600 =
625. Fordi 625 er større enn samtidighetsgrensen på 210, kan flyten utføre omtrent 5 000 000 handlinger per time hvis den bruker alle 210 tråder.
Den siste begrensende faktoren er flytens feilfrekvens. Feilfrekvenser teller bare med feil som kan prøves på nytt. Flytelementer som mislykkes mer enn 2,5 % av tiden, utløser ytterligere frekvensbegrensninger. Samtidighetsgrensen justeres til feilfrekvensen forblir konsistent under 2,5 %. Disse justeringene bidrar til å beskytte nedstrøms tjenester, som eksterne tjenester. Feilfrekvenser er sannsynligvis den vanligste begrensende faktoren som påvirker en flyts mulighet til å utføre sine maksimale handlinger per time.
Flyter som krever sanntidsvar, som skjemasendinger, SMS-registreringer, toveis SMS-meldinger og e-postmeldinger med transaksjoner med høy prioritet, har en ekstra tillatelse på 50 % i forhold til grensen for samtidighet. Hvis du for eksempel har en samtidighetsgrense på 210, kan flyter som krever sanntidssvar, få tilgang til ytterligere 105 samtidige forespørsler (210 * 1,5 = 315).
Viktige punkter om godkjenning
Aktiveringsutløste flyter støtter to OAuth 2.0-godkjenningsflyter.
- Godkjenningskodeflyt
- Formål: Brukes hovedsakelig for programmer der brukerinteraksjon via en nettleser er forventet eller nødvendig.
- Prosess:
- Brukeren omdirigeres til den eksterne appens godkjenningsserver for å godkjenne og godkjenne programmet.
- Ved vellykket godkjenning returneres en godkjenningskode til Salesforce via en URI for omdirigering.
- Programmet utveksler denne godkjenningskoden for et tilgangstoken, som Salesforce oppdaterer ved behov.
- Bruksområde: Best egnet for nettprogrammer og programmer som krever høy sikkerhet, spesielt i tilfeller som krever Per bruker-tilgang.
- Referanser:
- Flyt for klientlegitimasjon
- Formål: Passer for server-til-server-interaksjoner der ingen bruker er involvert.
- Prosess:
- Klientprogrammet sender en forespørsel direkte til den eksterne appens tokensluttpunkt, inkludert dens klient-ID og klienthemmelighet.
- Den eksterne appen returnerer et tilgangstoken som kan brukes til å godkjenne API-forespørsler.
- Bruksområde: Ideal for serverdeltjenester eller programmer som bruker ressurser på vegne av seg selv i stedet for en bruker.
- Referanser:
- Vurderinger: Håndhold mellom Salesforce og det eksterne målsystemet for å hente og oppdatere tokener må være i samsvar med standarder for å kunne bruke klientlegitimasjon. Enkelte leverandører som ikke har virkemåte som samsvarer med standarder, støttes ikke.
Aktiveringsutløste flyter støtter flere former for godkjenning:
- Enkel godkjenning
- Formål: En enkel metode for klient-server kommunikasjon.
- Prosess:
- Klienten sender HTTP-forespørsler med brukernavnet og passordet kodet i base64 i forespørselshodet.
- Serveren dekoder og bekrefter legitimasjonen før tilgang gis.
- Sikkerhetshensyn: Grunnleggende godkjenning bør brukes med forsiktighet og alltid over HTTPS for å kryptere legitimasjonen og sikre at de ikke eksponeres under overføring.
- Referanser:
- API-nøgler
- Formål: Aktiverer enkel API-tilgang ved å bygge inn en unik nøkkel i HTTP-forespørselen.
- Prosess:
- Salesforce inkluderer API-nøkkelen som en del av HTTP-forespørslene – vanligvis i et hode – for godkjenning med tjenesten.
- Serveren validerer API-nøkkelen før forespørselen behandles.
- Bruksområde: Bekvemt for integrering av systemer der brukervennlighet er en prioritet fremfor komplekse sikkerhetskrav.
- Referanser:
- Det er ingen bransjestandard eller spesifikasjon for API-nøkler. Undersøk den eksterne appens dokumentasjon nøye for å finne hvor godt det passer med det som Salesforce støtter.
- Bruke API-nøkler i tilpassede hoder med navngitt legitimasjon
Andre vurderinger
Du kan ikke pakke Data 360-metadata, som aktiveringer, i samme pakke som ikke-Data 360-metadata. Bruk 2 pakker for å pakke en Data 360-aktivering med en flyt.
En flytkjøring som inkluderer en MuleSoft-kobling, bruker automatiseringskreditter. Flytkjøringer som mislykkes på grunn av spesifikke interne feil, forbruker ikke automatiseringskreditter. Se MuleSoft: Bruk av automatiseringskvoter og priser.
