Tabellen-API

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 28 Minuten Lesedauer

    • Die Tabelle Die API stellt Endpunkte bereit, mit denen Sie CRUD-Vorgänge (Erstellen, Lesen, Aktualisieren und Löschen) für vorhandene Tabellen ausführen können.

    Der aufrufende Anwender muss über ausreichende Rollen verfügen, um auf die Daten in der in der Anforderung angegebenen Tabelle zuzugreifen.

    Tabelle: LÖSCHEN SIE /now/table/{tableName}/{sys_ID}

    Löscht den angegebenen Datensatz aus der angegebenen Tabelle.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

    Standard-URL: /api/now/table/{tableName}/{sys_ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 1. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    sys_id SYS_ID des zu löschenden Datensatzes.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, aus der der angegebene Datensatz gelöscht werden soll, z. B. „Incident“ oder „Asset“.

    Datentyp: Zeichenfolge
    Tabelle : 2. Abfrageparameter
    Name Beschreibung
    sysparm_query_no_domain Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist.

    Gültige Werte:

    • Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.
    • Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api“ verfügbar.
    Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Keine

    Header

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

    Tabelle : 4. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Tabelle : 5. Antwort-Header
    Header 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 REST-API-HTTP-Antwortcodes .

    Tabelle : 6. Statuscodes
    Statuscode Beschreibung
    204 Gibt an, dass die Anforderung erfolgreich abgeschlossen wurde.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Keine

    Curl-Anforderung

    Löschen Sie einen Datensatz aus der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/d977b66a4f411200adf9f8e18110c7b2" \
--request DELETE \
--header "Accept:application/json" \
--user 'username':'password'

    Es ist kein Antworttext vorhanden.

    None

    Tabelle – RUFT /now/table/{tableName} AB

    Ruft mehrere Datensätze für die angegebene Tabelle ab.

    Grundlegende Anweisungen finden Sie unter Ruft vorhandene Incidents ab .

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}

    Standard-URL: /api/now/table/{tableName}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 7. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.
    Je nach Version gibt dieser Endpunkt verschiedene Ergebnisse für eine gültige Abfrage zurück.
    • Version 1 gibt Fehlercode 404 ohne Ergebnisse zurück.
    • Version 2 gibt den Erfolgscode 200 und ein leeres Array als Antworttext zurück.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, aus der die Datensätze abgerufen werden sollen.

    Datentyp: Zeichenfolge
    Tabelle : 8. Abfrageparameter
    Name Beschreibung
    Name-Wert-Paare Name-Wert-Paare, die zum Filtern des Ergebnissatzes verwendet werden sollen. Dieser Parameter schließt sich gegenseitig aus sysparm_query. Beispiel: Anstatt zu verwenden &Sysparm_query=Active=true , Sie können die aufrufende Anweisung vereinfachen, indem Sie verwenden &Active=wahr . Sie können den Anzeigewert auch verwenden, wenn das Feld ein Auswahl- oder Referenztypfeld ist, z. B. &Status=Geschlossen Anstelle von &Status=7 . Um mehrere Schlüssel-Wert-Paare anzugeben, trennen Sie jedes durch ein und-Zeichen, z. B. &Active=wahr&assigned_to=john.smith .

    Datentyp: Zeichenfolge
    Sysparm_Display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • Wahr: Gibt die Anzeigewerte für alle Felder zurück.
    • Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück.

    Standard: Falsch

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Häufig gestellte Fragen zur Tabellen-API (KB0534905).
    sysparm_exclude_reference_link Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen.

    Gültige Werte:

    • Wahr: Tabellen-API-Links für Referenzfelder ausschließen.
    • Falsch: Tabellen-API-Links für Referenzfelder einschließen.

    Datentyp: Boolescher Wert

    Standard: Falsch
    Sysparm_fields Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle Felder zurückgeben.
    Sysparm_limit Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie sysparm_offsetParameter zum Paginieren des Datensatzabrufs.

    Dieser Grenzwert wird vor der ACL-Auswertung angewendet. Wenn keine Datensätze zurückgegeben werden, einschließlich der Datensätze, auf die Sie Zugriff haben, ordnen Sie die Datensatzreihenfolge so an, dass Datensätze, auf die Sie zuerst zugreifen können, zurückgegeben werden.

    Hinweis:
    Ungewöhnlich groß sysparm_limitWerte können sich auf die Systemleistung auswirken.

    Datentyp: Zahl

    Standard: 20

    Maximum: 100
    Sysparm_no_count Kennzeichnung, die angibt, ob eine ausgeführt werden soll Anzahl auswählen (*) Abfrage der Tabelle, um die Anzahl der Zeilen in der zugehörigen Tabelle zurückzugeben.
    Gültige Werte:
    • Wahr: Führen Sie keinen aus Anzahl auswählen (*) .
    • Falsch: Führen Sie eine aus Anzahl auswählen (*) .

    Datentyp: Boolescher Wert

    Standard: Falsch
    Sysparm_Offset Startdatensatzindex, für den mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken.

    Beispiel: Wenn Sie diesen Endpunkt zum ersten Mal aufrufen, sysparm_offsetIst auf „0“ festgelegt. Um einfach alle verfügbaren Datensätze durchzublättern, verwenden Sie Sysparm_Offset=sysparm_Offset+sysparm_limit , Bis Sie das Ende aller Datensätze erreichen.

    Übergeben Sie keine negative Zahl in sysparm_offsetParameter.

    Datentyp: Zahl

    Standard: 0
    Sysparm_query Codierte Abfrage Wird verwendet, um den Ergebnissatz zu filtern. Sie können einen UI-Filter verwenden, um eine ordnungsgemäß codierte Abfrage zu erhalten.
    Syntax: Sysparm_query=<col_name> <operator> <value> .
    • <col_name>: Name der Tabellenspalte, nach der gefiltert werden soll.
    • <operator>: Unterstützt die folgenden Werte:
      • =: Stimmt genau mit <value> überein.
      • !=: Stimmt nicht mit <value> überein.
      • ^: Logisch UND mehrere Abfrageanweisungen.
      • ^ODER: Logisch ODER mehrere Abfrageanweisungen.
      • LIKE: <col_name> enthält die angegebene Zeichenfolge. Funktioniert nur für <col_name>-Felder, deren Datentyp „Zeichenfolge“ ist.
      • STARTSMIT: <col_name> beginnt mit der angegebenen Zeichenfolge. Funktioniert nur für <col_name>-Felder, deren Datentyp „Zeichenfolge“ ist.
      • ENDSWITH: <col_name> endet mit der angegebenen Zeichenfolge. Funktioniert nur für <col_name>-Felder, deren Datentyp „Zeichenfolge“ ist.
      <value>: Wert, mit dem abgeglichen werden soll.

    Bei allen Parametern wird zwischen Groß- und Kleinschreibung unterschieden. Abfragen können mehr als einen Eintrag enthalten, z. B. Sysparm_query=<col_name> <operator> <value>[<operator> <col_name> <operator> <value>] .

    Zum Beispiel:

    (Sysparm_query=caller_ID=javascript:gs.getUserID()^Active=wahr)

    Codierte Abfragen unterstützen auch die Funktion „Sortieren nach“. Um Antworten basierend auf bestimmten Feldern zu sortieren, verwenden Sie SORTIEREN NACH Und ORDERBYDESC Klauseln in sysparm_query.

    Syntax:
    • ORDERBY<col_name>
    • ORDERBYDESC<col_name>

    Beispiel: Sysparm_query=Active=wahr^ORDERBYNummer^ORDERBYDESCCATEGORY

    Diese Abfrage filtert alle aktiven Datensätze und ordnet die Ergebnisse in aufsteigender Reihenfolge nach Nummer und dann in absteigender Reihenfolge nach Kategorie an.

    Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Gibt dann Zeilen zurück, die nur den gültigen Teil der Abfrage verwenden. Sie können dieses Verhalten mithilfe der Eigenschaft steuern glide.invalid_query.returns_no_rows. Legen Sie diese Eigenschaft auf „wahr“ fest, um keine Zeilen für eine ungültige Abfrage zurückzugeben.
    Hinweis:
    Die glide.invalid_query.returns_no_rowsEigenschaft steuert das Verhalten aller Abfragen in der Instanz, z. B. in Listen, Skripts ( GlideRecord.Abfrage() ) Und Webservice-APIs.

    Datentyp: Zeichenfolge
    Sysparm_query_category Name der Kategorie, die für Abfragen verwendet werden soll.

    Datentyp: Zeichenfolge
    sysparm_query_no_domain Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist.

    Gültige Werte:

    • Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.
    • Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api“ verfügbar.
    sysparm_suppress_pagination_header Kennzeichnung, die angibt, ob der Linkheader aus der Antwort entfernt werden soll. Der Linkheader stellt verschiedene URLs für relative Seiten im Datensatzsatz bereit, die Sie zum Paginieren des zurückgegebenen Datensatzes verwenden können.

    Gültige Werte:

    • Wahr: Entfernen Sie den Linkheader aus der Antwort.
    • Falsch: Entfernen Sie den Linkheader nicht aus der Antwort.

    Datentyp: Boolescher Wert

    Standard: Falsch
    sysparm_view UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder.

    Gültige Werte:

    • Desktop
    • Mobile
    • both

    Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang.

    Datentyp: Zeichenfolge
    Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Keine

    Header

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

    Tabelle : 10. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Tabelle : 11. Antwort-Header
    Header Beschreibung
    Verknüpfen Relative URLs basierend auf der vorherigen Anforderung, mit denen Sie den verfügbaren Datensatzsatz durchblättern können.

    Zum Beispiel:

    https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="next" ,

    https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=40&sysparm_limit=1000>;rel="prev" ,

    https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=0&sysparm_limit=1000>;rel="first" ,

    https://<instance name>.servicenow.com/api/now/table/cmdb_ci?sysparm_offset=2780&sysparm_limit=1000>;rel="last"

    Für zusätzliche Informationen zu relParameter, siehe https://html.spec.whatwg.org/multipage/links.html#linkTypes.
    X-Gesamtzahl Gesamtanzahl der von der Abfrage zurückgegebenen Datensätze.

    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 REST-API-HTTP-Antwortcodes .

    Tabelle : 12. Statuscodes
    Statuscode Beschreibung
    200 Anforderung erfolgreich abgeschlossen. Wenn eine gültige Abfrage keine Ergebnisse zurückgegeben hat, enthält der Antworttext nur ein leeres Ergebnis-Array.

    Antworttext-Parameter (JSON oder XML)

    Parameter Beschreibung
    Name-Wert-Paare Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen.

    Curl-Anforderung

    Ruft den ersten Datensatz aus der Problemtabelle ab.

    curl "https://instance.servicenow.com/api/now/table/problem?sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Die Antwort enthält die Name-Wert-Paare für den angeforderten Datensatz.

    {
  "result": [
    {
      "parent": "",
      "made_sla": "true",
      "watch_list": "",
      "upon_reject": "cancel",
      "sys_updated_on": "2016-01-19 04:52:04",
      "approval_history": "",
      "number": "PRB0000050",
      "sys_updated_by": "glide.maint",
      "opened_by": {
        "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
        "value": "glide.maint"
      },
      "user_input": "",
      "sys_created_on": "2016-01-19 04:51:19",
      "sys_domain": {
        "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "state": "4",
      "sys_created_by": "glide.maint",
      "knowledge": "false",
      "order": "",
      "closed_at": "2016-01-19 04:52:04",
      "cmdb_ci": {
        "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/55b35562c0a8010e01cff22378e0aea9",
        "value": "55b35562c0a8010e01cff22378e0aea9"
      },
      "delivery_plan": "",
      "impact": "3",
      "active": "false",
      "work_notes_list": "",
      "business_service": "",
      "priority": "4",
      "sys_domain_path": "/",
      "time_worked": "",
      "expected_start": "",
      "rejection_goto": "",
      "opened_at": "2016-01-19 04:49:47",
      "business_duration": "1970-01-01 00:00:00",
      "group_list": "",
      "work_end": "",
      "approval_set": "",
      "wf_activity": "",
      "work_notes": "",
      "short_description": "Switch occasionally drops connections",
      "correlation_display": "",
      "delivery_task": "",
      "work_start": "",
      "assignment_group": "",
      "additional_assignee_list": "",
      "description": "Switch occasionally drops connections",
      "calendar_duration": "1970-01-01 00:02:17",
      "close_notes": "updated firmware",
      "sys_class_name": "problem",
      "closed_by": "",
      "follow_up": "",
      "sys_id": "04ce72c9c0a8016600b5b7f75ac67b5b",
      "contact_type": "phone",
      "urgency": "3",
      "company": "",
      "reassignment_count": "",
      "activity_due": "",
      "assigned_to": "",
      "comments": "",
      "approval": "not requested",
      "sla_due": "",
      "comments_and_work_notes": "",
      "due_date": "",
      "sys_mod_count": "1",
      "sys_tags": "",
      "escalation": "0",
      "upon_approval": "proceed",
      "correlation_id": "",
      "location": ""
    }
  ]
}

    Tabelle – RUFT /now/table/{tableName}/{sys_ID} AB

    Ruft den durch die angegebene sys_ID identifizierten Datensatz aus der angegebenen Tabelle ab.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

    Standard-URL: /api/now/table/{tableName}/{sys_ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 13. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    sys_id SYS_ID des abzurufenden Datensatzes.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, aus der der Datensatz abgerufen werden soll.

    Datentyp: Zeichenfolge
    Tabelle : 14. Abfrageparameter
    Name Beschreibung
    Sysparm_Display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • Wahr: Gibt die Anzeigewerte für alle Felder zurück.
    • Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück.

    Standard: Falsch

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Häufig gestellte Fragen zur Tabellen-API (KB0534905).
    sysparm_exclude_reference_link Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen.

    Gültige Werte:

    • Wahr: Tabellen-API-Links für Referenzfelder ausschließen.
    • Falsch: Tabellen-API-Links für Referenzfelder einschließen.

    Datentyp: Boolescher Wert

    Standard: Falsch
    Sysparm_fields Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle Felder zurückgeben.
    sysparm_query_no_domain Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist.

    Gültige Werte:

    • Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.
    • Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api“ verfügbar.
    sysparm_view UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder.

    Gültige Werte:

    • Desktop
    • Mobile
    • both

    Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang.

    Datentyp: Zeichenfolge
    Tabelle : 15. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Keine

    Header

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

    Tabelle : 16. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Tabelle : 17. Antwort-Header
    Header 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 REST-API-HTTP-Antwortcodes .

    Tabelle : 18. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.

    Antworttext-Parameter (JSON oder XML)

    Parameter Beschreibung
    Name-Wert-Paare Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen.

    Curl-Anforderung

    Ruft einen Datensatz aus der Incident-Tabelle ab.

    curl "https://instance.servicenow.com/api/now/table/incident/a9e30c7dc61122760116894de7bcc7bd" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

    Die Antwort enthält die Name-Wert-Paare für den angeforderten Datensatz.

    {
  "result": {
    "upon_approval": "",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/105cf7f3c611227501e75e08b14a38ba",
      "value": "105cf7f3c611227501e75e08b14a38ba"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "3",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "3",
    "delivery_plan": "",
    "sys_mod_count": "4",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2015-11-11 22:04:15",
    "delivery_task": "",
    "sys_updated_on": "2015-11-01 22:37:27",
    "parent": "",
    "work_end": "",
    "number": "INC0000046",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "software",
    "business_duration": "",
    "incident_state": "1",
    "activity_due": "",
    "correlation_display": "",
    "company": "",
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a4dde73c6112278017a6a4baf547aa7",
      "value": "8a4dde73c6112278017a6a4baf547aa7"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
      "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
    },
    "knowledge": "false",
    "made_sla": "false",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "1",
    "user_input": "",
    "sys_created_on": "2015-11-01 22:05:30",
    "approval_set": "",
    "reassignment_count": "1",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 22:04:15",
    "short_description": "Can't access SFA software",
    "order": "",
    "sys_updated_by": "glide.maint",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "",
    "approval_history": "",
    "problem_id": {
      "link": "https://instance.servicenow.com/api/now/table/problem/a9e4890bc6112276003d7a5a5c774a74",
      "value": "a9e4890bc6112276003d7a5a5c774a74"
    },
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "a9e30c7dc61122760116894de7bcc7bd",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "admin",
    "resolved_at": "",
    "assigned_to": "",
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/a9c0c8d2c6112276018f7705562f9cb0",
      "value": "a9c0c8d2c6112276018f7705562f9cb0"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/46c6f9efa9fe198101ddf5eed9adf6e7",
      "value": "46c6f9efa9fe198101ddf5eed9adf6e7"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "0",
    "comments": ""
  }
}

    Tabelle – PATCH /now/table/{tableName}/{sys_ID}

    Aktualisiert den angegebenen Datensatz mit den im Anforderungstext enthaltenen Name-Wert-Paaren.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

    Standard-URL: /api/now/table/{tableName}/{sys_ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 19. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    sys_id SYS_ID des zu aktualisierenden Datensatzes.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, in der sich der angegebene Datensatz befindet.

    Datentyp: Zeichenfolge
    Tabelle : 20. Abfrageparameter
    Name Beschreibung
    Sysparm_Display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • Wahr: Gibt die Anzeigewerte für alle Felder zurück.
    • Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück.

    Standard: Falsch

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Häufig gestellte Fragen zur Tabellen-API (KB0534905).
    Sysparm_fields Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle Felder zurückgeben.
    sysparm_input_display_value Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen. Abhängig von den verschiedenen Arten von Feldern kann der Endpunkt die übergebenen Anzeigewerte manipulieren, um die richtigen Werte in der Datenbank zu speichern. Wenn Sie beispielsweise den Anzeigenamen für ein Referenzfeld senden, speichert der Endpunkt die sys_ID für diesen Wert in der Datenbank. Bei Datums- und Uhrzeitfeldern wird der Datums- und Uhrzeitwert an die Zeitzone des aktuellen Anwenders angepasst. Bei „falsch“ werden der Datums- und Uhrzeitwert mithilfe der GMT-Zeitzone eingefügt.

    Gültige Werte:

    • Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden.
    • Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank.

    Datentyp: Boolescher Wert

    Standard: Falsch: Entspricht dem Datentyp, der während des Datenabrufs (GET-Methoden) zurückgegeben wird, d. h. den tatsächlichen Werten.

    Hinweis:
    Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen Wahr . Wenn dieser Parameter nicht auf „wahr“ festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zur Feldverschlüsselung finden Sie unter Encryption.
    sysparm_query_no_domain Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist.

    Gültige Werte:

    • Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.
    • Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api“ verfügbar.
    sysparm_view UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder.

    Gültige Werte:

    • Desktop
    • Mobile
    • both

    Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang.

    Datentyp: Zeichenfolge
    Tabelle : 21. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Name-Wert-Paare Feldname und neuer Wert für jeden Parameter, der im angegebenen Datensatz aktualisiert werden soll.
    Hinweis:
    Möglicherweise sind nicht alle Felder in einem Datensatz zum Aktualisieren verfügbar. Beispiel: Felder mit dem Präfix „sys_“ sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können.

    Header

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

    Tabelle : 22. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    X-no-response-body Standardmäßig enthalten Antworten Textinhalte, die den geänderten Datensatz detaillieren. Legen Sie diesen Anforderungsheader auf „wahr“ fest, um den Antworttext zu unterdrücken.
    Tabelle : 23. Antwort-Header
    Header 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 REST-API-HTTP-Antwortcodes .

    Tabelle : 24. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Name-Wert-Paare Feldnamen und Werte aller Parameter im angegebenen Datensatz oder der in den Abfrageparametern angegebenen.

    Curl-Anforderung

    Aktualisieren Sie einen Datensatz in der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PATCH \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'

    Die Antwort enthält die Name-Wert-Paare für den aktualisierten Datensatz.

    {
  "result": {
    "upon_approval": "proceed",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
      "value": "108752c8c611227501d4ab0e392ba97f"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "1",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "1",
    "delivery_plan": "",
    "sys_mod_count": "7",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2017-07-05 05:58:24",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:12:37",
    "parent": "",
    "work_end": "",
    "number": "INC0000050",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "hardware",
    "business_duration": "",
    "incident_state": "2",
    "activity_due": "2016-01-22 16:12:37",
    "correlation_display": "",
    "company": {
      "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
      "value": "31bea3d53790200044e0bfc8bcbe5dec"
    },
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
      "value": "8a5055c9c61122780043563ef53438e3"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
      "value": "5b7c200d0a640069006b3845b5d0fa7c"
    },
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "2",
    "user_input": "",
    "sys_created_on": "2015-11-02 18:05:40",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 21:58:24",
    "short_description": "Can't access Exchange server - is it down?",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "glide.maint",
    "resolved_at": "",
    "assigned_to": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
      "value": "681b365ec0a80164000fb0b05854a0cd"
    },
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
      "value": "281190e3c0a8000b003f593aa3f20ca6"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
      "value": "glide.maint"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "3",
    "comments": ""
  }
}

    Tabelle – POST /now/table/{tableName}

    Fügt einen Datensatz in die angegebene Tabelle ein. Das Einfügen mehrerer Datensätze wird von dieser Methode nicht unterstützt.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}

    Standard-URL: /api/now/table/{tableName}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 25. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, in der der Datensatz gespeichert werden soll.

    Datentyp: Zeichenfolge
    Tabelle : 26. Abfrageparameter
    Name Beschreibung
    Sysparm_Display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • Wahr: Gibt die Anzeigewerte für alle Felder zurück.
    • Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück.

    Standard: Falsch

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Häufig gestellte Fragen zur Tabellen-API (KB0534905).
    sysparm_exclude_reference_link Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen.

    Gültige Werte:

    • Wahr: Tabellen-API-Links für Referenzfelder ausschließen.
    • Falsch: Tabellen-API-Links für Referenzfelder einschließen.

    Datentyp: Boolescher Wert

    Standard: Falsch
    Sysparm_fields Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle Felder zurückgeben.
    sysparm_input_display_value Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen. Abhängig von den verschiedenen Arten von Feldern kann der Endpunkt die übergebenen Anzeigewerte manipulieren, um die richtigen Werte in der Datenbank zu speichern. Wenn Sie beispielsweise den Anzeigenamen für ein Referenzfeld senden, speichert der Endpunkt die sys_ID für diesen Wert in der Datenbank. Bei Datums- und Uhrzeitfeldern wird der Datums- und Uhrzeitwert an die Zeitzone des aktuellen Anwenders angepasst. Bei „falsch“ werden der Datums- und Uhrzeitwert mithilfe der GMT-Zeitzone eingefügt.

    Gültige Werte:

    • Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden.
    • Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank.

    Datentyp: Boolescher Wert

    Standard: Falsch: Entspricht dem Datentyp, der während des Datenabrufs (GET-Methoden) zurückgegeben wird, d. h. den tatsächlichen Werten.

    Hinweis:
    Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen Wahr . Wenn dieser Parameter nicht auf „wahr“ festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zur Feldverschlüsselung finden Sie unter Encryption.
    sysparm_view UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder.

    Gültige Werte:

    • Desktop
    • Mobile
    • both

    Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang.

    Datentyp: Zeichenfolge
    Tabelle : 27. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Name-Wert-Paare Feldname und zugeordneter Wert für jeden Parameter, der im angegebenen Datensatz definiert werden soll.
    Hinweis:
    Möglicherweise sind nicht alle Felder in einem Datensatz zum Aktualisieren verfügbar. Beispiel: Felder mit dem Präfix „sys_“ sind normalerweise Systemparameter, die automatisch generiert werden und nicht aktualisiert werden können.
    Felder, die nicht angegeben und vom System nicht automatisch generiert werden, werden auf den Nullwert des zugehörigen Datentyps festgelegt.

    Header

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

    Tabelle : 28. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    X-no-response-body Standardmäßig enthalten Antworten Textinhalte, die den neuen Datensatz detaillieren. Legen Sie diesen Header in der Anforderung auf „wahr“ fest, um den Antworttext zu unterdrücken.
    Tabelle : 29. Antwort-Header
    Header Beschreibung
    Standort Speicherort der erstellten Ressource.

    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 REST-API-HTTP-Antwortcodes .

    Tabelle : 30. Statuscodes
    Statuscode Beschreibung
    201 Gibt an, dass die Anforderung erfolgreich abgeschlossen wurde.
    400 Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Name-Wert-Paare Feldnamen und Werte aller Parameter im neu erstellten Datensatz oder der in den Abfrageparametern angegebenen Parameter.

    Curl-Anforderung

    Fügen Sie einen neuen Datensatz in die Incident-Tabelle ein.

    curl "https://instance.servicenow.com/api/now/table/incident" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'short_description':'Unable to connect to office wifi','assignment_group':'287ebd7da9fe198100f92cc8d1d2154e','urgency':'2','impact':'2'}" \
--user 'username':'password'

    Die Antwort enthält die Name-Wert-Paare für den neuen Datensatz.

    {
  "result": {
    "upon_approval": "proceed",
    "location": "",
    "expected_start": "",
    "reopen_count": "0",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "2",
    "urgency": "2",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "3",
    "delivery_plan": "",
    "sys_mod_count": "0",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:28:24",
    "parent": "",
    "work_end": "",
    "number": "INC0010002",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "inquiry",
    "business_duration": "",
    "incident_state": "1",
    "activity_due": "",
    "correlation_display": "",
    "company": "",
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/287ebd7da9fe198100f92cc8d1d2154e",
      "value": "287ebd7da9fe198100f92cc8d1d2154e"
    },
    "caller_id": "",
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "1",
    "user_input": "",
    "sys_created_on": "2016-01-22 14:28:24",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "0",
    "opened_at": "2016-01-22 14:28:24",
    "short_description": "Unable to connect to office wifi",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "c537bae64f411200adf9f8e18110c76e",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "admin",
    "resolved_at": "",
    "assigned_to": "",
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": "",
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/6816f79cc0a8016401c5a33be04be441",
      "value": "6816f79cc0a8016401c5a33be04be441"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "0",
    "comments": ""
  }
}

    Tabelle – PUT /now/table/{tableName}/{sys_ID}

    Aktualisiert den angegebenen Datensatz mit dem Anforderungstext.

    URL-Format

    Versionierte URL: /api/now/{api_Version}/table/{tableName}/{sys_ID}

    Standard-URL: /api/now/table/{tableName}/{sys_ID}

    Hinweis:
    Verfügbare Versionen werden in angegeben REST-API-Explorer . Für geskriptete REST-APIs gibt es zusätzliche Versionsinformationen auf Geskriptetes REST-Service-Formular .

    Unterstützte Anforderungsparameter

    Tabelle : 31. Pfad-Parameter
    Name Beschreibung
    api_version Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: v1 Oder v2 . Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden.

    Datentyp: Zeichenfolge
    sys_id Eindeutiger Bezeichner des zu aktualisierenden Datensatzes.

    Datentyp: Zeichenfolge
    tableName Name der Tabelle, in der sich der Datensatz befindet.

    Datentyp: Zeichenfolge
    Tabelle : 32. Abfrageparameter
    Name Beschreibung
    Sysparm_Display_value Bestimmt den Typ der zurückgegebenen Daten, entweder die tatsächlichen Werte aus der Datenbank oder die Anzeigewerte der Felder. Anzeigewerte werden basierend auf dem ist-Wert in der Datenbank und den Anwender- oder Systemeinstellungen und -Einstellungen geändert.
    Wenn Anzeigewerte zurückgegeben werden, ist der zurückgegebene Wert vom Feldtyp abhängig.
    • Auswahlfelder: Der Datenbankwert kann eine Zahl sein, der Anzeigewert ist jedoch beschreibender.
    • Datumsfelder: Der Datenbankwert hat das UTC-Format, während der Anzeigewert auf der Zeitzone des Anwenders basiert.
    • Verschlüsselter Text: Der Datenbankwert ist verschlüsselt, während der angezeigte Wert basierend auf dem Verschlüsselungskontext des Anwenders unverschlüsselt ist.
    • Referenzfelder: Der Datenbankwert ist sys_ID, der Anzeigewert ist jedoch ein Anzeigefeld des referenzierten Datensatzes.

    Datentyp: Zeichenfolge

    Gültige Werte:

    • Wahr: Gibt die Anzeigewerte für alle Felder zurück.
    • Falsch: Gibt die tatsächlichen Werte aus der Datenbank zurück.
    • Alle: Gibt sowohl ist-Werte als auch Anzeigewerte zurück.

    Standard: Falsch

    Hinweis:
    Es gibt keine bevorzugte Methode zum Festlegen dieses Parameters. Die Angabe des Anzeigewerts kann jedoch zu Leistungsproblemen führen, da er nicht direkt aus der Datenbank gelesen wird und möglicherweise auf andere Felder und Datensätze verweist. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Häufig gestellte Fragen zur Tabellen-API (KB0534905).
    sysparm_exclude_reference_link Kennzeichnung, die angibt, ob Tabellen-API-Links für Referenzfelder ausgeschlossen werden sollen.

    Gültige Werte:

    • Wahr: Tabellen-API-Links für Referenzfelder ausschließen.
    • Falsch: Tabellen-API-Links für Referenzfelder einschließen.

    Datentyp: Boolescher Wert

    Standard: Falsch
    Sysparm_fields Kommagetrennte Liste von Feldern, die in der Antwort zurückgegeben werden sollen. Ungültige Felder werden ignoriert.

    Datentyp: Zeichenfolge

    Standard: Alle Felder zurückgeben.
    sysparm_input_display_value Kennzeichnung, die angibt, ob Feldwerte mithilfe des Anzeigewerts oder des ist-Werts festgelegt werden sollen.

    Gültige Werte:

    • Wahr: Behandelt Eingabewerte als Anzeigewerte, und sie werden so bearbeitet, dass sie ordnungsgemäß in der Datenbank gespeichert werden können.
    • Falsch: Behandelt Eingabewerte als ist-Werte und speichert sie ohne Manipulation in der Datenbank.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    • Wenn dieser Parameter auf festgelegt ist Wahr , Achten Sie auf Eingabewerte, insbesondere Datumswerte, da diese als über die Zeitzoneneinstellung des Anwenders bereitgestellt interpretiert und in das UTC-Format umgewandelt werden.
    • Um den Wert eines verschlüsselten Felds festzulegen, müssen Sie diesen Parameter auf festlegen Wahr . Wenn dieser Parameter nicht auf „wahr“ festgelegt ist, werden an verschlüsselte Felder übermittelte Werte nicht gespeichert. Darüber hinaus muss der anfordernde Anwender über den entsprechenden Verschlüsselungskontext verfügen, bevor die Anforderung übermittelt wird. Verschlüsselte Felder werden für Anwender ohne den entsprechenden Verschlüsselungskontext ausgeblendet. Weitere Informationen zu Anzeigewerten und ist-Werten finden Sie unter Tabellen-API – häufig gestellte Fragen (KB0534905) . Weitere Informationen zur Feldverschlüsselung finden Sie unter Field Encryption.
    sysparm_query_no_domain Kennzeichnung, die angibt, ob die Datensatzsuche auf die Domänen beschränkt werden soll, für die der angemeldete Anwender konfiguriert ist.

    Gültige Werte:

    • Falsch: Schließen Sie den Datensatz aus, wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.
    • Wahr: Schließen Sie den Datensatz ein, auch wenn er sich in einer Domäne befindet, auf die der derzeit angemeldete Anwender nicht zugreifen kann.

    Datentyp: Boolescher Wert

    Standard: Falsch

    Hinweis:
    Die sysparm_query_no_domainDer Parameter ist nur für Systemadministratoren oder Anwender mit der Rolle „query_no_domain_table_api“ verfügbar.
    sysparm_view UI-Ansicht, für die die Daten gerendert werden sollen. Bestimmt die in der Antwort zurückgegebenen Felder.

    Gültige Werte:

    • Desktop
    • Mobile
    • both

    Wenn Sie auch angeben sysparm_fieldsParameter, hat Vorrang.

    Datentyp: Zeichenfolge
    Tabelle : 33. Anforderungstext-Parameter (XML oder JSON)
    Name Beschreibung
    Name-Wert-Paare Name-Wert-Paare für die Felder, die in der zugehörigen Tabelle aktualisiert werden sollen. Um beispielsweise die Kurzbeschreibungsdatei zu aktualisieren, geben Sie ein Name-Wert-Paar ähnlich dem folgenden ein: --Data „{\"short_description\": \"meine Kurzbeschreibung\" }" \ .

    Header

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

    Tabelle : 34. Anforderungskopfzeilen.
    Header Beschreibung
    Akzeptieren Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml.

    Standard: application/json
    Inhaltstyp Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml.
    X-no-response-body Standardmäßig enthalten Antworten Textinhalte, die den geänderten Datensatz detaillieren. Legen Sie diesen Header in der Anforderung auf „wahr“ fest, um den Antworttext zu unterdrücken.
    Tabelle : 35. Antwort-Header
    Header 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 REST-API-HTTP-Antwortcodes .

    Tabelle : 36. Statuscodes
    Statuscode Beschreibung
    200 Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet.
    400 Ungültige Anforderung. Ein ungültiger Anforderungstyp oder eine fehlerhafte Anforderung wurde erkannt.
    404 Nicht gefunden. Das angeforderte Element wurde nicht gefunden.

    Antworttext-Parameter (JSON oder XML)

    Name Beschreibung
    Name-Wert-Paare Alle Felder (nicht nur geändert) mit ihren zugehörigen Werten für die Change-Anforderung.

    Curl-Anforderung

    Aktualisieren Sie einen Datensatz in der Incident-Tabelle.

    curl "https://instance.servicenow.com/api/now/table/incident/ef43c6d40a0a0b5700c77f9bf387afe3" \
--request PUT \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data "{'assigned_to':'681b365ec0a80164000fb0b05854a0cd','urgency':'1','comments':'Elevating urgency, this is a blocking issue'}" \
--user 'username':'password'

    Die Antwort enthält die Name-Wert-Paare für den aktualisierten Datensatz.

    {
  "result": {
    "upon_approval": "proceed",
    "location": {
      "link": "https://instance.servicenow.com/api/now/table/cmn_location/108752c8c611227501d4ab0e392ba97f",
      "value": "108752c8c611227501d4ab0e392ba97f"
    },
    "expected_start": "",
    "reopen_count": "",
    "close_notes": "",
    "additional_assignee_list": "",
    "impact": "1",
    "urgency": "1",
    "correlation_id": "",
    "sys_tags": "",
    "sys_domain": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/global",
      "value": "global"
    },
    "description": "",
    "group_list": "",
    "priority": "1",
    "delivery_plan": "",
    "sys_mod_count": "7",
    "work_notes_list": "",
    "business_service": "",
    "follow_up": "",
    "closed_at": "",
    "sla_due": "2017-07-05 05:58:24",
    "delivery_task": "",
    "sys_updated_on": "2016-01-22 14:12:37",
    "parent": "",
    "work_end": "",
    "number": "INC0000050",
    "closed_by": "",
    "work_start": "",
    "calendar_stc": "",
    "category": "hardware",
    "business_duration": "",
    "incident_state": "2",
    "activity_due": "2016-01-22 16:12:37",
    "correlation_display": "",
    "company": {
      "link": "https://instance.servicenow.com/api/now/table/core_company/31bea3d53790200044e0bfc8bcbe5dec",
      "value": "31bea3d53790200044e0bfc8bcbe5dec"
    },
    "active": "true",
    "due_date": "",
    "assignment_group": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user_group/8a5055c9c61122780043563ef53438e3",
      "value": "8a5055c9c61122780043563ef53438e3"
    },
    "caller_id": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/5b7c200d0a640069006b3845b5d0fa7c",
      "value": "5b7c200d0a640069006b3845b5d0fa7c"
    },
    "knowledge": "false",
    "made_sla": "true",
    "comments_and_work_notes": "",
    "parent_incident": "",
    "state": "2",
    "user_input": "",
    "sys_created_on": "2015-11-02 18:05:40",
    "approval_set": "",
    "reassignment_count": "0",
    "rfc": "",
    "child_incidents": "",
    "opened_at": "2015-11-02 21:58:24",
    "short_description": "Can't access Exchange server - is it down?",
    "order": "",
    "sys_updated_by": "admin",
    "resolved_by": "",
    "notify": "1",
    "upon_reject": "cancel",
    "approval_history": "",
    "problem_id": "",
    "work_notes": "",
    "calendar_duration": "",
    "close_code": "",
    "sys_id": "ef43c6d40a0a0b5700c77f9bf387afe3",
    "approval": "not requested",
    "caused_by": "",
    "severity": "3",
    "sys_created_by": "glide.maint",
    "resolved_at": "",
    "assigned_to": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/681b365ec0a80164000fb0b05854a0cd",
      "value": "681b365ec0a80164000fb0b05854a0cd"
    },
    "business_stc": "",
    "wf_activity": "",
    "sys_domain_path": "/",
    "cmdb_ci": {
      "link": "https://instance.servicenow.com/api/now/table/cmdb_ci/281190e3c0a8000b003f593aa3f20ca6",
      "value": "281190e3c0a8000b003f593aa3f20ca6"
    },
    "opened_by": {
      "link": "https://instance.servicenow.com/api/now/table/sys_user/glide.maint",
      "value": "glide.maint"
    },
    "subcategory": "",
    "rejection_goto": "",
    "sys_class_name": "incident",
    "watch_list": "",
    "time_worked": "",
    "contact_type": "phone",
    "escalation": "3",
    "comments": ""
  }
}