IMPORT-GRCPROJECT-Befehl

Konzept-Informationen

Diligent One-Projektdaten importieren

Erstellt eine Analytics-Tabelle, indem eine Tabelle aus der Projekte-App von Diligent One importiert wird.

Syntax

IMPORT GRCPROJECT TO Tabelle Importdateiname PASSWORD Zahl FROM Org_ID/Typ_ID <FIELD Name AS Anzeigename <...n>> <CHARMAX max_Feldlänge>

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

Abhängig von der Umgebung, in der das Skript ausgeführt wird, kann PASSWORD Zahl notwendig sein oder auch nicht.

Umgebung, in der das Skript ausgeführt wird Anforderung PASSWORD Zahl
Analytics

(Online-Aktivierung)

PASSWORD Zahl ist nicht erforderlich.

Es wird automatisch der HighBond-Zugriffstoken des aktuellen Benutzers verwendet, der in der Windows-Registrierung gespeichert ist.
Analytics

(Offline-Aktivierung)

PASSWORD Zahl ist erforderlich.
Robots

FROM Org_ID/Typ_ID

Die Organisation und der Informationstyp, durch die zu importierende Daten definiert werden:

  • Org_ID Die Diligent One-Organisation, von der Sie Daten importierenDiligent One
  • Typ_ID Der Typ der Informationen, die Sie importieren

Die Org_ID- und Typ_ID-Werte müssen durch einen Schrägstrich ohne Leerzeichen getrennt werden:

FROM "125@-eu/audits"

Die gesamte Zeichenfolge muss in Anführungszeichen gesetzt werden.

Organisations-ID

Org_ID muss die Organisations-ID und, falls Sie aus einem Rechenzentrum außerhalb Nordamerikas (US) importieren, auch den Rechenzentrum-Code enthalten. Die Organisations-ID und der Rechenzentrum-Code müssen durch das @-Zeichen und einen Bindestrich (-) getrennt werden:

FROM "125@-eu"

Hinweis

Wenn Sie den Rechenzentrum-Code für Nordamerika (US) festlegen, verwendet dieser ein leicht unterschiedliches Format ohne Bindestrich:

FROM "125@us"

Der Rechenzentrum-Code gibt den regionalen Diligent One-Server an, aus dem Sie Daten importieren.

  • af – Afrika (Südafrika)
  • ap – Asien-Pazifik (Singapur)
  • au – Asien-Pazifik (Australien)
  • ca – Nordamerika (Kanada)
  • eu – Europa (Deutschland)
  • jp – Asien-Pazifik (Tokio)
  • sa – Südamerika (Brasilien)
  • us – Nordamerika (USA)

Sie können nur den Rechenzentrum-Code oder die Codes angeben, die für die Diligent One-Instanz Ihrer Organisation gestattet sind. Das Nordamerika-Rechenzentrum (US) ist die Standardeinstellung. Deshalb ist die Angabe von @us optional.

Wenn Sie die Organisations-ID nicht kennen, verwenden Sie die Analytics-Benutzeroberfläche, um eine Tabelle aus der Projekte-App zu importieren. Die Organisations-ID ist innerhalb des Befehls im Protokoll enthalten. Weitere Informationen finden Sie unter Diligent One-Projektdaten importieren.

Typ-ID

Typ_ID legt den importierten Informationstyp fest. Informationen in der Projekte-App befinden sich in einer Reihe verbundener Tabellen.

Verwenden Sie für Typ_ID einen der folgenden Werte. Geben Sie den Wert genauso ein, wie er angezeigt ist. Dies beinhaltet den Unterstrich:

  • audits - Projekte
  • control_test_plans - Kontrolltestpläne
  • control_tests - Kontrolltest
  • controls - Kontrollen
  • finding_actions - Aktionen
  • findings - Probleme
  • mitigations - Risikokontrollzuordnungen
  • narratives - Schilderungen
  • objectives- Ziele
  • risks - Risiken
  • walkthroughs - exemplarische Vorgehensweisen

Tipp

Informationen, wie die Tabellen in der Projekte-App verbunden werden, und Angaben über die Schlüsselfelder, die Sie zur Zusammenführung von Tabellen nach ihrem Import in Analytics verwenden können, finden Sie unter Diligent One-Projektdaten importieren.ProjectsAnalytics
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 muss dem physischen Feldnamen in der Projekte-App-Tabelle genau entsprechen, was die Groß-/Kleinschreibung einbezieht.Projects
  • 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.

Tipp

Um die physischen Feldnamen zu erhalten, verwenden Sie die Analytics-Benutzeroberfläche für einen Import der jeweiligen Tabelle aus der Projekte-App. Die physischen Feldnamen sind innerhalb des Befehls im Protokoll angegeben.

Spätere Importvorgänge können als Skript durchgeführt werden.
CHARMAX maximale_Feldlänge

Optional

Die maximale Länge in Zeichen für jedes Feld in der Analytics-Tabelle, dessen Ursprung Zeichendaten in der Projekttabelle sind.

