Zum Hauptinhalt springen
Version: 12.0

Bibliothekenverwaltung

Die Bibliothekenverwaltung ermöglicht dem Administrator umfassenden verwaltenden Zugriff auf ADOIT Bibliotheken und Repositorys.

Info

Die Rechte von Administratoren auf Bibliotheken sind aus Sicherheitsgründen eingeschränkt. Vollzugriff haben nur ADOIT Customizer und Produktentwickler.

Bibliothekenverwaltung aktivieren

Um die Bibliothekenverwaltung auszuwählen:

  • Klicken Sie auf die Komponentenauswahl links oben im Arbeitsbereich.

  • Wählen Sie die Bibliothekenverwaltung aus.

Hinweis

Auf dem Startbildschirm der Bibliothekenverwaltung finden Sie Links zu den wichtigsten Repository- und Bibliothekenfunktionen. Abhängig von der Auswahl im Katalog sind verschiedene Funktionen aktiv.

Allgemeine Repository-Funktionen

Um mit einer Bibliothek auch tatsächlich arbeiten zu können, muss diese mindestens ein Repository zugewiesen bekommen. In diesem werden nach der von einem Customizer festgelegten Bibliotheksdefinition Modelle erstellt, Objekte angelegt und wiederverwendet und vieles mehr.

Neues Repository anlegen

Um einer Bibliothek ein neues Repository zuzuweisen:

  1. Wählen Sie diese Bibliothek im Bibliothekenkatalog aus.

  2. Wählen Sie im Kontextmenü des Bibliothekenkatalogs den Menüpunkt Neues Repository anlegen....

  3. Geben Sie in das Feld Repository-Name den gewünschten Namen ein.

  4. Bestätigen Sie mit OK. Das Repository wird in der Datenbank angelegt und der Bibliothek zugewiesen

Info

Einem Benutzer (Administrator), der ein neues Repository anlegt, wird dieses auch gleich automatisch zugewiesen.

Repository sperren / freigeben

Von Zeit zu Zeit können Wartungsarbeiten an einem Repository notwendig werden. Gründe dafür sind beispielsweise das Löschen alter Modellbestände, eine Datensicherung zu einem bestimmten IST-Stand und vieles mehr. In diesem Fall ist es ratsam, das Repository vor Beginn der Arbeiten zu sperren und erst hinterher wieder freizugeben. Ein gesperrtes Repository kann von keinem Benutzer verwendet werden – eine Anmeldung an diesem Repository ist dann nicht möglich. So können inkonsistente Zustände während der Wartungsarbeiten vermieden werden.

Repository sperren

Um ein Repository zu sperren:

  • Wählen Sie das Repository im Bibliothekenkatalog aus.

  • Wählen Sie im Kontextmenü des Bibliothekenkatalogs den Menüpunkt Repository sperren.

Hinweis

Ein Repository kann nur gesperrt werden, wenn in diesem Augenblick keine anderen Benutzer mit dem Repository arbeiten. Andernfalls erscheint eine Fehlermeldung.

Repository freigeben

Um ein gesperrtes Repository wieder freizugeben:

  • Wählen Sie das Repository im Bibliothekenkatalog aus.

  • Wählen Sie im Kontextmenü des Bibliothekenkatalogs den Menüpunkt Repository freigeben aus. Das Repository wird freigegeben und kann wieder von allen berechtigten Benutzern verwendet werden.

Repository umbenennen

Um ein bestehendes Repository umzubenennen:

  1. Selektieren Sie das Repository im Bibliothekenkatalog.

  2. Drücken Sie <F2>. Ein Eingabedialog öffnet sich.

  3. Geben Sie den neuen Namen ein

  4. Bestätigen Sie mit OK. Der Name wird geändert und der Eingabedialog geschlossen.

Repository löschen

Administratoren mit den entsprechenden Berechtigungen können nicht mehr benötigte Repositorys löschen:

  1. Wählen Sie das Repository im Bibliothekenkatalog aus.

  2. Wählen Sie im Kontextmenü des Bibliothekenkatalogs den Menüpunkt Repository löschen aus. Eine Sicherheitsabfrage erscheint.

  3. Bestätigen Sie mit Ja. Das Repository samt Inhalt wird gelöscht.

Hinweis

Ein Repository kann nur gelöscht werden, wenn in diesem Augenblick keine anderen Benutzer mit dem Repository arbeiten.

Sie können das aktive Repository nicht löschen. Wechseln Sie zuerst das Repository.

Achtung

Lassen Sie beim Löschen von Repositorys besondere Vorsicht walten, da nach dem Löschen die Inhalte (Modelle, Objekte, Informationen) nicht wiederherstellbar sind.

Repository-Eigenschaften

Repositorys haben eine Vielzahl verschiedener Eigenschaften. Einige davon sind für die Arbeit von Administratoren wichtig und können daher abgerufen werden. Um die Repository-Eigenschaften anzuzeigen:

  • Wählen Sie im Kontextmenu des Repository den Menüpunkt Eigenschaften... aus.

Ein Dialog mit Repository-Eigenschaften öffnet sich:

 Repository– Eigenschaften

Eigenschaften

Folgende Repository-Eigenschaften werden angezeigt:

  • Derzeit verwendet von

    Enthält eine Liste aller Benutzer, welche im Augenblick am selektierten Repository angemeldet sind.

  • Derzeit gesperrt von

    Falls ein Benutzer das gewählte Repository gesperrt hat, wird an dieser Stelle der Benutzername angezeigt.

Allgemeine Bibliotheksfunktionen

Im Zuge der ADOIT Administration kann es notwendig werden, bestehende Anwendungsbibliotheken zu bearbeiten. Die Bearbeitungsmöglichkeiten für Administratoren sind eingeschränkt; nur Customizer und Produktentwickler haben Vollzugriff. Einige grundlegende Funktionen stehen allerdings auch in der Bibliothekenverwaltung zur Verfügung:

Bibliothek umbenennen

Um einer Bibliothek einen neuen Namen zuzuweisen:

  1. Wählen Sie die gewünschte Bibliothek im Bibliothekenkatalog aus.

  2. Drücken Sie <F2>. Ein Eingabedialog öffnet sich.

  3. Geben Sie den neuen Namen ein.

  4. Bestätigen Sie mit OK. Die Bibliothek wird umbenannt und das Eingabefenster geschlossen.

Bibliothek löschen

Von Zeit zu Zeit kann es auch nötig sein, nicht mehr verwendete Bibliotheken (z.B. alte Versionen) zu löschen. Um eine Bibliothek aus der Datenbank zu entfernen:

  1. Wählen Sie die gewünschte Bibliothek im Bibliothekenkatalog aus.

  2. Wählen Sie im Kontextmenü der Bibliothek den Menüpunkt Löschen aus. Eine Sicherheitsabfrage öffnet sich.

  3. Bestätigen Sie mit Ja. Die Bibliothek wird gelöscht und alle darin enthaltenen Objekte aus der Datenbank entfernt.

Hinweis

Bibliotheken, denen Repositorys zugewiesen sind, können nicht gelöscht werden. In diesem Fall müssen Sie zuerst die Repositorys löschen .

Bibliothekseinstellungen exportieren

Mit der Funktion Bibliothekseinstellungen exportieren können verschiedene Einstellungen einer ADOIT-Bibliothek aus der Datenbank exportiert und als XML-Datei im Dateisystem abgelegt werden.

Um die Bibliothekseinstellungen zu exportieren:

  1. Aktivieren Sie das Tab Einstellungen im Katalog.

  2. Wählen Sie im Kontextmenü der gewünschten Bibliothek den Menüpunkt Bibliothekseinstellungen exportieren... aus. Ein Dialog mit Einstellungen für den Export öffnet sich.

  3. Geben Sie den Pfad und den Namen der Exportdatei im Feld Dateiname ein (entweder manuell oder über den Unterstützungsdialog Durchsuchen...).

  4. Bestätigen Sie mit Exportieren. Der Export wird durchgeführt. Eine Erfolgsmeldung erscheint.

Hinweis

Welche Bibliothekseinstellungen tatsächlich exportiert werden, hängt von der ADOIT-Konfiguration ab.

Bibliothekseinstellungen importieren

Mit der Funktion Bibliothekseinstellungen importieren können extern gespeicherte Einstellungen einer ADOIT-Bibliothek aus dem Dateisystem importiert und in der Datenbank gespeichert werden.

Um gespeicherte Bibliothekseinstellungen zu importieren:

  1. Aktivieren Sie das Tab Einstellungen im Katalog.

  2. Wählen Sie im Kontextmenü der gewünschten Bibliothek den Menüpunkt Bibliothekseinstellungen importieren... aus. Ein Dialog mit Einstellungen für den Import öffnet sich.

  3. Geben Sie den Pfad und den Namen der Importdatei im Feld Dateiname ein (entweder manuell oder über den Unterstützungsdialog Durchsuchen...).

  4. Bestätigen Sie mit Importieren. Der Import wird durchgeführt. Eine Erfolgsmeldung erscheint.

Optional können Sie auch:

  • Übersetzungseinstellungen aus einer anderen Bibliothek importieren auswählen, falls die Bibliothekseinstellungen aus einer anderen Bibliothek oder Bibliotheksversion als jener in der Datenbank stammen (oder wenn Sie sich diesbezüglich nicht sicher sind). In diesem Fall erfolgt ein zusätzlicher Abgleich über die Namen der Elemente (nicht nur über interne ID-Nummern), um zusammenpassende Elemente mit unterschiedlichen IDs abgleichen zu können.

Bibliothek überprüfen

Eine erfolgreiche Bibliothek wird oft über viele Jahre kontinuierlich weiterentwickelt. Dabei können sich aber mit wachsender Größe und Komplexität Probleme einnisten, die oft auf den ersten Blick nicht erkennbar sind. Die Funktion Bibliothek überprüfen ermöglicht es, diese Probleme aufzuspüren.

Um eine Bibliothek zu überprüfen:

  1. Wählen Sie die Bibliothek im Bibliothekenkatalog aus.

  2. Klicken Sie mit der rechten Maustaste auf die Bibliothek, und klicken Sie dann auf Bibliothek überprüfen. Die Überprüfung wird durchgeführt und das Ergebnis als Registerkarte im Arbeitsbereich angezeigt.

Ergebnis

Der obere Teil der Registerkarte enthält die allgemeinen Informationen (Bibliotheksname, Zeitpunkt der Überprüfung, Fehlerübersicht …). Darunter befindet sich ein Sichtfenster, in dem Fehler, Warnungen und Informationen detailliert aufgelistet sind. Die Einträge sind nach Kategorien sortiert.

 Bibliothek überprüfen – Ergebnis

Mit einem Klick auf das Icon können Sie eine Kategorie aufklappen und die Einträge lesen.

Beispiel

In obigem Beispiel sieht man, dass die Bibliothek keinen Fehler beinhaltet und dass während der Überprüfung immerhin 13 Warnungen aufgetreten sind. Diese verteilen sich auf die Bibliotheksmodule Notebook-Definitionen und Bibliotheks-Kernel; die anderen Module sind fehlerfrei.

Weiterführende Funktionen

Die Bibliotheksüberprüfung bietet folgende erweiterte Funktionen an:

Auto-Korrektur

Um Fehler wenn möglich automatisch korrigieren zu lassen:

  • Klicken Sie auf Auto-Korrektur.

Die Auto-Korrektur wird durchgeführt und der Inhalt der Registerkarte aktualisiert.

Erneut überprüfen

Um dieselbe Bibliothek noch einmal zu überprüfen (beispielsweise nach Änderungen)

  • Klicken Sie auf Erneut überprüfen.

Die Bibliotheksüberprüfung wird wiederholt und der Inhalt der Registerkarte aktualisiert.

Details in die Zwischenablage kopieren

Um das Überprüfungsergebnis in die Zwischenablage zu kopieren:

  • Klicken Sie auf Details in die Zwischenablage kopieren.

Das Überprüfungsergebnis wird direkt in die Zwischenablage kopiert und kann überall dort eingefügt werden, wo Sie es gerade brauchen.

Bibliothek exportieren

Zur Sicherung und zur Verteilung von Bibliotheken an nicht vernetzte ADOIT-Administratoren ist es möglich, die in der Datenbank gespeicherten Bibliotheksinformationen als Datei im AXL-Format ins Dateisystem zu exportieren. Um eine Bibliothek zu exportieren:

 Bibliothek exportieren

  1. Öffnen Sie die Bibliothekenverwaltung über die Komponentenauswahl (1).

  2. Wählen Sie die Bibliothek im Bibliothekskatalog aus (2).

  3. Öffnen Sie im Kontextmenü der Bibliothek den Menüpunkt Bibliothek exportieren... (3). Der Export-Dialog öffnet sich.

  4. Wählen Sie in der Dropdown-Liste Sprachen exportieren aus, ob die Bibliothek mit allen verfügbaren Sprachen exportiert werden soll oder nur mit einer spezifischen (4).

  5. Geben Sie den Pfad und den Namen der Exportdatei im Feld Exportdatei ein (entweder manuell oder über den Unterstützungsdialog Durchsuchen...) (5).

  6. Bestätigen Sie mit Exportieren (6).

Bibliothek importieren

Um zusätzliche Bibliotheken zu laden, steht der Bibliotheksimport zur Verfügung. Um eine Bibliothek zu importieren:

 Bibliothek importieren

  1. Öffnen Sie die Bibliothekenverwaltung über die Komponentenauswahl (1).

  2. Wählen Sie Menü Bibliotheken - Menüeintrag Bibliothek importieren... (2). Ein Dialog-Fenster mit den Import-Einstellungen öffnet sich.

  3. Geben Sie den Pfad und den Namen der Sicherungsdatei im Feld Importdatei ein (entweder manuell oder über den Unterstützungsdialog Durchsuchen...) (3).

  4. Bestätigen Sie mit Importieren (4). Die Daten werden importiert und eine Bestätigung erscheint.

  5. Klicken Sie auf Meldungen einblenden >> um sicherzustellen, dass der Import erfolgreich war.

Bibliothek aktualisieren

Mit dieser Funktion können Sie für eine gespeicherte Bibliothek ein Update auf eine neuere Version durchführen. Um eine Bibliothek zu aktualisieren:

 Bibliothek aktualisieren

  1. Öffnen Sie die Bibliothekenverwaltung über die Komponentenauswahl (1).

  2. Wählen Sie die Bibliothek im Bibliothekskatalog aus (2).

  3. Klicken Sie im Menü Bibliotheken auf Bibliothek aktualisieren... (3). Ein Dialog-Fenster mit den Import-Einstellungen öffnet sich.

  4. Geben Sie den Pfad und den Namen der Updatedatei im Feld Importdatei ein (entweder manuell oder über den Unterstützungsdialog Durchsuchen...) (4).

  5. Aktivieren Sie das Kontrollkästchen Komponenteneinstellungen nicht importieren (5), um Ihre aktuellen Komponenteneinstellungen zu behalten. Wenn dieses Kontrollkästchen deaktiviert ist, werden durch das Aktualisieren der Bibliothek alle Komponenteneinstellungen in ADOIT mit den Komponenteneinstellungen aus der Importdatei überschrieben und Sie verlieren Ihre Änderungen.

  6. Bestätigen Sie mit Importieren (6). Ein Dialogfenster öffnet sich. Sie müssen sich jetzt entscheiden, ob Sie die existierende Bibliothek mit den Inhalten der Updatedatei überschreiben wollen. Klicken Sie auf Ja, um fortzufahren. Die Daten werden importiert und ein Dialogfenster zur Bestätigung öffnet sich.

  7. Klicken Sie auf Meldungen einblenden >> um sicherzustellen, dass der Import erfolgreich war.

Hinweis

Die Primärsprache wird während der Bibliotheksaktualisierung nicht geändert, auch wenn die neue Version eine andere Primärsprache als die Bibliothek in der Datenbank hat.

Übersetzungsrelevanz festlegen

Jede Bibliothek und ihr Metamodell (alle Modell-, Objekt- und Konnektortypen) besitzen Attribute verschiedenster Typen, darunter natürlich auch Textattribute. Mit der Funktion Übersetzungsrelevanz festlegen kann definiert werden, welche Textattribute eines Metamodells bzw. einer Bibliothek von Übersetzern bearbeitet werden sollen (= übersetzungsrelevant sind) und welche für alle Sprachen gleich bleiben sollen. Übersetzungsrelevante Attribute werden im Übersetzungseditor angezeigt, nicht relevante Attribute ausgeblendet.

Hinweis

Diese Funktion steht nur in mehrsprachigen Produktkonfigurationen zur Verfügung.

Um die Übersetzungsrelevanz innerhalb einer Bibliothek festzulegen:

 Übersetzungsrelevanz festlegen

  1. Wählen Sie das Tab Einstellungen im Katalog aus.

  2. Wählen Sie den gewünschten Eintrag im Katalog aus. Im Arbeitsbereich öffnet sich ein Tab mit Textattributen.

  3. Die Spalte Übersetzung zeigt, ob das Attribut übersetzungsrelevant ist () oder nicht (). Doppelklicken Sie hier, um den Status zu ändern.

Ausgegraute Zeilen beinhalten schreibgeschützte Attribute. Da diese nicht von Benutzern befüllt werden, sind sie auch nicht übersetzungsrelevant.

Hinweis

Bibliotheksinterne und versteckte Attribute besitzen niemals Übersetzungsrelevanz und werden daher hier nicht angezeigt.

Weitere Funktionen

Die folgenden erweiterten Funktionen stehen zur Verfügung:

Metamodellfragment importieren

Mit dieser Funktion können Sie eine JavaScript-Datei importieren, die Informationen über Metamodellelemente enthält.

Hinweis

Eine detaillierte Beschreibung dieser Funktionalität geht über den Rahmen dieses Handbuchs hinaus. Wenn Sie Fragen haben, wenden Sie sich bitte an Ihren ADOIT-Kundenbetreuer.

Bibliotheksspezifische Komponenteneinstellungen

Dieses Modul ermöglicht einem Administrator, eine breite Palette von bibliotheksspezifischen Komponenteneinstellungen anzupassen.

