WSD-API „Reservierbar“.

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 13 Minuten Lesedauer
  • Die Workplace Service Delivery (WSD) Reservable API bietet Endpunkte zum Abrufen von Details eines reservierbaren Elements, einer Entität, die reserviert werden kann, z. B. ein Arbeitsplatzstandort, aus einer ServiceNow -Instanz.

    Hinweis:
    Eine neuere Version dieser API, WSD Reservierbare V2-API, ist zur Verwendung verfügbar. Mit der neuen Version können Sie alle reservierbaren Elemente in eine POST-Anforderung aufnehmen, um Zeichenbeschränkungen des Parameters sys_Id zu vermeiden.

    Für den Zugriff auf diese API muss der Aufrufer über die Rolle sn_wsd_core.workplace_user verfügen.

    Diese API wird im Namespace sn_wsd_rsv ausgeführt. Für den Zugriff auf diese API muss das Plugin „Management von Arbeitsplatz-Reservierungen“ (sn_wsd_rsv) aktiviert sein.

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

    WSD Reservierbares Element – GET /sn_wsd_rsv/reservable/list_reservables/{sys_ids}

    Gibt die Details für ein oder mehrere angegebene reservierbare Elemente zurück.

    URL-Format

    URL mit Versionsnummer: /api/sn_wsd_rsv/{api_version}/reservable/list_reservables/{sys_ids}

    Standard-URL: /api/sn_wsd_rsv/reservable/list_reservables/{sys_ids}

    Hinweis:
    Verfügbare Versionen werden im REST-API-Explorerangegeben. Für geskriptete REST APIs finden Sie zusätzliche Versionsinformationen im Formular „Geskripteter REST-Service“.

    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

    sys_ids Sys_ids der reservierbaren Elemente, deren Details zurückgegeben werden sollen.

    Wenn Sie mehrere reservierbare Elemente angeben, trennen Sie die sys_ids durch Kommas.

    Datentyp: Zeichenfolge

    Tabelle: Arbeitsplatzstandort [sn_wsd_core_workplace_location]

    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    „include_flexible_services“ Kennzeichnung, die angibt, ob die flexiblen Services, die dem reservierbaren Element in zugeordnet sind, an die Antwort zurückgegeben werden sollen.

    Ein flexibler Service ist eine zusätzliche Bereitstellung, die mit einem reservierbaren Arbeitsplatzelement verfügbar ist, wenn eine Reservierung vorgenommen wird. Beispiel: Klassenraumstil – Reihen von Tischen, die so angeordnet sind, dass alle Teilnehmer zur Vorderseite des Raums blicken. Weitere Informationen zu flexiblen Services finden Sie unter Flexiblen Service erstellen.

    Gültige Werte:
    • „wahr“: Gibt die Informationen zum flexiblen Service zurück.
    • „falsch“: Die Informationen zum flexiblen Service werden nicht zurückgegeben.

    Datentyp: Boolesch

    Standardwert: false

    „include_layouts“ Kennzeichnung, die angibt, ob die Standortlayoutinformationen in der Antwort zurückgegeben werden sollen.

    Zu den Standortlayoutinformationen gehören Informationen wie Kapazität, maximale Kapazität, Vorbereitung und Bereinigungsdauer. Diese Informationen befinden sich in der Tabelle „Standortlayout“ [sn_wsd_rsv_m2m_location_layout].

    Gültige Werte:
    • „wahr“: Gibt die Informationen zum Standortlayout zurück.
    • „falsch“: Die Standortlayoutinformationen werden nicht zurückgegeben.

    Datentyp: Boolesch

    Standardwert: false

    „include_standard_​services“. Kennzeichnung, die angibt, ob die Standardserviceinformationen in der Antwort zurückgegeben werden sollen. Diese Informationen befinden sich in der Tabelle „Standardservice“ [sn_wsd_rsv_standard_service].

    Ein Standardservice beschreibt grundlegende Bestimmungen, die mit einem reservierbaren Arbeitsplatzelement verfügbar sind, wenn die Reservierung vorgenommen wird, z. B. Whiteboards, zusätzliche Monitore und ähnliche Services. Weitere Informationen zu Standardservices finden Sie unter Standardservices.

    Gültige Werte:
    • „wahr“: Gibt die Informationen zu Standardservices zurück.
    • „falsch“: Die Standardserviceinformationen werden nicht zurückgegeben.

    Datentyp: Boolesch

    Standardwert: false

    reservable_module_sys_id Erforderlich. Sys_id des reservierbaren Moduls.

    Ein reservierbares Modul gruppiert ähnliche Arten von Arbeitsplatzelementen.

    Weitere Informationen zu reservierbaren Modulen finden Sie unter Reservierbare Module konfigurieren.

    Datentyp: Zeichenfolge

    Tabelle: Reservierbares Modul [sn_wsd_rsv_reservable_module]

    „reservierung_start_zeit“ Reservierungsstartzeit, um die Vorlaufzeit zusätzlicher Services zu validieren.

    Format: UTC-Format, jjjj-MM-tt HH:mm:ss

    Datentyp: Zeichenfolge

    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 Antworttexts. Unterstützte Typen: application/json oder application/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-Antwortcodes der REST-API.

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Fehlerhafte Anforderung. Ein fehlerhafter Anforderungstyp oder eine falsch formatierte Anforderung wurde erkannt.
    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 Details zu jedem übereinstimmenden reservierbaren Element.

    Datentyp: Array von Objekten

    {
      "result": [
        {
          "allow_invitees": Boolean,
          "area": {Object},
          "building": {Object},
          "campus": {Object},
          "capacity": Number,
          "description": "String",
          "display_number_of_attendees": Boolean,
          "display_on_behalf_of": Boolean,
          "display_sensitivity": Boolean,
          "email": "String",
          "employee_override_privacy": Boolean
          "enable_group_reservations": Boolean,
          "enable_reservation_privacy": Boolean,
          "external_id": "String",
          "flexible_services": [Array],
          "floor": {Object},
          "image": {Object},
          "is_reservable": Boolean,
          "layouts": [Array],
          "location_type": {Object},
          "meetingProviders": [Array],
          "moduleType": "String",
          "name": "String",
          "number": "String",
          "order": Number,
          "require_approval": Boolean,
          "requires_check_in": Boolean,
          "require_subject": Boolean,
          "reservable_quantity": Number,
          "site": {Object},
          "standard_services": [Array],
          "sys_id": "String",
          "title": "String",
          "type": "String",
          "tableName": "String"
        }
      ]
    }
    result.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.area Bereich, in dem sich das reservierbare Element befindet.

    Datentyp: Objekt

    "area": {
       "display_value": "String",
       "sys_id": "String"
    }

    Tabelle: Bereich [sn_wsd_core_area]

    Ergebnis.Bereich.Anzeigewert Anzeigewert für den Bereich.

    Datentyp: Zeichenfolge

    result.area.sys_id Sys_id des zugeordneten Bereichsdatensatzes.

    Datentyp: Zeichenfolge

    result.building Gebäude, in dem sich das reservierbare Element befindet.

    Datentyp: Objekt

    "building": {
      "display_value": "String",
      "sys_id": "String",
      "timezone": {Object}
    }

    Tabelle: Gebäude [sn_wsd_core_building]

    Ergebnis.Gebäude.Anzeigewert Anzeigewert für das Gebäude.

    Datentyp: Zeichenfolge

    result.building.sys_id Sys_id des zugeordneten Gebäudedatensatzes.

    Datentyp: Zeichenfolge

    Ergebnis.Gebäude.Zeitzone Details der Zeitzone für das Gebäude.

    Datentyp: Objekt

    "timezone": {
      "displayValue": "String",
      "value": "String"
    }
    Ergebnis.Gebäude.Zeitzone.Anzeigewert Anzeigewert der Zeitzone, in der sich das zugeordnete Gebäude befindet.

    Datentyp: Zeichenfolge

    Ergebnis.Gebäude.Zeitzone.Wert Interner Wert der Zeitzone, in der sich das zugeordnete Gebäude befindet.

    Datentyp: Zeichenfolge

    result.campus Campus, in dem sich das reservierbare Element befindet.

    Datentyp: Objekt

    "campus": {
      "display_value": "String",
      "sys_id": "String"
    }

    Tabelle: Campus [sn_wsd_core_campus]

    result.campus.display_value Anzeigewert für den Campus.

    Datentyp: Zeichenfolge

    result.campus.sys_id Sys_id des zugeordneten Campus-Datensatzes.

    Datentyp: Zeichenfolge

    Ergebnis.Kapazität Anzahl der Personen, die das reservierbare Element aufnehmen kann.

    Datentyp: Zahl

    result.description

    Beschreibung des reservierbaren Elements.

    Datentyp: Zeichenfolge

    result.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.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.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.email E-Mail-Adresse, die dem reservierbaren Element zugeordnet ist.

    Datentyp: Zeichenfolge

    result.employee_override_privacy Kennzeichnung, die angibt, ob Anwender die Datenschutzeinstellung für das zugeordnete reservierbare Element überschreiben können.

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

    Gültige Werte:
    • wahr: Anwender können die Datenschutzeinstellung für das zugeordnete reservierbare Element überschreiben.
    • „falsch“: Anwender können die Datenschutzeinstellung für das zugeordnete reservierbare Element nicht überschreiben.
    result.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.enable_reservation_privacy

    Kennzeichnung, die die Standardeinstellung für den Reservierungsdatenschutz angibt.

    Weitere Informationen zu diesen Datenschutzeinstellungen finden Sie unter Location privacy settings and impact.

    Mögliche Werte:
    • „wahr“: Reservierungen sind standardmäßig privat.
    • „falsch“: Reservierungen sind standardmäßig nicht privat.

    Datentyp: Boolesch

    result.external_id Externe ID des reservierbaren Elements.

    Datentyp: Zeichenfolge

    result.flexible_services Wird nur ausgefüllt, wenn der Parameter include_flexible_services auf „true“ festgelegt und das Plugin „Workplace Case Management“ installiert ist. Beschreibung der flexiblen Services, die den reservierbaren Elementen zugeordnet sind. Es kann einen übergeordneten flexiblen Service und mehrere untergeordnete flexible Services geben.

    Datentyp: Objekt

    flexible_services": [
      {
        "additional_text": "String",
        "allow_only_single_service_item_selection": Boolean,
        "category": "String",
        "currency_code": "String",
        "flexible_service": [Array],
        "label": "String",
        "sub_category": "String",
        "sub_title": "String",
        "text": "String",
        "title": {Object}
      }
    ]

    Tabelle: Arbeitsplatzservice-Element [sn_wsd_case_workplace_service_item]

    result.flexible_services.additional_text Text, um den Anwender zur Auswahl zusätzlicher flexibler Services aufzufordern.

    Datentyp: Zeichenfolge

    result.flexible_services.allow_only_single_service_item_selection Kennzeichnung, die angibt, ob Anwender nur ein Service-Element aus der Gruppe der flexiblen Services innerhalb einer Reservierung auswählen können.
    Gültige Werte:
    • true: Es kann nur eine Einzelauswahl getroffen werden.
    • false: Mehrfachauswahl möglich.

    Datentyp: Boolesch

    result.flexible_services.category Kategorie der flexiblen Services.

    Datentyp: Zeichenfolge

    result.flexible_services.currency_code Währungscode, der zum Berechnen des Währungsbetrags beim Bestellen flexibler Services verwendet wird.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service Flexible Services, die einem übergeordneten flexiblen Service entsprechen.

    Datentyp: Array von Objekten

    "flexible_service": [
      {
        "flexible_service": [Array],
        "label": "String",
        "sub_category": "String"
     }
    ]

    Tabelle: Arbeitsplatzservice-Element [sn_wsd_case_workplace_service_item]

    result.flexible_services.flexible_service.​flexible_service Details zu jedem flexiblen Service, der einem übergeordneten flexiblen Service entspricht.

    Datentyp: Array von Objekten

    "flexible_service": [
      {
        "additional_text": "String",
        "capacity_enabled": Boolean,
        "category": "String",
        "category_label": "String",
        "cleanup_duration": "String",
        "image": "String",
        "max_capacity": Number,
        "name": "String",
        "preparation_duration": "String",
        "price_per_unit": {Object},
        "quantity_enabled": Boolean,
        "quantity_required": Boolean,
        "short_description": "String",
        "sub_category": "String",
        "sub_category_label": "String",
        "sub_title": "String",
        "sys_id": "String",
        "text": "String",
        "title": {Object}
      }
    ]
    result.flexible_services.flexible_service.​flexible_service.additional_text Text, mit dem ein Anwender aufgefordert wird, zusätzliche flexible Services auszuwählen.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.capacity_enabled Kennzeichnung, die angibt, ob die Kapazität des Raums in der Reservierung angezeigt werden soll. Wenn diese Option auf „wahr“ festgelegt ist, ist quantity_enabled immer „falsch“.
    Gültige Werte:
    • „wahr“: „Kapazität“ sollte angezeigt werden.
    • „falsch“: Kapazität darf nicht angezeigt werden.

    Datentyp: Boolesch

    result.flexible_services.flexible_service.​flexible_service.category Die Kategorie des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.category_label Kategoriebezeichnung des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.cleanup_duration Zeit, die zum Bereinigen oder Entfernen des dem reservierbaren Element hinzugefügten Service benötigt wird.

    Datentyp: Zahl

    Einheit: Millisekunden

    result.flexible_services.flexible_service.​flexible_service.image Link zum Bild des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.max_capacity Maximale Anzahl von Personen, die das reservierbare Element aufnehmen kann.

    Datentyp: Zahl

    result.flexible_services.flexible_service.​flexible_service.name Name des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.preparation_duration Zeit, die benötigt wird, um den Service dem reservierbaren Element hinzuzufügen.

    Datentyp: Zeichenfolge

    Einheit: Millisekunden

    result.flexible_services.flexible_service.​flexible_service.Preis_pro_Einheit Details zu den Kosten für das Hinzufügen des flexiblen Service zum reservierbaren Element.

    Datentyp: Objekt

    "price_per_unit": {
      "code": "String",
      "value": "String"
    }
    result.flexible_services.flexible_service.​flexible_service. Price_per_unit.code Bei der Berechnung der Kosten zu verwendender Währungscode, z. B. GBP oder USD.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.Price_per_unit.value Kosten für jede Einheit des flexiblen Service in der im Codeparameter definierten Währung.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.quantity_enabled Kennzeichnung, die angibt, ob das Mengenfeld in der Reservierung angezeigt werden soll. Wenn diese Option auf „wahr“ festgelegt ist, ist capacity_enabled immer „falsch“.
    Gültige Werte:
    • „wahr“: „Menge“ sollte angezeigt werden.
    • „falsch“: Menge darf nicht angezeigt werden.

    Datentyp: Boolesch

    result.flexible_services.flexible_service.​flexible_service.quantity_required Kennzeichnung, die angibt, ob die Menge erforderlich ist.
    Gültige Werte:
    • wahr: Menge ist erforderlich.
    • „false“: Menge ist nicht erforderlich.

    Datentyp: Boolesch

    result.flexible_services.flexible_service.​flexible_service.short_description

    Kurze Beschreibung des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.sub_category Name der Unterkategorie des flexiblen Services, z. B. „%C3%A4%B6%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%_%%%%%%%%%%%%%%%%%%%%%%%%%%%%%].

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.sub_category_label Bezeichnung der Unterkategorie des flexiblen Service, z. B. Anordnung der Stühle.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.sub_title Untertitelname des untergeordneten flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.sys_id Sys_id des flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.text Text, mit dem ein Anwender aufgefordert wird, flexible Services auszuwählen.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.title Details für die Titel, die beim Hinzufügen und Bearbeiten des untergeordneten flexiblen Service in der Anwenderoberfläche verwendet werden sollen.

    Datentyp: Objekt

    "title": {
      "add": "String",
      "edit": "String"
    }
    result.flexible_services.flexible_service.​flexible_service.title.add Titel, der beim Hinzufügen eines untergeordneten flexiblen Service in der Anwenderoberfläche verwendet wird.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​flexible_service.title.edit Titel, der beim Bearbeiten eines untergeordneten flexiblen Service in der Anwenderoberfläche verwendet wird.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.label Flexible Servicebezeichnung.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​sub_category Unterkategorie der übergeordneten flexiblen Services, z. B. zusätzlicher Stuhl.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.​sub_title Name des Untertitels des übergeordneten flexiblen Service.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.text Text, der verwendet wird, um einen Anwender aufzufordern, einen übergeordneten flexiblen Service auszuwählen.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.title Details für die Titel, die beim Hinzufügen und Bearbeiten des übergeordneten flexiblen Service in der Anwenderoberfläche verwendet werden sollen.

    Datentyp: Objekt

    "title": {
      "add": "String",
      "edit": "String"
    }
    result.flexible_services.flexible_service.title.​hinzufügen Titel, der beim Hinzufügen eines übergeordneten flexiblen Service in der Anwenderoberfläche verwendet wird.

    Datentyp: Zeichenfolge

    result.flexible_services.flexible_service.title.​bearbeiten Titel, der beim Bearbeiten eines übergeordneten flexiblen Service in der Anwenderoberfläche verwendet wird.

    Datentyp: Zeichenfolge

    Ergebnis.Stockwerk Details zum Stockwerk, auf dem sich das reservierbare Element befindet.

    Datentyp: Objekt

    "floor": {
      "display_value": "String",
      "sys_id": "String"
    }

    Tabelle: Stockwerk [sn_wsd_core_stockwerk]

    Ergebnis.Stockwerk.Anzeigewert Anzeigenummer des Stockwerks, in dem sich das reservierbare Element befindet, z. B. 12.

    Datentyp: Zeichenfolge

    Ergebnis.Stockwerk.sys_id Sys_id des zugeordneten Datensatzes in der Stockwerkstabelle.

    Datentyp: Zeichenfolge

    result.image Details zu einem Bild, das das zugeordnete reservierbare Element darstellt.

    Datentyp: Objekt

    "image": {
      "link": "String",
      "sys_id": "String"
    }

    Tabelle: Bilder [db_image]

    result.image.link Link zu einem Bild, das das reservierbare Element darstellt.

    Datentyp: Zeichenfolge

    result.image.sys_id Sys_id des zugeordneten Image-Datensatzes.

    Datentyp: Zeichenfolge

    result.is_reservable Kennzeichnung, die angibt, ob der flexible Service reserviert werden kann.
    Gültige Werte:
    • wahr: Flexibler Service kann reserviert werden.
    • „falsch“: Flexibler Service kann nicht reserviert werden.

    Datentyp: Boolesch

    ergebnisse.layouts Wird nur ausgefüllt, wenn der Parameter include_layouts auf „wahr“ festgelegt ist.

    Liste der Layouts, die dem reservierbaren Element zugeordnet sind.

    Datentyp: Array von Objekten

    "layouts": [
      {
        "capacity": Number,
        "cleanup_duration": "String",
        "image": {Object},
        "is_default": Boolean,
        "max_capacity": Number,
        "name": "String",
        "preparation_duration": "String",
        "short_description": "String",
        "sys_id": "String"
      }
    ]
    Ergebnis.Layouts.Kapazität Anzahl der Personen, die an der Besprechung teilnehmen

    Datentyp: Zahl

    result.layouts.cleanup_duration Zeit, die zum Bereinigen des reservierbaren Elements für dieses Layout benötigt wird.

    Datentyp: Zahl

    Einheit: Millisekunden

    Ergebnis.Layouts.Bild Details zu einem Bild, das das Layout für das zugeordnete reservierbare Element darstellt.

    Datentyp: Objekt

    "image": {
      "link": "String",
      "sys_id": "String"
    }

    Tabelle: Bilder [db_image]

    result.layouts.image.link Link zu einem Bild, das das Layout für dieses reservierbare Element darstellt.

    Datentyp: Zeichenfolge

    Tabelle: Bilder [db_image]

    result.layouts.image.sys_id Sys_id des zugeordneten Image-Datensatzes.

    Datentyp: Zeichenfolge

    result.layouts.is_default Kennzeichnung, die angibt, ob das zugeordnete Layout der Standard für das reservierbare Element ist.
    Gültige Werte:
    • true: Standard.
    • false: Nicht Standard.

    Datentyp: Boolesch

    result.layouts.max_capacity Maximale Anzahl von Personen, die das dem reservierbaren Element zugeordnete Layout aufnehmen kann.

    Datentyp: Zahl

    result.layouts.name Name des Standortlayouts

    Datentyp: Zeichenfolge

    result.layouts.preparation_duration Zeit, die zur Vorbereitung des zugehörigen Standortlayouts benötigt wird.

    Datentyp: Zahl

    Einheit: Millisekunden

    result.layouts.short_description Kurze Beschreibung des Standortlayouts.

    Datentyp: Zeichenfolge

    result.layouts.sys_id Sys_id des Standortlayouts.

    Datentyp: Zeichenfolge

    Tabelle: Layout [sn_wsd_rsv_layout]

    result.location_type Details zum Standorttyp des reservierbaren Elements, z. B. Arbeitsplatz/Schreibtisch, Café oder Studio.

    Datentyp: Objekt

    "location_type": {
      "display_value": "String",
      "sys_id": "String"
    }

    Tabelle: Platztyp [sn_wsd_core_space_type]

    result.location_type.display_value Anzeigewert des Ortstyps.

    Datentyp: Zeichenfolge

    result.location_type.sys_id Sys_id des zugeordneten Datensatzes.

    Datentyp: Zeichenfolge

    Tabelle: Platztyp [sn_wsd_core_space_type]

    result.meetingProviders Details zu den Anbietern virtueller Besprechungen, die dem reservierbaren Element zugeordnet sind.

    Datentyp: Array von Objekten

    "meetingProviders": [
      {
        "display_value": "String",
        "value": "String"
      }
    ]

    Tabelle: Anbieter virtueller Besprechungen [sn_wsd_rsv_virtual_meeting_provider]

    result.meetingProviders.display_value Anzeigewert des Namens des virtuellen Anbieters.

    Datentyp: Zeichenfolge

    result.meetingProviders.value Ist-Wert für den Namen des virtuellen Anbieters im Datensatz.

    Datentyp: Zeichenfolge

    result.moduleType Reservierbares Modul, das dem reservierbaren Element zugeordnet ist, z. B. Schreibtische oder Besprechungsraum.

    Datentyp: Zeichenfolge

    result.name Name des reservierbaren Elements.

    Datentyp: Zeichenfolge

    Ergebnis.Nummer Eindeutiger Bezeichner des reservierbaren Elements. Dieser Wert ist besser lesbar als die sys_id.

    Datentyp: Zeichenfolge

    Ergebnis.Reihenfolge Auftragsnummer für das reservierbare Element.

    Datentyp: Zahl

    result.require_approval Kennzeichnung, die angibt, ob für das Reservieren des reservierbaren Elements eine Genehmigung erforderlich ist.
    Mögliche Werte:
    • true: Genehmigung erforderlich.
    • „false“: Eine Genehmigung ist nicht erforderlich.

    Datentyp: Boolesch

    result.requires_check_in Kennzeichnung, die angibt, ob der Anwender für das reservierbare Element einchecken muss.
    Gültige Werte:
    • true: Check-in erforderlich.
    • „false“: Einchecken ist nicht erforderlich.

    Datentyp: Boolesch

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

    Ergebnis.reservierbare_Menge Maximale Anzahl, wie oft das zugeordnete reservierbare Element für dieselbe Zeit reserviert werden kann. Dieser Wert wird verwendet, wenn Arbeitsbereichsbereiche einem Bereich zugewiesen werden.

    Datentyp: Ganzzahl

    result.site Details zum Standort, auf dem sich das reservierbare Element befindet.

    Datentyp: Objekt

    "site": {
      "display_value": "String",
      "sys_id": "String"
    }

    Tabelle: Site [sn_wsd_core_site]

    result.site.display_value Anzeigewert der Site.

    Datentyp: Zeichenfolge

    result.standard_services Wird nur ausgefüllt, wenn der Parameter include_standard_services auf „wahr“ festgelegt ist.
    Zugehörige Standardservices, z. B. Flipchart, Bildschirmprojektor sowie Whiteboard und Marker.

    Datentyp: Array von Objekten

    "standard_services": [
      {
        "font_awesome_icon": "String",
        "name": "String",
        "short_description": "String",
        "sys_id": "String"
      }
    ]
    Ergebnis.Standard_Services.Schriftart_aweso_Symbol Name des Miniatursymbols, das dem Standardservice zugeordnet ist.

    Datentyp: Zeichenfolge

    result.standard_services.name Name des Standardservice.

    Datentyp: Zeichenfolge

    result.standard_services.short_description Kurze Beschreibung des Standardservice.

    Datentyp: Zeichenfolge

    result.standard_services.sys_id Sys_id des Standardservicedatensatzes.

    Datentyp: Zeichenfolge

    Tabelle: Standardservice [sn_wsd_rsv_standard_service]

    result.site.sys_id Sys_id des zugeordneten Site-Datensatzes.

    Datentyp: Zeichenfolge

    Tabelle: Site [sn_wsd_core_site]

    result.tableName Name der Tabelle, in der sich der reservierbare Datensatz befindet.

    Datentyp: Zeichenfolge

    Ergebnis.Titel Titel des reservierbaren Elements.

    Datentyp: Zeichenfolge

    result.type Typ eines reservierbaren Elements, z. B. Standort.

    Datentyp: Zeichenfolge

    cURL-Anforderung

    Das folgende Codebeispiel zeigt, wie dieser Endpunkt aufgerufen wird.

    curl "http://instance.servicenow.com/api/sn_wsd_rsv/reservable/list_reservables/dad3df5977220110b3d7be377b5a99ce,3ed3139977220110b3d7be377b5a99d1?include_flexible_services=true&include_layouts=false&include_reservable_purposes=true&include_standard_services=true&reservable_module_sys_id=c31241cedb7650106c731dcd13961917" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    Ergebnisse zurückgeben:

    {
      "result": [
        {
          "sys_id": "3e41e94adb7210106c731dcd1396198c",
          "external_id": null,
          "wsd_email": null,
          "name": "A1-02-04",
          "title": "A1-02-04",
          "description": "General desk available for reservation.",
          "image": null,
          "number": "SPCE0009004",
          "site": {
            "sys_id": "628eec06db7650106c731dcd139619dd",
            "display_value": "North America"
          },
          "campus": {
            "sys_id": "82b2a0cedb3650106c731dcd139619e9",
            "display_value": "California Campus"
          },
          "building": {
            "sys_id": "94e264cedb3650106c731dcd13961919",
            "display_value": "CAL-B1",
            "timezone": {
              "value": "US/Pacific",
              "displayValue": "US/Pacific"
            }
          },
          "floor": {
            "sys_id": "fc7368cedb3650106c731dcd13961902",
            "display_value": "Floor 1"
          },
          "area": null,
          "capacity": "1",
          "reservable_quantity": null,
          "location_type": {
            "sys_id": "5f017383eb512010b89bfdfc9c5228c8",
            "display_value": "Workspace/Desk"
          },
          "order": null,
          "requires_check_in": null,
          "is_reservable": "1",
          "type": "location",
          "moduleType": "Desks",
          "meetingProviders": [],
          "require_subject": false,
          "allow_invitees": true,
          "display_number_of_attendees": false,
          "display_on_behalf_of": true,
          "display_sensitivity": false,
          "enable_group_reservations": false,
          "enable_reservation_privacy": true,
          "employee_override_privacy": true,
          "tableName": "sn_wsd_core_space",
          "require_approval": false
        },
        {
          "sys_id": "fd41a94adb7210106c731dcd1396195a",
          "external_id": null,
          "wsd_email": null,
          "name": "A1-02-03",
          "title": "A1-02-03",
          "description": "General desk available for reservation.",
          "image": null,
          "number": "SPCE0009003",
          "site": {
            "sys_id": "628eec06db7650106c731dcd139619dd",
            "display_value": "North America"
          },
          "campus": {
            "sys_id": "82b2a0cedb3650106c731dcd139619e9",
            "display_value": "California Campus"
          },
          "building": {
            "sys_id": "94e264cedb3650106c731dcd13961919",
            "display_value": "CAL-B1",
            "timezone": {
              "value": "US/Pacific",
              "displayValue": "US/Pacific"
            }
          },
          "floor": {
            "sys_id": "fc7368cedb3650106c731dcd13961902",
            "display_value": "Floor 1"
          },
          "area": null,
          "capacity": "1",
          "reservable_quantity": null,
          "location_type": {
            "sys_id": "5f017383eb512010b89bfdfc9c5228c8",
            "display_value": "Workspace/Desk"
          },
          "order": null,
          "requires_check_in": null,
          "is_reservable": "1",
          "type": "location",
          "moduleType": "Desks",
          "meetingProviders": [],
          "require_subject": false,
          "allow_invitees": true,
          "display_number_of_attendees": false,
          "display_on_behalf_of": true,
          "display_sensitivity": false,
          "enable_group_reservations": false,
          "enable_reservation_privacy": true,
          "employee_override_privacy": true,
          "tableName": "sn_wsd_core_space",
          "require_approval": false
        }
      ]
    }