IMPORT-GRCRESULTS-Befehl

Erstellt eine Analytics-Tabelle, indem eine Tabelle aus der HighBond-Ergebnisse-App oder eine Interpretation importiert wird.

Syntax

IMPORT GRCRESULTS TO Tabelle Importdateiname PASSWORD Zahl FROM Pfad_der_Ergebnisressource <FIELD Name AS Anzeigename <...n>>

Parameter

Name Beschreibung
TO Tabelle

Der Name der Analytics-Tabelle, in welche die Daten importiert werden sollen.

Hinweis

Tabellennamen sind auf 64 alphanumerische Zeichen beschränkt. Der Name kann den Unterstrich beinhalten ( _ ), aber keine anderen Sonderzeichen oder Leerzeichen. Er kann nicht mit einer Ziffer beginnen.

Importdateiname

Der Name der zu erstellenden Analytics-Datendatei.

Geben Sie Importdateiname als in Anführungszeichen gesetzte Zeichenfolge mit der Dateierweiterung „.FIL“ an. Zum Beispiel: „Rechnungen.FIL“.

Standardmäßig wird die Datendatei (.FIL) in den Ordner mit dem Analytics-Projekt gespeichert.

Verwenden Sie entweder einen absoluten oder relativen Dateipfad, um die Datendatei in einen anderen bestehenden Ordner zu speichern:

  • "C:\Daten\Rechnungen.FIL"
  • "Daten\Rechnungen.FIL"
PASSWORD Zahl

Die zu verwendende Kennwortdefinition.

Sie verwenden nicht PASSWORD Zahl, um ein tatsächliches Kennwort abzurufen oder festzulegen. Die Kennwortdefinition bezieht sich auf ein vorher angegebenes oder ein mit dem PASSWORD-, dem SET-PASSWORD-Befehl oder dem PASSWORD-Analysetag festgelegtes Kennwort.

Zahl bezieht sich auf die Zahl der Kennwortdefinition. Wenn beispielsweise zuvor zwei Kennwörter in einem Skript angegeben bzw. festgelegt wurden oder falls eine Analyse geplant wurde, wird mit PASSWORD 2 angegeben, dass das zweite Kennwort verwendet wird.

Weitere Informationen über die Angabe oder das Festlegen von Kennwörtern finden Sie unter:

Das benötigte Kennwort ist ein HighBond-Zugriffstoken. Weitere Informationen finden Sie unter Eine Kennwortdefinition erstellen und ein Kennwort festlegen.

Hinweis

In Abhängigkeit von der Umgebung, in der das Skript ausgeführt wird, kann PASSWORD notwendig sein oder auch nicht:

Analytics

(Online-Aktivierung)

PASSWORD ist nicht erforderlich.

Es wird automatisch der HighBond-Zugriffstoken des aktuellen Benutzers verwendet.

Analytics

(Offline-Aktivierung)

PASSWORD wird benötigt.
Robots
Analytics Exchange
Fenster „Analyse-App“

FROM Pfad_der_Ergebnisressource

Der Pfad auf die zu importierenden Daten.

Das Format des Pfads ist je nach den zu importierenden Daten unterschiedlich. Einzelheiten hierzu finden Sie unter Pfad in der Ergebnisse-App.

Hinweis

Das Format des Ergebnisse-App-Pfads wird durch ein API bereitgestellt und unterliegt Veränderungen. Am einfachsten und verlässlichsten erhalten Sie die korrekte und aktuelle Syntax des Pfads, indem Sie einen manuellen Import der Zieldaten durchführen und den Pfad dann aus dem Befehlsprotokoll kopieren.
FIELD Name AS Anzeigename <...n>

Optional

Individuelle Felder in den zu importierenden Quelldaten. Geben Sie den Namen ein.

Wenn Sie FIELD auslassen, werden alle Felder importiert.

Name

Name muss dem physischen Feldnamen in der Ergebnisse-App-Tabelle genau entsprechen, was die Groß-/Kleinschreibung einbezieht. Um den physischen Feldnamen anzuzeigen, gehen Sie anhand einer der folgenden Methoden vor:

  • In der Ergebnisse-App klicken Sie in der Tabellenansicht auf einen Spaltentitel. Der physische Feldname wird nach dem Feldname angezeigt.
  • Wenn Sie eine Ergebnisse-App-Tabelle in Analytics importieren, erscheint der physische Feldname in Klammern nach dem Anzeigename im Dialogfeld, das Ihnen die Auswahl von Feldern gestattet.

Hinweis

Der physische Feldname in der Ergebnisse-App ist nicht der Anzeigename, der für die Spaltentitel in der Tabellenansicht verwendet wird.

Hierzu siehe auch Überlegungen zu Feldnamen beim Importieren und Exportieren von Daten aus Ergebnisse.

