---
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


---

# Nützliche Zeitplanungsskripts

# Nützliche Zeitplanungsskripts {#ariaid-title1}

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

Ein Business-Regel-Skript gibt die Aktionen an, die die Business-Regel ausführt. Skripts enthalten häufig vordefinierte globale Variablen, um auf Elemente in Ihrem System zu verweisen, z. B. den aktuellen Datensatz. Globale Variablen sind für alle Business-Regeln verfügbar.  
Warnung:  
Die hier beschriebene Anpassung wurde für die Verwendung in bestimmten Instanzen entwickelt und wird von nicht unterstützt Now Support. Diese Methode wird unverändert bereitgestellt und sollte vor der Implementierung gründlich getestet werden. Veröffentlichen Sie alle Fragen und Kommentare zu dieser Anpassung in unserer Community [Forum](http://community.service-now.com/).

## Berechnen Sie die Dauer anhand eines Zeitplans {#c_UsefulSchedulingScripts__section_iwg_tky_k1c}

Typ: Vor dem Aktualisieren/Einfügen der Business-Regel.

Beschreibung: Eine Geschäftsdauer berechnet die Dauer von offen bis geschlossen für einen Incident basierend auf dem bestimmten [Zeitpläne werden erstellt und verwendet](https://www.servicenow.com/docs/access?context=c_UseSchedules&version=yokohama&pubname=yokohama-platform-administration&ft:locale=en-US). Wenn kein Zeitplan angegeben ist, verwendet das Skript einfach den ersten Zeitplan, der von der Abfrage zurückgegeben wird.

Skriptbeispiel:  
Das folgende Beispiel legt die Dauer der Lösung fest, wenn der Incident-Status in „gelöst" wechselt.

    var gr_rec = new GlideRecord('incident');
    gr_rec.get('ed92e8d173d023002728660c4cf6a7bc');
    if (gr_rec.incident_state == 6) {
    var dur = calcDurationSchedule(gr_rec.opened_at, gr_rec.sys_updated_on);
    }
     
    function calcDurationSchedule(start, end){ 
      // Get the user   
      var usr = new GlideRecord('sys_user');
      usr.get(gs.getUserID());
      // Create schedule - pass in the sys_id of your standard work day schedule and pass in the users timezone
      var sched = new GlideSchedule('08fcd0830a0a0b2600079f56b1adb9ae',usr.time_zone);
      // Get duration based on schedule/timezone 
      return(sched.duration(start.getGlideObject(), end.getGlideObject()));
    }

## Überprüfen Sie die bevorstehenden Kündigungsdaten {#c_UsefulSchedulingScripts__section_i1b_cly_k1c}

Typ: Geplantes Skript.

Beschreibung: Dieses Skript überprüft jede Nacht nach Kündigungsdaten für Verträge, die in 90, 50 oder 10 Tagen anstehen (abhängig vom Feld „Vertragsdauer").

Skriptbeispiel:  

    function contractNoticeDue(){
      var now_GR = new GlideRecord("contract");
      now_GR.addQuery("u_contract_status","Active");
      now_GR.query();
      while(now_GR.next()){
        if((now_GR.u_termination_date<= gs.daysAgo(-90))&&(now_GR.u_contract_duration=="Long")){
          now_GR.u_contract_status="In review";}
        elseif((now_GR.u_termination_date<= gs.daysAgo(-50))&&(now_GR.u_contract_duration=="Medium")){
          now_GR.u_contract_status="In review";}
        elseif((now_GR.u_termination_date <= gs.daysAgo(-10))&&(now_GR.u_contract_duration=="Short")){
          now_GR.u_contract_status="In review";}
        now_GR.update();
      }
    }

Verwenden Sie Skripts in Business-Regeln, um allgemeine Aufgaben auszuführen, z. B.:

* Zwei Datumsfelder werden verglichen.
* XML-Nutzlasten werden analysiert.
* Eine Datenbankaktion in einer Business-Regel wird abgebrochen.
{#c_UsefulSchedulingScripts__ul_t24_4jm_jq}  
Mit Skripts können Sie auch:

* Geben Sie den Vorgang an, der die Business-Regel auslöst.
* Verwenden Sie das Scratchpad mit Business-Anzeigeregeln, um Formularwerte zu ändern, bevor ein Anwender das Formular lädt.
* Verwenden Sie die ODER-Bedingung wie in einem Bedingungsgenerator.
{#c_UsefulSchedulingScripts__ul_rn2_wjm_jq}

Sie können auch die Skripting-Funktionalität des Systems verwenden, die für serverseitige Skripts verfügbar ist.

Sie können Optionen im Formular „Business-Regeln" verwenden, um Bedingungen zu erstellen, Feldwerte festzulegen und Warnungsnachrichten anzuzeigen, ohne ein Skript schreiben zu müssen.

## Bricht eine Datenbankaktion in einer Business-Regel ab {#ariaid-title2}

Während eines vor-Business-Regel-Skripts können Sie die aktuelle Datenbankaktion mit der Methode current.setAbortAction(true) abbrechen oder abbrechen.

Beispiel: Wenn die Business-Regel „vor" während einer Einfügeaktion ausgeführt wird und Sie eine Bedingung im Skript haben, die aufruft current.setAbortAction(true) wird der neue Datensatz, der im aktuellen Verzeichnis gespeichert ist, nicht in der Datenbank erstellt.

## Fügen Sie die Funktion zum automatischen Ausfüllen hinzu {#ariaid-title3}

Die Funktion „automatisches Ausfüllen hinzufügen" wird auch als Incident-Vorlage, automatische Zuweisungen, Schnellaufrufe, Anrufskript oder automatisches Ausfüllen bezeichnet.

Nehmen wir an, Sie möchten automatisch ausfüllen Kurzbeschreibung Basierend auf Unterkategorie Ausgewählt. Erstellen Sie zuerst eine Suchtabelle, und füllen Sie dann in diesem Fall das Schlüsselfeld aus Unterkategorie Und das automatisch ausgefüllte Feld, Kurzbeschreibung . Nehmen wir an, Ihre Tabelle hatte einen Datensatz mit Unterkategorie = Passwort Und Kurzbeschreibung = Passwortzurücksetzung . Wenn der Anwender die Unterkategorie von auswählt Passwort Im Formular „Incident" sucht ein Client-Skript nach dem übereinstimmenden Datensatz und legt die Kurzbeschreibung auf gleich fest Passwortzurücksetzung . Client-Skripteinstellungen... Typ = OnChange , Tabellenname = Incident , Feldname = Unterkategorie .  

    function onChange(control, oldValue, newValue, isLoading) { 
      if (isLoading) { return; } 
      var newrec = gel('sys_row');
      //Check if new record
      if (newrec.value == -1) { 
        var lookup = new GlideRecord('u_short_desc_lookup'); 
        lookup.addQuery('u_subcategory', g_form.getValue('subcategory'));
        lookup.query();
        var temp; //temp var - reusable
        if (lookup.next()) {
          temp = lookup.u_short_description;
            if (null != temp) { //Set the form value from lookup if there is a lookup value
              g_form.setValue('short_description', temp); } 
            else {
              g_form.setValue('short_description', "" ); } } 
       else { 
         //If a lookup record does not exist based on lookup.addQuery 
         //Then set to UNDEFINED or NULL depending on type
          g_form.setValue('short_description', ""); } }
     
     }

Sie können viele Felder ausfüllen oder sogar Anrufskriptfragen in abrufen Kommentare Feld, damit Callcenter-Mitarbeiter gute Informationen sammeln und sie an einen Techniker weitergeben können. Es sind bereits Zuweisungsregeln, Vorlagen und Assistenten integriert, die ähnliche Funktionen ausführen.

## Beispielskript: Eine standardmäßige Business-Regel vor der Abfrage {#ariaid-title4}

Sie können eine Abfrage-Business-Regel verwenden, die vor der Datenbankabfrage ausgeführt wird, um zu verhindern, dass Anwender auf bestimmte Datensätze zugreifen.  
Warnung:  
Die hier beschriebene Anpassung wurde für die Verwendung in bestimmten Instanzen entwickelt und wird von nicht unterstützt Now Support. Diese Methode wird unverändert bereitgestellt und sollte vor der Implementierung gründlich getestet werden. Veröffentlichen Sie alle Fragen und Kommentare zu dieser Anpassung in unserer Community [Forum](http://community.service-now.com/).

Betrachten Sie das folgende Beispiel aus einer standardmäßigen Business-Regel, die den Zugriff auf Incident-Datensätze beschränkt.  
{#c_ExScptDftBfrQryBsnRu__table_jfv_wym_jq__entry__3}

| Name | Tabelle | Wann |
|-|-|-|
| Incident-Abfrage | Incident | Vor, Abfrage |
[Tabelle : 1. Die standardmäßige Business-Regel beschränkt den Zugriff auf Incident-Datensätze]

{#c_ExScptDftBfrQryBsnRu__table_jfv_wym_jq}

**Beispielskript**  
Dieses Beispiel verhindert, dass Anwender auf Incident-Datensätze zugreifen, es sei denn, sie verfügen über die itil-Rolle, die in aufgeführt ist Anrufer Oder Geöffnet von Feld. Wenn Selfservice-Anwender beispielsweise eine Liste von Incidents öffnen, können sie nur die von ihnen übermittelten Incidents sehen.

    if(!gs.hasRole("itil")&& gs.isInteractive()){
      var u = gs.getUserID();
      var qc = current.addQuery("caller_id", u).addOrCondition("opened_by", u).addOrCondition("watch_list","CONTAINS", u);
      gs.print("query restricted to user: "+ u);}

Hinweis:  
Sie können auch verwenden Zugriffssteuerungen, um die Datensätze einzuschränken, die Anwender sehen können.

**Zeitplanskript für Wochentage**

Typ: Business-Regeln/Clientskripts.  
Dieses Skript plant das Skript für Wochentage. Fügen Sie ein beliebiges Skript an der Stelle ein, in der „Ihr Skript hier" steht.

    var go ='false';
    var now =new Date(); 
     
    // Correct time zone, which is by default GMT -7 
    now.setHours(now.getHours()+8);
    var day = now.getDay(); 
     
    // No go on Saturday or Sunday 
    if(day !=0&& day !=6){
     
    // (your script here)
     
    }

**Legen Sie das Datumsfeld gemäß dem aktuellen Datum fest**  
Dieses Skript legt ein Datumsfeld abhängig vom aktuellen Wochentag fest. Wenn in diesem Beispiel der Tag Montag bis Mittwoch ist, wird das Datum auf diesen kommenden Montag festgelegt. Andernfalls wird das Datumsfeld auf den nächsten Montag festgelegt.

    function setCabDate(){
    var today =new Date();
    var thisDay = today.getDay();
    //returns 0 for Sunday, 1 for Monday, etc. thru 6 for Saturday.
    var thisMon =new GlideDateTime();
    thisMon.setDisplayValue(gs.beginningOfThisWeek());
    var nextMon = thisMon.getNumericValue();
    nextMon +=(1000*60*60*24*7);
     
    if((thisDay <4)&&(thisDay >0))
      //if today is Mon thru Wed (thisDay = 1, 2, or 3), set cab to this coming Monday.
      current.u_req_cab_rev_date.setDateNumericValue(thisMon.getNumericValue());
    elseif((thisDay >=4)||(thisDay ==0))
      //if today is Thurs thru Sun (thisDay = 4, 5, 6, or 0), set cab to next Monday.
      current.u_req_cab_rev_date.setDateNumericValue(nextMon);
    }

Um die Eingabe aller Datums-/Uhrzeitfelder zu validieren, können Sie Folgendes in einem Validierungsskript verwenden (SystemdefinitionValidierungsskripts) an. Da das Datums-/Uhrzeitformat in diesem Skript hartcodiert ist, muss es dem Datums-/Uhrzeitformat Ihrer Instanz entsprechen. Wenn sich das Datums-/Uhrzeitformat Ihrer Instanz ändert, müssen Sie Ihr Validierungsskript aktualisieren.  
Legen Sie den Typ des Validierungsskripts auf fest Datum/Uhrzeit . Wenn ein Anwender dann mit diesem Validierungsskript ein falsches Format in ein Datums-/Uhrzeitfeld eingibt, erhält er eine Fehlermeldung.

    function validate(value){
    // empty fields are still valid dates 
    if(!value)returntrue; 
     
    // We "should" have the global date format defined always defined. but there's always that edge case... 
    if(typeof g_user_date_time_format !=='undefined')return isDate(value, g_user_date_time_format); 
     
    // if we don't have that defined, we can always try guessing 
    return parseDate(value)!==null;}

Abbildung : 1. Validierung von Datum/Uhrzeit

