Configurer les Flux de travail Oracle pour Agent Workspace for Microsoft Teams (Agent for Microsoft Teams)

Il s'agit de la dernière étape de l'intégration de Oracle avec Agent Workspace for Microsoft Teams (Agent for Microsoft Teams). Vous pouvez effectuer cette tâche en utilisant l'action ENHANCED WORKFLOW EXECUTE Studio à la place. Vous pouvez également, si vous le souhaitez, permettre aux agents de créer des enregistrements manuellement.

Vous pouvez configurer les flux de travail Search, Custom Create et Standard Create pour Oracle et NiCE CXone Agent Workspace for Microsoft Teams (Agent for Microsoft Teams). Ces flux de travail recherchent ou créent des enregistrements Oracle, également appelés entités ou objets. Il s’agit de la configuration back-end de mappage des données dynamiques

Type de Workflow

 Description

Flux de travail
Recherche Flux de travail de recherche analysent Oracle à la recherche d'enregistrements applicables à l'interactionClosed La conversation complète avec un agent sur un canal. Par exemple, une interaction peut être un appel vocal, un courriel, un clavardage ou une conversation sur les réseaux sociaux. que l'Agent est en train de traiter. Rechercher par ANI
Recherche personnalisée
Création personnalisée Les flux de travail de création personnalisée permettent de créer le type d’enregistrement voulu depuis les champs standard et personnalisés. Créer un enregistrement personnalisé
Création Standard Les flux de travail de création standard créent des enregistrements Oracle standard avec des champs de données standard. La charge utile SNIPPET de ces flux de travail doit inclure les champs standard et uniquement ceux-là. Créer un actif
Créer un contact
Créer un incident
Créer une opportunité
Créer une organisation
Créer une tâche

Les flux de travail s'exécutent en utilisant les rôles et les autorisations de l'utilisateur du système. Il s'agit du compte utilisateur Oracle que vous avez créé spécifiquement pour la configuration de NiCE CXone. Lorsque des enregistrements sont créés, ils utilisent le nom et le fuseau horaire de l'utilisateur du système.

Avant de commencer, consultez le diagramme d'intégration CRM, le diagramme de flux de travail CRM, et la liste de terminologie d'intégration CRM.

Par ailleurs, téléchargez ce dossier de scripts modèles. Il contient des scripts voix et numériques pour NiCE CXone Studio et Desktop Studio.

Configurer les Flux de travail de recherche

Il existe deux flux de travail de recherche : Recherche par ANI et Recherche personnalisée.

Lorsque vous utilisez des mappages de données dynamiques dans un workflow de recherche, la section Interactions associée de la fiche client icon: a person next to a document. affiche d'abord les enregistrements qui :

  • Correspondent aux critères de recherche, et

  • Comporter des données dans chaque champ mappé.

Les agents peuvent cliquer sur Actualiser dans la fiche client icon: a person next to a document. pour afficher tous les enregistrements correspondant aux critères de recherche.

Configurer le Flux de travail Recherche d’ANI

Le workflow Search for ANI utilise l'ANIClosed Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. provenant du ACD pour rechercher des enregistrements correspondants dans tous les champs téléphoniques standard.

Ne faites pas figurer la propriété timeoutMilliSec dans votre code de workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Rechercher ANI.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC searchInput
searchInput.workflowInput.phoneNumber = "{ANI}"
						
ASSIGN searchJson = "{searchInput.asjson()}"

  5. Enregistrez votre script.

  6. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le workflow de recherche personnalisée

Le workflow Recherche personnalisée vous permet de rechercher dans Oracle des enregistrements correspondant à des critères de filtre flexibles. Vous pouvez utiliser Recherche personnalisée pour :

  • Recherchez un seul type d'enregistrement Oracle, par exemple Actif.

  • Recherchez multiple types d'enregistrement Oracle dans la même instance CRM en une seule charge utile. Par exemple, vous pouvez rechercher à la fois Contact et Incident en même temps.

  • Utilisez plusieurs champs et variables dans le filtre de recherche.

  • Connectez les conditions de recherche avec des opérateurs Oracle, tels que AND et OR.

