Exportieren und Konvertieren von Datensätzen in komplexe Datentypen

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 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, Datensätze aus einer Tabelle abzurufen und in einem angegebenen Format abzulegen. 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 ein HTTP 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 Die eine Liste der Datensätze aus der Incident-Tabelle zurückgibt. Die XLSDer Parameter 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 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. mithilfe von 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 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 einer Liste von Datensätzen zu generieren, setzen Sie das Suffix für das Ziel _Liste . Um ein Ziel für einen einzelnen Datensatz festzulegen, müssen Sie angeben sys_idParameter zur Identifizierung des Datensatzes, für den Sie die PDF-Datei 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 lautet: 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, z. B. 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 in einer Liste in der Anwenderoberfläche Exportieren > XML > ... auswählen Sie können entladungsformatierte 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. RUFEN SIE 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

    Dateien zurückgegeben

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

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