Skip to main content

Welcome to ADOIT!​

Thank you for your interest in ADOIT! This Quick Start Guide will help you quickly explore the key features. It will guide you and your colleagues through the first steps, so you can test ADOIT optimally and unlock the full potential of our software!

note

You don’t need to follow the steps in the exact order described here. Simply review them - you might decide to prioritize or skip certain steps.

Login​

You have received an email with a credentials-sheet. This sheet contains your login details and a link to the test account.

  1. Click on the link in the sheet to access the test account.
  2. Click on the gear icon Start Event icon located above the username to log into the administration. Use the credentials from the credentials-sheet.
  3. Change your password upon your first login and make sure to remember it!

ADOIT Administration

Get to know the ADOIT administration and settings.​

To help you quickly navigate the ADOIT administration and configure the right setup for your team, we have compiled the most important information for you. Below, you will find a list of videos and links to helpful resources.

ADOIT Administration

Important Settings:

  • Users: Management of users and user groups
  • Permissions: Assignment and management of permissions
  • System Roles: Management of system roles
  • Repositories: Management of repositories, import/export of migration packages and models
  • Properties: Customization of fields for ArchiMate elements
  • Settings: Various options, mostly preset

Helpful Videos to Get Started​

To make it easier for you to get started and test, we have selected a video from our video tutorial series with useful first steps in administration:

Start Event icon Get an overview of the key components of administration.

Our playlist offers more exciting videos – featuring the key functions and clever tips for ADOIT!

Our Admin-Help​

Prefer reading over watching? In our Admin-Help, you’ll find all the settings described in detail.

Import examples for your colleagues​

By default, our premium test accounts come with a banking example model, which includes a variety of models and analyses. Additionally, we have prepared 5 industry-specific example models that are smaller and more streamlined, making them ideal for getting started. These consist of:

  • 3 models
  • 1 analysis model
  • 1 workspace

Simply import the file, and your colleagues can explore the models at their own pace.

Download the desired example model directly:

Structure of the example models:

  • Capability Map
  • Operating Model
  • Application Landscape
  • An analysis with a portfolio view of the application components

Additionally, you will find a pre-configured workspace in the Workspaces scenario.

Sample model

Importing the example models:

  • Download one of the example models above.
  • Go to Repositories in the administration and click on More Options in the top right corner. Then click Import Repository.
  • It is important to import it as an INDEPENDENT Repository (select the first option in the import settings).
  • After importing the example model, you will need to assign access rights to yourself or the responsible colleagues who should see the example. You can do this under Users in the administration. Select your user and those of your colleagues who should be able to see the example and click Edit. Under Repository, you now need to select the corresponding repository. For more information, please refer to our Online-Help.
  • Log out of the administration and log into ADOIT to check if the import was successful. When logging in, select the new repository. You should now see the following in the explorer:

explorer

Great, the first steps are done! Now, let’s move on with your colleagues​

explorer

Normally, ADOIT accounts are managed via SAML. However, in the test account, it works differently. To allow your colleagues to test ADOIT freely, we have already prepared user accounts for them. You can find these accounts in the Administration section under "Users" or on the credentials sheet. There are just a few details you need to adjust:

  1. Go to Administration > Users > select a user > edit (⋮) > General
  2. Name: Enter the names of your testers to stay organized.
  3. Email: Make sure an email address is provided for each user. This is required for password resets!
  4. Finally, distribute the login details from the credentials sheet to your testers and share the ADOIT URL with them via email.

Difference between User and Reader: In the test account, you will most likely use the User role to fully test ADOIT’s features. However, in general, we differentiate between:

  • Reader: Users assigned to this group have read-only access.
  • User: Users assigned to this group have full write access.
  • Administrator: Users in this group have full write access and additional access to the administration.

Great, your colleagues are now on board! Show them the key tips and take the time to test all the features together!​

explorer

Import existing data via the Excel Interface​

Do you already have architecture information in Excel format? Use our Excel templates to import the data and test our features even more effectively:

explorer

You can find our template directly in the Object Explorer:

  1. Select the folder where you want to import the data.
  2. Open the context menu (the three dots in the top right corner of the Explorer).
  3. Choose "Import/Export" → "Import objects from Excel...".
  4. Download the template using the download icon.
  5. Fill in the template with your architecture information and upload it again.

For more information, please refer to our Online-Help!

note

Of course, you can also customize the template to fit your needs. You can find more information about this here.

Reduce modeling complexity with metamodel profiles​

In ArchiMate, there are many elements and relationships. Initially, your team will only use a few of them. Therefore, we offer so-called metamodel profiles. These act as a filter for elements and relationships. All our predefined views, analyses, examples, and templates are based on this filter.

explorer

note

Switch the metamodel profile via Setup Start Event icon in the toolbar. Please note that the selected profile will also be activated for your colleagues. More information about metamodel profiles can be found here.

In most cases, the profile "ADOIT for Fans of Lean Architecture" is used. In this profile, we have reduced the possible relationships between two classes to just one relationship. We recommend using this profile as a starting point. You can expand or further restrict it later based on your specific use case. More information, can be found here.

Activate ADOIT Forms​

With ADOIT Forms, you can simplify data maintenance. It is a user-friendly, form-based interface that allows for easy data entry and updates – even for users who are less familiar with ADOIT or enterprise architecture. There are 3 use cases in ADOIT Forms:

  • Create forms
  • Distribute forms
  • Fill out forms

For more information about ADOIT Forms, please refer to our Online-Help.

explorer

How to activate ADOIT Forms:

  1. ADOIT Forms runs in SaaS mode, so no additional installation is required.
  2. To activate Forms, log in to the administration.
  3. Navigate to “Settings” and click on “ADOIT Forms” in the list on the left.
  4. You can now activate Forms with the click of a button. All necessary settings for OAuth, REST, and CORS will be automatically configured in the background.
note

You can find more information on installing ADOIT Forms here. To learn which rights or licenses your users need, you can read more here.

The most important steps are done!​

Great job! You've successfully completed the first steps in ADOIT! Now you and your colleagues can continue exploring and testing the software at your own pace. To make the most out of your test account, we've compiled a list of useful features and resources here:

note

For any further questions or concerns, to your BOC contact person!