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

You can configure Search, Custom Create, and Standard Create workflows for Oracle and NiCE CXone Agent Workspace for Microsoft Teams (Agent for Microsoft Teams). These workflows search or create Oracle records, also called entities or objects. This is the back end configuration of dynamic data mapping.

Type de flux de travail

Description

Flux de travail

Recherche Les flux de travail de recherche analysent Oracle afin de trouver les enregistrements applicables à l'interactionClosed The full conversation with an agent through a channel. For example, an interaction can be a voice call, email, chat, or social media conversation. que l'Agent traite. 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 enregistrer 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 asset
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 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 workflow CRM, et la liste de terminologie d'intégration CRM.

Téléchargez également 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 : Search for ANI et Custom Search.

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

  • Correspond aux critères de recherche, et

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

Les agents peuvent cliquer sur Actualiser dans la carte 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 Also known as caller ID. Listed phone number of an incoming voice call. de ACD pour rechercher dans tous les champs téléphone standards les enregistrements correspondants.

N'incluez pas la propriété timeoutMilliSec dans votre code 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 Search for 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-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 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 Custom Search vous permet de rechercher Oracle des enregistrements correspondant à des critères de filtre flexibles. Vous pouvez utiliser Custom Search pour :

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

  • Recherchez Multiple Types d'enregistrement Oracle dans la même instance CRM, dans 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 Custom Search. Cependant, la recherche de nombreux champs dans une seule charge utile peut ralentir la recherche. Commencez par un petit ensemble de champs et développez-le selon les besoins.

N'incluez pas la propriété timeoutMilliSec dans votre code 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-cliquez 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 les besoins.

  5. Enregistrez votre script.

  6. Vous pouvez tester 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 afin de créer tout type d'enregistrement Oracle, standard ou personnalisé. Elles permettent également de remplir n'importe quel 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 Create Custom Record 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 remplis 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 : une SNIPPET appelée Snippet for Send Workflow Response, et une CUSTOMEVENT appelée Send Workflow Response. Utilisez ce modèle de script pour Desktop Studio ou ce modèle de script 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-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 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 en 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. Suivez ce format :

    
    item1.field = "value"
    		
  7. Remplacez 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.

  8. Modifiez la valeur de l'attribut workflowInput.pinnedRecord pour qu'elle soit 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 supposé être false.
  9. Remplacez 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 d'API de l'enregistrement que vous créez. Mettez en majuscule le nom pour qu'il corresponde à la casse mixte (camel case) de l'attribut. Par exemple, si le nom d'API de l'enregistrement que vous avez créé est asset, votre code serait :

    
    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 à la deuxième ligne avant la dernière de la charge utile SNIPPET. Mettez-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 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="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 null (""). 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. Lorsqu'il est défini sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelles de la fiche client. Lorsqu'il est défini 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 en 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 effectuer un test de votre script en simulant une interaction dans Studio.

Configurer le Workflow Créer un contact

  1. Dans Studio, ouvrez le script dans lequel vous souhaitez configurer le workflow Create 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 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 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 qu'un 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. Modifiez 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 sur true ou false. Lorsque la valeur est définie sur true, l'enregistrement créé s'affiche pour les agents dans la Section Interactions actuelle 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.
  9. Remplacez 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 Workflow de création d'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 Exécution du flux de travail.

  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 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 par 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 sur 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 l'élément 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 tester votre script en simulant une interaction dans Studio.

Configurer le workflow de création d'opportunité

  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 Exécution du flux de travail.

  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 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 avec 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. Modifiez la valeur de l'attribut createOpportunity.primaryContactId pour la définir sur 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'il est défini sur true, l'enregistrement créé s'affiche pour les agents dans la section Interactions actuelle de la carte client. Lorsqu'il est défini 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 en 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 étant 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 tester 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-clic sur l'action SNIPPET sur le canevas de 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 nulle (""). 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. Lorsqu'elle est définie sur true, l'enregistrement créé s'affiche aux agents dans la section Interactions actuelles 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 createOrganization.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.
  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 tester 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 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="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. Modifiez la valeur de l'attribut createPayload.data.statusWithType.status.lookupName selon l'état 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'achèvement 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. Modifiez 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 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 supposé être false.
  7. Remplacez la valeur de l'attribut createPayload.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 étant false.
  8. Cliquez sur l'action Exécution du flux de travail qui suit le SNIPPET 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 tester votre script en simulant une interaction dans Studio.

Épingler les enregistrements

Vous pouvez épingler un enregistrement à la Section Interaction actuelle de la fiche client. Lorsqu'un enregistrement est épinglé, il est lié icon of a check mark in a green box. à des fins de mémorialisation des données et d'informations de chronologie par défaut. Cela signifie que les informations de mémorialisation des données et 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 Screen Pop

Vous pouvez configurer des enregistrements afin qu'ils apparaissent automatiquement sous forme de pop-up d'écran dans Oracle. Cette opération s'effectue en modifiant la charge utile du workflow.

Dans les Flux de travail de recherche

Par défaut, les enregistrements à correspondance uniqueClosed Occurs when a Search workflow returns only one record. 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 du workflow

Vous pouvez contrôler si les résultats du workflow de recherche et de création 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.

Rechercher des Flux de travail

Par défaut, les résultats de Search workflow sont mis en cache. Vous pouvez modifier ce comportement en définissant l'attribut cacheResponse sur false. Les enregistrements retourné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 Custom Search workflow, 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 de Create workflow sont mis en cache. Vous pouvez modifier ce paramètre 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.