Komponenteneinstellungen aktivieren

Um die Komponenteneinstellungen auszuwählen:

  • Wechseln Sie im Katalog der Bibliothekenverwaltung zum Tab Komponenteneinstellungen.

  • Doppelklicken Sie eine Bibliothek im Katalog, um die Liste der Komponenten zu öffnen, die konfiguriert werden können.

Hinweis

Je nach Werkzeugkonfiguration stehen verschiedene Komponenten zur Verfügung.

Der Startbildschirm der Komponenteneinstellungen enthält Links zu den wichtigsten Konfigurations-Funktionen. Je nachdem welche Komponente ausgewählt ist, stehen die folgenden Funktionen zur Verfügung:

  • Konfiguration erstellen

    Eine neue Konfiguration für die ausgewählte Komponente hinzufügen.

  • Konfiguration bearbeiten

    Die ausgewählte Konfiguration bearbeiten.

  • Konfiguration löschen

    Die ausgewählte Konfiguration löschen.

  • Komponenteneinstellungen importieren

    Konfigurationseinstellungen für Komponenten importieren. Für Details beziehen Sie sich bitte auf den Abschnitt Bibliotheksspezifische Komponenteneinstellungen migrieren.

  • Komponenteneinstellungen exportieren

    Die Einstellungen der ausgewählten Komponente exportieren. Für Details beziehen Sie sich bitte auf den Abschnitt Bibliotheksspezifische Komponenteneinstellungen sichern.

Authentifizierung

Die Einstellungen für die Authentifizierung in ADOIT sind hier als bibliotheksspezifische Komponenteneinstellung hinterlegt. Diese Einstellungen sind im Administrations-Toolkit schreibgeschützt. Sie können diese Einstellungen auf der Administratorseite bearbeiten.

BIA-Konfiguration

Sie haben die Möglichkeit, verschiedene BIA-Einstellungen zu konfigurieren und verschiedene Modellierungsklassen und Relationsklassen aus der BIA-Konfiguration auszuschließen. Die ausgeschlossenen Klassen können nicht im Konfigurationsfenster ausgewählt werden. Die folgenden Einstellungen stehen zur Verfügung:

  • Einstellungen

    Dieses Tab ermöglicht die Festlegung einer Vielzahl von allgemeinen Einstellungen für die BIA-Konfiguration.

  • Modellierungsklassen

    Wählen Sie die Modellierungsklassen aus, die in einer BIA-Konfiguration verwendet werden können.

  • Relationsklassen

    Wählen Sie die Relationsklassen aus, die in einer BIA-Konfiguration verwendet werden können.

ClamAV Virenscanner

Durch Integration des ClamAV Virenscanners in ADOIT können Dateien auf Virusinfektionen überprüft werden, die in die ADOIT-Datenbank hochgeladen werden (Dokumente, Mediendateien, an Kommentare angehängte Dateien etc.) oder auf Ihr Gerät heruntergeladen werden.

Hinweis

Detaillierte Anweisungen zur Integration von ClamAV in ADOIT finden Sie im Kapitel Virenprüfung für Datei-Uploads aktivieren im Installationshandbuch.

Cluster Map-Konfiguration

Sie können festlegen, welche Optionen für die Pfad-Evaluierung beim Anlegen von Cluster Maps verfügbar sind. Die folgenden Einstellungen stehen zur Verfügung:

  • Optionen für den Auswertungspfad

    Wählen Sie die Optionen für die Pfad-Evaluierung aus, die in ADOIT verwendet werden können.

Allgemein

Hier verwalten Sie Konfigurationsoptionen für verschiedene allgemeine Einstellungen.

Änderungshistorie

Veränderungen an Repository-Objekten können in der Änderungshistorie erfasst werden. Web-Client Benutzer können über das Notebook eines Objekts auf die Änderungshistorie zugreifen.

Wählen Sie Konfiguration bearbeiten aus, um die Einstellungen für die Änderungshistorie zu öffnen. Die folgenden Einstellungen stehen zur Verfügung.

  • Änderungshistorie aktivieren

    Aktivieren oder deaktivieren Sie die Änderungshistorie über das Kontrollkästchen.

  • Tabellenattribut für die Änderungshistorie

    Wählen Sie das Tabellenattribut für die Änderungshistorie aus der Dropdown-Liste aus.

  • Maximale Anzahl der Einträge in der Änderungshistorie

    Wählen Sie die maximale Anzahl der Einträge in der Änderungshistorie aus.

  • Änderungshistorie im Web-Client verfügbar machen

    Aktivieren oder deaktivieren Sie die Änderungshistorie im Web-Client über das Kontrollkästchen. Wenn diese Option aktiviert ist, können Sie festlegen, welche Spalten der Änderungshistorie im Web-Client angezeigt werden sollen.

  • Alle Einträge unabhängig von Metamodellrechten anzeigen

    Standardmäßig wird die vollständige Änderungshistorie eines Repository-Objekts ausgeblendet, wenn der Benutzer aufgrund von Metamodellrechten auf ein oder mehrere Objektattribute keinen Zugriff hat. Aktivieren Sie dieses Kontrollkästchen, um unabhängig von Einschränkungen durch Metamodellrechte immer die vollständige Änderungshistorie anzuzeigen.

Datenaktualität

Achtung

Dieser Abschnitt beschreibt die veralteten Einstellungen für Datenaktualität in der Gruppe Allgemein. Diese Einstellungen sind in ADOIT 12.0 schreibgeschützt. Verwenden Sie stattdessen den neuen Menüeintrag auf der ersten Ebene der Komponenteneinstellungen.

Wählen Sie Konfiguration bearbeiten aus, um die Einstellungen für die Datenaktualität zu öffnen. Die folgenden Einstellungen stehen zur Verfügung:

  • Attribut für die Datenaktualität

    Wählen Sie das Attribut aus, nach dem die Bewertung der Datenaktualität ausgerichtet werden soll.

  • Anzahl der Tage nach denen ein Objekt als 'gelb' gekennzeichnet wird

    Wählen Sie aus, nach wie vielen Tagen ein Objekt als 'gelb' markiert wird, wenn es nicht vom Anwendungsverantwortlichen bestätigt wurde. Gleichzeitig erhält der Benutzer eine Benachrichtigung.

  • Anzahl der Tage nach denen ein Objekt als 'rot' gekennzeichnet wird

    Wählen Sie aus, nach wie vielen Tagen ein Objekt als 'rot' markiert wird, wenn es nicht vom Anwendungsverantwortlichen bestätigt wurde.

Dokumentverwaltung

Hier konfigurieren Sie einen Objekttyp, mit dem Web-Client Benutzer externe Dateien in die Datenbank hochladen können. Standardmäßig werden die importierten Dateien als Dokumente im Objektkatalog verwaltet. Wenn ein Repository zu Backup- und Migrationszwecken exportiert wird, werden die externen Dateien in der Datenbank mitexportiert.

Wählen Sie Konfiguration bearbeiten aus, um die Einstellungen für die Dokumentverwaltung zu öffnen. Die folgenden Einstellungen stehen zur Verfügung:

  • Dokumentverwaltung aktivieren

    Aktivieren oder deaktivieren Sie die Dokumentverwaltung über das Kontrollkästchen.

  • Klasse für die Dokumentverwaltung

    Wählen Sie aus der Dropdown-Liste eine Klasse für die Dokumentverwaltung aus.

  • Attribut für die Dokumentverwaltung

    Wählen Sie aus der Dropdown-Liste ein Attribut für die Dokumentverwaltung aus.

  • Maximale Dateigröße (MB)

    Wählen Sie die erlaubte maximale Dateigröße für Dateien in der Datenbank (bis zu 50 MB).

  • Erlaubte Dateitypen

    Wählen Sie die Dateitypen aus, die Web-Client Benutzer in die Datenbank hochladen können. Trennen Sie die Dateiendungen mit einem Leerzeichen.

    Zulässige Dateitypen sind: doc, docx, ppt, pptx, xls, xlsx, csv, txt, pdf, rtf, png, jpg, gif, jpeg, bmp, zip, rar, 7z, axr, xml, bpmn

    Alle weiteren Dateitypen sind standardmäßig gesperrt. Damit Sie zusätzliche Dateitypen zu dieser Liste hinzufügen können, müssen Sie eine Konfigurationsdatei anpassen.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Mediaverwaltung

Hier konfigurieren Sie ein Objektattribut, mit dem Web-Client Benutzer externe Mediendateien in die Datenbank hochladen können.

Wenn der Benutzer eine Bilddatei (PNG, JPG, etc.) hochlädt und der Objekttyp korrekt konfiguriert ist, wir der Inhalt der Bilddatei anstelle der Standardrepräsentation des Objekts im grafischen Editor angezeigt. Standardmäßig trifft das auf Notizen zu.

Wenn ein Repository zu Backup- und Migrationszwecken exportiert wird, werden die externe Mediendateien in der Datenbank mitexportiert.

Wählen Sie Konfiguration bearbeiten aus, um die Einstellungen für die Mediaverwaltung zu öffnen. Die folgenden Einstellungen stehen zur Verfügung:

  • Mediaverwaltung aktivieren

    Aktivieren oder deaktivieren Sie die Mediaverwaltung über das Kontrollkästchen.

  • Attribut für die Mediaverwaltung

    Wählen Sie aus der Dropdown-Liste ein Attribut für die Mediaverwaltung aus.

  • Maximale Dateigröße (MB)

    Wählen Sie die erlaubte maximale Dateigröße für Dateien in der Datenbank.

  • Erlaubte Dateitypen

    Wählen Sie die erlaubten Dateitypen für Dateien in der Datenbank aus. Trennen Sie die Dateiendungen mit einem Leerzeichen.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Objektverantwortliche

In ADOIT ist es möglich, einen Benutzer als Objektverantwortlichen für Repository-Objekte einzutragen. Der Benutzer wird dazu:

  • ArchiMate-Anwendungsbibliothek: Als Durchführungsverantwortlicher Geschäfts-Akteur festgelegt (Objektattribut im Notebook-Kapitel "Organisation").

  • ADOIT Standard-Anwendungsbibliothek: Als Verantwortliche Person festgelegt (Objektattribut im Notebook-Kapitel "Organisation").

Hinweis

Alternativ können Sie eine andere Relationsklasse auswählen, um die Verantwortlichkeit zu definieren.

Der Objektverantwortliche ist für das Objekt inhaltlich verantwortlich. Folgende Einstellungen stehen zur Verfügung:

  • Benutzer bei der Erstellung eines Objektes automatisch als Objektverantwortlichen eintragen

    Wählen Sie aus, ob ein Benutzer, der ein Objekt erstellt, automatisch als Objektverantwortlicher eingetragen wird.

  • Relationsklasse, die verwendet werden soll, um eine Verantwortlichkeit zu definieren

    Wählen Sie eine Relationsklasse aus der Dropdown-Liste aus. Mit dieser Klasse wird festgelegt, welche Art von Verantwortung sich ergibt, wenn der Benutzer ein Objekt erstellt und die erste Option aktiv ist.

    [OOO]

    Wenn Sie eine Relationsklasse mit dem Zusatz [OOO] ausgewählen, erhält ein Objektverantwortlicher IMMER Schreibrechte auf das Objekt. Was für ein Recht vorher auf das Objekt bestanden hat, hat keine Auswirkung.

    Nach der Zuweisung können ADOIT Administratoren die Rechte des Objektverantwortlichen beliebig anpassen. Wenn die Referenz auf den Benutzer gelöscht wird, gilt das in einer übergeordneten Hierarchieebene (Gruppe) gesetzte Recht.

Corporate Identity

Das Corporate Identity-Schema (CI-Schema) einer Organisation kann in verschiedenen Publikationen in ADOIT eingebettet werden (z.B. beim Drucken von Modellen als PDF und beim Erzeugen von Reports). Die folgenden Einstellungen stehen zur Verfügung:

  • Name der Corporate Identity

    Geben Sie einen Namen für das CI-Schema ein, das Sie erstellen wollen.

  • Logo, das in der Kopfzeile von Reports dargestellt werden soll

    Klicken Sie auf Durchsuchen..., um ein Logo hochzuladen, das in Publikationen angezeigt werden soll.

  • Grafik, die als Banner auf Szenario-Startseiten und Dashboards angezeigt werden kann

    Klicken Sie auf Durchsuchen..., um ein Bannerbild hochzuladen, das oben auf der "Gestalten & Dokumentieren" Startseite dargestellt werden soll.

Hinweis

In der ADOIT Standard-Anwendungsbibliothek ist die Funktionalität Grafik, die als Banner auf Szenario-Startseiten und Dashboards angezeigt werden kann nicht verfügbar

  • Unternehmensdaten

    Geben Sie den Namen des Unternehmens, die Postadresse und weitere Unternehmensdaten in den entsprechenden Feldern ein.

  • Als Standard verwenden

    Wählen Sie aus, ob dieses CI-Schema bei der Erstellung von Publikationen als Standard eingestellt ist. Diese Einstellung kann von den Benutzern des ADOIT Web-Clients entsprechend ihrer persönlichen Vorlieben überschrieben werden.

Größe von Bildern

Bilder sollten diesen Vorgaben entsprechen:

TypBreite & HöheDateigrößeFormat
BannerEmpfohlene Größe: 2000 x 1000 Pixel (weitere Informationen finden Sie unterhalb der Tabelle).Weniger als 5MBJPG, PNG, BMP, GIF oder SVG
LogoMindestens 260 x 260 Pixel. Seitenverhältnis ca. 1:1 für beste Ergebnisse.Weniger als 5MBJPG, PNG, BMP oder GIF

Bannerbilder werden aufgrund unterschiedlicher Bildschirmgrößen automatisch zugeschnitten. Dies geschieht vor allem auf breiten Bildschirmen, wo der obere und untere Teil abgeschnitten werden. Platzieren Sie daher den wichtigsten Teil des Bildes (z. B. Logo und Text) in der Mitte. Der empfohlene, sichere Inhaltsbereich ist etwa 2000 x 150 Pixel groß.

 Bannerbild - Sicherer Inhaltsbereich

Datenaktualität

In diesem Bereich können Sie Einstellungen für die Datenaktualität von Objekten konfigurieren.

Attribut für die Datenaktualität

Wählen Sie das Attribut aus, nach dem die Bewertung der Datenaktualität ausgerichtet werden soll.

Globaler Schwellenwert (Standardwert wenn kein klassenspezifischer Wert definiert ist)

Hier können Sie globale Schwellenwerte definieren zur Bewertung der Datenaktualität. Diese Einstellungen gelten für alle Objekttypen, wenn keine klassenspezifischen Werte definiert wurden.

  • Anzahl der Tage nach denen ein Objekt 'gelb' markiert wird

    Wählen Sie aus, nach wie vielen Tagen ein Objekt als 'gelb' markiert wird, wenn es nicht vom Anwendungsverantwortlichen bestätigt wurde. Gleichzeitig erhält der Benutzer eine Benachrichtigung.

  • Anzahl der Tage nach denen ein Objekt 'rot' markiert wird

    Wählen Sie aus, nach wie vielen Tagen ein Objekt als 'rot' markiert wird, wenn es nicht vom Anwendungsverantwortlichen bestätigt wurde.

Schwellenwert (pro Klasse)

Hier können Sie individuelle Schwellenwerte für bestimmte Klassen festlegen und damit die globalen Schwellenwerte außer Kraft setzen.

  • Klicken Sie dort, wo sich eine Zeile (= Klasse) und eine Spalte (= gelber oder roter Status) treffen, um die Schwellenwerte zu bearbeiten.

Element-Erstellung Konfiguration

Mit den Einstellungen in diesem Bereich können Sie Web-Client Benutzer beim Erstellen neuer Modelle und Objekte unterstützen. Sie können ein Set von Modell- und Objekttypen definieren, die im Bereich Empfehlungen auf der Seite Neu angezeigt werden.

Hinweis

Wenn keine empfohlenen Elemente konfiguriert wurden, ist der Bereich Empfehlungen nicht verfügbar.

Folgende Einstellungen sind verfügbar:

  • Empfehlungen zur Erstellung von Elementen

    Wählen Sie die Modell- und Objekttypen aus, die im Bereich Empfehlungen angezeigt werden werden sollen, und klicken Sie dann auf Hinzufügen. Die Reihenfolge, in der diese Elemente visualisiert werden, kann im rechten Fenster angepasst werden.

  • Empfehlungen

    Passen Sie über die Schaltflächen zwischen den beiden Fenstern (nach oben, nach unten, zum Anfang oder zum Ende) die Reihenfolge an, in der die ausgewählten Elemente visualisiert werden.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Konfiguration für die Element-Erstellung wird in der Datenbank gespeichert und ist sofort im Web-Client verfügbar.

Hinweis

In der ADOIT Standard-Anwendungsbibliothek ist diese Funktionalität nicht verfügbar

Enterprise Architecture Management

In diesem Bereich können Sie spezielle Funktionen für Anwendungen oder Architekturelemente konfigurieren.

ArchiMate-Anwendungsbibliothek

Wenn Sie die ArchiMate-Anwendungsbibliothek verwenden, sind folgende Einstellungen verfügbar:

  • Gewähren Sie dem Verantwortlichen Schreibzugriff auf die Objektgruppe, welche das Architekturelement enthält

    In ADOIT ist es möglich, einen Benutzer als Objektverantwortlichen für ein Repository-Objekt einzutragen (siehe Abschnitt Objektverantwortliche). Legen Sie fest, ob der Verantwortliche Schreibrechte auf die Objektgruppe mit dem Repository-Objekt erhält, auch wenn er normalerweise nur Leserechte besitzt. Wenn der Benutzer entfernt wird, werden die Rechte auf die Objektgruppe auf vererbt zurückgesetzt.

ADOIT Standard-Anwendungsbibliothek

