Ausnahmen in die Ergebnisse-App in Diligent One exportieren

Konzept-Informationen

EXPORT-Befehl

Als Diligent One-Benutzer können Sie Ausnahmedaten in einer Analytics-Tabelle in eine Tabelle der Ergebnisse-App exportieren. Für den Export von Ausnahmen verwenden Sie die übliche Vorgehensweise für den Export von Daten in Analytics, wobei einige kleine Abweichungen bestehen.

Die Ergebnisse-App ist eine App, mit der Sie Beilegungen und den Workflow automatisieren können. Die App verwaltet Ausnahmedaten, fügt über Fragebögen menschlichen Kontext hinzu und sorgt mit Triggern und Metriken, dass eine kontinuierliche Überwachung möglich ist. Weitere Informationen finden Sie unter Mit Daten in der Ergebnisse-App arbeiten.

Sicherheitsvorgaben

Um Ausnahmedaten in einen Kontrolltest in der Ergebnisse-App exportieren zu können, muss eine spezifische Diligent One-Rollenzuweisungen in oder Administrationsberechtigungen vorhanden sein:

  • Benutzer, die für eine Ergebnisse-App-Sammlung die Rolle „Fachmanager“ oder „Fachbenutzer“ aufweisen, können Ergebnisse in die Kontrolltests der Sammlung exportieren.

    Hinweis

    Nur Benutzer mit der Rolle „Fachmanager“ können bestehende Daten eines Kontrolltests überschreiben.

  • Diligent One-Kontoadministratoren und Ergebnisse-App-Administratoren erhalten in den Diligent One-Instanzen, die sie administrieren, automatisch für alle Sammlungen die Rolle „Fachmanager“.

Weitere Informationen finden Sie unter Berechtigungen der Ergebnisse-App.

Exportlimits

Wenn Sie in einen Kontrolltest in der Ergebnisse-App exportieren, gelten die folgenden Beschränkungen.

Innerhalb dieser Grenzen können Sie Exporte mehrfach in denselben Kontrolltest durchführen. Falls in dem Kontrolltest bereits Daten vorliegen, können diese entweder mit den neuen Daten überschrieben oder daran angehängt werden.

Hinweis

Obwohl Sie bis zu 100.000 Datensätze in einen Kontrolltest exportieren können, wäre es besser, kleinere und somit konkretere Ausnahmemengen zu erstellen.

Element Maximum
Datensätze pro Exportvorgang 100.000
Datensätze pro Kontrolltest 100.000
Felder pro Datensatz 500
Zeichen pro Feld 256

Ausrichtung von Feldern zwischen Analytics und der Ergebnisse-App beibehalten

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

Hinweis

Wenn Sie Daten an Fragebogenfelder anhängen, bleibt der Anzeigename der Spalte in der Ergebnisse-App der Name, der in der Konfiguration des Fragebogens festgelegt wurde. Das gilt selbst dann, wenn Sie den Anzeigenamen in Analytics geändert haben.

Überschreibungsoption und Primärschlüssel in der Ergebnisse-App

Wenn Sie Ausnahmedaten aus Analytics in eine bestehende Ergebnisse-App-Tabelle exportieren, haben Sie die Option, die exportierten Daten an die Tabelle anzuhängen oder die Tabelle komplett zu überschreiben.

Wenn in der Ergebnisse-App-Tabelle ein Feld als Primärschlüssel festgelegt wurde und die Daten, die Sie exportieren, ein entsprechendes Feld enthalten, unterscheidet sich das Exportverhalten ein wenig. (Weitere Informationen über das Festlegen eines Primärschlüssels in der Ergebnisse-App finden Sie unter Primärschlüssel festlegen.)

Die unterschiedlichen Möglichkeiten werden unten zusammengefasst.

  Kein Primärschlüssel in der Ergebnisse-App Primärschlüssel in der Ergebnisse-App
Option Überschreiben nicht ausgewählt Exportierte Daten werden an die bestehende Ergebnisse-App-Tabelle angehängt.
  • übereinstimmender Wert Wenn im Primärschlüsselfeld der Ergebnisse-App und im entsprechenden exportierten Analytics-Feld ein Wert übereinstimmt, wird der Datensatz in der Ergebnisse-App mit den bestehenden Werten des exportierten Datensatzes aktualisiert.ResultsAnalyticsResults
  • kein übereinstimmender Wert Wenn im Primärschlüsselfeld der Ergebnisse-App und im entsprechenden exportierten Analytics-Feld kein Wert übereinstimmt, wird der Datensatz in der Ergebnisse-App nicht aktualisiert und der exportierte Datensatz wird an die Tabelle angehängt.ResultsAnalyticsResults
Option Überschreiben ausgewählt Exportierte Daten ersetzen (überschreiben) die bestehende Ergebnisse-App-Tabelle. Exportierte Daten ersetzen (überschreiben) die bestehende Ergebnisse-App-Tabelle.

Ausnahmen in die Ergebnisse-App exportieren

Hinweis

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

