Aktivierung und Setup

ADONIS Process Mining Essentials (PME) ist standardmäßig deaktiviert und muss von einem ADONIS-Administrator manuell aktiviert werden. In diesem Kapitel erfahren Sie, wie Sie PME aktivieren und konfigurieren.

• Stellen Sie zunächst sicher, dass alle Voraussetzungen erfüllt sind.

• Wenn Sie mit einer Neuinstallation von ADONIS 17.0 oder höher arbeiten, ist das Aktivieren von PME für bestimmte Repositorys unkompliziert – und in der Regel der einzige erforderliche Schritt.

• Wenn Ihre Organisation ausgehende Verbindungen einschränkt, müssen Sie zusätzlich die PME-URLs in ihrer Firewall zulassen.

• Wenn Sie von einer älteren ADONIS-Version migrieren, befolgen Sie die zusätzlichen Konfigurationsschritte, um PME zu aktivieren.

• Optional können Sie zusätzliche Einstellungen konfigurieren. Zum Beispiel können Sie steuern, welche Benutzer auf PME zugreifen dürfen, oder alle repository-spezifischen PME-Daten löschen.

Voraussetzungen

Damit Sie Process Mining in ADONIS PME betreiben können, müssen einige Voraussetzungen erfüllt sein:

• Zugriff auf die ADONIS Enterprise GPM Suite: PME ist ein Add-on zur ADONIS Enterprise Edition, daher benötigen Sie Zugriff auf diese Edition.

• Unterstützte ADONIS-Versionen: PME ist für ADONIS 17.0 oder höher verfügbar. Wenn Sie eine ältere Version von ADONIS verwenden, kann das Add-on nicht installiert oder genutzt werden.

• Bibliotheksanforderungen: PME benötigt die ADONIS BPMS-Bibliothek 17.0 oder höher oder eine andere Bibliothek, die auf denselben Standard aktualisiert wurde. Andernfalls kann das Add-on nicht installiert oder genutzt werden.

Bibliotheksanforderungen für ADONIS-Upgrades

Haben Sie ein Upgrade von einer älteren ADONIS-Version durchgeführt und weiterhin die alte Datenbank im Einsatz? Dann stellen Sie sicher, dass die Bibliothek aktualisiert wurde.

• Ereignisprotokolldaten: PME analysiert Ereignisprotokolldaten, stellt diese jedoch nicht bereit.

Hinweis

Zu Testzwecken können folgende Beispiel-Ereignisprotokolle verwendet werden, um die Möglichkeiten von ADONIS PME zu entdecken:

• Purchase-To-Pay (CSV-Datei)
• Defect Reparation (XES-Datei)

PME aktivieren

So aktivieren Sie PME in Ihrer ADONIS-Umgebung:

1. Öffnen Sie die ADONIS Administration mit Ihrem Administratorkonto:

   • Geben Sie die HTTPS-URL ein, unter der ADONIS verfügbar ist. Klicken Sie auf Administration, geben Sie Ihre Anmeldeinformationen ein und loggen Sie sich ein.

   • Wenn Sie bereits in ADONIS eingeloggt sind und zur ADONIS Administration wechseln möchten, klicken Sie auf das Benutzersymbol in der rechten oberen Ecke und dann auf Administration.

2. Greifen Sie auf die PME-Einstellungen zu:

   • Wechseln Sie zu Einstellungen > Process Mining Essentials > Allgemein.

3. Konfiguration überprüfen (ADONIS 17.2 oder höher):

   • Oben auf der Seite zeigt ADONIS an, ob die notwendigen Einstellungen zur Aktivierung von PME konfiguriert oder nicht konfiguriert sind.

   • Falls Einstellungen fehlen, erweitern Sie die Hierarchie, um Details anzuzeigen und die Probleme zu beheben.

     • Sie können auf Automatisch konfigurieren klicken, um fehlende Einstellungen automatisch anzuwenden, oder eine manuelle Konfiguration durchführen.

4. Fügen Sie den Registrierungsschlüssel hinzu:

   On-Premise-Kunden, die ADONIS PME erworben haben, müssen vor der Aktivierung einen Registrierungsschlüssel bei der BOC Group Hotline anfordern.

   • Klicken Sie auf Registrierungsschlüssel anfordern. Ihr E-Mail-Client öffnet sich mit einer vorausgefüllten Nachricht.

     • Ersetzen Sie [Firmenname eintragen] durch Ihren tatsächlichen Firmennamen.

     • Die Felder Datenbank-ID und Basis-URL werden automatisch ausgefüllt und sollten nicht geändert werden.

   • Senden Sie die E-Mail an die BOC Group Hotline.

   • Sie erhalten einen Link zu einem sicheren Dateiübertragungsportal, über den Sie den Registrierungsschlüssel herunterladen können.

   • Fügen Sie den Schlüssel in das Feld Registrierungsschlüssel ein.

   SaaS-Kunden können diesen Schritt überspringen, da der Registrierungsschlüssel von unserem Cloud Operations Team verwaltet wird.

