Architecturing Good Practice

Objective

After completing this lesson, you will be able to explain how subaccounts, entitlements, roles and collections, ID provider work together

Architecture Good Practice

List of tasks: adding quota to a subaccount, subscribing to SAP Order Management, enabling UI access, configuring identity providers, and enabling API access.

To be able to create an SAP Order Management for sourcing and availability service instance, make sure to Enable Cloud Foundry on subaccount level. For more information, see Getting Started with an Enterprise Account in the Cloud Foundry Environment.

The Provider of the selected subaccount needs to be Microsoft Azure and the Region needs to be Europe (Netherlands).

For more information on how to create a subaccount, see Create a Subaccount.

Quota

A user interface showing SAP service entitlements for order management, including available plans and service details.

Steps

  1. In the SAP Business Technology Platform cockpit, navigate to your Global Account.

  2. Navigate to Entitlements  Entity Assignments.

  3. Search for your subaccount and click Select to see the list of configured entitlements.

    Note

    The Provider of the selected subaccount needs to be Microsoft Azure and the Region needs to be Europe (Netherlands). For more information on how to create a subaccount, see Create a Subaccount.
  4. Choose Configure Entitlements and Add Service Plans.

  5. Search for SAP Order Management solution for sourcing and availability and select the SAP Order Management for Sourcing and Availability entitlement.

  6. Under Available Plans, select default.

  7. Add the Service Plans.

  8. Save your changes.

Role Collection

Note

When changing roles, make sure to sign off and on again.
Interface showing SAP BTP cockpit with role collections, user roles, and mappings for a specific subaccount.

Steps

  1. In the SAP Business Technology Platform cockpit, choose Subaccounts.

  2. In the subaccount in which the application SAP Order Management for sourcing and availability is subscribed, choose Security  Users.

  3. Choose Create.

  4. Enter the email address of the user you want to assign the role collection to as name, select the default identity, and insert the email address again.

  5. Choose Create.

  6. For UI user access, create a role collection as described in Define a Role Collection and add the following roles to it:

    • StrategyREAD
    • StrategyWRITE
    • MasterDataREAD
    • MasterDataWRITE
    • StrategyStatisticREAD
    • TracesWRITE
    • SourcingCREATE

    Note

    For more information about the roles concept and other predefined roles, see Authorization and Authentication.
  7. Assign the role collection to one or more users. For more information, see Assigning Role Collections to Users or User Groups.

Subscribe

Screenshot of a web interface displaying a validation message about the requirement for Alt Text in images.

Steps

  1. In your SAP Business Technology Platform cockpit, navigate to the subaccount in which you want to use the application.

  2. In the navigation pane, choose Services → Service Marketplace.

  3. Search for SAP Order Management for sourcing and availability and open the detail view by clicking the tile.

    Note

    In case SAP Order Management for sourcing and availability is not available, create an incident for component IS-DFO.
  4. Choose Create.

  5. In the step Basic Info, under Plan select default.

  6. Choose Create.

Enabling API Access

Screenshot of SAP BTP Cockpit showing service entitlement management for SAP Order Management for Sourcing and Availability.
Interface for creating a new instance or subscription in SAP BTP cockpit, showing service options and parameters.

Steps

  1. Sign in to the SAP Business Technology Platform cockpit.

  2. Open your global account and the subaccount in which you've subscribed to SAP Order Management solution for sourcing and availability.

  3. Open Entitlements in the navigation area and choose Configure Entitlements.

  4. Click Add Service Plans.

  5. From the All Solutions dropdown menu, choose SAP Order Management for Sourcing and Availability(API).

    Note

    You have the option to choose from four different plans. For information about the roles contained in each service plan, see Service Plans.
    • default
    • client-capacity
    • client-unprocessed-sales
    • client-webshop
  6. Click Add Service Plans and save your entitlements.

Create Service Key And Check Details

Dialog box for creating a new binding, with fields for binding name and JSON file upload.

Onboarding SAP Order Management Foundation

Overview

The recommended setup and onboarding option for SAP Order Management foundation is the SAP BTP cockpit booster. The booster fast tracks the initial setup by automating several steps. After successfully executing the booster, it verifies authorization, compatible providers and regions, creates a subaccount or allows you to use existing subaccounts, adds users and sets up authorizations. It also enables Cloud Foundry, creates a default space and assigns roles to specific users.

Interface displaying SAP BTP Cockpit, focused on creating accounts for management and order sourcing at a global account level.

Prerequisite

You have followed the steps in the Initial Setup.

Note

