|
results
|
Details for the requested reservable module.Data type: Object
```
{
"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
|
Flag that indicates whether employees are able to add invitees to the reservation. Valid values:
- true: Allow employees to add invitees to the reservation.
- false: Don't allow employees to add invitees to the reservation.
Data type: Boolean
|
|
result.allow\_whole\_day
|
Flag that indicates whether users can reserve the reservable for the entire day. Valid values:
- true: Allow users to reserve for the entire day.
- false: Don't allow users to reserve for the entire day.
Data type: Boolean
|
|
result.apply\_to\_shift
|
Flag that indicates whether shift-based reservations are enabled for the reservable module. Valid values:
- true: Allow shift-based reservations.
- false: Don't allow shift-based reservations.
Data type: Boolean
|
|
result.browse\_by\_area\_enabled
|
Flag that indicates whether users are able to search for reservable modules by area.Valid values:
- true: Allow users to browse reservable modules by area.
- false: Don't allow users to browse reservable modules by area.
Data type: Boolean
|
|
result.browse\_by\_neighborhood\_enabled
|
Only available if the Space Management - sn\_wsd\_spc\_mgmt plugin is installed.Flag that indicates whether users are able to search in the reservable modules by neighborhood.
Valid values:
- true: Allow users to browse reservable modules by neighborhood.
- false: Don't allow users to browse reservable modules by neighborhood.
Data type: Boolean
|
|
result.browse\_near\_a\_person\_enabled
|
Flag that indicates whether users are able to search for reservable modules located by a specified person.Valid values:
- true: Allow users to browse reservable modules near a person.
- false: Don't allow users to browse reservable modules near a person.
Data type: Boolean
|
|
result.buildingTreeData
|
Only returned if the **is\_buildings\_tree\_data\_required** query parameter is set to `true`. Hierarchy of the buildings associate with the reservable module.Hierarchy order:
- Region: Located in the Region \[sn\_wsd\_core\_region\] table.
- Site: Located in the Site \[sn\_wsd\_core\_site\] table.
- Campus: Located in the Campus \[sn\_wsd\_core\_campus\] table.
- Building: Located in the Building \[sn\_wsd\_core\_building\] table.
Each `children[ ]` node reflects a different building level/hiearchy:
- buildingsTreeData: Region
- buildingsTreeData.children: Site
- buildingsTreeData.children.children: Campus
- buildingsTreeData.children.children.children: Building
Data type: Array of Objects
```
"buildingsTreeData": [
{
"children": [Array],
"data": {Object},
"isSelectable": Boolean,
"isValid": Boolean,
"label": "String",
"uId": "String"
}
]
```
|
|
result.buildingsTreeData.children
|
Details on the site, campus, or building associated with the reservable module. Each of the parameters in all `children[ ]` nodes are the same. They just apply to different building entities and are only described one time in this section.Data type: Array of Objects
```
"children": [
{
"children": [Array],
"data": {Object},
"isSelectable": Boolean,
"isValid": Boolean,
"label": "String",
"uId": "String"
}
]
```
|
|
result.buildingsTreeData.children.data
|
Details about the building entity.Data type: Object
```
"data": {
"sysId": "String",
"table": "String",
"timezone": {Object}
}
```
|
|
result.buildingsTreeData.children.data.sys\_id
|
Sys\_id of the associated building entity.Data type: String
|
|
result.buildingsTreeData.children.data.table
|
Name of the table in which the building entity record identified in the sys\_id is located.Data type: String
|
|
result.buildingsTreeData.children.data.timezone
|
Details about the time zone of the building entity.```
"timezone": {
"displayValue": "String",
"value": "String"
}
```
|
|
result.buildingsTreeData.children.data.timezone.displayValue
|
Display value in the record for the time zone.Data type: String
|
|
result.buildingsTreeData.children.data.timezone.value
|
Internal value in the record for the time zone.Data type: String
|
|
result.buildingsTreeData.children.isSelectable
|
Flag that indicates whether the associated building entity is available \(selectable\) for the reservable model.Valid values:
- true: Building entity is available for the reservable module.
- false: Building entity isn't available for the reservable module.
Data type: Boolean
|
|
result.buildingsTreeData.children.isValid
|
Flag that indicates whether the associated building entity is valid for the reservable model.Valid values:
- true: Building entity is valid for the reservable module.
- false: Building entity isn't valid for the reservable module.
Data type: Boolean
|
|
result.buildingsTreeData.children.label
|
Name of the building entity.Data type: String
|
|
result.buildingsTreeData.children.uId
|
Sys\_id of the associated building entity record.Data type: String
|
|
result.buildingSysIds
|
List of sys\_ids of the buildings associated with the reservable module.Data type: Array of Strings
|
|
result.checkin\_before\_minutes
|
Amount of time before a reservation starts that a user can check into their reservation.Unit: Minutes
Data type: Number
|
|
result.display\_number\_of\_attendees
|
Flag that indicates whether users can specify the number of attendees in the reservation. Valid values:
- true: Users can specify the number of attendees.
- false: Users can't specify the display number of attendees.
Data type: Boolean
|
|
result.display\_on\_behalf\_of
|
Flag that indicates whether reservations can be made on behalf of someone else. Valid values:
- true: On behalf of supported.
- false: On behalf of not supported.
Data type: Boolean
|
|
result.display\_sensitivity
|
Flag that indicates whether users can set the sensitivity of the reservation, such as normal or private.Valid values:
- true: Able to set sensitivity.
- false: Not able to set sensitivity. Defaults to normal.
Data type: Boolean
|
|
result.display\_value
|
Display value of the reservable module.Data type: String
|
|
result.enable\_browse\_by\_area
|
Flag that indicates whether users are able to search for reservable modules by area. Same as **browse\_by\_area\_enabled**.Valid values:
- true: Allow users to browse reservable modules by area.
- false: Don't allow users to browse reservable modules by area.
Data type: Boolean
|
|
result.enable\_browse\_by\_neighborhood
|
Flag that indicates whether users are able to search for reservable modules by neighborhood.Valid values:
- true: Allow users to browse reservable modules by neighborhood.
- false: Don't allow users to browse reservable modules by neighborhood.
Data type: Boolean
|
|
result.enable\_browse\_near\_a\_person
|
Flag that indicates whether users are able to search for reservable modules located by a specified person. Same as**browse\_near\_a\_person\_enabled**.Valid values:
- true: Allow users to browse reservable modules near a person.
- false: Don't allow users to browse reservable modules near a person.
Data type: Boolean
|
|
result.enable\_facet\_filter
|
Flag that indicates whether facet filtering on workplace items is enabled. When enabled, the filter options that appear are based on the search results. Only the items that are available in the generated search result are available to users for selection in the filter.Valid values:
- true: Facet filters are enabled.
- false: Facet filters aren't enabled.
Data type: Boolean
|
|
result.enable\_group\_reservations
|
Flag that indicates whether users can make a group reservation.Valid values:
- true: Able to make group reservations.
- false: Not able to make group reservations.
Data type: Boolean
|
|
result.enable\_ical\_generation
|
Flag that indicates whether users can generate an iCalendar for the reservation.Valid values:
- true: iCalendar generation allowed.
- false: iCalendar generation isn't allowed.
Data type: Boolean
|
|
result.font\_awesome\_icon
|
Name of the font icon attached to the reservable module.Data type: String
|
|
result.inline\_title
|
Inline title of the reservable module. The title appears in line with the descriptive text on the Workplace service portal.Data type: String
|
|
result.layout\_mapping
|
Details about the structure of the layout mapping of locations. Use this data to lay out the information in the UI. Data type: Object
```
"layout_mapping": {
"body": [Array],
"description": [Array],
"image": "String",
"subtitle": [Array],
"subtitle_asc": [Array],
"title": [Array]
}
```
|
|
result.layout\_mapping.body
|
Placeholder for mapping the front-end UI data.Data type: Array of Objects
```
"body": [
{
"field": "String",
"field_to_display": "String",
"icon": "String",
"label": "String"
}
]
```
|
|
result.layout\_mapping.body.field
|
Placeholder for mapping the front-end UI data.Data type: String
|
|
result.layout\_mapping.body.field\_to\_display
|
Placeholder for mapping the front-end UI data.Data type: String
|
|
result.layout\_mapping.body.icon
|
Placeholder for mapping the front-end UI data.Data type: String
|
|
result.layout\_mapping.body.label
|
Placeholder for mapping the front-end UI data.Data type: String
|
|
result.layout\_mapping.description
|
Placeholder for mapping the front-end UI data. Description of the layout mapping.Data type: Array
|
|
result.layout\_mapping.image
|
Placeholder for mapping the front-end UI data.Data type: String
|
|
result.layout\_mapping.subtitle
|
Placeholder for mapping the front-end UI data.Data type: Array
|
|
result.layout\_mapping.subtitle\_asc
|
Placeholder for mapping the front-end UI data.Data type: Array
|
|
result.layout\_mapping.title
|
Placeholder for mapping the front-end UI data.Data type: Array
|
|
result.max\_days\_in\_future
|
Maximum number of the days in the future that a user can reserve the reservable module.Data type: Number
|
|
result.max\_occurrences
|
Maximum number of recurring reservation occurrences if recurring reservations are available for the reservable module.Data type: Number
|
|
result.name
|
Name of the reservable module.Data type: String
|
|
result.nbhBuildingIds
|
Only returned if the Space Management plugin is installed, the **browse\_by\_neighborhood\_enabled** parameter is set to `true`, and the **neighborhood** parameter is passed in the query parameters.List of sys\_ids of the buildings associated with the reservable module and configured for the neighborhood.
Data type: Array of Strings
|
|
result.nbhBuildingsData
|
Only returned if the Space Management plugin is installed, the **browse\_by\_neighborhood\_enabled** parameter is set to `true`, and the **neighborhood** parameter is passed in the query parameters.List of sys\_ids of the buildings associated with the reservable module and configured for the neighborhood. Each building element also contains a list of sys\_ids of the corresponding floors available for the building.
For example:
```
"nbhBuildingsData": {
"4703a4cedb3650106c731dcd13961945": [
"0f9e304edb7650106c731dcd13961911"
],
"6c0364cedb3650106c731dcd13961927": [
"b23328cedb3650106c731dcd139619f9"
]
}
```
Data type: Array of Objects
Table: Records associated with the building sys\_ids are located in the Building \[sn\_wsd\_core\_building\] table. Records associated with the floor sys\_ids are located in the Floor \[sn\_wsd\_core\_floor\] table.
|
|
result.nbhBuildingsTreeData
|
Only returned if the Space Management plugin is installed, the **browse\_by\_neighborhood\_enabled** parameter is set to `true`, and the **neighborhood** parameter is passed in the query parameters.Hierarchy of the buildings associate with the reservable module and neighborhood.
Data type: Array of Objects
```
"buildingsTreeData": [
{
"children": [Array],
"data": {Object},
"isSelectable": Boolean,
"isValid": Boolean,
"label": "String",
"uId": "String"
}
]
```
Hierarchy order:
- Region: Located in the Region \[sn\_wsd\_core\_region\] table.
- Site: Located in the Site \[sn\_wsd\_core\_site\] table.
- Campus: Located in the Campus \[sn\_wsd\_core\_campus\] table.
- Building: Located in the Building \[sn\_wsd\_core\_building\] table.
|
|
result.nbhBuildingsTreeData.children
|
Describes the hierarchy of the children associated with the building.Each `children[]` node reflects a different building level/hierarchy:
- buildingsTreeData: Region
- buildingsTreeData.children: Site
- buildingsTreeData.children.children: Campus
- buildingsTreeData.children.children.children: Building
Data type: Array of Objects
```
"children": [
{
"children": [Array],
"data": {Object},
"isSelectable": Boolean,
"isValid": Boolean,
"label": "String",
"uId": "String"
}
]
```
The parameters in the `children[]` array are the same as those in the **nbhBuildingsTreeData** object, just for the associated location type; region, site, campus, or building.
|
|
result.nbhBuildingsTreeData.data
|
Details about the associated entity; region, site, campus, or building.Data type: Object
```
"data": {
"sys_id": "String",
"table": "String",
"timezone": {Object}
}
```
|
|
result.nbhBuildingsTreeData.data.sysId
|
Sys\_id of the associated entity record.Data type: String
|
|
result.nbhBuildingsTreeData.data.table
|
Table in which the associated record is located.Data type: String
|
|
result.nbhBuildingsTreeData.data.timezone
|
Information about the time zone in which the associated entity resides.Data type: Object
```
"timezone": {
"displayValue": "String",
"value": "String"
}
```
|
|
result.nbhBuildingsTreeData.data.timezone.displayValue
|
Time zone value to use in a user interface.Data type: String
|
|
result.nbhBuildingsTreeData.data.timezone.value
|
Internal time zone value.Data type: String
|
|
result.nbhBuildingsTreeData.isSelectable
|
Flag that indicates whether the associated entity is available \(selectable\) for the reservable model.Valid values:
- true: Entity is available for the reservable module.
- false: Entity isn't available for the reservable module.
Data type: Boolean
|
|
result.nbhBuildingsTreeData.isValid
|
Flag that indicates whether the associated entity is valid for the reservable model.Valid values:
- true: Entity is valid for the reservable module.
- false: Entity isn't valid for the reservable module.
Data type: Boolean
|
|
result.nbhBuildingsTreeData.label
|
Name of the reservable view.Data type: String
|
|
result.nbhBuildingsTreeData.uId
|
Sys\_id of the associated entity.Data type: String
|
|
result.override\_approval\_policy
|
Option to specify how to implement the approval policy. Choices:
- No override: The approval policy is implemented as set in the **Requires approval** field of a workplace space or room.
- Always require approval: The approval policy is required regardless of what is set in the **Requires approval** field of a workplace space or room.
- Never require approval: The approval policy is removed regardless of what is set in the **Requires approval**l field of a workplace space or room.
Data type: String
|
|
result.require\_cancel\_notes
|
Flag that indicates whether users must enter a cancellation note before cancelling a reservable module.Valid values:
- true: Cancellation note required.
- false: Cancellation note not required.
Data type: Boolean
|
|
result.require\_cc\_dept\_check
|
Flag that indicates whether to check if there's a cost center or department mismatch between the workspace item and the logged in user. Valid values:
- true: Check for a mismatch.
- false: Don't check for a mismatch.
Data type: Boolean
|
|
result.require\_subject
|
Flag that indicates whether the user must enter a subject when making the reservation.Valid values:
- true: Subject required.
- false: Subject isn't required.
Data type: Boolean
|
|
result.reservable\_columns
|
List of the columns of a reservable.Data type: Array
Table: Workplace Location \[sn\_wsd\_core\_workplace\_location\]
|
|
result.reservable\_container\_field
|
Level of the container, such as a group of desks in a specific area.Data type: String
|
|
result.reservable\_filter
|
Filter conditions used to filter out reservable items in the associated Reservable table. Reservable table is a field in the Reservable Module \[sn\_wsd\_rsv\_reservable\_module\] table. These filter conditions were applied to the table contained in the field Reservable table.Data type: String
|
|
result.reservable\_quantity\_field
|
Reservable quantity of all the spaces. The quantity is used when assigning neighbourhood spaces to an area. For additional information, see [Assign neighborhood spaces to an area](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/employee-service-management/add-neighbourhood-spaces-to-an-area.md).Data type: String
|
|
result.reservable\_table
|
Table that contains the reservable workplace items.Data type: String
|
|
result.reservable\_type
|
Type of the reservable item, such as location.Data type: String
|
|
result.reservable\_views
|
Details about the different views associated with the reservable module, such as card view or schedule view.Data type: Object
```
"reservable_views": {
"iconClass": "String",
"isDefault": Boolean,
"label": "String",
"order": Number,
"type": "String"
}
```
Table: Reservable View \[sn\_wsd\_rsv\_reservable\_view\]
|
|
result.reservable\_views.iconClass
|
Icon class of the reservable view.Data type: String
|
|
result.reservable\_views.isDefault
|
Flag that indicates whether to make this reservable view the default for reservable modules. Valid values:
- true: Make default.
- false: Don't make default.
Data type: Boolean
|
|
result.reservable\_views.label
|
Name of the reservable view.Data type: String
|
|
result.reservable\_views.order
|
Order in which the views are displayed for the reservable module in the UI. The lower order number come first in the UI. In case of the same order number, it is assigned random ordering.Data type: Number
|
|
result.reservable\_views.type
|
Backend name of the reservable view. Used for internal processing.Data type: String
|
|
result.reservation\_paths
|
Reservation paths associated with the reservable modules such as Browse all, Browse near a person.Data type: Array of Objects
```
"reservation_paths": [
{
"displayValue": "String",
"value": "String"
}
]
```
|
|
result.reservation\_paths.displayValue
|
Display value for the reservation path, such as "Browse near a person".Data type: String
|
|
result.reservation\_paths.value
|
Internal value for the reservation path, such as "browse\_near\_a\_person".Data type: String
|
|
result.search\_limit
|
Maximum number of search results to return when a user searches for a workplace location.Data type: Number
|
|
result.selection\_type
|
Type of selection to display in the search results.
Can be one of the following options:
- Specific unit: The search result displays every workplace item.
- Container: The search result displays the parent or container of the workplace items.
Data type: String
|
|
result.short\_description
|
Brief description of the reservable module.Data type: String
|
|
result.show\_map\_view
|
Flag that indicates whether to enable the map view for reservable modules. Valid values:
- true: Enable map view.
- false: Don't enable map view.
Data type: Boolean
|
|
result.sys\_id
|
Sys\_id of the reservable module.Data type: String
|
|
result.timeSlots
|
Details about the time slots associated for a reservable module.Data type: Array of Objects
```
[
{
"name": "String",
"short_description": "String",
"slot_end": "String",
"slot_start": "String",
"sys_id": "String"
}
]
```
|
|
result.timeSlots.name
|
Name of the time slot.Data type: String
|
|
result.timeSlots.short\_description
|
Brief description of the time slot.Data type: String
|
|
result.timeSlots.slot\_end
|
End time of the time slot.Data type: String
|
|
result.timeSlots.slot\_start
|
Start time of the slot.Data type: String
|
|
result.timeSlots.sys\_id
|
Sys\_id of the time slot record.Data type: String
Table: Time Slot \[sn\_wsd\_rsv\_time\_slot\]
|
|
result.title
|
Title of the reservable module.Data type: String
|
|
result.virtual\_meeting\_provider
|
Details about the virtual provider associated with the reservable module.Data type: Object
```
"virtual_meeting_provider": {
"display_value": "String",
"sys_id": "String"
}
```
|
|
result.virtual\_meeting\_provider.display\_value
|
Display value of the virtual meeting provider.Data type: String
|
|
result.virtual\_meeting\_provider.sys\_id
|
Sys\_id of the virtual meeting provider.Data type: String
|