Vous pouvez rechercher n'importe quelle combinaison d'un maximum de 5 enregistrements Oracle dans une seule charge utile. Il n'existe aucune limite imposée au nombre de champs dans une Recherche personnalisée. Toutefois, la recherche d'un grand nombre de champs dans une seule charge utile peut ralentir la recherche. Commencez par un petit ensemble de champs, puis développez-le selon les besoins.

Ne faites pas figurer la propriété timeoutMilliSec dans votre code de workflow. Cela peut entraîner la livraison de plusieurs fois la même interaction à vos agents.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Custom Search.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez l'un des blocs d'exemple de code ci-dessous et collez-le dans l'onglet vue texte de la fenêtre Éditeur. Mettez ensuite à jour les valeurs selon vos besoins.

  5. Use this option when you want to search only one Oracle record type, such as Asset or Contact.

    
DYNAMIC searchInput
DYNAMIC payload
payload.entity = "asset"
payload.filter = "phone='{ANI}'"
searchInput.workflowInput.search = payload
						
ASSIGN searchJson = "{searchInput.asjson()}"

    In this example, the workflow searches the asset record type for assets where the phone field matches the ANIClosed Aussi connu sous le nom d’id de l’appelant. numéro de téléphone listé d’un appel entrant, ou d’un appel vocal entrant. from the interaction.

    1. Change the value of the payload.entity attribute to the API name for the record you want to use. For example, payload.entity = "asset". This is case-sensitive.

      Record

      API
      Account account
      Answer answer
      Asset asset
      Contact contact
      Incident incident
      Opportunity opportunity
      Organization organization
      Task task

    2. Change the value of the payload.filter attribute to the filter expression for the search. For example, payload.filter = "phone='{ANI}'". A full list of Oracle operators can be found in the Oracle documentation Box with arrow indicating navigation to external site.. This is case-sensitive.

      To add more than one condition to the filter, connect them with an Oracle operator. For example, to search for assets with both a matching phone number and customer number:

      
payload.filter = "phone='{ANI}'AND customer_number_c='{CustomerNumber}'"

  6. Use this option when you want to search more than one Oracle record type in the same CRM instance in a single payload. Each entity in the search has its own entity and filter values.

    When you use multiple entities, workflowInput.search is an array of search objects, instead of a single object.

    
DYNAMIC searchInput
DYNAMIC searchArray

DYNAMIC item1
item1.entity = "asset"
item1.filter = "phone='{ANI}'"

DYNAMIC item2
item2.entity = "contact"
item2.filter = "phone='{ANI}'"

searchArray[1] = item1
searchArray[2] = item2

searchInput.workflowInput.search = searchArray
						
ASSIGN searchJson = "{searchInput.asjson()}"

    In this example, the workflow searches both:

    • asset records where the phone field matches the ANI.

    • contact records where the phone field matches the ANI.

    You can also use different fields and variables for each entity. For example, to search Assets by phone number and Contacts by customer number in one payload:

    
DYNAMIC searchInput
DYNAMIC searchArray

DYNAMIC item1
item1.entity = "asset"
item1.filter = "phone='{ANI}'"

DYNAMIC item2
item2.entity = "contact"
item2.filter = "customer_number_c='{CustomerNumber}'"

searchArray[1] = item1
searchArray[2] = item2

searchInput.workflowInput.search = searchArray
						
