---
sourceDocument: Xanadu-Konversations-Schnittstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Konversations-Schnittstellen

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Integrieren Sie anwenderdefinierte Steuerungen

# Integrieren Sie anwenderdefinierte Steuerungen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

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.

    {#ccif-integrate-custom-controls__ul_z22_lcx_fqb}  
    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 <kbd class="ph userinput"> sys_cs_custom_adapter_config.list</kbd> ein.
2. Wählen Sie Neu.
3. Füllen Sie die Felder des Formulars aus.  
   {#ccif-integrate-custom-controls__table_zbd_nsp_b4b__entry__2}

   | Feld | Beschreibung |
   |-|-|
   | Provider | Der Name des Kanalbezeichners für Ihre anwenderdefinierte Chatintegration. Details finden Sie unter [Erstellen Sie einen Kanalbezeichner für Ihre anwenderdefinierte Chatintegration](https://servicenow-prod.fluidtopics.net/~_J2FqIPH1InGDOumD_jkw "Erstellen Sie in der Tabelle „Identitäten des Anbieterkanals“ [sys_cs_provider_application] 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](https://servicenow-prod.fluidtopics.net/91yiCfMbXFr7xc4Fm8LMOg "Anwenderdefinierte Steuerungen sind Komponenten, die ServiceNow -Entwickler zur Verwendung in Virtual Agent -Themen oder -Themenblöcken erstellen können. Zu diesen Steuerelementen gehören Schieberegler oder Video-Player. Anwenderdefinierte Steuerungen ergänzen die in Virtual Agent-Designerbereitgestellten 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. |
   [Tabelle : 1. Formular „Anwenderdefinierte Adapterkonfigurationen".]

   {#ccif-integrate-custom-controls__table_zbd_nsp_b4b}
4. Wählen Sie Absenden.