Utilizzare le macro per l'automazione della produttività

Puoi automatizzare le seguenti attività con le macro per l'automazione della produttività:

• aprire e aggiornare i record
• apri viste
• risolvi casi
• cercare nella Knowledge Base
• clona record
• impostare lo stato attivo su un altro script dell'agente
• aprire i modelli di messaggio
• compilare automaticamente campi modulo
• impostare e recuperare variabili e valori nel contesto della sessione

Puoi utilizzare le azioni per l'automazione della produttività un numero qualsiasi di volte in diverse macro per automatizzare ed eseguire operazioni con le app basate su modello.

Le sezioni seguenti descrivono le diverse azioni per l'automazione della produttività che è possibile utilizzare per creare macro.

Apri un nuovo modulo per creare un record

Apre un nuovo modulo per creare un record. L'azione contiene i campi seguenti.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità che intendi aprire.
ID modulo dell'entità	Specifica l'ID modulo.
Nome attributo	Specifica il nome logico dell'attributo. Devi immettere il nome dell'attributo affinché l'applicazione precompili il campo con un valore.
Valore attributo	Specifica il valore dell'attributo. Devi immettere il valore dell'attributo affinché l'applicazione precompili il campo dell'attributo.

Nota

Questa azione richiede un modello specifico per impostare i valori di ricerca. È necessario passare l'ID del record correlato, il tipo di record e il nome del record come attributi separati per una singola ricerca.

Esempio 1: creare una nuova attività da un caso esistente

Esegui i passaggi seguenti per creare una macro per aprire un'attività dal caso:

1. Aggiungi l'azione Apri un nuovo modulo per creare un record che crea un'attività con i seguenti attributi:
   • Oggetto: numero di casi recuperati utilizzando un parametro dati.
     • Nome attributo: oggetto
     • Valore attributo: completamento dell'attività relative a $(anchor.ticketnumber)
   • Descrizione: Combinazione di una stringa di testo e dell'indirizzo e-mail del cliente recuperati utilizzando una query oData.
     • Nome attributo: descrizione
     • Valore attributo: esamina l'e-mail del cliente: {$odata.contact.emailaddress1.?$filter=contactid eq '{anchor._customerid_value}'}
   • Tema: record del cliente.
     • Nome attributo: regardingobjectid
     • Valore attributo: ${anchor.incidentid}
     • Nome attributo: regardingobjectidtype
     • Valore attributo: incident
     • Nome attributo: regardingobjectidname
     • Valore attributo: ${anchor.title}
2. Aggiungi l'azione Salva il record.

Esempio 2: crea un nuovo caso da una conversazione

Esegui i passaggi seguenti per creare una macro per aprire un caso da una conversazione:

1. Aggiungi l'azione Apri un nuovo modulo per creare un record con i seguenti attributi:
   • Oggetto: conversazione recuperata utilizzando un parametro dati.
     • Nome attributo: oggetto
     • Valore attributo: completamento con $(customerName)
   • Descrizione: combinazione di una stringa di testo e dell'indirizzo e-mail del cliente recuperati utilizzando una query oData.
     • Nome attributo: descrizione
     • Valore attributo: esamina l'e-mail del cliente: {$odata.contact.emailaddress1.?$filter=contactid eq '{customerRecordid}'}
   • Tema: record del cliente.
     • Nome attributo: regardingobjectid
     • Valore attributo: ${customerRecordid}
     • Nome attributo: regardingobjectidtype
     • Valore attributo: ${customerEntityName}
     • Nome attributo: regardingobjectidname
     • Valore attributo: ${customerName}
2. Aggiungi l'azione Salva il record.

Apri un record esistente

Apre un modello di record esistente. L'azione contiene i campi seguenti.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità che intendi aprire.
ID record dell'entità	Specifica l'ID record dell'entità.
ID modulo dell'entità	Specifica l'ID modulo.

Esempio 1: apri il record del prodotto da un caso esistente