ASSIGN searchJson = "{searchInput.asjson()}"

    To add more entities to the same search:

    • Create another dynamic data object with a new name, such as item3.

    • Set item3.entity and item3.filter for that record type.

    • Add it to the array with the next index, such as searchArray[3] = item3.

    You can include up to 5 entities.

    1. Change the values of the item.entity attributes to the API names for the records you want to search. For example, item1.entity = "asset". This is case-sensitive.

      Record

      API
      Account account
      Answer answer
      Asset asset
      Contact contact
      Incident incident
      Opportunity opportunity
      Organization organization
      Task task

    2. Change the values of the item.filter attributes to the filter expressions for the search. For example, item1.filter = "phone= '{ANI}'". A full list of Oracle operators can be found in the Oracle documentation Box with arrow indicating navigation to external site.. This is case-sensitive.

      To add more than one condition to the filter, connect them with a Oracle operator. For example, to search for assets with both a matching phone number and customer number:

      
payload.filter = "phone='{ANI}'AND customer_number_c='{CustomerNumber}'"

  7. Enregistrez votre script.

  8. Vous pouvez test votre script en simulant une interaction dans Studio.

Configurer les Flux de travail de création personnalisée

Les flux de travail Custom Create vous permettent de configurer une charge utile SNIPPET pour créer tout type d'enregistrement Oracle, standard ou personnalisé. Elles vous permettent également de remplir tout type DE champ, Standard ou personnalisé. Par exemple, vous pouvez créer l’enregistrement Ressource avec une partie des champs standard de ce type d’enregistrement, ainsi que vos propres champs personnalisés.

Il s’agit de la méthode recommandée pour créer des enregistrements Oracle

Configuration du Flux de travail Créer un enregistrement personnalisé (anciennement Créer une entité)

Le workflow Créer un enregistrement personnalisé crée tout type d'enregistrement Oracle, standard ou personnalisé. Cet enregistrement permet d’afficher des champs de données standard et personnalisés. Les champs doivent contenir du texte, des nombres ou des variables. Les champs liés sont le plus souvent peuplés par des résultats de recherche ou des listes d'options, mais vous pouvez configurer ce Workflow pour ajouter des données codées en dur à un champ lié.

Si vous utilisez l'ancienne version de ce workflow, appelée workflow Créer une entité, vous devez configurer votre script Studio avec deux actions supplémentaires : un SNIPPET appelé Snippet for Send Workflow Response, et un CUSTOMEVENT appelé Send Workflow Response. Utilisez ce script modèle pour Desktop Studio ou ce script modèle pour Studio.

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Custom Record.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après ONANSWER ou ONASSIGNMENT.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC workflowPayload
DYNAMIC workflowInput
DYNAMIC data
						
DYNAMIC item1
item1.subject = "[Subject]"
item1.primaryContact.id = 'PRIMARYCONTACTID' //Do not change this

data[1] = item1
						
workflowInput.data = data
workflowInput.table = "[entity API]" //The API name of the record type found in Oracle
workflowInput.pinnedRecord = "[true or false]"
workflowInput.screenPop = "[true or false]"

workflowPayload.workflowInput = workflowInput
						
ASSIGN create[RecordName]WorkflowPayload = "{workflowPayload.asjson()}"
ASSIGN create[RecordName]Payload = create[RecordName]WorkflowPayload.replace("{char(34)}PRIMARYCONTACTID{char(34)}",3421)

  5. Modifiez la valeur de l'attribut item1.subject pour indiquer l'objet que vous souhaitez assigner à cet enregistrement. Par exemple, item1.subject = "Record for {ANI}".

  6. Pour ajouter des champs supplémentaires, ajoutez des lignes sous item1.primaryContact.id. Suivre ce format :

    
item1.field = "value"

  7. Modifiez la valeur de l'attribut workflowInput.table par le nom API de l'enregistrement que vous souhaitez utiliser. Par exemple, workflowInput.table = "asset". Ces noms sont sensibles à la casse.

    Record

    API
    Compte account
    Répondre answer
    Actif asset
    Contact contact
    Incident incident
    Opportunité opportunity
    Organisation organization
    Tâche task
  8. Changez la valeur de l'attribut workflowInput.pinnedRecord en true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelle de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  9. Modifiez la valeur de l'attribut workflowInput.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  10. Remplacez toutes les occurrences de [RecordName] dans les trois dernières lignes du code par le nom API de l'enregistrement que vous créez. Mettez une majuscule au nom pour qu'il corresponde à la casse mixte (camel case) de l'attribut. Par exemple, si le nom API de l'enregistrement que vous avez créé est asset, votre code serait le suivant :

    
