Naudokite susiejimo ID, kad susietumėte skirtingus paleidiklius

Straipsnis
01/30/2024

Jei tai yra trileidimu pagrįstos, pasikartojančios kelionės, klientas gali pakartoti kelionę nebaigęs ankstesnio vykdymo. Pavyzdžiui, apsvarstykite kelionę, kuri siunčia susitikimo patvirtinimus ir priminimus. Kai asmuo užsiregistruoja pirmajam susitikimui, jis patenka į kelionę ir gauna patvirtinimą. Jie ir toliau lauks kelionėje, kol dieną prieš susitikimą gaus priminimą. Per tą laiką tas pats asmuo galėjo užsiregistruoti antram susitikimui. Kelionės dalyvis tą pačią kelionę pradės antrą kartą antram susitikimui. Kitaip tariant, tas pats asmuo dabar išgyvena du tos pačios kelionės atvejus.

Tokiu atveju, jei kelionės dalyvis atšaukia vieną iš susitikimų, jis turėtų išeiti tik iš kelionės, susijusios su atšauktu susitikimu. Pavyzdžiui, jei jie atšaukia pirmąjį susitikimą, jie turėtų išeiti iš kelionės, susietos su pirmuoju susitikimu, bet tęsti kelionę, susietą su antruoju susitikimu. Jei naudojate iš anksto parengtus įvykius Dataverse, tada veikimas yra automatinis ir nereikia atlikti jokių kitų veiksmų. Tačiau, jei naudojate pasirinktinius paleidiklius, turite sukonfigūruoti paleidiklį, kad teisingai identifikuotumėte konkretų kelionės atvejį, su kuriuo paleidiklis turi būti susietas.

Naudojant atributą bindingId, kad būtų galima unikaliai identifikuoti kiekvieną kelionės atvejį

Kiekvienas pasirinktinis paleidiklis turi pasirinktinį "bindingId" atributą, kurį galima naudoti norint susieti paleidiklį su konkrečiais kelionės atvejais. Kai atributo "bindingId" nėra, paleidiklis veiks visais kelionės, kurioje asmuo dalyvauja, atvejais. Pavyzdžiui, jei asmuo užsiregistravo dviem susitikimams, bet atšaukia vieną, ir jei atšauktas paleidiklis nenaudojo įpareigojančio ID, tada tas asmuo išeis iš abiejų kelionės egzempliorių. Jei ketinate naudoti paleidiklius pasikartojančiose kelionėse, labai rekomenduojama į paleidiklį įtraukti rišamąjįId .

Kai paleidiklyje, kuriuo pradedama kelionė, yra susiejimo ID, tas ID naudojamas kelionės egzemplioriui identifikuoti. Norint identifikuoti kelionės egzempliorių, bet kuris kitas įvykis turėtų naudoti tą patį privalomąjį ID. Įrišimo ID formatas yra toks: {entityType}/{entityId} Pavyzdžiui, jei jūsų pradžios įvykis yra Paskyros objektas, vadinamas Paskyra patvirtinta , ir jo objektoId yra "123", įpareigojantis Id bus Appointment/123. Jūsų išėjimo įvykio paskyra Atšaukta turi būti to paties objekto tipo ir turėtų naudoti tą patį įpareigojantį Id (Appointment/123), kad unikaliai identifikuotumėte kelionės egzempliorių.

Jei kelionėje naudojate tik pasirinktinius paleidiklius, galite pasikliauti unikaliomis eilutėmis, kad identifikuotumėte kelionės egzempliorius.

Pastaba.

Pasirinktinis paleidiklis veiks visuose veiklos ciklo, kuriame kas nors dalyvauja, egzemplioriuose, jei nėra susiejimo ID arba jei susiejimas skirtas kitam objekto tipui.

Susiekite tinkintus paleidiklius ir parengtus naudoti įvykius arba tinkintus verslo įvykius

