Integrieren Sie anwenderdefinierte Steuerungen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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 in erstellte anwenderdefinierte Steuerungen zu implementieren Workflow-Studio.
    Beispiel: Unterstützung anwenderdefinierter 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 einer anwenderdefinierten Steuerung
    Sie können eine anbieterspezifische Transformation für jedes anwenderdefinierte Steuerelement implementieren, indem Sie verwenden Untertyp Feld in der Tabelle „Anwenderdefinierte Adapterkonfiguration“ [sys_cs_custom_Adapter_config]. Sie können eine neuere Version eines anwenderdefinierten Steuerelements oder eines vorgefertigten veröffentlichen, ServiceNow Anwenderdefinierte Steuerung, bei Bedarf auch als standardmäßige anwenderdefinierte Steuerung bezeichnet. Dies beinhaltet die Veröffentlichung der entsprechenden eingehenden und ausgehenden Workflow-Studio Aktionsskripts und Aktualisierung der Konfiguration in der Tabelle „Anwenderdefinierte Adapterkonfiguration“ [sys_cs_custom_Adapter_config].
    • Wenn Sie Ihre eigene Version von veröffentlichen ServiceNow Anwenderdefinierte Steuerung: Überschreiben Sie den anwenderdefinierten Steuerungsdatensatz in der Tabelle „Anwenderdefinierte Adapterkonfiguration“ mit Ihren eigenen Skriptnamen für eingehende und ausgehende Aktionen.
    • Nur ein Datensatz mit demselben Untertyp Ist zulässig. Wenn dieselbe anwenderdefinierte Steuerung 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 Steuerungen wie Zeitauswahl und Authentifizierung umwandeln. Wenn Sie ein Zeitauswahl-Steuerelement mit verschiedenen eingehenden und ausgehenden Transformationen hinzufügen, wird das neuere Zeitauswahl-Steuerelement verwendet. Sie können nicht zur ursprünglichen Version der anwenderdefinierten Steuerung zurückkehren.

    Prozedur

    1. Navigieren Sie zu Alle , Und geben Sie dann ein sys_cs_custom_Adapter_config.list Im Filter.
    2. Wählen Sie Neu.
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. Formular „anwenderdefinierte Adapterkonfigurationen“
      Feld Beschreibung
      Anbieter Der Name des Kanalbezeichners für Ihre anwenderdefinierte Chat-Integration. Details finden Sie unter Erstellen Sie einen Kanalbezeichner für Ihre anwenderdefinierte Chat-Integration.
      Steuerungstyp

      Wählen Sie die von Ihnen entworfene anwenderdefinierte Steuerung aus. Für anwenderdefinierte Steuerungen ist der Typ immer DefaultCustomControl.

      Weitere Informationen zu anwenderdefinierten Steuerungen finden Sie unter Wird Angepasst Virtual Agent Mit anwenderdefinierten Steuerungen.

      Untertyp Name der anwenderdefinierten Steuerung.
      Eingehende Umwandleraktion Name des eingehenden Umwandleraktionsskripts für diese umfassende Steuerung, z. B. sn_va_sms_twilio.va_sms_twilio_Adapter_input_Text_inbound_Transformer.
      Ausgehende Transformationsaktion Name des ausgehenden Transformatoraktionsskripts für diese umfassende Steuerung, z. B. sn_va_sms_twilio.va_sms_twilio_Adapter_input_Text_outbound_Transformer.
    4. Wählen Sie Absenden.