5. Aktivieren Sie PME repository-spezifisch:

   Mit dem Registrierungsschlüssel kann PME für bis zu 10 Repositorys aktiviert werden.

   • Wählen Sie unter Repository-Name die Repositorys aus, für die PME aktiviert werden soll.

   • Klicken Sie auf Speichern, um die Änderungen zu übernehmen.

PME ist jetzt für Benutzer verfügbar, die sich an den ausgewählten Repositories in ADONIS anmelden (siehe ADONIS PME öffnen).

URLs für PME in der Firewall zulassen

Kunden, die PME nutzen möchten, müssen sicherstellen, dass bestimmte URLs von ihrer Firewall durchgelassen werden. Sie müssen die konfigurierten URLs für PME in der ADONIS Administration nachschlagen und diese zu Ihrer Positivliste hinzufügen.

Hinweis

PME ist als iFrame in ADONIS eingebettet, wodurch der Browser des Benutzers direkte Verbindungen zu externen Diensten wie AWS Cognito und der PME API herstellt.

In vielen Netzwerkumgebungen sind die benötigten öffentlichen Service-URLs standardmäßig freigegeben. Sollte Ihre Organisation jedoch ausgehende Verbindungen – insbesondere vom Endgerät oder Browser – einschränken, müssen diese URLs möglicherweise manuell freigegeben werden.

Dies gilt sowohl für SaaS- als auch für On-Premise-Deployments und stellt sicher, dass PME innerhalb der ADONIS-Oberfläche korrekt funktioniert.

URLs nachschlagen

So finden Sie die konfigurierten URLs für PME:

1. Wechseln Sie in der ADONIS Administration zu Einstellungen > Weitere Optionen > Connect Center.

2. Wählen Sie im linken Bereich unter Konnektoren die Konfiguration AWS Cognito aus, und klicken Sie dann auf Konfigurationsdialog öffnen.

3. Öffnen Sie die Registerkarte Technische Einstellungen, kopieren Sie die URL aus dem Feld URL und speichern Sie sie für später ab. Schließen Sie dann die Konfiguration.

4. Wiederholen Sie die Schritte 2 - 3 für die Konfiguration Process Mining Essentials.

URLs zur Firewall-Positivliste hinzufügen

Fügen Sie folgende URLs zur Positivliste Ihrer Firewall hinzu:

• Die AWS Cognito URL (siehe oben)

• Die Process Mining Essentials URL (siehe oben)

Zusätzliches Setup für migrierte ADONIS-Installationen

Bei einem Upgrade von einer älteren ADONIS-Version sind zusätzliche Konfigurationsschritte erforderlich, um PME zu aktivieren. Diese Einstellungen sind bei Neuinstallationen von ADONIS 17.0 oder höher bereits vorkonfiguriert und können in diesem Fall übersprungen werden.

Abhängig von Ihrer ADONIS-Version und Ihren Präferenzen für das Setup gibt es zwei Möglichkeiten, die zusätzlichen Konfigurationsschritte für migrierte ADONIS-Installationen abzuschließen:

• Automatische Konfiguration (empfohlen für ADONIS 17.2 oder höher)

• Manuelle Konfiguration (für ADONIS 17.0/17.1 oder wenn mehr Kontrolle gewünscht ist)

Unabhängig davon, für welche Option Sie sich entscheiden, müssen Sie anschließend noch einige abschließende Schritte durchführen:

• Abschließende Schritte

Wählen Sie entweder die automatische oder manuelle Konfiguration, führen Sie die abschließenden Schritte durch, und schon können Sie loslegen!

Automatische Konfiguration

Wenn Sie ADONIS 17.2 oder höher verwenden, sollten Sie die zusätzlichen Konfigurationsschritte für migrierte ADONIS-Installationen automatisch von ADONIS durchführen lassen:

1. Wechseln Sie in der Einstellungen > Process Mining Essentials > Allgemein.

2. Oben auf der Seite zeigt ADONIS an, ob die notwendigen Einstellungen zur Aktivierung von PME konfiguriert oder nicht konfiguriert sind.

   • Der Gesamtstatus sollte nicht konfiguriert sein.

   • Erweitern Sie die Hierarchie, um den Status der einzelnen erforderlichen Einstellungen anzuzeigen.

