Massenimport von Beilegungen

Führen Sie einen Massenimport von Beilegungen durch, um zeitaufwendige manuelle Dateneingaben zu vermeiden oder wenn Sie Daten aus einem anderen System migrieren möchten.

Mit Hilfe von Sitzungen können Sie im Massenimportprogramm auch mehrere Beilegungen auf einmal aktualisieren. Weitere Informationen finden Sie unter Massen-Aktualisierung bestehender Beilegungen.

Funktionsweise

Sie öffnen eine neue Massenimportprogramm-Sitzung und laden die Excel-Vorlage von der Seite „Massenimportprogramm“ im Launchpad herunter. Sie bereiten die Daten in der Vorlage vor und laden anschließend die Vorlage auf der Seite Massenimportprogramm hoch.

Wo befinden sich die hochgeladenen Beilegungen?

Sobald Sie Beilegungen hochladen, sind die Daten in der Risikokontrollmatrix des Projekts oder des Frameworks verfügbar.

Vorbereitungen

Bevor Sie mit dem Import von Beilegungen beginnen, müssen Sie Folgendes tun:

  1. Erstellen Sie ein Projekt über das Massenimportprogramm, indem Sie das Arbeitsblatt Projects ausfüllen, oder über die Benutzeroberfläche; ODER
    Erstellen Sie ein Framework über das Massenimportprogramm, indem Sie das Arbeitsblatt Frameworks ausfüllen, oder über die Benutzeroberfläche.
  2. Definieren Sie Ziele über das Massenimportprogramm, indem Sie das Arbeitsblatt Objectives ausfüllen, oder über die Benutzeroberfläche.
  3. Definieren Sie Risiken und Kontrollen über das Massenimportprogramm, indem Sie die Arbeitsblätter Risks und Controls ausfüllen, oder über die Benutzeroberfläche.

Hinweis

Mit dem Massenimportprogramm können Sie zahlreiche Diligent One-Ressourcen in einem einzigen Import erstellen. Sie können die Arbeitsblätter aller erforderlicher Ressourcen ausfüllen und diese in einem Schritt importieren.

Workflow

Berechtigungen

Nur Systemadministratoren können Diligent One-Ressourcen massenhaft über das Massenimportprogramm hochladen.

Massen-Upload neuer Beilegungen

Hinweise

  • Begriffe der Benutzeroberfläche können angepasst werden, und auch Felder sowie Registerkarten sind einstellbar. In Ihrer Instanz von Diligent One können einige Begriffe, Felder und Registerkarten unterschiedlich sein.
  • Wenn ein erforderliches Feld leer bleibt, wird Ihnen eine Warnmeldung angezeigt: Dieses Feld ist obligatorisch. Einige benutzerdefinierte Felder verfügen möglicherweise über Standardwerte.

Neue Massenimportprogramm-Sitzung öffnen und die Excel-Vorlage herunterladen

  1. Öffnen Sie Launchpad.

    Hinweis

    Wenn Ihr Unternehmen mehrere Instanzen im Launchpad verwendet, stellen Sie sicher, dass die entsprechende Instanz aktiv ist.

  2. Wählen Sie Plattform-Einstellungen > Organisation aus.

    Wenn Organisation nicht als Option zur Verfügung steht, besitzt das Konto, unter dem Sie sich angemeldet haben, keine Administratorberechtigungen.

  3. Klicken Sie unter Massenimportprogramm auf Ressourcen massenweise verwalten.

    Eine neue Massenimportprogramm-Sitzung beginnt und die Sitzungs-ID wird an die URL angehängt.

    Achtung

    Beginnen Sie stets eine neue Sitzung, wenn Sie neue Ressourcen hinzufügen möchten. Andernfalls können Sie zuvor hochgeladene Daten verlieren.

    Hinweis

    Sie können vorherige Sitzungen verwenden, um bereits hochgeladene Daten zu aktualisieren. Weitere Informationen dazu finden Sie unter Aktualisierungsfunktion im Massenimportprogramm.

  4. Wählen Sie unter Ressource auswählen eine der folgenden Optionen im Ressourcentyp aus:

    • Projekte > Projektnamen Um Beilegungen für ein bestimmtes Projekt zu erstellen. Die Vorlage ist dynamisch und umfasst integrierte Konfigurationen des ausgewählten Projekts. Mit dieser Methode können Sie mehrere Diligent One-Ressourcen (Ziele, Risiken, Kontrollen und Beilegungen) für ein bestimmtes Projekt erstellen.
    • Frameworks > Framework-Namen Um Beilegungen für ein bestimmtes Framework zu erstellen. Die Vorlage ist dynamisch und umfasst integrierte Konfigurationen des ausgewählten Frameworks. Mit dieser Methode können Sie mehrere Diligent One-Ressourcen (Ziele, Risiken, Kontrollen und Beilegungen) für ein bestimmtes Framework erstellen.
    • Projekte > Projekttypen Um Beilegungen für ein Projekt oder Framework basierend auf einem bestimmten Projekttyp zu erstellen. Die Vorlage ist dynamisch und umfasst integrierte Konfigurationen des ausgewählten Projekttyps. Mit dieser Option können Sie mehrere Diligent One-Ressourcen (Projekte, Frameworks, Ziele, Risiken, Kontrollen und Beilegungen) basierend auf einem Projekttyp erstellen. Dasselbe ist auch mit der Option Frameworks > Projekttypen möglich.
    • Alle Ressourcen Um alle Ressourcen per Massenimport gleichzeitig zu importieren: Projekte, Frameworks, Ziele, Risiken, Kontrollen, Beilegungen, Probleme, Aktionen, Anfragen, Entitäten und Compliance-Maps. Die Vorlage ist statisch und muss manuell mit der Konfiguration der Ressourcen ausgefüllt werden.
  5. Klicken Sie auf .xlsx-Vorlage herunterladen.

    Die Excel-Vorlage wird auf dem lokalen Rechner gespeichert.