Zu exportierende Felder festlegen

  1. Öffnen Sie die Tabelle mit den Ausnahmedaten, die Sie exportieren möchten.
  2. Wählen Sie Daten > Exportieren.
  3. Wählen Sie auf der Registerkarte Haupt eines der folgenden Elemente:
    • Felder Legen Sie fest, welche Felder Sie exportieren möchten.

      Wenn Sie diese Option wählen, werden die Felder mit den physischen Feldnamen im Tabellenlayout exportiert.

      Informationen über das Umbenennen von Feldern finden Sie unter Feld in Tabellenlayout umbenennen.

    • Ansicht Alle Felder der aktuellen Ansicht exportieren

      Wenn Sie diese Option wählen, werden die Felder mit den Anzeigenamen der Spalten exportiert. Die Felder werden in derselben Reihenfolge exportiert, in der sie in der Ansicht erscheinen.

      Informationen über das Umbenennen von Spalten finden Sie unter Spalten einer Ansicht umbenennen.

  4. Falls Sie Felder gewählt haben, treffen Sie eine Auswahl aus den folgenden Möglichkeiten:
    • Wählen Sie die zu exportierenden Felder in der Liste Felder exportieren aus.

      Tipp

      Sie können mehrere, nicht angrenzende Felder auswählen, indem Sie die Steuerungstaste gedrückt halten und auf die betreffenden Felder klicken. Halten Sie die Umschalttaste gedrückt, und klicken Sie auf angrenzende Felder, um diese auszuwählen.

    • Klicken Sie auf Felder exportieren, um die Felder auszuwählen oder einen Ausdruck zu erstellen.

Exportoptionen wählen

  1. Wählen Sie in der Dropdown-Liste Exportieren als den Eintrag HighBond aus.HighBond
  2. Führen Sie einen der folgenden Schritte aus:
    • An Ergebnisse-App-Tabelle anhängen

      Wenn Sie die exportierten Daten an die bestehende Tabelle in der Ergebnisse-App anhängen möchten, wählen Sie Überschreiben nicht aus.

      Hinweis

      Analytics-Felder können nur an vorhandene Ergebnisfelder angehängt werden, wenn sie übereinstimmende physische Feldnamen haben, unabhängig von ihrem Anzeigenamen in einer der beiden Anwendungen. In Analytics handelt es sich beim physischen Feldnamen um den Namen im Tabellenlayout.

      Die Reihenfolge der Felder innerhalb der beiden Anwendungen wirkt sich nicht auf den Abgleich der Feldnamen aus.

      Exportierte Felder mit physischen Namen, die nicht mit dem physischen Namen eines Feldes in der Ergebnisse-App-Tabelle übereinstimmen, führen zur Erstellung neuer Spalten in der Tabelle.

    • Ergebnisse-App-Tabelle ersetzen (überschreiben)

      Wenn Sie die bestehende Tabelle in der Ergebnisse-App ersetzen möchten, wählen Sie Überschreiben aus.

    Weitere Informationen finden Sie unter Überschreibungsoption und Primärschlüssel in der Ergebnisse-App.

  3. (Optional) Wenn Sie Spaltenanzeigenamen in die Ergebnisse-App exportieren möchten, wählen Sie Feldanzeigename einfügen.

    Wenn Sie diese Option wählen, wird der Anzeigename und der physische Name der Spalte in der Ergebnisse-App an den Namen in Analytics angeglichen.

    Wenn Sie Feldanzeigename einfügen nicht auswählen, hängt das Ergebnis davon ab, ob Sie nach Feldern oder nach Ansicht exportieren:

     Felder exportierenAnsicht exportieren
    Feldanzeigename einfügen ausgewähltFeldname in der Ergebnisse-App entspricht dem Feldnamen von Analytics. Anzeigename in der Ergebnisse-App entspricht dem Anzeigenamen von Analytics.
    Feldanzeigename einfügen nicht ausgewähltFeldname und Anzeigename in der Ergebnisse-App entsprechen dem Feldnamen von Analytics.

    Feldname und Anzeigename in der Ergebnisse-App entsprechen dem Feldnamen von Analytics.

    Hinweis

    Wählen Sie nicht Feldanzeigename einfügen, wenn Sie eine Ansicht an eine Ergebnisse-App-Tabelle anhängen, die Sie anfänglich durch Exportieren einer Ansicht aus einer Analytics-Version älter als 14.1 erstellt haben. In diesem Fall werden möglicherweise Spalten mit unterschiedlichen Feldnamen als die Namen in die Ergebnisse-App exportiert. Dadurch werden neue Spalten in der Ergebnisse-App erstellt und die Daten zwischen den Anwendungen werden falsch ausgerichtet.

