---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference
Release :
- xanadu
ft:locale :
- fr-FR
ft:publication_title :
- Référence de l’API Xanadu
ft:clusterId :
- crapiref
bundleId :
- crapiref
workflow :
- Creator
---
# API du module réservable WSD
# API du module réservable WSD {#ariaid-title1}
* Rversion finale: Xanadu
*
* Mis à jour 1 août 2024
*
*  18 minutes de lecture
L'API Prestation de services sur le lieu de travail du module réservable (WSD) fournit des points de terminaison pour récupérer les détails d'un module réservable à partir d'une ServiceNow instance.
Un module réservable regroupe des types similaires d'éléments du lieu de travail. Les employés peuvent afficher ces éléments similaires dans une seule catégorie. Par exemple, une salle est un module réservable qui contient des éléments de lieu de travail similaires, tels que des salles de réunion, des salles de conférence et d'autres salles.
Pour accéder à cette API, l'appelant doit avoir le rôle sn_wsd_core.workplace_user et le module d'extension Workplace Reservation Management (sn_wsd_rsv) doit être activé. Cette API s'exécute dans l'espace `de noms sn_wsd_rsv` .
Pour en savoir plus sur , reportez-vous à Gestion des réservations du lieu de travailla section [Workplace Reservation Management](https://www.servicenow.com/docs/access?context=workplace-rsv-mgmt-feat&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US).
## Module réservable WSD : GET /sn_wsd_rsv/reservable_module/{sys_id} {#ariaid-title2}
Renvoie les détails d'un module réservable spécifié.
### Format d'URL {#wsd_resv_mod-GET-reserv_mod__section_vt2_5vz_qtb}
URL versionnée : /api/sn_wsd_rsv/{api_version}/reservable_module/{sys_id}
URL par défaut : /api/sn_wsd_rsv/reservable_module/{sys_id}
### Paramètres de demande pris en charge
{#wsd_resv_mod-GET-reserv_mod__entry__2}{#wsd_resv_mod-GET-reserv_mod__version-RESTAPI}
| Nom | Description |
|-|-|
| api_version | Facultatif. Version du point de terminaison auquel accéder. 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 |
| sys_id | Sys_id de l'enregistrement du module réversible à récupérer. Situé dans la table Module réservable \[sn_wsd_rsv_reservable_module\]. Type de données : chaîne |
[Tableau 1. Paramètres de chemin d'accès]
{#wsd_resv_mod-GET-reserv_mod__entry__8}
| Nom | Description |
|-|-|
| is_buildings_tree_data_required | Marqueur indiquant s'il faut renvoyer les données de bâtiment associées au modèle réservable. Valeurs valides : * true : renvoie les données du bâtiment. * false : ne renvoyez pas les données du bâtiment. Type de données : booléennes Valeur par défaut : false |
| quartier | 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. Situé dans la table Quartier \[sn_wsd_spcmgmt_neighborhood\]. Pour en savoir plus sur les réservations d'espaces de quartier, reportez-vous à la section [Create neighborhood reservations](https://www.servicenow.com/docs/access?context=create-neighborhood-reservations&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Le point de terminaison vérifie si le quartier est valide, puis récupère les données requises pour le chemin d'accès de navigation par quartier. Type de données : chaîne |
[Tableau 2. Paramètres de requête]
{#wsd_resv_mod-GET-reserv_mod__entry__14}
| Nom | Description |
|-|-|
| Aucun | |
[Tableau 3. Paramètres de corps de demande (XML ou JSON)]
### En-têtes {#wsd_resv_mod-GET-reserv_mod__section_k3d_swn_1yb}
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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__accept-RESTAPI}
| 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 4. En-têtes de demandes]
{#wsd_resv_mod-GET-reserv_mod__table_l3d_swn_1yb} {#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb__entry__2}
| En-tête | Description |
|-|-|
| Aucun | |
[Tableau 5. En-têtes de réponses]
{#wsd_resv_mod-GET-reserv_mod__table_m3d_swn_1yb}
### Codes d'état {#wsd_resv_mod-GET-reserv_mod__section_scs_twn_1yb}
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](https://servicenow-prod.fluidtopics.net/CFQa7z9NIrhoOq1u1cRN7g "REST (REpresentational State Transfer) est une architecture simple sans état qui fournit des normes entre les systèmes informatiques sur le Web, ce qui leur permet de communiquer plus facilement les uns avec les autres.").
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__entry-200-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-400-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-401-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-404-status-code}{#wsd_resv_mod-GET-reserv_mod__entry-500-status-code}
| 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. |
[Tableau 6. Codes d'état]
{#wsd_resv_mod-GET-reserv_mod__table_tcs_twn_1yb}
### Paramètres du corps de réponse (JSON ou XML)
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb__entry__2}{#wsd_resv_mod-GET-reserv_mod__allow_invitees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__allow_whole_day-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__apply_to_shift-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_by_area_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__browse_near_a_person_enabled-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__buildingTreeData-reserv_mod-row}{#wsd_resv_mod-GET-reserv_mod__buildingSysIds-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__checkin_before_minutes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_number_of_attendees-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_on_behalf_of-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_sensitivity-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_by_area-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_browse_near_a_person-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_facet_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_group_reservations-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__enable_ical_generation-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__font_awesome_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__inline_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_field_to_display-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_icon-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_body_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_image-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_subtitle_asc-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__layout_mapping_title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_days_in_future-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__max_occurrences-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__nbh_avail-reserv_mod-ph}{#wsd_resv_mod-GET-reserv_mod__override_approval_policy-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cancel_notes-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_cc_dept_check-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__require_subject-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_columns-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_container_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_filter-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_quantity_field-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_table-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_iconClass-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_isDefault-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_label-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_order-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservable_views_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_displayValue-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__reservation_paths_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__search_limit-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__selection_type-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__show_map_view-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_name-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_short_description-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_end-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_start-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__timeSlots_slot_sys_id-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__title-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_display_value-reserv_mod-entry}{#wsd_resv_mod-GET-reserv_mod__virtual_meeting_provider_sys_id-reserv_mod-entry}
| Nom | Description |
|-|-|
| résultats | Détails du module réservable demandé. Type de données : objet { "result": { "allow_invitees": Boolean, "allow_whole_day": Boolean, "apply_to_shift": Boolean, "browse_by_area_enabled": Boolean, "browse_by_neighborhood_enabled": Boolean, "browse_near_a_person_enabled": Boolean, "buildingsTreeData": [Array], "buildingSysIds": [Array], "checkin_before_minutes": Number, "display_number_of_attendees": Boolean, "display_on_behalf_of": Boolean, "display_sensitivity": Boolean, "display_value": "String", "enable_browse_by_area": Boolean, "enable_browse_by_neighborhood": Boolean, "enable_browse_near_a_person": Boolean, "enable_facet_filter": Boolean, "enable_group_reservations": Boolean, "enable_ical_generation": Boolean, "font_awesome_icon": "String", "inline_title": "String", "layout_mapping": {JSON Object}, "max_days_in_future": Number, "max_occurrences": Number, "name": "String", "nbhBuildingIds": [Array], "nbhBuildingsData": [Array]; "nbhBuildingsTreeData": [Array], "override_approval_policy": "String", "require_cancel_notes": Boolean, "require_cc_dept_check": Boolean, "require_subject": Boolean, "reservable_columns": [Array], "reservable_container_field": "String", "reservable_filter": "String", "reservable_quantity_field": "String", "reservable_table": "String", "reservable_type": "String", "reservable_views": [Array], "reservation_paths": [Array], "search_limit": Number, "selection_type": "String", "short_description": "String", "show_map_view": Boolean, "sys_id": "String", "timeSlots": [Array], "title": "String", "virtual_meeting_provider": {Object} } } |
| result.allow_invitees | Marqueur indiquant si les employés sont en mesure d'ajouter des invités à la réservation. Valeurs valides : * true : autoriser les employés à ajouter des invités à la réservation. * faux : n'autorisez pas les employés à ajouter des invités à la réservation. Type de données : booléennes |
| result.allow_whole_day | Marqueur indiquant si les utilisateurs peuvent réserver le réservable pour toute la journée. Valeurs valides : * true : autoriser les utilisateurs à réserver pour toute la journée. * false : n'autorisez pas les utilisateurs à réserver pour toute la journée. Type de données : booléennes |
| result.apply_to_shift | Marqueur indiquant si les réservations basées sur l'équipe sont activées pour le module réservable. Valeurs valides : * true : autoriser les réservations basées sur l'équipe. * false : n'autorisez pas les réservations basées sur le quart de travail. Type de données : booléennes |
| result.browse_by_area_enabled | Marqueur indiquant si les utilisateurs sont en mesure de rechercher des modules réservables par zone. Valeurs valides : * true : autoriser les utilisateurs à parcourir les modules réservables par zone. * false : n'autorise pas les utilisateurs à parcourir les modules réservables par zone. Type de données : booléennes |
| result.browse_by_neighborhood_enabled | Disponible uniquement si le module d'extension Gestion des espaces - sn_wsd_spc_mgmt est installé. Marqueur indiquant si les utilisateurs sont en mesure d'effectuer des recherches dans les modules réservables par quartier. Valeurs valides : * true : autoriser les utilisateurs à parcourir les modules réservables par quartier. * false : n'autorise pas les utilisateurs à parcourir les modules réservables par quartier. Type de données : booléennes |
| result.browse_near_a_person_enabled | Marqueur indiquant si les utilisateurs sont en mesure de rechercher des modules réservables situés par une personne spécifiée. Valeurs valides : * true : autorise les utilisateurs à parcourir les modules réservables à proximité d'une personne. * false : n'autorisez pas les utilisateurs à parcourir les modules réservables à proximité d'une personne. Type de données : booléennes |
| result.buildingTreeData | Renvoyé uniquement si le paramètre de is_buildings_tree_data_required requête est défini sur vrai. Hiérarchie des bâtiments associés au module réservable. Ordre hiérarchique : * Région : située dans la table Région \[sn_wsd_core_region\]. * Site : situé dans la table Site \[sn_wsd_core_site\]. * Campus : situé dans la table Campus \[sn_wsd_core_campus\]. * Bâtiment : situé dans la table Bâtiment \[sn_wsd_core_building\]. {#wsd_resv_mod-GET-reserv_mod__ul_ppq_h34_stb} Chaque noeud `d'enfants[ ]` reflète un niveau/hiérarchie de bâtiment différent : * buildingsTreeData : région * buildingsTreeData.children : Site * buildingsTreeData.children.children : Campus * buildingsTreeData.children.children.children : Bâtiment Type de données : tableau d'objets "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children | Détails sur le site, le campus ou le bâtiment associé au module réservable. Chacun des paramètres de tous les nœuds `enfants[ ]` est le même. Ils ne s'appliquent qu'à différentes entités de bâtiment et ne sont décrits qu'une seule fois dans cette section. Type de données : tableau d'objets "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] |
| result.buildingsTreeData.children.data | Détails sur l'entité du bâtiment. Type de données : objet "data": { "sysId": "String", "table": "String", "timezone": {Object} } |
| result.buildingsTreeData.children.data.sys_id | Sys_id de l'entité de bâtiment associée. Type de données : chaîne |
| result.buildingsTreeData.children.data.table | Nom de la table dans laquelle se trouve l'enregistrement d'entité du bâtiment identifié dans le sys_id. Type de données : chaîne |
| result.buildingsTreeData.children.data.timezone | Détails sur le fuseau horaire de l'entité du bâtiment. "timezone": { "displayValue": "String", "value": "String" } |
| result.buildingsTreeData.children.data.timezone.displayValue | Affichez la valeur dans l'enregistrement pour le fuseau horaire. Type de données : chaîne |
| result.buildingsTreeData.children.data.timezone.value | Valeur interne dans l'enregistrement pour le fuseau horaire. Type de données : chaîne |
| résultat.bâtimentsDonnéesArbre.enfants.isSélectionnable | Marqueur indiquant si l'entité de bâtiment associée est disponible (sélectionnable) pour le modèle réservable. Valeurs valides : * true : l'entité du bâtiment est disponible pour le module réservable. * false : l'entité du bâtiment n'est pas disponible pour le module réservable. Type de données : booléennes |
| result.buildingsTreeData.children.isValid | Marqueur indiquant si l'entité de bâtiment associée est valide pour le modèle réservable. Valeurs valides : * true : l'entité du bâtiment est valide pour le module réservable. * false : l'entité du bâtiment n'est pas valide pour le module réservable. Type de données : booléennes |
| resultat.bâtimentsDonnéesArbre.enfants.étiquette | Nom de l'entité du bâtiment. Type de données : chaîne |
| result.buildingsTreeData.children.uId | Sys_id de l'enregistrement d'entité de bâtiment associé. Type de données : chaîne |
| result.buildingSysIds | Liste des sys_ids des bâtiments associés au module réservable. Type de données : tableau de chaînes |
| result.checkin_before_minutes | Délai avant le début d'une réservation pendant lequel un utilisateur peut enregistrer sa réservation. Unité : Minutes Type de données : nombre |
| result.display_number_of_attendees | Marqueur indiquant si les utilisateurs peuvent spécifier le nombre de participants dans la réservation. Valeurs valides : * true : Les utilisateurs peuvent spécifier le nombre de participants. * false : Les utilisateurs ne peuvent pas spécifier le nombre de participants affichés. Type de données : booléennes |
| result.display_on_behalf_of | Marqueur indiquant si les réservations peuvent être effectuées au nom de quelqu'un d'autre. Valeurs valides : * true : au nom de pris en charge. * false : pour le compte de non pris en charge. Type de données : booléennes |
| result.display_sensitivity | Marqueur indiquant si les utilisateurs peuvent définir la sensibilité de la réservation, comme normal ou privé. Valeurs valides : * true : capable de définir la sensibilité. * false : impossible de définir la sensibilité. La valeur par défaut est normale. Type de données : booléennes |
| result.display_value | Valeur d'affichage du module réservable. Type de données : chaîne |
| result.enable_browse_by_area | Marqueur indiquant si les utilisateurs sont en mesure de rechercher des modules réservables par zone. Identique à browse_by_area_enabled. Valeurs valides : * true : autoriser les utilisateurs à parcourir les modules réservables par zone. * false : n'autorise pas les utilisateurs à parcourir les modules réservables par zone. {#wsd_resv_mod-GET-reserv_mod__ul_unz_q1r_stb} Type de données : booléennes |
| result.enable_browse_by_neighborhood | Marqueur indiquant si les utilisateurs sont en mesure de rechercher des modules réservables par quartier. Valeurs valides : * true : autoriser les utilisateurs à parcourir les modules réservables par quartier. * false : n'autorise pas les utilisateurs à parcourir les modules réservables par quartier. Type de données : booléennes |
| result.enable_browse_near_a_person | Marqueur indiquant si les utilisateurs sont en mesure de rechercher des modules réservables situés par une personne spécifiée. Identique à browse_near_a_person_enabled. Valeurs valides : * true : autorise les utilisateurs à parcourir les modules réservables à proximité d'une personne. * false : n'autorisez pas les utilisateurs à parcourir les modules réservables à proximité d'une personne. {#wsd_resv_mod-GET-reserv_mod__ul_zx4_s1r_stb} Type de données : booléennes |
| result.enable_facet_filter | Marqueur indiquant si le filtrage des facettes sur les éléments du lieu de travail est activé. Lorsque cette option est activée, les options de filtre qui s'affichent sont basées sur les résultats de la recherche. Seuls les éléments disponibles dans les résultats de recherche générés sont sélectionnables par les utilisateurs dans le filtre. Valeurs valides : * vrai : les filtres de facette sont activés. * faux : les filtres de facette ne sont pas activés. Type de données : booléennes |
| result.enable_group_reservations | Marqueur indiquant si les utilisateurs peuvent effectuer une réservation de groupe. Valeurs valides : * true : habilité à effectuer des réservations de groupe. * faux : impossible d'effectuer des réservations de groupe. Type de données : booléennes |
| result.enable_ical_generation | Marqueur indiquant si les utilisateurs peuvent générer un iCalendar pour la réservation. Valeurs valides : * vrai : génération d'iCalendar autorisée. * faux : la génération d'iCalendar n'est pas autorisée. Type de données : booléennes |
| result.font_awesome_icon | Nom de l'icône de police jointe au module réservable. Type de données : chaîne |
| result.inline_title | Titre en ligne du module réservable. Le titre s'affiche conformément au texte descriptif sur le portail de services Workplace. Type de données : chaîne |
| result.layout_mapping | Détails sur la structure du mappage de mise en page des emplacements. Utilisez ces données pour mettre en page les informations dans l'interface utilisateur. Type de données : objet "layout_mapping": { "body": [Array], "description": [Array], "image": "String", "subtitle": [Array], "subtitle_asc": [Array], "title": [Array] } |
| result.layout_mapping.corps | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : tableau d'objets "body": [ { "field": "String", "field_to_display": "String", "icon": "String", "label": "String" } ] |
| result.layout_mapping.corps.champ | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : chaîne |
| result.layout_mapping.body.field_to_display | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : chaîne |
| result.layout_mapping.corps.icône | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : chaîne |
| result.layout_mapping.corps.étiquette | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : chaîne |
| result.layout_mapping.description | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Description du mappage de mise en page. Type de données : tableau |
| result.layout_mapping.image | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : chaîne |
| result.layout_mapping.sous-titre | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : tableau |
| result.layout_mapping.subtitle_asc | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : tableau |
| result.layout_mapping.titre | Espace réservé pour le mappage des données de l'interface utilisateur frontale. Type de données : tableau |
| result.max_jours_dans_le futur | Nombre maximal de jours dans le futur pendant lesquels un utilisateur peut réserver le module réservable. Type de données : nombre |
| result.max_occurrences | Nombre maximal d'occurrences de réservation récurrentes si des réservations récurrentes sont disponibles pour le module réservable. Type de données : nombre |
| result.name | Nom du module réservable. Type de données : chaîne |
| result.nbhBuildingIds | Renvoyé uniquement si le module d'extension Gestion des espaces est installé, que le paramètre est défini sur vrai et que le neighborhoodbrowse_by_neighborhood_enabled paramètre est transmis dans les paramètres de requête. Liste des sys_ids des bâtiments associés au module réservable et configurés pour le quartier. Type de données : tableau de chaînes |
| result.nbhBuildingsData | Renvoyé uniquement si le module d'extension Gestion des espaces est installé, que le paramètre est défini sur vrai et que le neighborhoodbrowse_by_neighborhood_enabled paramètre est transmis dans les paramètres de requête. Liste des sys_ids des bâtiments associés au module réservable et configurés pour le quartier. Chaque élément de bâtiment contient également une liste de sys_ids des étages correspondants disponibles pour le bâtiment. Par exemple : "nbhBuildingsData": { "4703a4cedb3650106c731dcd13961945": [ "0f9e304edb7650106c731dcd13961911" ], "6c0364cedb3650106c731dcd13961927": [ "b23328cedb3650106c731dcd139619f9" ] } Les enregistrements associés au sys_ids de bâtiment se trouvent dans la table Bâtiment \[sn_wsd_core_building\]. Les enregistrements associés au sys_ids d'étage sont situés dans la table Étage \[sn_wsd_core_floor\]. Type de données : tableau d'objets |
| result.nbhBuildingsTreeData | Renvoyé uniquement si le module d'extension Gestion des espaces est installé, que le paramètre est défini sur vrai et que le neighborhoodbrowse_by_neighborhood_enabled paramètre est transmis dans les paramètres de requête. Hiérarchie des bâtiments associés au module réservable et au quartier. Type de données : tableau d'objets "buildingsTreeData": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] Ordre hiérarchique : * Région : située dans la table Région \[sn_wsd_core_region\]. * Site : situé dans la table Site \[sn_wsd_core_site\]. * Campus : situé dans la table Campus \[sn_wsd_core_campus\]. * Bâtiment : situé dans la table Bâtiment \[sn_wsd_core_building\]. |
| result.nbhBuildingsTreeData.children | Décrit la hiérarchie des enfants associés au bâtiment. Chaque nœud `enfants[]` reflète un niveau/hiérarchie de bâtiment différent : * buildingsTreeData : région * buildingsTreeData.children : Site * buildingsTreeData.children.children : Campus * buildingsTreeData.children.children.children : Bâtiment Type de données : tableau "children": [ { "children": [Array], "data": {Object}, "isSelectable": Boolean, "isValid": Boolean, "label": "String", "uId": "String" } ] Les paramètres du tableau `children[]` sont les mêmes que ceux de l'objet nbhBuildingsTreeData , mais pour le type d'emplacement associé : région, site, campus ou bâtiment. |
| result.nbhBuildingsTreeData.data | Détails sur l'entité associée ; région, site, campus ou bâtiment. Type de données : objet "data": { "sys_id": "String", "table": "String", "timezone": {Object} } |
| result.nbhBuildingsTreeData.data.sysId | Sys_id de l'enregistrement d'entité associé. Type de données : chaîne |
| result.nbhBuildingsTreeData.data.table | Table dans laquelle se trouve l'enregistrement associé. Type de données : chaîne |
| result.nbhBuildingsTreeData.data.timezone | Informations sur le fuseau horaire dans lequel réside l'entité associée. Type de données : objet "timezone": { "displayValue": "String", "value": "String" } |
| result.nbhBuildingsTreeData.data.timezone.displayValue | Valeur de fuseau horaire à utiliser dans une interface utilisateur. Type de données : chaîne |
| result.nbhBuildingsTreeData.data.timezone.value | Valeur du fuseau horaire interne. Type de données : chaîne |
| result.nbhBuildingsTreeData.isSelectable | Marqueur indiquant si l'entité associée est disponible (sélectionnable) pour le modèle réservable. Valeurs valides : * true : l'entité est disponible pour le module réservable. * false : l'entité n'est pas disponible pour le module réservable. Type de données : booléennes |
| result.nbhBuildingsTreeData.isValid | Marqueur indiquant si l'entité associée est valide pour le modèle réservable. Valeurs valides : * vrai : l'entité est valide pour le module réservable. * false : l'entité n'est pas valide pour le module réservable. Type de données : booléennes |
| result.nbhBuildingsTreeData.label | Nom de la vue réservable. Type de données : chaîne |
| result.nbhBuildingsTreeData.uId | Sys_id de l'entité associée. Type de données : chaîne |
| result.override_approval_policy | Option permettant de spécifier la méthode d'implémentation de la politique d'approbation. Les choix sont les suivants : * Aucun remplacement : la politique d'approbation est mise en œuvre comme défini dans le champ Exige une approbation d'un espace ou d'une salle du lieu de travail. * Toujours exiger une approbation : la politique d'approbation est requise, quel que soit le paramètre défini dans le champ Exige une approbation d'un espace ou d'une salle du lieu de travail. * Ne jamais exiger d'approbation : la politique d'approbation est supprimée, quel que soit le paramètre défini dans le champ Nécessite une approbationl d'un espace ou d'une salle de lieu de travail. Type de données : chaîne |
| result.require_cancel_notes | Marqueur indiquant si les utilisateurs doivent saisir une note d'annulation avant d'annuler un module réservable. Valeurs valides : * true : note d'annulation requise. * faux : note d'annulation non requise. Type de données : booléennes |
| result.require_cc_dept_check | Marqueur indiquant s'il faut vérifier s'il existe une incompatibilité de centre de coûts ou de département entre l'élément de l'espace de travail et l'utilisateur connecté. Valeurs valides : * true : vérifier s'il y a une incohérence. * false : ne pas vérifier s'il y a une incohérence. Type de données : booléennes |
| result.require_subject | Marqueur indiquant si l'utilisateur doit saisir un objet lors de la réservation. Valeurs valides : * true : objet requis. * false : l'objet n'est pas obligatoire. Type de données : booléennes |
| result.reservable_columns | Liste des colonnes d'un réservable. Situé dans la table Emplacement du lieu de travail \[sn_wsd_core_workplace_location\]. Type de données : tableau |
| result.reservable_container_field | Niveau du conteneur, par exemple un groupe de bureaux dans une zone spécifique. Type de données : chaîne |
| result.reservable_filter | Conditions de filtre utilisées pour filtrer les éléments réservables dans la table réservable associée. La table réservable est un champ de la table Module réservable \[sn_wsd_rsv_reservable_module\]. Ces conditions de filtre ont été appliquées à la table contenue dans le champ Table réservable. Type de données : chaîne |
| result.reservable_quantity_field | Quantité réservable de tous les espaces. La quantité est utilisée lors de l'affectation d'espaces de quartier à une zone. Pour plus d'informations, reportez-vous [à la rubrique Affecter des espaces de quartier à une zone](https://www.servicenow.com/docs/access?context=add-neighbourhood-spaces-to-an-area&version=xanadu&pubname=xanadu-employee-service-management&ft:locale=en-US). Type de données : chaîne |
| result.reservable_table | Table contenant les éléments du lieu de travail réservables. Type de données : chaîne |
| result.reservable_type | Type de l'élément réservable, tel que l'emplacement. Type de données : chaîne |
| result.reservable_views | Détails sur les différentes vues associées au module réservable, telles que la vue de carte ou la vue de calendrier. Situé dans la table Vue réservable \[sn_wsd_rsv_reservable_view\]. Type de données : objet "reservable_views": { "iconClass": "String", "isDefault": Boolean, "label": "String", "order": Number, "type": "String" } |
| result.reservable_views.iconClass | Classe d'icône de la vue réservable. Type de données : chaîne |
| result.reservable_views.isDefault | Marqueur indiquant s'il faut faire de cette vue réservable la valeur par défaut pour les modules réservables. Valeurs valides : * true : définir par défaut. * false : ne pas définir par défaut. Type de données : booléennes |
| result.reservable_views.label | Nom de la vue réservable. Type de données : chaîne |
| result.reservable_views.commande | Ordre dans lequel les vues sont affichées pour le module réservable dans l'interface utilisateur. Le numéro d'ordre inférieur vient en premier dans l'interface utilisateur. Dans le cas du même numéro d'ordre, un ordre aléatoire lui est attribué. Type de données : nombre |
| result.reservable_views.type | Nom back-end de la vue réservable. Utilisé pour le traitement interne. Type de données : chaîne |
| result.reservation_paths | Chemins de réservation associés aux modules réservables tels que Tout parcourir, Explorer à proximité d'une personne. Type de données : tableau d'objets "reservation_paths": [ { "displayValue": "String", "value": "String" } |
| result.reservation_paths.displayValue | Valeur d'affichage du chemin de réservation, par exemple \<\< Explorer à proximité d'une personne \>\>. Type de données : chaîne |
| result.reservation_paths.valeur | Valeur interne du chemin de réservation, telle que \<\< browse_near_a_person \>\>. Type de données : chaîne |
| result.search_limit | Nombre maximal de résultats de recherche à renvoyer lorsqu'un utilisateur recherche un emplacement de lieu de travail. Type de données : nombre |
| result.selection_type | Type de sélection à afficher dans les résultats de la recherche. Peut être l'une des options suivantes : * Unité spécifique : les résultats de la recherche affichent chaque élément du lieu de travail. * Conteneur : les résultats de la recherche affichent le parent ou le conteneur des éléments du lieu de travail. Type de données : chaîne |
| result.short_description | Brève description du module réservable. Type de données : chaîne |
| result.show_map_view | Marqueur indiquant s'il faut activer la vue de carte pour les modules réservables. Valeurs valides : * true : activer la vue cartographique. * faux : n'activez pas la vue cartographique. {#wsd_resv_mod-GET-reserv_mod__ul_dsq_ftg_rtb} Type de données : booléennes |
| result.sys_id | Sys_id du module réservable. Type de données : chaîne |
| result.timeSlots | Détails sur les créneaux horaires associés à un module réservable. Type de données : tableau d'objets [ { "name": "String", "short_description": "String", "slot_end": "String", "slot_start": "String", "sys_id": "String" } ] |
| result.timeSlots.name | Nom du créneau horaire Type de données : chaîne |
| result.timeSlots.short_description | Brève description du créneau horaire. Type de données : chaîne |
| result.timeSlots.slot_end | Heure de fin du créneau horaire Type de données : chaîne |
| result.timeSlots.slot_start | Heure de début du créneau. Type de données : chaîne |
| result.timeSlots.sys_id | Sys_id de l'enregistrement de créneau horaire. Situé dans la table Créneau horaire \[sn_wsd_rsv_time_slot\]. Type de données : chaîne |
| résultat.titre | Titre du module réservable. Type de données : chaîne |
| result.virtual_meeting_provider | Détails sur le fournisseur virtuel associé au module réservable. Type de données : objet "virtual_meeting_provider": { "display_value": "String", "sys_id": "String" } |
| result.virtual_meeting_provider.display_value | Valeur d'affichage du fournisseur de réunion virtuelle. Type de données : chaîne |
| result.virtual_meeting_provider.sys_id | Sys_id du fournisseur de réunion virtuelle. Type de données : chaîne |
[ ]
{#wsd_resv_mod-GET-reserv_mod__id_w24_zwn_1yb}
### Demande cURL
Cet exemple de code montre comment demander un module réservable avec les données de l'arborescence des bâtiments.
curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable_module/5db44502dbb650106c731dcd13961937&is_buildings_tree_data_required=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Corps de réponse :
{
"result": {
"sys_id": "5db44502dbb650106c731dcd13961937", "name": "Desks",
"title": "Desks",
"inline_title": "desk",
"font_awesome_icon": "fa-desktop",
"reservable_table": "sn_wsd_core_space",
"reservable_filter": "active=true^is_reservable=true^location_type=5f017383eb512010b89bfdfc9c5228c8^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a single desks",
"reservable_type": "location",
"require_subject": null,
"require_cancel_notes": false,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": null,
"display_number_of_attendees": null,
"display_on_behalf_of": null,
"display_sensitivity": null,
"max_days_in_future": "90",
"allow_whole_day": "1",
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "90",
"enable_facet_filter": false,
"search_limit": 10000,
"enable_ical_generation": null,
"enable_group_reservations": null,
"enable_browse_near_a_person": "1",
"enable_browse_by_area": "1",
"enable_browse_by_neighborhood": "1",
"show_map_view": false,
"require_cc_dept_check": false,
"display_value": "Desks",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"browse_by_neighborhood_enabled": true,
"reservable_columns": [
"sys_id",
"external_id",
"email",
"name",
"title",
"description",
"image",
"number",
"site",
"campus",
"building",
"floor",
"area",
"capacity",
"reservable_quantity",
"location_type",
"order",
"requires_check_in",
"is_reservable"
],
"layout_mapping": {
"title": [
"name"
],
"description": [
"description"
],
"subtitle": [
"campus",
"building",
"floor",
"area"
],
"subtitle_asc": [
"area",
"floor",
"building",
"campus"
],
"image": "image",
"body": [
{
"label": "Capacity",
"icon": "fa-users",
"field": "capacity",
"field_to_display": ""
},
{
"label": "Standard services",
"icon": "fa-check",
"field": "standard_services",
"field_to_display": "name"
},
{
"label": "Reservable purposes",
"icon": "fa-tags",
"field": "reservable_purposes",
"field_to_display": "name"
}
]
},
"timeSlots": [
{
"sys_id": "d5331cf2dbb5f01038e42b24ca961906",
"name": "All day",
"short_description": "8am - 6pm",
"slot_start": "08:00",
"slot_end": "18:00"
},
{
"sys_id": "de131cf2dbb5f01038e42b24ca961931",
"name": "Before noon",
"short_description": "8am - 12pm",
"slot_start": "08:00",
"slot_end": "12:00"
},
{
"sys_id": "6e99ab5ddbb930102e8e853e68961929",
"name": "After noon",
"short_description": "1pm - 6pm",
"slot_start": "13:00",
"slot_end": "18:00"
}
],
"buildingSysIds": [
"9e0364cedb3650106c731dcd1396192b"
],
"buildingsTreeData": [
{
"isValid": true,
"label": "Europe",
"uId": "2d626c4edb3650106c731dcd1396194b",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Western Europe",
"uId": "b17220cedb3650106c731dcd1396197a",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "Amsterdam Campus",
"uId": "44d2e0cedb3650106c731dcd13961988",
"isSelectable": false,
"children": [
{
"isValid": true,
"label": "AMS-B1",
"uId": "9e0364cedb3650106c731dcd1396192b",
"isSelectable": true,
"children": [],
"data": {
"sysId": "9e0364cedb3650106c731dcd1396192b",
"table": "sn_wsd_core_building",
"timezone": {
"value": "Europe/Amsterdam",
"displayValue": "Europe/Amsterdam"
}
}
}
],
"data": {
"sysId": "44d2e0cedb3650106c731dcd13961988",
"table": "sn_wsd_core_campus",
"timezone": null
}
}
],
"data": {
"sysId": "b17220cedb3650106c731dcd1396197a",
"table": "sn_wsd_core_site",
"timezone": null
}
}
],
"data": {
"sysId": "2d626c4edb3650106c731dcd1396194b",
"table": "sn_wsd_core_region",
"timezone": null
}
}
],
"reservable_views": [
{
"type": "card",
"label": "Card view",
"iconClass": "fa-th-large",
"isDefault": true,
"order": "1"
},
{
"type": "schedule",
"label": "Schedule view",
"iconClass": "fa-calendar-o",
"isDefault": false,
"order": "2"
}
],
"checkin_before_minutes": 30,
"reservation_paths": [
{
"value": "browse_all",
"displayValue": "Browse all"
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person"
},
{
"value": "browse_by_area",
"displayValue": "Browse by area"
}
],
"override_approval_policy": "never_required"
}
}