Lösen Sie manuell ein Playbook aus

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Verwenden Sie ein Serverskript, um ein Playbook manuell auszulösen.

    Playbook-Funktion auslösen

    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 können den bereichsbezogenen Namen finden, indem Sie die Prozessdefinition in suchen sys_pd_process_definition Tabelle und Kopieren der Felder „Name“ und „Anwendungsbereich“. Ersetzen Übergeordneter Datensatz Mit dem Eingabe-/ü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 einem Fehler eine Fehlermeldung hinzufügen.

    Hilfsfunktionen

    Verwenden Sie die folgende skriptfähige Funktion, um zu bestimmen, ob bereits ein Playbook für einen Datensatz ausgeführt wird, bevor Sie eine UI-Aktion oder eine deklarative Aktion anzeigen, um es auszulösen.
    sn_playbook.PlaybookExperience.parentRecordContainsPlaybook(parentRecord, '<scoped name>')
    Verwenden Sie den folgenden Code, um jedes Playbook anzuzeigen, das für einen bestimmten übergeordneten Datensatz ausgeführt wird:
    sn_playbook.PlaybookExperience.getPlaybooksForParentRecord(parentRecord)
    Diese Informationen können verwendet werden, um zu steuern, wann eine Auslöser-Playbook-Aktion wie eine UI-Aktion angezeigt werden soll.

    Der folgende Abschnitt ist ein Beispiel für die Verwendung der Playbook-Auslöserfunktion zum Erstellen einer Schaltfläche „Playbook hinzufügen“.

    Erstellen Sie eine Playbook-UI-Aktion hinzufügen

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

    Vorbereitungen

    Erforderliche Rolle: Workspace_admin

    Prozedur

    1. Navigieren zu Alle > Systemdefinitionen > UI-Aktionenan.
    2. Klicken Sie auf Neu.
    3. Füllen Sie im Formular die Felder 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 anwenderdefinierte UI-Aktionen in ein veralteter Arbeitsbereich.
      Tabelle : 1. UI-Aktionsformular
      Feld Beschreibung
      Name UI-Aktionsname. Dies wird z. B. in der Arbeitsbereich-UI angezeigt: Fügen Sie Das Onboarding-Playbook Hinzu .
      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 wechseln die Bestellnummern von klein nach groß.
      Aktionsname Entspricht Name Das in Protokollen und Tabellenspalten angezeigt wird, z. B. Interaction_add_Onboarding
      Aktiv Umschalten, damit die UI-Aktion angezeigt wird.
      Bei Update anzeigen Umschalten, um das Update in anzuzeigen Tabelle .
      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 ein Skript Feld.
      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 Clientskripts, die in diesem Feld enthalten sind. Sie können das Feld „Arbeitsbereich-Client-Skript“ nur für Client-Skripts verwenden. Ersetzen sn_pad_demo.playbook_onboarding_demo Mit dem bereichsbezogenen Namen Ihres Playbooks. Sie können den bereichsbezogenen Namen finden, indem Sie die Prozessdefinition in suchen sys_pd_process_definition Tabelle und Kopieren der Felder „Name“ und „Anwendungsbereich“.

    5. In Arbeitsbereich Registerkarte auswählen: Arbeitsbereichsformular-Schaltfläche Damit die Schaltfläche „Playbook hinzufügen“ in der Zeile der UI-Aktionen angezeigt wird, oder Arbeitsbereich-Formularmenü Damit es als Liste in der Menüliste angezeigt wird.
    6. In Arbeitsbereich-Clientskript Feld, erstellen Sie ein arbeitsbereichsspezifisches Client-Skript.
      Arbeitsbereich weist ähnliche Client-Skripting-Einschränkungen wie auf Serviceportal. Um beispielsweise ein Formular durch Klicken darauf zu öffnen, können Sie das folgende Clientskript hinzufügen:
      function onClick(g_form) {
      
      }