Anzeigename

Anzeigename (alternativer Spaltentitel) ist der Anzeigename für das Feld in der Ansicht der neuen Analytics-Tabelle. Sie müssen einen Anzeigenamen für jeden Namen von FIELD angeben. Geben Sie den Anzeigenamen als in Anführungszeichen gesetzte Zeichenfolge an.

Verwenden Sie zwischen den Wörtern ein Semikolon (;), wenn Sie die Zeilen in dem Spaltentitel umbrechen möchten.

Im Gegensatz zu anderen IMPORT-Befehlen in Analytics können Sie keinen leeren Anzeigenamen angeben, um den FIELD-Namen als Anzeigenamen zu verwenden.

Beispiele

Festgelegte Felder von einer Tabelle in die Ergebnisse-App importieren

Sie importieren festgelegte Felder von einer Tabelle in der Ergebnisse-App in eine Analytics-Tabelle namens Spesenausnahmen:

IMPORT GRCRESULTS TO Spesenausnahmen „C:\Sekundäre Analyse\Spesenausnahmen.fil" PASSWORD1 FROM "results/api/orgs/11594/control_tests/185699/exceptions" FIELD "metadata.status" AS "Status" FIELD "Mitnr" AS "Mitarbeiternummer" FIELD "DATE" AS "Datum" FIELD "CARDNUM" AS "Kartennummer" FIELD "CODES" AS "Händlercodes" FIELD "AMOUNT" AS "Betrag" FIELD "DESCRIPTION" AS "Beschreibung"

Alle Felder von einer Tabelle in die Ergebnisse-App importieren

Sie importieren alle Felder von einer Tabelle in der Ergebnisse-App in eine Analytics-Tabelle namens Spesenausnahmen:

IMPORT GRCRESULTS TO Spesenausnahmen „C:\Sekundäre Analyse\Spesenausnahmen.fil" PASSWORD 1 FROM "results/api/orgs/11594/control_tests/185699/exceptions"

Daten von einer Interpretation in die Ergebnisse-App importieren

Sie importieren eine Interpretation in der Ergebnisse-App in eine Analytics-Tabelle namens Spesenausnahmen_gefiltert:

IMPORT GRCRESULTS TO Spesenausnahmen_gefiltert "C:\Sekundäre Analyse\Spesenausnahmen_gefiltert.fil" FROM "results/api/orgs/11594/control_tests/185699/interpretations/22699/exceptions"

Bemerkungen

Hinweis

Weitere Informationen über die Funktion dieses Befehls finden Sie in Hilfe für Analytics.

Sortierfolge und Filter beibehalten

Wenn Sie Daten aus der Ergebnisse-App importieren, bleiben alle Datenanpassungen, wie Sortieren oder Filtern, in der entstehenden Analytics-Tabelle erhalten bzw. werden ignoriert. Dies hängt davon ab, wie Sie die Daten importieren:

  • Tabelle importieren Datenanpassungen werden ignoriert. Alle Daten in der Tabelle werden importiert, mit Ausnahme von Feldern, die Sie auslassen möchten.
  • Interpretation importieren Datenanpassungen werden beibehalten.

Pfad in der Ergebnisse-App

Hinweis

Das Format des Ergebnisse-App-Pfads wird durch ein API bereitgestellt und unterliegt Veränderungen. Am einfachsten und verlässlichsten erhalten Sie die korrekte und aktuelle Syntax des Pfads, indem Sie einen manuellen Import der Zieldaten durchführen und den Pfad dann aus dem Befehlsprotokoll kopieren.

Der Ergebnisse-App-Pfad im Parameter FROM weist das folgende allgemeine Format auf:

FROM "results <-Regionskennung>/api/orgs/<Org-ID>/control_tests/<Kontrolltest-ID>/exceptions

Beispiel: FROM "results/api/orgs/11594/control_tests/4356/exceptions"

Die Org-ID wird in der Adressleiste des Browsers angezeigt, wenn Sie sich an Launchpad anmelden. Die Kontrolltest-ID und die Interpretations-ID sehen Sie in der Adressleiste, sobald Sie diese Tabellen in der Ergebnisse-App anzeigen.

Die folgende Tabelle enthält alle Varianten des Ergebnisse-App-Pfads.

