---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Bestellleitfäden werden automatisch ausgeführt

# Bestellleitfäden werden automatisch ausgeführt {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 Minuten Lesedauer

Mit Servicekatalog-Bestellleitfäden können Kunden eine einzelne Servicekataloganforderung stellen, die mehrere bestellte Artikel generieren kann. Administratoren können Bestellleitfäden so konfigurieren, dass sie automatisch ausgeführt werden, über einen Workflow oder ein Skript, um einen Satz bestellter Elemente zu generieren, ohne manuell eine Servicekataloganforderung zu übermitteln. Administratoren können auch Fehler im Bestellleitfaden überprüfen und erneut verarbeiten.

Als Anwendungsfall kann ein Onboarding-Workflow für einen neuen Mitarbeiter einen Bestellleitfaden ausführen, um Artikel für diesen Mitarbeiter automatisch zu bestellen.  
Hinweis:  
Sie können nur Katalogelemente speichern, nicht den Bestellleitfaden (d. h. Optionen für die erste Zielseite).

## Bestellleitfäden werden aus Skripts ausgeführt {#ariaid-title2}

Die Ausführung von Bestellleitfäden mit einem serverseitigen Skript ist komplexer als die Verwendung von Workflows, ermöglicht jedoch mehr Flexibilität und kann in Situationen ohne Workflow verwendet werden.
Sie können beispielsweise Bestellleitfadenskripts mit UI-Aktionen oder serverseitigen Business-Regeln verwenden.  
Hinweis:  
Wenn Bestellleitfäden automatisch ausgeführt werden, werden UI-Richtlinien des Bestellleitfadens nicht erzwungen. Außerdem können Optionen auf dem Bildschirm „Optionen auswählen" nicht ausgewählt werden. Stellen Sie daher sicher, dass Regeln für die Bestellanleitung sensible Standardwerte für diese Optionen definieren, um Verarbeitungsfehler zu vermeiden.

Verwenden Sie SNC.SkriptableBestellleitfaden Java-Klasse zum Ausführen von Bestellleitfäden mit einem Skript.

Verwenden Sie SNC.ScriptableOrderGuide(Zeichenfolge orderGuideId) Konstruktor zum Erstellen eines neuen ScriptableOrderGuide-Objekts.

### Methodenzusammenfassung