Daten in der Vorlage vorbereiten

  1. Öffnen Sie die heruntergeladene Vorlage und navigieren Sie zum Arbeitsblatt Mitigations.
  2. Kopieren Sie Ihre Daten und fügen Sie diese in die Vorlage ein. Hilfe zur Dateneingabe finden Sie unter Tipps für die Vorbereitung von Inhalten.
    Hinweis
    • Wenn Sie das Add-In für Excel verwenden, stellen Sie sicher, dass die Option „ACL Add-In“ deaktiviert ist, bevor Sie die Excel-Vorlage ändern. Wie Sie dabei vorgehen, erfahren Sie unter Das Add-In für Excel konfigurieren.
    • Ändern Sie nicht den Namen des Arbeitsblatts oder der Felder. Bei diesen Angaben wird zwischen Groß- und Kleinschreibung unterschieden. Sie dürfen nicht geändert werden.
    • Die maximale Anzahl von Zeilen, die auf einmal hochgeladen werden können, beträgt 2000 (einschließlich aller Arbeitsblätter).
    FeldBeschreibung

    referenceId

    obligatorisch

    Gibt eine eindeutige ID für die Ressource an. Dabei muss es sich um einen eindeutigen Wert für jede Reihe im Arbeitsblatt handeln.

    Er kann eine Kombination aus Text und Zahlen enthalten, die maximale Länge beträgt 255 Zeichen.

    Dieses Feld ist der Primärschlüssel für jede Reihe in der Vorlage. Sie benötigen diesen Schlüssel, wenn Sie diese Ressource erneut aktualisieren möchten.

    Wichtig

    Mit Referenz-IDs können Sie Ressourcen schnell miteinander verknüpfen. Sie können beispielsweise ein neues Projekt und ein neues Ziel erstellen, das beim gleichen Hochladevorgang mit diesem Projekt verknüpft wird. Erstellen Sie dazu einen Link zwischen dem Projekt und dem Ziel, indem Sie referenceId in das geforderte Feld eingeben.

    Weitere Informationen über die Verknüpfung von Diligent One-Ressourcen im Massenimportprogramm finden Sie unter Verwendung von Referenz-IDs zur Verknüpfung von Ressourcen im Massenimportprogramm.

    Hinweis

    Referenz-IDs sind erforderlich, wenn Sie mit dem Massenimportprogramm Ressourcen hinzufügen oder aktualisieren. Sie sind nicht verfügbar, wenn Sie Ressourcen über die Benutzeroberfläche von Diligent One hinzufügen/aktualisieren.

    controlId

    obligatorisch

    gibt die ID der Kontrolle an, mit der Sie diese Beilegung verknüpfen möchten.

    Sie finden die Kontroll-ID in der URL, wenn Sie zu einer Kontrolle navigieren.

    Zum Beispiel: 

    https://stark.projects.highbond.com/
    audits/13659/objectives/6616/controls/5182
    , wobei 5182 die Kontrolle-ID ist.

    Hinweis

    Alternativ können Sie in diesem Feld eine Referenz-ID einer neuen Kontrolle angeben, die Sie in der aktuellen Vorlage hinzugefügt haben. Damit wird die Beilegung beim Hochladen der Vorlage mit der Kontrolle verknüpft.

    Weitere Informationen über die Verknüpfung von Diligent One-Ressourcen im Massenimportprogramm finden Sie unter Verwendung von Referenz-IDs zur Verknüpfung von Ressourcen im Massenimportprogramm.

    Informationen zu Kontrollen finden Sie unter Risiken und Kontrollen definieren.

    riskId

    obligatorisch

    gibt die ID des Risikos an, mit dem Sie diese Beilegung verknüpfen möchten.

    Sie finden die Risiko-ID in der URL, wenn Sie zu einem Risiko navigieren.

    Zum Beispiel:

    https://stark.projects.highbond.com/
    audits/13659/objectives/6616/risks/3988
    , wobei 3988 die Risiko-ID ist.

    Hinweis

    Alternativ können Sie in diesem Feld eine Referenz-ID eines neuen Risikos angeben, die Sie in der aktuellen Vorlage hinzugefügt haben. Damit wird die Beilegung beim Hochladen der Vorlage mit dem Risiko verknüpft.

    Weitere Informationen über die Verknüpfung von Diligent One-Ressourcen im Massenimportprogramm finden Sie unter Verwendung von Referenz-IDs zur Verknüpfung von Ressourcen im Massenimportprogramm.

    Informationen zu Risiken finden Sie unter Risiken und Kontrollen definieren.

    weight

    obilagtorisch

    gibt die Bedeutung der Beilegung an. Der Wert muss eine Zahl zwischen 1 und 100 sein.

    Hinweis

    In der dynamischen Vorlage werden für ein Dropdown-Feld die Optionen in der Dropdown-Liste nur für die erste Zeile angezeigt. Um diese Optionen für weitere Zeilen zu verwenden, kopieren Sie die erste Zeile und fügen Sie sie in die erforderlichen Zeilen ein.

  3. Speichern und schließen Sie die Vorlage.