Wenn Sie die ADOIT Standard-Anwendungsbibliothek verwenden, sind folgende Einstellungen verfügbar:

  • Gewähren Sie dem Anwendungsverantwortlichen Schreibzugriff auf die Objektgruppe, welche die Anwendung enthält

    In ADOIT ist es möglich, einen Benutzer als Objektverantwortlichen für eine Anwendung einzutragen (siehe Abschnitt Objektverantwortliche). Legen Sie fest, ob der Anwendungsverantwortliche Schreibrechte auf die Objektgruppe mit der Anwendung erhält, auch wenn er normalerweise nur Leserechte besitzt. Wenn der Benutzer entfernt wird, werden die Rechte auf die Objektgruppe auf vererbt zurückgesetzt.

  • Verantwortung für die Anwendung auf alle bereitgestellten Schnittstellen übertragen

    Legen Sie fest, ob der Anwendungsverantwortliche automatisch als Objektverantwortlicher für alle bereitgestellten Schnittstellen zugewiesen wird. Wenn der Anwendungsverantwortliche entfernt wird, wird er auch aus allen bereitgestellten Schnittstellen entfernt.

  • Anwendungsverantwortliche informieren, wenn genutzte Schnittstellen gelöscht werden

    Legen Sie fest, ob ADOIT automatisch E-Mails an den Anwendungsverantwortlichen sendet, wenn genutzte Schnittstellen gelöscht werden.

Excel-Import

In ADOIT ist eine konfigurierbare Excel-Schnittstelle zur schnellen Datenerfassung integriert. Über die Excel-Schnittstelle können Sie Repository-Objekte mit ihren Attributen und Relationen aus einer Excel-Datei importieren. Für diesen Prozess wird die Struktur der Excel-Datei in einer XML-Konfigurationsdatei beschrieben.

Konfiguration erstellen

Eine XML-Konfigurationsdatei enthält die Zuordnung von Objekten aus der Excel-Datei zum ADOIT Metamodell.

 Beispiel einer Excel-Datei mit Objekten und ihren Attributen

  • Die Excel-Datei kann aus beliebig vielen Tabellenblättern bestehen

  • Jedes Tabellenblatt enthält nur Objekte eines Typs (1)

    Beispiel - XML-Konfigurationsdatei

    Eine Konfiguration für ein Tabellenblatt könnte so aussehen:

    <sheet name="Applications" class_name="C_APPLICATION" id="2" data_row="4">

    <sheet name> ist der Name des Tabellenblatts in Excel. <class_name> ist der sprachunabhängige Name des Objekttyps. <id> ist die Nummer der Spalte, die das Objekt eindeutig identifiziert. <data_row> ist die erste Zeile, die ein Objekt enthält.

  • Jede Zeile des Tabellenblatts enthält ein Objekt (2)

  • Jede Spalte enthält ein Attribut oder eine Relation zu einem anderen Objekt (3)

    Beispiel - XML-Konfigurationsdatei

    Eine Konfiguration für ein Attribut könnte so aussehen:

    <attribute name="A_DESCRIPTION" type="simple" context="en" column="5"/>

    <attribute name> ist der sprachunabhängige Name des Attributs. <type> ist der Attributtyp. <context> definiert die Sprache der Objekte, die importiert werden. <column> ist die Nummer der Spalte.

  • Eine eindeutige Kennung (Name, ID etc.) wird für jedes Objekt benötigt

  • Folgende Attributtypen können importiert werden: simple, date, enum, treeenumlist, enum_list, bool, relation und file_pointer

Wenn Sie die ArchiMate-Anwendungsbibliothek oder die ADOIT Standard-Anwendungsbibliothek verwenden, sind bereits eine oder mehrere Beispielkonfigurationen im Administrations-Toolkit verfügbar. Bei jeder Konfiguration ist eine passende Excel-Datei hinterlegt.

Hinweis

Einen vollständige Beschreibung der Konfigurationsmöglichkeiten für den Excel-Import ist nicht Teil dieses Handbuchs. Wenn Sie Ihre eigene Konfigurationen erstellen möchten, wenden Sie sich bitte an Ihren ADOIT-Kundenbetreuer.

Um erfolgreich eine Konfiguration zu erstellen, müssen Sie Zugriff auf die Metamodellverwaltung haben. Die sprachunabhängigen Namen von Objekttypen, Attributen usw. sind dort zu finden und werden für die Konfiguration benötigt.

Konfiguration importieren

Damit Sie eine bestimmte Konfiguration benutzen können, müssen Sie sie zuerst die XML-Konfigurationsdatei in ADOIT importieren:

  1. Klicken Sie im Tab Komponenteneinstellungen mit der rechten Maustaste auf Excel-Import, und klicken Sie dann auf Konfiguration erstellen.

  2. Geben Sie im Feld Name der Konfiguration einen Namen für die Konfiguration ein.

  3. Klicken Sie auf die Konfigurationsdatei einlesen Schaltfläche und doppelklicken sie auf die XML-Konfigurationsdatei. Die Konfiguration wird importiert und im Feld Vorschau angezeigt.

  4. Klicken Sie auf OK.

Die Konfiguration wird gespeichert. Sie können jetzt Objekte aus jeder Excel-Datei importieren, die der Konfiguration entspricht.

Excel-Datei als Vorlage importieren

Zu jeder Konfiguration können Sie eine passende Excel-Datei als Vorlage importieren.

  1. Doppelklicken Sie die Konfiguration, für die Sie eine Vorlage importieren möchten.

  2. Klicken Sie auf die Vorlage einlesen Schaltfläche und doppelklicken sie auf die Excel-Datei. Die Konfiguration wird importiert.

  3. Klicken Sie auf OK.

Die Konfiguration wird gespeichert. Die Vorlage steht jetzt im Excel Import-Dialog im Web-Client zum Download bereit. Anwender können die Vorlage herunterladen, darin Objekte erfassen und dann die Objekte importieren.

Gantt-Konfiguration

Sie haben die Möglichkeit, Modellierungsklassen und Attribute aus der Gantt-Konfiguration auszuschließen. Die ausgeschlossenen Klassen und Attribute können nicht im Konfigurationsfenster ausgewählt werden. Die folgenden Einstellungen stehen zur Verfügung:

  • Allgemeine Einstellungen

    Wählen Sie individuelle Farbeinstellungen für Gantt-Sichten oder verwenden Sie die Standardeinstellungen.

  • Modellierungsklassen

    Wählen Sie die Modellierungsklassen aus, die in einer Gantt-Konfiguration verwendet werden können.

  • Attribute

    Wählen Sie die Attribute aus, die in einer Gantt-Konfiguration verwendet werden können.

HTML-Publikation

Standardmäßig wird die Suchseite als Startseite einer HTML-Publikation angezeigt, einschließlich eingebetteter Corporate Identity-Elemente. Sie können stattdessen eine benutzerdefinierte Startseite konfigurieren. Dazu laden Sie eine einzelne HTML-Seite hoch.

Die hochgeladene Datei muss alle Bilder, Skripte, Stilinformationen usw. inline enthalten oder diese Ressourcen von einer referenzierten Webseite herunterladen. Um Bilder inline in die HTML-Seite einzubinden, müssen diese in Base64-codiert eingebettet sein.

Folgende Einstellungen stehen zur Verfügung:

  • Benutzerdefinierte Startseite deaktivieren

    Legen Sie fest, ob die hochgeladene Datei in HTML-Publikationen angezeigt wird. Diese Option ist nützlich, wenn Sie eine benutzerdefinierte Startseite vorübergehend deaktivieren möchten.

  • Benutzerdefinierte Startseite - Dateiname

    Laden Sie eine HTML-Seite hoch. Klicken Sie auf die Durchsuchen Schaltfläche, klicken Sie auf die HTML-Seite, die Sie verwenden möchten, und klicken Sie dann auf OK.

  • Benutzerdefinierte Startseite - Dateiinhalt

    Hier wird der Inhalt der hochgeladenen HTML-Datei angezeigt.

Integration - Konfiguration & Datenkonnektoren

Der ADOIT-Integrationsframework ist eine generische ADOIT-Erweiterung zum Erstellen und Konfigurieren von Adaptern. Mit diesen Adaptern kann eine Verbindung zu Tools von Drittanbietern hergestellt werden, die eine HTTP-Schnittstelle zum Abrufen von Daten bereitstellen.

Hinweis

Eine detaillierte Beschreibung dieser Funktionalität geht über den Rahmen dieses Handbuchs hinaus. Wenn Sie Fragen haben, wenden Sie sich bitte an Ihren ADOIT-Kundenbetreuer.

Layout

Hier verwalten Sie Konfigurationsoptionen für verschiedene Layout-Einstellungen.

Analyse

Die Analyse-Einstellungen definieren das Layout eines Abfrageergebnis-Modells. Abfrageergebnis-Modelle werden verwendet, um die Ergebnisse einer grafischen oder tabellarischen Analyse als Modell zu speichern. Die folgenden Einstellungen stehen zur Verfügung:

  • Modelltyp

    Wählen Sie einen Modelltyp als Basis für das Abfrageergebnis-Modell aus. Im Normalfall wählen Sie dafür das Architektur-Diagramm oder Analysemodell.

  • Schwimmbahnklasse

    Wählen Sie eine Schwimmbahnklasse zur Strukturierung aller Objekte einer Klasse im Modell aus.

  • Schwimmbahnreihenfolge

    Wählen Sie die Reihenfolge aus, in der die Schwimmbahnen im Modell dargestellt werden.

  • Ausrichtung der Schwimmbahnen

    Wählen Sie aus, ob die Schwimmbahnen im Modell horizontal oder vertikal angeordnet werden sollen.

Management Office Integration

ADOIT ermöglicht die Synchronisation von Objekten mit anderen BOC Management Office-Produkten. Die Synchronisation erfolgt zwischen dem ADOIT Web-Client und dem Web-Client eines anderen BOC Management Office-Produkts. Objekte werden aus dem Ausgangsprodukt exportiert und in das Zielprodukt importiert. Für die Kommunikation zwischen den Produkten wird eine REST API verwendet.

ADOIT-Administratoren können im Administrations-Toolkit konfigurieren, welche Objekttypen synchronisiert werden und in welcher Zielgruppe synchronisierte Objekte platziert werden. Die Synchronisation kann entweder manuell (im Web-Client) oder automatisch periodisch durchgeführt werden.

Hinweis

Die Verfügbarkeit dieser Funktionalität hängt von der Lizenz ab.

Hinweis

Für Details zu diesem Thema beziehen Sie sich bitte auf das Dokument "Management Office Integration" auf dem ADOIT Installationsmedium im Ordner “02 Rich Client\BOC\ADOIT 12.0\books\german”.

Matrix-Konfiguration

Hier können Sie Konfigurationsoptionen für Matrix-Sichten verwalten. Folgende Einstellungen sind verfügbar:

Allgemeine Einstellungen

  • Schreibende Änderungen in Matrix-Sichten erlauben

    Aktivieren Sie dieses Kontrollkästchen, damit Benutzer nach dem Erstellen einer Matrix-Sicht innerhalb der Sicht die Objekte oder das Modell bearbeiten können, auf denen die Matrix-Sicht basiert. Damit können Benutzer beispielsweise in einer Matrix-Sicht Beziehungen zwischen Objekten hinzufügen, Änderungen an einer modell-basierten Matrix-Sicht speichern etc.

  • Erstellen der modell-basierten Matrix auf im Modell enthaltene Objekte einschränken

    Aktivieren Sie dieses Kontrollkästchen, damit eine Matrix-Sicht nur mit den Objekten im Modell erstellt wird. Ansonsten werden alle Objekte automatisch hinzugefügt, die zu den Ausgangsobjekten eine über die Matrix-Konfiguration definierte Beziehung besitzen.

    Hinweis

    Diese Einstellung gilt nur für Matrix-Sichten, die auf Modellen basieren. Matrix-Sichten, die auf Objekten basieren, werden immer automatisch vervollständigt.

  • Zelle Farbeinstellungen / Überschrift Farbeinstellungen

    Wählen Sie individuelle Farbeinstellungen für Matrix-Sichten aus oder verwenden Sie die Standardeinstellungen.

Modellierungsklassen

  • Wählen Sie die Modellierungsklassen aus, die in einer Matrix-Konfiguration verwendet werden können.

Relationsklassen

  • Wählen Sie die Relationsklassen aus, die in einer Matrix-Konfiguration verwendet werden können.
Hinweis

Wenn Sie Modellierungsklassen und Relationsklassen aus der Matrix-Konfiguration ausschließen, können die ausgeschlossenen Klassen nicht mehr im Konfigurationsfenster ausgewählt werden.

Metamodell Profil Konfigurator

Mit dem Metamodell Profil Konfigurator können Power-User im Web-Client zwischen verschiedenen vordefinierten Metamodell-Profilen wählen:

  • Metamodell-Profile reduzieren die Anzahl der verfügbaren Metamodellelemente.

  • Sie werden beim Login auf alle Benutzer angewendet.

  • Sie umfassen ein Set von Metamodellrechten, das in einer speziellen System-Rolle abgebildet wird.

  • Diese System-Rolle wird automatisch erstellt, wenn der Power-User ein Profil auswählt, und dann allen Benutzern zugewiesen.

  • Die System-Rolle hat den gleichen Namen wie das Profil (z.B. ADOIT für Fans einer Lean Architecture).

Konflikt mit anderen System-Rollen

Die Profileinstellungen werden möglicherweise beeinflusst, wenn es andere System-Rollen gibt, die relevant für Metamodellrechte sind.

Hinweis

Die Metamodell-Profile sind vordefiniert und können nicht durch den ADOIT-Administrator geändert werden. Wenn Sie die Konfiguration anpassen möchten, wenden Sie sich bitte an Ihren ADOIT-Kundenbetreuer.

Zugriff auf den Metamodell Profil Konfigurator einrichten

Als ADOIT-Administrator können Sie vertrauenswürdigen Benutzern in Ihrer Organisation die Erlaubnis erteilen, Metamodell-Profile auswählen. Weisen Sie Benutzergruppen oder individuellen Benutzern folgende System-Rolle zu:

  • MMProfileConfigurator

Wenn die System-Rolle MMProfileConfigurator in Ihrer Umgebung nicht verfügbar ist, können Sie Ihre eigene System-Rolle mit Zugriff auf den Metamodell Profil Konfigurator erstellen:

  1. Erstellen Sie folgende System-Rolle:

    • MMProfileConfigurator (oder ein anderer sprechender Name)
  2. Weisen Sie dieser System-Rolle folgendes Web-Modul zu:

    • Metamodel profile configurator

Fertig! Diese System-Rolle bietet Ihren Benutzern jetzt Zugriff auf den Metamodell Profil Konfigurator.

Modellzeitfilter

Der Modellzeitfilter ermöglicht es, Objekte im gerade geöffneten Modell / der gerade geöffneten Sicht nach ihrer Gültigkeitsdauer zu filtern. Die folgenden Einstellungen stehen zur Verfügung:

  • Modellierungsklassen, die vom Modellzeitfilter gefiltert werden

    Wählen Sie aus einer Liste von Klassen diejenigen aus, die vom Modellzeitfilter berücksichtigt werden sollen.

Organisationsportal

Das Organisationsportal erlaubt Mitarbeitern Ihrer Organisation einen einfachen und intuitiven Zugriff auf den Modellbestand in ADOIT. Personalisierte Dashboards und andere komplexe Funktionen kommen im Organisationsportal nicht vor. Typischerweise haben die Anwender sehr eingeschränkte Zugriffsrechte, wie z.B. nur lesenden Zugriff. Der Zugriff auf das Organisationsportal ist ohne eigenen ADOIT Benutzer möglich.

Hinweis

Die Verfügbarkeit des Organisationsportals hängt von der Lizenz ab.

Zugriff aufs Organisationsportal einrichten

Für den Zugriff auf das Organisationsportal müssen Sie mindestens einen Benutzer mit der passenden System-Rolle vorbereiten. Folgende Schritte sind zum Einrichten der Standardkonfiguration notwendig:

  1. Erstellen Sie folgende Benutzergruppe auf oberster Ebene:

    • Reader
  2. Bearbeiten Sie die Zugriffsrechte der Benutzergruppe "Reader" so, dass sie die folgenden Rechte hat:

    • Lesezugriff auf die Modellgruppe "(Standard-Gruppe)"

    • Lesezugriff auf die Objektgruppe "(Standard-Gruppe)"

  3. Erstellen Sie jetzt folgenden Benutzer und fügen Sie ihn zu der neu erstellten Benutzergruppe hinzu:

    • Benutzername: Reader, Passwort: Password123++. Haken Sie Vertrautes Login an und weisen Sie dem Benutzer das aktuelle Standard-Repository zu.
  4. Weisen Sie der neu erzeugten Benutzergruppe folgende vorkonfigurierte System-Rolle zu:

    • Organisationsportal
  5. Die System-Rolle "Organisationsportal" hat standardmäßig nur auf folgende Web-Module Zugriff:

    • Standard Organisationsportal
Hinweis

Die oben genannten Einstellungen stellen die Minimalkonfiguration dar. Sie können der System-Rolle "Organisationsportal" zusätzliche Web-Module zuweisen. Beachten Sie aber, dass die Komplexität des Organisationsportals sich als Ganzes erhöht, wenn ein Benutzer über zusätzliche Web-Module Zugriff auf mehr Funktionen erhält.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Organisationsportal konfigurieren

Um das Organisationsportal zu konfigurieren:

  • Wählen Sie Bibliothekenverwaltung > Komponenteneinstellungen >Organisationsportal > Allgemein.

Die erste Seite des Konfigurationsassistenten für das Organisationsportal öffnet sich im Tab Bibliothekenverwaltung.

Organisationsportal Konfigurationsassistent - Seite 1

Die erste Seite des Konfigurationsassistenten für das Organisationsportal ermöglicht folgende Einstellungen:

Anonymen Zugriff auf das Organisationsportal zulassen

  • Wählen Sie aus, ob der Zugriff auf das Organisationsportal ein Benutzerkonto erfordert. Die Deaktivierung dieser Option ist bei öffentlich zugänglichen Deployments sinnvoll, wenn ein Zugriff auf das Organisationsportal ohne Authentifizierung nicht erwünscht ist.

    Die Deaktivierung dieser Option hat folgende Auswirkungen:

    • Nur authentifizierte Benutzer mit der System-Rolle "Organisationsportal" können sich im Organisationsportal anmelden.

    • Der Link zum Betreten des Organisationsportals auf der Web-Client Loginseite wird nicht angezeigt.

    • Der Zugriff auf das Organisationsportal über benutzerspezifische URLs ist deaktiviert.

    • Der Menüpunkt Organisationsportal aus dem Dropdown-Menü zur Szenarioauswahl im Web-Client ist deaktiviert.

    • Im Konfigurationsassistenten für das Organisationsportal sind folgende Optionen deaktiviert: Organisationsportal über Link auf der Web-Client Login-Seite anbieten, Benutzerspezifische URL aktivieren und Standardbenutzer.

Organisationsportal über Link auf der Web-Client Loginseite betreten

  • Legen Sie fest, ob auf der Web-Client Loginseite ein Link angezeigt wird, mit dem Anwender das Organisationsportal betreten können. Der Standardbenutzer (siehe unten) wird in diesem Fall verwendet.

Repository Fallback aktivieren

  • Aktivieren Sie dieses Kontrollkästchen, um einen Fallback-Mechanismus für authentifizierte Benutzer mit der Systemrolle "Organisationsportal" zu aktivieren, die KEINE benutzerspezifische Organisationsportal-Konfiguration haben. Wenn sich solche Benutzer am Web-Client anmelden, wird eine Fallback-Konfiguration verwendet. Dies ist bei Deployments sinnvoll, bei denen eine große Anzahl von Benutzern mit der Systemrolle "Organisationsportal" automatisch erstellt wird, aber eine individuelle Konfiguration nicht praktikabel ist.

    Hinweis

    Fallback-Konfigurationen können für jedes Repository auf der Registerkarte Repositorys konfiguriert werden.

Benutzer

Diese Registerkarte listet alle Benutzer mit der System-Rolle "Organisationsportal" auf.

Sie können verschiedene Benutzer konfigurieren (unterschiedliche Einstellungen für das Organisationsportal und unterschiedliche Benutzerrechte). Damit können Sie für die Mitarbeiter Ihrer Organisation mehrere Einstiegspunkte in das Organisationsportal zur Verfügung stellen und den Zugriff auf den verfügbaren Repository-Inhalt einschränken.

Hinweis

Vertrautes Login ist eine Voraussetzung für Benutzer, die für die anonyme Anmeldung am Organisationsportal verwendet werden.

  • Filter

    Wählen Sie aus, ob in der Tabelle unterhalb Alle Benutzer angezeigt werden, oder nur Konfigurierte oder Nicht konfigurierte Benutzer.

  • Name

    Die erste Spalte enthält den Namen des Benutzers.

  • Benutzerspezifische URL

    Diese Spalte enthält die URL, mit der Anwender die Anmeldung überspringen und direkt das Organisationsportal betreten können. Die Zugriffsrechte auf den Modellbestand richten sich nach dem verwendeten Benutzerkonto und den Einstellungen für das Organisationsportal.

    Die URL setzt sich aus der Basis-URL und dem Zusatz ?reader=<Benutzer> zusammen, z.B. http://server:8000/ADOIT12_0?reader=Reader2.

    Doppelklicken Sie auf die Zelle, um die vollständige URL anzuzeigen. Kopieren Sie die URL in die Zwischenablage und fügen Sie die URL dort ein, wo Sie sie benötigen.

  • Ausgewähltes Repository

    Wenn der Benutzer auf mehrere Repositorys Zugriff hat, müssen Sie ein Repository für das Organisationsportal auswählen. Um ein Repository auszuwählen, doppelklicken Sie auf die Zelle, und wählen Sie dann ein Repository aus der Liste Verfügbare Repositorys aus.

  • Konfiguriert

    Wenn für einen Benutzer eine benutzerspezifische Organisationsportal-Konfiguration existiert, wird in dieser Spalte der Eintrag Konfiguriert angezeigt.

    Um eine benutzerspezifische Konfiguration zu erstellen, wählen Sie ein Repository aus (Spalte Ausgewähltes Repository) und führen Sie dann mit dem ausgewählten Benutzer die Einstellungen auf den folgenden Seiten des Konfigurationsassistenten für das Organisationsportal aus.

    Hinweis

    Benutzer, die KEINE benutzerspezifische Organisationsportal-Konfiguration haben, können nicht auf das Organisationsportal zugreifen, es sei denn, die Option Repository Fallback aktivieren ist aktiviert UND auf der Registerkarte Repositorys ist eine Fallback-Konfiguration konfiguriert.

  • Benutzerspezifische URL aktivieren

    Legen Sie fest, ob der anonyme Zugriff auf das Organisationsportal mit diesem Benutzer möglich ist. Diese Option ist nützlich, wenn Sie einen Einstiegspunkt in das Organisationsportal vorübergehend deaktivieren möchten, anstatt ihn dauerhaft zu entfernen.

    Wenn Sie diese Option deaktivieren, ist die benutzerspezifische URL für den Zugriff auf das Organisationsportal mit diesem Benutzer deaktiviert. Wenn es sich um den Standardbenutzer (siehe unten) handelt, wird zusätzlich der Link zum Betreten des Organisationsportals auf der Web-Client Loginseite nicht angezeigt und der Menüpunkt Organisationsportal aus dem Dropdown-Menü zur Szenarioauswahl im Web-Client ist deaktiviert.

  • Standardbenutzer

    Legen Sie fest, welcher Benutzer verwendet wird, wenn Anwender das Organisationsportal über den Link auf der Web-Client Loginseite betreten.

Repositorys

Diese Registerkarte listet alle Repositorys auf. Sie können für jedes dieser Repositorys eine Fallback-Konfiguration definieren. Diese Fallback-Konfigurationen werden verwendet, wenn die Option Repository Fallback aktivieren aktiviert ist.

  • Filter

    Wählen Sie aus, ob in der Tabelle unterhalb Alle Repositorys angezeigt werden, oder nur Konfigurierte oder Nicht konfigurierte Repositorys.

  • Konfiguriert

    Wenn für ein Repository eine Fallback-Konfiguration existiert, wird in dieser Spalte der Eintrag Konfiguriert angezeigt.

    Um eine Fallback-Konfiguration zu erstellen, führen Sie mit dem ausgewählten Repository die Einstellungen auf den folgenden Seiten des Konfigurationsassistenten für das Organisationsportal aus.

  • Aktiviert

    Legen Sie fest, ob der Zugriff auf das Organisationsportal mit dieser Fallback-Konfiguration möglich ist. Diese Option ist nützlich, wenn Sie einen Einstiegspunkt in das Organisationsportal vorübergehend deaktivieren möchten, anstatt ihn dauerhaft zu entfernen.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des Konfigurationsassistenten für das Organisationsportal öffnet sich.

Info

Die Einstellungen auf den folgenden Seiten des Konfigurationsassistenten für das Organisationsportal sind benutzerspezifisch. Um fortzufahren, muss ein Benutzer oder ein Repository ausgewählt sein.

Organisationsportal Konfigurationsassistent - Seite 2

Die zweite Seite des Konfigurationsassistenten für das Organisationsportal ermöglicht die Auswahl eines Startmodells. Das Startmodell wird auf der Startseite des Organisationsportals angezeigt.

Wenn es sich um den Standardbenutzer (siehe oben) handelt, wird das Startmodell zusätzlich auf der Startseite des "Entdecken & Mitwirken" Szenarios (nur ArchiMate-Anwendungsbibliothek) angezeigt.

Folgende Einstellungen sind verfügbar:

  • Ausgangsmodell aktivieren

    Legen Sie fest, ob ein Startmodell angezeigt wird.

  • Modelle

    Wenn Ausgangsmodell aktivieren aktiviert ist, können Sie hier das Startmodell auswählen.

Hinweis

Wenn kein Startmodell konfiguriert wurde, gilt Folgendes:

  • Im Organisationsportal ändert sich das Aussehen der Startseite. Der Bereich "Home" mit dem Startmodell wird nicht angezeigt. Stattdessen wird der Bereich "Architektur-Diagramme" als Startseite angezeigt.

  • Im "Entdecken & Mitwirken" Szenario ist weiterhin der Bereich "Home" die Startseite. Auf der Startseite werden nur die Listen Zuletzt geöffnet, Favoriten und Meine Objekte angezeigt.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit Fertig stellen. Die Konfiguration für das Organisationsportal wird in der Datenbank gespeichert.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Portfolio-Konfiguration

Sie haben die Möglichkeit, verschiedene Modellierungsklassen und Attribute aus der Portfolio-Konfiguration auszuschließen. Die ausgeschlossenen Klassen können nicht im Konfigurationsfenster ausgewählt werden. Die folgenden Einstellungen stehen zur Verfügung:

  • Modellierungsklassen

    Wählen Sie die Modellierungsklassen aus, die in einer Portfolio-Konfiguration verwendet werden können.

  • Attribute

    Wählen Sie die Attribute aus, die in einer Portfolio-Konfiguration verwendet werden können.

Eigenschaftenfilter

Mit Eigenschaftenfiltern steuern Sie die Sichtbarkeit von Attributen im/in:

  • Tabellarischen Editor

  • Notebooks

  • Reports

  • Modellvergleich

Sie können verschiedene Eigenschaftenfilter für verschiedene System-Rollen und Szenarien definieren.

Eigenschaftenfilter hinzufügen

Um einen neuen Eigenschaftenfilter hinzuzufügen:

  1. Klicken Sie auf die Filter hinzufügen Schaltfläche.

  2. Geben Sie im Feld Sprachunabhängiger Name einen Namen für den Eigenschaftenfilter ein. Dieser sprachunabhängige Name identifiziert den Filter eindeutig.

  3. Geben Sie im Bereich Anzeigename einen Namen für jede Sprache ein, die ADOIT unterstützt. Diese Namen werden auf der Benutzeroberfläche dargestellt.

  4. Wählen Sie im Bereich Reihenfolge die Sortierung der Einträge aus, wenn Anwender im Web-Client einen Eigenschaftenfilter auswählen.

  5. Wählen Sie im Bereich System-Rollenzuweisung jene System-Rollen aus, denen Sie diesen Filter zuweisen möchten.

  6. Wählen Sie im Bereich Szenariozuweisung jene Szenarien aus, denen Sie diesen Filter zuweisen möchten.

  7. Klicken Sie auf OK. Der neue Eigenschaftenfilter wird als neue Spalte im Einstellungen des Eigenschaftenfilters Editor hinzugefügt.

Optional können Sie auch:

  • Im Feld Kopiere Filter von eine vorhandene Konfiguration als Vorlage für Ihren neuen Eigenschaftenfilter auswählen.
System-Rollenzuweisung und Szenariozuweisung - Sichtbarkeit von Filtern

Sie können System-Rollenzuweisungen und Szenariozuweisungen kombinieren. Ein Eigenschaftsfilter ist nur dann sichtbar, wenn alle Bedingungen erfüllt sind (UND-Verknüpfung).

Eigenschaftenfilter konfigurieren

Um die Attribute auszuwählen, die bei aktivem Eigenschaftenfilter nicht angezeigt werden sollen:

  • Klicken Sie auf die „+“ beziehungsweise „-“ Symbole neben den Elementen im Editor, um den Inhalt zu erweitern oder zu reduzieren. Sie können die einzelnen Typen von Modellen/Objekten/Relationen und die dazugehörigen Attribute anzeigen.

  • Deaktivieren Sie das Kontrollkästchen, wo sich eine Zeile (= Attribut) und eine Spalte (= Filter) treffen. Damit legen Sie fest, dass ein Attribut nicht angezeigt wird, wenn ein bestimmter Eigenschaftenfilter aktiv ist. Sie können auch ganze Notebook-Kapitel bzw. sogar alle Attribute in einem bestimmten Notebook auf einmal deaktivieren.

Eigenschaftenfilter bearbeiten

Um einen Eigenschaftenfilter zu bearbeiten:

  • Klicken Sie auf den Spaltenkopf der Spalte, die den Eigenschaftenfilter repräsentiert.

Filtereinstellungen

In diesem Bereich können Sie Einstellungen konfigurieren, die die Verfügbarkeit von Eigenschaftenfiltern beeinflussen.

  • Standardfilter

    Wählen Sie aus, welcher Eigenschaftenfilter standardmäßig im ADOIT Web-Client aktiviert ist. Wenn ein Benutzer keinen Zugriff auf den ausgewählten Filter hat, wird standardmäßig der erste Filter in der Liste aktiviert, dann der zweite Filter etc.

  • 'Alles anzeigen'-Filter aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit der Alles anzeigen Filter allen Benutzern zur Verfügung steht. Wenn der Alles anzeigen Filter aktiviert ist, sind alle Attribute sichtbar.

  • 'Leere Attribute ausblenden'-Filter aktivieren in Notebooks im 'Lesemodus'

    Aktivieren Sie dieses Kontrollkästchen, damit der Leere Attribute ausblenden Filter allen Benutzern zur Verfügung steht. Wenn der Leere Attribute ausblenden Filter aktiviert ist, sind keine leeren Attribute in Notebooks im Lesemodus sichtbar.

  • Szenario-spezifische Filtereinstellungen

    Klicken Sie auf diese Schaltfläche, um die Filtereinstellungen für bestimmte Szenarien anzupassen:

  • Deaktivieren Sie das Kontrollkästchen Standard Einstellungen benutzen, um szenario-spezifische Optionen zu aktivieren.

  • Wählen Sie in der Liste Standardfilter aus, welcher Eigenschaftenfilter standardmäßig in diesem Szenario aktiviert ist.

    Hinweis

    Wenn ein Standardfilter für ein Szenario definiert ist, wird beim Umschalten auf dieses Szenario immer dieser Standardfilter aktiviert, egal welcher Filter vorher aktiv war.

  • Aktivieren Sie das Kontrollkästchen 'Alles anzeigen'-Filter aktivieren, damit der Alles anzeigen Filter allen Benutzern in diesem Szenario zur Verfügung steht.

EA-Workflow

Mit dem EA-Workflow lassen sich Repository-Objekte zur Prüfung und zur Freigabe weiterleiten. Während des Freigabeprozesses übernehmen die Mitwirkenden abhängig von ihrer System-Rolle verschiedene Aufgaben.

Hinweis

Die Verfügbarkeit des EA-Workflows hängt von der Lizenz ab.

Hinweis

Die Konfiguration für den EA-Workflow ist vordefiniert und kann nicht durch den ADOIT-Administrator geändert werden. Wenn Sie die Konfiguration anpassen möchten, wenden Sie sich bitte an Ihren ADOIT-Kundenbetreuer.

Zugriff auf den EA-Workflow einrichten

Um den EA-Workflow zu verwenden, weisen Sie Benutzer abhängig von ihrer Aufgabe im Freigabeprozess zu den folgenden System-Rollen hinzu. Es handelt sich um untergeordnete Rollen der System-Rolle "EA-Workflow":

  • Benutzer mit der Freigabeworkflow-Rolle Contributor reichen Objekte zur Überprüfung ein. Sie können außerdem neue Versionen von bereits freigegebenen Objekten erstellen, um sie zu adaptieren.

  • Architekten können alle Zustandsübergänge durchführen. Im Gegensatz zu Benutzern mit der Freigabeworkflow-Rolle Contributor können sie auch Objekte zurückweisen oder freigeben.

  • Administratoren können ebenfalls alle Zustandsübergänge durchführen, aber sie erhalten keine automatischen Benachrichtigungen.

Danach ist der EA-Workflow einsatzbereit.

Hinweis

Für Details zum Zuweisen von System-Rollen an Benutzer beziehen Sie sich bitte auf den Abschnitt System-Rollen erstellen und Benutzer zuweisen.

Zugriff auf Objekte für Leser

Zugriffsrechte auf Objekte im EA-Workflow werden je nach Freigabeworkflow-Rolle (z.B. "Architekt") und Status (z.B. "In Bearbeitung") festgelegt. Benutzer ohne Freigabeworkflow-Rolle haben nur Lesezugriff auf alle Objekte in allen Status. Damit ist sichergestellt, dass Leser die Mechanismen des EA-Workflows nicht aushebeln können.

Reporting Board

Mit dem Reporting Board können Web-Client Benutzer von einem zentralen Dashboard aus verschiedene Reports (= vordefinierte Suchabfragen, Sichten und Reports) erzeugen. Dafür stehen mehrere Kategorien von Reports zur Verfügung (z.B. Typ). Jede Kategorie besteht wiederum aus einer oder mehreren Gruppen von einzelnen Reports.

Reporting Board konfigurieren

Um die Einstellungen für das Reporting Board zu bearbeiten:

  1. Wählen Sie Reporting Board - Allgemein.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Konfiguration bearbeiten.

Die erste Seite des Konfigurationsassistenten für das Reporting Board öffnet sich im Tab Bibliothekenverwaltung.

Konfiguration der Kategorien

Die erste Seite des Konfigurationsassistenten ist in Form einer Tabelle aufgebaut, die sämtliche Kategorien gleichzeitig anzeigt.

  • Jede Zeile stellt eine Kategorie dar.

  • Die erste Tabellenspalte enthält den Namen der Kategorie.

  • Die zweite Spalte der Tabelle enthält den Namen der System-Rollen, die Reports dieser Kategorie erzeugen dürfen.

Klicken Sie auf die entsprechenden Buttons, um Kategorien zu bearbeiten, zu löschen oder neu hinzuzufügen.

Kategorie bearbeiten/hinzufügen

Wenn Sie eine bestehende Kategorie bearbeiten oder eine neue Kategorie hinzufügen, öffnet sich ein Dialogfenster.

  • Name

    Bearbeiten Sie die sprachspezifischen Namen der Kategorie über den Unterstützungsdialog Bearbeiten....

  • System-Rollen

    Erlauben Sie bestimmten System-Rollen, Reports dieser Kategorie zu erzeugen, indem Sie die entsprechenden Kontrollkästchen anhaken.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des Konfigurationsassistenten für das Reporting Board öffnet sich.

