Standardmäßige Rich Controls für Ein- und Ausgabe für eine anwenderdefinierte Chatintegration

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer

    • Rich Controls für Ein- und Ausgabe müssen Ihrer anwenderdefinierten Chatintegration in der Tabelle „Anwenderdefinierte Adapterkonfigurationen“ [sys_cs_custom_adapter_config] zugeordnet sein. Wenn bei einem Rich Control eine Implementierung eines ausgehenden Umwandlers fehlt, wird dem Endanwender keine Antwort zugestellt, und dieser Benutzer kann über die Chat-Experience verfügen.

    Die folgenden standardmäßigen Rich Controls sind Eingabe- und Ausgabe-Rich Controls zugeordnet. Der Parameter uiType bezieht sich auf ein Themensteuerelement, das zum Erstellen von Konversationen in Virtual Agent-Designerverwendet wird.

    Tabelle : 1. Standardmäßige Rich Controls für Eingabe und Ausgabe
    Umfangreiche 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 erstellt über dieses Framework die folgenden Arten von Aktionsnachrichten. Die anwenderdefinierte Chatoberfläche 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
    • Supportwarteschlange abonnieren || actionMsg-Instanzvon
    • SubscribeToChatPresence || actionMsg instanceof
    • SwitchToLiveAgentActionMsg || actionMsg instanceof

    ActionRichControl umschließt diese Nachrichten in das Element actionMsg. Daher kann ein einzelner ausgehender Umwandler für ActionRichControl alle diese Nachrichten verarbeiten. Für diese Komponente ist kein eingehender Umwandler erforderlich.
    agentInfo Parameter Wenn die Rich Control von einem Servicemitarbeiter gesendet wird, wird ihr 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 Zuordnungen zu Dateiauswahl, Themenauswahl und booleschen Steuerungen.
    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 vorgeschlagene Themen angezeigt werden sollen. Zum 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 Entspricht den Steuerungen „Eingabetext“, „Ausgabetext“und „Dateiupload“.
    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?"        
}
    DefaultDate Zuordnung zu Datums- und Zeitsteuerungen.
    {
    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 Wird Bildantwortsteuerelementen zugeordnet.
    Beispiel:
    {
    uiType: "OutputImage",
    group: "DefaultOutputImage",
    value: "www.foo"
}
    DefaultOutputCard Wird Kartenantwortsteuerelementen zugeordnet.
    Beispiel:
    {
    uiType: "OutputCard",
    group: "DefaultOutputCard",
    templateName: "Card",
    data: "some json data string"
}
    DefaultOutputHtml Zuordnung zu HTML- Antwortsteuerelementen.
    Beispiel:
    {
    uiType: "OutputHtml",
    group: "DefaultOutputHtml",
    style: "inline",
    height: 100,
    width: 100,
    value: "<div>html</div>"
}
    DefaultOutputTable Zuordnung zu Steuerelementen für Tabellenantworten
    Beispiel:
    {
    uiType: "OutputTable",
    group: "DefaultOutputTable",
    label: "Table Title",
    headers: ["Column 1", "Column 2"],
    navigationBtnLabel: "See next",
    data: [
        ["foo1", "foo2"],
        ["bar1", "bar2"]
    ]
}
    DefaultGroupedPartsOutputControl Zuordnung zu Steuerelementen mit Mehrfachantwort.
    Beispiel:
    {
    uiType: "GroupedPartsOutputControl",
    group: "DefaultGroupedPartsOutputControl"
    groupPartType: "Link",
    header: "header message",
    values: [
	{
	    action: "www.foo",
	    description: "description",
	    label: "link_1 label",
	    context: "ITSM"
	},
	...
    ]
}
    StandardMultipartAusgabe Zuordnung zu Steuerelementen mit Mehrfachantwort.
    Beispiel:
    {
    uiType: "MultiPartOutput",
    group: "DefaultMultiPartOutput"
    navigationBtnLabel: "Go next",
    content: {
        uiType: "OutputHtml",
        style: "inline",
        type: "html",
        height: 100,
        width: 100,
        value: "<div>html</div>"
     }
}
    DefaultCustomControl Zuordnungen zu anwenderdefinierten Steuerungen.
    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";    
}