SAP Learning Journey

Setting Up Your Account for Full-Stack Application Development using Productivity Tools in SAP Business Application Studio

Objectives
After completing this lesson, you will be able to:

After completing this lesson, you will be able to:

  • Use a booster to automatically set up a subaccount
  • Add entitlements to a subaccount on SAP BTP
  • Access SAP Business Application Studio for application development on SAP BTP
  • Subscribe to services on SAP BTP

Set Up of an Account for Application Development

Business Scenario

In this lesson, you will learn about the administration onboarding steps for setting up an account, with the tools and services needed to get you started with developing applications on SAP Business Technology Platform.

Prerequisites

  • You need a global account enabled – see Getting a Global Account
    Note

    Depending on whether you are using a Trial Account, Free-Tier, or an Enterprise Account, the options available might differ. If you are using an Enterprise Account you will have access to all options. If you are using a Trial or Free-Tier Account, you will find that some options are not available. In those cases watch the simulation.

  • The global account has entitlements for:
    • SAP Business Application Studio
    • SAP Build Work Zone (standard OR advanced edition)*
    • SAP HANA Cloud
    • (Optional) SAP Mobile Services
    • Cloud Foundry runtime
Note
*If you have already subscribed to the SAP Build Work Zone, advanced edition, you don't need to subscribe to the standard edition. The advanced edition is a superset of the standard edition.

You'll need the role of Global Account Administrator to be able create a new subaccount.

Addition of Entitlements to a Subaccount on SAP BTP

Access to SAP Business Application Studio on SAP BTP can be obtained through manual subscription or by using a subscription booster. Boosters provide a set of guided interactive steps that enable you to select, configure, and consume services on SAP BTP to achieve a specific technical goal. For more information about SAP BTP boosters, see Boosters.

The Getting Started with SAP Business Application Studio booster equips your subaccount with the basic entitlements and subscriptions to help you develop and preview your applications within SAP Business Application Studio.

These include:

Entitlements per Plan

EntitlementFree-Tier Account/Enterprise AccountTrial Account
SAP Business Application StudiofreeTrial

Continuous Integration & Delivery

-cicd-app

-cicd-service (Not available on Trial)

cicd-app (free (Application))

cicd-service(default)

cicd-app (trial (Application))
Authorization and Trust Management Service

application

space

apiaccess

application

space

apiaccess

Additionally, the booster also assigns the required role collections to the user, which include:

  • Business_Application_Studio_Administrator
  • Business_Application_Studio_Developer
Note
Ensure that the above entitlements (including subscriptions) and role collections are assigned to your subaccount, either by running the booster or by assigning them manually.

If you are using a trial account on SAP BTP and cannot use the booster, please follow the steps described here to Set Up Your Trial Account, configure entitlements, and create a dev space. In this case, skip task 1.

However, you will not be able deploy the applications or create native mobile apps. To enable deployment, we will need to add more entitlements and subscriptions to your subaccount:

Additionally, depending on your choice of media for deployment, you can add the following services:

You can also add other entitlements and subscriptions depending on your business objectives. For more details, see Deploying Applications.

Once the booster is completed successfully, you gain access to various high productivity development capabilities in a cloud environment. For a test and (free) evaluation, and usage of the SAP Business Application Studio environment, you can use the free-tier plans or trial-accounts. For more information on the free-tier plan of SAP Business Application Studio, see Application Plans.

For more information on the Trial Account see Working with a Trial Account.

Set up your Account for full-stack Application Development using Productivity Tools in SAP Business Application Studio

Business Scenario

In this exercise, we will set up an account with the tools and services needed to get you started for developing applications on SAP Business Technology Platform. We will go through all the necessary administration tasks to create and configure a subaccount, and enable various services. Take note that we will use a single subaccount for development (design time), as well as for deployment (runtime). In real-world scenarios, design-time and runtime environments are typically managed separately to reduce operational costs.

In this exercise, you will perform the following tasks:

  • Create a new subaccount for application development using a booster.
  • Add additional entitlements to your account for SAP Build Work Zone, SAP HANA Cloud, SAP Mobile Services, and Cloud Foundry runtime.
  • Add subscription or instances for SAP Build Work Zone, SAP HANA Cloud, SAP Mobile Services, and Cloud Foundry runtime.
  • Assign required role collections for your user.