workflowPayload.workflowInput = workflowInput
						
ASSIGN createAssetWorkflowPayload = "{workflowPayload.asjson()}"
ASSIGN createAssetPayload = createAssetWorkflowPayload.replace("{char(34)}PRIMARYCONTACTID{char(34)}",3421)

  11. Cliquez sur l'action Workflow Execute qui suit l'SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette Action sur la Variable create[RecordName]WorkflowPayload dans l'avant-dernière ligne de la charge utile de SNIPPET. Placez-le entre accolades ( { } ). Par exemple, {createAssetWorkflowPayload}.

  12. Enregistrez votre script.

  13. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer les Flux de travail de création Standard

Les flux de travail de création Standard créent des enregistrements Oracle standard avec les champs spécifiés dans la charge utile du flux de travail.

Vous ne pouvez pas ajouter ou supprimer de champs dans la charge utile SNIPPET des flux de travail de création standard. Si vous ajoutez ou supprimez des champs, l’enregistrement ne sera pas créé. Pour créer un enregistrement standard ou personnalisé avec les champs souhaités, utilisez le workflow Créer un enregistrement personnalisé.

Configurer le Workflow de création d'actif

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Créer un Actif.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createPayload
createPayload.table="assets"
createPayload.data.name ="[asset name]"
createPayload.data.serialNumber ="[serial number]"
createPayload.data.contact.id = "[contact ID number]"
DYNAMIC product1
product1.lookupName = "[product name]"
DYNAMIC productArr
productArr[1] = product1
createPayload.data.product = productArr
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"

DYNAMIC createAssetsPayload
createAssetsPayload.workflowInput=createPayload
ASSIGN createAssetJson="{createAssetsPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.data.contact.id = "".

  5. Modifiez les valeurs des attributs. N'importe laquelle de ces valeurs peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    1. Remplacez la valeur de l'attribut createPayload.data.name par le nom de l'actif. Par exemple, createPayload.data.name = "Asset 2".

    2. Remplacez la valeur de l'attribut createPayload.data.serialNumber par le numéro de série du produit. Par exemple, createPayload.data.serialNumber = "SN0002301-2".

    3. Remplacez la valeur de l'attribut createPayload.data.contact.id par le numéro d'id du contact. Par exemple, createPayload.data.contact.id = "1234567890".

    4. Remplacez la valeur de l'attribut product1.lookupName par le nom du produit. Par exemple, product1.lookupName = "Smart Thermostat Z".

  6. Modifiez la valeur de l'attribut createPayload.pinnedRecord sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelles de la fiche client. Lorsque la valeur est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Modifiez la valeur de l'attribut createPayload.screenPop sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Workflow Execute qui suit l'SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createAssetJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le workflow Create Contact

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Créer un contact.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createContact
createContact.phoneNumber = "{ANI}"
createContact.firstName = "[first name]"
createContact.lastName = "[last name]"
createContact.email = "[email address]"
						
createContact.pinnedRecord = "[true or false]"
createContact.screenPop = "[true or false]"

DYNAMIC createContactPayload
createContactPayload.workflowInput = createContact
						
ASSIGN createContactJson = "{createContactPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez que le champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createContact.email = "".

  5. Remplacez la valeur de l'attribut createContact.firstName par le prénom du contact. Par exemple, createContact.firstName = "Elinor". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  6. Remplacez la valeur de l'attribut createContact.lastName par le nom du contact. Par exemple, createContact.lastName = "Dashwood". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  7. Remplacez la valeur de l'attribut createContact.email par l'adresse courriel du contact. Par exemple, createContact.email = "elinor.dashwood@classics.com". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  8. Modifiez la valeur de l'attribut createContact.pinnedRecord en true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la Section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  9. Modifiez la valeur de l'attribut createContact.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  10. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createContactJson}. Veillez à inclure les accolades.

  11. Enregistrez votre script.

  12. Vous pouvez tester votre script en simulant une interaction dans Studio.

