WSD API für wiederkehrende Reservierungen

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 35 Minuten Lesedauer
  • Die Workplace Service Delivery (WSD) Recurring Reservation- API bietet Endpunkte für die Verwaltung von Reservierungen, die zur gleichen Zeit auftreten, aber unterschiedliche Daten haben.

    Für den Zugriff auf diese API muss der Aufrufer über die Rolle „sn_wsd_core.workplace_user“ verfügen und die Plugins „Workplace Safety Management“ (sn_wsd_core) und „Workplace Reservation Management“ (sn_wsd_rsv) müssen aktiviert sein.

    Diese API wird im Namespace sn_wsd_rsv ausgeführt.

    Weitere Informationen zu Workplace Reservation Managementfinden Sie unter Workplace Reservation Management.

    WSD Recurring Reservation – GET /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}

    Gibt die angegebene wiederkehrende Reservierung zurück.

    Wenn mehr als sechs wiederkehrende Besprechungstermine für die Reservierung verfügbar sind, können Sie die Termine mithilfe der Abfrageparameter paginieren. Sie können auch Vorkommensdatensätze angeben, die nicht zurückgegeben werden sollen.

    URL-Format

    Versionierte URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/list/{parent_id}

    Standard-URL: /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfadparameter
    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

    parent_id Sys_id des wiederkehrenden übergeordneten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Wenn eine wiederkehrende Reservierung erstellt wird, werden ein wiederkehrender übergeordneter Datensatz und mindestens ein untergeordneter Reservierungsdatensatz erstellt. Reservierungsdatensätze enthalten ein Feld mit der Bezeichnung „reservierung_subtyp“, das den Typ des Reservierungsdatensatzes angibt. Für wiederkehrende übergeordnete Datensätze wird dieses Feld auf „Wiederkehrendes übergeordnetes Element“ festgelegt. Für untergeordnete Datensätze wird dieses Feld auf „Vorkommen“ festgelegt.

    Innerhalb eines untergeordneten Datensatzes befindet sich die sys_id des zugeordneten wiederkehrenden übergeordneten Datensatzes im Feld source_reservation.

    Datentyp: Zeichenfolge

    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    end_index Beim Paginieren durch einen wiederkehrenden Datensatz die nullbasierte Datensatznummer, bei der die Rückgabe von Vorkommensdatensätzen beendet werden soll.
    Hinweis:
    Wenn die Anzahl der wiederkehrenden Vorkommen weniger als sechs beträgt, gibt der Endpunkt alle Vorkommen zurück, andernfalls werden die ersten sechs Vorkommen zurückgegeben. Um mehr als sechs Vorkommen abzurufen, müssen Sie den Parameter end_index entsprechend übergeben.

    Datentyp: Zahl

    incident_sys_id Sys_id eines Vorkommensdatensatzes in der wiederkehrenden Serie, der nicht zurückgegeben werden soll. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].
    start_index Beim Paginieren durch einen wiederkehrenden Datensatz die nullbasierte Datensatznummer, ab der mit der Rückgabe von Vorkommensdatensätzen begonnen werden soll.

    Datentyp: Zahl

    Standard: 0

    Tabelle : 3. Anforderungstextparameter
    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.

    Tabelle : 4. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Anforderungstexts. Unterstützte Typen: application/json, application/xml oder text/xml.

    Standard: application/json

    Tabelle : 5. Antwortkopfzeilen
    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.

    Tabelle : 6. Statuscodes
    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 Gibt die Ergebnisse für die angeforderte wiederkehrende Reservierung zurück.

    Datentyp: Objekt

    "result": {
     "occurencesTotalCount": "String",
     "reservation": {Object}
    }
    result.occurencesTotalCount Gesamtzahl der Besprechungen in der wiederkehrenden Serie.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung Details zur angeforderten wiederkehrenden Reservierung.

    Datentyp: Objekt

    "reservation": {
      "active": Boolean,
      "attendees": [Array],
      "check_in_state": {Object},
      "edit_restriction": {Object},
      "end": "String",
      "external_ical": "String",
      "external_id": "String",
      "is_parent": Boolean,
      "last_updated_sub_source": {Object},
      "location": {Object},
      "notification_custom_message": "String",
      "notification_recipients": [Array],
      "number": "String",
      "number_of_attendees": Number,
      "opened_by": {Object},
      "recording_details": [Array],
      "recurring_pattern": {Object},
      "requested_for": {Object},
      "reservable_module": {Object},
      "sensitivity": {Object},
      "shift": {Object},
      "source": {Object},
      "source_icon": {Object},
      "source_reservation": {OObject},
      "source_reservation_requester": {Object},
      "start": "String",
      "state": {OObject},
      "sys_created_on": "String",
      "sys_id": "String",
      "sys_updated_on": "String",
      "subject": "String",
      "sub_source": {Object},
      "sync_state": {Object},
      "virtual_meeting": "String"
    }
    result.reservation.active Kennzeichnung, die angibt, ob die Reservierung aktiv ist.
    Gültige Werte:
    • true: Reservierung ist aktiv.
    • false: Reservierung ist inaktiv.

    Datentyp: Boolesch

    Ergebnis.Reservierung.Teilnehmer Liste der Teilnehmer für die Reservierung.

    Datentyp: Array von Objekten

    "attendees": [
      {
        "avatar": "String",
        "displayValue": "String",
        "display_value": "String",
        "email": "String",
        "initials": "String",
        "label": "String",
        "name": "String",
        "sys_id": "String",
        "table": "String",
        "user_name": "String",
        "value": "String"
      }
    ]
    Ergebnis.Reservierung.Teilnehmer.Avatar Sys_id des Avatars, der dem Teilnehmer zugeordnet ist. Befindet sich in der Tabelle „Anhänge“ [sys_attachment].

    Datentyp: Zeichenfolge

    result.reservation.teilnehmer.displayValue Anzeigewert für den Teilnehmer.

    Datentyp: Zeichenfolge

    result.reservation.attendees.display_value Anzeigewert des Teilnehmers. Identisch mit displayValue.

    Datentyp: Zeichenfolge

    result.reservation.attendees.email E-Mail-Adresse des Teilnehmers.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Initialen Initialen des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.attendees.name Name des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.teilnehmer.sys_id Sys_id_des Teilnehmerdatensatzes.

    Datentyp: Zeichenfolge

    result.reservation.teilnehmer.tabelle Tabelle, in der der Teilnehmerdatensatz vorhanden ist.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Benutzername Benutzername des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.attendees.value Interner Wert des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.check_in_state Details zum Check-in-Status der Reservierung.

    Datentyp: Objekt

    "check_in_state": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.check_in_state.​display_value Anzeigewert für den aktuellen Check-in-Status der Reservierung, z. B. In Bearbeitung oder Abgeschlossen.

    Datentyp: Zeichenfolge

    result.reservation.check_in_state.value Interner Wert für den aktuellen Check-in-Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

    result.reservation.edit_restriction Beschreibung der Benutzerbearbeitungsbeschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „complete_restricted“.

    Datentyp: Objekt

    "edit_restriction": {
      "display_value": "String",
      "value": "String"
    }
    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:
    • true: Übergeordnete Reservierung.
    • false: Keine übergeordnete Reservierung.

    Datentyp: Boolesch

    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

    "last_updated_sub_source": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.last_updated_sub_source.​display_value Anzeigewert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. ServiceNow Workplace Service Delivery oder Google Kalender. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird.

    Datentyp: Zeichenfolge

    result.reservation.last_updated_sub_source.​value Interner Wert für die zuletzt aktualisierte Unterquelle der Reservierung, z. B. servicenow_workplace_service_delivery oder google_calendar. Wird verwendet, wenn die Reservierung mit einem externen Service wie Google Kalender oder Microsoft Outlook integriert wird.

    Datentyp: Zeichenfolge

    result.reservation.location Details zum Standort, der der Reservierung zugeordnet ist.

    Datentyp: Objekt

    "location": {
      "area": {Object},
      "building": {Object},
      "campus": {Object},
      "capacity": Number,
      "description": "String",
      "display_value": "String",
      "email": "String",
      "floor": {Object},
      "label_value": "String",
      "name": "String",
      "number": "String",
      "number_of_attendees": Boolean,
      "reservable_module": {Object},
      "region": {Object},
      "reservation": {Object},
      "site": {Object},
      "requested_for": {Object},
      "state": {Object},
      "sys_id": "String",
    }
    result.reservation.location.area Details zum Bereich, der dem Standort zugeordnet ist.

    Datentyp: Objekt

    "area": {
      "active": Boolean,
      "display_value": "String,"
      "sys_id": "String"
    }
    result.reservation.location.area.active Kennzeichnung, die angibt, ob der Bereich aktiv ist.
    Gültige Werte:
    • true: Bereich ist aktiv.
    • false: Bereich ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.area.display_value Anzeigewert des Bereichs, zu dem dieser Standort gehört, z. B. Schreibtisch A2.

    Datentyp: Zeichenfolge

    result.reservation.location.area.sys_id Sys_id des Bereichs, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Bereich“ [sn_wsd_core_area].

    Datentyp: Zeichenfolge

    result.reservation.location.building Details zum Gebäude, das dem Standort zugeordnet ist.

    Datentyp: Objekt

    "building": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String",
      "timezone": {Object}
    }
    result.reservation.location.building.active Kennzeichnung, die angibt, ob das Gebäude aktiv ist.
    Gültige Werte:
    • true: Gebäude ist aktiv.
    • false: Gebäude ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.building.​display_value Anzeigewert des Gebäudes, zu dem dieser Standort gehört, z. B. AMS - Geb. 1.

    Datentyp: Zeichenfolge

    result.reservation.location.building.sys_id Sys_id des Gebäudes, zu dem dieser Standort gehört. Befindet sich in der Gebäudetabelle [sn_wsd_core_building].

    Datentyp: Zeichenfolge

    result.reservation.location.building.timezone Details der Zeitzone für das Gebäude.
    "timezone": {
      "displayValue": "String",
      "value": "String"
    }
    result.reservation.location.building.timezone.​display_value Anzeigewert der Zeitzone, in der sich das zugeordnete Gebäude befindet.

    Datentyp: Zeichenfolge

    result.reservation.location.building.timezone.​value Interner Wert für die Zeitzone, zu der dieser Standort gehört.

    Datentyp: Zeichenfolge

    result.reservation.location.campus Details zum Campus, der dem Standort zugeordnet ist.

    Datentyp: Objekt

    "campus": {
      "active": Boolean,
      "display_value": "String,"
      "sys_id": "String"
    }
    result.reservation.location.campus.active Kennzeichnung, die angibt, ob der Campus aktiv ist.
    Gültige Werte:
    • true: Campus ist aktiv.
    • false: Campus ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.campus.​display_value Anzeigewert des Campus, zu dem dieser Standort gehört, z. B. Campus Amsterdam.

    Datentyp: Zeichenfolge

    result.reservation.location.campus.sys_id Sys_id des Campus, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Campus“ [sn_wsd_core_campus].

    Datentyp: Zeichenfolge

    result.reservation.location.capacity Maximale Anzahl von Personen für den Standort.

    Datentyp: Zahl

    result.reservation.location.description Kurze Beschreibung des Standorts.

    Datentyp: Zeichenfolge

    result.reservation.location.display_value Wert, der in der Benutzeroberfläche für diesen Standort angezeigt werden soll.

    Datentyp: Zeichenfolge

    result.reservation.location.email E-Mail-Adresse für den Standort.

    Datentyp: Zeichenfolge

    result.reservation.location.stockwerk Details zum Stockwerk, das dem Standort zugeordnet ist.

    Datentyp: Objekt

    "floor": {
      "active": Boolean,
      "display_value": "String,"
      "sys_id": "String"
    }
    result.reservation.location.floor.active Kennzeichnung, die angibt, ob das Stockwerk aktiv ist.
    Gültige Werte:
    • true: Stockwerk ist aktiv.
    • false: Stockwerk ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.stockwerk.display_value Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erstes Stockwerk.

    Datentyp: Zeichenfolge

    result.reservation.location.stockwerk.sys_id Sys_id des Stockwerks, zu dem dieser Standort gehört. Befindet sich in der Tabelle „Stockwerk“ [sn_wsd_core_floor].

    Datentyp: Zeichenfolge

    result.reservation.location.label_value Typ des im Parameter name angegebenen Werts, z. B. Raumname.

    Datentyp: Zeichenfolge

    result.reservation.location.name Name des Standorts.

    Datentyp: Zeichenfolge

    result.reservation.location.number Reservierungsnummer.

    Datentyp: Zeichenfolge

    result.reservation.location.number_of_​attendees Anzahl der Teilnehmer für die Reservierung.

    Datentyp: Zahl

    result.reservation.location.reservable_module Details zum reservierbaren Modul, das der Reservierung zugeordnet ist.

    Datentyp: Objekt

    
      "reservable_module": {
        "inline_title": "String",
        "name": "String",
        "sys_id": "String",
        "title": "String",
      },
    result.reservation.location.reservable_module.​inline_title Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt.

    Datentyp: Zeichenfolge

    result.reservation.location.reservable_module.​name Name des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.location.reservable_module.​sys_id Sys_id des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.location.reservable_module.​title Titel des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.location.region Details zur Region, die dem Standort zugeordnet ist.

    Datentyp: Objekt

    "region": {
      "active": Boolean,
      "display_value": "String,"
      "sys_id": "String"
    }
    result.reservation.location.region.active Kennzeichnung, die angibt, ob die Region aktiv ist.
    Gültige Werte:
    • true: Region ist aktiv.
    • false: Region ist inaktiv.

    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.reservation Details zur Reservierung, die dem Standort zugeordnet ist.

    Datentyp: Objekt

    "reservation": {
      "active": Boolean,
      "number": "String",
      "number_of_attendees": Number,
      "requested_for": {Object},
      "state": {Object},
      "sys_id": "String"
    }
    result.reservation.location.reservation.active Kennzeichnung, die angibt, ob die Reservierung aktiv ist.
    Gültige Werte:
    • true: Reservierung ist aktiv.
    • false: Reservierung ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.reservation.number Reservierungsnummer.

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.number_of_attendees Anzahl der Teilnehmer der Reservierung.

    Datentyp: Zahl

    result.reservation.location.reservation.​requested_for Details zur Person, für die die Reservierung im Namen von angefordert wurde.

    Datentyp: Objekt

    "requested_for": {
      "name": "String",
      "sys_id": "String",
      "user_name": "String"
    }
    result.reservation.location.reservation.​requested_for.name Name des Benutzers, für den die Reservierung angefordert wurde.

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.​requested_for.sys_id Sys_id des angeforderten Anwenders. Befindet sich in der Benutzertabelle [sys_user].

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.​requested_for.user_name Benutzername des Benutzers, für den die Reservierung angefordert wurde.

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.​state Details zum Status der Reservierung für den Standort.

    Datentyp: Objekt

    "state": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.location.reservation.​.state.display_value Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“.

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.​.state.value Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

    result.reservation.location.site Site, zu der der Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site].

    Datentyp: Objekt

    "site": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String",
    }
    result.reservation.location.site.active Kennzeichnung, die angibt, ob die Site aktiv ist.
    Gültige Werte:
    • true: Site ist aktiv.
    • false: Site ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.site.display_value Anzeigewert des Standorts, zu dem dieser Standort gehört, z. B. Westeuropa.

    Datentyp: Zeichenfolge

    result.reservation.location.site.sys_id Sys_id des Standorts, zu dem dieser Speicherort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site].

    Datentyp: Zeichenfolge

    result.reservation.location.standard_services
    result.reservation.location.state Details zum Status der Reservierung für den Standort.

    Datentyp: Objekt

    "state": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.location.state.display_value Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“.

    Datentyp: Zeichenfolge

    result.reservation.location.state.value Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

    result.reservation.location.sys_id Sys_id des zugeordneten Standortdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location].

    Datentyp: Zeichenfolge

    result.reservation.notification_custom_​message Benutzerdefinierte Nachricht für die Benachrichtigung, die an die in reservation.notification_recipientsaufgeführten Empfänger gesendet wird.

    Datentyp: Zeichenfolge

    result.reservation.notification_recipients Liste der Empfänger, die Benachrichtigungen über die Reservierung erhalten.

    Datentyp: Array von Objekten

    "notification_recipients":[
      {
        "name": "String",
        "sys_id": "String",
        "user_name": "String"
      }
    ]
    result.reservation.notification_recipients.name Name des Empfängers.

    Datentyp: Zeichenfolge

    result.reservation.notification_recipients.sys_id Sys_id des Empfängers. Befindet sich in der Benutzertabelle [sys_user].

    Datentyp: Zeichenfolge

    result.reservation.notification_recipients.​user_name Benutzername des Empfängers.

    Datentyp: Zeichenfolge

    result.reservation.number Eindeutige Nummer des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation]. Sie können diesen Wert verwenden, um die Reservierung abzufragen.

    Datentyp: Zeichenfolge

    result.reservation.number_of_attendees Anzahl der Teilnehmer in dieser Reservierung.

    Datentyp: Zahl

    result.reservation.opened_by Details zum Benutzer, der die Reservierung erstellt hat.

    Datentyp: Objekt

    "opened_by": {
      "avatar": "String",
      "displayValue": "String",
      "display_value": "String",
      "email": "String",
      "initials": "String",
      "label": "String",
      "name": "String",
      "sys_id": "String",
      "table": "String",
      "user_name": "String",
      "value": "String"
    }
    result.reservation.opened_by.avatar Avatar für den Benutzer, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.displayValue Anzeigewert des Benutzers, der ihn geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.display_value Anzeigewert des Benutzers, der ihn geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.email E-Mail-Adresse des Benutzers, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.initials Initialen des Benutzers, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.name Name des Benutzers, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.user_name Benutzername des Benutzers, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.value Interner Wert des Benutzers, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.recording_details Details zu den Aufzeichnungen, die der Reservierung (Besprechung) zugeordnet sind.

    Datentyp: Array

    "recording_details": [
      "recording_url": "String"
    ]
    result.reservation.recording_details.​recording_url URL der Aufzeichnungen, die der Reservierung zugeordnet sind.

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern Details zum wiederkehrenden Muster für die Reservierung.

    Datentyp: Objekt

    "recurring_pattern": {
      "amountOfDates": "String",
      "duration": Number,
      "label": "String",
      "options": {Object},
      "repeats": "String",
      "startDate":"String",
      "startDateGdt": Object,
    }
    result.reservation.recurring_pattern.​amountOfDates Anzahl der Daten, für die die reservierbaren Elemente reserviert sind.

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern.duration
    Dauer für die Reservierung des reservierbaren Elements.

    Datentyp: Zahl

    Einheit: Sekunden

    result.reservation.recurring_pattern.label Beschreibender Name für die wiederkehrende Reservierung.

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern.options Details zu den Optionen, die der wiederkehrenden Reservierung zugeordnet sind.

    Datentyp: Objekt

    "options": {
      "count": Number,
      "daysOfWeek": "String",
      "every": Number,
      "endDate": "String"
      "endDateGdt": Object
    }
    result.reservation.recurring_pattern.options.​count

    Anzahl der Wiederholungen des Musters.

    Datentyp: Zahl

    result.reservation.recurring_pattern.options.​daysOfWeek

    Wochentage, an denen das reservierbare Element benötigt wird.

    Gültige Werte:
    • 1 = Montag
    • 2 = Dienstag
    • 3 = Mittwoch
    • 4 = Donnerstag
    • 5 = Freitag
    • 6 = Samstag
    • 7 = Sonntag

    Um beispielsweise Dienstag, Donnerstag und Freitag anzugeben, übergeben Sie 245 (kein Trennzeichen). Wenn repeatsweekly“ ist, count5“ ist und daysOfWeek 245“ ist, dann ist die Summe in den zurückgegebenen Ergebnissen gleich count*daysOfWeek.length (5*3=15).

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern.options.​every Musterwiederholungsintervall. Wenn dieser Wert beispielsweise 2ist, wiederholen Sie das Muster alternativ basierend auf der Auswahl im Parameter repeats, z. B. jeden zweiten Tag oder jede zweite Woche.

    Datentyp: Zahl

    result.reservation.recurring_pattern.options.endDate Enddatum und -uhrzeit der Wiederholung der Besprechung, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    result.reservation.recurring_pattern.options.​ endDateGdt Enddatum und -uhrzeit der Wiederholung der Besprechung, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    result.reservation.recurring_pattern.repeats

    Wiederholtes Muster für das reservierbare Element.

    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • täglich
    • monatlich
    • wöchentlich
    • jährlich

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern.startDate
    Startdatum und -uhrzeit für das wiederkehrende Muster, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    result.reservation.recurring_pattern​ startDateGdt
    Startdatum und -uhrzeit für das wiederkehrende Muster, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    result.reservation.requested_for Details zum Benutzer, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Objekt

    "requested_for": {
      "avatar": "String",
      "displayValue": "String",
      "display_value": "String",
      "email": "String",
      "initials": "String",
      "label": "String",
      "name": "String",
      "sys_id": "String",
      "table": "String",
      "user_name": "String",
      "value": "String"
    }
    result.reservation.requested_for.avatar Avatar für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.displayValue Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.display_value Anzeigewert des Benutzers, für den die Reservierung vorgenommen wurde. Identisch mit displayValue.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.email E-Mail-Adresse des Benutzers, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.initials Initialen des Benutzers, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.label Bezeichnung für den Benutzer, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.name Name des Benutzers, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.rservation.requested_for.sys_id Sys_id_of des Benutzers, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Benutzertabelle [sys_user].

    Datentyp: Zeichenfolge

    result.rservation.requested_for.table Tabelle, die den Benutzerdatensatz enthält.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.user_name Benutzername des Benutzers, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.value Interner Wert des Benutzers, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module Details für das angeforderte reservierbare Modul.

    Datentyp: Objekt

    {
      "reservable_module": {
        "allow_invitees": Boolean,
        "allow_whole_day": Boolean,
        "apply_to_shift": Boolean,
        "browse_by_area_enabled": Boolean,
        "browse_near_a_person_enabled": Boolean,
        "buildingSysIds": [Array],
        "checkin_before_minutes": Number,
        "display_number_of_attendees": Boolean,
        "display_on_behalf_of": Boolean,
        "display_sensitivity": Boolean,
        "display_value": "String",
        "enable_browse_by_area": Boolean,
        "enable_browse_near_a_person": Boolean,
        "enable_facet_filter": Boolean,
        "enable_group_reservations": Boolean,
        "enable_ical_generation": Boolean,
        "font_awesome_icon": "String",
        "inline_title": "String",      
        "layout_mapping": {JSON Object},
        "max_days_in_future": Number,
        "max_occurrences": Number,
        "name": "String",
        "override_approval_policy": "String",
        "require_cancel_notes": Boolean,
        "require_cc_dept_check": Boolean,
        "require_subject": Boolean,
        "reservable_columns": [Array],
        "reservable_container_field": "String",
        "reservable_filter": "String",
        "reservable_quantity_field": "String",
        "reservable_table": "String",
        "reservable_type": "String",
        "reservable_views": [Array],
        "reservation_paths": [Array],
        "search_limit": Number,
        "selection_type": "String",
        "short_description": "String",
        "show_map_view": Boolean,
        "sys_id": "String",
        "timeSlots": [Array],
        "title": "String",
        "virtual_meeting_provider": {Object}
      }
    }
    result.reservation.reservable_module.​allow_invitees Kennzeichnung, die angibt, ob Mitarbeiter der Reservierung eingeladene Personen hinzufügen können.
    Gültige Werte:
    • true: Erlaubt Mitarbeitern, eingeladene Personen zur Reservierung hinzuzufügen.
    • false: Mitarbeiter dürfen der Reservierung keine eingeladenen Personen hinzufügen.

    Datentyp: Boolesch

    result.reservation.reservable_module.allow_wholt_day Kennzeichnung, die angibt, ob Benutzer das reservierbare Element für den gesamten Tag reservieren können.
    Gültige Werte:
    • true: Erlaubt Benutzern, für den gesamten Tag zu reservieren.
    • false: Benutzer können nicht für den gesamten Tag reservieren.

    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:
    • true: Schichtbasierte Reservierungen zulassen.
    • false: Schichtbasierte Reservierungen nicht zulassen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​browse_by_area_enabled Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können.
    Gültige Werte:
    • true: Ermöglicht Benutzern das Durchsuchen reservierbarer Module nach Bereich.
    • false: Benutzer können reservierbare Module nicht nach Bereich durchsuchen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​browse_near_a_person_enabled Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden.
    Gültige Werte:
    • true: Ermöglicht Benutzern das Durchsuchen reservierbarer Module in der Nähe einer Person.
    • false: Benutzer können keine reservierbaren Module in der Nähe einer Person durchsuchen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​buildingSysIds Liste der sys_ids der Gebäude, die dem reservierbaren Modul zugeordnet sind.

    Datentyp: Array von Zeichenfolgen

    result.reservation.reservable_module.​checkin_before_minutes Zeitraum vor Beginn einer Reservierung, in dem ein Benutzer in seine Reservierung einchecken kann.

    Einheit: Minuten

    Datentyp: Zahl

    result.reservation.reservable_module.​display_number_of_attendees Kennzeichnung, die angibt, ob Benutzer die Anzahl der Teilnehmer in der Reservierung angeben können.
    Gültige Werte:
    • true: Benutzer können die Anzahl der Teilnehmer angeben.
    • false: Benutzer können die angezeigte Anzahl der Teilnehmer nicht angeben.

    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:
    • true: Im Auftrag von unterstützt.
    • false: Im Namen von nicht unterstützt.

    Datentyp: Boolesch

    result.reservation.reservable_module.​display_sensitivity Kennzeichnung, die angibt, ob Benutzer die Vertraulichkeit der Reservierung festlegen können, z. B. „Normal“ oder „Privat“.
    Gültige Werte:
    • true: Empfindlichkeit kann festgelegt werden.
    • false: Empfindlichkeit kann nicht festgelegt werden. Der Standardwert ist „Normal“.

    Datentyp: Boolesch

    result.reservation.reservable_module.​display_value Anzeigewert des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​enable_browse_by_area Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen nach Bereich suchen können. Identisch mit browse_by_area_enabled.
    Gültige Werte:
    • true: Ermöglicht Benutzern das Durchsuchen reservierbarer Module nach Bereich.
    • false: Benutzer können reservierbare Module nicht nach Bereich durchsuchen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​enable_browse_near_a_person Kennzeichnung, die angibt, ob Benutzer nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Identisch mit browse_near_a_person_enabled.
    Gültige Werte:
    • true: Ermöglicht Benutzern das Durchsuchen reservierbarer Module in der Nähe einer Person.
    • false: Benutzer können keine reservierbaren Module in der Nähe einer Person durchsuchen.

    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:
    • true: Aspektfilter sind aktiviert.
    • false: Aspektfilter sind nicht aktiviert.

    Datentyp: Boolesch

    result.reservation.reservable_module.​enable_group_reservations Kennzeichnung, die angibt, ob Benutzer eine Gruppenreservierung vornehmen können.
    Gültige Werte:
    • true: Gruppenreservierungen möglich.
    • false: Gruppenreservierungen können nicht vorgenommen werden.

    Datentyp: Boolesch

    result.reservation.reservable_module.​enable_ical_generation Kennzeichnung, die angibt, ob Benutzer einen iCalendar für die Reservierung generieren können.
    Gültige Werte:
    • true: iCalendar-Generierung zulässig.
    • false: iCalendar-Generierung ist nicht zulässig.

    Datentyp: Boolesch

    result.reservation.reservable_module.​font_awesome_icon Name des Schriftartsymbols, das an das reservierbare Modul angehängt ist.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​inline_title Inline-Titel des reservierbaren Moduls. Der Titel wird in Übereinstimmung mit dem beschreibenden Text im Workplace Service Portal angezeigt.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.layout_mapping Details zur Struktur der Layoutzuordnung von Standorten. Verwenden Sie diese Daten, um die Informationen in der Benutzeroberfläche zu gestalten.

    Datentyp: Objekt

    "layout_mapping": {
      "body": [Array],
      "description": [Array],
      "image": "String",
      "subtitle": [Array],
      "subtitle_asc": [Array],
      "title": [Array]
    }
    result.reservation.reservable_module.​layout_mapping.body Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Array von Objekten

    "body": [
      {
        "field": "String",
        "field_to_display": "String",
        "icon": "String",
        "label": "String"
      }
    ]
    result.reservation.reservable_module.​layout_mapping.body.field Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.layout_mapping.body.field_to_display Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​layout_mapping.body.icon Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​layout_mapping.body.label Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​layout_mapping.description Platzhalter für die Zuordnung der Front-End-UI-Daten. Beschreibung der Layoutzuordnung.

    Datentyp: Array

    result.reservation.reservable_module.​layout_mapping.image Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​layout_mapping.subtitle Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Array

    result.reservation.reservable_module.​layout_mapping.subtitle_asc Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Array

    result.reservation.reservable_module.​layout_mapping.title Platzhalter für die Zuordnung der Front-End-UI-Daten.

    Datentyp: Array

    result.reservation.reservable_module.​max_days_in_zukünftig Maximale Anzahl der Tage in der Zukunft, für die ein Benutzer das reservierbare Modul reservieren kann.

    Datentyp: Zahl

    result.reservation.reservable_module.​max_occurrences Maximale Anzahl wiederkehrender Reservierungen, wenn wiederkehrende Reservierungen für das reservierbare Modul verfügbar sind.

    Datentyp: Zahl

    result.reservation.reservable_module.name Name des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​override_approval_policy Option zum Festlegen, wie die Genehmigungsrichtlinie zu implementieren ist. Die Auswahlmöglichkeiten lauten wie folgt:
    • Keine Überschreibung: Die Genehmigungsrichtlinie wird implementiert, wie im Feld Genehmigung erforderlich für einen Arbeitsplatzbereich oder -raum festgelegt.
    • Genehmigung immer erforderlich: Die Genehmigungsrichtlinie ist unabhängig von der Einstellung im Feld Genehmigung erforderlich für einen Arbeitsplatzbereich oder -raum erforderlich.
    • Genehmigung nie erforderlich: Die Genehmigungsrichtlinie wird unabhängig von der Einstellung im Feld Genehmigung erforderlichl für einen Arbeitsplatzbereich oder -raum entfernt.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​require_cancel_notes Kennzeichnung, die angibt, ob Benutzer eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren.
    Gültige Werte:
    • true: Stornierungshinweis erforderlich.
    • false: Stornierungshinweis nicht erforderlich.

    Datentyp: Boolesch

    result.reservation.reservable_module.​require_cc_dept_check Kennzeichnung, die angibt, ob zwischen dem Arbeitsbereichselement und dem angemeldeten Benutzer eine Kostenstelle oder Abteilungsabweichung besteht.
    Gültige Werte:
    • true: Auf Nichtübereinstimmung prüfen.
    • false: Nicht auf Nichtübereinstimmung prüfen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​require_subject Kennzeichnung, die angibt, ob der Benutzer bei der Reservierung einen Betreff eingeben muss.
    Gültige Werte:
    • true: Betreff erforderlich.
    • false: Betreff ist nicht erforderlich.

    Datentyp: Boolesch

    result.reservation.reservable_module.​reservable_columns Liste der Spalten eines reservierbaren Elements. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location].

    Datentyp: Array

    result.reservation.reservable_module.​reservable_container_field Ebene des Containers, z. B. eine Gruppe von Schreibtischen in einem bestimmten Bereich.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_filter Filterbedingungen, die verwendet werden, um reservierbare Elemente in der zugehörigen Tabelle „Reservierbar“ herauszufiltern. Die Tabelle „Reservierbar“ ist ein Feld in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module]. Diese Filterbedingungen wurden auf die Tabelle angewendet, die im Feld Reservierbare Tabelle enthalten ist.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_quantity_field Die reservierbare Menge aller Arbeitsbereiche. Die Menge wird verwendet, wenn einem Bereich angrenzende Arbeitsbereiche zugewiesen werden. Weitere Informationen finden Sie unter Aneinander angrenzende Bereiche einem Bereich zuweisen.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_table Tabelle, die die reservierbaren Arbeitsplatzelemente enthält.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_type Typ des reservierbaren Elements, z. B. Standort.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_views Details zu den verschiedenen Ansichten, die dem reservierbaren Modul zugeordnet sind, z. B. Kartenansicht oder Zeitplanansicht.

    Befindet sich in der Tabelle „Reservierbare Ansicht“ [sn_wsd_rsv_reservable_view].

    Datentyp: Objekt

    "reservable_views": {
      "iconClass": "String",
      "isDefault": Boolean,
      "label": "String",
      "order": Number,
      "type": "String"
    }
    result.reservation.reservable_module.​reservable_views.iconClass Symbolklasse der reservierbaren Ansicht.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_views.isDefault Kennzeichnung, die angibt, ob diese reservierbare Ansicht als Standard für reservierbare Module festgelegt werden soll.
    Gültige Werte:
    • true: Als Standard festlegen.
    • false: Nicht als Standard festlegen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​reservable_views.label Name der reservierbaren Ansicht.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_views.order Reihenfolge, in der die Ansichten für das reservierbare Modul in der Benutzeroberfläche angezeigt werden. Die niedrigere Ordnungszahl kommt in der Benutzeroberfläche zuerst. Bei gleicher Reihenfolgennummer wird eine zufällige Reihenfolge zugewiesen.

    Datentyp: Zahl

    result.reservation.reservable_module.​reservable_views.type Back-End-Name der reservierbaren Ansicht. Wird für die interne Verarbeitung verwendet.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservation_paths Reservierungspfade, die den reservierbaren Modulen zugeordnet sind, z. B. Alle durchsuchen, In der Nähe einer Person suchen.

    Datentyp: Array von Objekten

    "reservation_paths": [
      {
        "displayValue": "String",
        "value": "String"
    }
    result.reservation.reservable_module.​reservation_paths.display_value Anzeigewert für den Reservierungspfad, z. B. „In der Nähe einer Person suchen“.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservation_paths.value Interner Wert für den Reservierungspfad, z. B. „browse_near_a_person“.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​search_limit Maximale Anzahl der Suchergebnisse, die zurückgegeben werden sollen, wenn ein Benutzer nach einem Arbeitsplatzstandort sucht.

    Datentyp: Zahl

    result.reservation.reservable_module.​selection_type

    Der Typ der Auswahl, die in den Suchergebnissen angezeigt werden soll.

    Dies kann eine der folgenden Optionen sein:
    • Bestimmte Einheit: Das Suchergebnis zeigt alle Arbeitsplatzelemente an.
    • Container: Das Suchergebnis zeigt das übergeordnete Element oder den Container der Arbeitsplatzelemente an.

    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:
    • true: Kartenansicht aktivieren.
    • false: Kartenansicht nicht aktivieren.

    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

    [
      {
        "name": "String",
        "short_description": "String",
        "slot_end": "String",
        "slot_start": "String",
        "sys_id": "String"
      }
    ]
    result.reservation.reservable_module.​timeSlots.name Name des Zeitfensters.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.timeSlots.short_description Kurze Beschreibung des Zeitfensters.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.timeSlots.slot_end Endzeit des Zeitfensters.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.timeSlots.slot_start Startzeit des Zeitfensters.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.timeSlots.sys_id Sys_id des Zeitfenster-Datensatzes.

    Befindet sich in der Zeitfenstertabelle [sn_wsd_rsv_time_slot].

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.title Titel des reservierbaren Moduls.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​virtual_meeting_provider Details zum virtuellen Anbieter, der dem reservierbaren Modul zugeordnet ist.

    Datentyp: Objekt

    "virtual_meeting_provider": {
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.reservable_module.​virtual_meeting_provider.display_value Anzeigewert des Anbieters der virtuellen Besprechung.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​virtual_meeting_provider.sys_id Sys_id des Anbieters der virtuellen Besprechung.

    Datentyp: Zeichenfolge

    result.reservation.reservationAcl Details der Prüfungen der Benutzerzugriffskontrollebenen (ACL), die für die zugehörige Reservierung festgelegt wurden.

    Datentyp: Objekt

    "reservationAcl": {
      "read": Boolean,
      "write": {Object}
    }
    result.reservation.reservationAcl.read Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer diese Reservierung lesen kann.
    Gültige Werte:
    • true: Überprüfen Sie, ob der Benutzer die Reservierung lesen kann.
    • false: Überprüft nicht, ob der Anwender die Reservierung lesen kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write Details zu den Schreibfähigkeiten des Benutzers für die zugehörige Reservierung.

    Datentyp: Objekt

    "write": {
      "allFields": Boolean,
      "fields": {Object},
      "record": Boolean
    }
    result.reservation.reservationAcl.write.allFields Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind im Objekt reservationACL.write.fields nur diese Felder „true“.
    Gültige Werte:
    • true: Überprüft, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields Details der Zugriffskontrollen in verschiedenen Feldern der Reservierung.

    Datentyp: Objekt

    "fields": {
      "location": Boolean,
      "number_of_attendees": Boolean,
      "requested_for": Boolean,
      "sensitivity": Boolean,
      "subject": Boolean
    }
    result.reservation.reservationAcl.write.fields.​location Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Standortfelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • true: Überprüfen, ob der Benutzer in die Standortfelder schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in die Standortfelder schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.number_of_attendees Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Felder für die Anzahl der Teilnehmer in dieser Reservierung schreiben kann.
    Gültige Werte:
    • true: Überprüfen Sie, ob der Benutzer in das Feld „Anzahl der Teilnehmer“ schreiben kann.
    • false: Überprüft nicht, ob der Anwender in das Feld „Anzahl der Teilnehmer“ schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.​requested_for Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die angeforderten Felder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • true: Überprüft, ob der Benutzer in das Feld „Angefordert für“ schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in das Feld „Angefordert für“ schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.​sensitivität Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • true: Überprüfen, ob der Benutzer in das Vertraulichkeitsfeld schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in das Vertraulichkeitsfeld schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.​subject Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in die Betrefffelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • true: Überprüft, ob der Benutzer in das Betrefffeld schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in die Betrefffelder schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.record Kennzeichnung, die angibt, ob überprüft werden soll, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann.
    Gültige Werte:
    • true: Überprüfen Sie, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann.
    • false: Überprüft nicht, ob der Benutzer in den gesamten Reservierungsdatensatz schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservation_zweck Details zum Zweck der Reservierung.

    Datentyp: Objekt

    "reservation_purpose": {
      "display_value": "String,"
      "value": "String"
    }
    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

    "reservation_type": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.reservation_type.​display_value Anzeigewert für den Typ der Reservierung, z. B. Platz.

    Datentyp: Zeichenfolge

    result.reservation.reservation_type.value Interner Wert für den Typ der Reservierung, z. B. Platz.

    Datentyp: Zeichenfolge

    result.reservation.reservation_subtype Details zum Untertyp der Reservierung. Untertypen geben den Typ der Reservierung an, z. B. Einzeln, Mehrfach übergeordnet, Mehrfach untergeordnet, Wiederkehrend übergeordnet oder Vorkommen.

    Datentyp: Objekt

    "reservation_subtype": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.reservation_subtype.​display_value Anzeigewert für den Untertyp der Reservierung, z. B. Einzeln.

    Datentyp: Zeichenfolge

    result.reservation.reservation_subtype.value Interner Wert für den Untertyp der Reservierung, z. B. Einzeln.

    Datentyp: Zeichenfolge

    result.reservation.sensitivity Details zur Vertraulichkeit der Reservierung.

    Datentyp: Objekt

    "sensitivity": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.sensitivity.display_value Anzeigewert für die Empfindlichkeit der Reservierung, z. B. hoch oder niedrig.

    Datentyp: Zeichenfolge

    result.reservation.sensitivity.value Interner Wert für die Vertraulichkeit der Reservierung, z. B. 1 oder 3.

    Datentyp: Zeichenfolge

    result.reservation.shift Details zur Schicht, die auf die Reservierung angewendet wird.

    Datentyp: Objekt

    "shift": {
      "display_value": "String",
      "name": "String",
      "shiftDetails": "String",
      "sys_id": "String"
    }
    result.reservation.shift.display_value Anzeigewert der Schicht.

    Datentyp: Zeichenfolge

    result.reservation.shift.name Der Name der Schicht Identisch mit display_value.

    Datentyp: Zeichenfolge

    Ergebnis.reservierung.schicht.schichtDetails Details der Schicht.

    Datentyp: Zeichenfolge

    result.reservation.shift.sys_id Sys_id des Schichtdatensatzes. Befindet sich in der Schichttabelle [sn_wsd_core_shift].

    Datentyp: Zeichenfolge

    result.reservation.source Details zur Quelle für die Reservierung, z. B. Arbeitsplatzservices oder Google Mail.

    Datentyp: Objekt

    "source": {
      "display_value": "String",
      "value": "String"
    }
    result.reservation.source.display_value Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices.

    Datentyp: Zeichenfolge

    result.reservation.source.value Interner Wert für die Reservierungsquelle, z. B. servicenow.

    Datentyp: Zeichenfolge

    result.reservation.source_icon Details zur Quelle des in der Reservierung verwendeten Symbols. Dieses Symbol wird in der Benutzeroberfläche verwendet.

    Datentyp: Objekt

    "source_icon": {
      "classNames": "String",
      "imgSrc": "String",
      "tooltip": "String"
    }
    result.reservation.source_icon.classNames Kommagetrennte Klassennamen für das Quellsymbol.

    Datentyp: Zeichenfolge

    result.reservation.source_icon.imgSrc Name der Bildquelle für das Quellsymbol. Dieses Symbol wird in der Tabelle „Bilder“ [db_image] gespeichert.

    Datentyp: Zeichenfolge

    result.reservation.source_icon.tooltip Tooltip, der dem Quellsymbol zugeordnet ist.

    Datentyp: Zeichenfolge

    result.reservation.source_reservation Quellreservierung der aktuellen Reservierung. Beispiel: Für wiederkehrende Reservierungen ist die wiederkehrende übergeordnete Reservierung die Quelle der Reihe von Vorkommensreservierungen.

    Datentyp: Objekt

    "source_reservation": {
      "display_value": "String",
      "name": "String",
      "sys_id": "String"
    }
    result.reservation.source_reservation.​display_value Anzeigewert für die Quellreservierung.

    Datentyp: Zeichenfolge

    result.reservation.source_reservation.name Name der Quellreservierung.

    Datentyp: Zeichenfolge

    result.reservation.source_reservation.sys_id Sys_id des Quellreservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Datentyp: Zeichenfolge

    result.reservation.source_reservation_​requester Der Benutzer, der die wiederkehrende Reservierung angefordert hat.

    Datentyp: Objekt

    "source_reservation": {
      "name": "String",
      "sys_id": "String",
      "user_name": "String"
    }
    result.reservation.source_reservation_​requester.name Name der anfordernden Person für die wiederkehrende Reservierung.

    Datentyp: Zeichenfolge

    result.reservation.source_reservation_requester.sys_id Sys_id des Benutzers, der die wiederkehrende Reservierung angefordert hat. Befindet sich in der Benutzertabelle [sys_user].

    Datentyp: Zeichenfolge

    result.reservation.source_reservation_​requester.user_name Benutzername der anfordernden Person für die wiederkehrende 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.Status Details zum Status der Reservierung.

    Datentyp: Objekt

    "state": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.state.display_value Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“.

    Datentyp: Zeichenfolge

    result.reservation.state.value Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

    result.reservation.subject Betreff der Reservierung.

    Datentyp: Zeichenfolge

    result.reservation.sub_source Details zur Unterquelle der Reservierung. Die Unterquelle gibt an, woher die Reservierung stammt, z. B. Google Kalender oder Microsoft Exchange.

    Datentyp: Objekt

    "sub_source": {
      "display_value": "String,"
      "value": "String"
    }
    result.reservation.sub_source.display_value Anzeigewert für die Unterquelle der Reservierung, z. B. Google Kalender.

    Datentyp: Zeichenfolge

    result.reservation.sub_source.value Interner Wert des Unterquellenfelds der Reservierung, z. B. google_calendar.

    Datentyp: Zeichenfolge

    result.reservation.sync_state Details zum Synchronisierungsstatus einer Reservierung von einem anderen Service, z. B. „sync_enqueued“ oder „synchronized“.

    Datentyp: Objekt

    "sync_state": {
      "display_value": "String,"
      "value": "String"
    }
    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
    Sys_id des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Datentyp: Zeichenfolge

    Ergebnis.reservierung.sys_updated_on Datum und Uhrzeit der letzten Aktualisierung der Reservierung.

    Datentyp: Zeichenfolge

    result.reservation.virtual_meeting URL des Links der virtuellen Besprechung.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie eine bestimmte wiederkehrende Reservierung abgerufen wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/list/d98a381587b789506342b846dabb3563" \
    --request GET \
    --header "Accept:application/json" \
    --user "username": "password"
    

    Ergebnisse zurückgeben:

    {
      "result": {
        "reservations": [
          {
            "sys_id": "198a381587b789506342b846dabb3565",
            "number": "WRES0001247",
            "location": {
              "sys_id": "fe1f744edb7650106c731dcd139619ca",
              "name": "Aspen",
              "description": "A room with large windows, dark leather seats and a large wooden table.",
              "display_value": "Aspen",
              "capacity": 16,
              "label_value": "Room name",
              "email": null,
              "reservable_module": {
                "sys_id": "c31241cedb7650106c731dcd13961917",
                "name": "Meeting rooms",
                "title": "Meeting rooms",
                "inline_title": "meeting room"
              },
              "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": "2f554296dbba10106c731dcd139619ed",
                "display_value": "Floor 2",
                "active": true
              },
              "area": {
                "sys_id": "",
                "display_value": "",
                "active": false
              },
              "reservation": {
                "sys_id": "198a381587b789506342b846dabb3565",
                "number_of_attendees": 1,
                "state": {
                  "value": "confirmed",
                  "display_value": "Confirmed"
                },
                "requested_for": {
                  "sys_id": "2de07e1887cb89106342b846dabb35fe",
                  "name": "Workplace User",
                  "user_name": "workplace_user"
                },
                "number": "WRES0001247",
                "active": true
              },
              "number_of_attendees": 1,
              "state": {
                "value": "confirmed",
                "display_value": "Confirmed"
              },
              "number": "WRES0001247",
              "requested_for": {
                "sys_id": "2de07e1887cb89106342b846dabb35fe",
                "name": "Workplace User",
                "user_name": "workplace_user"
              }
            },
            "start": "2022-06-11T13:00:00Z",
            "end": "2022-06-11T14:00:00Z",
            "sys_created_on": "2022-05-30T07:06:37Z",
            "sys_updated_on": "2022-05-30T07:06:40Z",
            "source_reservation": {
              "sys_id": "d98a381587b789506342b846dabb3563",
              "display_value": "WRES0001246",
              "name": "WRES0001246"
            },
            "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": "occurrence",
              "display_value": "Occurrence"
            },
            "reservation_purpose": {
              "value": "meeting",
              "display_value": "Meeting"
            },
            "attendees": null,
            "number_of_attendees": 1,
            "is_parent": false,
            "subject": "Rec 1",
            "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": "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_recurring": "1",
              "allow_whole_day": "1",
              "require_whole_day": null,
              "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": "1",
              "enable_group_reservations": null,
              "enable_browse_near_a_person": "1",
              "enable_browse_by_area": "1",
              "enable_floor_search": "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": [],
              "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",
                  "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": "2de07e1887cb89106342b846dabb35fe",
              "value": "2de07e1887cb89106342b846dabb35fe",
              "displayValue": "Workplace User",
              "display_value": "Workplace User",
              "name": "Workplace User",
              "user_name": "workplace_user",
              "table": "sys_user",
              "avatar": null,
              "initials": "WU",
              "email": "workplace_user@example.com",
              "label": ""
            },
            "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": null,
              "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_reservation_requester": {
              "sys_id": "2de07e1887cb89106342b846dabb35fe",
              "name": "Workplace User",
              "user_name": "workplace_user"
            },
            "source_icon": {
              "classNames": "fa fa-calendar-check-o",
              "tooltip": "Reservation is confirmed",
              "imgSrc": ""
            },
            "shift": null,
            "recurring_pattern": {
              "duration": "3600000",
              "repeats": "daily",
              "options": {
                "count": 3,
                "daysOfWeek": "",
                "every": 1,
                "endDate": "2022-06-13 14:00:00",
                "endDateGdt": {}
              },
              "label": "Repeats daily, 3 times",
              "startDate": "2022-06-11 13:00:00",
              "startDateGdt": "{}",
              "amountOfDates": "3"
            },
            "reservationAcl": {
              "write": {
                "record": true,
                "fields": {
                  "subject": true,
                  "sensitivity": true,
                  "requested_for": true,
                  "number_of_attendees": true,
                  "location": true
                },
                "allFields": true
              },
              "read": true
            }
          }
        ],
        "occurencesTotalCount": "1"
      }
    }
    

    WSD Wiederkehrende Reservierung – PATCH /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}

    Storniert eine gesamte angegebene Reservierung einer wiederkehrenden Serie oder eine bestimmte Besprechung innerhalb der Serie.

    Hinweis:
    Sie können nicht mehrere Besprechungstermine in einem einzelnen Anruf löschen.

    URL-Format

    Versionierte URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/cancel_series/{sys_id}

    Standard-URL: /api/sn_wsd_rsv/recurring_reservation/cancel_series/{sys_id}

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfadparameter
    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 Um die gesamte Serie zu stornieren, übergeben Sie die sys_id des wiederkehrenden übergeordneten Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Um ein bestimmtes Vorkommen der Serie abzubrechen, übergeben Sie die sys_id des Vorkommens der Serie.

    Für den wiederkehrenden übergeordneten Datensatz ist die Spalte „reservierung_subtype“ auf Wiederkehrendes übergeordnetes Elementfestgelegt. Bei einzelnen Vorkommensdatensätzen wird das Feld „reservierung_untertyp“ auf Vorkommengesetzt.

    Informationen zum Abrufen der Details der wiederkehrenden übergeordneten Reservierung aus dem Vorkommensdatensatz finden Sie in der sys_id des Felds source_reservation des Vorkommensdatensatzes.

    Datentyp: Zeichenfolge
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    cancel_notes Grund für die Stornierung der Reservierung.

    Datentyp: Zeichenfolge

    Tabelle : 9. Anforderungstextparameter
    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.

    Tabelle : 10. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 11. Antwortkopfzeilen
    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.

    Tabelle : 12. Statuscodes
    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 Gibt Ergebnisse für die Anforderung zum Stornieren der wiederkehrenden Reservierung zurück.

    Datentyp: Objekt

    "result": {
      "failedToCancelOccurrenceReservations": [Array],
      "seriesId": "String",
      "success": Boolean,
      "successCanceledOccurrences": [Array],
      "user_msg": "String"
    }
    result.failedToCancelOccurrenceReservations Liste der sys_ids der einzelnen Besprechungsdatensätze, die nicht abgebrochen werden konnten.

    Datentyp: Array von Zeichenfolgen

    result.seriesId Sys_id des wiederkehrenden übergeordneten Elements, wenn die gesamte Serie abgebrochen wird, oder die sys_id eines bestimmten Vorkommens, wenn ein einzelnes Vorkommen abgebrochen wird.

    Datentyp: Zeichenfolge

    Ergebnis.Erfolg Kennzeichnung, die angibt, ob die Reservierung erfolgreich storniert wurde.
    Mögliche Werte:
    • true: Erfolgreich abgebrochen.
    • false: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    result.failedToCancelOccurrenceReservations Liste der sys_ids der einzelnen Besprechungsdatensätze, die erfolgreich abgebrochen wurden.

    Datentyp: Array von Zeichenfolgen

    result.user_msg Nachricht zur Anforderung.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie eine gesamte wiederkehrende Reservierung storniert wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/cancel_series/f64983a347274550003a4587746d43b8" \
    --request PATCH \
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --user "username":"password"

    Ergebnisse zurückgeben:

    {
      "result": {
        "failedToCancelOccurrenceReservations": [],
        "successCanceledOccurrences": [
          "cb4983a347274550003a4587746d43bd",
          "cf4983a347274550003a4587746d43ba"
        ],
        "user_msg": "Your Recurring reservation has been canceled successfully!",
        "seriesId": "f64983a347274550003a4587746d43b8",
        "success": true
      }
    }

    WSD Wiederkehrende Reservierung – POST /api/sn_wsd_rsv/recurring_reservation/create_series

    Erstellt Arbeitsplatzreservierungen für dieselbe Zeit, aber unterschiedliche Daten, z. B. wöchentlich, monatlich oder alle zwei Wochen.

    URL-Format

    Versionierte URL: /api/sn_wsd_rsv/{api_version}/recurring_reservation/create_series

    Standard-URL: /api/sn_wsd_rsv/recurring_reservation/create_series

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfadparameter
    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

    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Keine
    Tabelle : 15. Anforderungstextparameter
    Name Beschreibung
    wiederkehrendes Muster Details zum wiederkehrenden Muster für die Reservierung.

    Datentyp: Objekt

    "recurringPattern": {
      "duration": Number,
      "label": "String",
      "options": {Object},
      "repeats": "String",
      "startDate": "String"
    }
    wiederkehrendesMuster.Dauer Erforderlich, wenn keine schichtbasierte Reservierung.
    Dauer für die Reservierung des reservierbaren Elements.

    Datentyp: Zahl

    Einheit: Sekunden

    wiederkehrendesMuster.Bezeichnung Beschreibender Name für die wiederkehrende Reservierung.

    Datentyp: Zeichenfolge

    wiederkehrendesMuster.Optionen Erforderlich.
    Details zu den für das wiederkehrende Muster festgelegten Optionen.

    Datentyp: Objekt

    
      "options": {
        "count": Number,
        "daysOfWeek": "String",
        "every": Number,
        "endDate": "String"
      }
    recurringPattern.options.count Erforderlich, wenn keine schichtbasierte Reservierung; wird für schichtbasierte Reservierungen ignoriert.

    Anzahl der Wiederholungen des Musters.

    Datentyp: Zahl

    wiederkehrendesMuster.Optionen.Wochentage Erforderlich, wenn der Parameter repeats auf wöchentlichfestgelegt ist.

    Wochentage, an denen das reservierbare Element benötigt wird.

    Gültige Werte:
    • 1 = Montag
    • 2 = Dienstag
    • 3 = Mittwoch
    • 4 = Donnerstag
    • 5 = Freitag
    • 6 = Samstag
    • 7 = Sonntag

    Um beispielsweise Dienstag, Donnerstag und Freitag anzugeben, übergeben Sie 245 (kein Trennzeichen). Wenn repeatsweekly“ ist, count5“ ist und daysOfWeek 245“ ist, dann ist die Summe in den zurückgegebenen Ergebnissen gleich count*daysOfWeek.length (5*3=15).

    Datentyp: Zeichenfolge

    recurringPattern.options.every Musterwiederholungsintervall. Wenn dieser Wert beispielsweise 2ist, wiederholen Sie das Muster alternativ basierend auf der Auswahl im Parameter repeats, z. B. jeden zweiten Tag oder jede zweite Woche.

    Datentyp: Zahl

    wiederkehrendesMuster.Optionen.Enddatum Enddatum und -uhrzeit der Wiederholung der Besprechung, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    wiederkehrendMuster.Optionen.Wiederholen Erforderlich, wenn keine schichtbasierte Reservierung.

    Wiederholtes Muster für das reservierbare Element.

    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • täglich
    • monatlich
    • wöchentlich
    • jährlich

    Datentyp: Zeichenfolge

    wiederkehrendesMuster.startdatum Erforderlich.
    Startdatum und -uhrzeit für das wiederkehrende Muster, z. B. „2022-07-08T14:00:00Z“.

    Datentyp: Zeichenfolge

    Format: UTC jjjj-mm-tt hh:mm:ss

    Reservierung Details zur zu erstellenden wiederkehrenden Reservierung.

    Datentyp: Objekt

    "reservation": {
      "is_private": Boolean,
      "location": "String",
      "reservable_module": "String",
      "shift": "String",
      "subject": "String"
    }
    Reservierung.ist_privat Kennzeichnung, die angibt, ob die Reservierung privat ist. Wenn privat, wird die Reservierung nur dem Besitzer angezeigt.

    Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Standort-Datenschutzeinstellungen und Auswirkungen.

    Gültige Werte:
    • true: Reservierung ist privat.
    • false: Reservierung ist nicht privat.

    Datentyp: Boolesch

    Standard: In den Systemeigenschaften für Datenschutz festgelegter Wert.

    Reservierung.Standort Erforderlich.
    Sys_id des zu reservierenden Standorts. Befindet sich in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location].

    Datentyp: Zeichenfolge

    reservierung.reservable_module Erforderlich. Sys_id des reservierbaren Moduls, das der Reservierung zugeordnet werden soll. Ein reservierbares Modul definiert die für eine Reservierung erforderlichen Arbeitsplatzelemente. Befindet sich in der Tabelle „Reservierbares Modul“ [sn_wsd_rsv_reservable_module].

    Datentyp: Zeichenfolge

    Reservierung.Schicht
    Sys_id der Schicht, die der Reservierung zugeordnet werden soll. Befindet sich in der Schichttabelle [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich.

    Weitere Informationen zu schichtbasierten Reservierungen finden Sie unter Schichtbasierte Reservierungen aktivieren.

    Datentyp: Zeichenfolge

    Reservierung.Betreff Erforderlich.
    Betreff der Besprechung, die der Reservierung zugeordnet ist.

    Datentyp: Zeichenfolge

    Header

    Die folgenden Anforderungs- und Antwortkopfzeilen gelten nur für diese HTTP-Aktion oder für diese Aktion auf eine bestimmte Weise. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter Unterstützte REST-API-Header.

    Tabelle : 16. Anforderungskopfzeilen
    Kopfzeile Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/json oder application/xml.

    Standard: application/json

    Content-Type Datenformat des Anforderungstexts. Unterstützt nur application/json.
    Tabelle : 17. Antwortkopfzeilen
    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.

    Tabelle : 18. Statuscodes
    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 Ergebnisse aus der Erstellung oder Aktualisierung einer Mehrfachreservierung zurückgeben.

    Datentyp: Objekt

    "result": {
      "isValid": Boolean,
      "parent": "String",
      "successfulReservations": Array,
      "unSuccessfulReservations": Array
    }
    result.isValid Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde.
    Mögliche Werte:
    • true: Erfolgreich erstellt.
    • false: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    result.parent Sys_id der übergeordneten Reservierung, die aktualisiert wurde.

    Datentyp: Zeichenfolge

    result.successfulReservations Liste der Reservierungen, die erfolgreich aktualisiert wurden.

    Datentyp: Array von Objekten

    "successfulReservations": [
      {
        "collision": Boolean,
        "end": "String",
        "error": "String",
        "inserted": Boolean,
        "start": "String"
        "sys_id": "String"
      }
    ]
    result.successfulReservations.collision Kennzeichnung, die angibt, ob für die angegebene Zeit bereits eine Reservierung vorhanden ist, und mit der aktuellen Reservierung kollidiert.
    Mögliche Werte:
    • true: Kollision.
    • false: Keine Kollision.

    Datentyp: Boolesch

    result.successfulReservations.end Enddatum und -uhrzeit der Reservierung.

    Datentyp: Zeichenfolge

    Format: UTC: jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z

    result.successfulReservations.error Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist.

    Datentyp: Zeichenfolge

    result.successfulReservations.inserted Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Beispielsweise wenn eine Reservierung hinzugefügt wird.
    Mögliche Werte:
    • true: Erfolgreich eingefügt.
    • false: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    result.successfulReservations.start Startdatum und -uhrzeit der Reservierung.

    Datentyp: Zeichenfolge

    Format: UTC - jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z

    result.successfulReservations.sys_id Sys_id der erstellten Reservierung. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Datentyp: Zeichenfolge

    result.unSuccessfulReservations Liste der Reservierungen, die nicht erfolgreich aktualisiert wurden.

    Datentyp: Array von Objekten

    "unSuccessfulReservations": [
      {
        "collision": Boolean,
        "end": "String",
        "error": "String",
        "inserted": Boolean,
        "start": "String"
        "sys_id": "String"
      }
    ]
    result.unSuccessfulReservations.collision Kennzeichnung, die angibt, ob für die angegebene Zeit bereits eine Reservierung vorhanden ist, und mit der aktuellen Reservierung kollidiert.
    Mögliche Werte:
    • true: Kollision.
    • false: Keine Kollision.

    Datentyp: Boolesch

    result.unSuccessfulReservations.end Enddatum und -uhrzeit der Reservierung.

    Datentyp: Zeichenfolge

    Format: UTC: jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z

    result.unSuccessfulReservations.error Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist.

    Datentyp: Zeichenfolge

    result.unSuccessfulReservations.inserted Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Beispielsweise wenn eine Reservierung hinzugefügt wird.
    Mögliche Werte:
    • true: Erfolgreich eingefügt.
    • false: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    result.unSuccessfulReservations.start Startdatum und -uhrzeit der Reservierung.

    Datentyp: Zeichenfolge

    Format: UTC - jjjj-mm-ttThh:mm:ssZ, z. B. 2021-02-05T18:00:00Z

    result.unSuccessfulReservations.sys_id
    Sys_id des Reservierungsdatensatzes. Befindet sich in der Tabelle „Arbeitsplatzreservierung“ [sn_wsd_rsv_reservation].

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie eine täglich wiederkehrende Reservierung für zwei aufeinanderfolgende Tage erstellt wird.

    curl "https://instance.servicenow.com/api/sn_wsd_rsv/recurring_reservation/create_series" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
        \"reservation\": {
            \"reservable_module\": \"5db44502dbb650106c731dcd13961937\",
            \"subject\": \"Test-123\",
            \"reservation_purpose\": \"meeting\",
            \"timezone\": \"US/Pacific\",
            \"requested_for\": \"6816f79cc0a8016401c5a33be04be441\",
            \"location\": \"6a11a94adb7210106c731dcd1396194e\",
            \"attendees\": \"6816f79cc0a8016401c5a33be04be441\",
            \"is_private\": false
        },
        \"recurringPattern\": {
            \"duration\": 3600000,
            \"repeats\": \"daily\",
            \"options\": {
                \"count\": 2,
                \"daysOfWeek\": \"\",
                \"every\": 1
            },
            \"label\": \"Repeats daily, 2 times\",
            \"startDate\": \"2023-01-12T12:00:00Z\"
        }
    }" \

    Ergebnisse zurückgeben:

    {
      "result": {
        "isValid": true,
        "parent": "1e5f65ca87586550cfaa99b73cbb3513",
        "successfulReservations": [
          {
            "inserted": true,
            "collision": false,
            "sys_id": "9e5f65ca87586550cfaa99b73cbb3517",
            "error": null,
            "start": "2023-01-13T12:00:00Z",
            "end": "2023-01-13T13:00:00Z"
          }
        ],
        "unSuccessfulReservations": [
          {
            "inserted": true,
            "collision": true,
            "sys_id": "5e5f65ca87586550cfaa99b73cbb3515",
            "error": null,
            "start": "2023-01-12T12:00:00Z",
            "end": "2023-01-12T13:00:00Z"
          }
        ]
      }
    }