Daten in der Projekttabelle, die die maximale Feldlänge übersteigen, werden beim Import in Analytics abgeschnitten.

Durch die Fähigkeit, Felder abzukürzen, wird verhindert, dass die Gesamt-Datensatzlänge aufgrund langer Werte die vom Importprozess unterstützten Werte überschreitet:

  • 32.767 Zeichen (Nicht-Unicode-Analytics)

  • 16.383 Zeichen (Unicode-Analytics)

Beispiele

Angegebene Felder aus der Projekte-App-Tabelle importieren

Sie importieren die spezifischen Felder aus der Projekte-App-Tabelle für alle aktiven Projekte, die zur Organisation 286 (US-Region) gehören. Importiert werden sie in eine Analytics-Tabelle namens Alle_Projekte:Analytics

IMPORT GRCPROJECT TO Alle_Projekte "C:\HighBond-Projektdaten\Alle_Projekte.fil" FROM "286@us/audits" FIELD "id" AS "Id" FIELD "description" AS "Beschreibung" FIELD "name" AS "Name" FIELD "start_date" AS "Startdatum" FIELD "status" AS "Status" FIELD "created_at" AS "Erstellt am"

Alle Felder aus der Projekte-App-Tabelle importieren

Sie importieren alle Felder aus der Projekte-App-Tabelle für alle aktiven Projekte, die zur Organisation 286 (US-Region) gehören. Importiert werden sie in eine Analytics-Tabelle namens Alle_Projekte. Zur Authentifizierung der Verbindung schließen Sie eine nummerierte Kennwortdefinition ein.

IMPORT GRCPROJECT TO Alle_Projekte "C:\HighBond-Projektdaten\Alle_Projekte.fil" PASSWORD 1 FROM "286@us/audits"

Feldlänge beim Import aus der Projekttabelle begrenzen

Sie importieren alle Felder aus der Projekte-Tabelle in eine Analytics-Tabelle namens Alle_Projekte. Sie begrenzen die Feldlänge mit dem CHARMAX-Parameter.

IMPORT GRCPROJECT TO Alle_Projekte "C:\HighBond-Projektdaten\Alle_Projekte.fil" PASSWORD 1 FROM "286@us/audits" CHARMAX 200

In der resultierenden Analytics-Tabelle werden alle Felder, die als Zeichendaten aus „Projekte“ stammen, auf die angegebene Länge von 200 Zeichen begrenzt. Alle Feldwerte, die das Limit überschreiten, werden auf 200 Zeichen abgekürzt.

Alle Felder aus der Problemtabelle importieren

Sie importieren alle Felder aus der Problemtabelle für alle aktiven Projekte, die zur Organisation 11594 (europäische Region) gehören. Importiert werden sie in eine Analytics-Tabelle namens Alle_Probleme:Analytics

IMPORT GRCPROJECT TO Alle_Probleme "C:\HighBond-Projektdaten\Alle_Probleme.fil" FROM „11594@-eu/findings"

Bemerkungen

Weitere Informationen über die Funktionsweise dieses Befehls finden Sie unter Diligent One-Projektdaten importieren.

Eine Kennwortdefinition erstellen und ein Kennwort festlegen

Wenn Sie ein Skript in Robots ausführen, das eine Diligent One-Projekttabelle importiert, müssen Sie eine Kennwortdefinition in den IMPORT GRCPROJECT-Befehl aufnehmen. Dieselbe Anforderung gilt auch für Skripts, die in Analytics ausgeführt werden, wenn Sie die Offline-Aktivierung verwendet haben.

Unabhängig von Ihrer verwendeten Methode beim Erstellen einer Kennwortdefinition handelt es sich bei dem erforderlichen Kennwortwert um einen HighBond-Zugriffstoken, den Sie in Launchpad erstellen können. Weitere Informationen finden Sie unter HighBond-Zugriffstoken beschaffen.

Kennwortdefinitionsmethoden

Methode Beschreibung

PASSWORD-Analysetag

(Für Skripts, die in Robots ausgeführt werden)

Wenn Sie das PASSWORD-Analysetag verwenden, um die nummerierte Kennwortdefinition für die Verbindung zu Diligent One anzulegen, wird kein Wert für das Kennwort im Skript angegeben. Beim Erstellen einer Aufgabe zur Ausführung des Skripts in Robots können Sie oder andere Benutzer in einem Eingabefeld im Aufgaben-Designer das tatsächliche Kennwort angeben.

Weitere Informationen finden Sie unter PASSWORD-Analysetag.

PASSWORD-Befehl

(Für Skripts, die in Analytics ausgeführt werden, Offline-Aktivierung)

Wenn Sie den PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung zu Diligent One anzulegen, wird kein Wert für das Kennwort im Skript angegeben. Beim Herstellen der Skriptverbindung wird eine Aufforderung zur Eingabe des Kennworts angezeigt.

Weitere Informationen finden Sie unter PASSWORD-Befehl.

