Anwenderdefinierte Playbook-Aktionen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Passen Sie Playbook-Interaktionen an, indem Sie Bedingungen einrichten, die Schaltflächen, Dropdownlisten, Listenelemente und anklickbare Symbole hinzufügen. Mit dieser Anpassung können Sie in allen Playbook-Experiences Formulare übermitteln, Datensätze öffnen und Aktivitäten abschließen und überspringen.

    Übersicht

    Playbook-Aktionen können bei Auslösung Serverskripts ausführen, Client-Aktionen senden oder UI-Komponenten rendern. Bei der Ausführung von Serverskripts wird die Variable current an den zugehörigen Datensatz der Aktivität gebunden. Wenn Sie möchten, dass Client-Aktionen Ereignisse innerhalb von UI Builderauslösen, lesen Sie Konfigurieren Sie UXF-Client-Aktionen für das Playbook.

    Flow-Daten-Datensätze (sys_flow_data) werden häufig als zugehörige Datensätze verwendet, um die Konfiguration eines Flows über ein Aktionsserverskript zu steuern. Diese Serverskripts können den Status der Flows auf „Abgeschlossen“ oder „Übersprungen“ festlegen, sodass ein Agent die Logik innerhalb eines Flows direkt beeinflussen kann.

    Flow-Datensätze können auch Benutzerdaten von einem Service Desk-Mitarbeiter sammeln, um sie in einem Flow zu verwenden.

    Ein zugeordneter Datensatz kann an jede Tabelle gebunden werden. Sie können Ihre eigenen Aktionen definieren, die über diese Standardaktionen hinausgehen, um die gewünschte Geschäftsprozess-Workflow-Logik zu erreichen.

    Sie können die Funktion „Speichern und dann“ für alle Nicht-Server- Skriptaktionen aktivieren, indem Sie das Kontrollkästchen Formularfelder erforderlich aktivieren. Eine Aktion mit der Funktion „Speichern und dann“ übermittelt ein Formular, führt Client-Skripts und Validierungen von Geschäftsregeln aus und führt die Aktion aus, sobald der Datensatz erfolgreich gespeichert wurde. Die Aktion wird nicht ausgeführt, wenn eine Validierungs- oder Geschäftsregel das Speichern des Datensatzes verhindert. Standardmäßig löst dies die UI-Aktion „ sysverb_ws_save “ zum Senden des Formulars aus. Dies kann jedoch durch Angabe einer anderen UI-Aktion in einer Eigenschaft „uiActionName“ der Nutzlast der Client-Aktion überschrieben werden.

    Standardaktionen

    Die folgenden Standardaktionen werden in Playbook unterstützt.
    Aktionsname Beschreibung
    Überspringen

    überspringen_Anweisungen

    		 Überspringt einen anweisungsbezogenen Prozessschritt
    Überspringen

    überspringen_email

    		 Überspringt das Senden einer E-Mail
    Überspringen

    überspringen_knowledge

    		 Überspringt einen Knowledge-Prozessschritt
    Überspringen

    überspringen_Update

    		 Überspringt den Prozessschritt „Datensatz aktualisieren“.
    Überspringen

    überspringen_Liste

    		 Überspringt einen Listenprozessschritt
    Überspringen

    überspringen_erstellen

    		 Überspringt einen Prozessschritt der Datensatzerstellung
    Als abgeschlossen markieren

    complete_activity

    		 Markieren Sie eine Aktivität als abgeschlossen
    Datensatz erstellen

    create_record

    		 Erstellt einen neuen Datensatz aus einem neuen Datensatzformular
    E-Mail senden

    send_email

    		 Informiert die Prozessautomatisierung zum Senden von E-Mails
    Neu starten

    „restart_activity“

    		 Startet die Aktivität neu
    Überspringen

    überspringen_Aktivität

    		 Markieren Sie Aktivitäten mithilfe eines Experience-Statusdatensatzes als übersprungen.
    Datensatz anzeigen

    Datensatz anzeigen

    		 Zeigen Sie den aktuellen Datensatz an
    Speichern

    save_record

    		 Aktuellen Datensatz speichern
    Genehmiger anzeigen

    Playbook-Ansicht – Genehmiger

    		 Zeigen Sie die Genehmiger für diesen Datensatz an
    Als abgeschlossen markieren

    mark_complete_knowledge

    		 Markiert einen abgeschlossenen Wissensprozessschritt
    Als abgeschlossen markieren

    markieren_vollständig_Anweisungen

    		 Markiert einen abgeschlossenen Prozessschritt für Anweisungen
    Als abgeschlossen markieren

    mark_complete_list

    		 Markiert einen Listenprozessschritt als abgeschlossen
    Als abgeschlossen markieren

    mark_complete

    		 Markiert den aktuellen Prozess als abgeschlossen
    Als abgeschlossen markieren

    save_and_complete_activity

    		 Speichern Sie den aktuellen Datensatz, und markieren Sie den Prozess als abgeschlossen

    Passen Sie Playbook-Aktionen an

    Passen Sie Playbook-Aktionen mithilfe von Formularen, Bedingungen und Skripts, Komponenten oder Client-Aktionen an. Mit dieser Anpassung können Anwender Formulare übermitteln, Datensätze öffnen sowie Aktivitäten abschließen und überspringen.

    Vorbereitungen

    Erforderliche Rolle: playbook_experience.admin

    Warum und wann dieser Vorgang ausgeführt wird

    • Standardaktionen können nicht bearbeitet werden. Diese Aktionen werden als schreibgeschützt angezeigt.
    • Aktionen können nur für einen Datensatz ausgeführt werden.

    Prozedur

    1. Erstellen Sie die Aktion, und geben Sie Details an.
      1. Navigieren zu Playbook-Experience > Aktionen Playbook-Aktionen, Phasenaktionenoder Aktivitätsaktionen.
      2. Wählen Sie eine Aktionszuweisung aus, oder klicken Sie auf Neu, um eine neue zu erstellen.
        Hinweis:
        Eine Liste der Standardaktionen finden Sie unter Playbook-Aktionen.
      3. Füllen Sie die Felder des Formulars aus.
        Tabelle : 1. Formular „Aktionszuweisung“.
        Feld Beschreibung
        Aktionsbezeichnung Bezeichnung, die auf der durch die Aktion erstellten Schaltfläche angezeigt wird.
        Aktionsname Name für Ihre Aktion, der in der Aktionszuweisungsliste angezeigt wird. Eine Aktionszuweisung überschreibt andere mit demselben Namen.
        Implementiert als Typ der Aktion, die implementiert wird. Beispiel: UI-Komponente.
        Geben Sie die UI-Komponente an Wenn das Feld Implementiert als auf UI-Komponente festgelegt ist, gibt dieses Feld eine UI-Komponente an, die angezeigt wird, wenn die Aktion ausgelöst wird.
        Tooltip Text, der angezeigt wird, wenn ein Service Desk-Mitarbeiter den Mauszeiger über eine Schaltfläche oder ein Symbol bewegt.
        Symbol Symbol, das auf der Aktivitätskarte angezeigt wird.
        Render-Modus Rendermodus auf einer Playbook-Karte. Geben Sie an, wie die Aktion auf der Playbook-Karte gerendert wird. WählenSie Schaltfläche, Header-Dropdownoder Header-Symbol aus.
        Schaltflächentyp Schaltflächentyp, der in der Playbook-UI angezeigt wird. Wählen Sie Primär, Sekundäroder Tertiäraus.
        Formularfelder erforderlich Option, die kommuniziert, dass für die Aktion Daten vom Anwender erforderlich sind, um fortzufahren
        Dieses Feld wird in der Playbook-Experience-UI auf folgende Weise verwendet.
        1. Wenn eine Aktivität ein Formular enthält, das zu groß für eine Karte ist, wird das Formular in einem modalen Element ausgeblendet.
        2. Wenn eine Aktivität ein Formular enthält, aber keine Aktionen aufweist, für die Formularfelder erforderlich sind, wird das Formular nicht gerendert. Stattdessen werden die Felder im Formular als gestapelte Sammlung von Bezeichnungswertpaaren gerendert.
        Dieses Feld kann durch Erstellen eines anwenderdefinierten Aktivitäts-Renderers überschrieben werden.
        Beschreibung Beschreibung für die Aktion, die in der Liste „Aktionszuweisungen“ angezeigt wird.
        Anwendung Anwendung für die Aktionszuweisung.
        Arbeitsbereich Arbeitsbereich, dem die Playbook-Aktion zugeordnet ist. Beispiel: ServiceNow® ITSM oder HR.
        Hinweis:
        Dieses Feld ist nicht erforderlich.
        Tabelle Feld, um diese Aktion auf Aktivitäten mit dieser zugeordneten Tabelle zu beschränken.
        Ansicht Feld, um diese Aktion auf Aktivitäten in dieser Formularansicht zu beschränken.
        Aktiv Option zum Aktivieren der Aktion.
        Bestellung Ganzzahl, die die Priorität dieser Aktion in Bezug auf übereinstimmende Aktionen mit demselben Namen bestimmt. Je niedriger die Zahl, desto wahrscheinlicher ist es, dass sie für andere Aktionen ausgewählt wird. Mit dieser Reihenfolge können Sie andere Aktionen mit Ihren eigenen überschreiben. In der Regel werden Zahlen im Hunderterbereich verwendet. Zum Beispiel 100, 200, 300 oder 400.
    2. Richten Sie Bedingungen für die Aktion ein.
      1. Klicken Sie auf die Registerkarte Bedingungen.
      2. Füllen Sie die Felder des Formulars aus.
        Tabelle : 2. Formular „Bedingungen“.
        Feld Beschreibung
        Skriptbedingung Skriptbedingung für die Aktionszuweisung. Geben Sie sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(current) ein. Mit diesem Skript können Sie ein Playbook nur anzeigen, wenn der Datensatz eine Prozessausführung ausgelöst hat.
        Hinweis:
        Das Hinzufügen von Abfragen mit mehreren Verknüpfungen kann die Leistung beeinträchtigen.
        Clientbedingungen Wählen Sie Bedingungen aus, um Kollisionen basierend auf Ihrem Anwendungsfall zu begrenzen.
        Datensatzbedingungen Wählen Sie Bedingungen aus, um Kollisionen basierend auf Ihrem Anwendungsfall zu begrenzen.
        Erforderliche Rollen Rollen zum Einschränken des Playbook-Zugriffs.
        Erfordert Erstellzugriff Optionen, um Erstellzugriff zu erfordern.
        Erfordert Lesezugriff Option zum Erfordern des Lesezugriffs.
        Erfordert Schreibzugriff Optionen, um Schreibzugriff zu erfordern.
        Erfordert Löschzugriff Optionen, um Löschzugriff zu erfordern.
    3. Wenn im Feld Implementiert alsServerskript ausgewählt ist, geben Sie ein Skript für die Aktion an.
      • Serverskripts können mithilfe der Variablen Current auf den zugeordneten Datensatz einer Aktivität verweisen.
      • Durch einen Aufruf von current.update() wird der zugeordnete Datensatz mit Werten aktualisiert, die der Anwender aus eingebetteten Formularen auf Playbook-Karten bereitstellt.
    4. Wenn Client-Aktion im Feld Implementiert als ausgewählt ist, geben Sie optional die Nutzlastzuordnung auf der Registerkarte Aktionsattribute an.

      Mit der Nutzlastzuordnung können Sie Teile der von Client-Aktionen gesendeten Nutzlast überschreiben. Beispielsweise können Sie mit der Clientaktion „Datensatzvorschau anzeigen“ einen Datensatz auf einer neuen Registerkarte Arbeitsbereich öffnen. Mithilfe der Nutzlastzuordnung können Sie eine zugehörige Elementregisterkarte angeben, die beim Öffnen des Formulars angezeigt wird. Legen Sie die defaultTab-Einstellung fest, um dies zu tun.

    5. Wenn UI-Komponente im Feld Implementiert als ausgewählt ist, geben Sie optional die Attribute der Komponente auf der Registerkarte Komponentenattribute an.
    6. Klicken Sie auf Absenden.

    Wenden Sie Playbook-Aktionen auf Playbook-Experiences an

    Wenden Sie standardmäßige oder anwenderdefinierte Playbook-Aktionen auf Playbook-Experiences an.

    Vorbereitungen

    Erforderliche Rolle: playbook_experience_admin

    Prozedur

    1. Navigieren zu Alle > Playbook-Experience > Playbook Experiencesan.
    2. Wählen Sie eine Playbook Experience aus.
    3. Klicken Sie auf die zugehörige Liste Aktionszuordnung.
    4. Klicken Sie auf Neu.
    5. Füllen Sie die Felder des Formulars aus.
      Tabelle : 3. Aktionszuweisungszuordnung der Playbook-Experience
      Feld Beschreibung
      Aktionszuweisung Wählen Sie die deklarative Aktionszuweisung aus
      Playbook-Experience Wählen Sie aus, auf welche Playbook-Experience die Aktion angewendet werden soll
      Anwendung Anwendung, in der die Aktion angewendet wird
      Aktivitätsdefinition Wählen Sie die Aktivitätsdefinition aus, um die Aktion anzuwenden
    6. Klicken Sie auf Absenden.
    7. Wählen Sie im Abschnitt „Zugehörige Links“ die Registerkarte Playbook-Experience-Zuordnung.
    8. Stellen Sie sicher, dass die Playbook-Experience der Tabelle hinzugefügt wurde.

    Nächste Maßnahme

    Integrieren Sie Ihre Playbook-Experience mit Arbeitsbereich.