WSD-Reservierungs-API
Die Reservierungs -API Workplace Service Delivery (WSD) bietet Endpunkte für die Verwaltung von Arbeitsplatzreservierungen.
Um auf diese API zuzugreifen, muss der Anrufer ü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 Management von Arbeitsplatz-Reservierungenfinden Sie unter Reservierungsmanagement für Arbeitsplatz.
WSD-Reservierung: GET /api/sn_wsd_rsv/reservation/get
Ruft die angegebene Arbeitsplatzreservierung ab.
URL-Format
URL mit Versionsnummer: /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 zugehörigen 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 zugehörigen externen Anwendung ab. Datentyp: Zeichenfolge |
| „include_multi_child_data“. | Wenn der Wert des Felds „reservierung_subtype“ im zugehörigen 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 Bestimmungen, die mit einem reservierbaren Arbeitsplatzelement verfügbar sind, wenn die Reservierung vorgenommen wird, 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 |
|---|---|
| result.reservation | 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 |
| Ergebnis.Reservierung.Teilnehmer.Anzeigewert | Anzeigewert für den Teilnehmer. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Anzeigewert | 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.attendees.sys_id | Sys_id_des Teilnehmerdatensatzes. Datentyp: Zeichenfolge |
| „ergebnis.reservierung.teilnehmer.tabelle“ | Tabelle, in der der Teilnehmerdatensatz vorhanden ist. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Anwendername | Anwendername des Teilnehmers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Wert | 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 Anwenderbearbeitungseinschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „vollständig eingeschränkt“. 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. Bei einer privaten Reservierung ist die Reservierung nur für den Besitzer sichtbar. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Datenschutzeinstellungen für den Standort und ihre Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: Wert, der für Datenschutz in den Systemeigenschaften festgelegt ist. |
| 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 |
| Ergebnis.Reservierung.Standort | Details zum Standort, der der Reservierung zugeordnet ist. Datentyp: Objekt |
| Ergebnis.Reservierung.Standort.Bereich | Details zum Gebiet, das 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 |
| Ergebnis.Reservierung.Standort.Gebäude | 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äude 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 |
| Ergebnis.Reservierung.Ort.Gebäude.Zeitzone | 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.Wert | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.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 Paris. 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 |
| Ergebnis.Reservierung.Standort.Kapazität | 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 Anwenderoberfläche für diesen Standort angezeigt werden soll. Datentyp: Zeichenfolge |
| result.reservation.location.email | E-Mail-Adresse für den Standort Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.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.anzeigewert | Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erster Stock. 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_stockwerk]. 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 |
| Ergebnis.Reservierung.Standort.Nummer | Reservierungsnummer. Datentyp: Zeichenfolge |
| „result.reservation.location.number_of_attendees“ | Anzahl der Teilnehmer für die Reservierung. Datentyp: Zahl |
| Ergebnis.Reservierung.Standort.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 Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.sys_id | Sys_id des Anwenders, für den die Reservierung angefordert wird. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.user_name | Anwendername des Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.Reservierung | 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 |
| Ergebnis.Reservierung.Standort.Reservierung.Nummer | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.number_of_attendees | Anzahl der Teilnehmer für die 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 Anwenders, 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 Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.user_name | Anwendername des Anwenders, 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 Arbeitsplatz-Serviceportal 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 | Standort, zu dem 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 Website 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 der Site, zu der dieser Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Ort.Status | 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 |
| Ergebnis.Reservierung.Standort.Status.Wert | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.location.sys_id | Sys_id des zugeordneten Standortdatensatzes. Zu finden in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| result.reservation.notification_custom_message | Anwenderdefinierte 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 Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.user_name | Anwendername des Empfängers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Nummer | 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 Anwender, der die Reservierung erstellt hat. Datentyp: Objekt |
| result.reservation.opened_by.avatar | Avatar des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.displayValue | Anzeigewert des „Geöffnet von“-Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.display_value | Anzeigewert des „Geöffnet von“-Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.email | E-Mail-Adresse des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.initials | Initialen des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.label | Bezeichnung für den Anwender, der die Reservierung geöffnet hat. Dies ist eine Kombination aus Titel und Abteilung des Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.name | Name des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.rservation.opened_by.sys_id | Sys_id_des Anwenders, der die Reservierung geöffnet hat. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.opened_by.table | Tabelle, die den Anwenderdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.opened_by.user_name | Anwendername des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.value | Interner Wert des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Nummer | 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 Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Objekt |
| result.reservation.requested_for.avatar | Avatar für den Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.displayValue | Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.display_value | Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.requested_for.email | E-Mail-Adresse des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.initials | Initialen des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.label | Bezeichnung für den Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.name | Name des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.rservation.requested_for.sys_id | Sys_id_des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.requested_for.table | Tabelle, die den Anwenderdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.requested_for.user_name | Anwendername des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.value | Interner Wert des Anwenders, 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_gesamt_tag | Kennzeichnung, die angibt, ob Anwender 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 Anwender nach Bereich nach reservierbaren Modulen suchen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_near_a_person_enabled | Kennzeichnung, die angibt, ob Anwender 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 | Zeitspanne vor Beginn einer Reservierung, in der ein Anwender in seine Reservierung einchecken kann. Einheit: Minuten Datentyp: Zahl |
| result.reservation.reservable_module.display_number_of_attendees | Kennzeichnung, die angibt, ob Anwender 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 Anwender 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 Anwender nach Bereich nach reservierbaren Modulen 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 Anwender 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 Anwender eine Gruppenreservierung vornehmen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_ical_generation | Kennzeichnung, die angibt, ob Anwender einen iCalendar für die Reservierung generieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.font_awetype_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 Arbeitsplatz-Serviceportal 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 Anwenderoberfläche anzuordnen. 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_future | Maximale Anzahl der Tage in der Zukunft, die ein Anwender das reservierbare Modul reservieren kann. Datentyp: Zahl |
| result.reservation.reservable_module.max_occurrences | Maximale Anzahl der wiederkehrenden Reservierungsvorkommen, 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 Anwender eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_cc_dept_check | Kennzeichnung, die angibt, ob überprüft werden soll, ob eine Kostenstelle oder Abteilung zwischen dem Arbeitsbereichselement und dem angemeldeten Anwender nicht übereinstimmt. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_subject | Kennzeichnung, die angibt, ob der Anwender bei der Reservierung einen Betreff eingeben muss. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_columns | Liste der Spalten eines reservierbaren Elements. Zu finden 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 zum Herausfiltern von reservierbaren Elementen in der zugehörigen Tabelle „Reservierbar“ verwendet werden. 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 Arbeitsbereichsbereiche einem Bereich zugewiesen werden. Weitere Informationen finden Sie unter Flächen in der Umgebung 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 Ansicht „Reservierbar“. 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 Anwenderoberfläche angezeigt werden. Die niedrigeren Ordnungszahlen stehen in der Anwenderoberfläche an erster Stelle. 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 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 von Suchergebnissen, die zurückgegeben werden sollen, wenn ein Anwender nach einem Arbeitsplatzstandort sucht. Datentyp: Zahl |
| result.reservation.reservable_module.selection_type | Der Typ der Auswahl, die in den Suchergebnissen angezeigt werden soll. 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 Tabelle „Zeitfenster“ [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 virtueller Besprechungen. 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 Zugriffssteuerungsebenenprüfungen (ACL), die für die zugeordnete Reservierung festgelegt sind. Datentyp: Objekt |
| result.reservation.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write | Details zu den Schreibfähigkeiten des Anwenders für die zugeordnete Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind nur diese Felder im Objekt reservationACL.write.fields zutreffend. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields | Details der Zugriffssteuerungen für verschiedene Felder der Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender in die Felder für die Teilnehmerzahl 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 Anwender in die Felder „Angefordert für“ in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.sensitivity | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender 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 Anwender 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. einfach, 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 |
| Ergebnis.Reservierung.Empfindlichkeit | Details zur Vertraulichkeit der Reservierung. Datentyp: Objekt |
| Ergebnis.Reservierung.Empfindlichkeit.Anzeigewert | Anzeigewert für die Empfindlichkeit der Reservierung, z. B. hoch oder niedrig. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Empfindlichkeit.Wert | Interner Wert für die Empfindlichkeit der Reservierung, z. B. 1 oder 3. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Schicht | Details zur Schicht, die auf die Reservierung angewendet wird. Datentyp: Objekt |
| Ergebnis.Reservierung.Schicht.Anzeigewert | Anzeigewert der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.name | Der Name der Schicht Identisch mit display_value. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.schicht.schichtDetails | Details zur Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.sys_id | Sys_id des Schichtdatensatzes. Befindet sich in der Tabelle „Schicht“ [sn_wsd_core_shift]. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Quelle | Details zur Quelle für die Reservierung, z. B. Workplace Services oder Google Mail. Datentyp: Objekt |
| Ergebnis.Reservierung.Quelle.Anzeigewert | Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Quelle.Wert | 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 Anwenderoberflä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 Quellsymbol. Dieses Symbol wird in der Tabelle „Images“ [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: Im Fall mehrerer 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 |
| Ergebnis.Reservierung.Betreff | 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 Unterquellfelds 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 |
| Result.reservation.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.virtual_meeting | URL des Links für die virtuelle Besprechung. Datentyp: Zeichenfolge |
| result.reservationAcl | Details der Zugriffssteuerungsebenenprüfungen (ACL), die für die zugeordnete Reservierung festgelegt sind. Datentyp: Objekt |
| result.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write | Details zu den Schreibfähigkeiten des Anwenders für die zugeordnete Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind nur diese Felder im Objekt reservationACL.write.fields zutreffend. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields | Details der Zugriffssteuerungen für verschiedene Felder der Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender in die Felder für die Teilnehmerzahl 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 Anwender in die Felder „Angefordert für“ 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 Anwender 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 Anwender 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 Anwender 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 „wahr“ festgelegt ist. Zugehörige Standardservices, z. B. Flipchart, Bildschirmprojektor sowie Whiteboard und Marker. Datentyp: Array von Objekten
|
| Ergebnis.Standard_Services.Schriftart_aweso_Symbol | 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 werden.
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
URL mit Versionsnummer: /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 Anwenders, dessen Reservierungen zurückgegeben werden sollen. Befindet sich in der Tabelle „Benutzer“ [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 | Rückgabeergebnisse für Reservierung. 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 |
| „ergebnis.reservierungenNachDatum“ | Details zu jeder Reservierung nach Datum. Datentyp: Objekt – jedes Datum in einem eigenen Array |
| result.reservationsByDatum.building | Gebäude, in dem sich das reservierbare Element befindet. Diese Informationen befinden sich in der Tabelle „Gebäude“ [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 |
| Ergebnis.ReservierungenNachDatum.Gebäude.Zeitzone | Details der Zeitzone für das Gebäude. |
| result.reservationsByDatum.building.timezone.display_value | Anzeigewert der Zeitzone, in der sich das zugeordnete Gebäude befindet. Datentyp: Zeichenfolge |
| result.reservationsByDatum.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.reservationsByDatum.stockwerk | Details zum Stockwerk, das der Reservierung zugeordnet ist. Datentyp: Objekt |
| result.reservationsByDatum.stockwerk.displayValue | Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12. Datentyp: Zeichenfolge |
| result.reservationsByDatum.stockwerk.wert | Interner Wert des Stockwerks, in dem sich die Reservierung befindet. Datentyp: Zeichenfolge |
| result.reservationsByDatum.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 Studio. 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 ab 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, an denen der angegebene Anwender Reservierungen für die nächsten sieben Tage hat, sortiert in Datumsreihenfolge. 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 Tabelle „Gebäude“ [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 |
| Ergebnis.ArbeitsplatzProfil.Gebäude.Zeitzone | Details der Zeitzone für das Gebäude. |
| Ergebnis.ArbeitsplatzProfil.Gebäude.Zeitzone.Anzeigewert | 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 |
| Ergebnis.ArbeitsplatzProfil.Gebäude.Wert | Interner Wert für das Gebäude. Datentyp: Zeichenfolge |
| Ergebnis.ArbeitsplatzProfil.Stockwerk | Details zum Stockwerk, in dem der Benutzer arbeitet. Datentyp: Objekt |
| Ergebnis.ArbeitsplatzProfil.Stockwerk.Anzeigewert | Anzeigenummer des Stockwerks, in dem der Benutzer arbeitet, z. B. Stockwerk 8. Datentyp: Zeichenfolge |
| Ergebnis.Arbeitsplatzprofil.Stockwerk.Wert | Interner Wert des Stockwerks, in dem der Benutzer arbeitet. Datentyp: Zeichenfolge |
| Ergebnis.ArbeitsplatzProfil.Ort | Details zum Standort des Anwenders. Datentyp: Objekt |
| result.workplaceProfile.location.displayValue | Anzeigewert des Standorts, z. B. San Diego. Datentyp: Zeichenfolge |
| Ergebnis.ArbeitsplatzProfil.Ort.Typ | Typ des Standorts, z. B. Schreibtisch oder Büro. Datentyp: Zeichenfolge |
| Ergebnis.Arbeitsplatzprofil.Standort.Wert | 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-Reservierung – GET /api/sn_wsd_rsv/reservation/icalendar/{sys_id}
Generiert einen iCalendar-Dateitext für eine angegebene Reservierung.
URL-Format
URL mit Versionsnummer: /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-Textkörper 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 Anwender angefordert oder von diesem geöffnet wurden.
URL-Format
URL mit Versionsnummer: /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 zum Filtern der zurückgegebenen Reservierungsdatensatz-Ergebnisse. Alle Felder in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation] sind innerhalb der Abfrage gültig. Beispiel: Datentyp: Zeichenfolge |
| endIndex | Letzter Reservierungsdatensatz im Ergebnissatz, der zurückgegeben wird, 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 zurückgegebenen Ergebnisse in absteigender Reihenfolge der Startzeit zurückgegeben werden sollen. Gültige Werte:
Standardwert: false |
| Suchkriterien | Text, der innerhalb der Reservierung übereinstimmen muss, um in die zurückgegebenen Ergebnisse aufgenommen zu werden. Der Endpunkt sucht in den folgenden Feldern nach diesem Wert:
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 Anwenders zum Herausfiltern der zurückgegebenen Reservierungsinformationen. Befindet sich in der Tabelle „Benutzer“ [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 Anwender entspricht. Aus dieser Reservierungsliste werden dann die Reservierungen herausgefiltert, bei denen „requested_for“ oder „open_by“ dem übergebenen Wert userIdentspricht. Datentyp: Zeichenfolge Standard: Gibt alle Reservierungen zurück, bei denen das Feld „requested_for“ oder „opened_by“ dem aktuell angemeldeten Anwender entspricht. |
| 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 |
|---|---|
| result.reservation | 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 |
| Ergebnis.Reservierung.Teilnehmer.Anzeigewert | Anzeigewert für den Teilnehmer. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Anzeigewert | 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.attendees.sys_id | Sys_id_des Teilnehmerdatensatzes. Datentyp: Zeichenfolge |
| „ergebnis.reservierung.teilnehmer.tabelle“ | Tabelle, in der der Teilnehmerdatensatz vorhanden ist. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Anwendername | Anwendername des Teilnehmers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Teilnehmer.Wert | 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 Anwenderbearbeitungseinschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „vollständig eingeschränkt“. 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. Bei einer privaten Reservierung ist die Reservierung nur für den Besitzer sichtbar. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Datenschutzeinstellungen für den Standort und ihre Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: Wert, der für Datenschutz in den Systemeigenschaften festgelegt ist. |
| 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 |
| Ergebnis.Reservierung.Standort | Details zum Standort, der der Reservierung zugeordnet ist. Datentyp: Objekt |
| Ergebnis.Reservierung.Standort.Bereich | Details zum Gebiet, das 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 |
| Ergebnis.Reservierung.Standort.Gebäude | 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äude 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 |
| Ergebnis.Reservierung.Ort.Gebäude.Zeitzone | 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.Wert | Interner Wert für die Zeitzone, zu der dieser Standort gehört. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.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 Paris. 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 |
| Ergebnis.Reservierung.Standort.Kapazität | 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 Anwenderoberfläche für diesen Standort angezeigt werden soll. Datentyp: Zeichenfolge |
| result.reservation.location.email | E-Mail-Adresse für den Standort Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.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.anzeigewert | Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erster Stock. 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_stockwerk]. 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 |
| Ergebnis.Reservierung.Standort.Nummer | Reservierungsnummer. Datentyp: Zeichenfolge |
| „result.reservation.location.number_of_attendees“ | Anzahl der Teilnehmer für die Reservierung. Datentyp: Zahl |
| Ergebnis.Reservierung.Standort.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 Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.sys_id | Sys_id des Anwenders, für den die Reservierung angefordert wird. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.requested_for.user_name | Anwendername des Anwenders, für den die Reservierung angefordert wurde. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Standort.Reservierung | 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 |
| Ergebnis.Reservierung.Standort.Reservierung.Nummer | Reservierungsnummer. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.number_of_attendees | Anzahl der Teilnehmer für die 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 Anwenders, 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 Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.location.reservation.requested_for.user_name | Anwendername des Anwenders, 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 Arbeitsplatz-Serviceportal 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 | Standort, zu dem 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 Website 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 der Site, zu der dieser Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site]. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Ort.Status | 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 |
| Ergebnis.Reservierung.Standort.Status.Wert | Interner Wert für den aktuellen Status der Reservierung, z. B. 2. Datentyp: Zeichenfolge |
| result.reservation.location.sys_id | Sys_id des zugeordneten Standortdatensatzes. Zu finden in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| result.reservation.notification_custom_message | Anwenderdefinierte 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 Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.reservation.notification_recipients.user_name | Anwendername des Empfängers. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Nummer | 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 Anwender, der die Reservierung erstellt hat. Datentyp: Objekt |
| result.reservation.opened_by.avatar | Avatar des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.displayValue | Anzeigewert des „Geöffnet von“-Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.display_value | Anzeigewert des „Geöffnet von“-Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.email | E-Mail-Adresse des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.initials | Initialen des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.label | Bezeichnung für den Anwender, der die Reservierung geöffnet hat. Dies ist eine Kombination aus Titel und Abteilung des Anwenders. Datentyp: Zeichenfolge |
| result.reservation.opened_by.name | Name des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.rservation.opened_by.sys_id | Sys_id_des Anwenders, der die Reservierung geöffnet hat. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.opened_by.table | Tabelle, die den Anwenderdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.opened_by.user_name | Anwendername des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| result.reservation.opened_by.value | Interner Wert des Anwenders, der die Reservierung geöffnet hat. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Nummer | 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 Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Objekt |
| result.reservation.requested_for.avatar | Avatar für den Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.displayValue | Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.display_value | Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Identisch mit displayValue. Datentyp: Zeichenfolge |
| result.reservation.requested_for.email | E-Mail-Adresse des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.initials | Initialen des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.label | Bezeichnung für den Anwender, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.name | Name des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.rservation.requested_for.sys_id | Sys_id_des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| result.rservation.requested_for.table | Tabelle, die den Anwenderdatensatz enthält. Datentyp: Zeichenfolge |
| result.reservation.requested_for.user_name | Anwendername des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Datentyp: Zeichenfolge |
| result.reservation.requested_for.value | Interner Wert des Anwenders, 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_gesamt_tag | Kennzeichnung, die angibt, ob Anwender 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 Anwender nach Bereich nach reservierbaren Modulen suchen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.browse_near_a_person_enabled | Kennzeichnung, die angibt, ob Anwender 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 | Zeitspanne vor Beginn einer Reservierung, in der ein Anwender in seine Reservierung einchecken kann. Einheit: Minuten Datentyp: Zahl |
| result.reservation.reservable_module.display_number_of_attendees | Kennzeichnung, die angibt, ob Anwender 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 Anwender 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 Anwender nach Bereich nach reservierbaren Modulen 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 Anwender 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 Anwender eine Gruppenreservierung vornehmen können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.enable_ical_generation | Kennzeichnung, die angibt, ob Anwender einen iCalendar für die Reservierung generieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.font_awetype_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 Arbeitsplatz-Serviceportal 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 Anwenderoberfläche anzuordnen. 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_future | Maximale Anzahl der Tage in der Zukunft, die ein Anwender das reservierbare Modul reservieren kann. Datentyp: Zahl |
| result.reservation.reservable_module.max_occurrences | Maximale Anzahl der wiederkehrenden Reservierungsvorkommen, 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 Anwender eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren können. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_cc_dept_check | Kennzeichnung, die angibt, ob überprüft werden soll, ob eine Kostenstelle oder Abteilung zwischen dem Arbeitsbereichselement und dem angemeldeten Anwender nicht übereinstimmt. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.require_subject | Kennzeichnung, die angibt, ob der Anwender bei der Reservierung einen Betreff eingeben muss. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservable_module.reservable_columns | Liste der Spalten eines reservierbaren Elements. Zu finden 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 zum Herausfiltern von reservierbaren Elementen in der zugehörigen Tabelle „Reservierbar“ verwendet werden. 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 Arbeitsbereichsbereiche einem Bereich zugewiesen werden. Weitere Informationen finden Sie unter Flächen in der Umgebung 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 Ansicht „Reservierbar“. 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 Anwenderoberfläche angezeigt werden. Die niedrigeren Ordnungszahlen stehen in der Anwenderoberfläche an erster Stelle. 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 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 von Suchergebnissen, die zurückgegeben werden sollen, wenn ein Anwender nach einem Arbeitsplatzstandort sucht. Datentyp: Zahl |
| result.reservation.reservable_module.selection_type | Der Typ der Auswahl, die in den Suchergebnissen angezeigt werden soll. 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 Tabelle „Zeitfenster“ [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 virtueller Besprechungen. 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 Zugriffssteuerungsebenenprüfungen (ACL), die für die zugeordnete Reservierung festgelegt sind. Datentyp: Objekt |
| result.reservation.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write | Details zu den Schreibfähigkeiten des Anwenders für die zugeordnete Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind nur diese Felder im Objekt reservationACL.write.fields zutreffend. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields | Details der Zugriffssteuerungen für verschiedene Felder der Reservierung. Datentyp: Objekt |
| result.reservation.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender in die Felder für die Teilnehmerzahl 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 Anwender in die Felder „Angefordert für“ in dieser Reservierung schreiben kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservation.reservationAcl.write.fields.sensitivity | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender 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 Anwender 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. einfach, 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 |
| Ergebnis.Reservierung.Empfindlichkeit | Details zur Vertraulichkeit der Reservierung. Datentyp: Objekt |
| Ergebnis.Reservierung.Empfindlichkeit.Anzeigewert | Anzeigewert für die Empfindlichkeit der Reservierung, z. B. hoch oder niedrig. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Empfindlichkeit.Wert | Interner Wert für die Empfindlichkeit der Reservierung, z. B. 1 oder 3. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Schicht | Details zur Schicht, die auf die Reservierung angewendet wird. Datentyp: Objekt |
| Ergebnis.Reservierung.Schicht.Anzeigewert | Anzeigewert der Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.name | Der Name der Schicht Identisch mit display_value. Datentyp: Zeichenfolge |
| Ergebnis.reservierung.schicht.schichtDetails | Details zur Schicht. Datentyp: Zeichenfolge |
| result.reservation.shift.sys_id | Sys_id des Schichtdatensatzes. Befindet sich in der Tabelle „Schicht“ [sn_wsd_core_shift]. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Quelle | Details zur Quelle für die Reservierung, z. B. Workplace Services oder Google Mail. Datentyp: Objekt |
| Ergebnis.Reservierung.Quelle.Anzeigewert | Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices. Datentyp: Zeichenfolge |
| Ergebnis.Reservierung.Quelle.Wert | 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 Anwenderoberflä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 Quellsymbol. Dieses Symbol wird in der Tabelle „Images“ [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: Im Fall mehrerer 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 |
| Ergebnis.Reservierung.Betreff | 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 Unterquellfelds 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 |
| Result.reservation.sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Reservierung. Datentyp: Zeichenfolge |
| result.reservation.virtual_meeting | URL des Links für die virtuelle Besprechung. Datentyp: Zeichenfolge |
| result.reservationAcl | Details der Zugriffssteuerungsebenenprüfungen (ACL), die für die zugeordnete Reservierung festgelegt sind. Datentyp: Objekt |
| result.reservationAcl.read | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender diese Reservierung lesen kann. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write | Details zu den Schreibfähigkeiten des Anwenders für die zugeordnete Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.allFields | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind nur diese Felder im Objekt reservationACL.write.fields zutreffend. Gültige Werte:
Datentyp: Boolesch |
| result.reservationAcl.write.fields | Details der Zugriffssteuerungen für verschiedene Felder der Reservierung. Datentyp: Objekt |
| result.reservationAcl.write.fields.location | Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender 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 Anwender in die Felder für die Teilnehmerzahl 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 Anwender in die Felder „Angefordert für“ 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 Anwender 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 Anwender 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 Anwender 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 „wahr“ festgelegt ist. Zugehörige Standardservices, z. B. Flipchart, Bildschirmprojektor sowie Whiteboard und Marker. Datentyp: Array von Objekten
|
| Ergebnis.Standard_Services.Schriftart_aweso_Symbol | 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 Anwender 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-Reservierung – PATCH /api/sn_wsd_rsv/reservation/cancel/{sys_id}
Storniert eine angegebene Arbeitsplatzreservierung.
URL-Format
URL mit Versionsangabe: /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 Sie eine Reservierung mit diesem Endpunkt stornieren.
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-Reservierung – PATCH /api/sn_wsd_rsv/reservation/share_details/{sys_id}
Aktualisiert die Reservierungsdetails und gibt sie über eine E-Mail-Benachrichtigung an eine angegebene Liste von Empfängern weiter. Optional können Sie eine bestimmte Nachricht zusammen mit der Reservierung senden.
URL-Format
URL mit Versionsnummer: /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 Anwender, an die die E-Mail-Benachrichtigung gesendet werden soll. Befindet sich in der Tabelle „Benutzer“ [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-Reservierung – PATCH /api/sn_wsd_rsv/reservation/update/{sys_id}
Aktualisiert eine angegebene Arbeitsplatzreservierung.
URL-Format
URL mit Versionsnummer: /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 |
|---|---|
| end | 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. Bei einer privaten Reservierung ist die Reservierung nur für den Besitzer sichtbar. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Datenschutzeinstellungen für den Standort und ihre Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: Wert, der für Datenschutz in den Systemeigenschaften festgelegt ist. |
| location | Erforderlich. Sys_id des zu reservierenden Standorts. Zu finden in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| requested_for | Sys_id oder E-Mail-Adresse des Anwenders, für den die Reservierung vorgenommen wird. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| Schicht | Sys_id der Schicht, die der Reservierung zugeordnet werden soll. Befindet sich in der Tabelle „Schicht“ [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierung aktivieren. Datentyp: Zeichenfolge |
| start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (JJJJ-MM-TT hh:mm:ss) |
| Betreff | Erforderlich. Betreff des Meetings, das 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 Antworttexts (JSON oder XML)
| Name | Beschreibung |
|---|---|
| Ergebnis | Details der aktualisierten Reservierung. Datentyp: Objekt |
| result.location_id | Sys_id des Reservierungsstandort-Datensatzes. Zu finden 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 Sie eine Reservierung mit diesem Endpunkt aktualisieren.
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
URL mit Versionsnummer: /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 Durchführung der Anforderungsvalidierungen. Beispiel: Europa/Amsterdam. Diese Validierung überprüft, ob Start- und Endzeit auf denselben Tag fallen. Datentyp: Zeichenfolge Standard: Benutzerzeitzone |
| Name | Beschreibung |
|---|---|
| end | 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. Bei einer privaten Reservierung ist die Reservierung nur für den Besitzer sichtbar. Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Datenschutzeinstellungen für den Standort und ihre Auswirkungen. Gültige Werte:
Datentyp: Boolesch Standard: Wert, der für Datenschutz in den Systemeigenschaften festgelegt ist. |
| location | Erforderlich. Sys_id des zu reservierenden Standorts. Zu finden in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location]. Datentyp: Zeichenfolge |
| requested_for | Sys_id oder E-Mail-Adresse des Anwenders, für den die Reservierung vorgenommen wird. Befindet sich in der Tabelle „Benutzer“ [sys_user]. Datentyp: Zeichenfolge |
| reservable_module | Erforderlich. Sys_id des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. Ein reservierbares Modul definiert die Arbeitsplatzelemente, die für eine Reservierung erforderlich sind. 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 Tabelle „Schicht“ [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierung aktivieren. Datentyp: Zeichenfolge |
| start | Erforderlich. Angeforderte Startzeit der Reservierung. Datentyp: Zeichenfolge Format: UTC oder Ortszeit (JJJJ-MM-TT hh:mm:ss) |
| Betreff | Erforderlich. Betreff des Meetings, das 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
URL mit Versionsnummer: /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 |
|---|---|
| end | 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 der Nähe des Anwenders einen Standort reservieren möchte. Zu finden 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 Arbeitsplatzelemente, die für eine Reservierung erforderlich sind. 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 Tabelle „Schicht“ [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich. Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierung 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 -Schnellreservierungs-Endpunkt 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"
}