Bruge automatiseringsordbog til at videregive parameternøgler
Automatiseringsordbogen indeholder de kontekstafhængige data for sessioner. Du kan bruge nøglerne fra automatiseringsordbogen til at sende parameteren i en handling.
Når du opretter skabeloner og makroer i appen Admin, kan du overføre parameternøgler som titlen på en session, titlen på meddelelsen, titlen på en skabelon til programfane og brugerdefinerede parameterværdier for programfanetyper. Disse nøgler erstattes på baggrund af de kontekstoplysninger, der findes på kørselstidspunktet.
Overføre dataparameter i skabeloner
Lad os tage et scenario for skabeloner med meddelelserne.
Under meddelelsen vises bestemte felter og værdier, der kaldes henholdsvis Hoved i felt og Værdi.
Michael Jensen er en kunde, som har startet en samtale, og mens Helpdesk-medarbejderen ser meddelelsen, vises Kundenavn som Michael Jensen.
Her er Hoved i feltKundenavn, og Værdi er Michael Jensen.
Hvis skabeloner skal identificere navnet på kunden som Kenneth Smith, skal du (administratoren) overføre parameteren som nøgler.
På samme måde kan du overføre dataparametrene til sessions- og meddelelsesfelter. Flere oplysninger: Automationsordbogsformater til dataparameternøgler
Systemet erstatter disse parameternøgler med de faktiske værdier ud fra konteksten for sessionen, kanaludbyderen, Microsoft Dataverse og brugerhandlingerne. Flere oplysninger: Typer af kontekstdataparametre
Overføre dataparameter i makroer og helpdesk-medarbejderscripts
Makroer er et sæt konfigurerede sekventielle handlinger, der køres efter behov af brugeren. Som administrator skal du konfigurere de handlinger, der skal udføres i en makro. Hvis du vil konfigurere handlingerne, skal du overføre dataparametrene. Flere oplysninger: Automationsordbogens formater til overførsel af dataparameternøgler
Når Helpdesk-medarbejderen kører makroen, erstatter systemet disse parameternøgler med de faktiske værdier ud fra konteksten for sessionen, kanaludbyderen, Dataverse og brugerhandlingerne.
Når konteksten er fra en session, køres makrohandlingen på baggrund af oplysningerne om en aktuel session, hvor oplysningerne hentes fra en Anker-fane eller den aktuelle fane, der er i fokus. Hvis du vil oprette en sag, skal du f.eks. definere de handlinger, der indeholder formularen for hændelsesobjektet og GUID for formularen (valgfrit). Flere oplysninger: Typer af kontekstdataparametre
Typer af kontekstdataparametre
Automationsordbogen bruger de kontekstdataparametre, der er tilgængelige fra følgende kilder:
- Kontekstdata fra kanaludbyderen
- Kontekstdata fra brugerhandlinger
- Kontekstdata fra Dataverse
- Kontekstdata fra andre makrohandlinger
Kontekstdata fra kanaludbyderen
Disse kontekstdata er fra førstepartens kanaludbyder, f.eks. Omnikanal til Customer Service eller en tredjeparts kanaludbyder, der bruger den widget, som vises af Dynamics 365-kanalintegrationsstruktur. Kontekstdataene fra Omnikanal til Customer Service er undersøgelsen før samtale, gæsteportalnavigation osv.
Kontekstdata fra brugerhandlinger
Disse data udfyldes, mens og når Helpdesk-medarbejdere udfører en række aktiviteter i sessionen. Et eksempel er åbnning af en ny kundepost, sag osv.
Kontekstdata fra Dataverse
Organisationsdataene gemmes i Dataverse, og du kan hente dataene ved hjælp af OData-forespørgsler. Flere oplysninger: OData-forespørgsler
Kontekstdata fra andre makrohandlinger
En handling i en makro genererer kontekstdata, der forbruges af andre handlinger i den pågældende makro.
Der er f.eks. to handlingstrin i følgende rækkefølge:
- Åbn en ny formular for at oprette en post.
- Åbn en mailformular med en foruddefineret skabelon.
Når du opretter handlingen Åbn en e-mail- formular med en foruddefineret skabelon, kan du hente kontekstdataparameternøglerne i makrohandlingstrinnet Åbn en ny formular for at oprette en post.
Kontekstdataparameteren fra den første makrohandling er følgende:
- Objektets logiske navn
- Sidetype
- Fane-id
Bemærk
Kontekstdataparametrene fra andre makrohandlinger er specifikke for makroer og kan ikke anvendes på skabeloner.
Automationsordbogens formater til overførsel af dataparameternøgler
Automatiseringsordbogen indeholder de kontekstafhængige data for sessioner. Nøglerne i automationsordbogen kan overføres som parameterre til handlingen i makroer. Systemet erstatter disse parameternøgler med den faktiske værdi ud fra konteksten for sessionen, kanaludbyderen, Dataverse og brugerhandlingerne.
Automationsordbogen understøtter følgende formater:
Slug
En slug er en erstatningsparameter, som systemet udfylder under kørsel baseret på kontekst. Du kan kun bruge følgende liste over slugs til makroer og helpdesk-medarbejderscripts og til at angive et helpdesk-medarbejderscript som standard ved hjælp af udtryksgeneratoren for helpdesk-medarbejderscript. Flere oplysninger: Produktivitetsværktøjer
Slugs til produktivitetsværktøjer (makroer og helpdesk-medarbejderscripts)
Makroer og Helpdesk-medarbejderscripts understøtter følgende slugs:
| Slug | Beskrivelse |
|---|---|
${customerName} |
Navnet på den kunde, der har indledt samtalen. |
${caseId} |
Entydigt id for en sag. Sags-id'et vises kun i systemet, hvis der er knyttet en sag til samtalen. |
${caseTitle} |
Titlen på sagen. Sagstitlen vises kun i systemet, hvis sagen er knyttet til samtalen. |
${LiveWorkItemId} |
Det entydige samtale-id. |
${queueId} |
Entydigt id for en kø. Denne alfanumeriske streng vises i URL-adressen til køsiden. |
${visitorLanguage} |
Sproget for den kunde, der startede samtalen. |
${visitorDevice} |
Enheden for den kunde, der startede samtalen. |
${entityRoutingLogicalName} |
Navnet på objektet, hvis meddelelsen er for en objektpost. |
${customerEntityName} |
Navnet på objektet (kontakt eller firma), hvis kunden er godkendt. |
${customerRecordId} |
Det entydige id for objektet (kontakt eller firma), hvis kunden er godkendt. |
${<name of the pre-conversation survey questions>} |
Alle spørgsmål for undersøgelsen før samtale, som er konfigureret for en arbejdsstrøm, får slug-navnet som navnet på spørgsmålet. |
Bemærk
Det er kun ${anchor.<attribute_name>}-sluggen, der understøttes i makroer og scripts til Customer Service workspace.
Slug for link til genoprettelse af forbindelse
Følgende slug bruges til at oprette et link til genoprettelse af forbindelse, der kan deles med kunderne, så de kan oprette forbindelse tilbage til den samme Helpdesk-medarbejder og samtale. Flere oplysninger: Konfigurere genoprettelse af en forbindelse til en tidligere chat
| Slug | Beskrivelse |
|---|---|
{ReconnectUrl{ReconnectID}} |
Bruges i hurtige svar til at oprette linket til genoprettelse af forbindelse. |
Formatere for slugs til produktivitetsværktøjer
Parameterformatet ${Slug}, der henter konteksten fra kanaludbyderen, den aktuelle brugersession, output fra andre makrohandlinger eller Dataverse.
Kontekst for produktivitetsautomatisering
Når du vil udføre en slynge i forbindelse med produktivitetsautomatisering, som bruges til at udføre handlinger, der er relateret til modelbaserede apps i Dynamics 365, skal du bruge formatet ${</slug/>} Eksempel: ${customerName}
Kontekst for sessionsconnector
Når du vil udføre en slug i sessionskonteksten, skal du bruge formatet ${$session.<slug>}. Eksempel: ${$session.customerName}
Nogle af de slugs, der er tilgængelige for sessionskontekst, er følgende:
${$session.visitorDevice}${$session.visitorDevice}${$session.entityRoutingLogicalName}${$session.entityRoutingRecordId}${$session.<name of the pre-chat survey questions>
Omnikanal-connector-kontekst
Når du vil udføre en slug i konteksten af Omnikanal til Customer Service, skal du bruge formatet ${$oc.<slug>}. Eksempel: ${$oc.customerName}
Parametrene Session.CurrentTab.<Attribute> og Session.AnchorTab.<Attribute> giver kontekstdata, der er baseret på den aktuelle session og forankringsfanen eller den aktuelle fane i fokus. Følgende er understøttede attributtyper:
- EntityName
- EntityId
Eksempler:
Session.CurrentTab.<EntityName>Session.CurrentTab.<EntityId>Session.AnchorTab.<EntityName>Session.AnchorTab.<EntityId>
Bemærk
Parametrene Session.CurrentTab.<Attribute> og Session.AnchorTab.<Attribute> kan kun anvendes på makroer og kan ikke anvendes på skabeloner.
Slugs til skabeloner
Listen over understøttede slug er:
| Slug | Beskrivelse |
|---|---|
{anchor.<attribute_name>} |
Bruges til at få adgang til attributter for den post, der indlæses under forankringsfanen. |
{customerName} |
Navnet på den kunde, der har indledt samtalen. |
{caseId} |
Entydigt id for en sag. Sags-id'et vises kun i systemet, hvis sagen er knyttet til samtalen. |
{caseTitle} |
Titlen på sagen. Sagstitlen vises kun i systemet, hvis sagen er knyttet til samtalen. |
{queueId} |
Entydigt id for en kø. Denne alfanumeriske streng vises i URL-adressen til køsiden. |
{visitorLanguage} |
Sproget for den kunde, der startede samtalen. |
{visitorDevice} |
Enheden for den kunde, der startede samtalen. |
{entityRoutingLogicalName} |
Navnet på objektet, hvis meddelelsen er for en objektpost. |
{entityRoutingRecordId} |
Det entydige id for objektposten, hvis meddelelsen er for en objektpost. |
{customerRecordId} |
Det entydige id for objektet (kontakt eller firma), hvis kunden er godkendt. |
{<name of the pre-chat survey questions>} |
Alle spørgsmål for undersøgelsen før chat, som er konfigureret for en arbejdsstrøm, får slugnavnet som navnet på spørgsmålet. |
Formatere til slugs for skabeloner
Parameterformatet {Slug}, der henter skabelonkonteksten fra kanaludbyderen, den aktuelle brugersession eller Dataverse. Eksempel: {caseId}
OData-forespørgsler
OData-forespørgsler kan bruges til at hente de kontekster, der er tilgængelige fra Dataverse.
OData-forespørgselsformatet er:
{$odata.<entityName>.<entityAttributeName>.<?options>}
Eksempler:
{$odata.account.name.?$filter=accountid eq '{customerRecordId}'}{$odata.incident.prioritycode.?$filter=incidentid eq '{caseId}'&$select=prioritycode}{$odata.incident.title.?$filter=incidentid eq '{caseId}'&$select=title}
Statiske værdier
Det er faste værdier, som du opdaterer ud fra din virksomheds krav. For alle de faste attributter, du vælger, skal du følge formattypen for den pågældende attribut.
Eksempel (makro):
Der skal altid tilføjes en sagstitel til Contoso -. Du kan bruge handlingen Åbn en ny formular for at oprette en post med følgende felter.
| Parameter | Værdi |
|---|---|
| Objektets logiske navn | hændelse |
| Attributnavn | Sagstitel |
| Attribute value | Contoso - {caseTitle} |
Her er Contoso - den faste statiske værdi.
Eksempel (skabeloner):
I forbindelse med en indgående chatanmodning skal du angive den statiske titel for sessions- og meddelelsesskabelonen, som helpdesk-medarbejdere ser under kørsel.
Meddelelsestitel = New chat request
Sessionstitel = Chat conversation
Se også
Administrere sessionsskabeloner
Administrer programfaneskabeloner
Administrer meddelelsesskabeloner
Knytte skabeloner til arbejdsstrømme