Benutzerdefinierte Playbook-Aktionen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

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

    Übersicht

    Playbook-Aktionen können Serverskripts ausführen, Client-Aktionen senden oder UI-Komponenten rendern, wenn sie ausgelöst werden. Beim Ausführen von Serverskripts ist die Variable current an den zugehörigen Datensatz der Aktivität gebunden. Wenn Sie möchten, dass Client-Aktionen Events in UI Builderauslösen, finden Sie weitere Informationen unter Konfigurieren Sie UXF-Client-Aktionen für das Playbook.

    Flow-Datensätze (sys_flow_data) werden häufig als zugeordnete Datensätze verwendet, um die Konfiguration eines Flow ü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 erfassen, die in einem Flow verwendet werden sollen.

    Ein zugeordneter Datensatz kann an eine beliebige Tabelle gebunden werden. Sie können über diese Standardaktionen hinaus eigene Aktionen definieren, um die gewünschte Geschäftsprozess-Workflow-Logik auszuführen.

    Sie können die Funktion „Speichern und dann“ für alle Skriptaktionen außerhalb des Servers aktivieren, indem Sie das Kontrollkästchen Erfordert Formularfelder aktivieren. Eine Aktion mit der Funktion „Speichern und dann“ sendet 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 Validierung oder Geschäftsregel das Speichern des Datensatzes verhindert. Standardmäßig löst dies die UI-Aktion „ sysverb_ws_save “ aus, um das Formular zu übermitteln. Dies kann jedoch überschrieben werden, indem eine andere UI-Aktion in einer Eigenschaft „uiActionName“ der Client-Aktionsnutzlast angegeben wird.

    Standardaktionen

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

    überspringen_Anweisung

    		 Überspringt einen Anweisungsprozessschritt
    Überspringen

    überspringen_email

    		 Überspringt das Senden einer E-Mail
    Überspringen

    überspringen_knowledge

    		 Überspringt einen Wissensprozessschritt
    Überspringen

    überspringen_update

    		 Überspringt einen Prozessschritt zum Aktualisieren eines Datensatzes
    Überspringen

    überspringen_list

    		 Überspringt einen Listenverarbeitungsschritt
    Überspringen

    überspringen_erstellen

    		 Überspringt einen Prozessschritt zum Erstellen eines Datensatzes
    Als abgeschlossen markieren

    Complete_activity

    		 Markieren Sie eine Aktivität als abgeschlossen
    Datensatz erstellen

    create_record

    		 Erstellen Sie 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 Genehmiger für diesen Datensatz an
    Als vollständig markieren

    mark_complete_knowledge

    		 Markiert einen Wissensprozessschritt als abgeschlossen
    Als vollständig markieren

    markieren_vollständig_instruktional

    		 Markiert einen Anweisungsprozessschritt als abgeschlossen
    Als vollständig markieren

    mark_complete_list

    		 Markiert einen Listenprozessschritt als abgeschlossen
    Als vollständig markieren

    mark_complete

    		 Markiert den aktuellen Prozess als abgeschlossen
    Als vollständig markieren

    save_and_complete_activity

    		 Speichern Sie den aktuellen Datensatz, und markieren Sie den Vorgang 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 Benutzer 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-Dropdown-Menüoder Header-Symbol.
        Schaltflächentyp Schaltflächentyp, der in der Playbook-UI angezeigt wird. Wählen Sie Primär, Sekundäroder Tertiäraus.
        Formularfelder erforderlich Option, die mitteilt, dass für die Aktion Daten vom Benutzer erforderlich sind, um fortzufahren.
        Dieses Feld wird in der Benutzeroberfläche der Playbook-Experience 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 Fenster ausgeblendet.
        2. Wenn eine Aktivität ein Formular enthält, aber keine Aktionen enthält, die Formularfelder erfordern, wird das Formular nicht gerendert. Stattdessen werden die Felder im Formular als gestapelte Sammlung von Bezeichnungswertpaaren dargestellt.
        Dieses Feld kann durch Erstellen eines benutzerdefinierten Aktivitätsrenderers ü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. Zum 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.
        Reihenfolge Ganzzahl, die die Rangfolge dieser Aktion im Verhältnis zu übereinstimmenden 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 Joins 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 zum Anfordern des Erstellungszugriffs.
        Erfordert Lesezugriff Option, um Lesezugriff zu erfordern.
        Erfordert Schreibzugriff Optionen, um Schreibzugriff zu erfordern.
        Erfordert Löschzugriff Optionen zum Erfordernis des Löschzugriffs.
    3. Wenn im Feld Implementiert alsServerskript ausgewählt ist, geben Sie ein Skript für die Aktion an.
      • Serverskripts können mit 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 Benutzer 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 der Clientaktion gesendeten Nutzlast überschreiben. Mit der Client-Aktion Vorschau auf Datensatz können Sie beispielsweise einen Datensatz auf einer neuen Arbeitsbereich -Registerkarte öffnen. Mithilfe der Nutzlastzuordnung können Sie eine Registerkarte für zugehörige Elemente angeben, die beim Öffnen des Formulars angezeigt wird. Legen Sie dazu defaultTab fest.

    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 benutzerdefinierte Playbook-Aktionen auf Playbook-Experiences an.

    Vorbereitungen

    Erforderliche Rolle: playbook_experience_admin

    Prozedur

    1. Navigieren zu Alle > Playbook-Experience > Playbook Experiences.
    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 Zuweisung der deklarativen Aktion 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 Mapping aus.
    8. Stellen Sie sicher, dass die Playbook-Experience der Tabelle hinzugefügt wurde.

    Nächste Maßnahme

    Integrieren Sie Ihre Playbook-Experience mit Arbeitsbereich.