Löst ein Playbook manuell aus

Verwenden Sie ein Serverskript, um ein Playbook manuell auszulösen.

Lösen Sie die Playbook-Funktion aus

Lösen Sie manuell ein Playbook mithilfe einer Serverskriptfunktion mit dem folgenden Code aus:

sn_playbook.PlaybookExperience.triggerPlaybook('<scoped name>',parentRecord);

Ersetzen<scoped name> mit dem bereichsbezogenen Namen Ihres Playbooks. Sie können den bereichsbezogenen Namen finden, indem Sie die Prozessdefinition in der Tabelle „sys_pd_process_definition“ suchen und die Felder „Name“ und „Anwendungsbereich“ kopieren. Ersetzen Sie parentRecord durch den Eingabe-/übergeordneten Datensatz, für den der Prozess ausgeführt werden soll.

Bei einem Fehler löst das Serverskript eine Ausnahme aus. Sie können bei Erfolg eine Infonachricht und bei einem Fehler eine Fehlermeldung hinzufügen.

Hilfsfunktionen

Verwenden Sie die folgende skriptfähige Funktion, um zu bestimmen, ob ein Playbook bereits für einen Datensatz ausgeführt wird, bevor Sie eine UI-Aktion oder eine deklarative Aktion anzeigen, um sie auszulösen.

sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(parentRecord, '<scoped name>')

Um alle Playbooks anzuzeigen, die für einen bestimmten übergeordneten Datensatz ausgeführt werden, verwenden Sie den folgenden Code:

sn_playbook.PlaybookExperience.getPlaybooksForParentRecord(parentRecord)

Diese Informationen können verwendet werden, um zu steuern, wann eine Playbook-Aktion auslösen, z. B. eine UI-Aktion, angezeigt werden soll.

Der folgende Abschnitt zeigt ein Beispiel für die Verwendung der Funktion „Playbook auslösen“ zum Erstellen einer Schaltfläche „Playbook hinzufügen“.

Erstellen Sie eine Playbook-UI-Aktion hinzufügen

Erstellen Sie im Arbeitsbereich eine UI-Aktion „Playbook hinzufügen“.

Vorbereitungen

Erforderliche Rolle: workspace_admin

Prozedur

1. Navigieren zu Alle > Systemdefinitionen > UI-Aktionenan.
2. Klicken Sie auf Neu.
3. Füllen Sie die Felder des Formulars aus.
   Hinweis:

   Andere Felder als die in der folgenden Tabelle erscheinen im Formular, haben jedoch keine Funktion in Arbeitsbereichen. Weitere Informationen zu den einzelnen Feldern im Formular „UI-Aktionen“ finden Sie unter Richten Sie anwenderdefinierte UI-Aktionen in ein veralteter Arbeitsbereich.

   Tabelle : 1. UI-Aktionsformular

   Feld	Beschreibung
   Name	Name der UI-Aktion. Dies wird auf der Anwenderoberfläche des -Arbeitsbereichs angezeigt, z. B. Onboarding-Playbook hinzufügen.
   Tabelle	Tabelle, für die die UI-Aktion gilt. Jedes Mal, wenn ein Service Desk-Mitarbeiter einen Datensatz aus dieser Tabelle anzeigt, wird diese UI-Aktion angezeigt.
   Bestellung	Platzierung in der horizontalen Liste der UI-Aktionen. Von links nach rechts werden die Bestellnummern von klein nach groß angezeigt.
   Aktionsname	Äquivalent des Namens, der in Protokollen und Tabellenspalten angezeigt wird, z. B. „ interaction_add_onboarding“.
   Aktiv	Umschalten, um die UI-Aktion anzuzeigen.
   Bei Update anzeigen	Schalten Sie um, um das Update in der Tabelle anzuzeigen.
   Bedingung	Bedingungen, die erfüllt sein müssen, damit die UI-Aktion angezeigt wird, z. B. current.canWrite() && !sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(current, 'sn_pad_demo.playbook_onboarding_demo').
   Skript	Serverseitiges Skript, das die UI-Aktion implementiert.
   Anwendung	Anwendung, für die diese Komponente gilt. Global bedeutet, dass die Komponente für alle Anwendungen gilt.

4. Um ein serverseitiges Skript zu erstellen, das die Aktion „Playbook hinzufügen“ implementiert, geben Sie das Skript in das Feld Skript ein.

   try{
   	current.update();
   	sn_playbook.PlaybookExperience.triggerPlaybook('sn_pad_demo.playbook_onboarding_demo',current);
   	gs.addInfoMessage(gs.getMessage("Onboarding Playbook added to Interaction."));
   } catch(e){
   		gs.addErrorMessage(e.getMessage());
   }

   Das System ignoriert alle Client-Skripts, die in diesem Feld enthalten sind. Sie können nur das Clientskript-Feld des Arbeitsbereichs für Clientskripts verwenden. Ersetzen Sie sn_pad_demo.playbook_onboarding_demo durch den bereichsbezogenen Namen Ihres Playbooks. Sie können den bereichsbezogenen Namen finden, indem Sie die Prozessdefinition in der Tabelle „sys_pd_process_definition“ suchen und die Felder „Name“ und „Anwendungsbereich“ kopieren.

5. Wählen Sie auf der Registerkarte „Arbeitsbereich“ Folgendes aus: Arbeitsbereich- Formularschaltfläche, damit die Schaltfläche „Playbook hinzufügen“ in der Zeile der UI-Aktionen angezeigt wird, oder Arbeitsbereich-Formularmenü, damit sie als Liste in der Menüliste angezeigt wird.
6. Erstellen Sie im Feld Workspace Client Script (Arbeitsbereichs-Client-Skript) ein arbeitsbereichsspezifisches Client-Skript.
   Für den Arbeitsbereich gelten ähnliche Einschränkungen beim Client-Skripting wie für Serviceportal. Um beispielsweise ein Formular durch Anklicken zu öffnen, können Sie das folgende Client-Skript hinzufügen:

   function onClick(g_form) {
   
   }