Daten aus der Diligent One-Ergebnisse-App importieren

Konzept-Informationen

IMPORT-GRCRESULTS-Befehl

Sie können eine Analytics-Tabelle erstellen, indem Sie Daten aus Sammlungen importieren, für die Sie Berechtigungen in der Diligent One-Ergebnisse-App aufweisen. Sie können Datentabellen und Interpretationen aus einzelnen Kontrolltests importieren.

Hinweis

In der Ergebnisse-App wird ein Kontrolltest als „Datenanalyse“ bezeichnet.

Nutzungsmöglichkeit der Informationen

Durch die Möglichkeit, aus der Ergebnisse-App in Analytics zu importieren, können Sie für Ausnahmen Zweit- oder Folgeanalysen durchführen. Nach Durchführung der Analyse können Sie die Daten wieder zur Verwendung in die Ergebnisse-App zurückexportieren. Weitere Informationen finden Sie unter Ausnahmen in die Ergebnisse-App in Diligent One exportieren.

Überlegungen zu Feldnamen, wenn Daten aus der Ergebnisse-App ausgetauscht und wieder importiert werden sollen

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 der 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 ( _ )

Einschränkungen der Datensatzlänge

Die maximale Datensatzlänge, die Sie in Analytics importieren können, beträgt 32.767 Zeichen bzw. 16.383 Unicode-Zeichen.

Wenn Sie versuchen, Daten aus Ergebnisse zu importieren, die den Maximalwert überschreiten, wird eine Fehlermeldung angezeigt und der Import schlägt fehl. Versuchen Sie, große Felder mit Schilderungen aus dem Import zu entfernen, um die Datensatzlänge zu verringern.

Sie können den Import auch mit dem Befehl IMPORT GRCRESULTS in der Analytics-Befehlszeile ausführen. Beim Verwenden des Befehls können Sie auch den CHARMAX-Parameter angeben und damit eine Höchstanzahl an Zeichen in jedem importierten Feld festlegen. Weitere Informationen finden Sie unter IMPORT-GRCRESULTS-Befehl.

Schritte

Hinweis

Unter Umständen müssen Sie zur Verbindung mit Diligent One ein Kennwort eingeben. Weitere Informationen finden Sie unter Kennwortanforderung.

  1. Wählen Sie Importieren > HighBond > Ergebnisse.HighBond
  2. Im Dialogfeld Zu importierende Daten auswählen doppelklicken Sie auf den Organisationsordner.
  3. Navigieren Sie zum entsprechenden Kontrolltest.

    Hinweis

    Sie haben keine ausreichenden Berechtigungen für den Zugriff auf die Daten, falls

    • die Sammlung, die den Kontrolltest enthält, nicht angezeigt wird
    • die Meldung Fehler beim Abrufen der Interpretationsliste angezeigt wird, wenn Sie versuchen, auf den Kontrolltest zuzugreifen.

    Weitere Informationen finden Sie unter Rollen und Berechtigungen in der Ergebnisse-App zuweisen.

    Wenn Sie Hilfe zu Berechtigungen benötigen, wenden Sie sich an den Diligent One-Kontoadministrator oder den Ergebnisse-App-Administrator in Ihrem Unternehmen.

  4. Wählen Sie eine der folgenden Tabellen aus, die Sie in Analytics importieren möchten:
    • eine Interpretation, falls vorhanden
    • Prüfpfad
    • Anmerkungen
    • Ergebnistabelle (doppelklicken Sie auf den Ordner Auswahl der Tabellenfelder)

    Hinweis

    Es kann jeweils nur eine Tabelle gleichzeitig in Analytics importiert werden.

    Tipp

    Sie können die Ergebnistabelle, den Prüfungspfad und die Anmerkungen in Analytics mit „Datensatz-ID“ als Schlüsselfeld zusammenführen. Verwenden Sie die Ergebnistabelle in der Zusammenführung als Primärtabelle.

  5. Wenn Sie die Ergebnistabelle importieren, wählen Sie die einzelnen Felder, die Sie importieren möchten, aus den folgenden Kategorien aus:
    • Metadaten Felder mit Workflow-Informationen, die durch den Benutzer oder das System erstellt wurden
    • Extras Namen von Sammlungen und Kontrolltests sowie die Datensatz-ID.

      Achten Sie darauf, die Datensatz-ID auszuwählen, wenn Sie die Ergebnistabelle in Analytics zusammenführen möchten.

    • Daten Felder mit Daten, die in die Ergebnisse-App importiert wurden, oder Antworten auf einen Ergebnisse-App-Fragebogen.
    • Alle wählen Die gesamte Tabelle wird importiert.
  6. Klicken Sie auf OK.

    Die Daten werden aus der Ergebnisse-App importiert.

  7. Geben Sie im Dialogfeld Datei speichern unter einen Dateinamen und gegebenenfalls einen anderen Speicherort für die Analytics-Datendatei an, und klicken Sie auf Speichern.Analytics
  8. Geben Sie einen Namen für die Analytics-Tabelle ein, die Sie dem Projekt hinzufügen, oder behalten Sie den Standardnamen bei und klicken auf OK.AnalyticsAnalytics

    Hinweis

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

Kennwortanforderung

Kennwort nicht erforderlich

Sie müssen kein Kennwort für einen Import aus Diligent One festlegen, falls Sie zur Aktivierung Ihrer Analytics-Kopie die Online-Aktivierung verwendet haben. Das Kennwort wird automatisch erstellt und an Diligent One auf Basis der Aktivierungsinformationen geschickt, die auf Ihrem Computer gespeichert sind.

Passwort erforderlich

In den folgenden Situationen müssen Sie ein Kennwort für den Import aus Diligent One angeben:

  • Sie haben Ihre Analytics-Kopie mit der Offline-Aktivierung aktiviert.

  • Sie importieren Daten über ein Skript aus Diligent One und führen das Skript in Robots aus.

Das benötigte Kennwort ist ein HighBond-Zugriffstoken.

HighBond-Zugriffstoken beschaffen

Achtung

Schützen Sie Ihren Zugriffstoken genauso wie Ihr Kontokennwort. Es enthält Informationen, die Ihr Diligent One-Konto eindeutig identifizieren. Sie sollten Zugriffstoken nicht teilen.

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 Datenzugriffs- und Kennwortdefinitionsmethode:

    Benutzeroberfläche von Analytics

    Fügen Sie den kopierten Token in eine Kennwortaufforderung ein, die angezeigt wird, wenn Sie manuell auf Diligent One zugreifen.

    Analyseskript

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

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

  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