Note

In this exercise, we will be creating a new subaccount. It is also possible to apply the required configuration steps to an existing subaccount. However, to keep things clean and separated from other activities, we recommend creating a separate subaccount for this learning journey.

Prerequisites

Details on the prerequisites for setting up an account on SAP Business Application Studio for application development is covered in this lesson.

Note

Depending on whether you are using a Trial Account, Free-Tier, or an Enterprise Account, the options available might differ. If you are using an Enterprise Account you will have access to all options. If you are using a Trial or Free-Tier Account, you will find that some options are not available. In those cases watch the simulation.

Context

As discussed earlier in this lesson, you will be using a booster to set up a new subaccount for developing applications on SAP Business Application Studio. The setup environment however, will only enable you to design and preview your applications. You will have to subscribe to additional entitlements and services to be able to deploy your application.

Note

Note that some of the services that this learning journey links to, can incur costs.

If you are concerned about charges, you can opt to skip the corresponding exercises and watch the simulation instead.

Note

If you are using a Trial Account the booster described in task 1 will not be available as SAP Business Application Studio is available by default. In this case, continue with task 2.

Note
In this exercise, it is recommended to save your work more often than requested in the substeps.

Let's get started.

Exercise Options

You can perform this exercise in two ways:

  1. Live Environment: by using the instructions provided below, you can perform the steps in your SAP BTP account.
  2. Platform Simulation: follow the step-by-step instructions within the simulation.
Note
We strongly recommend to perform the steps in the live environment first.

The following simulation reproduces the full exercise execution:

ExerciseStart Exercise

Task 1: Run the "Get Started with SAP Business Application Studio" Booster

Steps

  1. Use a booster from your global account cockpit.

    1. From the navigation pane of your SAP BTP cockpit, choose Boosters.

    2. Search for studio to find the booster called Get started with SAP Business Application Studio, and open it.

    3. The booster overview page provides some more information about the booster, and the solution diagram shows the (potential) services involved.

    4. Choose Start to start the booster. In the first step, the booster will check whether the prerequisites for running the booster are in place. Once this step is finished and no issues are found, choose Next.

    5. You can now choose to create a new subaccount (recommended for this exercise), or choose an existing subaccount to apply the booster. Choose Next.

    6. As Provider choose Microsoft Azure and as Region choose US West (WA).

      You can now configure your subaccount's name, region, cloud provider, and so on. Depending on the entitlements, your options for cloud providers and regions can be different because not every service is available in every data center. The SAP Continuous Integration and Delivery service is optional, but it is recommended to keep these services, as they will be used as part of this Learning Journey.

    7. Choose Next.

    8. In this step, you can add team members to your subaccount. Administrators can manage the account and services. Developers are more limited in their options, but can still develop applications. By default, you will be part of the administrators. Choose Next.

    9. In the last step before execution, you can review your configuration settings. Choose Finish to execute the booster.

    10. A pop-up dialog appears that shows the booster's progress. As you will notice, some steps can be executed in parallel.

    11. Once the booster has successfully finished, choose Navigate to Subaccount.

Task 2: Add More Entitlements to Your Subaccount to be Able to Deploy Applications

Note

In this task you will add several services to your subaccount. If you decide to use free-tier services be aware of the fact that each service implements its own limitations (for example with regards to the number of available instances per account).

If you are using a trial account you might find that some entitlements have already been added by default.

Steps

  1. Add entitlements to the subaccount.

    1. From the navigation pane on the left, choose Entitlements. The list overview shows you all entitlements currently assigned to your subaccount. Some are added by default when a subaccount was created. Others were added by the booster.

    2. Choose Configure Entitlements.

    3. Choose Add Service Plans.

  2. Add the SAP Build Work Zone entitlement.

    1. Search for zone, and choose the SAP Build Work Zone, standard edition entitlement.

    2. Choose the required plan.

      Free-tier Account/Enterprise AccountTrial Account
      Free (Application)standard (Application)

  3. Add the SAP HANA Cloud entitlements.

    1. Search for hana, and choose the SAP HANA Cloud entitlement.

    2. Choose the required plan.

      Free-tier Account/Enterprise AccountTrial Account
      hana

      tools

      		hana

      tools (Application)

    3. Choose the SAP HANA Schemas & HDI Containers entitlement.

    4. Choose the hdi-shared plan.

  4. Add the Mobile Services entitlement.

    1. Search for mobile, and choose the Mobile Services entitlement.

    2. Choose the required plan.

      Free-tier Account/Enterprise AccountTrial Account
      Freelite

  5. Add the Cloud Foundry Runtime/Environment entitlement.

    1. Search for run, and choose the Cloud Foundry Runtime/Environment entitlement.

    2. Choose the required plan.

      Free-tier Account/Enterprise AccountTrial Account
      Free (environment)MEMORY

  6. Save all added service plans.

    1. Choose Save.

    2. Wait for the changes to be saved and applied to the subaccount before continuing the exercise.

