Datensätze werden exportiert und in komplexe Datentypen konvertiert

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 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 werden als komplexe Datentypen exportiert

    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, führen Sie einen HTTP GET -Befehl über die folgende 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 -Element, 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 zeigt URL-Parameter, die Sie in GET -Anforderungen verwenden können, Filter, mit denen Sie unerwünschte Tabellendatensätze bei der Rückgabe herausfiltern können, und einen Indikator, der angibt, ob Sie den Datentyp direkt in eine Tabelle POSTEN können. Der Parameter wird zur Erweiterung der zurückgegebenen Datei. Wenn Sie beispielsweise den Parameter XLS verwenden, wird eine Datei im Formular zurückgegeben<table-name> .xls.
    Tabelle : 1. URL-Parameter
    Datentyp Parameter Gültige Filter Direkt POST an 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 von Tabellendatensätzen und zum 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 einer Liste von Datensätzen zu generieren, fügen Sie dem Ziel das Suffix _list hinzu. Um einen einzelnen Datensatz als Ziel festzulegen, 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: sysparm_query=active=true in einer GET -Anforderung exportiert nur aktive Datensätze. Im folgenden Beispiel werden nur aktive Incident-Datensätze im 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 anhand der codierten Abfrage vor dem Exportieren von Dateien. 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, geben Sie sysparm_view=ess ein.
    • useUnloadFormat: Gibt an, dass das zurückgegebene XML-Format ein Entladeformat ist. Das Entladeformat ist das gleiche Format, das Sie erhalten, wenn Sie in einer Liste in der Anwenderoberfläche Exportieren > XML > ... auswählen. Sie können unformatierte XML-Dateien zurück 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 Content-Disposition-Header 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 posten :
    • CSV
    • Excel
    • JSON

    Die Dateiheader müssen mit den Feldspalten in der Zieltabelle übereinstimmen. Weitere Informationen finden Sie unter CSV- oder Excel-Dateien direkt in einem Importsatz posten.