Zum Hauptinhalt springen

Aktivierung und Setup

Der Prozess-Drafter ist standardmäßig deaktiviert und muss von einem ADONIS-Administrator manuell aktiviert werden. In diesem Kapitel erfahren Sie, wie Sie den Prozess-Drafter aktivieren und konfigurieren.

Voraussetzungen​

Damit Sie den Prozess-Drafter betreiben können, müssen einige Voraussetzungen erfüllt sein:

  • Zugriff auf die ADONIS Enterprise GPM Suite: Der Prozess-Drafter ist in der ADONIS Enterprise Edition für alle Kunden ohne Aufpreis enthalten.

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

  • Bibliotheksanforderungen: Der Prozess-Drafter benötigt die ADONIS BPMS-Bibliothek 17.0 oder höher oder eine andere Bibliothek, die auf denselben Standard aktualisiert wurde. Andernfalls kann der Prozess-Drafter 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.

  • ADONIS mit SSL installiert: On-Premise-Kunden müssen sicherstellen, dass SSL/TLS-Unterstützung für Tomcat konfiguriert ist. SaaS-Kunden müssen sich darüber keine Gedanken machen, da alle SaaS-Deployments bereits so eingerichtet sind, dass SSL/TLS zur Verschlüsselung der zwischen Client und Server übertragenen Daten verwendet wird.

Prozess-Drafter aktivieren​

So aktivieren Sie den Prozess-Drafter 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 Symbol 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 Benutzersymbol in der rechten oberen Ecke und dann auf Administration.

  2. Konfigurieren Sie die Basis-URL:

    On-Premise-Kunden müssen die Basis-URL konfigurieren.

    • Wechseln Sie zu Einstellungen > Systemeinstellungen > System.

    • Tragen Sie im Feld Basis-URL die HTTPS-URL ein, unter der ADONIS von anderen Rechnern aus erreicht werden kann.

    • Klicken Sie auf Speichern.

    SaaS-Kunden können diesen Schritt überspringen, da die Basis-URL während der Bereitstellung automatisch gesetzt wird.

  3. Greifen Sie auf die Prozess-Drafter-Einstellungen zu:

    • Wechseln Sie zu Einstellungen > Prozess-Drafter > Allgemein.

  4. Konfiguration überprüfen (ADONIS 17.1 oder höher):

    • Oben auf der Seite zeigt ADONIS an, ob die notwendigen Einstellungen zur Aktivierung des Prozess-Drafters Konfiguriert Symbol konfiguriert oder Nicht konfiguriert Symbol 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.

      • Die Basis-URL in On-Premise-Deployments muss in jedem Fall manuell gesetzt werden (siehe Schritt 2 oben).

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

    On-Premise-Kunden 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.

  6. Aktivieren Sie den Prozess-Drafter repository-spezifisch:

    Mit dem Registrierungsschlüssel kann der Prozess-Drafter für bis zu 10 Repositorys aktiviert werden.

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

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

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

URLs für den Prozess-Drafter in der Firewall zulassen​

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

Hinweis

Der Prozess-Drafter ist als iFrame in ADONIS eingebettet, wodurch der Browser des Benutzers direkte Verbindungen zu externen Diensten wie AWS Cognito und der Process Drafter 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 der Prozess-Drafter innerhalb der ADONIS-Oberfläche korrekt funktioniert.

URLs nachschlagen​

So finden Sie die konfigurierten URLs für den Prozess-Drafter:

  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 Symbol 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 Drafter.

URLs zur Firewall-Positivliste hinzufügen​

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

  • Die AWS Cognito URL (siehe oben)

  • Die Prozess-Drafter 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 den Prozess-Drafter 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:

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

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.1 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 ADONIS Administration zu Einstellungen > Prozess-Drafter > Allgemein.

  2. Oben auf der Seite zeigt ADONIS an, ob die notwendigen Einstellungen zur Aktivierung des Prozess-Drafters Konfiguriert Symbol konfiguriert oder Nicht konfiguriert Symbol nicht konfiguriert sind.

    • Der Gesamtstatus sollte Nicht konfiguriert Symbol 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:

      • OAuth 2.0-Client konfigurieren & CORS aktivieren

      • RESTful Services aktivieren

      • AWS Cognito Konnektor konfigurieren

    • Die Basis-URL in On-Premise-Deployments muss in jedem Fall manuell gesetzt werden (siehe Prozess-Drafter aktivieren).

Manuelle Konfiguration​

Wenn Sie ADONIS 17.0 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:

RESTful Services aktivieren​

  1. Wechseln Sie in der ADONIS Administration zu Einstellungen > Standard RESTful Services > Allgemein.

  2. Aktivieren Sie das Kontrollkästchen Standard RESTful Services global aktivieren.

  3. Wechseln Sie auf die Registerkarte OAuth 2.0 und konfigurieren Sie folgende Einstellungen:

    • Aktivieren Sie das Kontrollkästchen OAuth 2.0 aktivieren.

    • Aktivieren Sie unter Repositoryszenarien alle verfügbaren APIs.

    • Aktivieren Sie unter Metamodellszenarien Metamodell-Lese-APIs.

  4. Klicken Sie auf Speichern.

CORS aktivieren​

  1. Wechseln Sie in der ADONIS Administration zu Authentifizierung > Weitere Optionen > Sicherheitseinstellungen.

  2. Aktivieren Sie auf der Registerkarte Allgemein das Kontrollkästchen CORS erlauben.

  3. Aktivieren Sie auf der Registerkarte REST das Kontrollkästchen CORS erlauben.

  4. Klicken Sie auf Speichern.

OAuth 2.0-Client konfigurieren​

Redirect URI nachschlagen​

Bevor Sie im nächsten Schritt den OAuth 2.0-Client hinzufügen können, müssen Sie die Redirect URI für den Prozess-Drafter nachschlagen.

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

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

  3. Öffnen Sie die Registerkarte Konstanten, kopieren Sie die URL aus dem Parameter pw_tool_url und speichern Sie sie für die spätere Verwendung als Redirect URI. Schließen Sie dann die Konfiguration.

OAuth 2.0-Client hinzufügen​

  1. Wechseln Sie in der ADONIS Administration zu Authentifizierung > OAuth 2.0

  2. Aktivieren Sie das Kontrollkästchen Aktiviert.

  3. Klicken Sie auf Erstellen, um einen neuen Client hinzuzufügen und konfigurieren Sie folgende Einstellungen:

    • Typ: Wählen Sie public aus.

    • ID: ProcessDrafterAppID

    • Name: Process Drafter

    • Redirect URI: Fügen Sie die zuvor nachgeschlagene Redirect URI hier ein.

    • Logo: Optional können Sie ein Logo hochladen, das den Prozess-Drafter repräsentiert.

    • Secret: Klicken Sie auf Generieren, um ein neues Geheimnis zu erstellen.

  4. Klicken Sie zur Bestätigung auf OK. Zurück auf der Seite OAuth 2.0 klicken Sie auf Speichern.

AWS Cognito-Konfiguration importieren​

On-Premise-Kunden müssen die neue AWS Cognito-Konfiguration 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 AWS Cognito-Konfiguration 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 Konfiguration AWS Cognito 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​

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 des Applikations-Servers und der Webapplikation kann der Prozess-Drafter verwendet werden.

Zusätzliche Einstellungen​

Folgende zusätzliche Einstellungen sind verfügbar:

Zugriff auf den Prozess-Drafter gewähren oder verweigern​

Der Zugriff auf den Prozess-Drafter wird über System-Rollen gesteuert. Standardmäßig steht er 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:

    • Prozess-Drafter

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

Verfügbare Beziehungen für Prozessschritte konfigurieren​

Beim Erstellen eines Prozessentwurfs können Benutzer einzelne Schritte (= die Aufgabe Symbol Aufgaben, die zur Durchführung des Prozesses erforderlich sind) mit zusätzlichen Informationen anreichern. Standardmäßig sind dafür folgende Beziehungen verfügbar:

  • Verantwortlich für die Ausführung zur Zuweisung verantwortlicher Rollen

  • Referenzierte Anwendungen/IT-Systeme zur Verknüpfung mit Anwendungen

Als Administrator können Sie konfigurieren, welche Beziehungen Benutzern zum Hinzufügen zu Schritten zur Verfügung stehen:

  1. Wechseln Sie in der ADONIS Administration zu Einstellungen > Prozess-Drafter > Konfiguration.

  2. Wählen Sie auf der Seite Prozess-Drafter - Konfiguration die Beziehungen aus, die Benutzer zu jedem Schritt hinzufügen können.

    • Über das Suchfeld können Sie schnell eine bestimmte Beziehung finden.

    • Erweitern Sie eine Beziehung, um einzuschränken, welche Objekttypen als Ziel erlaubt sind:

      • Wenn Sie bestimmte Objekttypen auswählen, können Benutzer nur diese hinzufügen.

      • Wenn keine Objekttypen ausgewählt sind, sind alle erlaubt.

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

Prozess-Drafter-Daten für ein Repository löschen​

So entfernen Sie dauerhaft alle repository-spezifischen Prozess-Drafter-Daten:

  1. Wechseln Sie in der ADONIS Administration zu Einstellungen > Prozess-Drafter > Allgemein.

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

  3. Wenn Sie zum Fortfahren aufgefordert werden, klicken Sie auf Repository-Daten löschen.