---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# OCRotationV2 - Global

# OCRotationV2 - Global {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

L'include de script OCRotationV2 est une extension de l'include de script OCRotation , qui est utilisé par Fullcalendar.io et le calendrier d'astreinte DHTMLX.

Utilisez cet include de script pour obtenir l'intervalle de temps du calendrier entre deux dates filtrées par groupes, rotations, listes et utilisateurs. Vous pouvez également étendre OCRotationV2 pour ajouter ou modifier un comportement. Cela fait partie de la planification d'astreinte.

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

Renvoie un tableau des groupes qui ont des rotations actives.
{#r_OCRotationV2-getGroups__table_ozg_nlb_h5__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau d'objets de groupe. Chacun contient les attributs suivants : * sys_id de l'enregistrement de sys_user_group * Nom de l'enregistrement de sys_user_group {#r_OCRotationV2-getGroups__ul_brf_31x_55} |
[Tableau 2. Renvoie]

{#r_OCRotationV2-getGroups__table_pzg_nlb_h5}

## OCRotationV2 : getRostersByRotas(chaîne rotaSysIds) {#ariaid-title3}

Renvoie un tableau des listes actives pour un ID de rotation donné.
{#r_OCRotationV2-getRostersByRotas_String__table_y14_1mb_h5__entry__3}

| Nom | Type | Description |
|-|-|-|
| rotaSysIds | Chaîne | Liste séparée par des virgules de valeurs de sys_id de rotation (cmn_rota). |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau d'objets de rotation. Chacun contient les attributs suivants : * sys_id de l'enregistrement de cmn_rota_roster * Nom de l'enregistrement de cmn_rota_roster * sys_id de rotation de l'enregistrement de cmn_rota {#r_OCRotationV2-getRostersByRotas_String__ul_svs_y1x_55} |
[Tableau 4. Renvoie]

{#r_OCRotationV2-getRostersByRotas_String__table_z14_1mb_h5}

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

Renvoie un tableau de rotations actives pour un ID de groupe donné.
{#r_OCRotationV2-getRotasByGroup_String__table_jcg_xlb_h5__entry__3}

| Nom | Type | Description |
|-|-|-|
| groupSysIds | Chaîne | Liste séparée par des virgules de valeurs de sys_id de groupe (sys_user_group). |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Tableau d'objets de rotation. Chacun contient les attributs suivants : * sys_id de l'enregistrement de cmn_rota * Nom de l'enregistrement de cmn_rota * sys_id de groupe de l'enregistrement de sys_user_group {#r_OCRotationV2-getRotasByGroup_String__ul_plv_p1x_55} |
[Tableau 6. Renvoie]

{#r_OCRotationV2-getRotasByGroup_String__table_kcg_xlb_h5}

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

Obtenez les parcours entre la date de début spécifiée et la date de fin spécifiée. Si aucune date de début et de fin n'est fournie, la date de début est par défaut un mois avant et la date de fin par défaut est un mois après l'heure actuelle. Vous pouvez également utiliser les ID de groupes, les ID de rotation, les ID de listes, les ID d'utilisateurs pour filtrer davantage les parcours.
{#r_OCRotationV2-getSpans__table_j24_jlb_h5__entry__3}

| Nom | Type | Description |
|-|-|-|
| Aucun |   |   |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| Tableau | Un tableau de travées. Chacun contient les attributs suivants : id, sys_id, table, rota_id, roster_id, user_id, texte, description, couleur, textColor, start_date, end_date. |
[Tableau 8. Renvoie]

{#r_OCRotationV2-getSpans__table_k24_jlb_h5}  
Obtenir tous les parcours pour la période par défaut

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

Obtenez toutes les travées entre le 1er avril 2014 et le 5 juin 2014

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

Obtenir les étendues du groupe de réseaux pour la période par défaut

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

Obtenir les parcours des utilisateurs ITIL entre le 1er janvier 2014 et le 31 janvier 2014

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