Exportieren Sie Daten dynamisch aus einem Skript oder Webservice, indem Sie eine URL-Abfrage erstellen.
Vorbereitungen
Erforderliche Rolle: keine
Hinweis: ServiceNow Erzwingt
Standardauthentifizierung Für direkten URL-Zugriff. Die aus der URL extrahierten Daten enthalten nur die Felder, auf die der aktuell authentifizierte Anwender Lesezugriff hat.
Warum und wann dieser Vorgang ausgeführt wird
Sie können URL-Abfragen verwenden, um vor dem Exportieren gefilterte Listen von Datensätzen programmgesteuert zu generieren. URL-Abfragen sind nützlich für Skripts, die eine Liste von Datensätzen generieren, oder wenn kein Anwender den Filter manuell über die Anwenderoberfläche hinzufügen kann.
Sie müssen mit vertraut sein ServiceNow Tabellen- und Spaltennamen, um Daten direkt aus der URL zu exportieren. Siehe Navigieren Sie mithilfe einer URL zu einem Datensatz oder Modul .
Sie können mithilfe von Abfrageparametern oder Systemeigenschaften steuern, ob der Anzeigewert oder der Rohwert von Feldern und die Feldbezeichnung oder der Feldname für Header exportiert werden sollen.
Abfrageparameter überschreiben, falls vorhanden, Systemeigenschaften.
Prozedur
-
Geben Sie die Instanz-URL an.
Zum Beispiel:
https://<instance name>.service-now.com/
-
Geben Sie das zu exportierende Tabellenformular oder die Liste an.
Zum Beispiel:
incident_list.do
-
Geben Sie den Exportformatprozessor an, der für den Export verwendet werden soll.
Sie können CSV, XLS, JSON, XLSX oder XML angeben. Zum Beispiel:
?CSV
Hinweis: Der XML-Prozessor in einem URL-Export exportiert keine Anhänge oder Journalfelder. Zum Exportieren von Anhängen und Journalfeldern wie Arbeitsnotizen Oder Zusätzliche Kommentare Felder, exportieren Sie die Datensätze aus einer Liste mit Option im Kontextmenü.
- Wahlweise:
Fragen Sie bestimmte Datensätze ab, indem Sie hinzufügen sysparm_queryParameter.
Die erforderliche Syntax ist
Sysparm_query=[Spaltenname][Operator][Wert] . Zum Beispiel:
https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1
Hinweis: Alle Abfragen verwenden einen Spaltennamen, einen Operator und einen Wert. Siehe
Bedingungsgenerator Für eine Liste der verfügbaren Operatoren.
- Wahlweise:
Sortieren Sie die Datensätze mithilfe von nach Spaltennamen sysparm_orderbyParameter.
Die erforderliche Syntax ist
Sysparm_orderby=[Spaltenname] . Zum Beispiel:
https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to
Hinweis: Mit können Sie nur nach einer Spalte sortieren
sysparm_orderby. Um nach mehreren Spalten zu sortieren, verwenden Sie mehrere sorderby-Einträge. Zum Beispiel:
sysparm_query=ORDERBYassigned_to^ORDERBYpriority
- Wahlweise:
Exportieren Sie Felder mit aus einer bestimmten Ansicht sysparm_viewParameter.
Die erforderliche Syntax ist
Sysparm_View=[Ansichtsname] . Zum Beispiel:
https://<instance name>.service-now.com/incident.do?CSV&sysparm_view=ess
Diese URL exportiert Incident-Felder, die in der Self-Service-Ansicht (ess) sichtbar sind.
- Standardmäßig werden beim Exportieren von Daten aus einer Liste nur die Felder exportiert, die in der aktuellen Ansicht sichtbar sind. Wenn Sie Felder aus einer anderen Listenansicht exportieren möchten, können Sie Ansichten über die Anwenderoberfläche wechseln. Siehe Ansichtsverwaltung .
- Wenn Sie CSV- oder Excel-Daten exportieren und keine Ansicht angeben, verwendet der Export die standardmäßige Listenansicht.
- Wenn Sie XML-Daten exportieren, werden standardmäßig alle Felder exportiert, es sei denn, Sie geben eine bestimmte Ansicht an.
- Wahlweise:
Exportieren Sie bestimmte Felder aus der Tabelle mit sysparm_fieldsParameter.
Die erforderliche Syntax ist
Sysparm_fields=[field1],[field2] . Zum Beispiel:
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
- Wahlweise:
Exportieren Sie alle Felder aus der Tabelle, einschließlich der sys_ID, mit sysparm_default_export_fieldsParameter.
Die erforderliche Syntax ist
Sysparm_default_Export_fields=all . Zum Beispiel:
https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
Die
sysparm_default_export_fieldsDer Parameter hat keine Auswirkungen auf XML-Exporte, es sei denn, Sie schließen ein
sysparm_viewParameter zum Angeben einer nicht standardmäßigen Ansicht.
Beispiel-URLs
| URL |
Beschreibung |
| https://<instance name>.service-now.com/incident_list.do?CSV |
Exportieren Sie alle Incidents in eine durch Kommas getrennte Werttextdatei. |
| https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_query=sys_id%3E%3Db4aedb520a0a0b1001af10e278657d27 |
Exportieren Sie einen bestimmten Incident in eine durch Kommas getrennte Werttextdatei. |
| https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_orderby=sys_id |
Exportieren Sie alle Incidents in eine durch Kommas getrennte Werttextdatei, und sortieren Sie die Liste nach sys_ID |
| https://<instance name>.service-now.com/incident_list.do?XML&sysparm_query=priority=1&sysparm_orderby=assigned_to |
Exportieren Sie eine Liste aller Incidents mit Priorität 1 in eine XML-Datei, und sortieren Sie die Liste nach Zugewiesen an Feld. |