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


---

# OCRotationV2 -- Global

# OCRotationV2 -- Global {#ariaid-title1}

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

Die OCRotationV2 Skripteinbindung ist eine Erweiterung von OCRotation Skripteinbindung, die von Fullendar.io und dem DHTMLX-Rufbereitschaftskalender verwendet wird.

Verwenden Sie diese Skripteinbindung, um die Zeitplanspanne zwischen zwei Daten abzurufen, die weiter nach Gruppen, Rotationen, Dienstplänen und Anwendern gefiltert wird. Sie können auch erweitern OCRotationV2 Zum Hinzufügen oder Ändern des Verhaltens. Dies ist Teil der Bereitschaftsplanung.

## OCRotationV2 -- getGroups() {#ariaid-title2}

Gibt ein Array von Gruppen zurück, die aktive Rotationen haben.
{#r_OCRotationV2-getGroups__table_ozg_nlb_h5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#r_OCRotationV2-getGroups__table_ozg_nlb_h5} {#r_OCRotationV2-getGroups__table_pzg_nlb_h5__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Gruppenobjekten. Jedes enthält die folgenden Attribute: * sys_ID des Datensatzes „sys_user_Group" * Name des Datensatzes „sys_user_Group" {#r_OCRotationV2-getGroups__ul_brf_31x_55} |
[Tabelle : 2. Rückgaben]

{#r_OCRotationV2-getGroups__table_pzg_nlb_h5}

## OCRotationV2 -- getRostersByRotas(Zeichenfolge rotaSysIds) {#ariaid-title3}

Gibt ein Array aktiver Dienstpläne für eine bestimmte Rotationsplan-ID zurück.
{#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| RotaSysIds | Zeichenfolge | Kommagetrennte Liste von sys_ID-Rotationswerten (cmn_Rotationsplan). |
[Tabelle : 3. Parameter]

{#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5} {#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Rotationsobjekten. Jedes enthält die folgenden Attribute: * sys_ID des Datensatzes „cmn_Rota_Roster" * Name des Datensatzes „cmn_Rota_Roster" * rota sys_ID des cmn_Rota-Datensatzes {#r_OCRotationV2-getRostersByRotas_String__ul_svs_y1x_55} |
[Tabelle : 4. Rückgaben]

{#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5}

## OCRotationV2 -- getRotasByGroup(Zeichenfolge groupSysIds) {#ariaid-title4}

Gibt ein Array aktiver Rotationen für eine bestimmte Gruppen-ID zurück.
{#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| groupSysIds | Zeichenfolge | Kommagetrennte Liste von Gruppen-sys_ID-Werten (sys_user_Group). |
[Tabelle : 5. Parameter]

{#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5} {#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Rotationsobjekten. Jedes enthält die folgenden Attribute: * sys_ID des cmn_Rota-Datensatzes * Name des Datensatzes „cmn_Rota" * Gruppen-sys_ID des Datensatzes „sys_user_Group" {#r_OCRotationV2-getRotasByGroup_String__ul_plv_p1x_55} |
[Tabelle : 6. Rückgaben]

{#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5}

## OCRotationV2 -- getSpans() {#ariaid-title5}

Ruft die Spannen vom angegebenen Startdatum bis zum angegebenen Enddatum ab. Wenn keine Start- und Enddaten angegeben sind, wird das Startdatum standardmäßig auf einen Monat vor und das Enddatum standardmäßig auf einen Monat nach der aktuellen Uhrzeit festgelegt. Sie können auch die Gruppen-IDs, Rotationsplan-IDs, Dienstplan-IDs und Anwender-IDs verwenden, um die Bereiche weiter zu filtern.
{#r_OCRotationV2-getSpans__table_j24_jlb_h5__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 7. Parameter]

{#r_OCRotationV2-getSpans__table_j24_jlb_h5} {#r_OCRotationV2-getSpans__table_k24_jlb_h5__entry__2}

| Typ | Beschreibung |
|-|-|
| Array | Ein Array von Bereichen. Jedes enthält die folgenden Attribute: id, sys_ID, table, rota_ID, roster_ID, User_ID, Text, Beschreibung, Farbe, textColor, Start_date, end_date. |
[Tabelle : 8. Rückgaben]

{#r_OCRotationV2-getSpans__table_k24_jlb_h5}  
Ruft alle Bereiche für den Standardzeitraum ab

    var spans = new OCRotationV2().getSpans();
    var firstSpanStartDate = spans[0].start_date; // get the first span's start date

Ruft alle Spannen zwischen dem 1. April 2014 und dem 5. Juni 2014 ab

    var spans = new OCRotationV2()
        .setStartDate("2014-04-01")
        .setEndDate("2014-06-05")
        .getSpans();

Rufen Sie die Bereiche der Netzwerkgruppe für den Standardzeitraum ab

    var spans = new OCRotationV2()
         .setGroupIds("287ebd7da9fe198100f92cc8d1d2154e")
         .getSpans();

Rufen Sie die Spannen des ITIL-Anwenders zwischen dem 1. Januar 2014 und dem 31. Januar 2014 ab

    var spans = new OCRotationV2()
        .setStartDate("2014-01-01")
        .setEndDate("2014-01-31")
        .setUserIds("681b365ec0a80164000fb0b05854a0cd")
        .getSpans();


