API de recherche WSD

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 54 minutes de lecture

    • L’API Prestation de services de lieu de travailde recherche (WSD) fournit des points de terminaison permettant de rechercher des emplacements et des éléments de lieu de travail disponibles, tels que des réservables, des modules réservables et des équipes disponibles.

    Pour accéder à cette API, l’appelant doit disposer du rôle sn_wsd_core.workplace_user et les modules d’extension Workplace Safety Management (sn_wsd_core) et Workplace Reservation Management (sn_wsd_rsv) doivent être activés.

    Cette API s’exécute dans l’espace de noms sn_wsd_rsv .

    Pour plus d’informations sur Gestion des réservations du lieu de travail, voir Gestion des réservations du lieu de travail.

    Recherche WSD : GET /api/sn_wsd_rsv/search/availability

    Vérifie si les réservables spécifiés sont disponibles pour les heures spécifiées.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/availability

    URL par défaut : /api/sn_wsd_rsv/search/availability

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 1. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 2. Paramètres de requête
    Nom Description
    fin Requis. Heure de fin à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être postérieure à la valeur spécifiée dans le start paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    include_reservations_within_days Marqueur indiquant s’il faut renvoyer tous les créneaux libres d’heures disponibles dans la réponse pour chaque réservable pour toute la journée.
    Valeurs valides :
    • vrai : renvoyer tous les emplacements libres.
    • faux : Ne retournez pas tous les emplacements libres.

    Type de données : booléennes

    Valeur par défaut : false
    reservable_ids Requis. Liste séparée par des virgules des sys_ids réservables dont la disponibilité doit être évaluée.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    reservation_ids Liste séparée par des virgules des sys_ids de réservation existants. Transmettez ce paramètre si vous souhaitez modifier les réservations associées.

    Le temps bloqué pour ces sys_ids pour les réservables correspondants est traité comme disponible.

    Type de données : chaîne

    Par défaut : aucun

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    reservable_module Requis. Sys_id du module réservable à inclure dans la recherche. Un module réservable regroupe des types similaires d’éléments du lieu de travail.

    Type de données : chaîne

    Table : module réservable [sn_wsd_rsv_reservable_module]
    schedule_view_obj Détails sur la vue de calendrier à renvoyer. Transmettez cet objet si vous avez besoin de données de disponibilité 24 heures sur 24 pour les réservations qui s’étendent sur plus d’une journée. Les résultats de retour ne contiendront que les heures disponibles et les réservations pour la date spécifiée.

    Pour que cette fonctionnalité fonctionne correctement, les paramètres ignore_same_day_validation et include_reservations_within_days doivent être définis sur vrai.

    Type de données : objet

    "schedule_view_obj": {
  "schedule_view_date": "String",
  "timezone": "String"
}
    schedule_view_obj.schedule_view_date Date pour laquelle commencer à renvoyer la disponibilité de la réservation. Cette date doit se trouver dans le fuseau horaire spécifié dans le schedule_view_obj.timezone paramètre.

    Type de données : chaîne

    Format : AAAA-MM-JJ
    schedule_view_obj.fuseau horaire Fuseau horaire du bâtiment à utiliser pour déterminer les données de disponibilité de la réservation à renvoyer. Par exemple : États-Unis/Pacifique.

    Type de données : chaîne
    Période de travail Requis si les modules réservables spécifiés sont basés sur une équipe.
    Sys_id de l’équipe à associer à la réservation. Si ce paramètre est transmis, il end n’est pas obligatoire.

    Pour plus d’informations sur les réservations basées sur des équipes, consultez Activer la réservation basée sur des équipes.

    Type de données : chaîne

    Table : Équipe [sn_wsd_core_shift]
    début Requis. Heure de début à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être antérieure à la valeur spécifiée dans le end paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    Tableau 3. Paramètres du corps de la demande
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 4. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml.

    Valeur par défaut : application/json
    Tableau 5. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 6. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse

    Nom Description
    résultat Liste de tous les éléments disponibles pour les périodes spécifiées.

    Type de données : tableau d’objets

    "result": [
  {
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "email": "String",
    "floor": {Object},
    "is_available": Boolean,
    "name": "String",
    "reservations": [Array],
    "sys_id": "String"
  }
]
    résultat.délaisdisponibles Liste des dates/heures auxquelles le réservable associé est disponible.

    Type de données : tableau
    résultat.bâtiment Détails sur le bâtiment associé au réservable.

    Type de données : objet

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne
    result.building.name Nom du bâtiment.

    Type de données : chaîne
    result.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne
    résultat.campus Détails sur le campus associé au réservable.

    Type de données : objet

    "campus": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.campus.display_value Numéro d’affichage du campus sur lequel se trouve le réservable, par exemple East Bay.

    Type de données : chaîne
    result.campus.name Nom du campus.

    Type de données : chaîne
    result.campus.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Campus [sn_wsd_core_campus]
    result.email Adresse e-mail du réservable associé.

    Type de données : chaîne
    résultat.étage Détails sur l’étage associé au réservable.

    Type de données : objet

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.floor.name Nom de l’étage auquel le réservable réside.

    Type de données : chaîne
    result.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    result.is_available Marqueur indiquant si le réservable est disponible à la réservation.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : non disponible pour réservation.

    Type de données : booléennes
    result.name Nom du réservable.

    Type de données : chaîne
    résultat.réservations Détails sur la réservation associée.

    Type de données : tableau d’objets

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservations.configuration_item Éléments de configuration correspondant à la réservation.

    Type de données : chaîne

    Table : Élément de configuration [cmdb_ci]
    résultat.réservations.fin Date et heure de fin de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    result.reservations.is_collided Marqueur indiquant si la réservation entre en conflit avec les heures de début et de fin de la recherche.

    Cela indique que l’emplacement réservable associé est déjà réservé pour l’intervalle de temps de recherche spécifié.

    Valeurs possibles :
    • true : Collision.
    • faux : Pas de collision.

    Type de données : booléennes
    résultat.réservations.emplacement Détails sur l’emplacement de la réservation.

    Type de données : objet

    "location": {
  "location": "String",
  "timezone": {Object}
}
    résultat.réservations.emplacement.emplacement Sys_id de l’enregistrement de l’emplacement associé.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    résultat.réservations.emplacement.fuseau horaire Détails sur le fuseau horaire associé à l’emplacement.

    Type de données : objet

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservations.location.timezone.displayValue Valeur d’affichage pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.réservations.emplacement.fuseauhoraire.valeur Valeur interne pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.réservations.nombre Numéro de réservation.

    Type de données : chaîne
    result.reservations.requested_for Détails sur la personne au nom de laquelle la réservation a été demandée.

    Type de données : objet

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservations.requested_for.name Nom de l’utilisateur pour lequel la réservation a été demandée.

    Type de données : chaîne
    result.reservations.requested_for.sys_id Sys_id de l’utilisateur pour lequel la réservation est demandée.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    result.reservations.reservation_purpose Détails sur l’objet de la réservation.

    Type de données : objet

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservations.reservation_purpose.display_value Valeur d’affichage pour l’objectif de la réservation, comme une réunion de la société.

    Type de données : chaîne
    result.reservations.reservation_purpose.valeur Valeur interne pour l’objet de la réservation, telle que company_meeting.

    Type de données : chaîne
    résultat.réservations.début Date et heure de début de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    résultat.réservations.état Détails sur l’état de la réservation pour l’emplacement.

    Type de données : objet

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservations.state.display_value Valeur d’affichage de l’état actuel de la réservation, par exemple confirmée.

    Type de données : chaîne
    résultat.réservations.état.valeur Valeur interne correspondant à l’état actuel de la réservation, par exemple 2.

    Type de données : chaîne
    résultat.réservations.objet Objet de la réservation.

    Type de données : chaîne
    result.reservations.sys_id Requis.
    Sys_id de l’enregistrement de la réservation.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]

    Demande cURL

    L’exemple de code suivant montre comment appeler ce point de terminaison. Remarque : Des sauts de ligne ont été ajoutés aux paramètres de requête pour faciliter la lecture.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability?
