Enabling Multitenancy for the Previously Created Application

Enable multitenancy in your application. Users can do this from two locations: Project Overview or Guide Center.

1. From the Project Overview, select Project Actions (…) to open the context menu.

2. Choose Enable Multitenancy.

   

3. From the Guide Center, choose Enable Multitenancy in your Application, under Enable Multitenancy, choose Enable Multitenancy.

   

4. Substeps a, b, and c will lead to this page.

5. Choose Enable Multitenancy.

   

6. Choose Enable.

   

7. SAP Business Application Studio will show a message like below in the bottom right:

   

Enable External Services in a Multitenant Application. By default, multitenant applications don't expose a destination or other services to subscribers. However, you can follow the steps provided below to add the destination services to the SAP BTP SaaS Provisioning Service dependencies to allow subscribers to use them.

1. Open a terminal in SAP Business Application Studio.

   

2. Run the given command in the mtx/sidecar folder:

   npm install @sap/xsenv

3. Open the Explorer and navigate to the mtx/sidecar folder. Open the server.js file.

   If the Explorer isn't visible, you can open it using the steps shown in the following snapshot:

4. Add the following code to server.js:

   Code Snippet

   Copy codeSwitch to dark mode

   12345678910111213141516171819
   const xsenv = require('@sap/xsenv');
   cds.on('served', async () => {
     const { 'cds.xt.SaasProvisioningService':provisioning } = cds.services
       await provisioning.prepend(() => {
         provisioning.on('dependencies', async (req, next) => {
           await next()
           const services = xsenv.getServices({
             dest: { label: 'destination' }
           })
           let dependencies = [
             {
               xsappname: services.dest.xsappname
             }
           ]
           return dependencies
         })
       })
   })
   

5. The server.js will look as shown here:

   

6. Users can also find the steps described above in the Guide Center of SAP Business Application Studio under the section Enable Multitenancy in your Application.

   

Deploy to Cloud Foundry.

Subscribe to your multitenant application.

1. Navigate to your SAP BTP subaccount and from the navigation pane, choose Instances and Subscriptions.

2. In the Search bar, search for the destination instance of your multitenant application (<project name>-destination) and choose it to open the details pane.

   

3. Choose Manage Instance.

   

4. From the navigation pane, choose Destinations.

5. You can see the destination configured for your multitenant application. Choose Edit. In the User and Password fields, fill in the username and password for a technical user.

   

   Note

   A technical user refers to a user with relevant permissions for the provider Cloud Foundry account.

6. Clear the Client Secret field.

7. Choose Save.

Subscribe to the multitenant application.

1. Go to Service Marketplace.

2. Find out the deployed multitenant application.

3. Choose Create.

   

4. Leave the value as default in the next step.

5. Choose Create.

   

Open the application.

1. Navigate to your SAP BTP subaccount and from the navigation pane, choose Instances and Subscriptions.

2. In the Search bar, search for the application and choose it to open the details pane.

3. Choose Go to Application.

   

4. Result:

   

Test the application.

1. Choose the Risk tile in the application home page.

2. Choose the Go button, and check the current data.

3. Choose Create to go to the create page.

   

4. Enter data in the create page.

5. Choose the Action button in supplier_BusinessPartner to add a business partner from the external service.

6. Select a value from the popup.

7. Choose Create in the create page.

   

8. Result:

   

9. The new data has been created.

   

10. Go back to the Risks home page.

    

11. Check the data.