{#r_RunningOrderGuidesFromScripts__table_uzq_cdf_mp__entry__3}

| Methode | Rückgabewert | Beschreibung |
|-|-|-|
| Prozess (Zeichenfolgen-JSON) | boolean | Führt den Bestellleitfaden mit dem JSON-codierten Zeichenfolgenparameter als Eingabe für den Bestellleitfaden aus. Gibt Zurück Wahr Oder Falsch Abhängig davon, ob die Verarbeitung erfolgreich war oder nicht. Hinweis: Beides opened_byUnd requested_forParameter müssen an den Bestellleitfaden übergeben werden, und beide müssen gültige sys_ID-Werte des Anwenderdatensatzes aufweisen. Wenn die Verarbeitung erfolgreich ist und eine Anforderung vom Bestellleitfaden erstellt wird, können Sie den Anforderungs-GlideRecord mit abrufen Anforderung abrufen () . Wenn die Verarbeitung fehlschlägt, können Sie den Fehler-GlideRecord mit abrufen GetFailure() , Übermitteln Sie dann das Skript zur erneuten Verarbeitung mit „erneut verarbeiten". |
| Erneut verarbeiten (GlideRecord-Fehler) | boolean | Führt den Bestellleitfaden erneut mit dem JSON-codierten Zeichenfolgenparameter aus, der im Fehler-GlideRecord gespeichert ist. |
| GetMessage() | Zeichenfolge | Ruft die nach der Verarbeitung oder erneuten Verarbeitung ausgefüllte Nachricht ab. |
| Anforderung abrufen () | GlideRecord | Ruft den Anforderungs-GlideRecord ab. |
| GetFailure() | GlideRecord | Ruft den Fehler-GlideRecord aus der Tabelle „Fehler im skriptfähigen Bestellleitfaden" \[sc_script_order_guide_failure\] ab. |
[ ]

{#r_RunningOrderGuidesFromScripts__table_uzq_cdf_mp}

### Skriptbeispiel

Dieses Skript verarbeitet einen Bestellleitfaden namens IT-Onboarding-SOG .

    // Creating the object to later be JSON encoded 
    var json = {"opened_by":"62826bf03710200044e0bfc8bcbe5df1","requested_for":"06826bf03710200044e0bfc8bcbe5d8a","department":"221f3db5c6112284009f4becd3039cc9"};
     
    var now_GR = new GlideRecord("sc_cat_item_guide");
    if (gr.get("name","IT Onboarding SOG")) {
      var sog = new SNC.ScriptableOrderGuide(gr.getValue("sys_id"));
      var result = sog.process(new JSON().encode(json));
      if(!result)
        gs.log("Processing the scriptable order guide failed with message: " + sog.getMessage());
      else { 
        var request = sog.getRequest();
        gs.log("Request created - " + request.sys_id); } }

## Auftragsleitfäden werden aus Workflows ausgeführt {#ariaid-title3}

Das Ausführen eines Bestellleitfadens über einen Workflow ist geeignet, wenn Sie Bestellleitfäden als Teil eines umfassenderen Workflow-basierten Prozesses einschließen.
Beispielsweise kann eine Aktivität innerhalb eines Onboarding-Workflows für einen neuen Mitarbeiter automatisch einen Bestellleitfaden ausführen, um Artikel für diesen Mitarbeiter zu bestellen.  
Hinweis:  
Wenn Bestellleitfäden automatisch ausgeführt werden, werden UI-Richtlinien des Bestellleitfadens nicht erzwungen. Außerdem können Optionen auf dem Bildschirm „Optionen auswählen" nicht ausgewählt werden. Stellen Sie daher sicher, dass Regeln für die Bestellanleitung sensible Standardwerte für diese Optionen definieren, um Verarbeitungsfehler zu vermeiden.  
Verwenden Sie zum Ausführen von Bestellleitfäden über einen Workflow Skriptfähiger Bestellleitfaden Workflow-Aktivität.{#r_RunningOrderGuidesFromWorkflows__table_kcr_hbf_mp__entry__2}

| Feld | Beschreibung |
|-|-|
| Bestellleitfaden | Der Name des Bestellleitfadens, den diese Aktivität verarbeitet. Beispiel: Beispiel für IT-Onboarding FÜR Mitarbeiter . |
| Skript | Ein Skript, das Informationen an den Bestellleitfaden übergibt. Diese Informationen werden als JSON-codierter Zeichenfolgenparameter gesendet, der zugewiesen ist <var class="keyword varname">Antwort </var>Variable. Das Skript muss diese Anforderungen erfüllen: * Die Namen der Variablen im Skript müssen mit den im Bestellleitfaden verwendeten Namen übereinstimmen. Beispiel: Wenn der Bestellleitfaden einen verwendet <var class="keyword varname">Abteilung </var>Variable in einer Regelbedingung muss das Skript auch eine übergeben departmentParameter. * Beides opened_byUnd requested_forParameter müssen an den Bestellleitfaden übergeben werden, und beide müssen gültige sys_ID-Werte des Anwenderdatensatzes aufweisen. {#r_RunningOrderGuidesFromWorkflows__ul_qsp_4bf_mp} |
[Tabelle : 1. Auftragsleitfäden werden aus Workflows ausgeführt]

{#r_RunningOrderGuidesFromWorkflows__table_kcr_hbf_mp}

### Ergebnisse

* Erfolg : Die Aktivität hat den Bestellleitfaden erfolgreich verarbeitet. Dies bedeutet nicht, dass eine Anforderung erstellt wurde. Wenn eine Anforderung erstellt wurde, wird die sys_ID der Anforderung dem Workflow-Scratchpad unter hinzugefügt <var class="keyword varname">sc_Request </var>Variable.
* Fehler : Beim Verarbeiten des Bestellleitfadens ist ein Fehler aufgetreten, ein Fehlerdatensatz wird erstellt. Wenn die Verarbeitung fehlschlägt, können Sie den Fehlerdatensatz anzeigen und bearbeiten.
{#r_RunningOrderGuidesFromWorkflows__ul_t22_tbf_mp}

### Workflow-Beispiel

Die Beispiel für IT-Workflow für Mitarbeiter-Onboarding Workflow verwendet dieses Beispiel, um IT-Katalogelemente für einen neuen Mitarbeiter als Teil eines Onboarding-Prozesses zu generieren.  
Die Aktivität verwendet dieses Skript, um:

1. Verwenden Sie eine JSON-Zeichenfolge, die zuvor aus dem HR-Change-Datensatz generiert wurde.
2. Fügen Sie das obligatorische an opened_byUnd requested_forParameter für diese Zeichenfolge.
3. Übermitteln Sie die neue Zeichenfolge zur Verarbeitung durch den Bestellleitfaden.

{#r_RunningOrderGuidesFromWorkflows__ol_lxn_ccf_mp}

    var parameters  = new JSON().decode(current.payload);
     
    // Need to amend the json object to include additional values.
    parameters.opened_by = current.opened_by + "";
    parameters.requested_for = current.opened_for + "";
     
    answer = new JSON().encode(parameters);

## Zeigen Sie Fehler im Bestellleitfaden an {#ariaid-title4}

Die Verarbeitung des Bestellleitfadens kann fehlschlagen, z. B. wenn der ausgeführte Bestellleitfaden nicht vorhanden ist. Wenn während der Verarbeitung des Bestellleitfadens ein Fehler auftritt, wird Fehler Beim Skriptfähigen Bestellleitfaden Mit dem Submodul können Sie die Fehler überprüfen und erneut verarbeiten. Für jeden Fehler wird ein Datensatz erstellt. Sobald Sie die Fehler behoben haben, die den anfänglichen Fehler verursacht haben, können Sie die fehlgeschlagenen Bestellleitfäden erneut verarbeiten.

### Warum und wann dieser Vorgang ausgeführt wird

Wenn ein Fehler auftritt, wird ein Fehlerdatensatz in der Tabelle „Skriptfähige Bestellleitfadfehler" \[sc_script_order_guide_failure\] erstellt.

Navigieren Sie zu , um Details eines Fehlers anzuzeigen ServicekatalogKatalogverwaltungFehler im skriptfähigen Bestellleitfaden, Öffnen Sie dann einen Fehlerdatensatz.

Fehler bei erneuter Verarbeitung: Wenn Sie den Fehler behoben haben, der den anfänglichen Fehler verursacht hat, können Sie fehlgeschlagene Bestellleitfäden erneut verarbeiten.

### Prozedur

1. Navigieren zu ServicekatalogKatalogverwaltungFehler im skriptfähigen Bestellleitfadenan.
2. Öffnen Sie den Fehlerdatensatz.
3. Klicken Sie auf Erneut Verarbeiten Zugehöriger Link.  
   So verarbeiten Sie einen oder mehrere Fehler erneut:
   1. Navigieren zu ServicekatalogKatalogverwaltungFehler im skriptfähigen Bestellleitfadenan.
   2. Aktivieren Sie das Kontrollkästchen neben einem oder mehreren Datensätzen, die erneut verarbeitet werden sollen.
   3. Wählen Sie Aus Erneut Verarbeiten Von Aktionen Auswahlliste.
   {#t_ViewingOrderGuideFailures__ol_k2j_yff_mp}

