WSD-API für wiederkehrende Reservierungen

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 36 Minuten Lesedauer
  • Die Workplace Service Delivery (WSD) Recurring Reservation API bietet Endpunkte für die Verwaltung von Reservierungen, die zur gleichen Zeit, aber mit unterschiedlichen Daten erfolgen.

    Um auf diese API zuzugreifen, muss der Anrufer über die Rolle „sn_wsd_core.workplace_user“ verfügen, und die Plugins „Workplace Safety Management“ (sn_wsd_core) und „Workplace Reservation Management“ (sn_wsd_rsv) müssen aktiviert sein.

    Diese API wird im Namespace sn_wsd_rsv ausgeführt.

    Weitere Informationen zu Management von Arbeitsplatz-Reservierungenfinden Sie unter Reservierungsmanagement für Arbeitsplatz.

    Wiederkehrende WSD-Reservierung – GET /api/sn_wsd_rsv/recurring_reservation/list/{parent_id}

    Gibt die angegebene wiederkehrende Reservierung zurück.

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

    URL-Format

    URL mit Versionsnummer: /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 namens „reservierung_subtype“, 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.

    In einem untergeordneten Datensatz befindet sich die sys_id des zugehörigen 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, ab der die Rückgabe von Vorkommensdatensätzen beendet werden soll.
    Hinweis:
    Wenn die Anzahl der wiederkehrenden Vorkommen kleiner als sechs ist, gibt der Endpunkt alle Vorkommen zurück, andernfalls werden die ersten sechs Vorkommen zurückgegeben. Um die Vorkommen nach sechs abzurufen, müssen Sie den Parameter „end_index“ entsprechend übergeben.

    Datentyp: Zahl

    „occurrence_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 die Rückgabe von Vorkommensdatensätzen beginnen 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 Geben Sie Ergebnisse für die angeforderte wiederkehrende Reservierung zurück.

    Datentyp: Objekt

    "result": {
     "occurencesTotalCount": "String",
     "reservation": {Object}
    }
    result.occurencesTotalCount Gesamtanzahl der Besprechungstermine in der wiederkehrenden Serie.

    Datentyp: Zeichenfolge

    result.reservation 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:
    • wahr: Reservierung ist aktiv.
    • „falsch“: 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

    Ergebnis.Reservierung.Teilnehmer.Anzeigewert Anzeigewert für den Teilnehmer.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Anzeigewert Anzeigewert des Teilnehmers. Identisch mit displayValue.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Initialen Initialen des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.attendees.name Name des Teilnehmers.

    Datentyp: Zeichenfolge

    result.reservation.attendees.sys_id Sys_id_des Teilnehmerdatensatzes.

    Datentyp: Zeichenfolge

    „ergebnis.reservierung.teilnehmer.tabelle“ Tabelle, in der der Teilnehmerdatensatz vorhanden ist.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Anwendername Anwendername des Teilnehmers.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Teilnehmer.Wert Interner Wert des Teilnehmers.

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "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 Anwenderbearbeitungseinschränkungen für die Reservierung, z. B. „no_restrictions“, „service_only“ oder „vollständig eingeschränkt“.

    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:
    • wahr: Übergeordnete Reservierung.
    • „falsch“: 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

    Ergebnis.Reservierung.Ort 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",
    }
    Ergebnis.Reservierung.Standort.Bereich Details zum Gebiet, das 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:
    • wahr: Der Bereich ist aktiv.
    • „falsch“: Der 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

    Ergebnis.Reservierung.Standort.Gebäude 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:
    • wahr: Gebäude ist aktiv.
    • „falsch“: 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äude 1.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Ort.Gebäude.Zeitzone Details 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.​Wert Interner Wert für die Zeitzone, zu der dieser Standort gehört.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Campus Details zum Campus, der dem Standort zugeordnet ist.

    Datentyp: Objekt

    "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:
    • wahr: Campus ist aktiv.
    • „falsch“: Campus ist inaktiv.

    Datentyp: Boolesch

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Kapazität Maximale Anzahl von Personen für den Standort.

    Datentyp: Zahl

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Stockwerk Details zum Stockwerk, das dem Standort zugeordnet ist.

    Datentyp: Objekt

    "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:
    • wahr: Stockwerk ist aktiv.
    • „falsch“: Stockwerk ist inaktiv.

    Datentyp: Boolesch

    result.reservation.location.stockwerk.anzeigewert Anzeigewert des Stockwerks, zu dem dieser Standort gehört, z. B. Erster Stock.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.location.name Name des Standorts.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Nummer Reservierungsnummer.

    Datentyp: Zeichenfolge

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

    Datentyp: Zahl

    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 Arbeitsplatz-Serviceportal angezeigt.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.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:
    • „wahr“: 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

    Ergebnis.Reservierung.Standort.Reservierung 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:
    • wahr: Reservierung ist aktiv.
    • „falsch“: Reservierung ist inaktiv.

    Datentyp: Boolesch

    Ergebnis.Reservierung.Standort.Reservierung.Nummer Reservierungsnummer.

    Datentyp: Zeichenfolge

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

    Datentyp: Zahl

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

    Datentyp: Objekt

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

    Datentyp: Zeichenfolge

    result.reservation.location.reservation.​requested_for.sys_id Sys_id des angeforderten Anwenders. Befindet sich in der Tabelle „Benutzer“ [sys_user].

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Reservierung.​Status Details zum Status der Reservierung für den Standort.

    Datentyp: Objekt

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Standort.Reservierung.​.Status.Wert Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "site": {
      "active": Boolean,
      "display_value": "String",
      "sys_id": "String",
    }
    result.reservation.location.site.active Kennzeichnung, die angibt, ob die Website aktiv ist.
    Gültige Werte:
    • „wahr“: Standort ist aktiv.
    • „falsch“: 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 der Site, zu der dieser Standort gehört. Befindet sich in der Tabelle „Site“ [sn_wsd_core_site].

    Datentyp: Zeichenfolge

    result.reservation.location.standard_services
    Ergebnis.Reservierung.Ort.Status 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

    Ergebnis.Reservierung.Standort.Status.Wert Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array von Objekten

    "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 Tabelle „Benutzer“ [sys_user].

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zahl

    result.reservation.opened_by Details zum Anwender, 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 des Anwenders, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.displayValue Anzeigewert des „Geöffnet von“-Anwenders.

    Datentyp: Zeichenfolge

    result.reservation.opened_by.display_value Anzeigewert des „Geöffnet von“-Anwenders.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.opened_by.user_name Anwendername des Anwenders, der die Reservierung geöffnet hat.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    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 mit der wiederkehrenden Reservierung verknüpft 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 repeatswöchentlichist, count gleich 5ist und daysOfWeek gleich 245ist, dann ist in den zurückgegebenen Ergebnissen der Gesamtwert count*daysOfWeek.length (5*3=15).

    Datentyp: Zeichenfolge

    result.reservation.recurring_pattern.options.​each Musterwiederholungsintervall. Der Wert „2“ gibt beispielsweise an, dass das Muster sich je nach Wert der Eigenschaft repeats alle 2 Tage oder 2 Monate wiederholt.
    Hinweis:
    Diese Einstellung gilt nicht für wöchentliche Wiederholungsintervalle. Sie können die Eigenschaft repeats auf täglich und diesen Wert auf 14 für zweiwöchentliche Wiederholungsintervalle festlegen.

    Datentyp: Zahl

    Standardwert: 1

    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

    Sich wiederholendes Muster für das reservierbare Element.

    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • täglich
    • monatlich
    • wöchentlich
    Hinweis:
    Das Musterwiederholungsintervall wird in der Eigenschaft options.every festgelegt. Das einzige gültige Wiederholungsintervall für wöchentliche Muster ist 1.

    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 Anwender, 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 Anwender, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.displayValue Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

    result.reservation.requested_for.display_value Anzeigewert des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Identisch mit displayValue.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.rservation.requested_for.sys_id Sys_id_des Anwenders, in dessen Namen die Reservierung vorgenommen wurde. Befindet sich in der Tabelle „Benutzer“ [sys_user].

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.requested_for.user_name Anwendername des Anwenders, in dessen Namen die Reservierung vorgenommen wurde.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    {
      "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:
    • „wahr“: Mitarbeitern erlauben, eingeladene Personen zur Reservierung hinzuzufügen.
    • „falsch“: Mitarbeiter können der Reservierung keine eingeladenen Personen hinzufügen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​allow_gesamt_tag Kennzeichnung, die angibt, ob Anwender das reservierbare Element für den gesamten Tag reservieren können.
    Gültige Werte:
    • „wahr“: Ermöglicht Anwendern, für den gesamten Tag zu reservieren.
    • „falsch“: Lassen Sie nicht zu, dass Anwender 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:
    • „wahr“: Schichtbasierte Reservierungen zulassen.
    • „falsch“: Keine schichtbasierten Reservierungen zulassen.

    Datentyp: Boolesch

    „result.reservation.reservable_module.​browse_by_area_enabled“ Kennzeichnung, die angibt, ob Anwender nach Bereich nach reservierbaren Modulen suchen können.
    Gültige Werte:
    • „wahr“: Ermöglicht Anwendern das Durchsuchen reservierbarer Module nach Bereich.
    • „falsch“: Anwendern nicht erlauben, reservierbare Module nach Bereich zu durchsuchen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​browse_near_a_person_enabled Kennzeichnung, die angibt, ob Anwender nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden.
    Gültige Werte:
    • „wahr“: Ermöglicht Anwendern das Durchsuchen von reservierbaren Modulen in der Nähe einer Person.
    • „falsch“: Anwendern nicht erlauben, reservierbare Module in der Nähe einer Person zu 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 Zeitspanne vor Beginn einer Reservierung, in der ein Anwender in seine Reservierung einchecken kann.

    Einheit: Minuten

    Datentyp: Zahl

    result.reservation.reservable_module.​display_number_of_attendees Kennzeichnung, die angibt, ob Anwender die Anzahl der Teilnehmer in der Reservierung angeben können.
    Gültige Werte:
    • wahr: Benutzer können die Anzahl der Teilnehmer angeben.
    • „false“: Anwender 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 Namen von unterstützt.
    • „false“: „Im Namen von“ wird nicht unterstützt.

    Datentyp: Boolesch

    result.reservation.reservable_module.​display_sensitivity Kennzeichnung, die angibt, ob Anwender die Vertraulichkeit der Reservierung festlegen können, z. B. normal oder privat.
    Gültige Werte:
    • true: Empfindlichkeit kann festgelegt werden.
    • „falsch“: 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 Anwender nach Bereich nach reservierbaren Modulen suchen können. Identisch mit browse_by_area_enabled.
    Gültige Werte:
    • „wahr“: Ermöglicht Anwendern das Durchsuchen reservierbarer Module nach Bereich.
    • „falsch“: Anwendern nicht erlauben, reservierbare Module nach Bereich zu durchsuchen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​enable_browse_near_a_person Kennzeichnung, die angibt, ob Anwender nach reservierbaren Modulen suchen können, die von einer bestimmten Person gefunden wurden. Identisch mit browse_near_a_person_enabled.
    Gültige Werte:
    • „wahr“: Ermöglicht Anwendern das Durchsuchen von reservierbaren Modulen in der Nähe einer Person.
    • „falsch“: Anwendern nicht erlauben, reservierbare Module in der Nähe einer Person zu 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.
    • „falsch“: Aspektfilter sind nicht aktiviert.

    Datentyp: Boolesch

    result.reservation.reservable_module.​enable_group_reservations Kennzeichnung, die angibt, ob Anwender eine Gruppenreservierung vornehmen können.
    Gültige Werte:
    • „wahr“: Gruppenreservierungen möglich.
    • „falsch“: Gruppenreservierungen können nicht vorgenommen werden.

    Datentyp: Boolesch

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

    Datentyp: Boolesch

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    „result.reservation.reservable_module.​layout_mapping“ Details zur Struktur der Layoutzuordnung von Standorten. Verwenden Sie diese Daten, um die Informationen in der Anwenderoberfläche anzuordnen.

    Datentyp: Objekt

    "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_future Maximale Anzahl der Tage in der Zukunft, die ein Anwender das reservierbare Modul reservieren kann.

    Datentyp: Zahl

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

    Datentyp: Zahl

    result.reservation.reservable_module.name Name des reservierbaren Moduls

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​override_approval_policy Option zum Festlegen, wie die Genehmigungsrichtlinie zu implementieren ist. Die Auswahlmöglichkeiten lauten wie folgt:
    • Keine Überschreibung: Die Genehmigungsrichtlinie wird so implementiert, wie sie im Feld Genehmigung erforderlich eines Arbeitsplatzbereichs oder -raums festgelegt ist.
    • Genehmigung immer erforderlich: Die Genehmigungsrichtlinie ist erforderlich, unabhängig davon, was im Feld Erfordert Genehmigung eines Arbeitsplatzbereichs oder -raums festgelegt ist.
    • Genehmigung nie erforderlich: Die Genehmigungsrichtlinie wird unabhängig davon entfernt, was im Feld Erfordert Genehmigungl eines Arbeitsplatzbereichs oder -raums festgelegt ist.

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​require_cancel_notes Kennzeichnung, die angibt, ob Anwender eine Stornierungsnotiz eingeben müssen, bevor sie ein reservierbares Modul stornieren können.
    Gültige Werte:
    • wahr: Stornierungshinweis erforderlich.
    • „falsch“: Hinweis zum Abbruch nicht erforderlich.

    Datentyp: Boolesch

    result.reservation.reservable_module.​require_cc_dept_check Kennzeichnung, die angibt, ob überprüft werden soll, ob eine Kostenstelle oder Abteilung zwischen dem Arbeitsbereichselement und dem angemeldeten Anwender nicht übereinstimmt.
    Gültige Werte:
    • true: Auf Nichtübereinstimmung prüfen.
    • „falsch“: Nicht auf Nichtübereinstimmung prüfen.

    Datentyp: Boolesch

    result.reservation.reservable_module.​require_subject Kennzeichnung, die angibt, ob der Anwender 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. Zu finden in der Tabelle „Arbeitsplatzstandort“ [sn_wsd_core_workplace_location].

    Datentyp: Array

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_quantity_field Die reservierbare Menge aller Arbeitsbereiche. Die Menge wird verwendet, wenn Arbeitsbereichsbereiche einem Bereich zugewiesen werden. Weitere Informationen finden Sie unter Flächen in der Umgebung einem Bereich zuweisen.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

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

    Datentyp: Objekt

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

    Datentyp: Zeichenfolge

    result.reservation.reservable_module.​reservable_views.isDefault Kennzeichnung, die angibt, ob diese reservierbare Ansicht als Standard für reservierbare Module festgelegt werden soll.
    Gültige Werte:
    • „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 Anwenderoberfläche angezeigt werden. Die niedrigeren Ordnungszahlen stehen in der Anwenderoberfläche an erster Stelle. Bei gleicher Reihenfolgennummer wird eine zufällige Reihenfolge zugewiesen.

    Datentyp: Zahl

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

    Datentyp: Zeichenfolge

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

    Datentyp: Array von Objekten

    "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 von Suchergebnissen, die zurückgegeben werden sollen, wenn ein Anwender nach einem Arbeitsplatzstandort sucht.

    Datentyp: Zahl

    result.reservation.reservable_module.​selection_type

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

    Kann eine der folgenden Optionen sein:
    • 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:
    • „wahr“: Kartenansicht aktivieren.
    • „falsch“: 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 Tabelle „Zeitfenster“ [sn_wsd_rsv_time_slot].

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "virtual_meeting_provider": {
      "display_value": "String",
      "sys_id": "String"
    }
    result.reservation.reservable_module.​virtual_meeting_provider.display_value Anzeigewert des Anbieters virtueller Besprechungen.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.reservationAcl Details der Zugriffssteuerungsebenenprüfungen (ACL), die für die zugeordnete Reservierung festgelegt sind.

    Datentyp: Objekt

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

    Datentyp: Boolesch

    result.reservation.reservationAcl.write Details zu den Schreibfähigkeiten des Anwenders für die zugeordnete 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 Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann. Wenn der Benutzer nur Zugriff auf bestimmte Felder hat, sind nur diese Felder im Objekt reservationACL.write.fields zutreffend.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender in alle im Objekt reservationACL.write.fields angegebenen Felder schreiben kann

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields Details der Zugriffssteuerungen für verschiedene Felder 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 Anwender in die Standortfelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in die Standortfelder schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender 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 Anwender in die Felder für die Teilnehmerzahl in dieser Reservierung schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in das Feld „Anzahl der Teilnehmer“ schreiben kann.
    • „falsch“: Es wird nicht überprüft, 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 Anwender in die Felder „Angefordert für“ in dieser Reservierung schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in das „Angefordert für“-Feld schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender in das „Angefordert für“-Feld schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.​sensitivity Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in die Vertraulichkeitsfelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in das Empfindlichkeitsfeld schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender in das Vertraulichkeitsfeld schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.fields.​subject Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in die Betrefffelder in dieser Reservierung schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in das Betrefffeld schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender in die Betrefffelder schreiben kann.

    Datentyp: Boolesch

    result.reservation.reservationAcl.write.record Kennzeichnung, die angibt, ob überprüft werden soll, ob der Anwender in den gesamten Reservierungsdatensatz schreiben kann.
    Gültige Werte:
    • „wahr“: Überprüfen Sie, ob der Anwender in den gesamten Reservierungsdatensatz schreiben kann.
    • „falsch“: Es wird nicht überprüft, ob der Anwender 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. einfach, 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

    Ergebnis.Reservierung.Empfindlichkeit Details zur Vertraulichkeit der Reservierung.

    Datentyp: Objekt

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

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Empfindlichkeit.Wert Interner Wert für die Empfindlichkeit der Reservierung, z. B. 1 oder 3.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Schicht Details zur Schicht, die auf die Reservierung angewendet wird.

    Datentyp: Objekt

    "shift": {
      "display_value": "String",
      "name": "String",
      "shiftDetails": "String",
      "sys_id": "String"
    }
    Ergebnis.Reservierung.Schicht.Anzeigewert Anzeigewert der Schicht.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    Ergebnis.reservierung.schicht.schichtDetails Details zur Schicht.

    Datentyp: Zeichenfolge

    result.reservation.shift.sys_id Sys_id des Schichtdatensatzes. Befindet sich in der Tabelle „Schicht“ [sn_wsd_core_shift].

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Quelle Details zur Quelle für die Reservierung, z. B. Workplace Services oder Google Mail.

    Datentyp: Objekt

    "source": {
      "display_value": "String",
      "value": "String"
    }
    Ergebnis.Reservierung.Quelle.Anzeigewert Anzeigewert für die Reservierungsquelle, z. B. Arbeitsplatzservices.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Quelle.Wert Interner Wert für die Reservierungsquelle, z. B. ServiceNow.

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "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 Quellsymbol. Dieses Symbol wird in der Tabelle „Images“ [db_image] gespeichert.

    Datentyp: Zeichenfolge

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

    Datentyp: Zeichenfolge

    result.reservation.source_reservation Quellreservierung der aktuellen Reservierung. Beispiel: Bei wiederkehrenden 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_​anfordernde Person Der Anwender, der die wiederkehrende Reservierung angefordert hat.

    Datentyp: Objekt

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

    Datentyp: Zeichenfolge

    result.reservation.source_reservation_​requester.sys_id Sys_id des Anwenders, der die wiederkehrende Reservierung angefordert hat. Befindet sich in der Tabelle „Benutzer“ [sys_user].

    Datentyp: Zeichenfolge

    result.reservation.source_reservation_​requester.user_name Anwendername 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"
    }
    Ergebnis.Reservierung.Status.Anzeigewert Anzeigewert für den aktuellen Status der Reservierung, z. B. „Bestätigt“.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Status.Wert Interner Wert für den aktuellen Status der Reservierung, z. B. 2.

    Datentyp: Zeichenfolge

    Ergebnis.Reservierung.Betreff Betreff der Reservierung.

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "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 Unterquellfelds der Reservierung, z. B. „google_calendar“.

    Datentyp: Zeichenfolge

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

    Datentyp: Objekt

    "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

    Result.reservation.sys_updated_on Datum und Uhrzeit der letzten Aktualisierung der Reservierung.

    Datentyp: Zeichenfolge

    result.reservation.virtual_meeting URL des Links für die virtuelle Besprechung.

    Datentyp: Zeichenfolge

    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"
      }
    }
    

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

    Storniert eine gesamte angegebene wiederkehrende Serienreservierung oder einen bestimmten Besprechungstermin innerhalb der Serie.

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

    URL-Format

    URL mit Versionsnummer: /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 abzubrechen, ü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.

    Im wiederkehrenden übergeordneten Datensatz ist die Spalte „reservierung_untertyp“ auf Wiederkehrendes übergeordnetes Elementfestgelegt. Bei einzelnen Vorkommensdatensätzen ist das Feld „reservierung_untertyp“ auf Vorkommenfestgelegt.

    Informationen zu einer 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 Geben Sie Ergebnisse für die Anforderung zum Abbrechen 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 Datensätze für Besprechungsserienelemente, 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.
    • „falsch“: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    result.failedToCancelOccurrenceReservations Liste der sys_ids der einzelnen Datensätze für Besprechungsserienelemente, die erfolgreich abgebrochen wurden.

    Datentyp: Array von Zeichenfolgen

    result.user_msg Nachricht zur Anforderung.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie Sie eine gesamte wiederkehrende Reservierung stornieren.

    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
      }
    }

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

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

    URL-Format

    URL mit Versionsnummer: /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
    recurringPattern Details zum wiederkehrenden Muster für die Reservierung.

    Datentyp: Objekt

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

    Datentyp: Zahl

    Einheit: Sekunden

    recurringPattern.label Beschreibender Name für die wiederkehrende Reservierung.

    Datentyp: Zeichenfolge

    recurringPattern.options 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

    recurringPattern.options.daysOfWeek 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 repeatswöchentlichist, count gleich 5ist und daysOfWeek gleich 245ist, dann ist in den zurückgegebenen Ergebnissen der Gesamtwert count*daysOfWeek.length (5*3=15).

    Datentyp: Zeichenfolge

    recurringPattern.options.each Musterwiederholungsintervall. Der Wert „2“ gibt beispielsweise an, dass das Muster sich je nach Wert der Eigenschaft repeats alle 2 Tage oder 2 Monate wiederholt.
    Hinweis:
    Diese Einstellung gilt nicht für wöchentliche Wiederholungsintervalle. Sie können die Eigenschaft repeats auf täglich und diesen Wert auf 14 für zweiwöchentliche Wiederholungsintervalle festlegen.

    Datentyp: Zahl

    Standardwert: 1

    recurringPattern.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

    recurringPattern.repeats Erforderlich, wenn keine schichtbasierte Reservierung.

    Sich wiederholendes Muster für das reservierbare Element.

    Gültige Werte: (Groß-/Kleinschreibung beachten)
    • täglich
    • monatlich
    • wöchentlich
    Hinweis:
    Das Musterwiederholungsintervall wird in der Eigenschaft options.every festgelegt. Das einzige gültige Wiederholungsintervall für wöchentliche Muster ist 1.

    Datentyp: Zeichenfolge

    recurringPattern.startDate 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.is_private“ Kennzeichnung, die angibt, ob die Reservierung privat ist. Bei einer privaten Reservierung ist die Reservierung nur für den Besitzer sichtbar.

    Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Datenschutzeinstellungen für den Standort und ihre Auswirkungen.

    Gültige Werte:
    • „wahr“: Reservierung ist privat.
    • false: Reservierung ist nicht privat.

    Datentyp: Boolesch

    Standard: Wert, der für Datenschutz in den Systemeigenschaften festgelegt ist.

    Reservierung.Standort Erforderlich.
    Sys_id des zu reservierenden Standorts. Zu finden 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 Arbeitsplatzelemente, die für eine Reservierung erforderlich sind. 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 Tabelle „Schicht“ [sn_wsd_core_shift]. Wenn dieser Parameter übergeben wird, ist der Parameter end nicht erforderlich.

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

    Datentyp: Zeichenfolge

    „reservierung.betreff“ Erforderlich.
    Betreff des Meetings, das der Reservierung zugeordnet ist.

    Datentyp: Zeichenfolge

    Header

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

    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 Geben Sie Ergebnisse aus der Mehrfachreservierungserstellung oder -aktualisierung zurück.

    Datentyp: Objekt

    "result": {
      "isValid": Boolean,
      "parent": "String",
      "successfulReservations": Array,
      "unSuccessfulReservations": Array
    }
    Ergebnis.istGültig Kennzeichnung, die angibt, ob die Reservierung erfolgreich erstellt wurde.
    Mögliche Werte:
    • true: erfolgreich erstellt.
    • „falsch“: 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"
      }
    ]
    Ergebnis.ErfolgreicheReservierungen.Kollision Kennzeichnung, die angibt, ob für die angegebene Zeit bereits eine Reservierung vorhanden ist und mit der aktuellen Reservierung kollidiert.
    Mögliche Werte:
    • wahr: 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

    Ergebnis.ErfolgreicheReservierungen.Fehler Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist.

    Datentyp: Zeichenfolge

    Ergebnis.ErfolgreicheReservierungen.Eingefügt Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Zum Beispiel, wenn eine Reservierung hinzugefügt wird.
    Mögliche Werte:
    • true: Erfolgreich eingefügt.
    • „falsch“: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    Ergebnis.ErfolgreicheReservierungen.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"
      }
    ]
    Ergebnis.unErfolgreicheReservierungen.Kollision Kennzeichnung, die angibt, ob für die angegebene Zeit bereits eine Reservierung vorhanden ist und mit der aktuellen Reservierung kollidiert.
    Mögliche Werte:
    • wahr: 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

    Ergebnis.unErfolgreicheReservierungen.Fehler Fehlermeldung, wenn beim Erstellen der Reservierung ein Problem aufgetreten ist.

    Datentyp: Zeichenfolge

    Ergebnis.nichtErfolgreicheReservierungen.eingefügt Kennzeichnung, die angibt, ob die Reservierung erfolgreich eingefügt wurde. Zum Beispiel, wenn eine Reservierung hinzugefügt wird.
    Mögliche Werte:
    • true: Erfolgreich eingefügt.
    • „falsch“: Vorgang fehlgeschlagen.

    Datentyp: Boolesch

    Ergebnis.unErfolgreicheReservierungen.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 Sie für zwei aufeinanderfolgende Tage eine täglich wiederkehrende Reservierung erstellen.

    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"
          }
        ]
      }
    }