Get Access to the SAP Document AI Workspace

After completing the prerequisite tutorial Use Free Tier to Create a Service Instance for SAP Document AI, you can start with the steps to subscribe to the SAP Document AI workspace.

For now, the SAP Document AI workspace is only available for enterprise accounts with the plans embedded edition (embedded_edition) and premium edition (premium_edition). Make sure to choose one of these 2 plans when creating your service instance (instead of the free plan). For more information, see Service Plans.

1. Open the SAP BTP cockpit.

2. Click the tile to access your subaccount.

To use the SAP Document AI workspace, you need to make sure that your account is properly configured.

The SAP Document AI workspace requires a tenant for Cloud Identity Services. For more information, see Get Your Tenant.

1. On the navigation side bar, click Entitlements to see a list of all eligible services. You’re entitled to use every service in this list according to the assigned service plan.

2. Search for Cloud Identity Services. If you find it in the list, you’re entitled to use it. Now you can set this step to Done and proceed with Step 3.

   

ONLY if you DO NOT find Cloud Identity Services in your list, proceed as follows:

1. Click Edit.

![DOX-UI](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/cp-aibus-doc-ai-workspace/edit.png)

2. Click Add Service Plans.

![DOX-UI](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/cp-aibus-doc-ai-workspace/add-service-plans.png)

3. Search for Cloud Identity Services. Choose the default (Application) plan (or the additional-tenant (Application) plan). Click Add 1 Service Plan.

![DOX-UI](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/cp-aibus-doc-ai-workspace/add-plan.png)

4. Click Save to save your entitlement changes.

![DOX-UI](https://raw.githubusercontent.com/sap-tutorials/Tutorials/master/tutorials/cp-aibus-doc-ai-workspace/save-entitlements.png)

You're now entitled to create a tenant for Cloud Identity Services.

The Service Marketplace is where you find all the services and applications available on SAP BTP.

1. On the navigation side bar, click Service Marketplace. Search for Cloud Identity Services and click the tile.

   

2. In the top-right corner, click Create.

   

3. In the dialog, click Create.

   

   The subscription is going to be created now. Click on View Subscription to go to the list of your existing subscriptions.

   

1. Go to your inbox and open the account activation email (Activation Information for SAP Cloud Identity Services). Click the activation link.

   

2. Enter a password and click Continue.

   

3. You’re informed that your account is successfully activated. Click Continue.

   

   This opens the administration console of SAP Cloud Identity Services:

   

   Leave the administration console of SAP Cloud Identity Services open. We’ll go back here in step 7.

1. Back on the SAP BTP cockpit, under Security, click Trust Configuration and then in the top-right corner, click Establish Trust.

   

2. Choose your tenant for Cloud Identity Services and click Next 3 times.

   

3. Click Finish.

   

   Your tenant for Cloud Identity Services is added to the list:

   

Before subscribing to the SAP Document AI workspace, make sure that a service instance has alread been created for SAP Document AI using either the embedded edition (embedded_edition) plan or the premium edition (premium_edition) plan.

1. On the navigation side bar, click Service Marketplace. Search for SAP Document AI and click the tile.

   

2. Click Create.

   

3. In the dialog, choose the default plan and click Create.

   

   The subscription is going to be created now. Click on View Subscription to go to the list of your existing subscriptions.

   

SAP Document AI provides default policies that you can assign to users. These policies determine which actions a user can carry out on the SAP Document AI workspace. For more information, see Authorization Policies.

1. Go back to the administration console of SAP Cloud Identity Services that you left open in step 4.

2. Under Applications & Resources, choose the Applications tile.

   

3. Choose the bundled application SAP Document AI.

   

4. Choose the Authorization Policies tab and choose an authorization policy that you want to assign – for example, Admin.

   

   The administration console opens the Assignments pane.

5. Choose Add.

   

6. Select the users that you want to add to the authorization policy and choose Add.

   

   You have added the selected users to an authorization policy. These users are authorized to access and use the resources with the rules and restrictions defined in the authorization policy.

1. Back on the SAP BTP cockpit, under Services, click Instances and Subscriptions. Choose the three dots at the right end of the row with the SAP Document AI application and select Go to Application from the dropdown.

   

   The logon screen appears.

2. Enter your Identity Authentication service Email or User Name and Password to log on.

   A Permission Denied dialog is displayed. Or the SAP Document AI basic UI appears (in case you’ve already used the same subaccount to access the SAP Document AI basic UI as described in Use Free Tier to Subscribe to SAP Document AI Basic UI). To access the SAP Document AI workspace, do the following:

   • On the Permission Denied dialog, do the following: Choose the link (here) in “Or choose here if you already have access to the SAP Document AI workspace.”

   

   • From the SAP Document AI basic UI, toggle the Workspace switch at the top of the screen from OFF to ON. Alternatively, edit the URL of the SAP Document AI basic UI, replacing /ui and everything that follows it with /workspace.

   

   The SAP Document AI workspace appears.

   

   You have successfully subscribed to the SAP Document AI workspace.