Standardmäßige Rich Controls für Eingabe und Ausgabe für eine benutzerdefinierte Chat-Integration

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Rich-Eingabe- und Ausgabesteuerungen müssen Ihrer benutzerdefinierten Chat-Integration in der Tabelle „Benutzerdefinierte Adapterkonfigurationen“ [sys_cs_custom_adapter_config] zugeordnet werden. Wenn in einer Rich-Steuerung eine ausgehende Transformatorimplementierung fehlt, wird dem Endbenutzer keine Antwort zugestellt, und dieser Benutzer erhält möglicherweise eine unbefriedigende Chat-Experience.

    Die folgenden standardmäßigen Rich Controls werden Rich Controls für Ein- und Ausgaben zugeordnet. Der Parameter uiType verweist auf ein Themensteuerelement, das zum Erstellen von Konversationen in Virtual Agent-Designerverwendet wird.

    Tabelle : 1. Standardmäßige Rich Controls für Eingabe und Ausgabe
    Rich-Steuerung Beschreibung
    ActionRichControl Diese Komponente verarbeitet die verschiedenen Ereignisse und Aktionen, die in einer Konversation auftreten. Einige Aktionen gelten möglicherweise nicht für alle Kanäle. Beispielsweise wird StartSpinnerActionMsg in SMS ignoriert.

    ServiceNow® Virtual Agent erzeugt über dieses Framework die folgenden Arten von Aktionsnachrichten. Die benutzerdefinierte Chat-Schnittstelle erkennt nur bestimmte Aktionsnachrichtentypen.

    • SeparatorActionMsg ||actionMsg instanceof
    • SystemActionMsg || actionMsg instanceof
    • TopicFinishedActionMsg ||actionMsg instanceof
    • SwitchToVirtualAgentActionMsg ||actionMsg instanceof
    • SwitchConversationActionMsg ||actionMsg instanceof
    • ChatSubHeaderActionMsg ||actionMsg instanceof
    • StartSpinnerActionMsg || actionMsg-Instanz von EndSpinnerActionMsg
    • SupportQueue abonnieren || actionMsg-Instanzvon
    • SubscribeToChatPresence || actionMsg instanceof
    • SwitchToLiveAgentActionMsg ||actionMsg instanceof

    ActionRichControl schließt diese Nachrichten innerhalb des Elements actionMsg ein. Ein einzelner ausgehender Umwandler für ActionRichControl kann alle diese Nachrichten verarbeiten. Für diese Komponente ist kein eingehender Umwandler erforderlich.
    agentInfo Parameter Wenn die Rich-Steuerung von einem Servicemitarbeiter gesendet wird, wird der Rich-Steuerung das Attribut agentInfo hinzugefügt.
    Beispiel:
    {
     uiType: "someType",
     group: "someGroup"
     agentInfo: { sentFromAgent: true }  // please note that this object may contain more info in subsequent releases.
     ...
}
    Standardauswahl Ordnet auf Dateiauswahl, Themenauswahl und boolesche Steuerungen zu.
    Beispiel:
    {
    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
        }, 
	...
    ]
}

    Mit dem optionalen Parameter order können Sie die Reihenfolge angeben, in der heraufgestufte Themen angezeigt werden sollen. Beispiel:

    "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
    }
]
    Standardtext Ist den Steuerungen „Eingabetext“, „Ausgabetext“und „ Dateiupload“ zugeordnet.
    Beispiel:
    {
    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?"        
}
    Standarddatum Ordnet auf Datums- und Zeitsteuerungen zu.
    {
    uiType: "Date/DateTime/Time",
    group: "DefaultDate", 
    required: true/false,
    nluTextEnabled: true/false,   
    label: "The Question?"
     
}
    DefaultOutputLink Zuordnungen zum Verknüpfen von Antwortsteuerungen.
    Beispiel:
    {
    uiType: "OutputLink",
    group: "DefaultOutputLink",
    label: "link label",
    header: "link header",
    type: "link",
    value: {
        action: "www.foo",
    }	
}
     
}
    DefaultOutputImage Ordnet auf Bildantwortsteuerungen zu.
    Beispiel:
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    DefaultOutputCard Wird Kartenantwortsteuerungen zugeordnet.
    Beispiel:
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml Ordnet auf HTML-Antwortsteuerelemente zu.
    Beispiel:
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    DefaultOutputTable Ordnet auf Tabellenantwortsteuerungen zu.
    Beispiel:
    {
    uiType: "OutputTable",
    group: "DefaultOutputTable",
    label: "Table Title",
    headers: ["Column 1", "Column 2"],
    navigationBtnLabel: "See next",
    data: [
        ["foo1", "foo2"],
        ["bar1", "bar2"]
    ]
}
    StandardGroupedPartsOutputControl Ordnet auf Mehrfachantwortsteuerungen zu.
    Beispiel:
    {
    uiType: "GroupedPartsOutputControl",
    group: "DefaultGroupedPartsOutputControl"
    groupPartType: "Link",
    header: "header message",
    values: [
	{
	    action: "www.foo",
	    description: "description",
	    label: "link_1 label",
	    context: "ITSM"
	},
	...
    ]
}
    StandardMultiPartOutput Ordnet auf Mehrfachantwortsteuerungen zu.
    Beispiel:
    {
    uiType: "MultiPartOutput",
    group: "DefaultMultiPartOutput"
    navigationBtnLabel: "Go next",
    content: {
        uiType: "OutputHtml",
        style: "inline",
        type: "html",
        height: 100,
        width: 100,
        value: "<div>html</div>"
     }
}
    StandardCustomControl Ordnet auf benutzerdefinierte Steuerungenum.
    Beispiel:
    {
    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";    
}