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


---

# Implementierung einer relativen Dauer

# Implementierung einer relativen Dauer {#ariaid-title1}

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

Sie können eine relative Dauer implementieren, indem Sie die Tabelle „cmn_relative_duration" und erstellen Dauerrechner Skripteinbindung.

## Vorbereitungen

Erforderliche Rolle: Administrator

## Prozedur

1. Erstellen Sie die Tabelle „cmn_relative_duration".
2. Erstellen Sie die Skripteinbindung des DurationCalculators.
3. Erstellen Sie einen Beispieleintrag für die relative Dauer (z. B. „Nächster Geschäftstag bis 16:00 Uhr").
4. Fügen Sie die erforderlichen Felder zu SLA-Tabellen hinzu, um relative dauern zu unterstützen.
5. Ändern Sie die Berechnung der Dauer für SLAs.
6. Ändern Sie die Berechnung des SLAs-Prozentsatzes für SLAs (muss „work_seconds" verwenden).
7. Fügen Sie Zeitplanfelder zum Workflow hinzu: Zeitplan und Zeitzone (ausgewählt basierend auf dem Feld aus der Workflow-Tabelle).
8. Fügen Sie der Aktivität „Workflow-Aufgabe" Felder für die Dauer hinzu.
9. Implementieren Sie das Skript zur Berechnung der Dauer für die Aufgabenaktivität.

## Die Tabelle „relative Dauer" und die Methoden „DurationCalculator" {#ariaid-title2}

Die Tabelle „cmn_relative_duration" unterstützt die Definition eines Fälligkeitsdatums als Zeitdauer oder relative Dauer.

Diese Tabelle besteht aus zwei Feldern: „Name" und „Skript". Das Feld „Skript" enthält das Berechnungsskript für die relative Dauer. Dieses Skript enthält die Variable „Rechner", die zur Berechnung des Fälligkeitsdatums verwendet wird.

Die Skripteinbindung des DurationCalculators kann verwendet werden, um die Dauerberechnungen durchzuführen. Die folgenden Methoden sind in dieser Skripteinbindung verfügbar.  
{#c_RelDurTblCalc__table_vbs_swt_1q__entry__2}

| Methode | Beschreibung |
|-|-|
| SetSchedule(Zeichenfolge schedID, \[Zeichenfolgenzeitzone\]) | Legt den Zeitplan und die Zeitzone fest, die für die Berechnung des Fälligkeitsdatums verwendet werden sollen. |
| SetStartDateTime (GlideDateTime Start) | Legt die Startzeit für die Berechnungen der Dauer fest. Wenn „Start" leer ist, wird das aktuelle Datum/die aktuelle Uhrzeit verwendet. |
| CalcDuration (int Sekunden) | Berechnet das Enddatum und die Endzeit. Nach Abschluss werden die Eigenschaften „this.endDateTime" und „this.seconds festgelegt, um die Ergebnisse der Berechnung anzugeben. |
| CalcRelativeDuration(Zeichenfolge relativeDurationID) | Berechnet die Dauer anhand des angegebenen Skripts für relative Dauer. Nach Abschluss werden die Eigenschaften „this.endDateTime" und „this.seconds festgelegt, um die Ergebnisse der Berechnung anzugeben. |
| GetEndDateTime() | Ruft die Eigenschaft „this.endDateTime" ab, die von „calcDuration"/„calcRelativeDuration" festgelegt wurde und das Enddatum und die Endzeit für die Dauer angibt. |
| GetSeconds() | Ruft die Eigenschaft „this.seconds ab, die von „calcDuration"/„calcRelativeDuration" festgelegt wurde und die Gesamtzahl der Sekunden der Arbeit angibt, die für die Dauer ausgeführt werden soll. Hinweis: Dies ist die Gesamtarbeitszeit, nicht die Gesamtzeit zwischen Start- und Endzeiten und kann verwendet werden, um Prozentsätze der Arbeitszeit zu bestimmen |
| GetTotalSeconds() | Ruft die Eigenschaft „this.totalSeconds" ab, die von „calcDuration"/„calcRelativeDuration" festgelegt wurde und die Gesamtzahl der Sekunden zwischen den Start- und Endzeiten der Dauer angibt. |
[Tabelle : 1. DurationCalculator -- Skripteinbindungstabelle]

{#c_RelDurTblCalc__table_vbs_swt_1q}

Die folgenden Funktionen werden in Skripts der relativen Dauer verwendet:  
{#c_RelDurTblCalc__table_ahm_gd5_1q__entry__2}

| Funktion | Beschreibung |
|-|-|
| boolescher wert isAfter (GlideDateTime dt, Zeichenfolgenzeit) | Liegt „Uhrzeit" des Tages nach der durch „dt" angegebenen Uhrzeit? dt, wenn leer, wird das aktuelle Datum/die aktuelle Uhrzeit verwendet. Die Zeit wird im 24-Stunden-Format in „hh:mm:ss" angegeben. |
| CalcRelativeDueDate(GlideDateTime Start, int Tage, Zeichenfolgenendzeit) | Berechnet das Fälligkeitsdatum, das bei „Start" beginnt und „Tage" mithilfe des Zeitplans und der Zeitzone hinzufügt. Wenn wir den Tag finden, an dem die Arbeit fällig ist, legen Sie die Zeit auf „Endzeit" dieses Tages fest. Nach Abschluss werden die Eigenschaften „this.endDateTime" und „this.seconds festgelegt, um die Ergebnisse der Berechnung anzugeben. Wenn „endTime" leer ist, verwenden Sie das Ende des Endarbeitstags. |
[Tabelle : 2. Skriptfunktionen für relative Dauer]

{#c_RelDurTblCalc__table_ahm_gd5_1q}