Tipps für die Vorbereitung von Inhalten

Die Vorbereitung von Inhalten umfasst:

  • Kopieren und Einfügen der Quelldaten in die Excel-Vorlage
  • Daten, falls erforderlich, manuell in die Excel-Vorlage eingeben
  • Die Vorlage zur Vorbereitung auf den Massen-Upload speichern

Verwendung von Referenz-IDs zur Verknüpfung von Ressourcen im Massenimportprogramm

„Reference ID“ ist ein Feld in der zum Massenimportprogramm gehörenden Excel-Vorlage. Das Feld findet sich in allen Arbeitsblättern und ist für alle Ressourcen verfügbar. Es handelt sich um einen eindeutigen Bezeichner für jeden Datensatz im Arbeitsblatt.

Mit Referenz-IDs können Sie Diligent One-Ressourcen schnell miteinander verknüpfen. Sie können z. B. ein Projekt und ein Ziel, das mit dem Projekt verknüpft ist, im selben Import erstellen. Sie können dies tun, indem Sie referenceId in das erforderliche Feld eingeben.

Daten hochladen

Führen Sie einen der folgenden Schritte aus:

  • Ziehen Sie die Vorlage mit der Maus in das Browserfenster.
  • Klicken Sie auf Wählen Sie auf Ihrem Computer aus und wählen Sie die aktualisierte Vorlage von Ihrem Computer aus.

    Nur eine Excel-Vorlage gleichzeitig kann hochgeladen werden (jede Datei wird separat validiert).

  • Ergebnis Je nach Ergebnis des Vorgangs wird eine Erfolgs- oder Fehlermeldung angezeigt, und die letzte Sitzung wird in der Tabelle Sitzungen aktualisiert.

Sitzungen im Massenimportprogramm

Eine Sitzung im Massenimportprogramm besteht aus einer Reihe von Benutzerinteraktionen für den Import von Diligent One-Ressourcen. Jede Benutzersitzung wird in der Tabelle Sitzungen aufgezeichnet.

Die Sitzungstabelle enthält die folgenden Informationen:

Feldname

Beschreibung

Web-Sitzungen

Zeigt die Liste der Web-Sitzungen an.

Eine Websitzung stellt eine Sitzung dar, die über die Benutzeroberfläche des Massenimportprogramms abgehalten wird. Jedes Mal, wenn Sie die Seite Massenimportprogramm öffnen, beginnt eine neue Sitzung.

API-Sitzungen

Zeigt die Liste der API-Sitzungen an.

Eine API-Sitzung stellt eine Sitzung dar, die über eine API-Plattform wie Postman usw. abgehalten wird.

Aktualisieren

Lädt die Tabelle Sitzungen neu.