SET PASSWORD-Befehl

(Für Skripts, die in Analytics ausgeführt werden, Offline-Aktivierung)

Wenn Sie den SET PASSWORD-Befehl verwenden, um die nummerierte Kennwortdefinition für die Verbindung mit Diligent One anzulegen, wird ein Wert für das Kennwort im Skript angegeben. Deshalb wird keine Kennwortaufforderung angezeigt. Dieser Ansatz eignet sich für Skripts, die ohne Benutzereingriff ausgeführt werden sollen, stellt aber ein echtes Kennwort in Klartext im Skript dar. Je nach Situation kann das ungeeignet sein.

Weitere Informationen finden Sie unter SET-PASSWORD-Befehl.

HighBond-Zugriffstoken beschaffen

Achtung

Der generierte Zugriffstoken entspricht dem Konto, das zur Anmeldung bei Diligent One verwendet wurde. Es empfiehlt sich unter Umständen nicht, als Skriptautor in einem Skript Ihren eigenen Zugriffstoken festzulegen, wenn das Skript durch andere Personen benutzt wird.

Schützen Sie Zugriffstoken genauso wie Ihr Kontokennwort.

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.

  1. Führen Sie einen der folgenden Schritte aus:

    • Wählen Sie aus dem Analytics-Hauptmenü Extras > HighBond-Zugriffstoken.AnalyticsHighBond Access Token

    • Im Skript-Editor klicken Sie mit der rechten Maustaste und wählen Einfügen > HighBond-Token.HighBond Token

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

    Sie können ganz einfach über Analytics auf die Seite API-Token verwalten zugreifen. Sie können sich aber auch ohne Analytics über Ihr Benutzerprofil bei Diligent One anmelden und die Seite aufrufen.

  2. Führen Sie einen der folgenden Schritte aus:

    • Bestehenden Token verwenden

      1. Klicken Sie in der Spalte Token auf die teilweise verborgene Version des gewünschten Tokens.

      2. Geben Sie Ihr Diligent One-Kennwort ein und klicken Sie auf Bestätigen.Diligent One

        Der Token wird nicht verborgen angezeigt.

      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.

    • Neuen Token erstellen

      1. Klicken Sie auf Token hinzufügen > Analytics.

      2. Geben Sie im Seitenbereich Neuer Analytics-Token die folgenden Informationen ein:

        Feld oder Option Beschreibung
        Beschreibung

        Geben Sie eine Beschreibung ein, die nützliche Informationen enthält, wie beispielsweise:

        • Der Zweck des Tokens
        • Wo der Token verwendet wird – zum Beispiel den Namen und Ort des Analytics-Skripts oder den Namen und Ort der Robot-Aufgabe
        Token-Ablauf
        • Aktiviert der Token läuft nach der von Ihnen angegebenen Anzahl von Tagen ab
        • Deaktiviert der Token läuft niemals ab

        Hinweis

        Möglicherweise gilt in Ihrer Organisation eine Sicherheitsrichtlinie, die verlangt, dass Token nach einer gewissen Zeitdauer ablaufen. Die Erstellung von Token mit einer Ablauffrist ist eine gute Praxis. Diligent One sendet Ihnen vor dem Ablaufdatum eine automatisierte E-Mail-Benachrichtigung.
        Läuft ab in Geben Sie die Anzahl der Tage an, bevor das Token abläuft (1 bis 365).
        Kennwort Geben Sie das Kennwort für Ihr Diligent One-Konto ein.

      3. Klicken Sie auf Token generieren.

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

        Tipp

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

  3. Führen Sie einen der folgenden Schritte aus, je nach Ihrer Kennwortdefinitionsmethode:

    • PASSWORD-Analysetag Fügen Sie im Aufgaben-Designer in einem ACL-Robot den kopierten Token in ein Kennwort-Parameterfeld ein.ACL robot

    • PASSWORD-Befehl Fügen Sie in Analytics den kopierten Token in eine Kennwortaufforderung ein, die bei der Skriptausführung angezeigt wird.Analytics

    • SET PASSWORD-Befehl Fügen Sie in Analytics den kopierten Token an der geeigneten Stelle des Skripts in der SET PASSWORD-Befehlssyntax ein.Analytics

  4. Schließen Sie in Launchpad das Dialogfeld oder den Seitenbereich 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 HighBond-Zugriffstoken erstellen und verwalten.HighBond access tokens

Debugfunktion für Importe

Für Importe aus Diligent One 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 Diligent One scheitert, die JSON-Datei jedoch auf Ihrem Computer vorhanden ist, wissen Sie, dass das Problem bei Analytics und nicht bei Diligent One zu suchen ist.Diligent OneAnalyticsDiligent One
  • JSON-Datei ist nicht vorhanden Wenn der Import aus Diligent One scheitert und die JSON-Datei auf Ihrem Computer nicht vorhanden ist, wissen Sie, dass das Problem bei Diligent One zu suchen ist.Diligent OneDiligent One

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

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