Für den Import: Verwenden Sie dieses Format des Ergebnisse-App-Pfads:
Kontrolltestdaten (Tabelle) FROM "results/api/orgs/11594/control_tests/4356/exceptions"
Kontrolltestdaten (Tabelle) Prüfungspfad FROM "results/api/orgs/11594/control_tests/4356/audit_trail"
Kontrolltestdaten (Tabelle) Kommentare FROM "results/api/orgs/11594/control_tests/4356/comments"
Interpretation FROM "results/api/orgs/11594/control_tests/4356/interpretations/1192/exceptions"
Daten aus einer HighBond-Region, die von der Standardregion (us) abweicht
  • Asien/Pazifik FROM "results-ap/api/orgs/11594/control_tests/4356/exceptions"
  • Australien FROM "results-au/api/orgs/11594/control_tests/4356/exceptions"
  • Kanada FROM "results-ca/api/orgs/11594/control_tests/4356/exceptions"
  • Europa FROM "results-eu/api/orgs/11594/control_tests/4356/exceptions"

Systemerstellte Informationsspalten

Wenn Sie Daten aus der Ergebnisse-App importieren, haben Sie die Option, auch eine oder mehrere der unten aufgelisteten systemerstellten Informationsspalten zu importieren.

Vom System generierte Spalten sind entweder

  • ein Bestandteil der Ergebnisse-App-Tabellen und beinhalten Verarbeitungsinformationen in Bezug auf einzelne Datensätze oder
  • zusätzliche Informationen wie Sammlungsname, Tabellenname oder Datensatzkennung

Sie müssen die Feldnamen der systemerstellten Spalten genau wie unten dargestellt angeben. Es gelten die Standardanzeigenamen, wenn Sie aus der Ergebnisse-App über die Analytics-Benutzeroberfläche importieren. Wenn Sie den Importvorgang über ein Skript durchführen, können Sie die Anzeigenamen abändern.

Feldname

Standardanzeigename

metadata.priority

Priorität

metadata.status

Status

metadata.publish_date

Veröffentlicht

metadata.publisher

Name des Herausgebers

metadata.assignee

Empfänger
metadata.group Gruppe
metadata.updated_at Aktualisiert
metadata.closed_at Geschlossen
extras.collection Sammlung
extras.results_table Ergebnistabelle
extras.record_id Datensatz-ID

Überlegungen zu Feldnamen beim Importieren und Exportieren von Daten aus Ergebnisse

Wenn Sie einen Daten-Roundtrip zwischen der Ergebnisse-App und Analytics durchführen, müssen Sie sicherstellen, dass alle Feldnamen der Tabelle in der Ergebnisse-App die strikteren Anforderungen für Analytics-Feldnamen erfüllen. Ansonsten riskieren Sie eine fehlerhafte Ausrichtung der Daten von Analytics und der Ergebnisse-App.

Alle Sonderzeichen in Feldnamen der Ergebnisse-App werden beispielsweise automatisch in Unterstriche konvertiert, wenn sie in Analytics importiert werden. Aus diesem Grund entsprechen die Feldnamen dann nicht mehr den ursprünglichen Namen in der Ergebnisse-App. Wenn Sie die Analytics-Daten zurück in die Originaltabelle in die Ergebnisse-App exportieren, stimmen die Felder nicht mehr korrekt überein.

Um dieses Problem mit beabsichtigten Roundtrip-Daten zu vermeiden, stellen Sie sicher, dass die Analytics-Anforderungen an Feldnamen erfüllt sind, bevor Sie Daten aus CSV- oder Excel-Dateien in die Ergebnisse-App hochladen.

  • keine Sonderzeichen oder Leerzeichen
  • beginnt nicht mit einer Zahl
  • beinhaltet lediglich alphanumerische Zeichen oder den Unterstrich ( _ )

Eine Kennwortdefinition erstellen und ein Kennwort festlegen

PASSWORD-Befehl

Wenn Sie den PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung mit HighBond anzulegen, wird kein Wert für das Kennwort spezifiziert. Deshalb wird eine Kennwortaufforderung angezeigt, wenn ein Skript versucht, eine Verbindung aufzunehmen.

Weitere Informationen finden Sie unter PASSWORD-Befehl.

SET-PASSWORD-Befehl

Wenn Sie den SET-PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung mit HighBond anzulegen, wird ein Wert für das Kennwort spezifiziert und somit keine Kennwortaufforderung angezeigt. Dies eignet sich für Skripts, die unbeaufsichtigt ablaufen sollen.

Weitere Informationen finden Sie unter SET-PASSWORD-Befehl.

HighBond-Zugriffstoken beschaffen

Unabhängig von Ihrer verwendeten Vorgehensweise bei der Festlegung eines Kennworts handelt es sich bei dem erforderlichen Kennwortwert um einen HighBond-Zugriffstoken, den Benutzer in Launchpad erstellen können:

Achtung

