---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OCRotationV2 : Global

# OCRotationV2 : Global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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

Verwenden Sie diese Skripteinbindung, um die Zeitplan-Zeitspanne zwischen zwei Daten abzurufen, die weiter nach Gruppen, Rotationsplänen, Dienstplänen und Benutzern gefiltert werden. Sie können OCRotationV2 auch erweitern, um Verhalten hinzuzufügen oder zu ändern. Dies ist Teil der Rufbereitschaft.

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

Gibt ein Array von Gruppen zurück, die über aktive Rotationspläne verfügen.
{#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 of the sys_user_group record * Name des sys_user_group-Datensatzes {#r_OCRotationV2-getGroups__ul_brf_31x_55} |
[Tabelle : 2. Ergebnisse]

{#r_OCRotationV2-getGroups__table_pzg_nlb_h5}

## OCRotationV2 -- getRostersByRotas(String 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 der Rotationsplan-sys_id-Werte (cmn_rota). |
[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 Rotationsplan-Objekten. Jedes enthält die folgenden Attribute: * sys_id des cmn_rota_roster-Datensatzes * Name des cmn_rota_roster-Datensatzes * Rotationsplan-sys_id des cmn_rota-Datensatzes {#r_OCRotationV2-getRostersByRotas_String__ul_svs_y1x_55} |
[Tabelle : 4. Ergebnisse]

{#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5}

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

Gibt ein Array aktiver Rotationspläne 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 der Gruppen-sys_id-Werte (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 Rotationsplan-Objekten. Jedes enthält die folgenden Attribute: * sys_id des cmn_rota-Datensatzes * Name des cmn_rota-Datensatzes * Gruppen-sys_id des sys_user_group-Datensatzes {#r_OCRotationV2-getRotasByGroup_String__ul_plv_p1x_55} |
[Tabelle : 6. Ergebnisse]

{#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5}

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

Liefert die Spannen vom angegebenen Startdatum bis zum angegebenen Enddatum. Wenn kein Start- und Enddatum angegeben ist, wird standardmäßig ein Monat vor dem Startdatum und ein Enddatum einen Monat nach der aktuellen Uhrzeit angezeigt. Sie können auch die Gruppen-IDs, Rotationsplan-IDs, Dienstplan-IDs und Benutzer-IDs verwenden, um die Spannen 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 | Eine Reihe von Arrays. Jede enthält die folgenden Attribute: id, sys_id, table, rota_id, roster_id, user_id, text, description, color, textColor, start_date, end_date. |
[Tabelle : 8. Ergebnisse]

{#r_OCRotationV2-getSpans__table_k24_jlb_h5}  
Ruft alle Spannen 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();

Ruft die Spannen der Netzwerkgruppe für den Standardzeitraum ab

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

Ruft die Spannen des ITIL-Benutzers 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();