Jei norite naudoti pasirinktinių paleidiklių ir parengtų naudoti arba pasirinktinių verslo įvykių derinį, bindingId naudoja specialų formatavimą, kad unikaliai identifikuotų Dataverse lentelę ir eilutę. Pavyzdžiui, jūsų kelionė gali prasidėti nuo iš anksto paruošto įvykio "Opportunity Created". Tada išėjimo įvykiui galite naudoti pasirinktinį paleidiklį, vadinamą "Opportunity Won ". Pasirinktinis paleidiklis "Opportunity Won" turi turėti susiejimo ID , kuris atitinka įvykio Sukurta galimybė modelį, kad būtų galima unikaliai identifikuoti kiekvieną egzempliorių.

Kai kelionę pradeda parengtas naudoti arba pasirinktinis verslo įvykis, kiekvieną kelionės atvejį galima unikaliai atpažinti pagal modelį {entityType}/{unique row ID}. Šis šablonas turi būti įtrauktas į bet kurio pasirinktinio paleidiklio atributą "bindingId", kad būtų galima susieti su pasirinktiniais paleidikliais ir parengtais naudoti arba pasirinktiniais verslo įvykiais.

"Opportunity Won " pasirinktinio paleidiklio atveju įrišimasId gali būti:

įrišimas Id = opportunity/{unique ID of the opportunity row}

Jei pasirinktiniai paleidikliai atitinka anksčiau aprašytą susiejimo id modelį, juos galima naudoti tiksliam kelionės egzemplioriui identifikuoti, net jei jie naudojami su kitais verslo įvykiais. Kai įgyvendinamas privalomasis Id , jis veikia visais kelionės atvejais.

Pastaba.

Susiejimas veikia tik su tais pačiais objektų tipais.

Kaip pridėti rišamąjį ID prie pasirinktinio paleidiklio

Galite modifikuoti privalomojo Id atributą pasirinktinio paleidiklio kodo fragmentas.

Norėdami pasiekti esamo pasirinktinio paleidiklio kodo fragmentas:

Eikite į Customer Insights - Journeys>sužadėtuvių>paleidiklius.
Pasirinkite pasirinktinį paleidiklį, prie kurio norite pridėti susiejimo ID .
Pasirinkite Eiti į kodo fragmentas.
Nukopijuokite fragmentas ir įklijuokite jį į pasirinktą kodo rengyklę. Modifikuokite atributą bindingId pagal anksčiau minėtus formatus (unikalią eilutę, jei ją naudojate tik su pasirinktiniais paleidikliais arba {table_name}/{unique row ID} koreliuodami su pasirinktiniais paleidikliais ir parengtais naudoti įvykiais arba pasirinktiniais verslo įvykiais).

Galite atlikti tuos pačius veiksmus, kad pridėtumėte įrišamąjį ID , kai kuriate naują pasirinktinį paleidiklį.

privalomas Id aiškinimas

Simbolis / yra rezervuotas. Visada daroma prielaida, kad įrišimo id yra atskirto / formato ir bet koks priekinis ar galinis elementas bus pašalintas / . Be to, rezultate nėra / . Programa visada bando tai interpretuoti tokiu {entityType}/{entityId} būdu.

Pavyzdžiai:

"A/B"
will be interpreted as 
{entityType = "A"}/{entityId = "B"}

"A"
will be interpreted as 
{entityType = ""}/{entityId = "A"}

"A/B/C" 
will be interpreted as 
{entityType = "AB"}/{entityId = "C"}

""
will be interpreted as 
{entityType = ""}/{entityId = ""}

"A/B/"
will be interpreted as 
{entityType = "A"}/{entityId = "B"}

"///A/B////"
will be interpreted as 
{entityType = "A"}/{entityId = "B"}

Palyginimo algoritmas:

[Case 0] trigger has bindingId = "", meaning no restriction at all
    Always resume.
[Case 1] entityType matches, and entityId matches:
    Resume.
[Case 2] entityType matches, but entityId doesn't match:
    No resume.
[Case 3] entityType doesn't match trigger:
    It doesn't make sense to apply binding, so we fall back to what we have now and let it resume the journey instance.