Configurer le Flux de travail Create Incident

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Incident.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-clic sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createIncident
createIncident.subject = "[Incident Name]"
createIncident.primaryContactId = {CONTACTID}
						
createIncident.pinnedRecord = "[true or false]"
createIncident.screenPop = "[true or false]"

DYNAMIC createIncidentPayload
createIncidentPayload.workflowInput = createIncident
						
ASSIGN createIncidentJson = "{createIncidentPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createIncident.primaryContactID = "".

  5. Modifiez la valeur de l'attribut createIncident.subject avec le nom de l'incident. Par exemple, createIncident.subject = "Elinor's Incident". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  6. Remplacez la valeur de l'attribut createIncident.primaryContactId par l'id du contact de l'enregistrement Oracle. Il doit s'agir d'une valeur numérique non placée entre guillemets.

  7. Modifiez la valeur de l'attribut createIncident.pinnedRecord en true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la Section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  8. Remplacez la valeur de l'attribut createIncident.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  9. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createIncidentJson}. Veillez à inclure les accolades.

  10. Enregistrez votre script.

  11. Vous pouvez test votre script en simulant une interaction dans Studio.

Configurer le workflow Create Opportunity

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Créer une Opportunité.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createOpportunity
createOpportunity.subject = "[Opportunity Name]"
createOpportunity.primaryContactId = {CONTACTID}
						
createOpportunity.pinnedRecord = "[true or false]"
createOpportunity.screenPop = "[true or false]"

DYNAMIC createOpportunityPayload
createOpportunityPayload.workflowInput = createOpportunity
						
ASSIGN createOpportunityJson = "{createOpportunityPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createOpportunity.primaryContactID = "".

  5. Modifiez la valeur de l'attribut createOpportunity.subject par le nom de l'opportunité. Par exemple, createOpportunity.subject = "Elinor's Opportunity". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  6. Remplacez la valeur de l'attribut createOpportunity.primaryContactId par l'id du contact de l'enregistrement Oracle. Il doit s'agir d'une valeur numérique non placée entre guillemets.

  7. Remplacez la valeur de l'attribut createOpportunity.pinnedRecord par true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la carte client. Lorsqu'elle est définie sur false, il s'affiche dans la Section Interactions récentes de la carte client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  8. Modifiez la valeur de l'attribut createOpportunity.screenPop par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  9. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createOpportunityJson}. Veillez à inclure les accolades.

  10. Enregistrez votre script.

  11. Vous pouvez test votre script en simulant une interaction dans Studio.

Configurer le workflow de création d'organisation

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create Organization.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET sur le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createOrganization
createOrganization.name = "[Organization Name]"
						
createOrganization.pinnedRecord = "[true or false]"
createOrganization.screenPop = "[true or false]"

DYNAMIC createOrganizationPayload
createOrganizationPayload.workflowInput = createOrganization
						
ASSIGN createOrganizationJson = "{createOrganizationPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur null (""). Par exemple, createContact.email = "".

  5. Modifiez la valeur de l'attribut createOrganization.name avec le nom de l'organisation. Par exemple, createOrganization.name = "Elinor's Organization". Cette valeur peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que cette valeur soit mise à jour pour chaque interaction.

  6. Remplacez la valeur de l'attribut createOrganization.pinnedRecord par true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelles de la fiche client. Lorsque la valeur est définie sur false, il s'affiche dans la section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Modifiez la valeur de l'attribut createOrganization.screenPop sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Workflow Execute qui suit le SNIPPET de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createOrganizationJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez test votre script en simulant une interaction dans Studio.