Per creare una macro per aprire il record del prodotto da un caso esistente, aggiungi l'azione Apri un record esistente che legge l'ID del prodotto dal caso, con i seguenti attributi:

• Nome logico entità: product
• ID record dell'entità: ${anchor._productid_value}

Esempio 2: apri il record del cliente da una conversazione

Per creare una macro per aprire un record del cliente da una conversazione esistente, aggiungi l'azione Apri un record esistente che legge l'ID del cliente dalla conversazione, con i seguenti attributi:

• ID record dell'entità: ${customerEntityName}
• Nome logico entità: ${customerRecordid}

Compila automaticamente campi modulo

Aggiorna i campi dei moduli. L'azione macro non salva automaticamente i nuovi valori in Dataverse finché il modulo non attiva il salvataggio automatico. È possibile utilizzare un'altra azione della macro per salvare il record. In alternativa, puoi utilizzare la macro Aggiorna record esistente in base ai requisiti aziendali. Questa azione si applica al modulo nella scheda evidenziata e ha lo stesso tipo di entità menzionato nell'azione.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità che intendi aggiornare.

Nota

Questa macro richiede un modello specifico per impostare i valori di ricerca. È necessario impostare l'ID del record correlato, il tipo di record e il nome del record come attributi separati per una singola ricerca.

Esempio 1: apri il modulo di un'attività e compila i campi del modulo dal caso

Esegui i passaggi seguenti per creare una macro che apra il modulo di attività e quindi compili il modulo con i valori della scheda di ancoraggio:

1. Aggiungi l'azione Apri un nuovo modulo per creare un record che apre un record attività con i seguenti parametri:
   • Nome logico entità: task.
2. Aggiungi i campi del modulo di compilazione automatica che compilavano il nuovo record dell'attività con i valori del modulo del caso che è la scheda di ancoraggio, con i seguenti attributi:
   • Nome logico entità: task
   • Nome attributo: oggetto
   • Valore attributo: completamento dell'attività relative a ${anchor.ticketnumber}
   • Nome attributo: regrdingobjectid
   • Valore attributo: {{"id":"${anchor.incidentid}","name":"${anchor.title}","entitytype":"incident"}}

Esempio 2: apri il modulo di un'attività e compila i campi da una conversazione

Esegui i passaggi seguenti per creare una macro che apra il modulo di attività e quindi compili il modulo con i valori dalla conversazione usando i parametri dei dati:

1. Aggiungi l'azione Apri un nuovo modulo per creare un record che apre un record attività con i seguenti parametri:
   • Nome logico entità: task.
2. Aggiungi i campi del modulo di compilazione automatica che compilavano il nuovo record dell'attività con i valori della conversazione con i seguenti attributi:
   • Nome logico entità: task
   • Nome attributo: oggetto
   • Valore attributo: completamento dell'attività relative a ${anchor.customerName}
   • Nome attributo: regrdingobjectid
   • Valore attributo: "${customerName}","entitytype":"${customerEntityName}"}}

Aggiorna un record esistente

Aggiorna un record esistente. L'azione contiene i campi seguenti.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità che intendi aggiornare. Questo campo è obbligatorio.
ID record dell'entità	Specifica l'ID record dell'entità. Questo campo è obbligatorio.
Nome attributo	Specifica il nome logico dell'attributo che desideri aggiornare.
Valore attributo	Specifica il valore dell'attributo che viene aggiornato per l'attributo sopra menzionato.

Nota

Questa macro richiede un modello specifico per impostare i valori di ricerca. È necessario impostare l'ID del record correlato, il tipo di record e il nome del record come attributi separati per una singola ricerca.

Esempio 1: apri il modulo di attività, crea l'attività, quindi aggiorna il record

Esegui i passaggi seguenti per creare una macro che apra il modulo di attività e crei un nuovo modulo e quindi aggiorni il modulo di attività da un record esistente:

1. Aggiungi l'azione Apri un nuovo modulo per creare un record che apre un record attività con i seguenti parametri:
   • Nome logico entità: task
2. Aggiungi l'azione Salva il record.
3. Aggiungi Aggiorna un record esistente che compila il nuovo record dell'attività con l'ID del record e il nome logico dal contenuto dinamico (ottenuto dopo l'azione di salvataggio del record) e l'oggetto del tema basato sui valori dalla scheda di ancoraggio, con i seguenti attributi:
   • ID record dell'entità: Entity record ID
   • Nome logico entità: Entity logical name
   • Nome attributo: regardingobjectid_incident@odata.bind
   • Valore attributo: /incidents{${anchor.incidentid}}
4. Aggiungi l'azione della sessione Aggiorna la scheda per aggiornare il modulo dell'attività poiché la macro di aggiornamento del record esegue un'operazione di back-end e non aggiorna automaticamente la scheda.

Attenzione

Nell'esempio, il modulo si aggiorna dopo le azioni Salva il record e le azioni Aggiorna la scheda. Ti consigliamo di progettare le macro in modo tale da ridurre il caricamento dei moduli.

Risolvere un caso

Utilizza l'azione per risolvere un caso. L'azione contiene i campi seguenti.

Campo	Descrzione
Tempo fatturabile	Specifica il tempo fatturabile. Questo campo è obbligatorio.
ID incidente	Specifica l'ID del caso che desideri chiudere. Questo campo è obbligatorio.
Risoluzione	Specifica il motivo di risoluzione del caso. Questo campo è obbligatorio.

Esempio: Macro per risolvere un caso

Esegui i passaggi seguenti per creare una macro che risolva un caso. Quando gli agenti risolvono un caso utilizzando la macro, la scheda non viene aggiornata automaticamente, pertanto si consigliano ulteriori passaggi per una migliore esperienza utente.

1. Aggiungi l'azione Azione per risolvere il caso per impostare il tempo fatturabile come valore numerico e l'ID incidente è l'ID del record che deve essere risolto, con i seguenti attributi:

• ID incidente: ${anchor.incidentid}
• Tempo fatturabile: 0
• Risoluzione: Case${anchor.ticketnumber} risolta tramite macro

1. Aggiungi il connettore di sessione Recupera la scheda corrente.
2. Aggiungi l'azione di sessione Aggiorna la scheda per aggiornare la scheda con i seguenti attributi: -ID scheda: ID scheda

Apri un modulo e-mail con un modello predefinito

Questa azione è utilizzata per aprire un messaggio di posta elettronica con un modello predefinito. L'azione contiene i campi seguenti.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità a cui inviare l'e-mail. Questo campo è obbligatorio.
ID record dell'entità	Specifica l'ID del record dell'entità a cui inviare l'e-mail. Questo campo è obbligatorio.
Destinatari messaggio e-mail	Specifica il nome visualizzato del record a cui inviare l'e-mail. Questo campo è obbligatorio.
ID modello	Specifica l'ID del modello di posta elettronica del tipo di entità a cui viene inviata l'e-mail e che deve essere visualizzato nell'e-mail. Questo campo è obbligatorio.

Nota

Il campo Destinatari e-mail richiede un parametro ma non viene mappato automaticamente a un utente nel modulo. Ti consigliamo di utilizzare la macro campi del modulo di compilazione automatica per compilare i valori di conseguenza.

Esempio 1: apri un modello di e-mail da un caso

Esegui i seguenti passaggi per creare una macro che apra un modello di e-mail della categoria del caso:

1. Aggiungi l'azione Apri un modulo e-mail con un modello predefinito che aggiunge il modello in base all'ID del modello e compila il modulo e-mail con i campi A e Tema. Gli attributi sono i seguenti:
   • ID modello: specificare l'ID del modello di e-mail richiesto.
   • ID record entità: ${anchor.incidentid}
   • Destinatari e-mail: ${anchor._customerid_value@OData.Community.Display.V1.FormattedValue}
   • Nome logico entità: incident
2. Aggiungi l'azione campi del modulo di compilazione automatica per compilare i campi A e Tema. Gli attributi sono i seguenti:
   • Nome logico entità: Email
   • Nome attributo: su
   • Valore attributo: [{"id":"${anchor._customerid_value}","entitytype":"contact","name":"${anchor._customerid_value@OData.Community.Display.V1.FormattedValue}"}]
   • Nome attributo: regardingobjectid
   • Valore attributo: [{"id":"${anchor.incidentid}"},"name":"${anchor.title}","entitytype":"incident"}]

