Contrôles riches d’entrée et de sortie par défaut pour une intégration de messagerie instantanée personnalisée

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 3 minutes de lecture

    • Les contrôles enrichis d’entrée et de sortie doivent être mappés à votre intégration de messagerie instantanée personnalisée dans la table Configurations d’adaptateur personnalisées [sys_cs_custom_adapter_config]. Si une implémentation de transformateur sortant est manquante dans un contrôle enrichi, aucune réponse n’est fournie à l’utilisateur final et celui-ci peut obtenir une expérience de messagerie instantanée insatisfaisante.

    Les contrôles enrichis par défaut suivants sont mappés aux contrôles enrichis d’entrée et de sortie. Le uiType paramètre fait référence à un contrôle de rubrique utilisé pour créer des conversations dans Concepteur d'agent virtuel.

    Tableau 1. Contrôles enrichis d’entrée et de sortie par défaut
    Contrôle enrichi Description
    ActionRichControl (en anglais seulement) Ce composant gère les différents événements et actions qui se produisent dans une conversation. Certaines actions peuvent ne pas s’appliquer à tous les canaux. Par exemple, StartSpinnerActionMsg est ignoré dans SMS.

    ServiceNow® Agent virtuel génère les types de messages d’action suivants par le biais de ce cadre de travail. L’interface de messagerie instantanée personnalisée ne reconnaît que certains types de messages d’action.

    • SeparatorActionMsg ||actionMsg instanceof
    • SystemActionMsg ||actionMsg instanceof
    • TopicFinishedActionMsg ||actionMsg instanceof
    • SwitchToVirtualAgentActionMsg ||actionMsg instanceof
    • SwitchConversationActionMsg ||actionMsg instanceof
    • ChatSubHeaderActionMsg ||actionMsg instanceof
    • StartSpinnerActionMsg ||actionMsg, instance de EndSpinnerActionMsg
    • S’abonner à la file d’attente de soutien ||actionMsg instanceof
    • SubscribeToChatPresence ||actionMsg instanceof
    • SwitchToLiveAgentActionMsg ||actionMsg instanceof

    ActionRichControl enveloppe ces messages à l’intérieur de l’élément actionMsg . Ainsi, un seul transformateur sortant pour ActionRichControl peut gérer tous ces messages. Il n’y a pas besoin d’un transformateur entrant pour ce composant.
    agentInfo paramètre Si le contrôle enrichi est envoyé à partir d’un agent actif, l’attribut agentInfo est ajouté au contrôle enrichi.
    Exemple :
    {
     uiType: "someType",
     group: "someGroup"
     agentInfo: { sentFromAgent: true }  // please note that this object may contain more info in subsequent releases.
     ...
}
    Sélecteur par défaut Mappe aux contrôles Sélecteur de fichier, Sélecteur de rubrique et Booléen .
    Exemple :
    {
    uiType: "Picker/TopicPicker/Boolean",
    group: "DefaultPicker",  
    nluTextEnabled: true/false,
    promptMsg: "", // optional (needed for TopicPicker)
    label: "The question for the list",   // always filled
    itemType: "Picture/List"  // needed to user key to expect picture attached
    options: [
        {
            label: "display label prompt",
            value: "the value required to satisfy the question",
            description: "a description of value_1 item"
	    attachment: "www.foo",
            enabled: true/false
        }, 
	...
    ]
}

    Le paramètre facultatif order vous permet de spécifier l’ordre dans lequel les rubriques promues doivent s’afficher. Par exemple :

    "options": [
    {
      label: "Check IT Ticket Status",
      value: "55720b465bf0201024f11fc40a81c72d",
      order: 100,
      enabled: true
    },
    {
      label: "Live Agent Support",
      value: "ce2ee85053130010cf8cddeeff7b12bf",
      order: 200,
      enabled: true
    },
    {
      label: "Open IT Ticket 2",
      value: "2a46cffbc7602010v088bbf603c260a7",
      order: 300,
      enabled: true
    }
]
    Texte par défaut Mappe les contrôles Texte d’entrée, Texte de sortie et Chargement de fichier.
    Exemple :
    {
    uiType: "InputText/OutputText/FileUpload/Picture",
    group: "DefaultText", 
    required: true/false,
    nluTextEnabled: true/false,
    itemType: "file/image/inputtext/outputtext",
    maskType: "SECURE/SENSITIVE/NONE"  // null except for InputText/OutputText
    label: "The Question?"        
}
    Date par défaut Mappé aux contrôles de date et d’heure .
    {
    uiType: "Date/DateTime/Time",
    group: "DefaultDate", 
    required: true/false,
    nluTextEnabled: true/false,   
    label: "The Question?"
     
}
    Lien de sortie par défaut Mappe les contrôles de réponse de liaison .
    Exemple :
    {
    uiType: "OutputLink",
    group: "DefaultOutputLink",
    label: "link label",
    header: "link header",
    type: "link",
    value: {
        action: "www.foo",
    }	
}
     
}
    Image par défaut Mappé aux contrôles de réponse d’image .
    Exemple :
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    Carte de sortie par défaut Mappé aux contrôles de réponse de carte .
    Exemple :
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml (en anglais seulement) Mappé aux contrôles de réponse HTML .
    Exemple :
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    Table de sortie par défaut Mappé aux contrôles de réponse de table .
    Exemple :
    {
    uiType: "OutputTable",
    group: "DefaultOutputTable",
    label: "Table Title",
    headers: ["Column 1", "Column 2"],
    navigationBtnLabel: "See next",
    data: [
        ["foo1", "foo2"],
        ["bar1", "bar2"]
    ]
}
    DefaultGroupedPartsOutputControl Mappé aux contrôles multi-réponses .
    Exemple :
    {
    uiType: "GroupedPartsOutputControl",
    group: "DefaultGroupedPartsOutputControl"
    groupPartType: "Link",
    header: "header message",
    values: [
	{
	    action: "www.foo",
	    description: "description",
	    label: "link_1 label",
	    context: "ITSM"
	},
	...
    ]
}
    Sortie en plusieurs parties par défaut Mappé aux contrôles multi-réponses .
    Exemple :
    {
    uiType: "MultiPartOutput",
    group: "DefaultMultiPartOutput"
    navigationBtnLabel: "Go next",
    content: {
        uiType: "OutputHtml",
        style: "inline",
        type: "html",
        height: 100,
        width: 100,
        value: "<div>html</div>"
     }
}
    DefaultCustomControl (Contrôle par défaut) Mappe aux contrôles personnalisés.
    Exemple :
    {
    uiType: "CustomControl",
    group: "DefaultCustomControl",
    name: "The name of the Custom Control (sys_cs_custom_control.name)",
    required: true/false,
    uxComponentDefinitionSysId: "seismicComponentId" // or null if not
    isInput: true/false, // whether to wait for a response value or if just output
    serializedControlData: "User defined JSON from generateControlData function";    
}