Datensätze in komplexe Datentypen exportieren und konvertieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 3 Minuten Lesedauer

    • Verwenden Sie URL-Parameter, um Tabellendatensätze zu exportieren und in komplexe Datentypen wie JSON, XML, PDF, CSV und XLS zu konvertieren.

    Datensätze als komplexe Datentypen exportieren

    Sie können eine HTTP- GET -Anforderung verwenden, um Datensätze aus einer Tabelle abzurufen und in ein bestimmtes Format zu bringen. Verwenden Sie beispielsweise den Parameter PDF in einer GET -Anforderung, um Datensätze aus einer Tabelle als PDF-Dateien zu exportieren. Verwenden Sie den Parameter XLS, um Datensätze aus einer Tabelle als XLS-Dateien zu exportieren. Um beispielsweise eine Liste von Incident-Datensätzen als XLS-Dateien abzurufen, geben Sie ein HTTP GET mit der folgenden URL aus: https://instance_name.service-now.com/incident.do?XLS. Die zurückgegebene Datei ist incident.xls. incident.do ist im Grunde ein GET, das eine Liste der Datensätze aus der Incident-Tabelle zurückgibt. Der Parameter XLS konvertiert diese Datensätze in XLS-Dateien.

    Die allgemeine Syntax lautet: https://<serviceNow-instance-name> /<table-name> .do?<Data-type-parameter>

    URL-Parameter

    Die folgende Tabelle enthält URL-Parameter, die Sie in GET -Anforderungen verwenden können, Filter, mit denen Sie unerwünschte Tabellendatensätze in der Rückgabe herausfiltern können, und einen Indikator, der angibt, ob Sie den Datentyp direkt in eine Tabelle einfügen können. Der Parameter wird zur Erweiterung der zurückgegebenen Datei. Beispiel: Wenn Sie den Parameter XLS verwenden, wird eine Datei im Formular zurückgegeben<table-name> .xls.
    Tabelle : 1. URL-Parameter
    Datentyp Parameter Gültige Filter Direkter POST in Tabelle?
    CSV CSV sysparm_query, sysparm_view Y
    Excel XLS, EXCEL, XLSX sysparm_query, sysparm_view Y
    JSON JSONv2 Verschiedene Weitere Informationen finden Sie unter JSON-Datenabruf-API. Y
    PDF PDF sysparm_query, sysparm_view N
    RSS RSS sysparm_query, sysparm_view und mehr. Weitere Informationen finden Sie unter Ergebnisse mit einer Ansicht einschränken. N
    XML XML, XSD, SCHEMA sysparm_query, useUnloadFormat N

    Weitere Informationen zum Abrufen und Konvertieren von Tabellendatensätzen in das JSON-Dateiformat finden Sie unter JSONv2-Webservice.

    Weitere Informationen zum Abrufen und Konvertieren von Tabellendatensätzen in das RSS-Dateiformat finden Sie unter RSS-Feed-Generator.

    Datensätze werden in PDFs konvertiert

    Beim PDF-Export wird zwischen der Zielrichtung einer Tabelle und der Zielrichtung ihrer Liste unterschieden. Um eine PDF-Datei mit einer Liste von Datensätzen zu generieren, suffixieren Sie das Ziel mit _list. Um einen einzelnen Datensatz als Ziel zu verwenden, müssen Sie den Parameter sys_id angeben, um den Datensatz zu identifizieren, für den Sie die PDF-Datei generieren.

    Filter

    Alle URL-Parameter arbeiten mit Filtern, mit denen Sie eine Teilmenge von Tabellendatensätzen exportieren können. Beispiel: Mit sysparm_query=active=true in einer GET -Anforderung werden nur aktive Datensätze exportiert. Im folgenden Beispiel werden nur aktive Incident-Datensätze in ein Excel-Format exportiert: https://instance_name.service-now.com/incident.do?EXCEL&sysparm_query=active=true.

    Die allgemeine Syntax lautet: https://<serviceNow-instance-name> /<table_list> .do?<Data-type-parameter> &<filter>

    Zu den Filtern gehören:
    • sysparm_query: Filtert die Daten mithilfe der codierten Abfrage, bevor Dateien exportiert werden. Beispiel: sysparm_query=active=true exportiert nur aktive Datensätze.
    • sysparm_view: Geben Sie den Namen einer Listenansicht an, um zu steuern, welche Felder zurückgegeben werden. Um beispielsweise die ESS-Ansicht zurückzugeben, verwenden Sie sysparm_view=ess.
    • useUnloadFormat – Gibt an, dass das zurückgegebene XML-Format ein Entladeformat ist. Das Entladeformat ist das gleiche Format, das Sie erhalten, wenn Sie aus einer Liste in der Benutzeroberfläche Export > XML > ... auswählen. Sie können entladene XML-Dateien wieder in die Tabellen importieren. Um das Entladeformat von einer URL zu aktivieren, verwenden Sie den URL-Parameter useUnloadFormat=true, z. B. https://instance_name.service-now.com/incident.do?XML&useUnloadFormat=true.

    Beispiel für GET-Abfragen

    Tabelle : 2. Beispiele für GET-Anforderungen
    Datentyp Beispielanfrage
    CSV https://instance_name.service-now.com/incident.do?CSV&sysparm_query=active=true
    Excel https://instance_name.service-now.com/incident.do?XLS&sysparm_query=active=true
    PDF https://instance_name.service-now.com/incident.do?PDF&sysparm_view=ess
    RSS https://instance_name.service-now.com/incident.do?RSS&sysparm_view=ess
    XML https://instance_name.service-now.com/incident.do?XML&sysparm_query=active=true

    Zurückgegebene Dateien

    GET -Abfragen geben Datensätze aus einer Tabelle in dem in der Anforderung angegebenen Format zurück. Beispielsweise gibt eine Abfrage, die den Parameter XLS verwendet, einen Tabellendatensatz in einer Datei mit der Erweiterung XLS zurück.

    Der Header Content-Disposition in der Antwort zeigt den Dateinamen und die Erweiterung der zurückgegebenen Datei an. Der Dateiname basiert auf der Tabelle, aus der Sie exportieren, z. B. incident.xls, incident.pdf oder incident.xml.

    Daten werden in Tabellen exportiert

    Sie können die folgenden Datentypen direkt in Tabellen einfügen:
    • CSV
    • Excel
    • JSON

    Die Dateikopfzeilen müssen mit den Feldspalten in der Zieltabelle übereinstimmen. Weitere Informationen finden Sie unter CSV- oder Excel-Dateien direkt in einem Import Setveröffentlichen.