Esempio 2: apri un modello di e-mail da una conversazione

Esegui i seguenti passaggi per creare una macro che apra un modello di e-mail della categoria del contatto:

1. Aggiungi l'azione Apri un modulo e-mail con un modello predefinito che aggiunge il modello in base all'ID del modello e compila il modulo e-mail con i campi A e Tema. Gli attributi sono i seguenti:
   • ID modello: specificare l'ID del modello di e-mail richiesto.
   • ID record entità: ${customerRecordId}
   • Destinatari e-mail: ${customerName}
   • Nome logico entità: ${customerEntityName}
2. Aggiungi l'azione campi del modulo di compilazione automatica per compilare i campi A e Tema. Gli attributi sono i seguenti:
   • Nome logico entità: Email
   • Nome attributo: su
   • Valore attributo: [{"id":"${customerRecordId}", "entitytype":"contact","name":"${customerName}"}]
   • Nome attributo: regardingobjectid
   • Valore attributo: [{"id":"${customerRecordId}"},"entitytype":"contact","name": "${customerName}"}]|

Esempio 3: apri un modello di e-mail con più destinatari

Esegui i seguenti passaggi per creare una macro che apra un modello di e-mail della categoria caso e imposti più destinatari nel campo A dell'e-mail:

1. Aggiungi l'azione Apri un modulo e-mail con un modello predefinito che aggiunge il modello in base all'ID del modello e compila il modulo e-mail con i campi A e Tema. Gli attributi sono i seguenti:
   • ID modello: specificare l'ID del modello di e-mail richiesto.
   • ID record entità: ${customerRecordId}
   • Destinatari e-mail: ${customerName}
   • Nome logico entità: ${customerEntityName}
2. Aggiungi l'azione campi del modulo di compilazione automatica per compilare i campi A e Tema. Il campo A deve essere compilato con l'ID e-mail del cliente e un campo personalizzato, Contatto secondario. Gli attributi sono i seguenti:
   • Nome logico entità: phonecall
   • Nome attributo: oggetto
   • Valore attributo: completamento dell'attività relative al caso ${anchor.ticketnumber}
   • Nome attributo: su
   • Valore attributo: [{"id":"${anchor._customerid_value}","type":"${anchor._customerid_value@Microsoft.Dynamics.CRM.lookuplogicalname}","name":"${anchor._customerid_value@OData.Community.Display.V1.FormattedValue}", {"id":"${anchor._cr27b_secondarycontact_value}","type":"contact","name":"${anchor._cr27b_secondarycontact_value@OData.Community.Display.V1.FormattedValue}"}]
   • Nome attributo: regardingobjectid
   • Valore attributo: [{"id":"${anchor.incidentid}"},"name":"${anchor.title}","entitytype":"incident"}]

Cerca nella Knowledge Base la frase popolata

La macro cerca la frase popolata negli articoli della Knowledge Base. L'azione contiene il campo seguente.

Campo	Descrzione
Cerca stringa	Immetti la frase che intendi cercare negli articoli della Knowledge Base. Puoi immettere dati del contesto. Ad esempio, il parametro di dati del contesto può essere il titolo di un caso.
Etichetta scheda	Specifica l'etichetta della scheda.