reservable_module=5db44502dbb650106c731dcd13961937&
start=2023-10-12T11:00:00Z&
end=2023-10-15T12:00:00Z&
reservable_ids=adb35f1977220110b3d7be377b5a99fc&
reservation_ids=undefined&
shift=undefined&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
timezone=Europe/Paris&
include_reservations_within_days=true&
ignore_same_day_validation=true&
include_unavailable_items=true"  \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    Renvoyer les résultats :

    {
  "result": [
    {
      "sys_id": "fe1f744edb7650106c731dcd139619ca",
      "email": null,
      "name": "Aspen",
      "is_available": true,
      "availableTimes": [
        [
          "2022-04-23 07:00:00",
          "2022-04-23 08:30:00"
        ],
        [
          "2022-04-23 09:30:00",
          "2022-04-23 23:00:00"
        ],
        [
          "2022-04-24 00:00:00",
          "2022-04-24 06:59:59"
        ]
      ],
      "floor": {
        "sys_id": "2f554296dbba10106c731dcd139619ed",
        "display_value": "Floor 2",
        "name": "Floor 2"
      },
      "building": {
        "sys_id": "94e264cedb3650106c731dcd13961919",
        "display_value": "CAL-B1",
        "name": "CAL-B1"
      },
      "campus": {
        "sys_id": "82b2a0cedb3650106c731dcd139619e9",
        "display_value": "California Campus",
        "name": "California Campus"
      },
      "reservations": [
        {
          "sys_id": "5fe65830874bc9106342b846dabb352b",
          "number": "WRES0001001",
          "location": {
            "location": "fe1f744edb7650106c731dcd139619ca",
            "timezone": {
              "value": "US/Pacific",
              "displayValue": "US/Pacific"
            }
          },
          "configuration_item": null,
          "start": "2022-04-23T08:30:00Z",
          "end": "2022-04-23T09:30:00Z",
          "subject": null,
          "reservation_purpose": {
            "value": "meeting",
            "display_value": "Meeting"
          },
          "state": {
            "value": "confirmed",
            "display_value": "Confirmed"
          },
          "is_collided": false,
          "requested_for": {
            "sys_id": "2de07e1887cb89106342b846dabb35fe",
            "name": "Workplace User"
          }
        }
      ]
    }
  ]
}

    Recherche WSD : GET /api/sn_wsd_rsv/search/best_match

    Recherche la meilleure correspondance d’élément réservable en fonction des critères de recherche fournis.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/best_match

    URL par défaut : /api/sn_wsd_rsv/search/best_match

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 7. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 8. Paramètres de requête
    Nom Description
    best_match_count Nombre de réservables les mieux adaptés à renvoyer.

    Type de données : nombre

    Valeur par défaut : 1
    fin Requis. Heure de fin à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être postérieure à la valeur spécifiée dans le start paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    include_reservable_purposes Marqueur indiquant s’il faut renvoyer l’objectif de la réservation de l’emplacement du lieu de travail pour chaque réservable dans les résultats de retour.
    Valeurs valides :
    • vrai : renvoyer les objectifs réservables.
    • faux : ne renvoyez pas les objectifs réservables.

    Type de données : booléennes

    Valeur par défaut : false

    Tableau : Objectif réservable [sn_wsd_rsv_reservable_purpose]
    include_reservations_within_days Marqueur indiquant s’il faut renvoyer tous les créneaux libres d’heures disponibles dans la réponse pour chaque réservable pour toute la journée.
    Valeurs valides :
    • vrai : renvoyer tous les emplacements libres.
    • faux : Ne retournez pas tous les emplacements libres.

    Type de données : booléennes

    Valeur par défaut : false
    include_standard_services Marqueur indiquant s’il faut renvoyer les informations sur les services standard dans la réponse. Ces informations se trouvent dans la table Service standard [sn_wsd_rsv_standard_service].

    Un service standard décrit les dispositions de base disponibles avec un élément de lieu de travail réservable lorsque la réservation est effectuée, telles que les tableaux blancs, les moniteurs supplémentaires et les services similaires. Pour plus d’informations sur les services standard, voir Services standard.

    Valeurs valides :
    • true : renvoie les informations sur les services standard.
    • false : ne renvoie pas les informations de services standard.

    Type de données : booléennes

    Valeur par défaut : false
    q Requis. Requête codée à utiliser pour filtrer les résultats de recherche renvoyés. Dans cette requête, vous devez spécifier le sys_id du bâtiment et des paramètres tels que l’étage, la surface, la capacité, les services standard et reservable_purposes.

    Tous les paramètres transmis doivent être sys_ids, à l’exception de la capacité, qui est un nombre.

    Par exemple : q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81

    Vous trouverez ces informations dans les tables suivantes :
    • Superficie : sn_wsd_core_area
    • Bâtiment : sn_wsd_core_building
    • Étage : sn_wsd_core_floor
    • Objectifs réservables : sn_wsd_rsv_reservable_purpose
    • Services standards : sn_wsd_rsv_standard_service

    Type de données : chaîne
    reservable_module Requis. Sys_id du module réservable à inclure dans la recherche. Un module réservable regroupe des types similaires d’éléments du lieu de travail.

    Type de données : chaîne

    Table : module réservable [sn_wsd_rsv_reservable_module]
    début Requis. Heure de début à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être antérieure à la valeur spécifiée dans le end paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    time_slot Sys_id d’un enregistrement de créneau horaire pour lequel nous essayons de rechercher le réservable le mieux adapté.

    Type de données : chaîne

    Par défaut : aucun

    Table : Créneau horaire [sn_wsd_rsv_time_slot]
    fuseau horaire Fuseau horaire préféré, par exemple Europe/Amsterdam.

    Type de données : chaîne

    Par défaut : aucun
    Tableau 9. Paramètres du corps de la demande
    En-tête Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 10. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 11. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 12. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse

    Nom Description
    résultat Renvoyer les résultats pour la meilleure correspondance réservable.

    Type de données : objet

    "result": { 
  "floorsOfSelectedBuilding": [Array],
  "hasMore": Boolean,
  "nextItemIndex": Number,
  "reservableContainers": [Array],
  "reservableUnits": [Array]
}
    result.floorsOfSelectedBuilding Détails sur les étages où se trouve le réservable.

    Type de données : tableau d’objets

    "floorsOfSelectedBuilding": [
  {
    "display_value": "String",
    "external_id": "String",
    "name": "String",
    "sys_id": "String"
  }
]
    result.floorsOfSelectedBuilding.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.floorsOfSelectedBuilding.external_id Identificateur externe de l’étage.

    Type de données : chaîne
    result.floorsOfSelectedBuilding.name Nom de l’étage auquel le réservable réside.

    Type de données : chaîne
    result.floorsOfSelectedBuilding.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    résultat.hasPlus Marqueur indiquant s’il existe plus de réservables dans les résultats de retour.
    Valeurs possibles :
    • vrai : plus de réservables disponibles.
    • false : plus aucun réservable disponible.

    Type de données : booléennes
    résultat.nextItemIndex Index pour le prochain enregistrement réservable à extraire. Utilisez cette valeur lors de la pagination dans les enregistrements réservables.

    Type de données : nombre
    result.reservableContainers Uniquement renvoyé pour les modules réservables dont le champ selection_type est défini sur Conteneur. Un conteneur est un regroupement d’éléments similaires, tel qu’un groupe de bureaux.

    Type de données : tableau d’objets

    "reservableContainers": [
  {
    "building": {Object},
    "campus": {Object},
    "capacity": Number,
    "display_value": "String",
    "floor": {Object},
    "image": {Object}
    "sys_id": "String"
  } 
]
    résultat.conteneursréservables.bâtiment Détails sur le bâtiment associé au conteneur réservable.

    Type de données : objet

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne
    result.reservableContainers.building.name Nom du bâtiment.

    Type de données : chaîne
    result.reservableContainers.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne
    résultat.conteneursréservables.campus
    Détails sur le campus sur lequel se trouve le réservable.

    Type de données : objet

    "campus": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}

    Table : Campus [sn_wsd_core_campus]
    result.reservableContainers.campus.display_value Numéro d’affichage du campus sur lequel se trouve le réservable, par exemple East Bay.

    Type de données : chaîne
    result.reservableContainers.campus.name Nom du campus.

    Type de données : chaîne
    result.reservableContainers.campus.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Campus [sn_wsd_core_campus]
    résultat.conteneursréservables.capacité Nombre maximum d’occupants pour le réservable.

    Type de données : nombre
    result.reservableContainers.display_value Valeur d’affichage pour le conteneur réservable.

    Type de données : chaîne
    résultat.conteneursréservables.étage Détails sur l’étage associé au conteneur réservable.

    Type de données : objet

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.reservableContainers.floor.name Nom de l’étage auquel le réservable réside.

    Type de données : chaîne
    result.reservableContainers.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    résultat.conteneursréservables.image Détails sur une image qui représente la mise en page du réservable associé.

    Type de données : objet

    "image": {
  "link": "String",
  "sys_id": "String"
}

    Tableau : Images [db_image]
    result.reservableContainers.image.link Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]
    result.reservableContainers.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne
    result.reservableContainers.sys_id Sys_id de l’enregistrement de conteneur associé.

    Type de données : chaîne

    Table : la table dans laquelle se trouve l’élément peut être configurée pour n’importe quel type de conteneur. Par défaut, il figure dans la table Zone [sn_wsd_core_area].
    résultat.unitésréservables Détails sur les unités réservables qui correspondent aux critères de recherche spécifiés. Une unité réservable est un seul élément réservable tel qu’un bureau ou une chaise.

    Type de données : tableau d’objets

    "reservableUnits": [
  {
    "area": "String",
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "capacity": "String",
    "defaultPrivacyValue": Boolean,
    "description": "String",
    "email": "String",
    "external_id": "String",
    "floor": {Object},
    "image": {Object},
    "includedInResult": Boolean,
    "is_available": Boolean,
    "is_favorite": Boolean,
    "is_reservable": "String",
    "is_reserved": Boolean,
    "is_selected": Boolean,
    "location_type": {Object},
    "name": "String",
    "number": "String",
    "order": "String",
    "require_approval": Boolean,
    "requires_check_in": Boolean,
    "reservable_quantity": "String",
    "showPrivacyOption": Boolean,
    "site": {Object},
    "standard_services": [Array],
    "tableName": "String",
    "title": "String",
    “reservable_purposes”: [Array],
    "reservations": [Array],
    "sys_id": "String"
  }
]
    résultat.unitésréservables.zone Détails sur la zone dans laquelle se trouve le module réservable.

    Type de données : objet

    "area": {
  "display_value": "String",
  "sys_id": "String"
}

    Tableau : Zone [sn_wsd_core_area]
    result.reservableUnits.area.display_value Valeur d’affichage de la zone de module réservable.

    Type de données : chaîne
    result.reservableUnits.area.sys_id Sys_id de l’enregistrement de zone associé au réservable.

    Type de données : chaîne
    résultat.unitésréservables.heuresdisponibles Liste des dates/heures auxquelles le réservable associé est disponible.

    Type de données : tableau
    résultat.unitésréservables.bâtiment Détails sur le bâtiment dans lequel se trouve le réservable.

    Type de données : objet

    "building": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Bâtiment [sn_wsd_core_building]
    result.reservableUnits.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne
    result.reservableUnits.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne
    résultat.unitésréservables.campus
    Détails sur le campus sur lequel se trouve le réservable.

    Type de données : objet

    "campus": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Campus [sn_wsd_core_campus]
    result.reservableUnits.campus.display_value Numéro d’affichage du campus sur lequel se trouve le réservable, par exemple East Bay.

    Type de données : chaîne
    result.reservableUnits.campus.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Campus [sn_wsd_core_campus]
    résultat.unitésréservables.capacité Nombre maximum d’occupants pour le réservable.

    Type de données : nombre
    résultat.reservableUnits.defaultPrivacyValue Marqueur qui indique le paramètre de confidentialité par défaut pour le réservable.

    Pour plus d’informations sur ces paramètres de confidentialité, consultez Paramètres de confidentialité de l’emplacement et impact.

    Valeurs possibles :
    • true : le paramètre de confidentialité du réservable peut être remplacé.
    • faux : le paramètre de confidentialité du réservable ne peut pas être remplacé.

    Type de données : booléennes
    résultat.unitésréservables.description Brève description du réservable.

    Type de données : chaîne
    result.reservableUnits.email Adresse e-mail du réservable.

    Type de données : chaîne
    result.reservableUnits.external_id ID externe du réservable utilisé pour synchroniser un espace mappé dans CMS. Cette valeur n’est renseignée que si une carte est associée à cet emplacement.

    Type de données : chaîne
    résultat.unitésréservables.étage
    Détails sur l’étage où se trouve le réservable.

    Type de données : objet

    "floor": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Étage [sn_wsd_core_floor]
    result.reservableUnits.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.reservableUnits.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    résultat.unitésréservables.image Détails sur une image qui représente la mise en page du réservable associé.

    Type de données : objet

    "image": {
  "link": "String",
  "sys_id": "String"
}

    Tableau : Images [db_image]
    result.reservableUnits.image.link Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]
    result.reservableUnits.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne
    résultat.unitésréservables.inclusdansrésultat Marqueur indiquant si le réservable actuel est inclus dans les résultats de retour.
    Valeurs valides :
    • true : inclus dans les résultats de retour.
    • faux : non inclus dans les résultats de retour.

    Type de données : booléennes
    result.reservableUnits.is_available Marqueur indiquant si le réservable est disponible à la réservation.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : non disponible pour réservation.

    Type de données : booléennes
    result.reservableUnits.is_favorite Marqueur indiquant si le réservable est marqué comme l’un des favoris de l’utilisateur associé.
    Valeurs valides :
    • true : favori.
    • faux : Ce n’est pas un favori.

    Type de données : booléennes
    result.reservableUnits.is_reservable Marqueur indiquant s’il est possible de réserver ce réservable.
    Remarque :
    Si le paramètre de include_unavailable_items requête est défini sur true, les emplacements non disponibles sont également renvoyés. Dans ce cas, si un emplacement est déjà réservé, alors le is_available paramètre est faux, mais is_reservable est vrai.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : non disponible pour réservation.

    Type de données : booléennes
    result.reservableUnits.is_reserved Marqueur indiquant si le réservable est déjà réservé.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : déjà réservé.

    Type de données : booléennes
    result.reservableUnits.is_selected Marqueur indiquant si le réservable est déjà réservé.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : déjà réservé.

    Type de données : booléennes
    result.reservableUnits.location_type Détails sur le type d’emplacement du réservable, tel que lieu de travail/bureau, café ou salle de sport.

    Type de données : objet

    "location_type": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    result.reservableUnits.location_type.display_value Valeur d’affichage du type d’emplacement.

    Type de données : chaîne
    result.reservableUnits.location_type.name Nom du type d’emplacement, tel que sous-sol ou stockage. Identique à la valeur d’affichage.

    Type de données : chaîne
    result.reservableUnits.location_type.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Type d’espace [sn_wsd_core_space_type]
    result.reservableUnits.name Nom du réservable.

    Type de données : chaîne
    résultat.unitésréservables.nombre Identificateur unique du réservable. Cette valeur est plus lisible par l’homme que la sys_id.

    Type de données : chaîne
    résultat.unitésréservables.ordre Numéro de commande du réservable.

    Type de données : nombre
    result.reservableUnits.require_approval Marqueur indiquant si la réservation du réservable nécessite une approbation.
    Valeurs possibles :
    • vrai : approbation requise.
    • faux : l’approbation n’est pas requise.

    Type de données : booléennes
    result.reservableUnits.requires_check_in Marqueur indiquant si le réservable nécessite que l’utilisateur s’enregistre.
    Valeurs valides :
    • vrai : enregistrement obligatoire.
    • faux : l’enregistrement n’est pas obligatoire.

    Type de données : booléennes
    result.reservableUnits.reservable_purposes Détails sur l’objectif de la réservation du réservable associé.

    Type de données : tableau d’objets

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservable_purposes.nom Nom du réservable.

    Type de données : chaîne
    result.reservableUnits.reservable_purposes.short_description Brève description du réservable.

    Type de données : chaîne
    result.reservableUnits.reservable_purposes.sys_id Sys_id de l’enregistrement de l’objectif réservable.

    Type de données : chaîne

    Tableau : Objectif réservable [sn_wsd_rsv_reservable_purpose]
    résultat.unitésréservables.réservations Détails sur les réservations associées au réservable. Renseigné uniquement si le paramètre de include_reservations_within_days requête est vrai et que le paramètre contient des ID de réservation, ce qui signifie qu’il reservation_ids existe déjà des réservations pour ce réservable.

    Type de données : tableau d’objets

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservations.configuration_item Éléments de configuration correspondant à la réservation.

    Type de données : chaîne

    Table : Élément de configuration [cmdb_ci]
    résultat.unitésréservables.réservations.fin Date et heure de fin de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    result.reservableUnits.reservations.is_collided Marqueur indiquant si la réservation entre en conflit avec les heures de début et de fin de la recherche.

    Cela indique que l’emplacement réservable associé est déjà réservé pour l’intervalle de temps de recherche spécifié.

    Valeurs possibles :
    • true : Collision.
    • faux : Pas de collision.

    Type de données : booléennes
    résultat.unitésréservables.réservations.emplacement Détails sur l’emplacement de la réservation.

    Type de données : objet

    "location": {
  "location": "String",
  "timezone": {Object}
}
    résultat.unitésréservables.réservations.emplacement.emplacement Sys_id de l’enregistrement de l’emplacement associé.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    résultat.unitésréservables.réservations.location.fuseau horaire Détails sur le fuseau horaire associé à l’emplacement.

    Type de données : objet

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservableUnits.reservations.location.timezone.displayValue Valeur d’affichage pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.unitésréservables.réservations.location.fuseauhoraire.valeur Valeur interne pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.unitésréservables.réservations.numéro Identificateur unique du réservable. Cette valeur est plus lisible par l’homme que la sys_id.

    Type de données : chaîne
    result.reservableUnits.reservations.requested_for Détails sur la personne au nom de laquelle la réservation a été demandée.

    Type de données : objet

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservableUnits.reservations.requested_for.nom Nom de l’utilisateur pour lequel la réservation a été demandée.

    Type de données : chaîne
    result.reservableUnits.reservations.requested_for.sys_id Sys_id de l’utilisateur pour lequel la réservation est demandée.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    result.reservableUnits.reservations.reservation_purpose Détails sur l’objet de la réservation.

    Type de données : objet

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.reservation_purpose.valeur_affichage Valeur d’affichage pour l’objectif de la réservation, comme une réunion de la société.

    Type de données : chaîne
    result.reservableUnits.reservations.reservation_purpose.valeur Valeur interne pour l’objet de la réservation, telle que company_meeting.

    Type de données : chaîne
    résultat.unitésréservables.réservations.début Date et heure de début de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    résultat.unitésréservables.réservations.état Détails sur l’état de la réservation pour l’emplacement.

    Type de données : objet

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.state.display_value Valeur d’affichage de l’état actuel de la réservation, par exemple confirmée.

    Type de données : chaîne
    résultat.unitésréservables.réservations.état.valeur Valeur interne correspondant à l’état actuel de la réservation, par exemple 2.

    Type de données : chaîne
    résultat.unitésréservables.réservations.objet Objet de la réservation.

    Type de données : chaîne
    result.reservableUnits.reservations.sys_id Requis.
    Sys_id de l’enregistrement de la réservation.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    result.reservableUnits.reservable_quantity Nombre maximal de fois où le réservable associé peut être réservé pour la même durée. Cette valeur est utilisée lors de l’affectation d’espaces de quartier à une zone.

    Type de données : nombre entier
    result.reservableUnits.showPrivacyOption Marqueur indiquant si un employé peut remplacer les paramètres de confidentialité pour le réservable associé.

    Pour plus d’informations sur ces paramètres de confidentialité, consultez Paramètres de confidentialité de l’emplacement et impact.

    Valeurs valides :
    • vrai : les paramètres de confidentialité peuvent être remplacés.
    • faux : le paramètre de confidentialité ne peut pas être remplacé.

    Type de données : booléennes
    result.reservableUnits.site Détails sur le site où se trouve le réservable.

    Type de données : objet

    "site": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Site [sn_wsd_core_site]
    result.reservableUnits.site.display_value Valeur d’affichage du site.

    Type de données : chaîne
    result.reservableUnits.site.sys_id Sys_id de l’enregistrement de site associé.

    Type de données : chaîne

    Table : Site [sn_wsd_core_site]
    result.reservableUnits.standard_services
    Services standards associés, tels que tableau à feuilles mobiles, écran de projection, tableau blanc et marqueurs.

    Type de données : tableau d’objets

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.standard_services.font_awesome_icon Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.name Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.short_description Brève description du service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.sys_id Sys_id de l’enregistrement de service standard.

    Type de données : chaîne

    Table : Service standard [sn_wsd_rsv_standard_service]
    result.reservableUnits.sys_id Sys_id de l’enregistrement réservable.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    result.reservableUnits.tableName Nom de la table dans laquelle se trouve l’enregistrement réservable.

    Type de données : chaîne
    résultat.unitésréservables.titre Titre du réservable.

    Type de données : chaîne

    Demande cURL

    L’exemple de code suivant montre comment appeler ce point de terminaison.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/best_match?q=building%3D9e0364cedb3650106c731dcd1396192b&start=2023-01-04T07%3A00%3A00Z&time_slot=d5331cf2dbb5f01038e42b24ca961906&end=2023-01-04T17%3A00%3A00Z&best_match_count=1&reservable_module=2b636b7e1b4e60103523ff751a4bcbe2&timezone=Europe%2FAmsterdam" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    Renvoyer les résultats :

    {
  "result": {
    "hasMore": false,
    "reservableUnits": [
      {
        "sys_id": "fe1f744edb7650106c731dcd139619ca",
        "external_id": null,
        "email": null,
        "name": "Aspen",
        "title": "Aspen",
        "description": "A room with large windows, dark leather seats and a large wooden table.",
        "image": {
          "sys_id": "41c74902dbb650106c731dcd13961944",
          "link": "41c74902dbb650106c731dcd13961944.iix"
        },
        "number": "ROOM0000903",
        "site": {
          "sys_id": "628eec06db7650106c731dcd139619dd",
          "display_value": "North America"
        },
        "campus": {
          "sys_id": "82b2a0cedb3650106c731dcd139619e9",
          "display_value": "California Campus"
        },
        "building": {
          "sys_id": "94e264cedb3650106c731dcd13961919",
          "display_value": "CAL-B1"
        },
        "floor": {
          "sys_id": "2f554296dbba10106c731dcd139619ed",
          "display_value": "Floor 2"
        },
        "area": null,
        "capacity": "16",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "20713b83eb512010b89bfdfc9c522899",
          "display_value": "Room",
          "name": "Room"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_room",
        "require_approval": false,
        "standard_services": [
          {
            "sys_id": "abd0c18edb7650106c731dcd13961965",
            "name": "Projector screen",
            "short_description": "Connect laptop to screen (HDMI and DVI)",
            "font_awesome_icon": "fa-caret-square-o-right"
          }
        ],
        "reservable_purposes": [
          {
            "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
            "name": "Board room",
            "short_description": null
          }
        ],
        "is_available": true,
        "reservations": [
          {
            "sys_id": "5fe65830874bc9106342b846dabb352b",
            "number": "WRES0001001",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T08:30:00Z",
            "end": "2022-04-23T09:30:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          },
          {
            "sys_id": "af075c30874bc9106342b846dabb3572",
            "number": "WRES0001002",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T23:00:00Z",
            "end": "2022-04-24T00:00:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          }
        ],
        "availableTimes": [
          [
            "2022-04-23 07:00:00",
            "2022-04-23 08:30:00"
          ],
          [
            "2022-04-23 09:30:00",
            "2022-04-23 23:00:00"
          ],
          [
            "2022-04-24 00:00:00",
            "2022-04-24 06:59:59"
          ]
        ],
        "is_favorite": false
      }
    ],
    "reservableContainers": [],
    "nextItemIndex": -1,
    "floorsOfSelectedBuilding": [
      {
        "sys_id": "2f554296dbba10106c731dcd139619ed",
        "display_value": "Floor 2",
        "external_id": null,
        "name": "Floor 2"
      }
    ]
  }
}{
  "result": {
    "hasMore": false,
    "reservableUnits": [
      {
        "sys_id": "32f2a98adb7210106c731dcd13961972",
        "external_id": null,
        "wsd_email": null,
        "name": "B1-03-04",
        "title": "B1-03-04",
        "description": "Desk reserved for the Team-C. After 10am, free to reserve for everyone.",
        "image": {
          "sys_id": "57b42dcadb7210106c731dcd13961945",
          "link": "57b42dcadb7210106c731dcd13961945.iix"
        },
        "number": "SPCE0009018",
        "site": {
          "sys_id": "b17220cedb3650106c731dcd1396197a",
          "display_value": "Western Europe"
        },
        "campus": {
          "sys_id": "44d2e0cedb3650106c731dcd13961988",
          "display_value": "Amsterdam Campus"
        },
        "building": {
          "sys_id": "9e0364cedb3650106c731dcd1396192b",
          "display_value": "AMS-B1"
        },
        "floor": {
          "sys_id": "5373a8cedb3650106c731dcd1396198a",
          "display_value": "Floor 3"
        },
        "area": {
          "sys_id": "410ff04edb7650106c731dcd13961973",
          "display_value": "Desks C1"
        },
        "capacity": "1",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "5f017383eb512010b89bfdfc9c5228c8",
          "display_value": "Workspace/Desk",
          "name": "Workspace/Desk"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_space",
        "require_approval": false,
        "is_available": true,
        "reservations": [],
        "availableTimes": [
          [
            "2023-01-04 07:00:00",
            "2023-01-04 17:00:00"
          ]
        ],
        "showPrivacyOption": false,
        "defaultPrivacyValue": false,
        "container": {
          "sys_id": "410ff04edb7650106c731dcd13961973",
          "display_value": "Desks C1",
          "floor": {
            "sys_id": "5373a8cedb3650106c731dcd1396198a",
            "display_value": "Floor 3",
            "name": "Floor 3"
          },
          "building": {
            "sys_id": "9e0364cedb3650106c731dcd1396192b",
            "display_value": "AMS-B1",
            "name": "AMS-B1"
          },
          "campus": {
            "sys_id": "44d2e0cedb3650106c731dcd13961988",
            "display_value": "Amsterdam Campus",
            "name": "Amsterdam Campus"
          },
          "capacity": 6,
          "image": {
            "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
            "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
          }
        },
        "includedInResult": true,
        "is_favorite": true
      }
    ],
    "reservableContainers": [
      {
        "sys_id": "410ff04edb7650106c731dcd13961973",
        "display_value": "Desks C1",
        "floor": {
          "sys_id": "5373a8cedb3650106c731dcd1396198a",
          "display_value": "Floor 3",
          "name": "Floor 3"
        },
        "building": {
          "sys_id": "9e0364cedb3650106c731dcd1396192b",
          "display_value": "AMS-B1",
          "name": "AMS-B1"
        },
        "campus": {
          "sys_id": "44d2e0cedb3650106c731dcd13961988",
          "display_value": "Amsterdam Campus",
          "name": "Amsterdam Campus"
        },
        "capacity": 6,
        "image": {
          "sys_id": "d52c27b21b8e60103523ff751a4bcb49",
          "link": "d52c27b21b8e60103523ff751a4bcb49.iix"
        }
      }
    ],
    "nextItemIndex": -1,
    "floorsOfSelectedBuilding": [
      {
        "sys_id": "5373a8cedb3650106c731dcd1396198a",
        "display_value": "Floor 3",
        "external_id": null,
        "name": "Floor 3"
      }
    ]
  }

    Recherche WSD : GET /api/sn_wsd_rsv/search/overlapping_reservation

    Détermine s’il existe une réservation avec chevauchement en fonction des paramètres transmis.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/overlapping_reservation

    URL par défaut : /api/sn_wsd_rsv/search/overlapping_reservation

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 13. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 14. Paramètres de requête
    Nom Description
    fin Requis. Heure de fin à utiliser pour vérifier les réservations avec chevauchement.

    Type de données : chaîne

    Format : JJ-MM-AAAAT HH :MM :SSZ
    recurring_pattern Détails sur le modèle récurrent de la réservation.

    Type de données : objet

    "recurring_pattern": {
  "duration": Number,
  "options": {Object},
  "repeats": "String",
  "startDate":"String"
}
    recurring_pattern.durée Durée de la vérification.

    Type de données : nombre

    Unité : Secondes
    recurring_pattern.options Détails sur les options associées à la réservation récurrente.

    Type de données : objet

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "every": Number
}
    recurring_pattern.options.count Nombre de répétitions du modèle.

    Type de données : nombre
    recurring_pattern.options.daysOfWeek Jours de la semaine pour vérifier les chevauchements.
    Valeurs valides :
    • 1 = Lundi
    • 2 = Mardi
    • 3 = Mercredi
    • 4 = Jeudi
    • 5 = Vendredi
    • 6 = Samedi
    • 7 = Dimanche

    Par exemple, pour spécifier mardi, jeudi et vendredi, dépassez 245 (aucun délimiteur).

    Type de données : chaîne
    recurring_pattern.options.toutes les Intervalle de répétition du modèle à vérifier. Par exemple, si cette valeur est égale à 2, elle vérifie le modèle de répétition en fonction de la sélection dans le repeats paramètre, par exemple un jour sur deux ou une semaine sur deux.

    Type de données : nombre
    recurring_pattern.options.répétitions Modèle répétitif pour la vérification du chevauchement de réservation.
    Valeurs possibles : (sensible à la casse)
    • quotidien
    • mensuel
    • hebdomadaire
    • annuel

    Type de données : chaîne
    reservable_id Sys_id du module réservable pour vérifier les réservations avec chevauchement.

    Type de données : chaîne

    Table : module réservable [sn_wsd_rsv_reservable_module]
    reservation_id Sys_id de la réservation pour vérifier qu’il n’y a pas de chevauchement. Cette valeur est nécessaire dans le flux d’édition des parents multi/groupes.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    shift_info_object Détails de l’équipe à vérifier en cas de chevauchement.

    Pour plus d’informations sur les réservations basées sur des équipes, consultez Activer la réservation basée sur des équipes.

    Type de données : objet

    "shift_info_object": {
  "applyToShift": Boolean,
  "shift": "String",
  "timezone": "String"
}
    shift_info_object.applyToShift Marqueur indiquant si les réservations basées sur l’équipe sont activées pour le module réservable.
    Valeurs valides :
    • vrai : autoriser les réservations basées sur l’équipe.
    • false : n’autorisez pas les réservations basées sur des équipes.

    Type de données : booléennes
    shift_info_object.shift Sys_id de l’équipe à associer à la réservation. Si ce paramètre est transmis, il end n’est pas obligatoire.

    Type de données : chaîne

    Table :Maj [sn_wsd_core_shift]
    shift_info_object.fuseau horaire Fuseau horaire de l’équipe à vérifier pour les chevauchements.

    Type de données : chaîne
    début Requis. Heure de début à utiliser pour vérifier les réservations qui se chevauchent.

    Type de données : chaîne

    Format : JJ-MM-AAATH H :MM :SSZ
    user_id Requis. Sys_id de l’utilisateur à vérifier pour les réservations qui se chevauchent.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    Tableau 15. Paramètres de corps de demande (XML ou JSON)
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 16. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Tableau 17. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 18. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    400 Demande incorrecte. Un type de demande incorrecte ou mal formé a été détecté.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de la réponse (JSON ou XML)

    Nom Description
    résultats Détails des résultats de la vérification de chevauchement.

    Type de données : objet

    "results": {
  "isOverlapped": Boolean,
  "reservableId": "String"
}
    résultats.sontSuperposés Marqueur indiquant s’il existe une réservation avec chevauchement.

    Valeurs valides :

    • vrai : il existe une réserve avec chevauchement.
    • faux : la réservation avec chevauchement n’existe pas.

    Type de données : booléennes
    résultats.reservableId Dans le cas d’une réservation de groupe, le sys_id du réservable pour lequel le chevauchement se produit.

    Type de données : chaîne

    Demande cURL

    L’exemple de code suivant montre comment vérifier un chevauchement de réservation pour un utilisateur spécifique et pour une période spécifique notée par les start paramètres and end .

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/search/overlapping_reservation?user_id=2e617fecc3d365101e38b23bb00131ec&end=2023-06-19T8:00:00Z&start=2023-06-19T07:00:00Z" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Renvoyer les résultats :

    {
"results": {
  "isOverlapped": True,
  "reservableId": ""
  }
}

    Recherche WSD : GET /api/sn_wsd_rsv/search/reservable

    Recherche les éléments réservables disponibles à l’aide d’une configuration de modèle réservable spécifiée.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/reservable

    URL par défaut : /api/sn_wsd_rsv/search/reservable

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 19. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 20. Paramètres de requête
    Nom Description
    fin Requis. Heure de fin à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être postérieure à la valeur spécifiée dans le start paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    exclude_reservablesListe d’un ou plusieurs sys_ids de réservables à exclure des résultats de recherche.

    Type de données : chaîne ou tableau

    Table : La table dans laquelle se trouvent ces sys_ids est spécifiée dans le champ reservable_table de la table Module réservable [sn_wsd_rsv_reservable_module]. Il peut s’agir de la table Espace [sn_wsd_core_space] ou Salle [sn_wsd_core_room].
    ignore_same_day_validation Marqueur indiquant si la recherche de réservation ignore le changement de la validation de date entre les paramètres de début et de fin.
    Valeurs valides :
    • vrai : ignorer la validation de la date de changement.
    • faux : n’ignorez pas la validation de la date de changement.

    Type de données : booléennes

    Valeur par défaut : false
    include_reservable_purposes Marqueur indiquant s’il faut renvoyer l’objectif de la réservation de l’emplacement du lieu de travail pour chaque réservable dans les résultats de retour.
    Valeurs valides :
    • vrai : renvoyer les objectifs réservables.
    • faux : ne renvoyez pas les objectifs réservables.

    Type de données : booléennes

    Valeur par défaut : false

    Tableau : Objectif réservable [sn_wsd_rsv_reservable_purpose]
    include_reservations_within_days Marqueur indiquant s’il faut renvoyer tous les créneaux libres d’heures disponibles dans la réponse pour chaque réservable pour toute la journée.
    Valeurs valides :
    • vrai : renvoyer tous les emplacements libres.
    • faux : Ne retournez pas tous les emplacements libres.

    Type de données : booléennes

    Valeur par défaut : false
    include_standard_services Marqueur indiquant s’il faut renvoyer les informations sur les services standard dans la réponse. Ces informations se trouvent dans la table Service standard [sn_wsd_rsv_standard_service].

    Un service standard décrit les dispositions de base disponibles avec un élément de lieu de travail réservable lorsque la réservation est effectuée, telles que les tableaux blancs, les moniteurs supplémentaires et les services similaires. Pour plus d’informations sur les services standard, voir Services standard.

    Valeurs valides :
    • true : renvoie les informations sur les services standard.
    • false : ne renvoie pas les informations de services standard.

    Type de données : booléennes

    Valeur par défaut : false
    near_by_location_id Requis si le rsv_path paramètre est défini sur browse_near_a_person. Sys_id de l’emplacement à utiliser dans la requête codée.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    quartier

    Requis si le paramètre rsv_path est défini sur browse_by_neighborhood.

    Disponible uniquement si le module d’extension Gestion des espaces (sn_wsd_spc_mgmt_neighborhood) est activé.

    Sys_id de l’enregistrement de quartier à utiliser dans la requête codée.

    Pour plus d’informations sur les réservations d’espace de quartier, reportez-vous à la section Create neighborhood reservations.

    Type de données : chaîne

    Table : quartier [sn_wsd_spcmgmt_neighborhood]
    next_item_index Index de l’élément suivant à récupérer. Transmettez ce paramètre lors de la pagination des résultats renvoyés.

    Type de données : nombre

    Par défaut : 0
    page_size Nombre maximal d’enregistrements à renvoyer dans les résultats de retour.

    Type de données : nombre

    Par défaut : 6
    q Requis. Requête codée à utiliser pour filtrer les résultats de recherche renvoyés. Dans cette requête, vous devez spécifier le sys_id du bâtiment et des paramètres tels que l’étage, la surface, la capacité, les services standard et reservable_purposes.

    Tous les paramètres transmis doivent être sys_ids, à l’exception de la capacité, qui est un nombre.

    Par exemple : q=building=94e264cedb3650106c731dcd13961919^floorINfc7368cedb3650106c731dcd13961902^capacity>=1^standard_services=55c0818edb7650106c731dcd13961904^reservable_purposes=d6e5c7cd1ba4e01051848489cc4bcb81

    Vous trouverez ces informations dans les tables suivantes :
    • Superficie : sn_wsd_core_area
    • Bâtiment : sn_wsd_core_building
    • Étage : sn_wsd_core_floor
    • Objectifs réservables : sn_wsd_rsv_reservable_purpose
    • Services standards : sn_wsd_rsv_standard_service

    Type de données : chaîne
    reservable_module Requis. Sys_id du module réservable à inclure dans la recherche. Un module réservable regroupe des types similaires d’éléments du lieu de travail.

    Type de données : chaîne

    Table : module réservable [sn_wsd_rsv_reservable_module]
    reservation_ids Liste séparée par des virgules des sys_ids de réservation existants. Transmettez ce paramètre si vous souhaitez modifier les réservations associées.

    Le temps bloqué pour ces sys_ids pour les réservables correspondants est traité comme disponible.

    Type de données : chaîne

    Par défaut : aucun

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    rsv_path Chemin de réservation à appliquer à la recherche.
    Valeurs valides :
    • browse_all : rechercher tous les réservables.
    • browse_by_area : rechercher les réservables à proximité d’un emplacement spécifique. Un identificateur de zone doit être transmis dans la requête codée (q paramètre).
    • browse_by_neighborhood : recherchez les réservables à proximité du quartier spécifié dans le neighborhood paramètre.
    • browse_near_a_person : recherchez les réservables à proximité de l’emplacement du lieu de travail de la personne spécifiée dans le near_by_location_id paramètre.

    Type de données : chaîne

    Par défaut : browse_all
    schedule_view_obj Détails sur la vue de calendrier à renvoyer. Transmettez cet objet si vous avez besoin de données de disponibilité 24 heures sur 24 pour les réservations qui s’étendent sur plus d’une journée. Les résultats de retour ne contiendront que les heures disponibles et les réservations pour la date spécifiée.

    Pour que cette fonctionnalité fonctionne correctement, les paramètres ignore_same_day_validation et include_reservations_within_days doivent être définis sur vrai.

    Type de données : objet

    "schedule_view_obj": {
  "schedule_view_date": "String",
  "timezone": "String"
}
    schedule_view_obj.schedule_view_date Date pour laquelle commencer à renvoyer la disponibilité de la réservation. Cette date doit se trouver dans le fuseau horaire spécifié dans le schedule_view_obj.timezone paramètre.

    Type de données : chaîne

    Format : AAAA-MM-JJ
    schedule_view_obj.fuseau horaire Fuseau horaire du bâtiment à utiliser pour déterminer les données de disponibilité de la réservation à renvoyer. Par exemple : États-Unis/Pacifique.

    Type de données : chaîne
    début Requis. Heure de début à utiliser pour rechercher des modules réservables disponibles. Cette valeur doit être antérieure à la valeur spécifiée dans le end paramètre.

    Type de données : chaîne

    Format : UTC ou heure locale (aaaa-mm-jj hh :mm :ss)
    Période de travail
    Sys_id de l’équipe à associer à la réservation. Si ce paramètre est transmis, il end n’est pas obligatoire.

    Pour plus d’informations sur les réservations basées sur des équipes, consultez Activer la réservation basée sur des équipes.

    Type de données : chaîne

    Table : Équipe [sn_wsd_core_shift]
    sort_by Ordre de tri souhaité des éléments réservables retournés.
    Valeurs valides :
    • a_z : ordre de tri croissant.
    • favorites_first : trié par réservables sur le lieu de travail favori de l’utilisateur en premier, par ordre croissant pour le reste.
    • z_a : ordre de tri décroissant.

    Type de données : chaîne

    Par défaut : a_z
    fuseau horaire Fuseau horaire préféré, par exemple Europe/Amsterdam.

    Type de données : chaîne

    Par défaut : aucun
    Tableau 21. Paramètres du corps de la demande
    Nom Description
    Aucun

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 22. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml.

    Valeur par défaut : application/json
    Tableau 23. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 24. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse

    Nom Description
    résultat Renvoyer les résultats pour la recherche spécifiée.

    Type de données : objet

    "result": { 
  "filter": {Object},
  "hasMore": Boolean,
  "nextFavIndex": Number,
  "nextItemIndex": Number,
  "reservableContainers": [Array],
  "reservableUnits": [Array],
  "totalProcessed": Number
}
    résultat.filtre Détails sur les étages, les services standard et les objectifs réservables des réservables. Si les include_standard_services paramètres ou include_reservable_purposes sont définis sur faux, standard_services et reservable_purposes sont des tableaux vides.

    Type de données : objet

    "filter": {
   "floors": [Array],
   "reservable_purposes": [Array],
   "standard_services": [Array]
}
    résultat.filtre.étages
    Détails sur l’étage où se trouve le réservable.

    Type de données : objet

    "floors": [
  {
    "display_value": "String",
    "sys_id": "String"
  }
]
    result.filter.floors.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.filter.floors.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    result.filter.standard_services Renseigné uniquement si le include_standard_services paramètre est défini sur vrai.
    Services standards associés, tels que tableau à feuilles mobiles, écran de projection, tableau blanc et marqueurs.

    Type de données : tableau d’objets

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.filter.standard_services.font_awesome_icon Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne
    result.filter.standard_services.name Nom du service standard.

    Type de données : chaîne
    result.filter.standard_services.description_courte Brève description du service standard.

    Type de données : chaîne
    result.filter.standard_services.sys_id Sys_id de l’enregistrement de service standard.

    Type de données : chaîne

    Table : Service standard [sn_wsd_rsv_standard_service]
    result.filter.reservable_purposes Détails sur l’objectif de la réservation du réservable associé.

    Type de données : tableau d’objets

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.filter.reservable_purposes.name Nom du réservable.

    Type de données : chaîne
    result.filter.reservable_purposes.short_description Brève description du réservable.

    Type de données : chaîne
    result.filter.reservable_purposes.sys_id Sys_id de l’enregistrement de l’objectif réservable.

    Type de données : chaîne

    Tableau : Objectif réservable [sn_wsd_rsv_reservable_purpose]
    résultat.hasPlus Marqueur indiquant s’il existe plus de réservables dans les résultats de retour.
    Valeurs possibles :
    • vrai : plus de réservables disponibles.
    • false : plus aucun réservable disponible.

    Type de données : booléennes
    result.nextFavIndex Index du prochain favori réservable pour l’utilisateur. Utilisez cette valeur lors de la pagination dans les réservables favoris de l’utilisateur.

    Type de données : nombre
    résultat.nextItemIndex Index pour le prochain enregistrement réservable à extraire. Utilisez cette valeur lors de la pagination dans les enregistrements réservables.

    Type de données : nombre
    result.reservableContainers Uniquement renvoyé pour les modules réservables dont le champ selection_type est défini sur Conteneur. Un conteneur est un regroupement d’éléments similaires, tel qu’un groupe de bureaux.

    Type de données : tableau d’objets

    "reservableContainers": [
  {
    "building": {Object},
    "campus": {Object},
    "capacity": Number,
    "display_value": "String",
    "floor": {Object},
    "image": {Object}
    "sys_id": "String"
  } 
]
    résultat.conteneursréservables.bâtiment Détails sur le bâtiment associé au conteneur réservable.

    Type de données : objet

    "building": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne
    result.reservableContainers.building.name Nom du bâtiment.

    Type de données : chaîne
    result.reservableContainers.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne
    résultat.conteneursréservables.campus
    Détails sur le campus sur lequel se trouve le réservable.

    Type de données : objet

    "campus": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}

    Table : Campus [sn_wsd_core_campus]
    result.reservableContainers.campus.display_value Numéro d’affichage du campus sur lequel se trouve le réservable, par exemple East Bay.

    Type de données : chaîne
    result.reservableContainers.campus.name Nom du campus.

    Type de données : chaîne
    result.reservableContainers.campus.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Campus [sn_wsd_core_campus]
    résultat.conteneursréservables.capacité Nombre maximum d’occupants pour le réservable.

    Type de données : nombre
    result.reservableContainers.display_value Valeur d’affichage pour le conteneur réservable.

    Type de données : chaîne
    résultat.conteneursréservables.étage Détails sur l’étage associé au conteneur réservable.

    Type de données : objet

    "floor": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}
    result.reservableContainers.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.reservableContainers.floor.name Nom de l’étage auquel le réservable réside.

    Type de données : chaîne
    result.reservableContainers.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    résultat.conteneursréservables.image Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]
    result.reservableContainers.image.link Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]
    result.reservableContainers.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne
    result.reservableContainers.sys_id Sys_id de l’enregistrement de conteneur associé.

    Type de données : chaîne

    Table : la table dans laquelle se trouve l’élément peut être configurée pour n’importe quel type de conteneur. Par défaut, il figure dans la table Zone [sn_wsd_core_area].
    résultat.unitésréservables Détails sur les unités réservables qui correspondent aux critères de recherche spécifiés. Une unité réservable est un seul élément réservable tel qu’un bureau ou une chaise.

    Type de données : tableau d’objets

    "reservableUnits": [
  {
    "area": "String",
    "availableTimes": [Array],
    "building": {Object},
    "campus": {Object},
    "capacity": "String",
    "defaultPrivacyValue": Boolean,
    "description": "String",
    "email": "String",
    "external_id": "String",
    "floor": {Object},
    "image": {Object},
    "includedInResult": Boolean,
    "is_available": Boolean,
    "is_favorite": Boolean,
    "is_reservable": "String",
    "is_reserved": Boolean,
    "is_selected": Boolean,
    "location_type": {Object},
    "name": "String",
    "number": "String",
    "order": "String",
    "require_approval": Boolean,
    "requires_check_in": Boolean,
    "reservable_quantity": "String",
    "showPrivacyOption": Boolean,
    "site": {Object},
    "standard_services": [Array],
    "tableName": "String",
    "title": "String",
    “reservable_purposes”: [Array],
    "reservations": [Array],
    "sys_id": "String"
  }
]
    résultat.unitésréservables.zone Détails sur la zone dans laquelle se trouve le module réservable.

    Type de données : objet

    "area": {
  "display_value": "String",
  "sys_id": "String"
}

    Tableau : Zone [sn_wsd_core_area]
    result.reservableUnits.area.display_value Valeur d’affichage de la zone de module réservable.

    Type de données : chaîne
    result.reservableUnits.area.sys_id Sys_id de l’enregistrement de zone associé au réservable.

    Type de données : chaîne
    résultat.unitésréservables.heuresdisponibles Liste des dates/heures auxquelles le réservable associé est disponible.

    Type de données : tableau
    résultat.unitésréservables.bâtiment Détails sur le bâtiment dans lequel se trouve le réservable.

    Type de données : objet

    "building": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Bâtiment [sn_wsd_core_building]
    result.reservableUnits.building.display_value Valeur d’affichage pour le bâtiment.

    Type de données : chaîne
    result.reservableUnits.building.sys_id Sys_id de l’enregistrement du bâtiment associé.

    Type de données : chaîne
    résultat.unitésréservables.campus
    Détails sur le campus sur lequel se trouve le réservable.

    Type de données : objet

    "campus": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Campus [sn_wsd_core_campus]
    result.reservableUnits.campus.display_value Numéro d’affichage du campus sur lequel se trouve le réservable, par exemple East Bay.

    Type de données : chaîne
    result.reservableUnits.campus.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Campus [sn_wsd_core_campus]
    résultat.unitésréservables.capacité Nombre maximum d’occupants pour le réservable.

    Type de données : nombre
    résultat.unitésréservables.description Brève description du réservable.

    Type de données : chaîne
    result.reservableUnits.email Adresse e-mail du réservable.

    Type de données : chaîne
    result.reservableUnits.external_id ID externe du réservable utilisé pour synchroniser un espace mappé dans CMS. Cette valeur n’est renseignée que si une carte est associée à cet emplacement.

    Type de données : chaîne
    résultat.unitésréservables.étage
    Détails sur l’étage où se trouve le réservable.

    Type de données : objet

    "floor": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Étage [sn_wsd_core_floor]
    result.reservableUnits.floor.display_value Numéro d’affichage de l’étage où le réservable réside, par exemple 12.

    Type de données : chaîne
    result.reservableUnits.floor.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Étage [sn_wsd_core_floor]
    résultat.unitésréservables.image Détails sur une image qui représente la mise en page du réservable associé.

    Type de données : objet

    "image": {
  "link": "String",
  "sys_id": "String"
}

    Tableau : Images [db_image]
    result.reservableUnits.image.link Lien vers une image qui représente la mise en page de ce réservable.

    Type de données : chaîne

    Tableau : Images [db_image]
    result.reservableUnits.image.sys_id Sys_id de l’enregistrement d’image associé.

    Type de données : chaîne
    résultat.unitésréservables.inclusdansrésultat Marqueur indiquant si le réservable actuel est inclus dans les résultats de retour.
    Valeurs valides :
    • true : inclus dans les résultats de retour.
    • faux : non inclus dans les résultats de retour.

    Type de données : booléennes
    result.reservableUnits.is_available Marqueur indiquant si le réservable est disponible à la réservation.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : non disponible pour réservation.

    Type de données : booléennes
    result.reservableUnits.is_favorite Marqueur indiquant si le réservable est marqué comme l’un des favoris de l’utilisateur associé.
    Valeurs valides :
    • true : favori.
    • faux : Ce n’est pas un favori.

    Type de données : booléennes
    result.reservableUnits.is_reservable Marqueur indiquant s’il est possible de réserver ce réservable.
    Remarque :
    Si le paramètre de include_unavailable_items requête est défini sur true, les emplacements non disponibles sont également renvoyés. Dans ce cas, si un emplacement est déjà réservé, alors le is_available paramètre est faux, mais is_reservable est vrai.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : non disponible pour réservation.

    Type de données : booléennes
    result.reservableUnits.is_reserved Marqueur indiquant si le réservable est déjà réservé.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : déjà réservé.

    Type de données : booléennes
    result.reservableUnits.is_selected Marqueur indiquant si le réservable est déjà réservé.
    Valeurs valides :
    • true : disponible pour réservation.
    • faux : déjà réservé.

    Type de données : booléennes
    result.reservableUnits.location_type Détails sur le type d’emplacement du réservable, tel que lieu de travail/bureau, café ou salle de sport.

    Type de données : objet

    "location_type": {
  "display_value": "String",
  "name": "String",
  "sys_id": "String"
}

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    result.reservableUnits.location_type.display_value Valeur d’affichage du type d’emplacement.

    Type de données : chaîne
    result.reservableUnits.location_type.name Nom du type d’emplacement, tel que sous-sol ou stockage. Identique à la valeur d’affichage.

    Type de données : chaîne
    result.reservableUnits.location_type.sys_id Sys_id de l’enregistrement associé.

    Type de données : chaîne

    Table : Type d’espace [sn_wsd_core_space_type]
    result.reservableUnits.name Nom du réservable.

    Type de données : chaîne
    résultat.unitésréservables.nombre Identificateur unique du réservable. Cette valeur est plus lisible par l’homme que la sys_id.

    Type de données : chaîne
    résultat.unitésréservables.ordre Numéro de commande du réservable.

    Type de données : nombre
    result.reservableUnits.require_approval Marqueur indiquant si la réservation du réservable nécessite une approbation.
    Valeurs possibles :
    • vrai : approbation requise.
    • faux : l’approbation n’est pas requise.

    Type de données : booléennes
    result.reservableUnits.requires_check_in Marqueur indiquant si le réservable nécessite que l’utilisateur s’enregistre.
    Valeurs valides :
    • vrai : enregistrement obligatoire.
    • faux : l’enregistrement n’est pas obligatoire.

    Type de données : booléennes
    result.reservableUnits.reservable_purposes Détails sur l’objectif de la réservation du réservable associé.

    Type de données : tableau d’objets

    "reservable_purposes": [
  {
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservable_purposes.nom Nom du réservable.

    Type de données : chaîne
    result.reservableUnits.reservable_purposes.short_description Brève description du réservable.

    Type de données : chaîne
    result.reservableUnits.reservable_purposes.sys_id Sys_id de l’enregistrement de l’objectif réservable.

    Type de données : chaîne

    Tableau : Objectif réservable [sn_wsd_rsv_reservable_purpose]
    résultat.unitésréservables.réservations Détails sur les réservations associées au réservable. Renseigné uniquement si le paramètre de include_reservations_within_days requête est vrai et que le paramètre contient des ID de réservation, ce qui signifie qu’il reservation_ids existe déjà des réservations pour ce réservable.

    Type de données : tableau d’objets

    "reservations": [
  {
    "configuration_item": "String",
    "end": "String",
    "is_collided": Boolean,
    "location": {Object},
    "number": "String",
    "requested_for": {Object},
    "reservation_purpose": {Object},
    "start": "String",
    "state": {Object},
    "subject": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.reservations.configuration_item Éléments de configuration correspondant à la réservation.

    Type de données : chaîne

    Table : Élément de configuration [cmdb_ci]
    résultat.unitésréservables.réservations.fin Date et heure de fin de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    result.reservableUnits.reservations.is_collided Marqueur indiquant si la réservation entre en conflit avec les heures de début et de fin de la recherche.

    Cela indique que l’emplacement réservable associé est déjà réservé pour l’intervalle de temps de recherche spécifié.

    Valeurs possibles :
    • true : Collision.
    • faux : Pas de collision.

    Type de données : booléennes
    résultat.unitésréservables.réservations.emplacement Détails sur l’emplacement de la réservation.

    Type de données : objet

    "location": {
  "location": "String",
  "timezone": {Object}
}
    résultat.unitésréservables.réservations.emplacement.emplacement Sys_id de l’enregistrement de l’emplacement associé.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    résultat.unitésréservables.réservations.location.fuseau horaire Détails sur le fuseau horaire associé à l’emplacement.

    Type de données : objet

    "timezone": {
  "displayValue": "String",
  "value": "String"
}
    result.reservableUnits.reservations.location.timezone.displayValue Valeur d’affichage pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.unitésréservables.réservations.location.fuseauhoraire.valeur Valeur interne pour le fuseau horaire auquel cet emplacement appartient.

    Type de données : chaîne
    résultat.unitésréservables.réservations.numéro Identificateur unique du réservable. Cette valeur est plus lisible par l’homme que la sys_id.

    Type de données : chaîne
    result.reservableUnits.reservations.requested_for Détails sur la personne au nom de laquelle la réservation a été demandée.

    Type de données : objet

    "requested_for": {
  "name": "String",
  "sys_id": "String"
}
    result.reservableUnits.reservations.requested_for.nom Nom de l’utilisateur pour lequel la réservation a été demandée.

    Type de données : chaîne
    result.reservableUnits.reservations.requested_for.sys_id Sys_id de l’utilisateur pour lequel la réservation est demandée.

    Type de données : chaîne

    Table : Utilisateur [sys_user]
    result.reservableUnits.reservations.reservation_purpose Détails sur l’objet de la réservation.

    Type de données : objet

    "reservation_purpose": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.reservation_purpose.valeur_affichage Valeur d’affichage pour l’objectif de la réservation, comme une réunion de la société.

    Type de données : chaîne
    result.reservableUnits.reservations.reservation_purpose.valeur Valeur interne pour l’objet de la réservation, telle que company_meeting.

    Type de données : chaîne
    résultat.unitésréservables.réservations.début Date et heure de début de la réservation.

    Type de données : chaîne

    Format : UTC : aaaa-mm-jjThh :mm :ssZ, comme 2021-02-05T18:00:00Z
    résultat.unitésréservables.réservations.état Détails sur l’état de la réservation pour l’emplacement.

    Type de données : objet

    "state": {
  "display_value": "String",
  "value": "String"
}
    result.reservableUnits.reservations.state.display_value Valeur d’affichage de l’état actuel de la réservation, par exemple confirmée.

    Type de données : chaîne
    résultat.unitésréservables.réservations.état.valeur Valeur interne correspondant à l’état actuel de la réservation, par exemple 2.

    Type de données : chaîne
    résultat.unitésréservables.réservations.objet Objet de la réservation.

    Type de données : chaîne
    result.reservableUnits.reservations.sys_id Requis.
    Sys_id de l’enregistrement de la réservation.

    Type de données : chaîne

    Table : Réservation du lieu de travail [sn_wsd_rsv_reservation]
    result.reservableUnits.reservable_quantity Nombre maximal de fois où le réservable associé peut être réservé pour la même durée. Cette valeur est utilisée lors de l’affectation d’espaces de quartier à une zone.

    Type de données : nombre entier
    result.reservableUnits.site Détails sur le site où se trouve le réservable.

    Type de données : objet

    "site": {
  "display_value": "String",
  "sys_id": "String"
}

    Table : Site [sn_wsd_core_site]
    result.reservableUnits.site.display_value Valeur d’affichage du site.

    Type de données : chaîne
    result.reservableUnits.site.sys_id Sys_id de l’enregistrement de site associé.

    Type de données : chaîne

    Table : Site [sn_wsd_core_site]
    result.reservableUnits.standard_services
    Services standards associés, tels que tableau à feuilles mobiles, écran de projection, tableau blanc et marqueurs.

    Type de données : tableau d’objets

    "standard_services": [
  {
    "font_awesome_icon": "String",
    "name": "String",
    "short_description": "String",
    "sys_id": "String"
  }
]
    result.reservableUnits.standard_services.font_awesome_icon Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.name Nom de l’icône de miniature associée au service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.short_description Brève description du service standard.

    Type de données : chaîne
    result.reservableUnits.standard_services.sys_id Sys_id de l’enregistrement de service standard.

    Type de données : chaîne

    Table : Service standard [sn_wsd_rsv_standard_service]
    result.reservableUnits.sys_id Sys_id de l’enregistrement réservable.

    Type de données : chaîne

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    result.reservableUnits.tableName Nom de la table dans laquelle se trouve l’enregistrement réservable.

    Type de données : chaîne
    résultat.unitésréservables.titre Titre du réservable.

    Type de données : chaîne
    résultat.totalTraité Nombre total d’enregistrements traités.

    Type de données : nombre

    Demande cURL

    Cet exemple montre comment rechercher des réservables à l’aide de ce point de terminaison. Remarque : Des sauts de ligne ont été ajoutés aux paramètres de requête pour faciliter la lecture.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/reservable?
reservable_module=d9864189c3653910977396cb05013100&
start=2023-10-12T10:30:00Z&
end=2023-10-13T11:30:00Z&
include_standard_services=true&
include_reservable_purposes=true&
include_reservations_within_days=true&
include_unavailable_items=true&
near_by_location_id=undefined&
timezone=Europe/Paris&
page_size=6&
sort_by=a_z&
view=schedule&
rsv_path=browse_all&
ignore_same_day_validation=true&
schedule_view_obj={"schedule_view_date":"2023-10-12","timezone":"Europe/Paris"}&
q=building=dea39b1977220110b3d7be377b5a9955\
--request GET \
--header "Accept:application/json" 
--user "username":"password"

    Renvoyer les résultats :

    {
  "result": {
    "hasMore": true,
    "reservableUnits": [
      {
        "sys_id": "fe1f744edb7650106c731dcd139619ca",
        "external_id": null,
        "email": null,
        "name": "Aspen",
        "title": "Aspen",
        "description": "A room with large windows, dark leather seats and a large wooden table.",
        "image": {
          "sys_id": "41c74902dbb650106c731dcd13961944",
          "link": "41c74902dbb650106c731dcd13961944.iix"
        },
        "number": "ROOM0000903",
        "site": {
          "sys_id": "628eec06db7650106c731dcd139619dd",
          "display_value": "North America"
        },
        "campus": {
          "sys_id": "82b2a0cedb3650106c731dcd139619e9",
          "display_value": "California Campus"
        },
        "building": {
          "sys_id": "94e264cedb3650106c731dcd13961919",
          "display_value": "CAL-B1"
        },
        "floor": {
          "sys_id": "2f554296dbba10106c731dcd139619ed",
          "display_value": "Floor 2"
        },
        "area": null,
        "capacity": "16",
        "reservable_quantity": null,
        "location_type": {
          "sys_id": "20713b83eb512010b89bfdfc9c522899",
          "display_value": "Room",
          "name": "Room"
        },
        "order": null,
        "requires_check_in": null,
        "is_reservable": "1",
        "tableName": "sn_wsd_core_room",
        "require_approval": false,
        "standard_services": [
          {
            "sys_id": "9b01458edb7650106c731dcd13961945",
            "name": "Flip chart",
            "short_description": "Flip chart with paper sheets",
            "font_awesome_icon": "fa-calendar-o"
          }
        ],
        "reservable_purposes": [
          {
            "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
            "name": "Board room",
            "short_description": null
          }
        ],
        "is_available": true,
        "reservations": [
          {
            "sys_id": "5fe65830874bc9106342b846dabb352b",
            "number": "WRES0001001",
            "location": {
              "location": "fe1f744edb7650106c731dcd139619ca",
              "timezone": {
                "value": "US/Pacific",
                "displayValue": "US/Pacific"
              }
            },
            "configuration_item": null,
            "start": "2022-04-23T08:30:00Z",
            "end": "2022-04-23T09:30:00Z",
            "subject": null,
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "state": {
              "value": "confirmed",
              "display_value": "Confirmed"
            },
            "is_collided": false,
            "requested_for": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User"
            }
          }
        ],
        "availableTimes": [
          [
            "2022-04-23 07:00:00",
            "2022-04-23 08:30:00"
          ],
          [
            "2022-04-23 09:30:00",
            "2022-04-23 23:00:00"
          ]
        ],
       "is_reserved": true,
       "is_selected": true,
        "includedInResult": true,
        "is_favorite": false
      }
    ],
    "reservableContainers": [],
    "nextItemIndex": -1,
    "filter": {
      "floors": [],
      "standard_services": [
        {
          "sys_id": "9b01458edb7650106c731dcd13961945",
          "name": "Flip chart",
          "short_description": "Flip chart with paper sheets",
          "font_awesome_icon": "fa-calendar-o"
        }
      ],
      "reservable_purposes": [
        {
          "sys_id": "18f4c3cd1ba4e01051848489cc4bcb82",
          "name": "Board room",
          "short_description": null
        }
      ]
    },
    "totalProcessed": 2,
    "nextFavIndex": 0
  }
}

    Recherche WSD : GET /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}

    Renvoie une requête codée que vous pouvez utiliser pour rechercher des équipes disponibles dans la table Équipe [sn_wsd_core_shift].

    Applicable uniquement si le champ appy_to_shift dans le module réservable spécifié est activé. Sinon, la chaîne de requête codée renvoyée sera vide.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/shift/{building_id}/{module_id}

    URL par défaut : /api/sn_wsd_rsv/search/shift/{building_id}/{module_id}

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 25. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    building_id Sys_id du bâtiment à inclure dans la requête de recherche.

    Type de données : chaîne

    Table : Bâtiment [sn_wsd_core_building]
    module_id Sys_id du module réservable à inclure dans la requête de recherche. Un module réservable regroupe des types similaires d’éléments du lieu de travail, tels que des chaises ou des bureaux.

    Type de données : chaîne

    Table : Module réservable [sn_wsd_core_reservable_module]
    Tableau 26. Paramètres de requête
    Nom Description
    Aucun
    Tableau 27. Paramètres du corps de la demande
    Nom Description
    end_date Date et heure de fin de l’équipe à inclure dans la requête codée.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss
    start_date Date et heure de début de l’équipe à inclure dans la requête codée.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 28. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la demande. Types pris en charge : application/json, application/xml ou, text/xml.

    Valeur par défaut : application/json
    Tableau 29. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 30. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse

    Nom Description
    résultat Requête codée à utiliser pour acquérir les équipes disponibles spécifiées.

    Type de données : objet

    "result": { 
  "moduleHasShift": Boolean,
  "query": "String"
}
    moduleHasShift Marqueur indiquant si les équipes sont activées pour le module réservable spécifié.
    Valeurs valides :
    • vrai : le module réservable a des équipes activées.
    • faux : le module réservable n’a pas d’équipes activées. Aucune requête codée renvoyée.

    Type de données : booléennes
    requête Requête codée à utiliser pour récupérer les informations d’équipe pour le module réservable spécifié.

    Type de données : chaîne

    Demande cURL

    L’exemple de code suivant montre comment utiliser ce point de terminaison pour obtenir une requête codée d’équipe.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/shift/94e264cedb3650106c731dcd13961919/fc71f64fdb42a01097acc900399619a8?start_date=2022-04-23 16:00:00&end_date=2022-04-28 16:00:00"  \
--request GET \
--header "Accept:application/json" \
--user "username":"password"

    Renvoyer les résultats :

    {
  "result": { 
    "moduleHasShift" : true,
    "query" : "active=true^state=2^building=94e264cedb3650106c731dcd13961919^building.is_reservable=true^building.active=true^floorISEMPTY^ORfloor.is_reservable=true^floorISEMPTY^ORfloor.active=true^start<=2022-04-26 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY^start<=2022-04-28 16:00:00^ORstartISEMPTY^end>=2022-04-28 16:00:00^ORendISEMPTY"
  }
}

    Recherche WSD : POST /api/sn_wsd_rsv/search/availability_score

    Renvoie un score de disponibilité pour les éléments réservables pour les créneaux horaires spécifiés.

    Format d'URL

    URL versionnée : /api/sn_wsd_rsv/{api_version}/search/availability_score

    URL par défaut : /api/sn_wsd_rsv/search/availability_score

    Remarque :
    Les versions disponibles sont spécifiées dans l’explorateur d’API REST. Pour les API REST basées sur un script, des informations de version supplémentaires sont disponibles sur le formulaire Service REST scripté.

    Paramètres de demande pris en charge

    Tableau 31. Paramètres de chemin d'accès
    Nom Description
    api_version Facultatif. Version du point de terminaison auquel accéder. Par exemple, v1 ou v2. Spécifiez uniquement cette valeur pour utiliser une version de point de terminaison différente de la dernière.

    Type de données : chaîne
    Tableau 32. Paramètres de requête
    Nom Description
    Aucun
    Tableau 33. Paramètres du corps de la demande
    Nom Description
    RecurringPattern Requis si startEndDateTimes le paramètre n’est pas spécifié. Modèle récurrent à utiliser pour rechercher des réservables disponibles pour les événements récurrents spécifiés.

    Type de données : objet

    "recurringPattern": {
  "duration": Number,
  "label": "String",
  "options": {Object},
  "repeats": "String",
  "startDate": "String"
}
    recurringPattern.duration Requis. Durée pendant laquelle le réservable doit être disponible.

    Type de données : nombre

    Unité : millisecondes
    recurringPattern.label Description du modèle récurrent, par exemple Se répète quotidiennement, 5 fois.

    Type de données : chaîne
    recurringPattern.options Options de disponibilité pour la réservation récurrente à rechercher.

    Type de données : objet

    "options": {
  "count": Number,
  "daysOfWeek": "String",
  "endDate": "String"
}
    recurringPattern.options.count Requis si endDate n’est pas transmis. Si les deux sont réussis, count est utilisé. Nombre de fois que le modèle de réunion doit être répété.

    Type de données : nombre
    recurringPattern.options.daysOfWeek Requis si le recurringPattern.repeats paramètre est défini sur Hebdomadaire. Jours de la semaine où le réservable est nécessaire.
    Valeurs valides :
    • 1 = Lundi
    • 2 = Mardi
    • 3 = Mercredi
    • 4 = Jeudi
    • 5 = Vendredi
    • 6 = Samedi
    • 7 = Dimanche

    Par exemple, pour spécifier mardi, jeudi et vendredi, dépassez 245 (aucun délimiteur). Si repeat est hebdomadaire, count est 5 et daysOfWeek est égal à 245, alors dans les résultats de retour, le total est égal à count*daysOfWeek.length (5*3=15).

    Type de données : chaîne
    recurringPattern.options.endDate Requis si recurringPattern.options.count n’est pas transmis. Si les deux sont réussis, count est utilisé. Date et heure de fin de la récurrence de la réunion, telles que « 2022-07-08T14:00:00Z ».

    Type de données : chaîne

    Format : UTC aaaa-mm-jj hh :mm :ss
    recurringPattern.repeats Requis. Modèle répétitif pour le réservable.
    Valeurs valides (sensibles à la casse) :
    • quotidien
    • mensuel
    • hebdomadaire
    • annuel

    Type de données : chaîne
    recurringPattern.startDate Requis. Date et heure de début du modèle récurrent, tel que « 2022-07-08T14:00:00Z ».

    Type de données : chaîne

    Format : UTC aaaa-mm-jj hh :mm :ss
    ReservableIds Requis. Liste des sys_ids des réservables à inclure dans le score de disponibilité.

    Type de données : tableau

    Table : Emplacement du lieu de travail [sn_wsd_core_workplace_location]
    reservableType Requis. Type de réservable à inclure dans le score de disponibilité. Utilisé pour affiner la recherche.
    Valeurs valides (sensibles à la casse) :
    • configuration_item
    • emplacement

    Type de données : chaîne
    startEndDateTimes Liste des dates et heures de début et de fin dans le fuseau horaire de l’utilisateur pour la recherche.

    Type de données : tableau d’objets

    "startEndDateTimes": [
  {
    "end": "String",
    "start": "String"
  }
]

    Par défaut : doit spécifier le recurringPattern paramètre.
    startEndDateTimes.end Date et heure de fin du réservable.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss
    startEndDateTimes.start Date et heure de début du réservable.

    Type de données : chaîne

    Format : aaaa-mm-jj hh :mm :ss

    En-têtes

    Les en-têtes de demande et de réponse suivants s'appliquent à cette action HTTP uniquement ou s'appliquent à cette action d'une manière distincte. Pour obtenir la liste des en-têtes généraux utilisés dans l’API REST, consultez En-têtes d’API REST pris en charge.

    Tableau 34. En-têtes de demandes
    En-tête Description
    Accepter Format de données du corps de la réponse. Types pris en charge : application/json ou application/xml.

    Valeur par défaut : application/json
    Content-Type Format de données du corps de la demande. Prend uniquement en charge application/json.
    Tableau 35. En-têtes de réponses
    En-tête Description
    Aucun

    Codes d'état

    Les codes d'état suivants s'appliquent à cette action HTTP. Pour obtenir la liste des codes d’état possibles utilisés dans l’API REST, consultez Codes de réponse HTTP de l’API REST.

    Tableau 36. Codes d'état
    Code d'état Description
    200 Réussi. La demande a été correctement traitée.
    401 Non autorisé. Les informations d'identification de l'utilisateur sont incorrectes ou n'ont pas été transmises.
    404 Introuvable. L’élément demandé est introuvable.
    500 Erreur interne du serveur. Une erreur inattendue s'est produite lors du traitement de la demande. La réponse contient des informations supplémentaires sur l'erreur.

    Paramètres du corps de réponse

    Nom Description
    résultat Renvoyer les résultats pour le score de disponibilité spécifié.

    Type de données : objet

    "result": {
  "reservable_sys_id": {Object}
}
    result.reservable_sys_id Détails sur le score de disponibilité.

    Type de données : objet

    "reservable_sys_id": {
  "available": Number,
  "score": "String",
  "total": Number
}
    result.reservable_sys_id.disponible Nombre de réservables disponibles qui répondent aux critères de recherche spécifiés.

    Type de données : nombre
    result.reservable_sys_id.score Score de disponibilité. Nombre de réservables disponibles par rapport au nombre total de réservables qui ont répondu aux critères de recherche spécifiés. Par exemple, si available est égal à 2 et total égal à 4, la score valeur est 2/4.

    Type de données : chaîne
    result.reservable_sys_id.total Nombre total de réservables répondant aux critères de recherche spécifiés.

    Type de données : nombre

    Demande cURL

    L’exemple de code suivant montre comment appeler ce point de terminaison.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/search/availability_score" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
  \"reservableType\": \"location\",
  \"reservableIds\": [
    \"fe1f744edb7650106c731dcd139619ca\",
    \"5eafb44edb7650106c731dcd13961943\"
  ],
  \"recurringPattern\": {
    \"duration\": 3600000,
    \"repeats\": \"daily\",
    \"options\": {
      \"count\": 150,
      \"daysOfWeek\": \"\",
    },
    \"label\": \"Repeats daily, 5 times\",
    \"startDate\": \"2022-04-26T14:00:00Z\"
  },
  \"startEndDateTimes\": [
    {
      \"start\": \"2022-07-05 14:00:00\",
      \"end\": \"2022-07-05 15:00:00\"
    },
    {
      \"start\": \"2022-07-06 14:00:00\",
      \"end\": \"2022-07-06 15:00:00\"
    }
  ]
}" \
--user "username":"password"

    Renvoyer les résultats :

    {
  "result": {
    "fe1f744edb7650106c731dcd139619ca": {
      "available": 2,
      "total": 2,
      "score": "2/2"
    },
    "5eafb44edb7650106c731dcd13961943": {
      "available": 2,
      "total": 2,
      "score": "2/2"
    }
  }