Zum Hauptinhalt springen

Installation Manual

Overview​

This section describes

  • the installation of the ADOIT Enterprise Architect for SharePoint app for Microsoft SharePoint Online

  • the set-up of the connection between the SharePoint instance and one or more ADOIT instances

Where to get ADOIT Enterprise Architect for SharePoint​

The ADOIT Enterprise Architect for SharePoint app can be found on Microsoft AppSource.

Configuration of ADOIT​

This chapter describes the needed configuration to allow access to the ADOIT instances by ADOIT Enterprise Architect for SharePoint.

Hinweis

In order to use ADOIT Enterprise Architect for SharePoint with your ADOIT instances, the Standard RESTful services module must be licensed and enabled for each of them!

REST API with OAuth 2.0​

Detailed documentation can be found here:

Please note that some specific settings are required:

  1. Administration Toolkit REST scenarios required (more details)):

  • Repository read APIs

  • Repository search APIs

  • Users read APIs

  • Metamodel read APIs

  1. OAuth 2.0 client configuration (more details):

ADOIT CORS policy​

All ADOIT REST API requests are sent directly from the client web browser. To allow such requests, the following settings of the adoxx_web.properties server file must be set to true:

  • for all requests: security.rest.allow.cors

  • for OAuth 2.0 authentication process requests: security.allow.cors

Hinweis

If you are using ADOIT as SaaS, you can contact hotline@boc-group.com to configure the CORS policy.

Installation of the ADOIT Enterprise Architect for SharePoint app in SharePoint Online​

This chapter describes the steps to install the ADOIT Enterprise Architect for SharePoint app in Microsoft SharePoint Online. You can either

  1. As a user: Search for the ADOIT Enterprise Architect for SharePoint app on Microsoft AppSource and click Get it now. You will get redirected to the SharePoint Store where you have to Request the app. Your SharePoint administrator can continue then with the needed steps to install the app.
  2. As a SharePoint admin: Open your SharePoint Admin Center and navigate to the SharePoint Store. Search for the ADOIT Enterprise Architect for SharePoint app and Add to Apps site. You can add the app to all sites then and optionally also to Microsoft Teams.

Set-up the connection from your SharePoint instance to your ADOIT instance(s)​

After the app has been obtained, please directly contact cloud-integration-boc-ag@boc-group.com to provide the following inputs for the Customer Map Service:

  • URL of your SharePoint instance

  • URL(s) of your ADOIT instance(s) that should be accessible by ADOIT Enterprise Architect for SharePoint