Esempio: ricerca di un articolo in base a una stringa

Esegui i passaggi seguenti per creare una macro che esegua una ricerca basata su una frase:

1. Aggiungi l'azione Cerca nella Knowledge Base la frase popolata che seleziona il titolo del caso come frase di ricerca. Gli attributi sono i seguenti:
   • Etichetta scheda: Cerca ${anchor.title}
   • Stringa di ricerca: ${anchor.title}

Apri articolo della Knowledge Base

Apre un articolo della Knowledge Base. L'azione contiene il campo seguente.

Campo	Descrzione
ID record dell'entità	Specifica l'ID entità dell'articolo della Knowledge Base che desideri aprire. Questo campo è obbligatorio.

Esempio: apri un articolo della Knowledge Base passando un GUID

Esegui la procedura seguente per creare una macro che apra un articolo della Knowledge Base in base all'ID dell'articolo della Knowledge Base. | Aggiungi l'azione Apri articolo della Knowledge Base per aprire l'articolo della Knowledge Base e viene utilizzata dagli autori della Knowledge Base per la revisione dell'articolo. Gli attributi sono i seguenti:
ID del record dell'entità: specifica l'ID entità dell'articolo della Knowledge Base.|

Apri una griglia di record

Questa azione è utilizzata per aprire una griglia di record. L'azione contiene i campi seguenti.

Campo	Descrzione
Nome logico entità	Specifica il nome logico dell'entità per la quale si desidera aprire o creare la griglia. Questo campo è obbligatorio.
ID vista	Specifica l'ID della vista che si desidera aprire. Questo campo è obbligatorio.
Tipo di visualizzazione	Specifica il tipo di visualizzazione. Questo campo è obbligatorio.

Esempio 1: apri un elenco di prodotti

Per creare una macro che apra un elenco di prodotti, aggiungi l'azione Apri una griglia di record per aprire la vista predefinita dell'utente, poiché il tipo di vista e l'ID non sono specificati. Specifica i seguenti attributi: Nome logico entità: incident.

Esempio 2: apri un elenco di incidenti

Per creare una macro che apra un elenco di incidenti, aggiungi l'azione Apri una griglia di record per aprire il tipo di vista specificato. Gli attributi sono i seguenti:

• Nome logico entità: incident
• Visualizza tipo: specificare il tipo di visualizzazione.
• ID vista: specifica l'ID della vista in cui desideri che vengano aperti gli incidenti

Esegui una ricerca per pertinenza basata sulla frase

Cerca la frase popolata negli articoli della Knowledge Base. L'azione contiene il campo seguente.

Campo	Descrzione
Cerca stringa	Immetti la frase in base alla quale intendi eseguire una ricerca per pertinenza. Puoi immettere dati del contesto. Ad esempio, il parametro di dati del contesto può essere il titolo di un caso. Questo campo è obbligatorio.

Esempio 1: ricerca di casi con lo stesso titolo

Per creare una macro che utilizzi il titolo di un caso per cercare casi simili, aggiungi l'azione Esegui una ricerca per pertinenza basata sulla frase per utilizzare il titolo del caso dalla scheda di ancoraggio come parametro per la ricerca per pertinenza con Stringa di ricerca impostata su ${anchor.title}

Clona record corrente

Clona un record esistente aperto nella scheda corrente. L'azione copia solamente i campi e non salva il record. L'azione contiene il campo seguente.

Campo	Descrzione
Titolo record	Specifica il titolo del record che desideri clonare. Questo campo è obbligatorio.

Esempio: crea un caso figlio utilizzando la clonazione del record corrente

Esegui i passaggi seguenti per creare una macro che crei un clone del caso esistente e lo renda il caso principale. Il caso originale è impostato come caso figlio:

1. Aggiungi l'azione Clona record corrente che clona il caso originale e quindi imposta il caso clonato come padre. Il caso originale è impostato come caso figlio. Imposta l'attributo Titolo record su caso figlio di ${anchor.ticketnumber}.
2. Aggiungi i campi del modulo di compilazione automatica che popolano il caso figlio con gli attributi specificati. Il numero di ticket viene impostato quando il record viene salvato. Gli attributi sono i seguenti:
   • Nome logico entità: incident
   • Nome attributo: parentcaseid
   • Valore attributo: [{"id": "${anchor.incidentid}","name":"${anchor.title}","entitytype":"incident"}]
   • Nome attributo: ticketnumber
   • Valore attributo:
3. Aggiungi l'azione Salva il record per generare e impostare il numero di ticket per il caso figlio.

|

Clona record di input

Clona un record esistente. L'azione copia solo i campi e non salva il record. L'azione contiene i campi seguenti.

Campo	Descrzione
Titolo record	Specifica il titolo del record.
ID record dell'entità	Specifica l'ID del record dell'entità. Questo campo è obbligatorio.
Nome logico entità	Specifica il nome logico dell'entità che desideri clonare. Questo campo è obbligatorio.

Esempio: crea un caso figlio utilizzando la clonazione del record di input

Esegui i passaggi seguenti per creare una macro per clonare un caso esistente. Il caso esistente viene impostato come caso principale e il caso clonato viene impostato come caso figlio.

1. Aggiungi l'azione Clona record corrente che clona il caso originale e quindi imposta il caso clonato come figlio. Il caso originale è impostato come caso padre. Gli attributi sono i seguenti:
   • ID record dell'entità: ${anchor.incidentid}
   • Nome logico entità: incident
   • Titolo record: caso figlio di ${anchor.title}
2. Aggiungi i campi del modulo di compilazione automatica che popolano il caso figlio con gli attributi specificati. Il numero di ticket viene impostato quando il record viene salvato. Gli attributi sono i seguenti:
   • Nome logico entità: Entity logical name
   • Nome attributo: parentcaseid
   • Valore attributo: [{"id": "${anchor.incidentid}","name":"${anchor.title}","entitytype":"incident"}]
   • Nome attributo: ticketnumber
   • Valore attributo:
3. Aggiungi l'azione Salva il record per generare e impostare il numero di ticket per il caso figlio.

Imposta stato attivo script agente

Imposta lo stato attivo su uno script agente da eseguire successivamente. Lo script agente è messo in evidenza nel menu a discesa Script agente nel riquadro laterale dell'app. Ad esempio, se l'agente deve elaborare una richiesta di rimborso. L'agente utilizza diversi script per accogliere, avviare una richiesta di reclamo ed elaborare il rimborso. È possibile definire macro che pongano l'accento sugli script agente che devono essere eseguiti per ogni fase del processo di rimborso. L'azione contiene il campo seguente.

Campo	Descrzione
Nome univoco script agente	Specifica lo script agente che deve essere attivo.

Esempio: aggiorna la priorità di un caso e imposta lo stato attivo su un altro script agente

Esegui i passaggi seguenti per creare una macro che aggiorni la priorità di un caso su alta e quindi passi a un altro script agente. Lo script agente nello stato attivo viene associato al modello di sessione.

1. Aggiungi l'azione Aggiorna record esistente con i seguenti attributi:
   • ID record dell'entità: ${anchor.incidentid}
   • Nome logico entità: incident
   • Nome attributo: codice di priorità
   • Valore attributo: 1
2. Aggiungi l'azione Imposta stato attivo per lo script agente con Nome univoco script agente impostato su new_agentscript_highpriority.
3. Aggiungi il connettore di sessione Recupera la scheda corrente.
4. Aggiungi il connettore di sessione della scheda Aggiorna.

Salva il record

Salva il record dopo aver inserito i dati in tutti i campi obbligatori. L'azione non riesce se i campi obbligatori non vengono inseriti o vengono lasciati vuoti.

Passaggi successivi

Usare il connettore della sessione per creare macro