When setting up your global account for SAP BTP, it is not mandatory that you also set up a subaccount. The booster can automate the subaccount for you. Setting up an SAP S/HANA XS Advanced UAA Server as а target system is optional. Activating the option Enable Cloud Foundry to create a space is also not required when working with the booster.

Getting Started with the Booster

  1. In the SAP BTP cockpit SAP BTP Cockpit , log on with your Global Account.

    Note

    To set up SAP Web IDE for SAP Order Management foundation, you need to access Global Accounts - SAP BTP Cockpit.
  2. Click Boosters in the left navigation pane.
  3. In the Boosters page, choose Extension Suite-Development Efficiency from the dropdown list. Alternatively, you can search for it in the Search text box.
  4. Select Prepare an Account for SAP Order Management Foundation, then click Start to start the wizard.
  5. The system then verifies if all the required prerequisites are met.
  6. Select a subaccount mode for the booster.
  7. Create Subaccount
  8. This mode will help you set up a new Cloud Foundry subaccount and execute the relevant booster steps.
  9. Select Subaccount
  10. This mode will help you select an existing Cloud Foundry subaccount and execute the relevant booster steps.
  11. Configure your Cloud Foundry subaccount and space.

    Note

    Subaccount names may not contain /. Choose a Region in which you want to create a subaccount and to enable Cloud Foundry.

    Note

    A standard region has been previously chosen. Add users and assign relevant roles.

    Hint

    Email addresses added to this field must be separated by any of the following:
    • Line breaks - for example:user1@company.com user2@company.com
    • Spaces - for example:user1@company.com user2@company.com
    • Commas - for example:user1@company.com, user2@company.com
    • Semicolons - for example:user1@company.com; user2@company.com
  12. Click Next to continue and review the information provided in the summary page.
  13. If you notice that there is information that needs correction, click the respective step number or click Previous until you get to the desired screen.
  14. Choose Finalize after you have reviewed all necessary information. The system presents a processing screen listing the performed steps. Once processing is done, the system presents a Success window.
  15. To add the SAP Order Management foundation scopes to the newly created instance of the service in the SAP BTP cockpit, proceed as follows:
    • Go to your subaccount, and then choose your space.
    • Choose Instances, and then choose your newly created instance for the service.The details of the instance are displayed.
    • Copy the instance ID.
    • On the instance details screen, choose ..., and then choose Update.The Update Instance wizard screen appears.
    • Choose Parameters (step 2).
    • Specify the parameters in JSON format as shown in the sample code below, where the xsappname represents the instance ID, and the SAP Order Management foundation scopes you require are listed under authorities.The sample code contains the full list of available scopes; enter the scopes you require based on your business needs. For more information, see the information about service instances for system integration in Identity and Access Management.

      Note

      Sample Code

      { "xs-security": { "xsappname": "<YourInstanceID>", "authorities": [ "$XSMASTERAPPNAME.OrderUIView", "$XSMASTERAPPNAME.OrderView", "$XSMASTERAPPNAME.OrderManage", "$XSMASTERAPPNAME.DispatchView", "$XSMASTERAPPNAME.DispatchManage", "$XSMASTERAPPNAME.DispatchIntegrate", "$XSMASTERAPPNAME.BusinessConfigView", "$XSMASTERAPPNAME.BusinessConfigManage", "$XSMASTERAPPNAME.Analytics", "$XSMASTERAPPNAME.ProductView", "$XSMASTERAPPNAME.ProductManage", "$XSMASTERAPPNAME.ProductIntegrate", "$XSMASTERAPPNAME.IntegrationMonitoring", "$XSMASTERAPPNAME.OrderActivityView", "$XSMASTERAPPNAME.OrderActivityManage", "$XSMASTERAPPNAME.BusinessPartnerView", "$XSMASTERAPPNAME.BusinessPartnerIntegrate" ] } }

  16. Choose Update Instance.

You can now access your newly created subaccount and adjust the settings further if necessary.

Data Center Availability

Currently both applications OMF and OMSA are available on EU-20 (Azure in Amsterdam) only.

Further data centers will be made availabe on dedicted customer request.

Language Support

Language Support

Language Scope for SAP Order Management Foundation:

  • English
  • German
  • French
  • Spanish
  • Russian
  • Simplified Chinese
  • Portuguese
  • Japanese
  • Czech
  • Italian
  • Polish
  • Swedish
  • Norwegian
  • Dutch

Language Scope for SAP Order Management for Sourcing and Availability:

  • English
  • German
  • French
  • Spanish
  • Italian
  • Portuguese
  • Chinese
  • Japanese
  • Czech
  • Polish

Log in to track your progress & complete quizzes