Integrieren Sie anwenderdefinierte Steuerungen

Implementieren und nutzen Sie anwenderdefinierte Steuerungen, die mit dem anwenderdefinierten Steuerungs-Framework in Ihrer Integration erstellt wurden.

Vorbereitungen

Erforderliche Rolle: virtual_agent_admin oder admin

Warum und wann dieser Vorgang ausgeführt wird

Ordnen Sie einem Anbieterkanal anwenderdefinierte Steuerungen zu.

Implementieren Sie in erstellte anwenderdefinierte Steuerungen Workflow-Studio

Verwenden Sie das Beispielskript, um anwenderdefinierte Steuerelemente zu implementieren, die in Workflow-Studioerstellt wurden.

Beispiel: Unterstützung für anwenderdefinierte Steuerungen

{
    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";    
}

Beispiel: Skript für anwenderdefinierte Steuerungen

(function execute(inputs, outputs) {
    var rich_controls = inputs.rich_control;
    //this is the data returned from the 'serialized control data function' defind in designer
    var serializedControlData = rich_control['serializedControlData'];
    // if this rich control will require a response to move forward in topic flow
    var isInput = rich_control['isInput'];
    // if the component is suggesting using a Seismic control (web) that handles this
    var uxComponentDefinitionId = rich_control['uxComponentDefinitionSysId'];
    // the name of the custom control
    var name - rich_control['name'];

    // 1) now perform some logic to transform this data into a custom ui (slack/facebook/sms ascii art/html/etc)
    // 2) attach to outputs, i.e. outputs.text_message='foo :)'; for sms twillio

    // basic flow is to take the serializedControlData/Name/compId(optional) and create a custom UI component here
    // that your client understands (i.e. a slack rich form payload)
})(inputs, outputs);

Implementieren Sie eine anbieterspezifische Transformation eines anwenderdefinierten Steuerelements

Sie können eine anbieterspezifische Transformation für jedes anwenderdefinierte Steuerelement implementieren, indem Sie das Feld Subtyp in der Tabelle „Konfigurationen des anwenderdefinierten Adapters“ [sys_cs_custom_adapter_config] verwenden. Bei Bedarf können Sie eine neuere Version eines anwenderdefinierten Steuerelements oder eines vorgefertigten ServiceNow, das auch als standardmäßiges anwenderdefiniertes Steuerelement bezeichnet wird, veröffentlichen. Dies umfasst die Veröffentlichung der entsprechenden Aktionsskripts für eingehenden Datenverkehr und ausgehenden Datenverkehr Workflow-Studio und die Aktualisierung der Konfiguration in der Tabelle „Konfiguration des anwenderdefinierten Adapters“ [sys_cs_custom_adapter_config].

• Wenn Sie Ihre eigene Version eines anwenderdefinierten Steuerelements ServiceNow veröffentlichen, überschreiben Sie den Datensatz des anwenderdefinierten Steuerelements in der Tabelle „Konfiguration des anwenderdefinierten Adapters“ mit Ihren eigenen Skriptnamen für eingehende und ausgehende Aktionen.
• Nur ein Datensatz mit demselben Subtyp ist zulässig. Wenn dasselbe anwenderdefinierte Steuerelement von zwei verschiedenen Parteien implementiert wird, kann nur eine den vorhandenen Datensatz mit neuen eingehenden und ausgehenden Umwandlern aktualisieren.

Hinweis:

Sobald Sie einen vorhandenen anwenderdefinierten Steuerungsdatensatz überschreiben, verwendet das System die neue Version der anwenderdefinierten Steuerung. Beispielsweise können Transformationsskripts mehrere anwenderdefinierte Steuerelemente umwandeln, z. B. Zeitauswahl und Authentifizierung. Wenn Sie ein Zeitauswahl-Steuerelement mit unterschiedlichen eingehenden und ausgehenden Transformationen hinzufügen, wird das neuere Zeitauswahl-Steuerelement verwendet. Sie können die ursprüngliche Version des anwenderdefinierten Steuerelements nicht wiederherstellen.

Prozedur

1. Navigieren Sie zu Alle, und geben Sie im Filter sys_cs_custom_adapter_config.list ein.
2. Wählen Sie Neu.
3. Füllen Sie die Felder des Formulars aus.

   Tabelle : 1. Formular „Anwenderdefinierte Adapterkonfigurationen“.

   Feld	Beschreibung
   Anbieter	Der Name des Kanalbezeichners für Ihre anwenderdefinierte Chatintegration. Details finden Sie unter Erstellen Sie einen Kanalbezeichner für Ihre anwenderdefinierte Chatintegration.
   Steuerungstyp	Wählen Sie das von Ihnen entworfene anwenderdefinierte Steuerelement aus. Bei anwenderdefinierten Steuerelementen lautet der Typ immer DefaultCustomControl. Weitere Informationen zu anwenderdefinierten Steuerungen finden Sie unter Anpassen von Virtual Agent mit anwenderdefinierten Steuerungen.
   Untertyp	Name des anwenderdefinierten Steuerelements.
   Eingehende Umwandleraktion	Name des Skripts für die eingehende Umwandleraktion für dieses Rich Control, z. B. „sn_va_sms_twilio.va_sms_twilio_adapter_input_text_inbound_transformer“.
   Ausgehende Transformationsaktion	Name des Aktionsskripts für den ausgehenden Umwandler für dieses Rich Control, z. B. sn_va_sms_twilio.va_sms_twilio_adapter_input_text_outbound_transformer.

4. Wählen Sie Absenden.