3. Klicken Sie auf Automatisch konfigurieren.

   • Ein Hintergrundskript wird ausgeführt und führt folgende Aufgaben aus:

     • AWS Cognito Konnektor konfigurieren

     • Process Mining Essentials Konnektor konfigurieren

Manuelle Konfiguration

Wenn Sie ADONIS 17.0/17.1 verwenden oder die Konfiguration manuell durchführen möchten, folgen Sie diesen Schritten, um die zusätzlichen Konfigurationsschritte für migrierte ADONIS-Installationen abzuschließen:

• Konnektor-Konfigurationen importieren

Konnektor-Konfigurationen importieren

On-Premise-Kunden müssen neue Konnektor-Konfigurationen importieren.

1. Wechseln Sie in der ADONIS Administration zu Einstellungen > Weitere Optionen, und klicken Sie dann auf Einstellungen importieren.

2. Klicken Sie auf Durchsuchen und wählen Sie die Datei ADONIS <Version> - BPMS AL Standard Component Setting.axs aus, die die Konnektor-Konfigurationen enthält.

   • Sie finden diese Datei im Ordner <04 Sample Data/Component Settings> im ADONIS Installationspaket.

   • Alternativ können Sie die Datei von Ihrem Computer in den Bereich Ziehen Sie eine Datei hierher, um sie hochzuladen ziehen.

3. Lassen Sie die Option Alle Einstellungen importieren deaktiviert. Scrollen Sie nach unten, erweitern Sie den Eintrag Integration – Datenkonnektoren und wählen Sie nur die Konfigurationen AWS Cognito und Process Mining Essentials aus.

4. Klicken Sie auf Importieren. Wenn Sie zum Fortfahren aufgefordert werden, klicken Sie auf Ja. Die Daten werden importiert.

SaaS-Kunden können diesen Schritt überspringen, da die erforderliche Konfiguration von unserem Cloud Operations Team übernommen wird

Abschließende Schritte

Unabhängig davon, ob Sie die automatische oder manuelle Konfiguration für migrierte ADONIS-Installationen verwendet haben, führen Sie folgende abschließende Schritte durch:

• Konfiguration der Webapplikation überprüfen

• Umgebung neu starten

Konfiguration der Webapplikation überprüfen

On-Premise-Kunden müssen wichtige Parameter in einer Web-Server-Konfigurationsdatei überprüfen.

1. Navigieren Sie zum Verzeichnis <Tomcat>/webapps.

2. Öffnen Sie die Datei ADONIS*_*.war mit einer Komprimierungs-Software.

3. Öffnen Sie im Stammverzeichnis des Archivs die Konfigurationsdatei adoxx_web.properties in einem Texteditor mit Administratorrechten.

4. Stellen Sie sicher, dass folgende Eigenschaften vorhanden sind und gültige, vorkonfigurierte Werte enthalten:

   • security.src.frame-src

   • security.src.connect-src

   • security.src.frame-ancestors

Sollten diese Eigenschaften fehlen oder leer sein, kopieren Sie die entsprechenden Zeilen (mit vorkonfigurierten Werten) aus der Referenz-Konfigurationsdatei im Ordner 03 Web Application im ADONIS Installationspaket.

SaaS-Kunden können diesen Schritt überspringen, da die Parameter während der Bereitstellung automatisch festgelegt werden.

Umgebung neu starten

Nach einem Neustart der Webapplikation kann PME verwendet werden.

Zusätzliche Einstellungen

Folgende zusätzliche Einstellungen sind verfügbar:

Zugriff auf PME gewähren oder verweigern

Der Zugriff auf PME wird über System-Rollen gesteuert. Standardmäßig steht das Add-on Benutzern mit der Rolle "Gestalten & Dokumentieren" zur Verfügung.

So ändern Sie, wer Zugriff hat:

• Wechseln Sie in der ADONIS Administration zu Einstellungen > Systemeinstellungen > Module.

• Weisen Sie folgendes Modul jenen System-Rollen zu, denen Sie den Zugriff erlauben möchten:

  • Process Mining Essentials

Das war’s! Alle Benutzer mit den ausgewählten System-Rollen können jetzt in ADONIS auf PME zugreifen.

PME-Daten für ein Repository löschen

So entfernen Sie dauerhaft alle repository-spezifischen PME-Daten:

1. Öffnen Sie die ADONIS Administration und wechseln Sie zu Einstellungen > Process Mining Essentials > Allgemein.

2. Klicken Sie rechts neben dem Repository auf die Mehr Schaltfläche und dann auf Repository-Daten löschen.

3. Wenn Sie zum Fortfahren aufgefordert werden, klicken Sie auf Löschen.