Konfiguration der Gruppen

Die zweite des Konfigurationsassistenten ist in Form einer Tabelle aufgebaut, die sämtliche Gruppen gleichzeitig anzeigt.

  • Innerhalb des Editors sind die Report-Gruppen nach Kategorie gruppiert (z.B. Reports nach Typ).

  • Die Kategorie Alle Gruppen enthält alle verfügbaren Gruppen.

  • Einzelne Gruppen können durch einen Klick auf die „+“ beziehungsweise „-“ Symbole neben den Kategorien als Tabellenzeilen ein-/ausgeblendet werden.

Gruppe bearbeiten/hinzufügen

Wenn Sie eine bestehende Gruppe bearbeiten oder eine neue Gruppe hinzufügen, öffnet sich ein Dialogfenster mit zwei Tabs.

Allgemein

  • Bearbeiten Sie die sprachspezifischen Namen der Gruppe über den Unterstützungsdialog Bearbeiten....

  • Wählen Sie die Kategorien aus, zu denen eine Gruppe gehört, indem Sie die entsprechenden Kontrollkästchen anhaken.

Reports

  • Wählen Sie die Reports aus, die in der Gruppe enthalten sein sollen, indem Sie die entsprechenden Kontrollkästchen anhaken.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Einstellungen für das Reporting Board werden in der Datenbank gespeichert und sind sofort im Web-Client verfügbar.

REST API

In ADOIT ist eine generische, konfigurierbare REST API integriert, die authentifizierten Zugriff auf bereitgestellte Funktionalitäten ermöglicht. Über die REST API können Sie beispielsweise GET-Anforderungen an ADOIT senden, um Daten abzufragen.

Hinweis

Die Verfügbarkeit dieser Funktionalität hängt von der Lizenz ab. Die Verwendung der Anwendungsprogrammierschnittstelle (API) ist auf 500 Zugriffe pro Stunde begrenzt.

Zugriff auf die REST API aktivieren

Hier im Administrationshandbuch erfahren Sie, wie Sie den Zugriff auf die REST API aktivieren.

Führen Sie zunächst folgende Schritte aus:

Anschließend können Sie die Authentifizierungsmethode konfigurieren, über die Sie mit der REST API kommunizieren möchten.

Diese Schritte werden in den folgenden Abschnitten erklärt.

Hinweis

Aus technischen Gründen muss tokenbasierte Authentifizierung aktiviert sein, auch wenn Sie diese nicht verwenden möchten.

Verwendung der REST API

Nachdem Sie die Authentifizierung konfiguriert haben, können Sie die REST API verwenden. Informationen dazu finden Sie im ADOxx Developer Portal.

Technischen Benutzer anlegen

Das Anlegen eines technischen Benutzers ist unabhängig von der Authentifizierungsmethode notwendig, die Sie für die Authentifizierung von Anforderungen an die REST API verwenden möchten. Er wird aus technischen Gründen benötigt.

So erstellen Sie den technischen Benutzer im Administrations-Toolkit:

 Technischen Benutzer anlegen

  1. Öffnen Sie die Benutzerverwaltung, und klicken Sie dann auf Neuen Benutzer erstellen   .

  2. Geben Sie folgende Daten ein:

    • Benutzername: "Technical_StandardRESTfulServices" (und ein Passwort Ihrer Wahl)

    • Repository: Weisen Sie dem Benutzer nur (!) das Repository zu, das die abzufragenden Daten enthält.

    • Benutzergruppen: Dieser Benutzer ist Mitglied der Standardgruppe.

    • Vertrautes Login: Ja

Hinweis

Sie können "Vertrautes Login" nicht während der Benutzererstellung aktivieren. Nur Rechte bereits angelegter Benutzer können geändert werden. Verwenden Sie die Schaltfläche "Hinzufügen" im Tab "Neuen Benutzer anlegen", um den Benutzer zu erstellen, bevor Sie "Vertrautes Login" aktivieren.

Zugriffsrechte zum Administrations-Toolkit zuweisen

Möchten Sie Benutzer-Schreib-APIs verwenden? Dann müssen Sie dem Benutzer, in dessen Kontext Anforderungen ausgeführt werden sollen, Zugriffsrechte zum Administrations-Toolkit zuweisen.

Hinweis

Dabei kann es sich entweder um den technischen Benutzer (für tokenbasierte Authentifizierung) oder um einen Standard-Produktbenutzer (für Basic Authentication und OAuth 2.0) handeln.

So weisen Sie Zugriffsrechte zum Administrations-Toolkit zu:

 Zugriffsrechte zum Administrations-Toolkit zuweisen

  1. Öffnen Sie die Benutzerverwaltung.

  2. Klicken Sie im Benutzerkatalog mit der rechten Maustaste auf den Benutzer, dem Sie Zugriffsrechte zum Administrations-Toolkit gewähren möchten, und klicken Sie dann auf Zugriffsrechte bearbeiten.

  3. Wechseln Sie zum Tab Komponenten.

  4. Der momentane Rechtestatus für das Administrations-Toolkit wird in der Spalte Rechte angezeigt. Doppelklicken Sie hier, bis Sie den Status Zugriff erreichen.

  5. Wenn Sie gefragt werden, ob dem Benutzer globale Administratorenrechte zugewiesen werden sollen, klicken Sie auf Nein.

System-Einstellungen bearbeiten

Jetzt müssen Sie einige technische Einstellungen definieren, die die grundlegende Funktionsweise des Web-Clients betreffen. Dazu:

  1. Wechseln Sie zu Bibliothekenverwaltung > Komponenteneinstellungen > Web-Client > System.

  2. Tragen Sie im Feld Basis-URL die URL ein, unter der der Web-Client von anderen Rechnern aus erreicht werden kann.

  3. Wählen Sie im Feld Technische Benutzer in der Liste Verfügbare Benutzer den technischen Benutzer aus, den Sie erzeugt haben, d.h. “Technical_StandardRESTfulServices" (siehe Technischen Benutzer anlegen).

  4. Klicken Sie auf OK.

Beispiel Basis-URL

Sie konfigurieren ADOIT 12.0. Der ADOIT Web-Client läuft auf einem Rechner mit der IP 10.2.100.68 auf Port 8000. Die URL sollte folgendermaßen aussehen:

"http://10.2.100.68:8000/ADOIT12_0"

Allgemeine Einstellungen konfigurieren

So bearbeiten Sie die allgemeinen Einstellungen für die REST API:

  • Wechseln Sie zu Bibliothekenverwaltung > Komponenteneinstellungen > Standard RESTful Services > Allgemein.

Diese Einstellungen gelten für alle Authentifizierungsmethoden:

 REST API - Allgemeine Einstellungen

  • Standard RESTful Services global aktivieren

    Aktivieren Sie das Kontrollkästchen Standard RESTful Services global aktivieren, um die REST API zu aktivieren. Alle anderen Optionen in diesem Bereich sind inaktiv, wenn Sie dieses Kontrollkästchen nicht aktivieren.

  • Cache-Pfad

    Dieser Parameter ist optional. Geben Sie den absoluten Pfad zu dem Verzeichnis an, in dem die Cache-Dateien gespeichert werden müssen. Der Benutzer, unter dem der Apache Tomcat Web-Server als Dienst ausgeführt wird, muss Schreibrechte auf dieses Verzeichnis haben.

Hinweis

Vorteile der Verwendung des Cache-Pfad Parameters:

Modellbilder und Modell-Imagemaps werden nur einmal erzeugt und dann zwischengespeichert. Bei jedem Abruf des Modellbildes oder der Imagemap wird geprüft, ob sich das Modell geändert hat. Wenn es keine Änderungen gibt, werden die Informationen aus dem Dateisystem geladen. Andernfalls wird zuerst der Cache aktualisiert. Dadurch sind Antworten auf diese Arten von Anforderungen schneller und verbrauchen weniger Server-Ressourcen.

Bei Suchabfragen besteht der Vorteil darin, dass erstellte Abfragen in Cache-Dateien gespeichert und nach einem Neustart des Servers wiederverwendet werden können. Ohne den Cache-Pfad werden Abfragen nur im Speicher gehalten und gehen beim Neustart verloren.

  • Validierung aktivieren

    Dieser Parameter ist optional. Aktivieren Sie dieses Kontrollkästchen, um eine syntaktische und semantische Validierung von XML- und JSON-Antworten zu aktivieren. Das Aktivieren dieses Parameters kann die Ausführung von Anforderungen verlangsamen und einen hohen Speicherverbrauch und eine hohe CPU-Auslastung auf dem Webserver verursachen.

Damit Sie diese Einstellungen speichern können, muss Tokenbasierte Authentifizierung aktiviert sein. Mindestens ein Sicherheitskontext ist erforderlich.

Tokenbasierte Authentifizierung konfigurieren

So konfigurieren Sie tokenbasierte Authentifizierung für die REST API:

  1. Wechseln Sie zu Bibliothekenverwaltung > Komponenteneinstellungen > Standard RESTful Services > Allgemein.

  2. Bearbeiten Sie die Einstellungen auf der Registerkarte Tokens.

Folgende Einstellungen stehen zur Verfügung:

 REST API - Tokens

REST-Sicherheitskontext

Sie können den vorgegebenen REST-Sicherheitskontext bearbeiten oder auf die Schaltfläche Kontext hinzufügen klicken, um einen neuen REST-Sicherheitskontext zu erzeugen. Ein Sicherheitskontext besteht aus folgenden Teilen:

  • Schlüssel

  • Secret

  • Technischer Benutzer

  • REST-Szenarien

Hinweis

ADOIT RESTful Services unterstützen mehrere Sicherheitskontexte. Mindestens ein Sicherheitskontext ist erforderlich.

Wann ist es sinnvoll, mehrere Sicherheitskontexte zu verwenden? Sie können beispielsweise einen Sicherheitskontext konfigurieren, der die Änderung von Benutzern ermöglicht, und einen anderen mit Zugriff auf das Repository. Sie können Anforderungen mit Zugriffsrechten verschiedener technischer Benutzer ausführen. Während der Ausführung können Sie auswählen, welcher der vordefinierten Sicherheitskontexte verwendet werden soll.

Die Einstellungen im Detail:

  • Schlüssel (für Authentifizierung durch das Zielsystem)

    Dieser Parameter definiert den Schlüsselnamen, der für die Kommunikation mit der Webanwendung über authentifizierte REST APIs verwendet wird. Geben Sie einen sprechenden Namen ein, z.B. "boc.rest.key.mfb.StandardRESTfulServices".

  • Secret (für Authentifizierung durch das Zielsystem)

    Dieser Parameter definiert den geheimen Wert des Schlüssels, der für die Kommunikation mit der Webanwendung über authentifizierte REST APIs verwendet wird. Klicken Sie auf die Secret generieren Schaltfläche, um den Wert des Schlüssels zu generieren.

  • Technischer Benutzer

    Wählen Sie in der Liste Verfügbare Benutzer den technischen Benutzer aus, den Sie erzeugt haben, d.h. "Technical_StandardRESTfulServices" (siehe Technischen Benutzer anlegen).

  • REST-Szenarien

    In diesem Bereich können Sie bestimmte REST-Szenarien aktivieren. Wenn ein Szenario nicht aktiviert ist, geben alle Anforderungen an seine Endpunkte den Status 403 FORBIDDEN zurück. HATEOAS-Links, mit denen Sie verwandte Ressourcen finden können, sind ebenfalls betroffen. Beispielsweise kann die Antwort auf eine Anforderung zum Abrufen von Benutzerinformationen einen HATEOAS-Link zum Löschen des Benutzers enthalten. Wenn das Szenario für Benutzer-Schreib-APIs deaktiviert ist, gibt eine Anforderung an diesen Link den Statuscode 403 FORBIDDEN zurück.

Hinweis

Möchten Sie wissen, welche Endpunkte den REST-Szenarien zugeordnet sind? Lesen Sie die API-Referenz im ADOxx Developer Portal, wo die Endpunkte nach Szenarien gruppiert sind.

Basic Authentication konfigurieren

Sie können Basic Authentication für die REST API konfigurieren:

Einstellungen für Basic Authentication konfigurieren

So konfigurieren Sie Basic Authentication für die REST API:

  1. Wechseln Sie zu Bibliothekenverwaltung > Komponenteneinstellungen > Standard RESTful Services > Allgemein.

  2. Bearbeiten Sie die Einstellungen auf der Registerkarte Basic Auth.

Folgende Einstellungen stehen zur Verfügung:

 REST API - Basic Auth

  • Basic Authentication aktivieren

    Aktivieren Sie dieses Kontrollkästchen, um Basic Authentication zu aktivieren. Alle anderen Optionen in diesem Bereich sind inaktiv, wenn Sie dieses Kontrollkästchen nicht aktivieren.

  • REST-Szenarien

    In diesem Bereich können Sie bestimmte REST-Szenarien aktivieren. Wenn ein Szenario nicht aktiviert ist, geben alle Anforderungen an seine Endpunkte den Status 403 FORBIDDEN zurück. HATEOAS-Links, mit denen Sie verwandte Ressourcen finden können, sind ebenfalls betroffen. Beispielsweise kann die Antwort auf eine Anforderung zum Abrufen von Benutzerinformationen einen HATEOAS-Link zum Löschen des Benutzers enthalten. Wenn das Szenario für Benutzer-Schreib-APIs deaktiviert ist, gibt eine Anforderung an diesen Link den Statuscode 403 FORBIDDEN zurück.

Hinweis

Möchten Sie wissen, welche Endpunkte den REST-Szenarien zugeordnet sind? Lesen Sie die API-Referenz im ADOxx Developer Portal, wo die Endpunkte nach Szenarien gruppiert sind.

Basic Authentication für ADOIT aktivieren

Aus Sicherheitsgründen ist Basic Authentication in ADOIT standardmäßig deaktiviert. Wenn Sie die REST API mit Basic Authentication verwenden möchten, müssen Sie eine Konfigurationsdatei anpassen:

  1. Fahren Sie Apache Tomcat herunter, falls er ausgeführt wird.

  2. Öffnen Sie die Datei RESTAuthorization.xml im Ordner <Tomcat Installation>\webapps\ADOIT12_0\WEB-INF\registry\rest mit einem Editor.

  3. Suchen Sie folgenden Abschnitt:

    <!--<entry key="REST_BASIC_AUTHENTICATION">true</entry>-->

  4. Entfernen Sie die Kommentarzeichen (<!-- und -->).

  5. Speichern Sie die Datei und starten Sie Apache Tomcat neu.

OAuth 2.0 Authentifizierung konfigurieren

Sie können OAuth 2.0 Authentifizierung für die REST API konfigurieren:

Einstellungen für OAuth 2.0 konfigurieren

So konfigurieren Sie OAuth 2.0 Authentifizierung für die REST API:

  1. Wechseln Sie zu Bibliothekenverwaltung > Komponenteneinstellungen > Standard RESTful Services > Allgemein.

  2. Bearbeiten Sie die Einstellungen auf der Registerkarte OAuth 2.0.

Folgende Einstellungen stehen zur Verfügung:

 REST API - OAuth2

  • OAuth 2.0 aktivieren

    Aktivieren Sie dieses Kontrollkästchen, um OAuth 2.0 Authentifizierung zu aktivieren. Alle anderen Optionen in diesem Bereich sind inaktiv, wenn Sie dieses Kontrollkästchen nicht aktivieren.

  • REST-Szenarien

    In diesem Bereich können Sie bestimmte REST-Szenarien aktivieren. Wenn ein Szenario nicht aktiviert ist, geben alle Anforderungen an seine Endpunkte den Status 403 FORBIDDEN zurück. HATEOAS-Links, mit denen Sie verwandte Ressourcen finden können, sind ebenfalls betroffen. Beispielsweise kann die Antwort auf eine Anforderung zum Abrufen von Benutzerinformationen einen HATEOAS-Link zum Löschen des Benutzers enthalten. Wenn das Szenario für Benutzer-Schreib-APIs deaktiviert ist, gibt eine Anforderung an diesen Link den Statuscode 403 FORBIDDEN zurück.

Hinweis

Möchten Sie wissen, welche Endpunkte den REST-Szenarien zugeordnet sind? Lesen Sie die API-Referenz im ADOxx Developer Portal, wo die Endpunkte nach Szenarien gruppiert sind.

OAuth 2.0 für ADOIT aktivieren

Wenn Sie die REST API mit OAuth 2.0 verwenden möchten, müssen Sie OAuth 2.0 aktivieren und einen Client konfigurieren:

  1. Öffnen Sie einen Browser und geben Sie folgende URL ein: http://<SERVER_NAME>:<TOMCAT_PORT>/ADOIT12_0/admin.view.

  2. Geben Sie Ihre Anmeldeinformationen ein (falls notwendig) und loggen Sie sich ein. Der Benutzer muss Zugriffsrechte auf das Administrations-Toolkit haben.

  3. Klicken Sie auf der Symbolleiste ganz oben auf dem Bildschirm auf Mehr   , zeigen Sie auf Authentifizierung, und klicken Sie dann auf OAuth 2.0.

  4. Aktivieren Sie das Kontrollkästchen OAuth 2.0 aktiv, um die Nutzung von OAuth 2.0 zu erlauben.

  5. Klicken Sie auf die Logos hochladen Schaltfläche, um ein Logo hochzuladen, das die Client-Anwendungen repräsentiert.

  6. Klicken Sie auf die Hinzufügen Schaltfläche , um einen neuen Client hinzuzufügen.

  7. Füllen Sie das angezeigte Formular Client-Daten aus. Sie können folgende Daten eingeben und bearbeiten:

    • Typ: Wählen Sie den Client-Typ aus. Confidential (= vertrauliche) Clients sind z.B. zentralisierte, serverbasierte Anwendungen, die Client-Secrets sicher speichern können. Public (= öffentliche) Clients sind z.B. rein clientbasierte Anwendungen und native Apps, die Client-Secrets nicht sicher speichern können.

    • ID: Die ID des Client-Systems. Muss innerhalb der Clients eindeutig sein. Sollte einfach gehalten werden, da Sonderzeichen URL-kodiert werden müssen.

    • Name: Der Name der Client-Anwendung. Wird auf der Benutzeroberfläche angezeigt.

    • Redirect URI: Die URL eines Redirect-Endpunkts innerhalb der Client-Anwendung, der vom Autorisierungsserver bei der Ausgabe eines Autorisierungscodes aufgerufen wird.

    • Logo: Wählen Sie ein Logo, das die Kundenanwendung repräsentiert (muss zuerst auf der OAuth 2.0-Seite hochgeladen werden). Wird auf der Benutzeroberfläche angezeigt.

    • Access Token Validity (Seconds): Die Zeit in Sekunden, wie lange ein Access Token gültig ist, bis es abläuft. Standardwert: 1800s = 30 Minuten.

    • Refresh Token Validity (Seconds): Die Zeit in Sekunden, wie lange ein Refresh Token gültig ist, bis es abläuft. Standardwert: 1209600s = 14 Tage.

    • Secret: Das Geheimnis, das für die Client-Authentifizierung verwendet wird. Sie können auf Generieren klicken, um ein neues Geheimnis zu generieren, oder manuell eines festlegen.

  8. Klicken Sie auf Speichern, nachdem Sie das Formular Client-Daten ausgefüllt haben, und klicken Sie dann auf Änderungen speichern, um die OAuth 2.0 Seite zu speichern.

