Exportieren Sie direkt von einer URL

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Sie können Daten dynamisch aus einem Skript oder Webservice exportieren, indem Sie eine URL-Abfrage erstellen.

    Vorbereitungen

    Erforderliche Rolle: keine

    Hinweis:
    ServiceNow erzwingt die Standardauthentifizierung für den direkten URL-Zugriff. Die aus der URL extrahierten Daten enthalten nur die Felder, auf die der aktuell authentifizierte Benutzer Lesezugriff hat.

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können URL-Abfragen verwenden, um gefilterte Listen von Datensätzen vor dem Export programmgesteuert zu generieren. URL-Abfragen sind nützlich für Skripts, die eine Liste von Datensätzen generieren, oder wenn kein Benutzer den Filter manuell über die Anwenderoberfläche hinzufügen kann.

    Sie müssen mit den Namen der Tabelle ServiceNow und den Spaltennamen vertraut sein, um Daten direkt von der URL exportieren zu können. Weitere Informationen finden Sie unter Über eine URL zu einem Datensatz oder einem Modul navigieren.

    Sie können steuern, ob der Anzeigewert oder Rohwert von Feldern und die Feldbezeichnung oder der Feldname für Header mithilfe von Abfrageparametern oder Systemeigenschaften exportiert werden sollen. Wenn Abfrageparameter vorhanden sind, überschreiben sie die Systemeigenschaften.

    Prozedur

    1. Geben Sie die Instanz-URL an.
      Zum Beispiel:
      https://<instance name>.service-now.com/
    2. Geben Sie das zu exportierende Tabellenformular oder die zu exportierende Liste an.
      Zum Beispiel:
      incident_list.do
    3. Geben Sie den für den Export zu verwendenden Exportformatprozessor an.
      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. Um Anhänge und Journalfelder wie die Felder „Arbeitsnotizen“ oder „Zusätzliche Kommentare“ zu exportieren, exportieren Sie die Datensätze mithilfe von aus einer Liste Exportieren > XML Option im Kontextmenü.
    4. Wahlweise: Fragen Sie bestimmte Datensätze ab, indem Sie den Parameter sysparm_query hinzufügen.
      Die erforderliche Syntax lautet 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. Eine Liste der verfügbaren Operatoren finden Sie unter Bedingungsgenerator.
    5. Wahlweise: Sortieren Sie die Datensätze nach Spaltenname mit dem Parameter sysparm_orderby.
      Die erforderliche Syntax lautet 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 sysparm_orderbykönnen Sie nur nach einer Spalte sortieren. Um nach mehreren Spalten zu sortieren, verwenden Sie mehrere orderby-Einträge. Zum Beispiel:
      sysparm_query=ORDERBYassigned_to^ORDERBYpriority
    6. Wahlweise: Exportieren Sie Felder mit dem Parameter sysparm_view aus einer bestimmten Ansicht.
      Die erforderliche Syntax lautet 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 Selfservice-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 in der Anwenderoberfläche zwischen den Ansichten wechseln. Weitere Informationen finden Sie unter Verwaltung von anzeigen.
      • Wenn Sie CSV- oder Excel-Daten exportieren und keine Ansicht angeben, wird beim Exportieren die Standardlistenansicht verwendet.
      • Wenn Sie XML-Daten exportieren, werden standardmäßig alle Felder exportiert, sofern Sie keine bestimmte Ansicht angeben.
    7. Wahlweise: Exportieren Sie bestimmte Felder mit dem Parameter sysparm_fields aus der Tabelle.
      Die erforderliche Syntax lautet sysparm_fields=[field1],[field2]. Zum Beispiel:
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_fields=sys_id,number
    8. Wahlweise: Exportieren Sie alle Felder aus der Tabelle, einschließlich der sys_id, mit dem Parameter sysparm_default_export_fields.
      Die erforderliche Syntax lautet sysparm_default_export_fields=all. Zum Beispiel:
      https://<instance name>.service-now.com/incident_list.do?CSV&sysparm_default_export_fields=all
      Der Parameter sysparm_default_export_fields hat keine Auswirkungen auf XML-Exporte, es sei denn, Sie geben den Parameter sysparm_view an, um eine nicht standardmäßige Ansicht anzugeben.

    Beispiel-URLs

    URL Beschreibung
    https://<instance name> .service-now.com/incident_list.do?CSV Exportieren Sie alle Incidents in eine durch Kommas getrennte Textdatei.
    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 Textdatei.
    https://<instance name> .service-now.com/incident_list.do?CSV&sysparm_orderby=sys_id Exportieren Sie alle Incidents in eine durch Kommas getrennte Textdatei, 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 der Priorität 1 in eine XML-Datei, und sortieren Sie die Liste nach dem Feld Zugewiesen an.