Sitzungs-ID

Bezeichner der Sitzung.

In Websitzungen können Sie auf die Sitzungs-ID klicken, um zu einer bestimmten Sitzung zu gelangen, und die Sitzungs-ID wird an die URL angehängt.

Beispiel: https://stark.bulkimporter.highbond.com/import/bcc1e04e-4cd3-46d2-a8be-0b9083baccdc, wobei
bcc1e04e-4cd3-46d2-a8be-0b9083baccdc die Sitzungs-ID ist.

Hinweis

Sitzungs-IDs von Web- und API-Sitzungen sehen ähnlich aus. Achten Sie also darauf, die IDs nicht zu verwechseln.

Datum

Zeigt Datum und Uhrzeit der Sitzung an. Sie können das Datum in aufsteigender oder absteigender Reihenfolge sortieren.

Hochgeladen von

Zeigt den Namen des Benutzers an.

Status

Zeigt den Status des Uploads an und ob er erfolgreich war oder nicht.

Sie können auf den Status klicken, um die ausgefüllten Importeinzelheiten anzuzeigen.

Dateiname

Zeigt den Namen der hochgeladenen Vorlage/das Fehlerprotokoll an. Beispiel: HighBond_Template.xlsx, ErrorLog.xlsx.

Vorlage Sie können die Vorlage anklicken und herunterladen, um bereits hochgeladene Daten zu korrigieren.

Fehlerprotokoll Ein Fehlerprotokoll wird erstellt, wenn ein Upload fehlschlägt. Sie können im Fehlerprotokoll nachschauen, um die Fehler zu beheben und die Vorlage erneut hochzuladen.

Hinweis
  • Die Vorlage und das Fehlerprotokoll sind bis zu 18 Monate nach dem Upload-Datum zum Herunterladen verfügbar.
  • Der Link zum Herunterladen der Vorlage ist für Sitzungen im Massenimportprogramm ab 13. Mai 2022 verfügbar. Sie können die Vorlage nicht für Sitzungen herunterladen, die vor diesem Datum stattfanden.

Massen-Aktualisierung bestehender Beilegungen

Sie können im Massenimportprogramm mit Hilfe von Sitzungen mehrere Elemente auf einmal aktualisieren.

Hinweis

Sie können nur Ressourcen, die Sie mit dem Massenimportprogramm hochgeladen haben, aktualisieren.

Problembehandlung

Sie können das Fehlerprotokoll aus der Tabelle „Sitzungen“ herunterladen und darin nachschauen. Verstehen Sie, welche Fehler beim Massen-Upload häufig auftreten und lernen Sie, diese Fehler zu beheben.

Die folgende Tabelle enthält eine Liste der möglichen Fehler, die beim Hochladen der Vorlage auftreten können.

Fehler Lösung(en)
Es können dabei mehr als 2000 Zeilen in der hochgeladenen Datei enthalten sein (einschließlich aller Arbeitsblätter). Entfernen Sie die zusätzlichen Reihen aus der Vorlage und laden Sie sie erneut hoch.
Obligatorische Felder wurden nicht ausgefüllt oder fehlen in der hochgeladenen Datei. Vergewissern Sie sich, dass alle obligatorischen Felder (in der Vorlage durch rote und orangefarbene Spaltennamen gekennzeichnet) ausgefüllt sind.
Hinweis

Wenn Sie keine Daten in die Pflichtfelder eingeben, wird die Reihe nicht verarbeitet.

Daten sind ungültig.

Stellen Sie sicher, dass die Daten in Textfeldern gültig sind und die maximale Feldlänge nicht übersteigen: 255 Zeichen.

Rich-Text-Felder weisen keine Zeichengrenzen auf.

Die Datenwerte sind ungültig oder stimmen nicht mit den Dropdown-Werten überein.

Beispiel: Der Wert für die Felder received und sendRecurrentNotifications im Blatt Requests muss True oder False sein.

Ungültige Felder in der Vorlage.
  • Fügen Sie der Vorlage keine neuen Felder hinzu.
  • Entfernen Sie keine Felder aus der Vorlage.
Die Vorlage hat nicht das erwartete Format.

Vergewissern Sie sich, dass das Dateiformat .xlsx ist.

Ungültige Arbeitsblattnamen.

Ändern Sie nicht den Namen des Arbeitsblatts.

Die Sitzung ist abgelaufen.

Aktualisieren Sie die Seite und versuchen Sie den Upload erneut.

Möglicherweise ist die Sitzungs-ID ungültig. Stellen Sie sicher, dass Sie eine Websitzungs-ID verwenden.