Zeitfilter

Hier können Sie auswählen, für welche System-Rollen der Zeitfilter standardmäßig aktiviert ist. Wenn sich ein Benutzer mit dieser System-Rolle am Web-Client anmeldet, wird der Zeitfilter auf das aktuelle Datum gesetzt. Nur Objekte, die aktuell gültig sind, werden angezeigt.

Benutzer können den Zeitfilter jederzeit auf ein anderes Datum setzen oder ganz deaktivieren. Bei der nächsten Anmeldung wird der Zeitfilter erneut angewendet.

Hinweis

Wenn ein Benutzer mehrere System-Rollen hat, wird der Zeitfilter aktiviert, wenn diese Einstellung für mindestens eine System-Rolle ausgewählt ist.

Validierung

Mit den Validierungsfunktionen in ADOIT können Web-Client Benutzer kontrollieren, ob Modelle und Objekte den Modellierungsrichtlinien folgen. Wenn die Modellierungsrichtlinien verletzt werden, zeigt ADOIT entsprechende Benachrichtigungen an.

Validierung konfigurieren

Um die Einstellungen für die Validierung zu bearbeiten:

  1. Wählen Sie Validierung - Grundeinstellungen.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Konfiguration bearbeiten.

Die erste Seite des Konfigurationsassistenten für die Validierung öffnet sich im Tab Bibliothekenverwaltung.

Konfiguration der Kategorien

Die erste Seite des Konfigurationsassistenten ist in Form einer Tabelle aufgebaut, die sämtliche Kategorien gleichzeitig anzeigt.

  • Jede Zeile stellt eine Kategorie dar.

  • Die erste Tabellenspalte enthält den Namen der Kategorie.

  • Die zweite Spalte dieser Tabelle enthält das Erweiterungsmodul, das die Logik für die Ausführung von Checks dieser Kategorie bereitstellt.

  • Die dritte Spalte der Tabelle enthält den Namen der System-Rollen, die Checks dieser Kategorie ausführen dürfen.

Klicken Sie auf die entsprechenden Buttons, um Kategorien zu bearbeiten, zu löschen oder neu hinzuzufügen.

Kategorie bearbeiten/hinzufügen

Wenn Sie eine bestehende Kategorie bearbeiten oder eine neue Kategorie hinzufügen, öffnet sich ein Dialogfenster.

  • Name

    Bearbeiten Sie die sprachspezifischen Namen der Kategorie über den Unterstützungsdialog Bearbeiten....

  • System-Rollen

    Erlauben Sie bestimmten System-Rollen, Checks dieser Kategorie auszuführen, indem Sie die entsprechenden Kontrollkästchen anhaken.

  • Werte zurücksetzen

    Klicken Sie auf Werte zurücksetzen, um die Standardeinstellungen für eine Kategorie wiederherzustellen.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des Konfigurationsassistenten für die Validierung öffnet sich.

Konfiguration der Checks

Die zweite Seite des Konfigurationsassistenten ist in Form einer Tabelle aufgebaut, die sämtliche Checks gleichzeitig anzeigt.

  • Innerhalb des Editors sind die Checks nach Kategorie gruppiert (z.B. Methodisch).

  • Einzelne Checks können durch einen Klick auf die „+“ beziehungsweise „-“ Symbole neben den Kategorien als Tabellenzeilen ein-/ausgeblendet werden.

  • Die erste Tabellenspalte enthält den Namen des Checks.

  • Die zweite Tabellenspalte enthält den Typ des Checks (To-do, Hinweis, Warnung, Fehler).

  • Die dritte und vierte Tabellenspalte enthalten den Text und dazugehörigen Hinweis, die in der Benachrichtigung angezeigt werden.

  • Die fünfte Spalte dieser Tabelle enthält das Erweiterungsmodul, das die Logik für die Ausführung des Checks bereitstellt.

Check bearbeiten/hinzufügen

Wenn Sie einen bestehenden Check bearbeiten oder einen neuen Check hinzufügen, öffnet sich ein Dialogfenster mit drei Tabs.

Allgemein

  • Bearbeiten Sie die sprachspezifischen Namen des Checks über den Unterstützungsdialog Bearbeiten....

  • Bearbeiten Sie die sprachspezifischen Texte, die in der Benachrichtigung angezeigt werden, über den Unterstützungsdialog Bearbeiten....

  • Bearbeiten Sie die sprachspezifischen Hinweise, die in der Benachrichtigung angezeigt werden, über den Unterstützungsdialog Bearbeiten....

  • Klicken Sie auf Werte zurücksetzen, um die Standardeinstellungen für einen Check wiederherzustellen.

Kategorien

  • Wählen Sie die Kategorien aus, zu denen ein Check gehört, indem Sie die entsprechenden Kontrollkästchen anhaken.

Modell- und Objekttypen

  • Wählen Sie die zu überprüfenden Modell- und Objekttypen aus, indem Sie die entsprechenden Kontrollkästchen anhaken.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Einstellungen für die Validierung werden in der Datenbank gespeichert und sind sofort im Web-Client verfügbar.

Sichten

In den Einstellungen für die Sichten können Sie Konfigurationen für Sichten erstellen und verwalten.

Konfigurationen der BIA

Die BIA-Sicht (Business-Impact-Analyse) dient der Darstellung von (kritischen) Zusammenhängen einzelner Architekturobjekte über mehrere Architekturebenen hinweg. Es wird zum Beispiel dargestellt, welche Architekturobjekte direkten oder indirekten Einfluss auf geschäftskritische Prozesse haben.

Eine BIA-Konfiguration definiert die komplette Struktur der BIA-Hierarchie. Die Hierarchie basiert auf einer Start-Modellierungsklasse und mehreren anderen Klassen, die über Relationsklassen verbunden sind. Für jede Modellierungsklasse wird ein Layer erzeugt, der als Schwimmbahn in der BIA-Sicht dargestellt wird. Der Layer kann überbrückt werden, wodurch er in der BIA-Sicht unsichtbar wird. Die Konfiguration speichert auch die Farbe, die für jeden Layer ausgewählt wird.

BIA-Konfiguration erstellen

Um eine BIA-Konfiguration zu erstellen:

  1. Wählen Sie Sichten - Konfigurationen der BIA.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Neue Konfiguration erstellen.

Die erste Seite des BIA Konfigurationsassistenten öffnet sich im Tab Bibliothekenverwaltung.

BIA Konfigurationsassistent - Seite 1

Die erste Seite des BIA Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 BIA-Konfiguration erstellen Seite 1

  • Name der Konfiguration

    Der Name der BIA-Konfiguration. Der Name wird auf der Benutzeroberfläche dargestellt.

  • Beschreibung der Konfiguration

    Eine Beschreibung der BIA-Konfiguration. Diese Einstellung ist optional.

  • Startklasse

    Die Startklasse der neuen BIA-Konfiguration. Die Startklasse ist diejenige, auf der alle Beziehungen zu anderen Klassen basieren.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des BIA Konfigurationsassistenten öffnet sich.

BIA Konfigurationsassistent - Seite 2

Die zweite Seite des BIA Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 BIA-Konfiguration erstellen Seite 2

  • Liste der Relationsklassen

    Der Inhalt des linken Fensterbereichs hängt von der gewählten Startklasse ab. In diesem Bereich wird eine Liste aller vorhandenen Relationsklassen des ausgewählten Elements angezeigt, aufgeteilt in aus- und eingehende Relationsklassen.

    Durch Markieren einer Klasse und einen Klick auf die " >"-Schaltfläche zwischen den beiden Fensterbereichen wird eine Klasse zur Konfiguration hinzugefügt. Nun kann diese Klasse im rechten Fenster ausgewählt werden, um die Hierarchie der BIA-Konfiguration weiter zu spezifizieren.

  • Vorschau

    Im rechten Fensterbereich werden die Elemente, die bereits zur Konfiguration hinzugefügt wurden, als Layer dargestellt. Icons zum Entfernen eines Layers, zur Einstellung der Hintergrundfarbe eines Layers und zur Überbrückung eines Layers werden per Mouseover aktiviert.

    Der Layer, der die Startklasse enthält, kann nicht gelöscht oder überbrückt werden. Alle anderen Layer können mit den Schaltflächen zwischen den beiden Fensterbereichen (rauf, runter, nach oben und nach unten) bewegt werden.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die BIA-Konfiguration wird als XML-Datei in der Datenbank gespeichert und zu den vorhandenen BIA-Konfigurationen hinzugefügt.

Konfigurationen der Cluster Maps

Cluster Maps in ADOIT veranschaulichen Hierarchien und Beziehungen zwischen Objekten. Sie ähneln einem Stammbaum. In einer Cluster Map mit z. B. drei Ebenen steht die oberste Ebene für die Großeltern. Die zweite Ebene enthält die Kinder der Großeltern, die Geschwister sind. Die dritte Ebene enthält die Enkelkinder. Die Enkelkinder sind nur dann Geschwister, wenn Sie das gleiche Elternteil haben.

Die Cluster Map wird im Administrations-Toolkit konfiguriert und ist dann im Web-Client verfügbar. Um ein bestimmtes Layout für eine Cluster Map festzulegen, werden Modellvorlagen im Web-Client erzeugt.

Neu hinzugefügte Objekte vs. aktualisierte Objekte

Wenn Sie eine Cluster Map auf ein Objekt erzeugen, werden alle Objekte in der Cluster Map gemäß der Konfiguration hinzugefügt. Alle neu hinzugefügten Objekte einer Ebene, die sich dasselbe Elternobjekt teilen (= alle Geschwister), haben dieselbe Größe. Diese Größe leitet sich von dem Objekt ab, das am meisten wachsen muss, damit die Objekte der Ebene darunter (= seine Kinder) hineinpassen.

Wenn Sie eine Cluster Map auf ein Modell (Modellvorlage oder vorhandene Cluster Map) erzeugen, werden alle Objekte in der Größe aktualisiert, soweit das notwendig ist. Objekte, die nicht Teil des Modells sind, aber mit den Objekten des Modells entsprechend der Cluster Map Konfiguration in Beziehung stehen, werden als neue Objekte hinzugefügt.

Cluster Map Konfiguration erstellen

Um eine Cluster Map Konfiguration zu erstellen:

  1. Wählen Sie Sichten - Konfigurationen der Cluster Maps im Tab Komponenteneinstellungen.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Neue Konfiguration erstellen.

Der Cluster Map Konfigurationsdialog öffnet sich im Tab Bibliothekenverwaltung.

Cluster Map Konfigurationsdialog

Der Cluster Map Konfigurationsdialog ermöglicht die folgenden Einstellungen:

 Cluster Map Konfigurationsdialog

  • Name

    Geben Sie einen Namen für die Cluster Map Konfiguration ein. Der Name wird auf der Benutzeroberfläche dargestellt.

  • Modelltyp

    Wählen Sie einen Modelltyp als Basis für die Cluster Map aus. Im Normalfall wählen Sie dafür das Architektur-Diagramm oder Analysemodell.

  • Ebenendefinition

    Erstellen Sie eine Ebenendefinition für die neue Cluster Map Konfiguration.

  • Relationendefinition

    Erstellen Sie eine Relationendefinition für die neue Cluster Map Konfiguration.

  • Modell wiederverwenden (überschreibt das Original)

    Wählen Sie aus, ob die Cluster Map als neues Modell erzeugt werden oder das Originalmodell überschreiben soll.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Cluster Map Konfiguration wird in der Datenbank gespeichert und zu den vorhandenen Cluster Map Konfigurationen hinzugefügt.

Ebenendefinition

Die Ebenendefinition enthält die Klassen, die pro Ebene der Cluster Map erlaubt sind und zur Datenanalyse verwendet werden.

  • Eine Cluster Map hat mindestens zwei Ebenen.

  • Jede Ebene enthält mindestens eine Klasse.

  • Runde Klammern umschließen jede einzelne Ebene und alle Ebenen gemeinsam.

  • Eine Klasse in einer Ebene wird durch ihren sprachunabhängigen Namen dargestellt.

Der sprachunabhängige Name einer Klasse ist hervorgehoben, wenn Sie den Klasse bearbeiten Dialog öffnen:

  • Doppelklicken Sie die Klasse im Metamodellkatalog (beliebige Ansicht) der Metamodellverwaltung.
Beispiel: Ebenendefinition

Die Ebenendefinition einer einfachen Cluster Map könnte so aussehen:

((C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Diese Cluster Map hat drei Ebenen. Die erste Ebene enthält die Klasse "Geschäfts-Prozess" (sprachunabhängiger Name C_BUSINESS_PROCESS). Die zweite Ebene enthält die Klasse "Applikations-Komponente" (sprachunabhängiger Name C_APPLICATION_COMPONENT). Die dritte Ebene enthält die Klasse "Systemsoftware" (sprachunabhängiger Name C_SYSTEM_SOFTWARE).

Ebene überbrücken

Um eine Ebene in einer Cluster Map auszublenden:

  • Fügen Sie drei Sternchen vor der Ebene ein, die Sie überbrücken wollen.

In der Darstellung enthalten die Großeltern so direkt die Kinder der überbrückten Ebene (= ihre Enkelkinder). Da alle Enkelkinder im selben Objekt liegen, ist eine Unterscheidung zwischen Geschwistern und Cousins nicht mehr möglich.

Beispiel: Ebene überbrücken

In der folgenden Ebenendefinition wird die zweite Ebene der Cluster Map überbrückt:

((C_BUSINESS_PROCESS)(*** C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Layout Parameter

Die Anordnung und Dimensionierung von Objekten in einer Cluster Map basiert auf drei Parametern. Diese Parameter können entweder auf einmal für jede Ebene festgelegt werden (z. B. "1 0 0", "0 0 2" etc.; diese Werte sind weiter unten erklärt) oder überhaupt nicht. Wenn die Parameter nicht in der Konfiguration festgelegt sind, werden ihre Standardeinstellungen verwendet.

Geschwisterwachstum abstimmen

Der erste Parameter stimmt das Wachstum von Objekten einer Ebene aufeinander ab, wenn sie dasselbe Elternobjekt haben. Die möglichen Werte sind:

  • "0" um den Parameter zu deaktivieren.

  • “1” um den Parameter zu aktivieren.

Wenn Geschwisterwachstum abstimmen aktiviert ist und ein Objekt wachsen muss, wachsen seine Geschwister in derselben Größenordnung mit.

Standardmäßig ist diese Einstellung aktiv. Dieser Parameter wirkt sich nur auf aktualisierte Objekte aus. Daher hat er keinen Einfluss auf Cluster Maps, die auf ein Objekt erstellt werden.

Hinweis

Wenn Sie Modellvorlagen verwenden, in denen die Größe von Objekten angepasst wurde, wächst jedes Objekt im Verhältnis zu seiner festgelegten Größe. Größere Objekte benötigen nach dem Wachsen dadurch noch mehr Platz als ihre kleineren Geschwister. Erzeugen Sie in einer Modellvorlage daher nur dann große Objekte, wenn Sie mit vielen Objekten befüllt werden, die mit ihnen in Beziehung stehen.

Beispiel: Geschwisterwachstum abstimmen

In der folgenden Ebenendefinition ist Geschwisterwachstum abstimmen für die erste Ebene der Cluster Map aktiviert:

((1 0 0 C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Abstände anpassen

Der zweite Parameter passt die Abstände zwischen Objekten an, wenn sie dasselbe Elternobjekt haben. Die möglichen Werte sind:

  • "0" um den Parameter zu deaktivieren.

  • “1” um den Parameter zu aktivieren.

Dieser Parameter kann nur aktiviert werden, wenn auch Geschwisterwachstum abstimmen aktiv ist. Wenn Abstände anpassen aktiviert ist und ein Objekt wachsen muss, passen seine Geschwister ihre Größe und Position zueinander an. Daher vergrößert sich auch der Abstand zwischen Objekten.

Standardmäßig ist diese Einstellung aktiv. Dieser Parameter wirkt sich nur auf aktualisierte Objekte aus. Daher hat er keinen Einfluss auf Cluster Maps, die auf ein Objekt erstellt werden.

Hinweis

Aktivieren Sie diesen Parameter, wenn Sie sicherstellen wollen, dass das vorgegebene Layout einer Ebene aus einer Modellvorlage sich nicht ändert, wenn Objekte wachsen. Elemente bleiben im Verhältnis zueinander in der gleichen Position.

Beispiel: Abstände anpassen

In der folgenden Ebenendefinition ist Abstände anpassen für die erste Ebene der Cluster Map aktiviert. Geschwisterwachstum abstimmen muss ebenfalls aktiv sein.

((1 1 0 C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Beispiel: Auswirkung von Geschwisterwachstum abstimmen und Abstände anpassen

Dieses Beispiel erläutert die Auswirkung der beiden Parameter Geschwisterwachstum abstimmen und Abstände anpassen. Die Parameter sind für die erste Ebene der Cluster Map aktiviert / deaktiviert.

 Auswirkung von Geschwisterwachstum abstimmen und Abstände anpassen

  • Modellvorlage (1).

  • Ebenendefinition: ((0 0 0 C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT).

    Geschwisterwachstum abstimmen deaktiviert, Abstände anpassen deaktiviert (2).

  • Ebenendefinition: ((1 0 0 C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT).

    Geschwisterwachstum abstimmen aktiviert, Abstände anpassen deaktiviert (3).

  • Ebenendefinition: ((1 1 0 C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT).

    Geschwisterwachstum abstimmen aktiviert, Abstände anpassen aktiviert (4).

Wachstumsrichtung anpassen

Der dritte Parameter beeinflusst, wie Objekte in einer Ebene angeordnet werden, wenn sie dasselbe Elternobjekt haben. Die möglichen Werte sind:

  • “0” damit Objekte nach rechts wachsen.

  • “1” damit Objekte nach unten wachsen.

  • "2" damit das Seitenverhältnis des Elternobjekts erhalten bleibt, wenn die Kinder angeordnet werden. Wenn das Elternobjekt neu hinzugefügt wurde, wird seine Größe so angeglichen, dass das Raster der Kinder so gut wie möglich einem goldenen Rechteck entspricht.

  • “3” damit das Raster der neuen Objekte so gut wie möglich einem goldenen Rechteck entspricht.

Standardmäßig wachsen Objekte nach unten. Dieser Parameter wirkt sich nur auf neu hinzugefügte Objekte aus. Sie werden so angeordnet, dass sie keine vorhandenen (= aktualisierten) Objekte überlappen.

Beispiel: Wachstumsrichtung anpassen

In der folgenden Ebenendefinition ist festgelegt, dass Objekte der zweiten Ebene der Cluster Map nach unten wachsen:

((C_BUSINESS_PROCESS)(0 0 1 C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Beispiel: Auswirkung von Wachstumsrichtung anpassen

Dieses Beispiel erläutert die Auswirkung des Parameters Wachstumsrichtung anpassen. Der Parameter ist für die zweite Ebene der Cluster Map aktiviert / deaktiviert.

 Auswirkung von Wachstumsrichtung anpassen

  • Modellvorlage (1).

  • Ebenendefinition: ((C_BUSINESS_PROCESS)(0 0 0 C_APPLICATION_COMPONENT).

    Wachstum nach rechts (2).

  • Ebenendefinition: ((C_BUSINESS_PROCESS)(0 0 1 C_APPLICATION_COMPONENT).

    Wachstum nach unten (3).

  • Ebenendefinition: ((C_BUSINESS_PROCESS)(0 0 2 C_APPLICATION_COMPONENT).

    Seitenverhältnis erhalten (4).

  • Ebenendefinition: ((C_BUSINESS_PROCESS)(0 0 3 C_APPLICATION_COMPONENT).

    Goldenes Rechteck (5).

Relationendefinition

Die Relationendefinition enthält die Relationsklassen, die die Ebenen in einer Cluster Map verbinden.

  • Benachbarte Ebenen in einer Cluster Map sind durch Relationsklassen verbunden.

  • Runde Klammern umschließen jede einzelne Relationsklasse und alle Relationsklassen gemeinsam.

  • Die Startebene und die Endebene einer Relationsklasse sind durch eine Nummer gekennzeichnet (0,1,2,…).

  • Die Richtung, in die eine Beziehung erlaubt ist, ist ebenfalls gekennzeichnet ("<" bedeutet vom Ende zum Start, ">" bedeutet vom Start zum Ende, "=" bedeutet in beide Richtungen).

  • Eine Relationsklasse wird durch ihren sprachunabhängigen Namen dargestellt.

Der sprachunabhängige Name einer Relationsklasse ist hervorgehoben, wenn Sie den Relationsklasse bearbeiten Dialog öffnen:

  • Doppelklicken Sie die Relationsklasse im Metamodellkatalog (beliebige Ansicht) der Metamodellverwaltung.
Beispiel: Relationendefinition

Angenommen, die Ebenendefinition einer Cluster Map sieht folgendermaßen aus:

((C_BUSINESS_PROCESS)(C_APPLICATION_COMPONENT)(C_SYSTEM_SOFTWARE))

Die Relationendefinition dieser Cluster Map könnte so aussehen:

((0 1 < RC_SERVING)(1 2 < RC_SERVING))

Diese Relationendefinition enthält zwei Beziehungen. Als Relationsklasse ist beide Male "Dient" (sprachunabhängiger Name RC_SERVING) festgelegt. Die erste Beziehung verbindet die erste und die zweite Ebene der Cluster Map. Die Richtung ist von der zweiten Ebene zur ersten. Die zweite Beziehung verbindet die zweite und die dritte Ebene der Cluster Map. Die Richtung ist von der dritten Ebene zur zweiten.

Konfigurationen der Gantt-Sicht

Eine Gantt-Sicht ist ein Diagramm mit rechteckigen Balken, deren Länge zu den Werten proportional ist, die sie darstellen. Die Objekte werden als horizontal ausgerichtete Balken dargestellt.

Eine Gantt-Konfiguration definiert die Klasse der visualisierten Objekte und die Attribute, die als Balken dargestellt werden. Mindestens ein Attribut muss definiert werden. Für Attribute des Typs DATE können zwei Attribute (Start-und Enddatum) definiert werden.

Abhängigkeiten

Die Gantt-Konfiguration wird vom verwendeten Metamodell definiert. Nur Modellierungsklassen, die mindestens ein Attribut des Typs INTEGER, DOUBLE, ENUM, BOOL oder DATE enthalten, werden im Konfigurationsassistenten angezeigt. Modellkontext-spezifische Attribute können nicht für eine Gantt-Konfiguration verwendet werden.

Gantt-Konfiguration erstellen

Um eine Gantt-Konfiguration zu erstellen:

  1. Wählen Sie Sichten - Konfigurationen der Gantt-Sicht.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Neue Konfiguration erstellen.

Die erste Seite des Gantt Konfigurationsassistenten öffnet sich im Tab Bibliothekenverwaltung.

Gantt Konfigurationsassistent - Seite 1

Die erste Seite des Gantt Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Gantt-Konfiguration erstellen Seite 1

  • Name der Konfiguration

    Der Name der Gantt-Konfiguration. Der Name wird auf der Benutzeroberfläche dargestellt.

  • Beschreibung der Konfiguration

    Eine Beschreibung der Gantt-Konfiguration. Diese Einstellung ist optional.

  • Startklasse für die Konfiguration

    Die Startklasse der neuen Gantt-Konfiguration. Die Startklasse ist diejenige, auf der alle Beziehungen zu anderen Klassen basieren.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des Gantt Konfigurationsassistenten öffnet sich.

Gantt Konfigurationsassistent - Seite 2

Die zweite Seite des Gantt Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Gantt-Konfiguration erstellen Seite 2

  • Liste der Relationsklassen

    Der Inhalt des linken Fensterbereichs hängt von der gewählten Startklasse ab. In diesem Bereich wird eine Liste aller vorhandenen Relationsklassen des ausgewählten Elements angezeigt, aufgeteilt in aus- und eingehende Relationsklassen.

    Durch Markieren einer Klasse und einen Klick auf die " >"-Schaltfläche zwischen den beiden Fensterbereichen wird eine Klasse zur Konfiguration hinzugefügt. Nun kann diese Klasse im rechten Fenster ausgewählt werden, um die Hierarchie der Gantt-Konfiguration weiter zu spezifizieren.

  • Vorschau

    Im rechten Fensterbereich werden die Elemente, die bereits zur Konfiguration hinzugefügt wurden, als Layer dargestellt. Ein Icon zum Entfernen eines Layers wird per Mouseover aktiviert.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die dritte Seite des Gantt Konfigurationsassistenten öffnet sich.

Gantt Konfigurationsassistent - Seite 3

Die dritte Seite des Gantt Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Gantt-Konfiguration erstellen Seite 3

  • Attribut

    Das Attribut, das auf der X-Achse dargestellt werden soll. Attribute der Typen INTEGER, DOUBLE, ENUM, BOOL und DATE sind möglich.

  • Attribute (Enddatum)

    Ein zusätzliches DATE Attribut kann definiert werden, wenn das erste Attribut ebenfalls vom Typ DATE ist. So können Zeiträume in Gantt-Sichten dargestellt werden.

  • Werte aggregieren

    Aktivieren Sie diese Einstellung, um den aggregierten Wert aller Attribute eines Objekts in einem zusätzlichen Balken anzuzeigen. Diese Einstellung ist nur für Attribute des Typs INTEGER, BOOL und DATE verfügbar.

  • Aggregationsmethode

    Wählen Sie die Methode, nach der sich der aggregierte Wert berechnet: Maximum, Minimum, Durchschnitt, Summe. Diese Einstellung ist nur für Attribute des Typs INTEGER verfügbar.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Gantt-Konfiguration wird als XML-Datei in der Datenbank gespeichert und zu den vorhandenen Gantt-Konfigurationen hinzugefügt.

Konfigurationen der Matrix-Sicht

Eine Matrix-Sicht in ADOIT stellt Abhängigkeiten (als Zellen in der Matrix) zwischen Objekten der X-Achse und der Y-Achse dar. Eine Verknüpfung kann:

  • eine Verbindung zwischen einem Objekt auf der X-Achse und einem Objekt auf der Y-Achse sein oder

  • ein Objekt sein, dass mit der X-Achse und der Y-Achse über Relationen verbunden ist.

Eine Matrix-Konfiguration definiert die Modellierungsklasse der dargestellten X-Achse Objekte, die Modellierungsklasse der dargestellten Y-Achse Objekte und die Klasse für die Matrixzellen. Sie haben die Möglichkeit, eine Relationsklasse oder eine Modellierungsklasse für die Matrixzellen zu definieren. Im Falle einer Modellierungsklasse müssen Sie festlegen, wie die Klasse mit der X-Achse Klasse und der Y-Achse Klasse verbunden ist. Dazu muss eine Klasse mit zwei Relationsklassen definiert werden.

Abhängigkeiten

Die Matrix-Konfiguration wird vom verwendeten Metamodell definiert. Mindestens eine Modellierungsklasse (für die X-Achse und die Y-Achse) und eine Relationsklasse (für die Zellen) müssen im Metamodell definiert sein.

Matrix-Konfiguration erstellen

Um eine Matrix-Konfiguration zu erstellen

  1. Wählen Sie Sichten - Konfigurationen der Matrix-Sicht.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Neue Konfiguration erstellen.

Die erste Seite des Matrix Konfigurationsassistenten öffnet sich im Tab Bibliothekenverwaltung.

Matrix Konfigurationsassistent - Seite 1

Die erste Seite des Matrix Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Matrix-Konfiguration erstellen Seite 1

  • Name der Konfiguration

    Der Name der Matrix-Konfiguration. Der Name wird auf der Benutzeroberfläche dargestellt.

  • Beschreibung der Konfiguration

    Eine Beschreibung der Matrix-Konfiguration. Diese Einstellung ist optional.

  • X-Achse

    Diese Einstellung bestimmt die Modellierungsklasse der dargestellten X-Achse Objekte.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die zweite Seite des Matrix Konfigurationsassistenten öffnet sich.

Matrix Konfigurationsassistent - Seite 2

Die zweite Seite des Matrix Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Matrix-Konfiguration erstellen Seite 2

  • Zelle

    Diese Einstellung bestimmt die Klasse der Matrixzelle.

Wenn Sie diese Einstellungen abgeschlossen haben, klicken Sie auf Weiter >. Die dritte Seite des Matrix Konfigurationsassistenten öffnet sich.

Matrix Konfigurationsassistent - Seite 3

Die dritte Seite des Matrix Konfigurationsassistenten ermöglicht die folgenden Einstellungen:

 Matrix-Konfiguration erstellen Seite 3

  • Y-Achse

    Diese Einstellung bestimmt die Modellierungsklasse der dargestellten Y-Achse Objekte.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Matrix-Konfiguration wird als XML-Datei in der Datenbank gespeichert und zu den vorhandenen Matrix-Konfigurationen hinzugefügt.

Konfigurationen der Portfolio-Sicht

Eine Portfolio-Sicht stellt Objekte als Blasen in einem Bereich dar. Der Bereich wird durch zwei Achsen (X-Achse und Y-Achse) definiert.

Ein Portfolio-Konfiguration bestimmt die Klasse der dargestellten Objekte und Attribute für die X-Achse, die Y-Achse und die Blasengröße. Das Attribut für Blasengröße ist optional; alle Blasen haben die gleiche Größe, wenn das Attribut nicht gesetzt ist.

Abhängigkeiten

Die Portfolio-Konfiguration wird vom verwendeten Metamodell definiert. Nur Modellierungsklassen, die mindestens zwei Attribute des Typs INTEGER, DOUBLE, ENUM, BOOL oder DATE enthalten, werden im Konfigurationsassistenten angezeigt. Modellkontext-spezifische Attribute können nicht für eine Portfolio-Konfiguration verwendet werden.

Portfolio-Konfiguration erstellen

Um eine Portfolio-Konfiguration zu erstellen:

  1. Wählen Sie Sichten - Konfigurationen der Portfolio-Sicht.

  2. Wählen Sie im Kontextmenü der Auswahl den Menüpunkt Neue Konfiguration erstellen.

Der Portfolio Konfigurationsassistent öffnet sich im Tab Bibliothekenverwaltung.

Portfolio Konfigurationsassistent

Der Portfolio Konfigurationsassistent ermöglicht die folgenden Einstellungen:

 Portfolio-Konfiguration erstellen

  • Name der Konfiguration

    Der Name der Portfolio-Konfiguration. Der Name wird auf der Benutzeroberfläche dargestellt.

  • Beschreibung der Konfiguration

    Eine Beschreibung der Portfolio-Konfiguration. Diese Einstellung ist optional.

  • Attribut der X-Achse

    Attribute der Typen INTEGER, DOUBLE, ENUM, BOOL und DATE werden angezeigt.

  • Attribut der Y-Achse

    Attribute der Typen INTEGER, DOUBLE, ENUM, BOOL und DATE werden angezeigt.

  • Attribut für die Objektgröße

    Attribute der Typen INTEGER, DOUBLE und ENUM werden unterstützt.

  • Modellierungsklasse

    Ein Modellierungsklasse wird hier angezeigt, wenn sie mindestens zwei Attribute enthält, die auf den Portfolio-Achsen dargestellt werden können.

Wenn Sie diese Einstellungen abgeschlossen haben, bestätigen Sie mit OK. Die Portfolio-Konfiguration wird als XML-Datei in der Datenbank gespeichert und zu den vorhandenen Portfolio-Konfigurationen hinzugefügt.

Web-Client

Hier verwalten Sie die Einstellungen für den Web-Client.

Attribute für die Volltextsuche

Beim Ausführen einer Suche im Web-Client werden bestimmte Attribute berücksichtigt, um übereinstimmende Objekte oder Modelle zu finden. Standardmäßig sind das die Attribute Name, Beschreibung, Vorname und Nachname. Weitere Attribute der Typen Kurztext, ADOtext sowie Langtext definieren Sie mit dieser Funktion. Folgende Einstellungen stehen zur Verfügung:

Selektieren Sie Attribute, die immer in den Suchergebnissen vorhanden sein sollen

Die hier definierten Attribute werden immer berücksichtigt:

  • bei Verwendung der allgemeinen Suchfunktion im ADOIT Web-Client (Suche & Analyse)

Die Suchergebnis-Tabelle liefert eine separate Spalte für jedes dieser Attribute aus. Gefundene Suchbegriffe sind im Suchergebnis gelb markiert.

Globale Attribute für die Explorer Suche verwenden

Aktivieren Sie dieses Kontrollkästchen, damit die oben ausgewählten Attribute zusätzlich berücksichtigt werden:

  • bei Verwendung der Suchfunktion im Explorer

  • beim Verwalten von Beziehungen im Notebook, wenn die Suchfunktion verwendet wird

Wenn dieses Kontrollkästchen deaktiviert ist, wird nur der Name berücksichtigt, wenn Sie die Suchfunktion im Explorer und beim Verwalten von Beziehungen verwenden.

Namensvisualisierungsmuster für die Explorer Suche verwenden

Während der Konfiguration von ADOIT kann von einem BOC Solution Engineer ein Namensmuster für einen Modelltyp oder eine Klasse definiert werden. Das Namensmuster bestimmt, aus welchen Teilen sich der visualisierte Name auf der Benutzeroberfläche zusammensetzt.

Aktivieren Sie dieses Kontrollkästchen, damit Relationen berücksichtigt werden, die Teil des Namensmusters sind:

  • bei Verwendung der Suchfunktion im Explorer

  • beim Verwalten von Beziehungen im Notebook, wenn die Suchfunktion verwendet wird

Wenn dieses Kontrollkästchen deaktiviert ist, wird nur der Name berücksichtigt, wenn Sie die Suchfunktion im Explorer und beim Verwalten von Beziehungen verwenden.

Hinweis

Das Laden dieser Funktion kann ein paar Minuten dauern, wenn eine umfangreiche Bibliothek in Verwendung ist.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Allgemein

Die allgemeinen Einstellungen ermöglichen die Konfiguration der grundlegenden Verhaltensweisen des ADOIT Web-Clients. Die folgenden Einstellungen stehen zur Verfügung:

  • Umbenennen von Katalog-Elementen erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Umbenennen von Katalog-Elementen im Web-Client zu erlauben.

  • Erstellen neuer Objekte erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Erstellen neuer Objekte im Web-Client zu erlauben.

  • Modelltypen beim Erstellen neuer Objekte ausblenden

    Aktivieren Sie dieses Kontrollkästchen, um beim Erstellen eines Objekts im Explorer alle Objekttypen in einer flachen Liste anzuzeigen. Wenn Sie dieses Kontrollkästchen deaktivieren, werden Objekttypen nach Modelltyp gruppiert.

  • Erstellen von Modellgruppen erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Erstellen neuer Modellgruppen im Web-Client über den Katalog zu erlauben.

  • Erstellen von Objektgruppen erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Erstellen neuer Objektgruppen im Web-Client über den Katalog zu erlauben.

  • Verschieben von Elementen im Katalog erlauben

    Aktivieren Sie dieses Kontrollkästchen, um Web-Client Benutzern zu erlauben, Elemente (Modelle, Objekte, Gruppen) per Drag & Drop in andere Verzeichnisse zu verschieben.

  • Löschen von Modellen und Objekten erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Löschen von Objektgruppen im Web-Client zu erlauben.

  • Modelle mit gleichem Typ und gleichem Namen erlauben

    Aktivieren Sie dieses Kontrollkästchen, um Web-Client Benutzern zu erlauben, mehrere Modelle vom selben Typ mit dem gleichen Namen zu erzeugen.

  • Objekte mit gleicher Klasse und gleichem Namen erlauben

    Aktivieren Sie dieses Kontrollkästchen, um Web-Client Benutzern zu erlauben, mehrere Repository-Objekte vom selben Typ mit dem gleichen Namen zu erzeugen.

  • Modelle im Katalog anzeigen

    Aktivieren Sie dieses Kontrollkästchen, um Modelle im Katalog des Web-Client anzuzeigen.

  • Objekte im Katalog anzeigen

    Aktivieren Sie dieses Kontrollkästchen, um Objekte im Katalog des Web-Client anzuzeigen.

  • Kollaborationskomponente aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit die Kollaborationskomponente im Web-Client verfügbar ist.

  • Abhängigkeitsanalysekomponente aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit die Abhängigkeitsanalysekomponente im Web-Client verfügbar ist. Zusätzliche Konfigurationsschritte können erforderlich sein.

  • Favoriten aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit im Web-Client Favoriten verfügbar ist.

  • Übersetzungskomponente aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit die Übersetzungskomponente im Web-Client verfügbar ist.

  • Hochladen von Dateien in das DMS erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Importieren von externen Dateien in die Datenbank im Web-Client zu erlauben.

  • Grafischen Modellvergleich aktivieren

    Aktivieren Sie dieses Kontrollkästchen, um das Ausführen von grafischen Modellvergleichen im Web-Client zu erlauben.

  • Passwort ändern erlauben

    Aktivieren Sie dieses Kontrollkästchen, um das Ändern von Passwörtern im Web-Client zu erlauben.

  • Im Relations-Dialog standardmäßig die Suche nutzen

    Die Standardstruktur zur Zuweisung von Relations-Zielen zu einem Objekt im Web-Client ist eine Baumstruktur. Wenn dieses Kontrollkästchen aktiviert ist, wird standardmäßig die Suche verwendet.

  • Zuletzt geöffnete Modelle aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit in der Schnellzugriff-Komponente im Explorer zuletzt geöffnete Modelle angezeigt werden. Wenn Sie dieses Kontrollkästchen deaktivieren, werden keine Modelle angezeigt.

  • Zuletzt geöffnete Objekte aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit in der Schnellzugriff-Komponente im Explorer zuletzt geöffnete Objekte angezeigt werden. Wenn Sie dieses Kontrollkästchen deaktivieren, werden keine Objekte angezeigt.

  • Automatische Suche aktivieren

    Aktivieren Sie dieses Kontrollkästchen, damit die Option Automatisch suchen im Web-Client standardmäßig aktiviert ist, also die Suchergebnisse automatisch angepasst werden, wenn der Benutzer einen Suchfilter bearbeitet.

  • "Speichern unter" deaktivieren

    Aktivieren Sie dieses Kontrollkästchen, um das Erstellen von Kopien von Modellen im Web-Client zu verbieten.

  • Hervorheben von Relationen aktivieren

    Aktivieren Sie dieses Kontrollkästchen, um beim Erstellen von Relationen im Web-Client die Relation mit der höchsten Priorität hervorzuheben. Wenn Sie dieses Kontrollkästchen deaktivieren, wird keine Relation hervorgehoben.

Mail

Der ADOIT Web-Client beinhaltet eine Mail-Komponente, die die automatische Versendung von Nachrichten aufgrund verschiedener Ereignisse erlaubt. Bevor diese Komponente verwendet werden kann, muss sie konfiguriert werden. Die folgenden Einstellungen stehen zur Verfügung:

  • Mail-Service aktivieren

    Aktivieren Sie dieses Kontrollkästchen, um den Mail-Service zu aktivieren. Wenn der Web-Server gestartet wird, schickt er regelmäßige Abfragen nach neuen E-Mails an den Applikations-Server.

  • IP-Adresse oder Name des Mail-Servers

    Geben Sie die IP-Adresse oder den Hostnamen des Clients ein, auf dem der Mail-Server installiert ist.

  • Port des Mail-Servers

    Geben Sie die Port-Nummer ein, die zum Zugriff auf den Mail-Server verwendet wird. Normalerweise ist dies Port 25.

  • System-Senderadresse

    Geben Sie die Systemadresse ein, die als Absenderadresse für System-Benachrichtigungen verwendet werden soll (z. B. erhalten Benutzer eine Benachrichtigung, wenn ihre Aufmerksamkeit für einen Schritt in einem Freigabe-Workflow erforderlich ist, und die Absenderadresse ist die in diesem Feld eingetragene Systemadresse).

  • Verschlüsselung

    Wählen Sie eine Verschlüsselungsoption, wenn der Mail-Server diese benötigt:

    Keine: Es wird keine Verschlüsselung verwendet.

    StartTLS (optional): Verwenden Sie StartTLS zum Upgraden auf eine verschlüsselte Verbindung. Wenn der Mail-Server StartTLS nicht unterstützt, wird eine unverschlüsselte Verbindung verwendet.

    StartTLS (erforderlich): Verwenden Sie StartTLS zum Upgraden auf eine verschlüsselte Verbindung. Wenn der Mail-Server StartTLS nicht unterstützt, schlägt der Vorgang fehl (keine E-Mails versendet).

    SSL/TLS: Verwenden Sie SSL/TLS zur Verschlüsselung der Kommunikation. Wenn der Mail-Server SSL/TLS nicht unterstützt, schlägt der Vorgang fehl (keine E-Mails versendet).

  • Authentifizierung erforderlich

    Aktivieren Sie dieses Kontrollkästchen, wenn der Mail-Server eine Authentifizierung anfordert. Normalerweise ist das der Fall.

  • Benutzername

    Geben Sie den Benutzernamen ein, der vom ADOIT Web-Client zum Versenden von E-Mails verwendet werden soll.

  • Passwort

    Geben Sie das Passwort ein, das vom ADOIT Web-Client zur Authentifizierung mit dem Mail-Server verwendet werden soll.

  • Intervall in Sekunden, in dem Mails abgearbeitet werden

    Diese Einstellung definiert das Intervall, das vom Web-Server verwendet wird, um den Applikations-Server nach neuen E-Mails abzufragen. Ein Wert von 300 bedeutet, dass der Web-Server für 300 Sekunden (= 5 Minuten) zwischen den Anfragen für neue Mails wartet.

Hinweis

E-Mail-Benachrichtigungen können nur dann versandt werden, wenn die Basis-URL richtig konfiguriert ist.

Info

Die ADOIT Webapplikation, die auf dem Web-Server läuft, muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Modellvergleich

Der grafische Modellvergleich im ADOIT Web-Client macht die Unterschiede zwischen zwei Modellen sichtbar. Das betrifft gelöschte Objekte bzw. Konnektoren, neu erstellte Objekte bzw. Konnektoren sowie Änderungen von Attributwerten.

Der grafische Modellvergleich kann im Administrations-Toolkit konfiguriert werden. Folgende Einstellungen stehen zur Verfügung:

  • Einstellungen für den Modellvergleich

    Wählen Sie aus, welche Attribute beim Vergleich von Modellen berücksichtigt werden sollen.

Modellierung

Konfigurieren Sie Einstellungen zum Automatischen Speichern, Darstellungsoptionen für den ADOIT Web-Client und andere Einstellungen. Die meisten dieser Einstellungen können von den Benutzern des ADOIT Web-Clients entsprechend ihrer persönlichen Vorlieben überschrieben werden.

Allgemein

Folgende Einstellungen sind möglich:

  • Automatisches Speichern

    Automatisches Speichern von Änderungen in Modellen und Objekten aktivieren. Anzahl der Änderungsschritte bis zum nächsten Speichern festlegen.

Modellierung

Folgende Einstellungen sind möglich:

  • Rechtwinklige Konnektoren

    Neue Konnektoren automatisch rechtwinklig zeichnen. Deaktivieren Sie dieses Kontrollkästchen, damit ADOIT stattdessen gerade Konnektoren zeichnet.

  • Brücken

    Brücken zeichnen, wenn Konnektoren sich kreuzen.

  • Fadenkreuz

    Fadenkreuz beim Modellieren anzeigen.

  • Mitbewegen

    Größenveränderbare Objekte und Aggregationen können als Container-Objekte für andere Objekte dienen. Wenn Sie so einen Container auf der Zeichenfläche verschieben, werden die darauf platzierten Objekte mitbewegt. Dazu müssen Sie gleichzeitig die Umschalttaste (<Shift>) gedrückt halten.

    Deaktivieren Sie dieses Kontrollkästchen, damit enthaltene Objekte auf jeden Fall mitbewegt werden (ohne gleichzeitig die <Shift>-Taste zu drücken).

Hinweis

Wenn Sie die ADOIT Standard-Anwendungsbibliothek verwenden, ist der folgende Objekttyp eine Aggregation: Block. Die ArchiMate-Anwendungsbibliothek enthält keine Aggregationen.

  • Seitenumbrüche

    Seitenumbrüche teilen Modelle beim Drucken in separate Seiten auf. Sie werden im grafischen Editor als gestrichelte Linien angezeigt. Wählen Sie aus, ob Seitenumbrüche und die Seitennummerierung sichtbar sind, wenn ein Benutzer auf ein Modell Schreibzugriff oder Lesezugriff hat.

Modellierungsrichtung

Die Modellierungsrichtung kann entweder horizontal (Modellierung von links nach rechts) oder vertikal (Modellierung von oben nach unten) verlaufen. Sie können die Modellierungsrichtung für jeden Modelltyp definieren.

Aktivieren Sie das Kontrollkästchen Änderbar, um Web-Client Benutzern zu erlauben, die Modellierungsrichtung für ein bestimmtes Modell im grafischen Editor zu ändern. Dabei werden die Objekte auf der Zeichenfläche automatisch neu angeordnet.

Hinweis

Bei Verwendung des Hover-Modellierungsassistenten im Web-Client legt die Modellierungsrichtung fest, wo das nächste Objekt platziert wird:

  • Horizontal: Rechts neben dem ausgewählten Objekt

  • Vertikal: Unter dem ausgewählten Objekt

Objekt Mouse-Over

Die Objekt Mouse-Over-Einstellungen erlauben das Konfigurieren von Tooltips für Objekte im Web-Client. Diese Tooltips werden angezeigt, wenn ein Modell mit Lesezugriff im grafischen Editor oder im Organisationsportal geöffnet wird. Folgende Einstellungen stehen zur Verfügung:

  • Einstellungen für Objekt Mouse-Over

    Wählen Sie aus, welche Attribute berücksichtigt werden sollen, wenn Tooltips für Objekte angezeigt werden.

Drucken und Reports

Konfigurieren Sie Einstellungen für das Drucken von Modellen als PDF, für das Erzeugen von PDF- und RTF-Reports, und für das Generieren von Grafiken im ADOIT Web-Client.

  • Auswahl der Druckvorlagen für den Druckdialog

    Legen Sie fest, welche Druckvorlagen beim Drucken von Modellen als PDF verwendet werden können. Je nach Anwendungsbibliothek stehen verschiedene Reports und die Druckvorlage Standard zur Verfügung. Reports, die nicht für die Verwendung als Druckvorlage vorgesehen sind, werden nicht angezeigt.

  • Standardvorlage

    Legen Sie eine Standardvorlage für das Drucken von Modellen als PDF fest.

  • Standard Seitenlayout

    Legen Sie ein Standard-Seitenlayout für das Drucken von Modellen als PDF und für das Erzeugen von PDF- und RTF-Reports fest. Seitenlayouts bestimmen das Aussehen der Kopf- und Fußzeilen.

    Hinweis

    Wenn Sie die ArchiMate-Anwendungsbibliothek oder die ADOIT Standard-Anwendungsbibliothek verwenden, ist das Standardseitenlayout für das Drucken von Modellen als PDF für alle Modelltypen direkt im Metamodell definiert und diese Einstellung wird nicht ausgewertet. Diese Einstellung wird jedoch weiterhin als Standardeinstellung für das Erzeugen von Reports ausgewertet.

    Web-Client Benutzer können ihr bevorzugtes Seitenlayout für das Drucken von Modellen als PDF und für das Erzeugen von PDF- und RTF-Reports selbst auswählen (unter > Einstellungen > Drucken).

  • PDF-Version

    Wählen Sie eine PDF-Version zum Drucken von Modellen als PDF und für das Erzeugen von PDF-Reports aus. PDF ist das Standardformat für Qualitätsdruck. PDF/A dient zur Langzeitarchivierung von elektronischen Dokumenten. Die Verfügbarkeit von PDF-Versionen hängt von der Konfiguration der Druckvorlagen ab.

Hinweis

Weitere Informationen zu PDF/A finden Sie unter https://www.pdfa.org/pdfa-faq/. In ADOIT erstellte PDF/A-Dokumente sind PDF/a-1b-konform.

  • Bildformat für das Drucken von Modellen als PDF

    Legen Sie das Bildformat für enthaltene Bilder beim Drucken von Modellen als PDF fest. Sie können zwischen PNG (pixelbasiertes Bildformat) und SVG (vektorbasiertes Bildformat) wählen.

  • Bildformat für das Generieren von Grafiken

    Legen Sie das Bildformat für das Generieren von Grafiken fest (= Exportieren von Modellen im grafischen Editor als Grafikdateien). Sie können zwischen PNG (pixelbasiertes Bildformat) und SVG (vektorbasiertes Bildformat) wählen.

  • Maximale Seitenanzahl für das Drucken von Modellen

    Legen Sie die maximale Seitenanzahl fest, die beim Drucken von Modellen als PDF im Vorschaufenster ausgewählt werden können.

  • Einstellungen für die Seitengröße

    Legen Sie fest, welche Papierformate beim Drucken von Modellen als PDF verwendet werden können.

    Um ein neues Papierformat hinzuzufügen, klicken Sie auf die Schaltfläche Neue Seitengröße. Geben Sie dann den Formatnamen und die Breite und Höhe in Millimetern an (z. B. Letter, 216, 279).

    Doppelklicken Sie auf ein Papierformat, um es zu ändern.

    Um ein Papierformat zu entfernen, wählen Sie das gewünschte Papierformat aus, und klicken Sie dann auf die Ausgewählte entfernen Schaltfläche.

System

Diese Einstellungen ermöglichen es einem ADOIT Administrator, technische Einstellungen zu definieren, die die grundlegende Funktionsweise des Web Clients betreffen. Die folgenden Einstellungen stehen zur Verfügung:

  • Basis-URL

    Tragen Sie die URL ein, unter der der Web-Client von anderen Rechnern aus erreicht werden kann: "http://<SERVER_NAME>:<TOMCAT_PORT>/ADOIT12_0/".

    <SERVER_NAME> ist der Name des Host-Systems. <TOMCAT_PORT> ist der beim Setup definierte HTTP/1.1 Connector Port, unter dem Apache Tomcat (und damit auch der Web-Client) erreichbar ist. Der Standard-Wert ist „8000“.

  • Session-Timeout (Minuten)

    Legen die Anzahl der Minuten fest, die eine Sitzung inaktiv bleiben kann, bevor der Server sie automatisch beendet. Der Standardwert ist 20 Minuten.

  • AJAX-Timeout für Abfragen vom Web-Client zum Web-Server in Sekunden

    Geben Sie das Zeitüberschreitungs-Intervall für Anfragen vom Web-Client zum Webserver in Sekunden an.

  • Technische Benutzer

    Hier sind alle Benutzer aufgelistet, für die Vertrautes Login aktiviert ist. Wählen Sie einen oder mehrere Benutzer aus der Liste Verfügbare Benutzer aus, um sie als technische Benutzer verfügbar zu machen. Diese Benutzer werden im Feld Ausgewählte Benutzer angezeigt.

    Technische Benutzer werden von verschiedenen Komponenten von ADOIT benötigt, beispielweise für die Synchronisation von Objekten mit anderen BOC Management Office-Produkten.

Web-Module

Sie können Web-Module (Plug-ins) an System-Rollen zuweisen, um Berechtigungen auf Funktionen im Web-Client zu vergeben. So können Sie unterschiedliche Szenarien für verschiedene Benutzergruppen oder Benutzer definieren.

  • Fachliche Module

    Dieses Tab enthält alle Web-Module, die Benutzern zugewiesen werden können. Sie können Web-Module entweder für alle System-Rollen oder bestimmte System-Rollen aktivieren.

Hinweis

Eine Schritt-für-Schritt-Anleitung für das Zuweisen von Web-Modulen finden Sie im Abschnitt Web-Module an System-Rollen zuweisen.

Info

Der ADOIT Applikations-Server muss neu gestartet werden, wenn diese Einstellungen verändert werden. Ansonsten werden die Änderungen nicht wirksam.

Administrator für gespeicherte Suchabfragen zuweisen

Als ADOIT-Administrator können Sie vertrauenswürdigen Benutzern in Ihrer Organisation die Erlaubnis erteilen, die Freigabe von gespeicherten Suchabfragen von anderen Benutzern aufzuheben. Weisen Sie folgendes Web-Modul den passenden System-Rollen zu:

  • Gespeicherte Suchabfragen (erweiterte Optionen)