Willkommen bei ADOIT!
Vielen Dank, dass ihr euch für ADOIT entschieden habt! Um dir den Einstieg und die erste Konfiguration so einfach wie möglich zu gestalten, haben wir diesen kleinen Quick Start Guide erstellt. Er wird dich durch die wichtigsten ersten Schritte begleiten, damit du gleich mit den ersten Kolleg:innen in ADOIT losstarten kannst!
Du musst die Schritte nicht 1:1 in der hier beschriebenen Reihenfolge durcharbeiten. Schau dir einfach die Schritte an - vielleicht möchtest du etwas vorziehen oder etwas weglassen.
Die erste Email
Du hast von uns eine E-Mail mit deinen Login-Informationen zum sicheren Download als PDF erhalten. Darin findest du ebenfalls deinen BOC-Ansprechpartner, der dich bei jedem Schritt unterstützen kann. Ganz egal, ob zu Schritten in diesem Quick-Start-Guide oder späteren Fragen!
Login & erste Administrations-Tätigkeiten
Für das erste Login klicke auf die Zahnräder rechts über dem Benutzernamen, um dich in der Administration anzumelden. Verwende bitte die Login-Daten, die du im PDF der ersten E-Mail erhalten hast. Nach dem Login wirst du aufgefordert, das Passwort zu ändern. Das neue Passwort musst du dir unbedingt merken! Nun siehst du die ADOIT Administration.
Nur noch wenige Schritte und du kannst loslegen! Zu Beginn musst du eine initiale Ablagestruktur definieren, ein paar Benutzergruppen anlegen und die Berechtigungen erteilen. Keine Sorge, wir haben das für dich schon vorbereitet! – Das so genannte Migrationspaket. Du musst nur eine Datei importieren und hast die wichtigsten Einstellungen schon vorinstalliert. Du kannst das Quick Start Migrationspaket hier herunterladen.
Importieren des Quick Start Migrationspakets:
Gehe in der Administration zu Repositorys und klicke rechts oben auf „Weitere Optionen“, dann auf „Migrationspaket importieren“. Nun kannst du das heruntergeladene Quick Start Migrationspaket per Drag&Drop oder über die Dateiauswahl hochladen. Füge das Migrationspaket direkt in das aktive Standard-Repository ein:
Mehr Informationen dazu findest du in unserer [Online-Hilfe](Repositorys | ADOIT). Außerdem kann du dich mit unserer Terminologie zu Repositorys und Migrationspaketen vertraut machen. Dies kannst du in unserer Online-Hilfe nachlesen: [Was sind Repositorys?](Repositorys | ADOIT) , [Was ist ein Migrationspaket?](Repositorys | ADOIT)
Wenn du erfolgreich warst, hast du folgendes erreicht:
1) Eine Ordner-Struktur für Objekte 2) Eine Ordner-Struktur für Modelle 3) Initiale Benutzergruppen 4) Initiale Berechtigungseinstellungen
Strukturen, Berechtigungen etc. kannst du natürlich später noch ändern. Darum kümmern wir uns weiter unten im Guide. Du wirst auch einen Dummy-User „arch“ in deinen Benutzergruppen finden. Dieser ist für ein paar Beispielmodelle wichtig, die du später importieren kannst. Du kannst ihn erstmal ignorieren
Erstelle einen Super-User für dich
Der Benutzer, den du bisher verwendet hast, entspricht wahrscheinlich nicht euren Richtlinien. Später sprechen wir noch darüber, wie du Single-Sign-On und SAML einrichtest.
Bereite dich darauf schonmal vor, indem du dir einen eigenen Benutzer anlegst, der den Richtlinien deines Unternehmens genügt.
Verwende idealerweise den im Unternehmen üblichen Standard als Benutzernamen, wie deinen Windows-Benutzernamen oder deine E-Mail-Adresse. Dies erleichtert die spätere Integration in den Directory Service. Falls du unsicher bist, wende dich am besten an den IT-ServiceDesk.
So gehst du vor:
Logge dich in der Administration ein
Klicke auf Benutzer
Erstelle einen neuen Benutzer.
„Allgemein“: Definiere Benutzername, Passwort …usw
„Gruppen und Rollen“: Wähle die Benutzergruppe „Administrator
„Repository“: Wähle das „Standard-Repository“.
Mehr Informationen, wie du neue Benutzer erstellen kannst und was die einzelnen Einstellungen bedeuten, findest du [hier](Benutzer | ADOIT).
Falls du möchtest, dass dein BOC-Ansprechpartner ebenfalls Zugang zu deinem ADOIT hat, um dich bei möglichen Problemen oder Fragen besser unterstützen zu können, haben wir für deinen Kundenbetreuer bereits einen Benutzer angelegt. Du musst diesen in der Administration noch freischalten. Dies machst du über die Einstellung eines Benutzers. [In unserer Online-Hilfe erfährst du, wie man Benutzer bearbeitet.](Benutzer | ADOIT)
Schau dich mal um
Nun logge dich aus der Administration aus, und in ADOIT mit deinem neu erstellten Super-User ein.
Du bist nun im Szenario Gestalten & Dokumentieren und kannst dich ein wenig umschauen. Klicke im Hauptmenü auf „Finden“.
In ADOIT gibt es zwei wichtige Kataloge, den Objektkatalog und den Modellkatalog. Im Objektkatalog werden Elemente wie Geschäftsprozesse und Anwendungskomponenten in einer Ordnerstruktur verwaltet. Diagramme - sogenannte Modelle - werden im Modellkatalog organisiert.
Wir haben bereits eine einfache Ordnerstruktur für Objekte und Modelle vordefiniert. Wirf einen Blick auf die vordefinierte Struktur:
Die Ordner haben auch mit der Berechtigungsstruktur zu tun. Aber damit befassen wir uns später.
Mehr Informationen zum Objekt- und Modell-Explorer findest du in unserer [Online-Hilfe](Mit dem Explorer arbeiten | ADOIT).
Du kannst dies natürlich später ändern und verfeinern. Dies funktioniert besonders gut mit dem Modell- und Objektorganisator. Mehr Infos dazu findest du in unserer [Online-Hilfe](Mit dem Explorer arbeiten | ADOIT). Wirf schonmal einen kurzen Blick darauf. Du musst jetzt aber noch nichts ändern.
Möchtest du ein kleines Beispiel anschauen?
Wir haben für dich ein paar Beispiele in 5 verschiedenen Branchen vorbereitet – die sogenannten ADOIT Beispielmodelle. Sie bestehen aus jeweils 3 Modellen, einem Analysemodell und einem Workspace. Du musst nur eine Datei importieren und kannst es dir in Ruhe anschauen. Klicke einfach auf einen der Links unten, um das Beispielmodell direkt herunterzuladen.
Folgende Sample Models stehen dir als Download zur Verfügung:
- Sample Model eines Flughafens
- Sample Model einer Bank
- Sample Model einer Versicherung
- Sample Model eines Retailers
- Sample Model eines Spielzeugherstellers
Aufbau der Beispiel-Modelle:
Capability Map
Operating Model
Applikations-Landkarte
Eine Analyse mit Portfolio-Ansicht der Applikationskomponenten
Zusätzlich findest du im Szenario „Arbeitsbereiche“ noch einen vorkonfigurierten Arbeitsbereich
Importieren der Beispiel-Modelle:
Lade eines der Beispiel-Modelle oben herunter
Gehe in der Administration zu Repositorys und klicke rechts oben auf „Weitere Optionen“. Dann auf „Repository importieren“.
Wichtig ist, dass du es als EIGENSTÄNDIGES Repository importierst. (Ersten Punkt in Import-Einstellungen auswählen!)
Wichtig ist ebenfalls, dass dein Benutzer Rechte auf das neue Repository bekommt. Dies musst du wieder unter „Benutzer“ in der Administration einstellen. Wähle deinen Super-User aus und klicke auf bearbeiten. Unter „Repository“ musst du nun das entsprechende Repository auswählen. Mehr Infos dazu findest du in unserer [Online-Hilfe](Benutzer | ADOIT)
Nachdem du dein Beispiel-Modell importiert hast und deinem Benutzer Zugriffsrechte gegeben hast, logge dich aus der Administration aus und in ADOIT ein. Wähle das von dir heruntergeladene Beispiel-Modell aus. Du solltest nun folgendes im Explorer sehen:
Du hast vollen Schreibzugriff auf das Beispiel-Modell. Du kannst dieses Repository zum Testen und Probieren verwenden. Das initiale Repositoy „Standard-Respository“ ist deine Produktivumgebung.
Super, alles ist für dich vorbereitet!
Als nächstes kümmern wir uns um deine Kolleg:innen.
Bevor wir neue Benutzer anlegen, lass uns zuerst einen kleinen Blick auf die vorhandenen Benutzergruppen werfen. Diese findest du wieder in der Administration unter Benutzer.
Über so genannte Benutzergruppen kannst du die Berechtigungen deiner Benutzer steuern. Die folgenden Benutzergruppen haben wir bereits bei der Installation für dich vorbereitet:
Reader: Benutzer, die dieser Gruppe zugewiesen sind, haben nur Lesezugriff.
User: Benutzer, die dieser Gruppe zugewiesen sind, haben vollen Schreibzugriff.
Administrator: Benutzer in dieser Gruppe haben vollen Schreibzugriff und zusätzlich Zugriff auf die Administration.
Die Benutzergruppen „Standardgruppe“ und „pp123456“ benötigen wir erstmal nicht.
Lege für die Mitglieder deines Kernteams Benutzer an
Normalerweise wirst du deine ADOIT-Konten über SAML verwalten. Dies dauert in der Regel etwas länger, da einige Abklärungen getroffen werden müssen.
Wir empfehlen daher, deine ersten Benutzer manuell anzulegen. Damit du das nicht einzeln machen musst, haben wir eine Excel Vorlage vorbereitet, die du dir herunterladen kannst und alle deine Benutzer eintragen kannst. Danach musst du sie nur noch importieren und schon sind die Benutzerkonten für deine Kolleg:innen in ADOIT erstellt!
Später werden diese Schritte durch eine automatisierte SAML-Verbindung ersetzt.
Melde dich dazu in der Administration an, navigiere zu „Benutzer“, dann rechts oben auf „Weitere Optionen“ und „Benutzer aus Excel importieren“. Lade dir die Vorlage „BenutzerImportieren.xlsx“ herunter.
Trage alle Benutzer ein, die in der Startphase mit ADOIT arbeiten sollen. Alle weiteren Benutzer werden künftig automatisch über SAML angelegt.
Den Kernteam-Mitglieder:innen gibst du typischerweise Schreibrechte. Das kannst du später natürlich einschränken.
Verwende die im Unternehmen üblichen Benutzernamen, häufig die E-Mail-Adresse oder den Windows-Login-Namen. Dies ist wichtig. Wenn SAML später eingerichtet wird, müssen die Benutzernamen mit denen von SAML übereinstimmen, sonst sind zusätzliche Migrationsschritte erforderlich.
Nun musst du die Datei mit den eingetragenen Usern wieder hochladen. Verwende dafür folgende Importoptionen:
Checkbox „Vertrautes Login“ auswählen. (Warum und wofür das wichtig ist kannst du [hier](Bedienkonzept | ADOIT) nachlesen)
Bei Benutzergruppen: User (Damit hat dein Kernteam Schreibrechte bei Modellen und Objekten)
Bei „Repositorys und Objektgruppen“: Standard-Repository und Objekte
Klicke dann auf „Datei hochladen“
Weise deinen Benutzern Szenarien zu
In ADOIT gibt es Named-Use-Szenario-Lizenzen. Named-Use-Szenario-Lizenzen definieren die Benutzer, die ein Szenario verwenden können. Szenarien sind die Hauptkomponenten von ADOIT. Es gibt:
Gestalten & Dokumentieren
Lesen & Entdecken
Arbeitsbereiche
So weist du Benutzern Szenarien zu:
Gehe in die Administration > Benutzer > wähle einen Benutzer aus > bearbeiten (3 Punkte) > Named Use-Benutzer
Wähle das Szenario im Feld „Szenarien auswählen“ und klicke dann auf „Auswählen“
Die Benutzer sind nun konfiguriert. Verteile nun die ADOIT-URL per E-Mail an deine Benutzer:innen und informiere sie über ihren Benutzernamen. Die Benutzer:innen können ihr Passwort über "Passwort vergessen" zurücksetzen.
Super, deine Kolleg:innen sind nun auch an Board! Zeige ihnen die wichtigesten Tricks.
Mit den folgenden Schritten kannst du dir Zeit sparen. Mach weiter! Du bist fast am Ziel!
Importieren existierender Daten via Excel Interface
Verfügst du bereits über Architekturinformationen? Im Excel-Format?
Nutze unsere Excel-Vorlagen, um die Informationen in ADOIT zu importieren.
Du findest unsere Vorlage direkt im Objekt-Explorer: Wähle den Ordner, in den du die Daten importieren möchtest, durch einmaliges klicken aus, öffne dann das Kontextmenü rechts oben im Explorer (die 3 Punkte) und wähle „Import/Export“ -> „Objekten aus Excel importieren…“ aus. Lade die Vorlage dann über das Download-Icon herunter. Nun kannst du sie mit deinen vorhandenen Architekturinformationen befüllen und danach wieder hochladen.
[Mehr Infos findest du in unserer Online-Hilfe!](Einstellungen | ADOIT)
Natürlich kannst du die Vorlage auch individuell anpassen. Mehr Informationen dazu findest du [hier](Einstellungen | ADOIT).
Reduziere die Modellierungs-Komplexität mit Meta-Model-Profilen
In ArchiMate gibt es sehr viele Elemente und Beziehungen. Zu Beginn wird dein Team nur wenige davon nutzen. Wir bieten daher sogenannte Metamodell-Profile an. Sie dienen wie eine Art Filter für Elemente und Beziehungen. Alle unsere vordefinierten Ansichten, Analysen, Beispiele und Vorlagen basieren auf diesem Filter
Mehr Informationen zu Metamodell-Profilen findest du [hier](Metamodell Profil Konfigurator | ADOIT).
Zumeist wird das Profil „ADOIT für Fans einer Lean Architecture“ genutzt. In diesem haben wir die Beziehungen, die man zwischen zwei Klassen ziehen können, so weit wie möglich auf genau eine Beziehung reduziert. Wir empfehlen, dieses Profil als Ausgangspunkt zu verwenden. Du kannst es später je nach deinem individuellen Anwendungsfall erweitern oder weiter einschränken. Infos dazu findest du [hier](Metamodell Profil Konfigurator | ADOIT).
Bereite die SAML-Integration vor
Um Single-Sign-On (SSO) auf deinem BOC SaaS-Konto (SP) und deinem SAML Identity Provider (IdP) einzurichten, benötigst du einige Vorarbeiten. Bitte bereite das Folgende vor und sende uns die Details bis zu 24 Stunden vor dem ersten geplanten Kundenmeeting.
Von deinem SSO-Technischen-Team benötigen wir folgendes:
Die folgenden Claims sollten in deinem SAML Identity Provider (IdP) konfiguriert werden:
- Benutzername=E-Mail-Adresse
- Vorname
- Nachname
- E-Mail-Adresse
- Gruppe
Nach der Konfiguration des Identity Provider (IdP) musst du dir Gedanken über die zu konfigurierenden AD-Gruppen machen : In ADOIT haben wir standardmäßig folgende Benutzergruppe:
Administrators
Readers
Users
Bitte sprich mit eurem Verantwortlichen über mögliche AD-Gruppen. Im Laufe der weiteren Konfiguration wirst du wahrscheinlich noch ein paar hinzufügen. Für mehr Informationen dazu frage bitte deinen BOC-Ansprechpartne
Wir benötigen ebenfalls die erforderlichen Informationen vom Kunden-IdP:
- IdP URL
- Token signing certificate
- Die „metadata.xml“ Datei bzw die Metadata URL
- Die Namen der konfigurierten claim-attribute
Wenn dein IdP-Endpunkt nicht über das Internet erreichbar ist, benötigen wir jemandem auf deiner Seite zum Testen. Bitte teile uns die Kontaktinformationen einer möglichen Test-Assistenz mit.
Nachdem du alle wichtigen Informationen gesammelt hast, würden wir dich bitten, deinen BOC Ansprechpartner zu kontaktieren. Er stellt dir einen sicheren File-Exchange-Service zur Verfügung, über den du alle erforderlichen Dateien und Informationen hochladen kannst. Hierfür benötigen wir zusätzlich eine Telefonnummer von eurer Seite. Bitte teile diese deinem BOC-Ansprechpartner ebenfalls mit.
Nachdem wir die geforderten Daten erhalten haben, konfigurieren wir SAML. Zunächst wird sie als sekundäre Authentifizierungsmethode eingerichtet, um Auswirkungen auf die produktive Nutzung deiner Instanz zu vermeiden. Nach erfolgreichen Tests während der Sitzung wird SAML als Standard-Authentifizierungsmethode aktiviert. Falls du weitere Fragen zu diesem Thema hast, kannst du dich jederzeit an deinen BOC-Ansprechpartner wenden!
Aktiviere ADOIT Forms
ADOIT Forms ist eine neue Funktion für ADOIT, die den Datenverwaltungsprozess vereinfachen soll. Im Gegensatz zu einer traditionellen Modellierungsschnittstelle, die ein tieferes Verständnis von EA-Konzepten und ArchiMate erfordert, bietet ADOIT Forms eine benutzerfreundliche, formularbasierte Schnittstelle. Diese ermöglicht es Benutzer:innen, die mit ADOIT oder der Unternehmensarchitektur weniger vertraut sind, Daten einfach einzugeben und zu aktualisieren, ohne dass eine EA-Schulung erforderlich ist.
ADOIT Forms aktivieren:
ADOIT Forms läuft im SaaS-Modus. Es ist daher keine weitere Installation erforderlich.
Um Forms zu aktivieren, logge dich in der Administration ein.
Navigiere zu „Einstellungen“ und klicke links in der Liste auf „ADOIT Forms“.
Du kannst Forms nun per Knopfdruck aktivieren. Alle benötigten Einstellungen für OAuth, REST und CORS werden automatisch im Hintergrund konfiguriert.
Mehr Informationen zur Installation von ADOIT Forms findest [hier](Installation | ADOIT). Welche Rechte oder Lizenzen deine Benutzer:innen brauchen kannst du [hier](Hardware and Software Requirements | ADOIT) nachlesen.
Die wichtigsten Schritte sind erledigt!
Super, die wichtigsten ersten Schritte hast du erfolgreich erledigt. Die weiteren Schritte kannst du nun mit deinem BOC-Ansprechpartner besprechen. Hier ist eine kleine Liste von nützlichen Features und Einstellungen, die wir am Anfang empfehlen würden. Frage dazu einfach deinen BOC-Ansprechpartner!
Verbinden mit ADONIS über ADO Connect:
[ADO Connect in unserem Marketplace](ADOIT Connect for Business Process Management - knowledge.boc-group.com)
[Mehr Infos zu ADO Connect](Synchronisation mit ADONIS - Standard-Mapping | ADOIT)
Unseren EA Marketplace zur Erweiterung deines ADOIT Portfolios :
[EA Marketplace](The ADOIT Marketplace | Enterprise Architecture by BOC Group)
[Kostenlose E-Learnings für dich und deine Kolleg:innen](The ADOIT Marketplace | Enterprise Architecture by BOC Group)
FAQ Bereich & Support Anfragen
[Help-Center](Help Center der BOC-Gruppe)
[Eine Anfrage einreichen](Anfrage einreichen – Help Center der BOC-Gruppe)
Lasse dich inspirieren: ADOIT Blog & EA Ressources
Nun, da alles eingerichtet ist, fragst du dich sicher, was du noch tun kannst. Hier findest du weitere Anregungen in unseren Blogs und in unseren EA Ressources weitere kostenlose Whitepaper, Webinare, Poster, etc zum Vertiefen von Wissen.
[ADOIT EA Blogs](EA Blog - www.boc-group.com)
[EA Ressources](EA Resources - www.boc-group.com)