Das erstellte Zugriffstoken entspricht dem Konto, das zur Anmeldung an Launchpad verwendet wurde. Es empfiehlt sich unter Umständen nicht, als Skriptautor in einem Skript Ihr eigenes Zugriffstoken festzulegen, wenn das Skript durch andere Personen benutzt wird.

  1. Führen Sie einen der folgenden Schritte aus:
    • Wählen Sie aus dem Analytics-Hauptmenü Extras > HighBond-Zugriffstoken
    • Im Skript-Editor klicken Sie mit der rechten Maustaste und wählen Einfügen > HighBond-Token.

    Die Seite API-Token verwalten wird in Ihrem Browser geöffnet. Möglicherweise müssen Sie sich zuerst am Launchpad anmelden.

  2. Führen Sie einen der folgenden Schritte aus:
    • Bestehenden Token verwenden In der Spalte Token klicken Sie auf den teilweise verborgenen Token, den Sie verwenden möchten. Geben Sie Ihr HighBond-Kontokennwort ein. Der Token wird nicht verborgen angezeigt.

      Tipp

      Verwenden Sie einen bereits bestehenden Token, solange es keinen Grund gibt, einen neuen zu erstellen. Erstellen Sie einen neuen Token, falls der existierende Token nicht funktioniert.

      Wenn Sie bestehende Token verwenden, müssen Sie eine geringere Anzahl von Token verwalten.

    • Neuen Token erstellen Klicken Sie auf Token erstellen > Analytics, und geben Sie Ihr HighBond-Kontokennwort ein.

      Ein neuer Analytics-Token wird erstellt.

      Hinweis

      Wenn Sie ein Launchpad-Systemadministrator sind, können Sie auch einen API-Token erstellen. Sie sollten API-Tokens für ihren beabsichtigten Zweck reservieren, also einen programmatischen Zugriff auf die HighBond-Plattform.

  3. Klicken Sie auf Kopieren, um den Token zu kopieren.

    Tipp

    Schließen Sie das Dialogfeld mit dem Token nicht, bevor Sie den Token erfolgreich eingefügt haben.

  4. Führen Sie einen der folgenden Schritte in Analytics aus:
    • Fügen Sie den Token in die Kennwort-Eingabeaufforderung ein.
    • Fügen Sie den Token in die SET-PASSWORD-Befehlssyntax an der geeigneten Stelle des Skripts ein.
  5. Schließen Sie in Launchpad das Dialogfeld mit dem Token.

    Nachdem Sie einen neuen Token erstellt haben, wird eine teilweise verborgene Version des Tokens am Anfang Ihrer Tokenliste hinzugefügt.

    Weitere Informationen finden Sie unter Zugriffstoken erstellen und verwalten.

Debugfunktion für Importe

Für Importe aus HighBond gibt es eine einfache Debugfunktion.

Die importierten Daten werden vorübergehend in einer JSON-Zwischendatei im Ordner gespeichert, der das Analytics-Projekt enthält. In jedem Ordner mit einem Analytics-Projekt können Sie eine Textdatei erstellen, die sicherstellt, dass die JSON-Datei beibehalten und nicht nach dem Datenimport in Analytics gelöscht wird.

  • JSON-Datei ist vorhanden Wenn der Import aus HighBond scheitert, die JSON-Datei jedoch auf Ihrem Computer vorhanden ist, wissen Sie, dass das Problem bei Analytics und nicht bei HighBond zu suchen ist.
  • JSON-Datei ist nicht vorhanden Wenn der Import aus HighBond scheitert und die JSON-Datei auf Ihrem Computer nicht vorhanden ist, wissen Sie, dass das Problem bei HighBond zu suchen ist.

Diese Informationen können Ihnen bei der Fehlersuche helfen.

Aufbewahrung der JSON-Zwischendatei konfigurieren

Erstellen Sie im Ordner, der das Analytics-Zielprojekt enthält, eine leere Textdatei mit diesem Namen: _grc_import_debug.txt

Wenn Sie aus der Ergebnisse- oder Projekte-App in HighBond importieren, wird die JSON-Zwischendatei mit dem Namen results.json beibehalten. Durch jeden späteren Import aus HighBond wird die Datei überschrieben.

Große Tabellen importieren

Tabellen mit vielen Feldern werden mit einem einzelnen IMPORT-GRCRESULTS-Befehl unter Umständen nicht erfolgreich importiert. Wenn Sie mit einer einzelnen Tabelle mit vielen Feldern außerhalb der Ergebnisse-App arbeiten müssen, verwenden Sie einen der folgenden Ansätze:

  • Tabelle aufteilen Verwenden Sie zwei oder mehr IMPORT-GRCRESULTS-Befehle, um eine Teilmenge der Felder zu importieren. Führen Sie dann die entstehenden Tabellen in Analytics mit dem JOIN-Befehl zusammen.
  • Tabelle in Datei exportieren Exportieren Sie die Tabelle im CSV-Format und importieren Sie die entstehende Datei dann mit dem Befehl IMPORT DELIMITED in Analytics.