Lösen Sie ein Playbook manuell aus

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

Lösen Sie die Playbook-Funktion aus

Lösen Sie ein Playbook manuell 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 finden den bereichsbezogenen Namen, indem Sie die Prozessdefinition in der Tabelle „sys_pd_process_definition“ suchen und die Felder „Name“ und „Anwendungsbereich“ kopieren. Ersetzen Sie parentRecord durch den Eingabedatensatz/übergeordneten Datensatz, für den Sie den Prozess ausführen möchten.

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

Hilfsfunktionen

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

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

Um jedes Playbook anzuzeigen, das für einen bestimmten übergeordneten Datensatz ausgeführt wird, verwenden Sie den folgenden Code:

sn_playbook.PlaybookExperience.getPlaybooksForParentRecord(parentRecord)

Diese Informationen können verwendet werden, um zu steuern, wann eine Playbook-Auslöseraktion wie 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 eine Playbook-UI-Aktion hinzufügen im Arbeitsbereich.

Vorbereitungen

Erforderliche Rolle: workspace_admin

Prozedur

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

   Andere Felder als die in der folgenden Tabelle werden im Formular angezeigt, funktionieren jedoch nicht in Arbeitsbereichen. Weitere Informationen zu den einzelnen Feldern im Formular „UI-Aktionen“ finden Sie unter Richten Sie benutzerdefinierte UI-Aktionen in ein veralteter Arbeitsbereich.

   Tabelle : 1. UI-Aktionsformular

   Feld	Beschreibung
   Name	Name der UI-Aktion. Dies wird in der Arbeitsbereichs-UI 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.
   Reihenfolge	Platzierung in der horizontalen Liste der UI-Aktionen. Von links nach rechts gehen die Reihenfolgennummern von klein nach groß.
   Aktionsname	Äquivalent zu Name, der in Protokollen und Tabellenspalten angezeigt wird, z. B. „ interaction_add_onboarding“.
   Aktiv	Schalten Sie um, 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 finden den bereichsbezogenen Namen, 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 eine der folgenden Optionen aus: Arbeitsbereich- Formularschaltfläche, damit die Schaltfläche „Playbook hinzufügen“ in der Zeile der UI-Aktionen angezeigt wird, oder Arbeitsbereich-Formularmenü, um sie als Liste in der Menüliste anzuzeigen.
6. Erstellen Sie im Feld Workspace Client Script (Arbeitsbereich-Client-Skript) ein arbeitsbereichsspezifisches Client-Skript.
   Für den Arbeitsbereich gelten ähnliche Client-Skripting-Einschränkungen wie für Serviceportal. Um beispielsweise ein Formular durch Klicken zu öffnen, können Sie das folgende Client-Skript hinzufügen:

   function onClick(g_form) {
   
   }