WSD-Reservierungs-API
Die Reservierungs -API Workplace Service Delivery (WSD) bietet Endpunkte für die Verwaltung von Arbeitsplatzreservierungen.
Für den Zugriff auf diese API muss der Aufrufer über die Rolle „sn_wsd_core.workplace_user“ verfügen und die Plugins „Workplace Safety Management“ (sn_wsd_core) und „Workplace Reservation Management“ (sn_wsd_rsv) müssen aktiviert sein.
Diese API wird im Namespace sn_wsd_rsv ausgeführt.
Weitere Informationen zu Workplace Reservation Managementfinden Sie unter Workplace Reservation Management.
WSD Reservation – GET /api/sn_wsd_rsv/reservation/get
Ruft die angegebene Arbeitsplatzreservierung ab.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/get
Standard-URL: /api/sn_wsd_rsv/reservation/get
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| external_ical | Eindeutige externe iCalendar-Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Rufen Sie diesen Wert aus der zugeordneten externen iCalendar-Anwendung ab. Datentyp: Zeichenfolge |
| external_id | Eindeutige externe Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Rufen Sie diesen Wert aus der zugeordneten externen Anwendung ab. Datentyp: Zeichenfolge |
| include_multi_child_data | Wenn der Feldwert „reservierung_subtype“ im zugeordneten Datensatz „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation] auf multi_child festgelegt ist, gibt diese Kennzeichnung an, ob die Reservierungsdetails zurückgegeben werden sollen. Gültige Werte:
Datentyp: Boolesch Standardwert: falsch |
| include_standard_services | Kennzeichnung, die angibt, ob die Standardserviceinformationen in der Antwort zurückgegeben werden sollen. Ein Standardservice beschreibt grundlegende Vorkehrungen, die bei der Reservierung für ein reservierbares Arbeitsplatzelement verfügbar sind, z. B. Whiteboards, zusätzliche Monitore und ähnliche Services. Weitere Informationen zu Standardservices finden Sie unter Standardservices. Diese Informationen befinden sich in der Tabelle „Standardservice“ [sn_wsd_rsv_standard_service]. Gültige Werte:
Datentyp: Boolesch Standardwert: false |
| sys_id | Erforderlich. Sys_id des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| Ergebnis.Reservierung | Details zur Reservierung. Datentyp: Objekt |
| result.reservation.active | Kennzeichnung, die angibt, ob die Reservierung aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| Ergebnis.Reservierung.Teilnehmer | Liste der Teilnehmer für die Reservierung. Datentyp: Array von Objekten |
| Ergebnis.Reservierung.Teilnehmer.Avatar | Sys_id des Avatars, der dem Teilnehmer zugeordnet ist. Befindet sich in der Tabelle „Anhänge“ [sys_attachment]. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.displayValue | Anzeigewert für den Teilnehmer. Datentyp: Zeichenfolge |
| result.reservation.attendees.display_value | Anzeigewert des Teilnehmers. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.attendees.email | E-Mail-Adresse des Teilnehmers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Initialen | Initialen des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.attendees.name | Name des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.sys_id | Sys_id_des Teilnehmerdatensatzes. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.tabelle | Tabelle, in der der Teilnehmerdatensatz vorhanden ist. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Benutzername | Benutzername des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.attendees.value | Interner Wert des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.check_in_state | Details zum Check-in-Status der Reservierung. Datentyp: Objekt |
| result.reservation.check_in_state.display_value | Anzeigewert für den aktuellen Check-in-Status der Reservierung, z. B. In Bearbeitung oder Abgeschlossen. Datentyp: Zeichenfolge |
| result.reservation.check_in_state.value | Interner Wert für den aktuellen Check-in-Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.edit_restriction | Beschreibung der Benutzerbearbeitungsbeschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „complete_restricted“. Datentyp: Objekt |
| result.reservation.edit_restriction.display_value | Anzeigewert für die Bearbeitungsbeschränkungen für die Reservierung, z. B. Keine Einschränkung. Datentyp: Zeichenfolge |
| result.reservation.edit_restriction.value | Interner Wert für die Bearbeitungsbeschränkungen für die Reservierung, z. B. no_restriction. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Ende | Enddatum und -uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC: jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| result.reservation.external_ical | Eindeutige externe iCalendar-Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Datentyp: Zeichenfolge |
| result.reservation.external_id | Eindeutige externe Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Datentyp: Zeichenfolge |
| result.reservation.is_parent | Kennzeichnung, die angibt, ob diese Reservierung eine übergeordnete Reservierung ist. Mögliche Werte:
Datentyp: Boolesch |
| result.reservation.is_private | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung nur dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Standort-Datenschutzeinstellungen und Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: In den Systemeigenschaften für Datenschutz festgelegter Wert. |
| result.reservation.last_updated_sub_source | Details zur zuletzt aktualisierten Unterquelle für die Reservierung. Unterquellen werden bei der Integration von Reservierungen mit einem externen Kalender verwendet. Dieses Objekt enthält Informationen wie „servicenow_workplace_service_delivery“, „google_calendar“ oder „microsoft_exchange“. Datentyp: Objekt |
| result.reservation.last_updated_sub_source.display_value | Anzeigewert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. ServiceNow Workplace Service Delivery oder Google Kalender. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird. Datentyp: Zeichenfolge |
| result.reservation.last_updated_sub_source.value | Interner Wert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. servicenow_workplace_service_delivery oder google_calendar. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird. Datentyp: Zeichenfolge |
| result.reservation.location | Details zum Standort, der der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.area | Details zum Bereich, der dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.area.active | Kennzeichnung, die angibt, ob der Bereich aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.area.display_value | Anzeigewert des Bereichs, zu dem dieser Standort gehört, z. B. Schreibtisch A2. Datentyp: Zeichenfolge |
| result.reservation.location.area.sys_id | Sys_id des Bereichs, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Bereich“ [sn_wsd_core_area]. Datentyp: Zeichenfolge |
| result.reservation.location.building | Details zum Gebäude, das dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.building.active | Kennzeichnung, die angibt, ob das Gebäude aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.building.display_value | Anzeigewert des Gebäudes, zu dem dieser Standort gehört, z. B. AMS - Geb. 1. Datentyp: Zeichenfolge |
| result.reservation.location.building.sys_id | Sys_id des Gebäudes, zu dem dieser Standort gehört. Befindet sich in der Gebäudetabelle [sn_wsd_core_building]. Datentyp: Zeichenfolge |
| result.reservation.location.building.timezone | Details zur Zeitzone, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.building.timezone.display_value | Anzeigewert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| result.reservation.location.building.timezone.value | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| result.reservation.location.campus | Details zum Campus, der dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.campus.active | Kennzeichnung, die angibt, ob der Campus aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.campus.display_value | Anzeigewert des Campus, zu dem dieser Standort gehört, z. B. Campus Amsterdam. Datentyp: Zeichenfolge |
| result.reservation.location.campus.sys_id | Sys_id des Campus, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Campus“ [sn_wsd_core_campus]. Datentyp: Zeichenfolge |
| result.reservation.location.capacity | Maximale Anzahl von Personen für den Standort. Datentyp: Zahl |
| result.reservation.location.description | Kurze Beschreibung des Standorts. Datentyp: Zeichenfolge |
| result.reservation.location.display_value | Wert, der in der Benutzeroberfläche für diesen Standort angezeigt werden soll. Datentyp: Zeichenfolge |
| result.reservation.location.email | E-Mail-Adresse für den Standort. Datentyp: Zeichenfolge |
| result.reservation.location.stockwerk | Details zum Stockwerk, das dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.floor.active | Kennzeichnung, die angibt, ob das Stockwerk aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.stockwerk.display_value | Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erstes Stockwerk. Datentyp: Zeichenfolge |
| result.reservation.location.stockwerk.sys_id | Sys_id des Stockwerks, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Stockwerk“ [sn_wsd_core_floor]. Datentyp: Zeichenfolge |
| result.reservation.location.label_value | Typ des im Parameter name angegebenen Werts, z. B. Raumname. Datentyp: Zeichenfolge |
| result.reservation.location.name | Name des Standorts. Datentyp: Zeichenfolge |
| result.reservation.location.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.number_of_attendees | Anzahl der Teilnehmer für die Reservierung. Datentyp: Zahl |
| result.reservation.location.region | Details zur Region, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.region.active | Kennzeichnung, die angibt, ob die Region aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.region.display_value | Anzeigewert der Region, zu der dieser Standort gehört, z. B. Europa. Datentyp: Zeichenfolge |
| result.reservation.location.region.sys_id | Sys_id der Region, zu der dieser Standort gehört. Befindet sich in der Tabelle „Region“ [sn_wsd_core_region]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for | Details zur Person, für die die Reservierung im Namen von angefordert wurde. Datentyp: Objekt |
| result.reservation.location.requested_for.name | Name des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.sys_id | Sys_id des Benutzers, für den die Reservierung angefordert wird. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.user_name | Benutzername des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservation | Details zur Reservierung, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.reservation.active | Kennzeichnung, die angibt, ob die Reservierung aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.reservation.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.number_of_attendees | Anzahl der Teilnehmer der Reservierung. Datentyp: Zahl |
| result.reservation.location.reservation.requested_for | Details zur Person, für die die Reservierung im Namen von angefordert wurde. Datentyp: Objekt |
| result.reservation.location.reservation.requested_for.name | Name des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.sys_id | Sys_id des angeforderten Anwenders. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.user_name | Benutzername des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module | Details zum reservierbaren Modul, das der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.reservable_module.inline_title | Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.name | Name des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.sys_id | Sys_id des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.title | Titel des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.site | Site, zu der der Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Objekt |
| result.reservation.location.site.active | Kennzeichnung, die angibt, ob die Site aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.site.display_value | Anzeigewert des Standorts, zu dem dieser Standort gehört, z. B. Westeuropa. Datentyp: Zeichenfolge |
| result.reservation.location.site.sys_id | Sys_id des Standorts, zu dem dieser Speicherort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Zeichenfolge |
| result.reservation.location.state | Details zum Status der Reservierung für den Standort. Datentyp: Objekt |
| result.reservation.location.state.display_value | Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“. Datentyp: Zeichenfolge |
| result.reservation.location.state.value | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.location.sys_id | Sys_id des zugeordneten Standortdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| result.reservation.notification_custom_message | Benutzerdefinierte Nachricht für die Benachrichtigung, die an die in reservation.notification_recipientsaufgeführten Empfänger gesendet wird. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients | Liste der Empfänger, die Benachrichtigungen über die Reservierung erhalten. Datentyp: Array von Objekten |
| result.reservation.notification_recipients.name | Name des Empfängers. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.sys_id | Sys_id des Empfängers. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.user_name | Benutzername des Empfängers. Datentyp: Zeichenfolge |
| result.reservation.number | Eindeutige Nummer des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Sie können diesen Wert verwenden, um die Reservierung abzufragen. Datentyp: Zeichenfolge |
| result.reservation.opened_by | Details zum Benutzer, der die Reservierung erstellt hat. Datentyp: Objekt |
| result.reservation.opened_by.avatar | Avatar für den Benutzer, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.displayValue | Anzeigewert des Benutzers, der ihn geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.display_value | Anzeigewert des Benutzers, der ihn geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.email | E-Mail-Adresse des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.initials | Initialen des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.label | Bezeichnung für den Benutzer, der die Reservierung geöffnet hat. Dies ist eine Kombination aus Titel und Abteilung des Benutzers. Datentyp: Zeichenfolge |
| result.reservation.opened_by.name | Name des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.rservation.opened_by.sys_id | Sys_id_of des Benutzers, der die Reservierung geöffnet hat. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.opened_by.table | Tabelle, die den Benutzerdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.opened_by.user_name | Benutzername des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.value | Interner Wert des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.number_of_attendees | Anzahl der Teilnehmer in dieser Reservierung. Datentyp: Zahl |
| result.reservation.recording_details | Details zu den Aufzeichnungen, die der Reservierung (Besprechung) zugeordnet sind. Datentyp: Array |
| result.reservation.recording_details.recording_url | URL der Aufzeichnungen, die der Reservierung zugeordnet sind. Datentyp: Zeichenfolge |
| result.reservation.requested_for | Details zum Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Objekt |
| result.reservation.requested_for.avatar | Avatar für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.displayValue | Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.display_value | Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.requested_for.email | E-Mail-Adresse des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.initials | Initialen des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.label | Bezeichnung für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.name | Name des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.rservation.requested_for.sys_id | Sys_id_of des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.requested_for.table | Tabelle, die den Benutzerdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.requested_for.user_name | Benutzername des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.value | Interner Wert des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.reservable_module | Details für das angeforderte reservierbare Modul. Datentyp: Objekt |
| result.reservation.reservable_module.allow_invitees | Kennzeichnung, die angibt, ob Mitarbeiter der Reservierung eingeladene Personen hinzufügen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.allow_wholt_day | Kennzeichnung, die angibt, ob Benutzer das reservierbare Element für den gesamten Tag reservieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.apply_to_shift | Kennzeichnung, die angibt, ob schichtbasierte Reservierungen für das reservierbare Modul aktiviert sind. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_by_area_enabled | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_near_a_person_enabled | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.buildingSysIds | Liste der sys_ids der Gebäude, die dem reservierbaren Modul zugeordnet sind. Datentyp: Array von Zeichenfolgen |
| result.reservation.reservable_module.checkin_before_minutes | Zeitraum vor Beginn einer Reservierung, in dem ein Benutzer in seine Reservierung einchecken kann. Einheit: Minuten Datentyp: Zahl |
| result.reservation.reservable_module.display_number_of_attendees | Kennzeichnung, die angibt, ob Benutzer die Anzahl der Teilnehmer in der Reservierung angeben können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_on_behalb_von | Kennzeichnung, die angibt, ob Reservierungen im Namen einer anderen Person vorgenommen werden können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_sensitivity | Kennzeichnung, die angibt, ob Benutzer die Vertraulichkeit der Reservierung festlegen können, z. B. „Normal“ oder „Privat“. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_value | Anzeigewert des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.enable_browse_by_area | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können. Identisch mit browse_by_area_enabled. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_browse_near_a_person | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Identisch mit browse_near_a_person_enabled. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_facet_filter | Kennzeichnung, die angibt, ob die Aspektfilterung für Arbeitsplatzelemente aktiviert ist. Wenn diese Option aktiviert ist, basieren die angezeigten Filteroptionen auf den Suchergebnissen. Nur die Elemente, die im generierten Suchergebnis verfügbar sind, stehen Benutzern zur Auswahl im Filter zur Verfügung. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_group_reservations | Kennzeichnung, die angibt, ob Benutzer eine Gruppenreservierung vornehmen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_ical_generation | Kennzeichnung, die angibt, ob Benutzer einen iCalendar für die Reservierung generieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.font_awesome_icon | Name des Schriftartsymbols, das an das reservierbare Modul angehängt ist. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.inline_title | Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping | Details zur Struktur der Layoutzuordnung von Standorten. Verwenden Sie diese Daten, um die Informationen in der Benutzeroberfläche zu gestalten. Datentyp: Objekt |
| result.reservation.reservable_module.layout_mapping.body | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array von Objekten |
| result.reservation.reservable_module.layout_mapping.body.field | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.field_to_display | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.icon | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.label | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.description | Platzhalter für die Zuordnung der Front-End-UI-Daten. Beschreibung der Layoutzuordnung. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.image | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.subtitle | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.subtitle_asc | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.title | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.max_days_in_zukünftig | Maximale Anzahl der Tage in der Zukunft, für die ein Benutzer das reservierbare Modul reservieren kann. Datentyp: Zahl |
| result.reservation.reservable_module.max_occurrences | Maximale Anzahl wiederkehrender Reservierungen, wenn wiederkehrende Reservierungen für das reservierbare Modul verfügbar sind. Datentyp: Zahl |
| result.reservation.reservable_module.name | Name des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.override_approval_policy | Option zum Festlegen, wie die Genehmigungsrichtlinie zu implementieren ist. Die Auswahlmöglichkeiten lauten wie folgt:
Datentyp: Zeichenfolge |
| result.reservation.reservable_module.require_cancel_notes | Kennzeichnung, die angibt, ob Benutzer eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_cc_dept_check | Kennzeichnung, die angibt, ob zwischen dem Arbeitsbereichselement und dem angemeldeten Benutzer eine Kostenstelle oder Abteilungsabweichung besteht. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_subject | Kennzeichnung, die angibt, ob der Benutzer bei der Reservierung einen Betreff eingeben muss. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_columns | Liste der Spalten eines reservierbaren Elements. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Array |
| result.reservation.reservable_module.reservable_container_field | Ebene des Containers, z. B. eine Gruppe von Schreibtischen in einem bestimmten Bereich. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_filter | Filterbedingungen, die verwendet werden, um reservierbare Elemente in der zugehörigen Tabelle „Reservierbar“ herauszufiltern. Die Tabelle „Reservierbar“ ist ein Feld in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module]. Diese Filterbedingungen wurden auf die Tabelle angewendet, die im Feld Reservierbare Tabelle enthalten ist. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_quantity_field | Die reservierbare Menge aller Arbeitsbereiche. Die Menge wird verwendet, wenn einem Bereich angrenzende Arbeitsbereiche zugewiesen werden. Weitere Informationen finden Sie unter Aneinander angrenzende Bereiche einem Bereich zuweisen. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_table | Tabelle, die die reservierbaren Arbeitsplatzelemente enthält. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_type | Typ des reservierbaren Elements, z. B. Standort. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views | Details zu den verschiedenen Ansichten, die dem reservierbaren Modul zugeordnet sind, z. B. Kartenansicht oder Zeitplanansicht. Befindet sich in der Tabelle „Reservierbare Ansicht“ [sn_wsd_rsv_reservable_view]. Datentyp: Objekt |
| result.reservation.reservable_module.reservable_views.iconClass | Symbolklasse der reservierbaren Ansicht. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views.isDefault | Kennzeichnung, die angibt, ob diese reservierbare Ansicht als Standard für reservierbare Module festgelegt werden soll. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_views.label | Name der reservierbaren Ansicht. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views.order | Reihenfolge, in der die Ansichten für das reservierbare Modul in der Benutzeroberfläche angezeigt werden. Die niedrigere Ordnungszahl kommt in der Benutzeroberfläche zuerst. Bei gleicher Reihenfolgennummer wird eine zufällige Reihenfolge zugewiesen. Datentyp: Zahl |
| result.reservation.reservable_module.reservable_views.type | Back-End-Name der reservierbaren Ansicht. Wird für die interne Verarbeitung verwendet. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservation_paths | Reservierungspfade, die den reservierbaren Modulen zugeordnet sind, z. B. Alle durchsuchen, In der Nähe einer Person suchen. Datentyp: Array von Objekten |
| result.reservation.reservable_module.reservation_paths.display_value | Anzeigewert für den Reservierungspfad, z. B. „In der Nähe einer Person suchen“. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservation_paths.value | Interner Wert für den Reservierungspfad, z. B. „browse_near_a_person“. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.search_limit | Maximale Anzahl der Suchergebnisse, die zurückgegeben werden sollen, wenn ein Benutzer nach einem Arbeitsplatzstandort sucht. Datentyp: Zahl |
| result.reservation.reservable_module.selection_type | Der Typ der Auswahl, die in den Suchergebnissen angezeigt werden soll. Dies kann eine der folgenden Optionen sein:
Datentyp: Zeichenfolge |
| result.reservation.reservable_module.short_description | Kurze Beschreibung des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.show_map_view | Kennzeichnung, die angibt, ob die Zuordnungsansicht für reservierbare Module aktiviert werden soll. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.sys_id | Sys_id des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots | Details zu den Zeitfenstern, die einem reservierbaren Modul zugeordnet sind. Datentyp: Array von Objekten |
| result.reservation.reservable_module.timeSlots.name | Name des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.short_description | Kurze Beschreibung des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.slot_end | Endzeit des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.slot_start | Startzeit des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.sys_id | Sys_id des Zeitfenster-Datensatzes. Befindet sich in der Zeitfenstertabelle [sn_wsd_rsv_time_slot]. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.title | Titel des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.virtual_meeting_provider | Details zum virtuellen Anbieter, der dem reservierbaren Modul zugeordnet ist. Datentyp: Objekt |
| result.reservation.reservable_module.virtual_meeting_provider.display_value | Anzeigewert des Anbieters der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.virtual_meeting_provider.sys_id | Sys_id des Anbieters der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservation.reservationAcl | Details der Prüfungen der Benutzerzugriffskontrollebenen (ACL), die für die zugehörige Reservierung festgelegt wurden. Datentyp: Objekt |
| result.reservation.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write | Details zu den Schreibfähigkeiten des Benutzers für die zugehörige Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind im Objekt reservationACL.write.fields nur diese Felder „true“. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields | Details der Zugriffskontrollen in verschiedenen Feldern der Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Standortfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.number_of_attendees | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Felder für die Anzahl der Teilnehmer in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.requested_for | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die angeforderten Felder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.sensitivität | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.subject | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Betrefffelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.record | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservation_zweck | Details zum Zweck der Reservierung. Datentyp: Objekt |
| result.reservation.reservation_zweck.display_value | Anzeigewert für den Zweck der Reservierung, z. B. Unternehmensbesprechung. Datentyp: Zeichenfolge |
| result.reservation.reservation_zweck.wert | Interner Wert für den Zweck der Reservierung, z. B. company_meeting. Datentyp: Zeichenfolge |
| result.reservation.reservation_type | Details zum Typ der Reservierung. Datentyp: Objekt |
| result.reservation.reservation_type.display_value | Anzeigewert für den Typ der Reservierung, z. B. Platz. Datentyp: Zeichenfolge |
| result.reservation.reservation_type.value | Interner Wert für den Typ der Reservierung, z. B. Platz. Datentyp: Zeichenfolge |
| result.reservation.reservation_subtype | Details zum Untertyp der Reservierung. Untertypen geben den Typ der Reservierung an, z. B. Einzeln, Mehrfach übergeordnet, Mehrfach untergeordnet, Wiederkehrend übergeordnet oder Vorkommen. Datentyp: Objekt |
| result.reservation.reservation_subtype.display_value | Anzeigewert für den Untertyp der Reservierung, z. B. Einzeln. Datentyp: Zeichenfolge |
| result.reservation.reservation_subtype.value | Interner Wert für den Untertyp der Reservierung, z. B. Einzeln. Datentyp: Zeichenfolge |
| result.reservation.sensitivity | Details zur Vertraulichkeit der Reservierung. Datentyp: Objekt |
| result.reservation.sensitivity.display_value | Anzeigewert für die Empfindlichkeit der Reservierung, z. B. hoch oder niedrig. Datentyp: Zeichenfolge |
| result.reservation.sensitivity.value | Interner Wert für die Vertraulichkeit der Reservierung, z. B. 1 oder 3. Datentyp: Zeichenfolge |
| result.reservation.shift | Details zur Schicht, die auf die Reservierung angewendet wird. Datentyp: Objekt |
| result.reservation.shift.display_value | Anzeigewert der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.name | Der Name der Schicht Identisch mit display_value. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.schicht.schichtDetails | Details der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.sys_id | Sys_id des Schichtdatensatzes. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Datentyp: Zeichenfolge |
| result.reservation.source | Details zur Quelle für die Reservierung, z. B. Arbeitsplatzservices oder Google Mail. Datentyp: Objekt |
| result.reservation.source.display_value | Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices. Datentyp: Zeichenfolge |
| result.reservation.source.value | Interner Wert für die Reservierungsquelle, z. B. servicenow. Datentyp: Zeichenfolge |
| result.reservation.source_icon | Details zur Quelle des in der Reservierung verwendeten Symbols. Dieses Symbol wird in der Benutzeroberfläche verwendet. Datentyp: Objekt |
| result.reservation.source_icon.classNames | Kommagetrennte Klassennamen für das Quellsymbol. Datentyp: Zeichenfolge |
| result.reservation.source_icon.imgSrc | Name der Bildquelle für das Quellsymbol. Dieses Symbol wird in der Tabelle „Bilder“ [db_image] gespeichert. Datentyp: Zeichenfolge |
| result.reservation.source_icon.tooltip | Tooltip, der dem Quellsymbol zugeordnet ist. Datentyp: Zeichenfolge |
| result.reservation.source_reservation | Quellreservierung der aktuellen Reservierung. Beispiel: Bei mehreren Reservierungen ist die übergeordnete Reservierung die Quelle der untergeordneten Reservierung. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Start | Startdatum und -uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC - jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| result.reservation.subject | Betreff der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.sub_source | Details zur Unterquelle der Reservierung. Die Unterquelle gibt an, woher die Reservierung stammt, z. B. Google Kalender oder Microsoft Exchange. Datentyp: Objekt |
| result.reservation.sub_source.display_value | Anzeigewert für die Unterquelle der Reservierung, z. B. Google Kalender. Datentyp: Zeichenfolge |
| result.reservation.sub_source.value | Interner Wert des Unterquellenfelds der Reservierung, z. B. google_calendar. Datentyp: Zeichenfolge |
| result.reservation.sync_state | Details zum Synchronisierungsstatus einer Reservierung von einem anderen Service, z. B. „sync_enqueued“ oder „synchronized“. Datentyp: Objekt |
| result.reservation.sync_state.display_value | Anzeigewert für den aktuellen Synchronisierungsstatus der Reservierung, z. B. „synchronisiert“. Datentyp: Zeichenfolge |
| result.reservation.sync_state.value | Interner Wert des aktuellen Synchronisierungsstatus der Reservierung, z. B. „synchronisiert“. Datentyp: Zeichenfolge |
| result.reservation.sys_created_on | Datum und Uhrzeit der Erstellung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.sys_id | Erforderlich. Sys_id des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.virtual_meeting | URL des Links der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservationAcl | Details der Prüfungen der Benutzerzugriffskontrollebenen (ACL), die für die zugehörige Reservierung festgelegt wurden. Datentyp: Objekt |
| result.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write | Details zu den Schreibfähigkeiten des Benutzers für die zugehörige Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind im Objekt reservationACL.write.fields nur diese Felder „true“. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields | Details der Zugriffskontrollen in verschiedenen Feldern der Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Standortfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.number_of_attendees | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Felder für die Anzahl der Teilnehmer in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.requested_for | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die angeforderten Felder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.sensitivity | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.subject | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Betrefffelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.record | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.standard_services | Wird nur ausgefüllt, wenn der Parameter include_standard_services auf „true“ festgelegt ist. Zugehörige Standardservices, z. B. Flipchart, Bildschirm, Whiteboard und Marker. Datentyp: Array von Objekten
|
| result.standard_services.font_awesome_icon | Name des Miniatursymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| result.standard_services.name | Name des Standardservice. Datentyp: Zeichenfolge |
| result.standard_services.short_description | Kurze Beschreibung des Standardservice. Datentyp: Zeichenfolge |
| result.standard_services.sys_id | Sys_id des Standardservicedatensatzes. Befindet sich in der Tabelle „Standardservice“ [sn_wsd_rsv_standard_service]. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen und die Informationen zu Standardservices eingeschlossen wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/get?sys_id=8e87c722870741106342b846dabb3573&include_standard_services=true" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Ergebnisse zurückgeben:
"result": {
"reservation": {
"sys_id": "bf3621de842c2110fa9b813be354f327",
"number": "WRES0001005",
"location": {
"sys_id": "9841e94adb7210106c731dcd13961914",
"name": "A1-02-02",
"description": "General desk available for reservation.",
"display_value": "A1-02-02",
"capacity": 1,
"label_value": "Workspace/Desk name",
"wsd_email": null,
"reservable_module": {
"sys_id": "5db44502dbb650106c731dcd13961937",
"name": "Desks",
"title": "Desks",
"inline_title": "desk",
"table": "sn_wsd_core_space"
},
"region": {
"sys_id": "3752ac8edb3650106c731dcd139619e0",
"display_value": "Americas",
"active": true
},
"site": {
"sys_id": "628eec06db7650106c731dcd139619dd",
"display_value": "North America",
"active": true
},
"campus": {
"sys_id": "82b2a0cedb3650106c731dcd139619e9",
"display_value": "California Campus",
"active": true
},
"building": {
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"active": true,
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"floor": {
"sys_id": "fc7368cedb3650106c731dcd13961902",
"display_value": "Floor 1",
"active": true
},
"area": {
"sys_id": "",
"display_value": "",
"active": false
},
"is_favorite": false,
"reservation": {
"sys_id": "bf3621de842c2110fa9b813be354f327",
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"auto_conflict_resolution_state": {
"value": null,
"display_value": null
},
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"name": "System Administrator",
"user_name": "admin"
},
"number": "WRES0001005",
"active": true
},
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"number": "WRES0001005",
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"name": "System Administrator",
"user_name": "admin"
},
"is_private": true
},
"start": "2023-01-24T16:00:00Z",
"end": "2023-01-24T17:00:00Z",
"sys_created_on": "2023-01-24T15:49:49Z",
"sys_updated_on": "2023-01-24T15:49:50Z",
"source_reservation": null,
"check_in_state": {
"value": "awaiting_check_in",
"display_value": "Awaiting check-in"
},
"external_id": null,
"external_ical": null,
"building": {
"active": true,
"sys_id": "94e264cedb3650106c731dcd13961919",
"display_value": "CAL-B1",
"campus": {
"display_value": "California Campus",
"value": "82b2a0cedb3650106c731dcd139619e9",
"active": true
},
"site": {
"display_value": "North America",
"value": "628eec06db7650106c731dcd139619dd",
"active": true
},
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
},
"active": true,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"sensitivity": {
"value": "normal",
"display_value": "Normal"
},
"reservation_type": {
"value": "space",
"display_value": "Space"
},
"reservation_subtype": {
"value": "single",
"display_value": "Single"
},
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"attendees": [
{
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
}
],
"number_of_attendees": 1,
"is_parent": false,
"is_private": true,
"subject": "Reservation for A1-02-02",
"virtual_meeting": null,
"recording_details": [],
"sync_state": {
"value": "not_required",
"display_value": "Synchronization not required"
},
"sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"last_updated_sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"reservable_module": {
"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": null,
"enable_reservation_privacy": true,
"allow_invitees": "1",
"display_number_of_attendees": null,
"display_on_behalf_of": "1",
"display_sensitivity": null,
"max_days_in_future": "90",
"allow_recurring": "1",
"auto_resolve_conflict": null,
"allow_whole_day": "1",
"allow_multi_building": "1",
"require_whole_day": null,
"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_floor_search": null,
"enable_browse_by_neighborhood": null,
"require_cc_dept_check": false,
"display_value": "Desks",
"browse_near_a_person_enabled": true,
"browse_by_area_enabled": true,
"browse_by_neighborhood_enabled": false,
"reservable_columns": [
"sys_id",
"external_id",
"wsd_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": [
"03c45bf7dba41010d7981dcd1396196d",
"07c45bf7dba41010d7981dcd1396196b",
"07c45bf7dba41010d7981dcd13961972",
"0bc45bf7dba41010d7981dcd13961970",
"0fc45bf7dba41010d7981dcd1396196e",
"1aa39b1977220110b3d7be377b5a9953",
"2130659ae7321010809a268b03f6a91e",
"22c41bf7dba41010d7981dcd139619fe",
"2ac45bf7dba41010d7981dcd13961901",
"2ec41bf7dba41010d7981dcd139619ff",
"32c45bf7dba41010d7981dcd13961905",
"32c45bf7dba41010d7981dcd1396190c",
"32c45bf7dba41010d7981dcd13961943",
"e2c41bf7dba41010d7981dcd139619fb"
],
"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",
"availableFor": true
},
{
"value": "browse_favorites",
"displayValue": "Browse favorites",
"availableFor": false
},
{
"value": "browse_near_a_person",
"displayValue": "Browse near a person",
"availableFor": true
},
{
"value": "browse_by_area",
"displayValue": "Browse by area",
"availableFor": true
}
],
"override_approval_policy": "never_required"
},
"notification_recipients": null,
"notification_custom_message": null,
"opened_by": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
},
"requested_for": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "a5d3c898c3222010ae17dd981840dd8b.iix?t=small",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator, Finance"
},
"auto_conflict_resolution_state": {
"value": null,
"display_value": null
},
"parent_reservation": {},
"edit_restriction": {
"value": "no_restriction",
"display_value": "No restriction"
},
"source": {
"value": "servicenow",
"display_value": "Workplace Services"
},
"source_icon": {
"classNames": "fa fa-calendar-check-o",
"tooltip": "Reservation is confirmed",
"imgSrc": ""
},
"shift": null,
"hasPrivateReservation": true,
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true,
"is_private": true
},
"allFields": true
},
"read": true
}
},
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true,
"is_private": true
},
"allFields": true
},
"read": true
}
}
}
WSD-Reservierung – GET /api/sn_wsd_rsv/reservation/get_user_reservations
Ruft die Reservierungsliste für einen angegebenen Anwender für die nächsten sieben Tage ab.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/get_user_reservations
Standard-URL: /api/sn_wsd_rsv/reservation/get_user_reservations
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| userId | Sys_id des Benutzers, dessen Reservierungen zurückgegeben werden sollen. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| Ergebnis | Reservierungsrückgabeergebnisse. Datentyp: Objekt |
| result.informMitarbeiterDatenschutz | Kennzeichnung, die angibt, ob eine Nachricht angezeigt werden soll, wenn Reservierungen zurückgegeben werden, die als privat markiert sind. Mögliche Werte:
Datentyp: Boolesch |
| result.reservationsByDate | Details zu jeder Reservierung nach Datum. Datentyp: Objekt – jedes Datum in einem eigenen Array |
| result.reservationsByDate.building | Gebäude, in dem sich das reservierbare Element befindet Diese Informationen befinden sich in der Gebäudetabelle [sn_wsd_core_building]. |
| result.reservationsByDate.building.display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| result.reservationsByDate.building.sys_id | Sys_id des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.reservationsByDate.building.timezone | Details der Zeitzone für das Gebäude. |
| result.reservationsByDate.building.timezone.display_value | Anzeigewert der Zeitzone, in der sich das zugeordnete Gebäude befindet. Datentyp: Zeichenfolge |
| result.reservationsByDate.building.timezone.sys_id | Sys_id des Zeitzonendatensatzes, in dem sich das zugeordnete Gebäude befindet. Datentyp: Zeichenfolge |
| result.reservationsByDate.building.value | Interner Wert für das Gebäude. Datentyp: Zeichenfolge |
| result.reservationsByDate.stockwerk | Details zum Stockwerk, das der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservationsByDate.stockwerk.anzeigeWert | Zeigen Sie die Nummer des Stockwerks an, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| result.reservationsByDate.stockwerk.wert | Interner Wert des Stockwerks, in dem sich die Reservierung befindet. Datentyp: Zeichenfolge |
| result.reservationsByDate.location | Details zum Standort der Reservierung. Datentyp: Objekt |
| result.reservationsByDate.location.displayValue | Anzeigewert des Standorts, z. B. South Parks. Datentyp: Zeichenfolge |
| result.reservationsByDate.location.type | Typ des Standorts, z. B. Arbeitsplatz/Schreibtisch, Café oder Fitnessstudio. Datentyp: Zeichenfolge |
| result.reservationsByDate.location.value | Interner Wert für den Standort, z. B. „south_parks“. Datentyp: Zeichenfolge |
| result.searchEndDate | Enddatum der Reservierungssuche. Sieben Tage nach dem Startdatum. Format: jjjj-mm-tt Datentyp: Zeichenfolge |
| result.searchStartDate | Startdatum der Reservierungssuche. Datum, an dem der Endpunkt aufgerufen wurde Format: jjjj-mm-tt Datentyp: Zeichenfolge |
| result.sortedReservationDates | Daten, für die der angegebene Benutzer Reservierungen für die nächsten sieben Tage hat, sortiert nach Datum. Datentyp: Array |
| result.workplaceProfile | Arbeitsplatzprofil des Benutzers. Beschreibt, wo der angegebene Anwender arbeitet. Datentyp: Objekt |
| result.workplaceProfile.building | Gebäude, in dem der Benutzer arbeitet. Diese Informationen befinden sich in der Gebäudetabelle [sn_wsd_core_building]. |
| result.workplaceProfile.building.display_value | Anzeigewert für das Gebäude. Datentyp: Zeichenfolge |
| result.workplaceProfile.building.sys_id | Sys_id des zugeordneten Gebäudedatensatzes. Datentyp: Zeichenfolge |
| result.workplaceProfile.building.timezone | Details der Zeitzone für das Gebäude. |
| result.workplaceProfile.building.timezone.display_value | Anzeigewert der Zeitzone, in der sich das zugeordnete Gebäude befindet. Datentyp: Zeichenfolge |
| result.workplaceProfile.building.timezone.sys_id | Sys_id des Zeitzonendatensatzes, in dem sich das zugeordnete Gebäude befindet. Datentyp: Zeichenfolge |
| result.workplaceProfile.building.value | Interner Wert für das Gebäude. Datentyp: Zeichenfolge |
| result.workplaceProfile.stockwerk | Details zum Stockwerk, in dem der Benutzer arbeitet. Datentyp: Objekt |
| result.workplaceProfile.stockwerk.displayValue | Zeigen Sie die Nummer des Stockwerks an, in dem der Benutzer arbeitet, z. B. Stockwerk 8. Datentyp: Zeichenfolge |
| result.workplaceProfile.stockwerk.wert | Interner Wert des Stockwerks, in dem der Benutzer arbeitet. Datentyp: Zeichenfolge |
| result.workplaceProfile.location | Details zum Standort des Benutzers. Datentyp: Objekt |
| result.workplaceProfile.location.displayValue | Anzeigewert des Standorts, z. B. San Diego. Datentyp: Zeichenfolge |
| result.workplaceProfile.location.type | Typ des Standorts, z. B. Schreibtisch oder Büro. Datentyp: Zeichenfolge |
| result.workplaceProfile.location.value | Interner Wert für den Standort, z. B. san_diego. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/get_user_reservations?userId=2de07e1887cb89106342b846dabb35fe" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Ergebnisse zurückgeben:
{
"result": {
"sortedReservationDates": [
"2023-01-24"
],
"workplaceProfile": {
"location": {
"displayValue": "DDC-A2.0016A",
"value": "96d3139977220110b3d7be377b5a9918",
"externalId": "0e7bddfb475a011064062782846d43c2",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 2",
"value": "68d31f5977220110b3d7be377b5a991b"
},
"building": {
"displayValue": "Building A",
"value": "dea39b1977220110b3d7be377b5a9955",
"timezone": {
"value": "Europe/Paris",
"displayValue": "Europe/Paris"
}
}
},
"reservationsByDate": {
"2023-01-24": [
{
"location": {
"displayValue": "A1-02-04",
"value": "3e41e94adb7210106c731dcd1396198c",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
},
{
"location": {
"displayValue": "A1-02-02",
"value": "9841e94adb7210106c731dcd13961914",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
},
{
"location": {
"displayValue": "A1-02-03",
"value": "fd41a94adb7210106c731dcd1396195a",
"externalId": "",
"type": "Workspace/Desk"
},
"floor": {
"displayValue": "Floor 1",
"value": "fc7368cedb3650106c731dcd13961902"
},
"building": {
"displayValue": "CAL-B1",
"value": "94e264cedb3650106c731dcd13961919",
"timezone": {
"value": "US/Pacific",
"displayValue": "US/Pacific"
}
}
}
]
},
"searchStartDate": "2023-01-24",
"searchEndDate": "2023-01-31",
"informEmployeePrivacy": true
}
}
WSD Reservation – GET /api/sn_wsd_rsv/reservation/icalendar/{sys_id}
Generiert einen iCalendar-Dateitext für eine angegebene Reservierung.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/icalendar/{sys_id}
Standard-URL: /api/sn_wsd_rsv/reservation/icalendar/{sys_id}
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | Sys_id der Reservierung, für die ein iCalendar-Dateitext generiert werden soll. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
| Name | Beschreibung |
|---|---|
| Keine |
Kopfzeilen
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| Ergebnis | iCalendar-Dateitext für die angegebene Reservierung. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird, um einen iCalender-Text zu erstellen.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/icalendar/60d26a0f47578910003a4587746d4331" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Ergebnisse zurückgeben:
{
"result": "BEGIN:VCALENDAR\nPRODID:-//Service-now.com//Outlook 11.0 MIMEDIR//EN\nVERSION:2.0\nMETHOD:REQUEST\nBEGIN:VEVENT\nATTENDEE;ROLE=REQ-PARTICIPANT;RSVP=TRUE:MAILTO:workplace_user@example.com\nDTSTART:20220521T050000Z\nDTEND:20220521T060000Z\nUID:60d26a0f47578910003a4587746d4331\nDTSTAMP:20220511T044018Z\nSUMMARY:For user 1\nDESCRIPTION:Dear System Administrator,\\n\\nThank you for your reservation.\\n\\nYou can find more details on your reservation, or manage your reservation using the following link: https://damay2.service-now.com/ws?id=wsd_reservation_summary&reservation_id=60d26a0f47578910003a4587746d4331\\n\\nKind regards,\\nWorkplace Services Team\nLOCATION:Berlin\nCLASS:PUBLIC\nORGANIZER;CN=Workplace User:MAILTO:workplace_user@example.com\nATTENDEE;ROLE=REQ-PARTICIPANT;CN=Workplace User:RSVP=TRUE:MAILTO:workplace_user@example.com\nEND:VEVENT\nEND:VCALENDAR"
}
WSD-Reservierung – GET /api/sn_wsd_rsv/reservation/list
Ruft die Liste der Reservierungen ab, die zu einem angegebenen Anwender gehören.
Dieser Endpunkt gibt nur Reservierungen zurück, die für den angegebenen Benutzer angefordert oder von diesem geöffnet wurden.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/list
Standard-URL: /api/sn_wsd_rsv/reservation/list
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| encodedQuery | Codierte Abfrage, die zum Filtern der zurückgegebenen Reservierungsdatensatzergebnisse verwendet werden soll. Alle Felder in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation] sind innerhalb der Abfrage gültig. Beispiel: Datentyp: Zeichenfolge |
| endIndex | Letzter Reservierungsdatensatz in der Ergebnismenge, die zurückgegeben werden soll, wenn Indizes für die Paginierung angegeben werden. Wenn dieser Wert größer als die verfügbare Anzahl der Rückgabeergebnisdatensätze ist, werden alle verbleibenden Datensätze zurückgegeben. Datentyp: Zahl |
| orderByEndDesc | Kennzeichnung, die angibt, ob die Ergebnisse in absteigender Reihenfolge der Startzeit zurückgegeben werden sollen. Gültige Werte:
Standardwert: false |
| Suchkriterien | Text, der innerhalb der Reservierung übereinstimmen muss, damit er in die Rückgabeergebnisse aufgenommen wird. Der Endpunkt prüft auf diesen Wert in den folgenden Feldern:
Datentyp: Zeichenfolge |
| startIndex | Startdatensatz, für den Datensätze zurückgegeben werden sollen, nullbasiert. Verwenden Sie diesen Parameter, um große Datensätze zu paginieren. Datentyp: Zeichenfolge Standard: 0 |
| userId | Sys_id eines Benutzers, um die zurückgegebenen Reservierungsinformationen herauszufiltern. Befindet sich in der Benutzertabelle [sys_user]. Wenn dieser Wert übergeben wird, filtert der Endpunkt die Reservierungen heraus, bei denen das Feld requested_for oder opened_by dem aktuell angemeldeten Benutzer entspricht. Aus dieser Reservierungsliste werden dann die Reservierungen herausgefiltert, bei denen „angefordert_for“ oder „opened_by“ dem übergebenen userIdentspricht. Datentyp: Zeichenfolge Standard: Gibt alle Reservierungen zurück, bei denen die Felder „angefordert für“ oder „opened_by“ dem aktuell angemeldeten Benutzer entsprechen. |
| Header | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml. Standard: application/json |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| Ergebnis.Reservierung | Details zur Reservierung. Datentyp: Objekt |
| result.reservation.active | Kennzeichnung, die angibt, ob die Reservierung aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| Ergebnis.Reservierung.Teilnehmer | Liste der Teilnehmer für die Reservierung. Datentyp: Array von Objekten |
| Ergebnis.Reservierung.Teilnehmer.Avatar | Sys_id des Avatars, der dem Teilnehmer zugeordnet ist. Befindet sich in der Tabelle „Anhänge“ [sys_attachment]. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.displayValue | Anzeigewert für den Teilnehmer. Datentyp: Zeichenfolge |
| result.reservation.attendees.display_value | Anzeigewert des Teilnehmers. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.attendees.email | E-Mail-Adresse des Teilnehmers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Initialen | Initialen des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.attendees.name | Name des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.sys_id | Sys_id_des Teilnehmerdatensatzes. Datentyp: Zeichenfolge |
| result.reservation.teilnehmer.tabelle | Tabelle, in der der Teilnehmerdatensatz vorhanden ist. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Benutzername | Benutzername des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.attendees.value | Interner Wert des Teilnehmers. Datentyp: Zeichenfolge |
| result.reservation.check_in_state | Details zum Check-in-Status der Reservierung. Datentyp: Objekt |
| result.reservation.check_in_state.display_value | Anzeigewert für den aktuellen Check-in-Status der Reservierung, z. B. In Bearbeitung oder Abgeschlossen. Datentyp: Zeichenfolge |
| result.reservation.check_in_state.value | Interner Wert für den aktuellen Check-in-Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.edit_restriction | Beschreibung der Benutzerbearbeitungsbeschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „complete_restricted“. Datentyp: Objekt |
| result.reservation.edit_restriction.display_value | Anzeigewert für die Bearbeitungsbeschränkungen für die Reservierung, z. B. Keine Einschränkung. Datentyp: Zeichenfolge |
| result.reservation.edit_restriction.value | Interner Wert für die Bearbeitungsbeschränkungen für die Reservierung, z. B. no_restriction. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Ende | Enddatum und -uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC: jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| result.reservation.external_ical | Eindeutige externe iCalendar-Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Datentyp: Zeichenfolge |
| result.reservation.external_id | Eindeutige externe Identifizierung der Reservierung. Verwenden Sie diesen Wert, um die Reservierung zu identifizieren, wenn es sich um eine Reservierung im Zusammenhang mit der Kalendersynchronisierung handelt. Datentyp: Zeichenfolge |
| result.reservation.is_parent | Kennzeichnung, die angibt, ob diese Reservierung eine übergeordnete Reservierung ist. Mögliche Werte:
Datentyp: Boolesch |
| result.reservation.is_private | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung nur dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Standort-Datenschutzeinstellungen und Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: In den Systemeigenschaften für Datenschutz festgelegter Wert. |
| result.reservation.last_updated_sub_source | Details zur zuletzt aktualisierten Unterquelle für die Reservierung. Unterquellen werden bei der Integration von Reservierungen mit einem externen Kalender verwendet. Dieses Objekt enthält Informationen wie „servicenow_workplace_service_delivery“, „google_calendar“ oder „microsoft_exchange“. Datentyp: Objekt |
| result.reservation.last_updated_sub_source.display_value | Anzeigewert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. ServiceNow Workplace Service Delivery oder Google Kalender. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird. Datentyp: Zeichenfolge |
| result.reservation.last_updated_sub_source.value | Interner Wert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. servicenow_workplace_service_delivery oder google_calendar. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird. Datentyp: Zeichenfolge |
| result.reservation.location | Details zum Standort, der der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.area | Details zum Bereich, der dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.area.active | Kennzeichnung, die angibt, ob der Bereich aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.area.display_value | Anzeigewert des Bereichs, zu dem dieser Standort gehört, z. B. Schreibtisch A2. Datentyp: Zeichenfolge |
| result.reservation.location.area.sys_id | Sys_id des Bereichs, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Bereich“ [sn_wsd_core_area]. Datentyp: Zeichenfolge |
| result.reservation.location.building | Details zum Gebäude, das dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.building.active | Kennzeichnung, die angibt, ob das Gebäude aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.building.display_value | Anzeigewert des Gebäudes, zu dem dieser Standort gehört, z. B. AMS - Geb. 1. Datentyp: Zeichenfolge |
| result.reservation.location.building.sys_id | Sys_id des Gebäudes, zu dem dieser Standort gehört. Befindet sich in der Gebäudetabelle [sn_wsd_core_building]. Datentyp: Zeichenfolge |
| result.reservation.location.building.timezone | Details zur Zeitzone, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.building.timezone.display_value | Anzeigewert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| result.reservation.location.building.timezone.value | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| result.reservation.location.campus | Details zum Campus, der dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.campus.active | Kennzeichnung, die angibt, ob der Campus aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.campus.display_value | Anzeigewert des Campus, zu dem dieser Standort gehört, z. B. Campus Amsterdam. Datentyp: Zeichenfolge |
| result.reservation.location.campus.sys_id | Sys_id des Campus, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Campus“ [sn_wsd_core_campus]. Datentyp: Zeichenfolge |
| result.reservation.location.capacity | Maximale Anzahl von Personen für den Standort. Datentyp: Zahl |
| result.reservation.location.description | Kurze Beschreibung des Standorts. Datentyp: Zeichenfolge |
| result.reservation.location.display_value | Wert, der in der Benutzeroberfläche für diesen Standort angezeigt werden soll. Datentyp: Zeichenfolge |
| result.reservation.location.email | E-Mail-Adresse für den Standort. Datentyp: Zeichenfolge |
| result.reservation.location.stockwerk | Details zum Stockwerk, das dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.floor.active | Kennzeichnung, die angibt, ob das Stockwerk aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.stockwerk.display_value | Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erstes Stockwerk. Datentyp: Zeichenfolge |
| result.reservation.location.stockwerk.sys_id | Sys_id des Stockwerks, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Stockwerk“ [sn_wsd_core_floor]. Datentyp: Zeichenfolge |
| result.reservation.location.label_value | Typ des im Parameter name angegebenen Werts, z. B. Raumname. Datentyp: Zeichenfolge |
| result.reservation.location.name | Name des Standorts. Datentyp: Zeichenfolge |
| result.reservation.location.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.number_of_attendees | Anzahl der Teilnehmer für die Reservierung. Datentyp: Zahl |
| result.reservation.location.region | Details zur Region, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.region.active | Kennzeichnung, die angibt, ob die Region aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.region.display_value | Anzeigewert der Region, zu der dieser Standort gehört, z. B. Europa. Datentyp: Zeichenfolge |
| result.reservation.location.region.sys_id | Sys_id der Region, zu der dieser Standort gehört. Befindet sich in der Tabelle „Region“ [sn_wsd_core_region]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for | Details zur Person, für die die Reservierung im Namen von angefordert wurde. Datentyp: Objekt |
| result.reservation.location.requested_for.name | Name des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.sys_id | Sys_id des Benutzers, für den die Reservierung angefordert wird. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.user_name | Benutzername des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservation | Details zur Reservierung, die dem Standort zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.reservation.active | Kennzeichnung, die angibt, ob die Reservierung aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.reservation.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.number_of_attendees | Anzahl der Teilnehmer der Reservierung. Datentyp: Zahl |
| result.reservation.location.reservation.requested_for | Details zur Person, für die die Reservierung im Namen von angefordert wurde. Datentyp: Objekt |
| result.reservation.location.reservation.requested_for.name | Name des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.sys_id | Sys_id des angeforderten Anwenders. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.user_name | Benutzername des Benutzers, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module | Details zum reservierbaren Modul, das der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservation.location.reservable_module.inline_title | Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.name | Name des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.sys_id | Sys_id des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.reservable_module.title | Titel des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.location.site | Site, zu der der Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Objekt |
| result.reservation.location.site.active | Kennzeichnung, die angibt, ob die Site aktiv ist. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.location.site.display_value | Anzeigewert des Standorts, zu dem dieser Standort gehört, z. B. Westeuropa. Datentyp: Zeichenfolge |
| result.reservation.location.site.sys_id | Sys_id des Standorts, zu dem dieser Speicherort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Zeichenfolge |
| result.reservation.location.state | Details zum Status der Reservierung für den Standort. Datentyp: Objekt |
| result.reservation.location.state.display_value | Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“. Datentyp: Zeichenfolge |
| result.reservation.location.state.value | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.location.sys_id | Sys_id des zugeordneten Standortdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| result.reservation.notification_custom_message | Benutzerdefinierte Nachricht für die Benachrichtigung, die an die in reservation.notification_recipientsaufgeführten Empfänger gesendet wird. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients | Liste der Empfänger, die Benachrichtigungen über die Reservierung erhalten. Datentyp: Array von Objekten |
| result.reservation.notification_recipients.name | Name des Empfängers. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.sys_id | Sys_id des Empfängers. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.user_name | Benutzername des Empfängers. Datentyp: Zeichenfolge |
| result.reservation.number | Eindeutige Nummer des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Sie können diesen Wert verwenden, um die Reservierung abzufragen. Datentyp: Zeichenfolge |
| result.reservation.opened_by | Details zum Benutzer, der die Reservierung erstellt hat. Datentyp: Objekt |
| result.reservation.opened_by.avatar | Avatar für den Benutzer, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.displayValue | Anzeigewert des Benutzers, der ihn geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.display_value | Anzeigewert des Benutzers, der ihn geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.email | E-Mail-Adresse des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.initials | Initialen des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.label | Bezeichnung für den Benutzer, der die Reservierung geöffnet hat. Dies ist eine Kombination aus Titel und Abteilung des Benutzers. Datentyp: Zeichenfolge |
| result.reservation.opened_by.name | Name des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.rservation.opened_by.sys_id | Sys_id_of des Benutzers, der die Reservierung geöffnet hat. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.opened_by.table | Tabelle, die den Benutzerdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.opened_by.user_name | Benutzername des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.value | Interner Wert des Benutzers, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.number | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.number_of_attendees | Anzahl der Teilnehmer in dieser Reservierung. Datentyp: Zahl |
| result.reservation.recording_details | Details zu den Aufzeichnungen, die der Reservierung (Besprechung) zugeordnet sind. Datentyp: Array |
| result.reservation.recording_details.recording_url | URL der Aufzeichnungen, die der Reservierung zugeordnet sind. Datentyp: Zeichenfolge |
| result.reservation.requested_for | Details zum Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Objekt |
| result.reservation.requested_for.avatar | Avatar für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.displayValue | Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.display_value | Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.requested_for.email | E-Mail-Adresse des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.initials | Initialen des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.label | Bezeichnung für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.name | Name des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.rservation.requested_for.sys_id | Sys_id_of des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.requested_for.table | Tabelle, die den Benutzerdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.requested_for.user_name | Benutzername des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.value | Interner Wert des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.reservable_module | Details für das angeforderte reservierbare Modul. Datentyp: Objekt |
| result.reservation.reservable_module.allow_invitees | Kennzeichnung, die angibt, ob Mitarbeiter der Reservierung eingeladene Personen hinzufügen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.allow_wholt_day | Kennzeichnung, die angibt, ob Benutzer das reservierbare Element für den gesamten Tag reservieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.apply_to_shift | Kennzeichnung, die angibt, ob schichtbasierte Reservierungen für das reservierbare Modul aktiviert sind. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_by_area_enabled | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_near_a_person_enabled | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.buildingSysIds | Liste der sys_ids der Gebäude, die dem reservierbaren Modul zugeordnet sind. Datentyp: Array von Zeichenfolgen |
| result.reservation.reservable_module.checkin_before_minutes | Zeitraum vor Beginn einer Reservierung, in dem ein Benutzer in seine Reservierung einchecken kann. Einheit: Minuten Datentyp: Zahl |
| result.reservation.reservable_module.display_number_of_attendees | Kennzeichnung, die angibt, ob Benutzer die Anzahl der Teilnehmer in der Reservierung angeben können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_on_behalb_von | Kennzeichnung, die angibt, ob Reservierungen im Namen einer anderen Person vorgenommen werden können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_sensitivity | Kennzeichnung, die angibt, ob Benutzer die Vertraulichkeit der Reservierung festlegen können, z. B. „Normal“ oder „Privat“. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.display_value | Anzeigewert des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.enable_browse_by_area | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können. Identisch mit browse_by_area_enabled. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_browse_near_a_person | Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Identisch mit browse_near_a_person_enabled. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_facet_filter | Kennzeichnung, die angibt, ob die Aspektfilterung für Arbeitsplatzelemente aktiviert ist. Wenn diese Option aktiviert ist, basieren die angezeigten Filteroptionen auf den Suchergebnissen. Nur die Elemente, die im generierten Suchergebnis verfügbar sind, stehen Benutzern zur Auswahl im Filter zur Verfügung. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_group_reservations | Kennzeichnung, die angibt, ob Benutzer eine Gruppenreservierung vornehmen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_ical_generation | Kennzeichnung, die angibt, ob Benutzer einen iCalendar für die Reservierung generieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.font_awesome_icon | Name des Schriftartsymbols, das an das reservierbare Modul angehängt ist. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.inline_title | Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping | Details zur Struktur der Layoutzuordnung von Standorten. Verwenden Sie diese Daten, um die Informationen in der Benutzeroberfläche zu gestalten. Datentyp: Objekt |
| result.reservation.reservable_module.layout_mapping.body | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array von Objekten |
| result.reservation.reservable_module.layout_mapping.body.field | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.field_to_display | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.icon | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.body.label | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.description | Platzhalter für die Zuordnung der Front-End-UI-Daten. Beschreibung der Layoutzuordnung. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.image | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.layout_mapping.subtitle | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.subtitle_asc | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.layout_mapping.title | Platzhalter für die Zuordnung der Front-End-UI-Daten. Datentyp: Array |
| result.reservation.reservable_module.max_days_in_zukünftig | Maximale Anzahl der Tage in der Zukunft, für die ein Benutzer das reservierbare Modul reservieren kann. Datentyp: Zahl |
| result.reservation.reservable_module.max_occurrences | Maximale Anzahl wiederkehrender Reservierungen, wenn wiederkehrende Reservierungen für das reservierbare Modul verfügbar sind. Datentyp: Zahl |
| result.reservation.reservable_module.name | Name des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.override_approval_policy | Option zum Festlegen, wie die Genehmigungsrichtlinie zu implementieren ist. Die Auswahlmöglichkeiten lauten wie folgt:
Datentyp: Zeichenfolge |
| result.reservation.reservable_module.require_cancel_notes | Kennzeichnung, die angibt, ob Benutzer eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_cc_dept_check | Kennzeichnung, die angibt, ob zwischen dem Arbeitsbereichselement und dem angemeldeten Benutzer eine Kostenstelle oder Abteilungsabweichung besteht. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_subject | Kennzeichnung, die angibt, ob der Benutzer bei der Reservierung einen Betreff eingeben muss. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_columns | Liste der Spalten eines reservierbaren Elements. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Array |
| result.reservation.reservable_module.reservable_container_field | Ebene des Containers, z. B. eine Gruppe von Schreibtischen in einem bestimmten Bereich. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_filter | Filterbedingungen, die verwendet werden, um reservierbare Elemente in der zugehörigen Tabelle „Reservierbar“ herauszufiltern. Die Tabelle „Reservierbar“ ist ein Feld in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module]. Diese Filterbedingungen wurden auf die Tabelle angewendet, die im Feld Reservierbare Tabelle enthalten ist. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_quantity_field | Die reservierbare Menge aller Arbeitsbereiche. Die Menge wird verwendet, wenn einem Bereich angrenzende Arbeitsbereiche zugewiesen werden. Weitere Informationen finden Sie unter Aneinander angrenzende Bereiche einem Bereich zuweisen. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_table | Tabelle, die die reservierbaren Arbeitsplatzelemente enthält. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_type | Typ des reservierbaren Elements, z. B. Standort. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views | Details zu den verschiedenen Ansichten, die dem reservierbaren Modul zugeordnet sind, z. B. Kartenansicht oder Zeitplanansicht. Befindet sich in der Tabelle „Reservierbare Ansicht“ [sn_wsd_rsv_reservable_view]. Datentyp: Objekt |
| result.reservation.reservable_module.reservable_views.iconClass | Symbolklasse der reservierbaren Ansicht. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views.isDefault | Kennzeichnung, die angibt, ob diese reservierbare Ansicht als Standard für reservierbare Module festgelegt werden soll. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_views.label | Name der reservierbaren Ansicht. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservable_views.order | Reihenfolge, in der die Ansichten für das reservierbare Modul in der Benutzeroberfläche angezeigt werden. Die niedrigere Ordnungszahl kommt in der Benutzeroberfläche zuerst. Bei gleicher Reihenfolgennummer wird eine zufällige Reihenfolge zugewiesen. Datentyp: Zahl |
| result.reservation.reservable_module.reservable_views.type | Back-End-Name der reservierbaren Ansicht. Wird für die interne Verarbeitung verwendet. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservation_paths | Reservierungspfade, die den reservierbaren Modulen zugeordnet sind, z. B. Alle durchsuchen, In der Nähe einer Person suchen. Datentyp: Array von Objekten |
| result.reservation.reservable_module.reservation_paths.display_value | Anzeigewert für den Reservierungspfad, z. B. „In der Nähe einer Person suchen“. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.reservation_paths.value | Interner Wert für den Reservierungspfad, z. B. „browse_near_a_person“. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.search_limit | Maximale Anzahl der Suchergebnisse, die zurückgegeben werden sollen, wenn ein Benutzer nach einem Arbeitsplatzstandort sucht. Datentyp: Zahl |
| result.reservation.reservable_module.selection_type | Der Typ der Auswahl, die in den Suchergebnissen angezeigt werden soll. Dies kann eine der folgenden Optionen sein:
Datentyp: Zeichenfolge |
| result.reservation.reservable_module.short_description | Kurze Beschreibung des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.show_map_view | Kennzeichnung, die angibt, ob die Zuordnungsansicht für reservierbare Module aktiviert werden soll. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.sys_id | Sys_id des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots | Details zu den Zeitfenstern, die einem reservierbaren Modul zugeordnet sind. Datentyp: Array von Objekten |
| result.reservation.reservable_module.timeSlots.name | Name des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.short_description | Kurze Beschreibung des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.slot_end | Endzeit des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.slot_start | Startzeit des Zeitfensters. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.timeSlots.sys_id | Sys_id des Zeitfenster-Datensatzes. Befindet sich in der Zeitfenstertabelle [sn_wsd_rsv_time_slot]. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.title | Titel des reservierbaren Moduls. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.virtual_meeting_provider | Details zum virtuellen Anbieter, der dem reservierbaren Modul zugeordnet ist. Datentyp: Objekt |
| result.reservation.reservable_module.virtual_meeting_provider.display_value | Anzeigewert des Anbieters der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservation.reservable_module.virtual_meeting_provider.sys_id | Sys_id des Anbieters der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservation.reservationAcl | Details der Prüfungen der Benutzerzugriffskontrollebenen (ACL), die für die zugehörige Reservierung festgelegt wurden. Datentyp: Objekt |
| result.reservation.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write | Details zu den Schreibfähigkeiten des Benutzers für die zugehörige Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind im Objekt reservationACL.write.fields nur diese Felder „true“. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields | Details der Zugriffskontrollen in verschiedenen Feldern der Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Standortfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.number_of_attendees | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Felder für die Anzahl der Teilnehmer in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.requested_for | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die angeforderten Felder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.sensitivität | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.subject | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Betrefffelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.record | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservation_zweck | Details zum Zweck der Reservierung. Datentyp: Objekt |
| result.reservation.reservation_zweck.display_value | Anzeigewert für den Zweck der Reservierung, z. B. Unternehmensbesprechung. Datentyp: Zeichenfolge |
| result.reservation.reservation_zweck.wert | Interner Wert für den Zweck der Reservierung, z. B. company_meeting. Datentyp: Zeichenfolge |
| result.reservation.reservation_type | Details zum Typ der Reservierung. Datentyp: Objekt |
| result.reservation.reservation_type.display_value | Anzeigewert für den Typ der Reservierung, z. B. Platz. Datentyp: Zeichenfolge |
| result.reservation.reservation_type.value | Interner Wert für den Typ der Reservierung, z. B. Platz. Datentyp: Zeichenfolge |
| result.reservation.reservation_subtype | Details zum Untertyp der Reservierung. Untertypen geben den Typ der Reservierung an, z. B. Einzeln, Mehrfach übergeordnet, Mehrfach untergeordnet, Wiederkehrend übergeordnet oder Vorkommen. Datentyp: Objekt |
| result.reservation.reservation_subtype.display_value | Anzeigewert für den Untertyp der Reservierung, z. B. Einzeln. Datentyp: Zeichenfolge |
| result.reservation.reservation_subtype.value | Interner Wert für den Untertyp der Reservierung, z. B. Einzeln. Datentyp: Zeichenfolge |
| result.reservation.sensitivity | Details zur Vertraulichkeit der Reservierung. Datentyp: Objekt |
| result.reservation.sensitivity.display_value | Anzeigewert für die Empfindlichkeit der Reservierung, z. B. hoch oder niedrig. Datentyp: Zeichenfolge |
| result.reservation.sensitivity.value | Interner Wert für die Vertraulichkeit der Reservierung, z. B. 1 oder 3. Datentyp: Zeichenfolge |
| result.reservation.shift | Details zur Schicht, die auf die Reservierung angewendet wird. Datentyp: Objekt |
| result.reservation.shift.display_value | Anzeigewert der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.name | Der Name der Schicht Identisch mit display_value. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.schicht.schichtDetails | Details der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.sys_id | Sys_id des Schichtdatensatzes. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Datentyp: Zeichenfolge |
| result.reservation.source | Details zur Quelle für die Reservierung, z. B. Arbeitsplatzservices oder Google Mail. Datentyp: Objekt |
| result.reservation.source.display_value | Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices. Datentyp: Zeichenfolge |
| result.reservation.source.value | Interner Wert für die Reservierungsquelle, z. B. servicenow. Datentyp: Zeichenfolge |
| result.reservation.source_icon | Details zur Quelle des in der Reservierung verwendeten Symbols. Dieses Symbol wird in der Benutzeroberfläche verwendet. Datentyp: Objekt |
| result.reservation.source_icon.classNames | Kommagetrennte Klassennamen für das Quellsymbol. Datentyp: Zeichenfolge |
| result.reservation.source_icon.imgSrc | Name der Bildquelle für das Quellsymbol. Dieses Symbol wird in der Tabelle „Bilder“ [db_image] gespeichert. Datentyp: Zeichenfolge |
| result.reservation.source_icon.tooltip | Tooltip, der dem Quellsymbol zugeordnet ist. Datentyp: Zeichenfolge |
| result.reservation.source_reservation | Quellreservierung der aktuellen Reservierung. Beispiel: Bei mehreren Reservierungen ist die übergeordnete Reservierung die Quelle der untergeordneten Reservierung. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Start | Startdatum und -uhrzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC - jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z |
| result.reservation.subject | Betreff der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.sub_source | Details zur Unterquelle der Reservierung. Die Unterquelle gibt an, woher die Reservierung stammt, z. B. Google Kalender oder Microsoft Exchange. Datentyp: Objekt |
| result.reservation.sub_source.display_value | Anzeigewert für die Unterquelle der Reservierung, z. B. Google Kalender. Datentyp: Zeichenfolge |
| result.reservation.sub_source.value | Interner Wert des Unterquellenfelds der Reservierung, z. B. google_calendar. Datentyp: Zeichenfolge |
| result.reservation.sync_state | Details zum Synchronisierungsstatus einer Reservierung von einem anderen Service, z. B. „sync_enqueued“ oder „synchronized“. Datentyp: Objekt |
| result.reservation.sync_state.display_value | Anzeigewert für den aktuellen Synchronisierungsstatus der Reservierung, z. B. „synchronisiert“. Datentyp: Zeichenfolge |
| result.reservation.sync_state.value | Interner Wert des aktuellen Synchronisierungsstatus der Reservierung, z. B. „synchronisiert“. Datentyp: Zeichenfolge |
| result.reservation.sys_created_on | Datum und Uhrzeit der Erstellung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.sys_id | Erforderlich. Sys_id des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.virtual_meeting | URL des Links der virtuellen Besprechung. Datentyp: Zeichenfolge |
| result.reservationAcl | Details der Prüfungen der Benutzerzugriffskontrollebenen (ACL), die für die zugehörige Reservierung festgelegt wurden. Datentyp: Objekt |
| result.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write | Details zu den Schreibfähigkeiten des Benutzers für die zugehörige Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind im Objekt reservationACL.write.fields nur diese Felder „true“. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields | Details der Zugriffskontrollen in verschiedenen Feldern der Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Standortfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.number_of_attendees | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Felder für die Anzahl der Teilnehmer in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.requested_for | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die angeforderten Felder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.sensitivity | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields.subject | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Betrefffelder in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.record | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.standard_services | Wird nur ausgefüllt, wenn der Parameter include_standard_services auf „true“ festgelegt ist. Zugehörige Standardservices, z. B. Flipchart, Bildschirm, Whiteboard und Marker. Datentyp: Array von Objekten
|
| result.standard_services.font_awesome_icon | Name des Miniatursymbols, das dem Standardservice zugeordnet ist. Datentyp: Zeichenfolge |
| result.standard_services.name | Name des Standardservice. Datentyp: Zeichenfolge |
| result.standard_services.short_description | Kurze Beschreibung des Standardservice. Datentyp: Zeichenfolge |
| result.standard_services.sys_id | Sys_id des Standardservicedatensatzes. Befindet sich in der Tabelle „Standardservice“ [sn_wsd_rsv_standard_service]. Datentyp: Zeichenfolge |
cURL-Anforderung
Dieses Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird, um eine Liste der Reservierungen abzurufen, die dem angegebenen Benutzer zugeordnet sind.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/list" \
--request GET \
--header "Accept:application/json" \
--user "username":"password"
Ergebnisse zurückgeben:
{
"result": {
"reservations": [
{
"sys_id": "12e2da5e87c701106342b846dabb354d",
"number": "WRES0001010",
"location": {
"sys_id": "02000d4edb7650106c731dcd13961914",
"name": "Eureka",
"description": "A comfortable meeting room with leather chairs and a wooden table. Client meeting room.",
"display_value": "Eureka",
"capacity": 12,
"label_value": "Room name",
"email": "eureka@example.com",
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room"
},
"region": {
"sys_id": "2d626c4edb3650106c731dcd1396194b",
"display_value": "Europe",
"active": true
},
"site": {
"sys_id": "b17220cedb3650106c731dcd1396197a",
"display_value": "Western Europe",
"active": true
},
"campus": {
"sys_id": "44d2e0cedb3650106c731dcd13961988",
"display_value": "Amsterdam Campus",
"active": true
},
"building": {
"sys_id": "9e0364cedb3650106c731dcd1396192b",
"display_value": "AMS-B1",
"active": true,
"timezone": {
"value": "Europe/Amsterdam",
"displayValue": "Europe/Amsterdam"
}
},
"floor": {
"sys_id": "5373a8cedb3650106c731dcd1396198a",
"display_value": "Floor 3",
"active": true
},
"area": {
"sys_id": "",
"display_value": "",
"active": false
},
"reservation": {
"sys_id": "12e2da5e87c701106342b846dabb354d",
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
},
"number": "WRES0001010",
"active": true
},
"number_of_attendees": 1,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"number": "WRES0001010",
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"name": "Workplace User",
"user_name": "workplace_user"
}
},
"start": "2022-05-15T16:00:00Z",
"end": "2022-05-15T17:00:00Z",
"sys_created_on": "2022-04-26T09:19:37Z",
"sys_updated_on": "2022-04-26T09:20:04Z",
"source_reservation": null,
"check_in_state": {
"value": "not_required",
"display_value": "Not required"
},
"external_id": null,
"external_ical": null,
"active": true,
"state": {
"value": "confirmed",
"display_value": "Confirmed"
},
"sensitivity": {
"value": "normal",
"display_value": "Normal"
},
"reservation_type": {
"value": "space",
"display_value": "Space"
},
"reservation_subtype": {
"value": "single",
"display_value": "Single"
},
"reservation_purpose": {
"value": "meeting",
"display_value": "Meeting"
},
"attendees": [
{
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": "eb513744c3222010ae17dd981840dd97",
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
}
],
"number_of_attendees": 1,
"is_parent": false,
"subject": "Add rsv_1",
"virtual_meeting": "https://samplemeetingurl.com",
"recording_details": [
{
"recording_url": "https://samplerecordingurl.com"
}
],
"sync_state": {
"value": "not_required",
"display_value": "Synchronization not required"
},
"sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"last_updated_sub_source": {
"value": "servicenow_workplace_service_delivery",
"display_value": "ServiceNow Workplace Service Delivery"
},
"reservable_module": {
"sys_id": "c31241cedb7650106c731dcd13961917",
"name": "Meeting rooms",
"title": "Meeting rooms",
"inline_title": "meeting room",
"font_awesome_icon": "fa-building",
"reservable_table": "sn_wsd_core_room",
"reservable_filter": "active=true^is_reservable=true^building!=6c0364cedb3650106c731dcd13961927^building.is_reservable=true^floor.is_reservable=true^EQ",
"short_description": "Reserve a meeting room",
"reservable_type": "location",
"require_subject": "1",
"require_cancel_notes": true,
"virtual_meeting_provider": {
"sys_id": "e33d9e6853c201103cf7ddeeff7b1205",
"display_value": "Template"
},
"allow_invitees": "1",
"display_number_of_attendees": "1",
"display_on_behalf_of": "1",
"display_sensitivity": "1",
"max_days_in_future": "180",
"allow_whole_day": "1",
"selection_type": "unit",
"reservable_container_field": null,
"reservable_quantity_field": null,
"apply_to_shift": null,
"max_occurrences": "180",
"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",
"display_value": "Meeting rooms",
"browse_near_a_person_enabled": true,
"browse_by_area_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"
}
],
"buildingSysIds": [
"4703a4cedb3650106c731dcd13961945",
"6c0364cedb3650106c731dcd13961927",
"94e264cedb3650106c731dcd13961919",
"9e0364cedb3650106c731dcd1396192b"
],
"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"
},
"notification_recipients": [
{
"sys_id": "7016f79cc0a8016401c5a33be04be441",
"name": "workplace user",
"user_name": "workplace.user"
}
],
"notification_custom_message": "Demo notification message",
"opened_by": {
"sys_id": "6816f79cc0a8016401c5a33be04be441",
"value": "6816f79cc0a8016401c5a33be04be441",
"displayValue": "System Administrator",
"display_value": "System Administrator",
"name": "System Administrator",
"user_name": "admin",
"table": "sys_user",
"avatar": "eb513744c3222010ae17dd981840dd97",
"initials": "SA",
"email": "admin@example.com",
"label": "System Administrator"
},
"requested_for": {
"sys_id": "2de07e1887cb89106342b846dabb35fe",
"value": "2de07e1887cb89106342b846dabb35fe",
"displayValue": "Workplace User",
"display_value": "Workplace User",
"name": "Workplace User",
"user_name": "workplace_user",
"table": "sys_user",
"avatar": "d3513744c3222010ae17dd981840dd97",
"initials": "WU",
"email": "workplace_user@example.com",
"label": ""
},
"edit_restriction": {
"value": "no_restriction",
"display_value": "No restriction"
},
"source": {
"value": "servicenow",
"display_value": "Workplace Services"
},
"source_icon": {
"classNames": "fa fa-calendar-check-o",
"tooltip": "Reservation is confirmed",
"imgSrc": ""
},
"shift": {
"sys_id": "e5d23acfdb42a01097acc9003996193a",
"name": "Test shift AMS-B1",
"display_value": "Test shift AMS-B1",
"shiftDetails": "8-5 weekdays excluding holidays\n - Monday-Friday 8-5"
},
"reservationAcl": {
"write": {
"record": true,
"fields": {
"subject": true,
"sensitivity": true,
"requested_for": true,
"number_of_attendees": true,
"location": true
},
"allFields": true
},
"read": true
}
}
]
}
}
WSD Reservation – PATCH /api/sn_wsd_rsv/reservation/cancel/{sys_id}
Storniert eine angegebene Arbeitsplatzreservierung.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/cancel/{sys_id}
Standard-URL: /api/sn_wsd_rsv/reservation/cancel/{sys_id}
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | Sys_id der zu stornierenden Reservierung. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
| Name | Beschreibung |
|---|---|
| cancel_notes | Grund für die Stornierung der Reservierung. Datentyp: Zeichenfolge |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| sys_id | Sys_id des stornierten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie eine Reservierung mit diesem Endpunkt storniert wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/cancel/12e2da5e87c701106342b846dabb354d" \
--request PATCH \
--header "Accept:application/json" \
--user ‘username’:’password’
Ergebnisse zurückgeben:
"result": {
"sys_id": "73c316d2474b0150003a4587746d4337"
}
WSD Reservation – PATCH /api/sn_wsd_rsv/reservation/share_details/{sys_id}
Aktualisiert und teilt die Reservierungsdetails über eine E-Mail-Benachrichtigung mit einer angegebenen Liste von Empfängern. Optional können Sie eine bestimmte Nachricht zusammen mit der Reservierung senden.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/share_details/{sys_id}
Standard-URL: /api/sn_wsd_rsv/reservation/share_details/{sys_id}
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Datentyp: Zeichenfolge |
| sys_id | Sys_id der freizugebenden Reservierung. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
| Name | Beschreibung |
|---|---|
| notification_custom_message | Nachricht, die an die angegebenen Empfänger gesendet werden soll. Datentyp: Zeichenfolge |
| notification_recipients | Erforderlich. Liste der sys_ids der Benutzer, an die die E-Mail-Benachrichtigung gesendet werden soll. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Array |
| notification_type | Typ der zu sendenden Benachrichtigung. Gültige Typen:
Datentyp: Zeichenfolge |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| sys_id | Sys_id des freigegebenen Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie dieser Endpunkt zum Freigeben einer Reservierung verwendet wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/share_details/60d26a0f47578910003a4587746d4331" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"notification_recipients\": [\"5dfb9fcf47d78910003a4587746d4367\"],
\"notification_type\":\"reservation_updated\",
\"notification_custom_message\": \"Please join our design brainstorming meeting!\"
}" \
--user "username":"password"
Ergebnisse zurückgeben:
"result": {
"sys_id": "60d26a0f47578910003a4587746d4331"
}
WSD Reservation – PATCH /api/sn_wsd_rsv/reservation/update/{sys_id}
Aktualisiert eine angegebene Arbeitsplatzreservierung.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/update/{sys_id}
Standard-URL: /api/sn_wsd_rsv/reservation/update/{sys_id}
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| sys_id | Sys_id der zu ändernden Reservierung. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| ignore_same_day_validation | Kennzeichnung, die angibt, ob die Reservierungssuche die Änderung der Datumsvalidierung zwischen den Start- und Endparametern ignoriert. Gültige Werte:
Datentyp: Boolesch Standardwert: false |
| Name | Beschreibung |
|---|---|
| Ende | Erforderlich, wenn der Parameter shift nicht übergeben wird. Angeforderte Endzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| is_private | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung nur dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Standort-Datenschutzeinstellungen und Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: In den Systemeigenschaften für Datenschutz festgelegter Wert. |
| location | Erforderlich. Sys_id des zu reservierenden Standorts. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| requested_for | Sys_id oder E-Mail-Adresse des Benutzers, für den die Reservierung vorgenommen wird. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| Schicht | Sys_id der Schicht, die der Reservierung zugeordnet werden soll. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierungen aktivieren. Datentyp: Zeichenfolge |
| Start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| Betreff | Erforderlich. Betreff der Besprechung, die der Reservierung zugeordnet ist. Datentyp: Zeichenfolge |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Antworttextparameter (JSON oder XML)
| Name | Beschreibung |
|---|---|
| Ergebnis | Details der aktualisierten Reservierung. Datentyp: Objekt |
| result.location_id | Sys_id des Reservierungsstandort-Datensatzes. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| result.sys_id | Sys_id des geänderten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
| result.type_of_change | Typ der in der Reservierung aktualisierten Informationen. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie eine Reservierung mit diesem Endpunkt aktualisiert wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/update/b537abc947db4510003a4587746d4351" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"subject\": \"Rsv Update_1\",
\"start\": \"2022-07-21 14:00:00\",
\"end\": \"2022-07-21 15:00:00\",
\"requested_for\": \"workplace_user@example.com\",
\"workplace_location\": \"fe1f744edb7650106c731dcd139619ca\",
\"is_private\": \false\
}" \
--user "username":"password"
Ergebnisse zurückgeben:
{
"result": {
"sys_id": "b537abc947db4510003a4587746d4351",
"location_id": "fe1f744edb7650106c731dcd139619ca",
"type_of_change": "location"
}
}
WSD-Reservierung – POST /api/sn_wsd_rsv/reservation/add
Erstellt eine neue Arbeitsplatzreservierung.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/add
Standard-URL: /api/sn_wsd_rsv/reservation/add
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| ignore_same_day_validation | Kennzeichnung, die angibt, ob die Reservierungssuche die Änderung der Datumsvalidierung zwischen den Start- und Endparametern ignoriert. Gültige Werte:
Datentyp: Boolesch Standardwert: false |
| Feld | Bevorzugte Zeitzone für die Ausführung der Anforderungsvalidierungen. Beispiel: Europa/Amsterdam. Diese Validierung überprüft, ob Start- und Endzeit auf denselben Tag fallen. Datentyp: Zeichenfolge Standard: Benutzerzeitzone |
| Name | Beschreibung |
|---|---|
| Ende | Erforderlich, wenn der Parameter shift nicht übergeben wird. Angeforderte Endzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| is_private | Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung nur dem Besitzer angezeigt. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Standort-Datenschutzeinstellungen und Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: In den Systemeigenschaften für Datenschutz festgelegter Wert. |
| location | Erforderlich. Sys_id des zu reservierenden Standorts. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| requested_for | Sys_id oder E-Mail-Adresse des Benutzers, für den die Reservierung vorgenommen wird. Befindet sich in der Benutzertabelle [sys_user]. Datentyp: Zeichenfolge |
| „reservable_module“ | Erforderlich. Sys_id des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. Ein reservierbares Modul definiert die für eine Reservierung erforderlichen Arbeitsplatzelemente. Befindet sich in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module]. Datentyp: Zeichenfolge |
| Schicht | Sys_id der Schicht, die der Reservierung zugeordnet werden soll. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierungen aktivieren. Datentyp: Zeichenfolge |
| Start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| Betreff | Erforderlich. Betreff der Besprechung, die der Reservierung zugeordnet ist. Datentyp: Zeichenfolge |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| sys_id | Sys_id des erstellten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie dieser Endpunkt zum Erstellen einer Reservierung verwendet wird.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/add" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"reservable_module\": \"c31241cedb7650106c731dcd13961917\",
\"subject\": \"Test-123\",
\"reservation_purpose\": \"meeting\",
\"timezone\": \"US/Pacific\",
\"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
\"location\": \"5eafb44edb7650106c731dcd13961943\",
\"is_private\": false,
\"start\": \"2023-01-12T11:00:00Z\",
\"end\": \"2023-01-12T12:00:00Z\"
}" \
--user "username":"password"
Ergebnisse zurückgeben:
"result": {
"sys_id": "4b036a9e474b0150003a4587746d43b1"
}
WSD-Reservierung – POST /api/sn_wsd_rsv/reservation/quick_reserve
Erstellt eine neue Arbeitsplatzreservierung mit Schnellreservierung.
URL-Format
Versionierte URL: /api/sn_wsd_rsv/{api_version}/reservation/quick_reserve
Standard-URL: /api/sn_wsd_rsv/reservation/quick_reserve
Unterstützte Anforderungsparameter
| Name | Beschreibung |
|---|---|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Zum Beispiel v1 oder v2. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| Name | Beschreibung |
|---|---|
| Keine |
| Name | Beschreibung |
|---|---|
| Ende | Erforderlich, wenn der Parameter shift nicht übergeben wird. Angeforderte Endzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
| ignore_same_day_validation | Erforderlich. Kennzeichnung, die angibt, ob der Endpunkt die Validierung der Datumsänderung zwischen den Parametern start und end ignoriert. Gültige Werte:
Datentyp: Boolesch |
| reference_location_id | Erforderlich. Sys_id des Standorts, in dessen Nähe der Benutzer einen Standort reservieren möchte. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| „reservable_module“ | Erforderlich. Sys_id des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. Ein reservierbares Modul definiert die für eine Reservierung erforderlichen Arbeitsplatzelemente. Befindet sich in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module]. Datentyp: Zeichenfolge |
| Schicht | Sys_id der Schicht, die der Reservierung zugeordnet werden soll. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierungen aktivieren. Datentyp: Zeichenfolge |
| Start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (jjjj-mm-tt hh:mm:ss) |
Header
Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.
| Kopfzeile | Beschreibung |
|---|---|
| Akzeptieren | Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml. Standard: application/json |
| Content-Type | Datenformat des Anforderungstexts. Unterstützt nur application/json. |
| Kopfzeile | Beschreibung |
|---|---|
| Keine |
Statuscodes
Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter HTTP-Antwortcodesder REST-API.
| Statuscode | Beschreibung |
|---|---|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert. Die Anmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 404 | Nicht gefunden. Das angeforderte Element wurde nicht gefunden. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Der Antworttext enthält Informationen zum Fehler. |
Parameter des Antwort-Haupttexts
| Name | Beschreibung |
|---|---|
| sys_id | Sys_id des erstellten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Datentyp: Zeichenfolge |
cURL-Anforderung
Das folgende Codebeispiel zeigt, wie Sie mit dem Schnellreservierungsendpunkt eine Reservierung erstellen.
curl "https://instance.servicenow.com/api/sn_wsd_rsv/reservation/quick_reserve" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{
\"start\":\"2022-05-23 16:00:00\",
\"end\": \"2022-05-23 17:00:00\",
\"reservable_module\": \"5db44502dbb650106c731dcd13961937\",
\"reference_location_id\": \"05f5290edb7210106c731dcd13961951\",
\"ignore_same_day_validation\": \"true\"
}" \
--user "username":"password"
Ergebnisse zurückgeben:
"result": {
"sys_id": "4b036a9e474b0150003a4587746d43b1"
}