Exportieren und Konvertieren von Datensätzen in komplexe Datentypen

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 3 Minuten Lesedauer

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

    Datensätze werden als komplexe Datentypen exportiert

    Sie können ein HTTP verwenden ABRUFEN Anforderung zum Abrufen von Datensätzen aus einer Tabelle und zum Einfügen in ein angegebenes Format. Verwenden Sie beispielsweise PDFParameter in einem ABRUFEN Anforderung zum Exportieren von Datensätzen aus einer Tabelle als PDF-Dateien; verwenden Sie XLSParameter zum Exportieren von Datensätzen aus einer Tabelle als XLS-Dateien. Um beispielsweise eine Liste von Incident-Datensätzen als XLS-Dateien abzurufen, geben Sie eine HTTP-Datei aus ABRUFEN Mit der folgenden URL: https://instance_name.service-now.com/incident.do?XLS . Die zurückgegebene Datei ist incident.xls . Incident.tun Ist im Grunde ein ABRUFEN Gibt eine Liste der Datensätze aus der Incident-Tabelle zurück. Die XLSParameter konvertiert diese Datensätze in XLS-Dateien.

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

    URL-Parameter

    Die folgende Tabelle zeigt URL-Parameter an, die Sie in verwenden können ABRUFEN Anforderungen, Filter, die Sie verwenden können, um unerwünschte Tabellendatensätze in der Rückgabe herauszufiltern, und ein Indikator, der angibt, ob Sie dies können VERÖFFENTLICHEN Der Datentyp direkt zu einer Tabelle. Der Parameter wird zur Erweiterung der zurückgegebenen Datei, z. B. mit XLSParameter gibt eine Datei im Formular zurück <table-name>.xls .
    Tabelle : 1. URL-Parameter
    Datentyp Parameter Gültige Filter Direkt in Tabelle POSTEN?
    CSV CSV Sysparm_query, sysparm_View Y
    Excel XLS, EXCEL, XLSX Sysparm_query, sysparm_View Y
    JSON JSONv2 Verschiedene. Siehe JSON-Datenabruf-API . Y
    PDF PDF Sysparm_query, sysparm_View N
    RSS RSS Sysparm_query, sysparm_View und mehr. Siehe Ergebnisse werden mit einer Ansicht eingeschränkt . 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 PDF-Dateien konvertiert

    Beim PDF-Export wird unterschieden zwischen der Ausrichtung einer Tabelle und der Ausrichtung ihrer Liste. Um eine PDF-Datei einer Liste von Datensätzen zu generieren, setzen Sie das Ziel mit einem Suffix _Liste . Um einen einzelnen Datensatz als Ziel zu definieren, müssen Sie angeben sys_idParameter zur Identifizierung des Datensatzes, für den Sie die PDF generieren.

    Filter

    Alle URL-Parameter funktionieren mit Filtern, mit denen Sie eine Teilmenge von Tabellendatensätzen exportieren können. Beispiel: Sysparm_query=Active=true In einem ABRUFEN Anforderungsexportiert nur aktive Datensätze. Das folgende Beispiel exportiert nur aktive Incident-Datensätze im Excel-Format: https://instance_name.service-now.com/incident.do?EXCEL&sysparm_query=active=true .

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

    Filter umfassen:
    • Sysparm_query: Filtert die Daten anhand 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. Verwenden Sie beispielsweise, um die ESS-Ansicht zurückzugeben 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 in einer Liste in der Anwenderoberfläche Exportieren > XML > ... auswählen Sie können entladene XML-Dateien zurück in die Tabellen importieren. Verwenden Sie zum Aktivieren des Entladungsformats aus einer URL UseUnloadFormat=wahr URL-Parameter, z. B. https://instance_name.service-now.com/incident.do?XML&useUnloadFormat=true .

    Beispiel für „Abfragen ABRUFEN“

    Tabelle : 2. RUFT Anforderungsbeispiele AB
    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

    ABRUFEN Abfragen geben Datensätze aus einer Tabelle im in der Anforderung angegebenen Format zurück. Beispiel: Eine Abfrage, die verwendet XLSParameter gibt einen Tabellendatensatz in einer Datei mit zurück .Xls Erweiterung.

    Der Header „Inhaltsdisposition“ 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 VERÖFFENTLICHEN Die folgenden Datentypen direkt in Tabellen:
    • CSV
    • Excel
    • JSON

    Die Datei-Header müssen mit den Feldspalten in der Zieltabelle übereinstimmen. Weitere Informationen finden Sie unter Veröffentlichen Sie CSV- oder Excel-Dateien direkt in einem Importsatz .