Result

You have now set up your account for full-stack application development using productivity tools in SAP Business Application Studio, and you are ready for the next exercises.

Task 3: Open SAP Business Application Studio From the New Subaccount

Steps

  1. Find and open the URL to SAP Business Application Studio.

    1. You are now in the overview page of your newly created subaccount. Notice the space (by default Dev that was created for you). From the navigation pane on the left, choose Instances and Subscriptions.

    2. In the Subscriptions list, you will see a link to the SAP Business Application Studio. Choosing this link will bring you to the entry point of the SAP Business Application Studio.

    3. From the home page, you can create a cloud-based development environment (called dev space) and start developing apps. The home page only opens, if you haven’t created any dev spaces yet. If there are already existing dev-spaces the dev space manager will open, where you can create new dev spaces or access already existing ones. The details will be handled in the next lesson. As mentioned earlier, at this point the environment setup allows you to develop and preview your applications, but you will not be able to deploy them. Proceed to the next steps to add additional entitlements and subscriptions for deployment.

Task 4: Create a New Dev Space in SAP Business Application Studio

Steps

  1. Create a new dev space.

    Use the following data:

    FieldValue
    Name(of your choice, for example) RisksManagmentDevSpace

    1. From the home-page of SAP Business Application Studio or Dev Space's manager, choose Create Dev Space.

    2. Enter a name for the dev space (for example, RisksManagmentDevSpace).

    3. Choose the Full Stack Application Using Productivity Tools type.

    4. Choose Create Dev Space.

    5. Wait until the dev space status becomes Running.

    6. Open the dev space by choosing dev space name link.

    7. Wait for the SAP Business Application Studio IDE loading to come to an end.

      You will see a notification on the lower right side with the text We have finished installing all tools and templates for you, enjoy your work!)

      Note

      By default SAP Business Application Studio opens with a dark theme. For better readability we use a light theme in this Learning Journey. You can adapt the themes by selecting the Manage button on the lower right side of your screen. Then choose Themes and Color Theme. This will open a list where you can select which theme you would like to use.

Task 5: Create an SAP HANA Database for Your Application

Steps

  1. Log on to your Cloud Foundry account.

    1. Open SAP Business Application Studio.

    2. Find the Hamburger icon in the menu on the left side of the screen. Select View and then select Command Palette.

    3. Select CF: Login to Cloud Foundry.

    4. Provide the API endpoint to your account.

      This is located in the overview page of your BTP subaccount.

    5. Select authentication method as SSO Passcode.

    6. Choose the link open a new browser page to generate your SSO passcode.

    7. Sign in with the appropriate identity provider, and copy the Temporary Authentication Code.

    8. Enter the Temporary Authentication Code as SSO Passcode.

    9. Choose Sign in.

    10. Select the organization and the space.

    11. Choose Apply.

  2. Create an SAP HANA Database for your application.

    1. Find the Hamburger icon in the menu on the left side of the screen. Select Terminal and then select New Terminal.

      This opens the Terminal window.

    2. Paste the following script into the terminal.

      For trial:

      cf create-service hana-cloud-trial hana learningdb -c '{ "data": {"memory": 30, "systempassword": "<your_password>"}}'
      Note

      Replace <your_password> with a password of your choice.

      For free-tier:

      cf create-service hana-cloud hana-free learningdb -c '{ "data": {"memory": 32, "systempassword": "<yourpassword>"}}'

    3. Choose Enter.

      This executes the script.

    4. Navigate to your SAP BTP subaccount and choose Services, followed by Instances and Subscriptions. You can follow the progress of the HANA database creation here.

      Note

      For trial account users:

      1. Once the database is created, navigate to your Subscriptions, and choose SAP HANA Cloud. You can see your created HANA database here as well.
      2. Select More and choose Manage Configuration.
      3. Navigate to the Connections tab and select Allow all IP addresses. Choose Review and Save.
      4. In the confirmation dialog box, choose Save changes with restart.
      5. Now for the changes to take effect, select More for your HANA database and choose Stop.
      6. Once the status of the database shows Stopped, select More and choose Start.

        Wait for the status to change to Running, before proceeding.

  3. Review that all instances have been subscribed.

    1. Assuming the HANA Cloud Database instance has been successfully set up, in the subscriptions overview, you should now have:

      • Continuous Integration & Delivery.
      • SAP Business Application Studio.
      • SAP Build Work Zone.
      • SAP HANA Cloud.

    2. In the instances overview, you should now have instances of the services:

      • Continuous Integration & Delivery (not available in trial).
      • SAP HANA Cloud Database.