Configurer le Workflow Create Task

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow créer une tâche.

  2. Si vous ne l'avez pas déjà fait, ajoutez une action SNIPPET après BEGIN et avant l'action Workflow Execute.

  3. Double-cliquez sur l'action SNIPPET dans le canevas du script.

  4. Copiez chacune des lignes de code suivantes et collez-les dans l’onglet vue texte de la fenêtre Éditeur.

    
DYNAMIC createPayload
createPayload.table="tasks"
createPayload.data.name ="[task name]"
createPayload.data.notes.text ="[notes for task]"
createPayload.data.statusWithType.status.lookupName = "[Not Started, In Progress, Completed, Waiting, or Deferred]"
createPayload.data.percentComplete = [#]
createPayload.data.priority.id = [1, 2, or 3]
createPayload.data.organization.id = [#]
						
createPayload.pinnedRecord = "[true or false]"
createPayload.screenPop = "[true or false]"

DYNAMIC createTasksPayload
createTasksPayload.workflowInput=createPayload
ASSIGN createTaskJson="{createTasksPayload.asjson()}"

    Vous devez inclure chacune de ces lignes. Si vous souhaitez qu'un champ reste vide, vous pouvez utiliser une valeur nulle (""). Par exemple, createPayload.data.notes.text = "".

  5. Modifiez les valeurs des attributs. N'importe laquelle de ces valeurs peut être codée en dur, être une variable ou une combinaison de ces éléments. Utilisez une variable si vous voulez que la valeur soit mise à jour pour chaque interaction.

    1. Modifiez la valeur de l'attribut createPayload.data.name par le nom de la tâche. Par exemple, createPayload.data.name = "Task 2".

    2. Modifiez la valeur de l'attribut createPayload.data.notes.text par des notes concernant la tâche. Par exemple, createPayload.data.notes.text = "This is a test task".

    3. Remplacez la valeur de l'attribut createPayload.data.statusWithType.status.lookupName par le statut de la tâche : Not Started, In Progress, Completed, Waiting ou Deferred. Par exemple, createPayload.data.statusWithType.status.lookupName = "In Progress".

    4. Remplacez la valeur de l'attribut createPayload.data.percentComplete par le pourcentage d'avancement de la tâche, sans le signe pour cent (%). Par exemple, createPayload.data.percentComplete = 80 indique que la tâche est terminée à 80 %.

    5. Remplacez la valeur de l'attribut createPayload.data.priority.id par la priorité de la tâche :

      • 1 : basse

      • 2 : normale

      • 3 : haute

      Par exemple, createPayload.data.priority.id = 1 indique que la tâche a une priorité basse.

    6. Remplacez la valeur de l'attribut createPayload.data.organization.id par le numéro d'identification de l'organisation à laquelle la tâche appartient. Par exemple, createPayload.data.organization.id = 18.

  6. Modifiez la valeur de l'attribut createPayload.pinnedRecord en true ou false. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle de la fiche client. Lorsqu'elle est définie sur false, il s'affiche dans la Section Interactions récentes de la fiche client. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.
  7. Modifiez la valeur de l'attribut createPayload.screenPop sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s’affiche automatiquement à l'agent sous la forme d'une fenêtre contextuelle dans Oracle. Lorsque la valeur est définie sur false, il ne s’affiche pas. Si vous n'incluez pas cet attribut dans la charge utile, il sera considéré comme false.

  8. Cliquez sur l'action Exécution du flux de travail qui suit l'Extrait de ce Flux de travail. Définissez la propriété workflowPayload de cette action sur {createTaskJson}. Veillez à inclure les accolades.

  9. Enregistrez votre script.

  10. Vous pouvez test votre script en simulant une interaction dans Studio.

Épingler les enregistrements

Vous pouvez épingler un enregistrement dans la section Current interaction de la fiche client. Lorsqu'un enregistrement est épinglé, il est lié icon of a check mark in a green box. par défaut, à des fins de mémorialisation des données et d'informations de chronologie. Cela signifie que la mémorialisation des données et les informations de chronologie seront ajoutées à l'enregistrement Oracle une fois l'interaction terminée. Si l'Agent ne souhaite pas que les informations soient mappées, il peut dissocier l'enregistrement.

  1. Ouvrez l'action SNIPPET Snippet for Create Workflow dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[RecordType]Payload :

    						
createPayload.pinnedRecord = "true"

  3. Make sure that createPayload matches the earlier lines in your workflow.

  4. Enregistrez votre script.

Configurer les enregistrements pour l'affichage automatique d'écran

Vous pouvez configurer des enregistrements pour qu'ils s'affichent automatiquement sous forme de screen pops dans Oracle. Cette opération s'effectue en modifiant la charge utile du workflow. Si vous utilisez Microsoft Dynamics CIF v2.0, uniquement un enregistrement peut apparaître comme fenêtre contextuelle. Si vous disposez de plusieurs enregistrements, seul le premier s’affiche. Les agents doivent cliquer sur les autres enregistrements dans la fiche client pour les ouvrir.

Rechercher dans les Flux de travail

Par défaut, les enregistrements à correspondance uniqueClosed Se produit lorsqu’un flux de travail de recherche renvoie un seul enregistrement. apparaissent sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur false.

Les enregistrements de correspondance Multiple n'apparaissent pas sous forme de fenêtres contextuelles, même si vous définissez l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du Workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
searchPayload.screenPop = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le Custom Search workflow, cette ligne doit être payload.screenPop. Dans le Search for ANI workflow, elle doit être searchInput.workflowInput.screenPop.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les enregistrements créés n'apparaissent pas sous forme de fenêtres contextuelles. Vous pouvez modifier ce comportement en définissant l'attribut screenPop sur true.

  1. Ouvrez l'action SNIPPET du workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[RecordName]Payload :

    						
createPayload.screenPop = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le workflow standard Créer un contact, cette ligne doit être createContact.screenPop.

    2. Modifier la valeur de l'attribut screenPop :

      • Définissez-le sur true pour afficher l'enregistrement sous forme de fenêtre contextuelle.

      • Définissez-le sur false pour ne pas l'afficher.

  4. Enregistrez votre script.

Configurer la mise en cache de Workflow

Vous pouvez contrôler si les résultats du workflow Search et Create sont mis en cache. Pour ce faire, modifiez la charge utile du workflow. Lorsque les résultats sont mis en cache, ils apparaissent dans la fiche client dans l'application Agent.

Dans Rechercher des Flux de travail

Par défaut, les résultats du workflow de recherche sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements renvoyés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du workflow dans votre script Studio.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant ASSIGN searchJson = "{searchInput.asjson()}" :

    						
searchPayload.cacheResponse = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que searchPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le workflow Custom Search, cette ligne doit être payload.cacheResponse.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

      • Définissez-le sur false pour ne pas les mettre en cache.

  4. Enregistrez votre script.

Dans Créer des Flux de travail

Par défaut, les résultats du Workflow Create sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements créés n'apparaîtront pas dans l'application Agent.

  1. Ouvrez l'action SNIPPET du Workflow dans votre script.

  2. Dans la charge utile du flux de travail, copiez cette ligne de code et collez-la avant DYNAMIC create[RecordName]Payload :

    						
createPayload.cacheResponse = "[true or false]"

  3. Configurez le code collé.

    1. Assurez-vous que createPayload correspond aux lignes précédentes de votre workflow. Par exemple, dans le workflow standard Créer un contact, cette ligne doit être createContact.cacheResponse.

    2. Modifier la valeur de l'attribut cacheResponse :

      • Définissez-le sur true pour mettre en cache les résultats du workflow.

      • Définissez-le sur false pour ne pas les mettre en cache.

  4. Enregistrez votre script.