Export fertigstellen

  1. Falls Einträge in der aktuellen Ansicht vorhanden sind, die Sie von der Verarbeitung ausschließen wollen, dann tragen Sie eine Bedingung in das Textfeld Wenn ein oder klicken Sie auf Wenn, um mittels Ausdruck-Generator eine IF-Anweisung zu erstellen.

    Hinweis

    Die Wenn-Bedingung wird nur für Datensätze ausgewertet, die nach Anwendung von Bereichsoptionen (Erste, Nächste, Solange) in einer Tabelle übrig sind.

    Die IF-Anweisung berücksichtigt alle Datensätze in der Ansicht und filtert diejenigen heraus, die der angegebenen Bedingung nicht entsprechen.

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

    Wenn Sie die Kennungsnummer der Tabelle kennen, in die Sie exportieren:

    Geben Sie die Nummer in das Textfeld Nach ein.

    • Geben Sie die Nummer ohne Anführungszeichen ein – zum Beispiel 99
      • .
    • Geben Sie nur die Nummer ein. Geben Sie keinen Dateinamen ein.
    • Wenn Sie nicht in das Rechenzentrum für Nordamerika (US) exportieren, müssen Sie auch den Rechenzentrum-Code angeben. Die Kontrolltest-ID und der Rechenzentrum-Code müssen durch das @-Zeichen getrennt werden – zum Beispiel 99@eu. Der Rechenzentrum-Code gibt den regionalen Diligent One-Server an, der als Ziel für den Datenexport bestimmt ist.

      • 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 Kennungsnummer der Tabelle nicht kennen, in den Sie exportieren, oder wenn Sie eine neue Tabelle erstellen möchten:

    1. Klicken Sie auf Nach und navigieren Sie im Dialogfeld Zieltest auswählen zum entsprechenden Analysenordner.
    2. Führen Sie einen der folgenden Schritte aus:
      • Wählen Sie eine bestehende Tabelle und klicken Sie auf OK.
      • Geben Sie einen Namen in das Feld Neue Datenanalyse ein und klicken Sie auf Erstellen.

      Sie kehren in das Dialogfeld Exportieren zurück und die Kontrolltest-ID sowie der Rechenzentrum-Code befinden sich im Textfeld Nach.

  3. Klicken Sie auf die Registerkarte Weiter.

  4. Wählen Sie im Bereich Abschnitt die entsprechende Option aus:

    • Alle
    • Erste
    • Nächste
    • Solange
    Umfangsoption Details
    Alle (Standard) Gibt an, dass alle Datensätze in der Ansicht verarbeitet sind.
    Erste Geben Sie eine Nummer in das Textfeld ein. Beginnt die Verarbeitung beim ersten Datensatz der Ansicht und bezieht nur die ausgewählte Anzahl von Datensätzen ein.
    Nächste Geben Sie eine Nummer in das Textfeld ein. Beginnt die Verarbeitung beim aktuell ausgewählten Datensatz der Ansicht und bezieht nur die ausgewählte Anzahl von Datensätzen ein. Es muss die tatsächliche Datensatznummer in der äußersten linken Spalte der Ansicht ausgewählt werden, nicht die Daten in der Zeile.
    Solange

    Begrenzen Sie die zu verarbeitenden Datensätze in der Ansicht mithilfe einer WHILE-Anweisung basierend auf einem Kriterium oder mehreren Kriterien.

    Geben Sie eine Bedingung in das Textfeld Solange ein oder klicken sie auf Solange klicken, um mit dem Ausdruck-Generator eine WHILE-Anweisung zu erstellen.

    Eine WHILE-Anweisung ermöglicht, Datensätzen in der Ansicht nur dann zu verarbeiten, wenn die angegebene Bedingung als wahr bewertet wird. Sobald die Bedingung als falsch bewertet wird, wird die Verarbeitung beendet und es werden keine weiteren Datensätze verarbeitet.

    Sie können die Option Solange in Verbindung mit den Optionen Alle, Erste oder Nächste verwenden. Die Datensatzverarbeitung endet, sobald eine Grenze erreicht wird.

    Hinweis

    Die Optionen Erste(r) oder Nächste(r) verweisen entweder auf die physische Reihenfolge oder auf die indizierte Reihenfolge der Datensätze in einer Tabelle. Erste(r) oder Nächste(r) ignorieren alle Filter oder Schnellsortierungen, die auf eine Tabellenansicht angewendet werden. Bei Ausgabeergebnissen analytischer Operationen wird die vorhandene Filterung jedoch berücksichtigt.

    Wenn eine Schnellsortierung für die Ansicht angewandt wird, verhält sich die Option Nächste wie Erste.

  5. Klicken Sie auf OK.

    Eine Statusanzeige erscheint, während die Ausnahmedaten in die Ergebnisse-App exportiert werden. Im Anschluss an den Export wird ein Eintrag im Protokoll erstellt.

Kennwortanforderung

Kennwort nicht erforderlich

Sie müssen kein Kennwort für einen Export in die Ergebnisse-App festlegen, falls Sie zur Aktivierung Ihrer Analytics-Kopie die Online-Aktivierung verwendet haben. Das Kennwort wird automatisch erstellt und an die Ergebnisse-App 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 Export zu Ergebnisse angeben:

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

  • Sie exportieren Daten über ein Skript zu Ergebnisse 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