Subscribe to Services in Service Marketplace

Business Scenario

In this exercise, you will subscribe to services in Service Marketplace, and you will set up your account for application development in SAP Business Application Studio.

In this exercise, you will perform the following task: subscribe to services in Service Marketplace.

Prerequisites

The exercise Set up Your Account for Full-Stack Application Development Using Productivity Tools in SAP Business Application Studio is completely and successfully done.

Note
Depending on whether you are using a trial account, free-tier, or paid services, the options available might differ. This document aims to cover all options available.
Note

Note that some of the services that this learning journey links to, can incur costs.

If you are concerned about charges, you can opt to skip the corresponding exercises and watch the simulation instead.

Note
In this exercise, it is recommended to save your work more often than requested in the substeps.

Exercise Options

You can perform this exercise in two ways:

  1. Live Environment: by using the instructions provided below, you can perform the steps in your SAP BTP account.
  2. Platform Simulation: follow the step-by-step instructions within the simulation.
Note
We strongly recommend to perform the steps in the live environment first.

The following simulation reproduces the full exercise execution:

ExerciseStart Exercise

Task 1: Subscribe to Services in Service Marketplace

Steps

  1. Subscribe to SAP Build Work Zone.

    1. In the navigation pane of the subaccount's SAP BTP Cockpit page, choose Service Marketplace.

    2. Search for zone, and choose the SAP Build Work Zone, standard edition tile.

    3. In the service details section, you can find more information about the service, and additional links. Take note that for free plan, there are restrictions. For trial you have to use the standard (subscription) plan. Choose Create.

    4. Choose the Service and Plan (use the defaults), and choose Create.

    5. While the subscription is in progress, you can check the status in the Instances and Subscriptions list by choosing the View Subscription button. Alternatively, choose Close to close this dialog and go to the next step while the subscription continues in the background.

  2. Subscribe to SAP HANA Cloud.

    1. In the Service Details section, choose Create.

    2. Depending on your type of account you have to choose the tools/tools (Application) plan.

    3. Choose Create.

      Note

      If you didn’t run the Get Started with SAP Business Application Studio booster, you also have to add the following services manually by selecting them from Service Marketplace:

      • Continuous Integration & Delivery
      • SAP Business Application Studio

  3. Check the assigned Role Collections for your user.

    1. In the subaccount's SAP BTP cockpit, choose Users in the navigation pane.

    2. Choose your user.

    3. In the Details section, you can see which Role Collections are already assigned to your user. These Role Collections contain specific roles, and have been assigned through the booster, the subaccount creation, or subscription to specific services. Choose Assign Role Collection.

    4. In the dialog, choose the Role Collections and choose Assign Role Collection.

      • Launchpad_Admin
      • SAP HANA Cloud Administrator
      • CICD Service Administrator
      Note

      If you didn’t run the Get Started with SAP Business Application Studio booster you also have to add the following roles manually:

      • Business_Application_Studio_Administrator
      • Business_Application_Studio_Developer

Result

When you've reached this point, you have successfully subscribed to services in Service Marketplace.

Further Reading About Setting Up an Account

The following list provides further information about setting up an Account:

Log in to track your progress & complete quizzes