Transport Mobile Development Kit (MDK) apps using SAP Content Agent UI

1. To access SAP BTP Cockpit of your enterprise account, choose https://cockpit.btp.cloud.sap. Depending on your own geo location, this URL will redirect you to the closest regional SAP BTP Cockpit URL.

2. In your global account, navigate to the Dev Source subaccount from where you want to transport Mobile apps.

   

To enable the usage of the user interface of SAP Content Agent service, subscribe to the free plan.

1. In your subaccount, go to Services > Service Marketplace.

2. Use the Search field to filter for content agent.

3. The SAP Content Agent tile is displayed.

   

4. Select the three dots (…) on the tile, and choose Create.

   

5. On the New Instance or Subscription dialog, from the Plan dropdown box, select free and choose Create.

   

6. The subscription is in progress. Choose View Subscription. You’ve subscribed to the application.

   

See also on SAP Help Portal: Initial Setup

After successful subscription, you need to configure user access to the application. You can create role collections and assign roles to the role collections based on the application templates. Afterwards, you assign the role collections to users or user groups.

1. To use the delivered role collections, choose Security > Role Collections from the navigation on the left. Filter for role collections called content agent. The role collections are displayed.

   

2. To assign users to the desired role collection, choose Content Agent Admin, from the list. In the details of the role collection, choose Edit.

   

3. You can add individual users or user groups to the role collection. In the tutorial, add an individual user. To do this, select the identity provider (here: Default identity provider). In the ID field, enter an existing e-mail address and choose Enter. The E-Mail field is automatically filled with the selected e-mail address. Save your changes.

   

Repeat the steps, if you want to add users other role collections for other tasks, such as the Content Agent Import Operator for import tasks. See also on SAP Help Portal: Setting Up Role Collections

You should now be able to access the user interface of SAP Content Agent service.

1. To check this, in your subaccount, choose Services > Instances and Subscriptions. In the Subscriptions section, choose the Content Agent link or the Go to Application icon to the right of it.

   

2. In a new tab, you should now see the Overview page of your SAP Content Agent service. Currently, the Activities Performed tile is empty as expected from a new instance.

   

Get the service key details of the SAP Cloud Transport Management instance that you created as part of tutorial Step 5 in Get Started with SAP Cloud Transport Management.

1. Go to the central administrative SAP BTP subaccount. To do this, click on the Central Services tile.

   

2. Choose Instances and Subscriptions and filter for Cloud Transport Management to get the service instance. Click on the key link to view credentials.

   

3. The key looks as follows. Leave the service key open so that you copy the required values in the next step, or note down the values of uri (you have to scroll down), as well as clientid, clientsecret, and url from the uaa section.

   

The destination to SAP Cloud Transport Management service defines the endpoint of SAP Cloud Transport Management service that is used by SAP Content Agent for pushing the content to desired source node of transport route. The destination has the fixed name TransportManagementService.

1. Open the source subaccount in a new tab.

   

2. Under Connectivity > Destinations click on Create Destination.

   

3. In the Destination Configuration window, enter details for the following fields.

   Keep the values of fields not mentioned in the table unchanged. For destination name, the value must have TransportManagementService as prefix.

   Field	Value
   Name	TransportManagementService as default
   Description	For example: Destination to SAP Cloud Transport Management
   URL	Enter the value of the uri from the service key details (scroll down to the bottom of the service key). For example: https://transport-service-app-backend.ts.cfapps.us10.hana.ondemand.com
   Authentication	Select OAuth2ClientCredentials.
   Client ID	Enter the value of clientid from the uaa section of the service key details.
   Client Secret	Enter the value of the clientsecret from the uaa section of the service key details.
   Token Service URL	Enter the value of url from the uaa section of the service key details and append /oauth/token to the URL. For example: https://cpi-dev-12345678.authentication.us10.hana.ondemand.com/oauth/token

   

See also on SAP Help Portal: Create TransportManagementService Destination

You need to configure a transport destination so that SAP Cloud Transport Management knows about the target endpoint of the deployment process. This is usually the endpoint of the deploy service on Cloud Foundry.

1. You will use the Central Services subaccount that’s subscribed to SAP Cloud Transport Management service.

   

2. In the Central Services subaccount, under Connectivity > Destinations click on Create Destination.

   

3. In the Destination Configuration window, enter details for the following fields and save the entries:

   Field	Value
   Name	Enter a name, for example: Quality_Target_Node
   Description	For example: Destination for Deploy Service targeted on target BTP account for Mobile Service
   URL	Specify the URL to the SAP Cloud Deployment service as the deploy end point of the destination https://deploy-service.cf.<domain>/slprot/<myorg>/<myspace>/slp <domain>: Domain of your target subaccount derived from the Cloud Foundry API endpoint that you can find in the SAP BTP Cockpit in the Overview of your subaccount. <myorg>/<myspace>: Names of your org and space. For example https://deploy-service.cf.eu10-004.hana.ondemand.com/slprot/Example%20Company%20Test%20Org/Example%20Company%20Test%20Space/slp
   Authentication	Select BasicAuthentication.
   User*	Specify the user name (usually, an email address) of the user that is used for the deployment. User must be a valid platform user on Cloud Foundry environment and it must have the role SpaceDeveloper in the target space.
   Password	Specify the password of the user.

   

   The destination was created.

This destination name will be used later in target node configuration of the SAP Cloud Transport Management application.

Configure the landscape in SAP Cloud Transport Management service using the transport destination.

1. Go to the central administrative SAP BTP subaccount. To do this, click on the Central Services tile.

   

2. Choose Instances and Subscriptions and filter for Cloud Transport Management and launch the application. The UI opens in a new browser tab or window.

   

3. To configure the landscape, select Landscape Visualization from the navigation on the left.

   

4. Start by creating the transport node that acts as the logical representation of your SAP Integration Suite source subaccount, here DEV_NODE. To do this, choose the + icon (1). On the Create Node dialog, enter details for the following fields (2-3), and click OK (4):

   You can keep the values of fields not mentioned in the table unchanged.

   Field	Value
   Name (2)	Enter a name, here: DEV_NODE
   Description	This field is optional. For example: source (development) node for Mobile Services
   Allow Upload to Node (3)	Select the checkbox.

   

5. To create the transport node that acts as the logical representation of your SAP Mobile services target subaccount, choose the + icon. On the Create Node dialog, enter details for the following fields. Afterwards, choose OK (4).

   You can keep the values of fields not mentioned in the table unchanged.

   Field	Value
   Name (1)	here TARGET_NODE
   Description	This field is optional. For example, SAP Mobile services Quality target node.
   Content Type (2)	Select the type of content as Multi-Target Application.
   Destination (3)	Select the destination created in the previous step. Here, this is Quality_Target_Node.

   

6. The target node is created and is also visible on the canvas. To create a transport route to connect the two nodes, choose the connector icon. sOn the Create Route dialog, enter a name for the transport route, here Route_DEV_TARGET (1), select the source node DEV_NODE (2) and the target node TARGET_NODE (3), and click OK (4).

   

You’ve configured the transport landscape.

See also on SAP Help Portal: Configuring the Landscape

Confirm if the app is ready to be exported.

1. Launch SAP Mobile Services Cockpit by clicking on the app from instances in DEV account.

   

2. Confirm the app in dev account

   

1. Login to SAP Content Agent UI from the DEV account.

   

2. Navigate to the Content Types page to check status of SAP Mobile service. You should see a warning message SAP Mobile service is active and ready for export. Ignore the Action Recommended as in this scenario we do not perform direct import from Content Agent UI.

   

3. Check the status of SAP Cloud Transport Management is showing as “Connected” to verify the destination is configured correctly in the DEV account. Select the destination name. By default TransportManagementService is pre-selected. Select the source node as the entry node of the transport route you want to choose.

   

4. Start the export process by clicking on Export option listed in the Side Navigation. Use the options to filter type as Mobile Application and search text using name of your app, for example test.

   

5. Select the mobile app from the list you want to export. Upon clicking the checkbox you can view the subcomponents of selected app where some mandatory components are pre-checked for you. Go to Step 2.

   

6. Select the transport mode option as “SAP Cloud Transport Management” service. Choose the source node based on the entry node of the desired transport route. Enter a description for creating the transport request. This would be visible in the SAP Cloud Transport Management transport requests view.

   

7. Review your selection and proceed to the next step.

   

8. An asynchronous process is started and you can view the progress and messages.

   

You can also use the “Activities Performed” page to see the past activities - export/ import done along with logs, content selected and transport information to track if the changes are deployed in the target account.

1. Navigate to Activities Performed and select the activity for which you want to view further details.

   

2. Select the tab Activity Logs to view the logs. You can also download them.

   

3. Select the Content Information tab to view the details (subcomponent information) of the mobile app you have exported from the source account.

   

4. Select the Transport Details tab to see the transport request status. You can also use the View Transport Request ## button to go to SAP Cloud Transport Management UI to see further details.

   

1. Navigate to the target subaccount where you want the app to be imported.

   

2. Launch SAP Mobile Services Cockpit by clicking on the support link of SAP Mobile Services.

   

3. To login, follow the steps of tutorial.

4. From the home screen, navigate to Mobile Applications > Native/MDK. Confirm there are no apps listed in the page.

   

5. Bookmark the Mobile Services admin UI URL for quick access.

In Cloud Transport Management, the content is automatically forwarded from the DEV_NODE to the TARGET_NODE. You can now import the content into your target subaccount.

1. Navigate to the transport request created in SAP Cloud Transport Management. You can do so by clicking on the Transport Request link from the activities performed page in Content Agent UI (as shown in previous step). To go to the import queue, click on the TARGET_NODE.

   

2. To start the import select the checkbox in the table for the transport request and click on Import Selected.

   

3. Approve the import.

   

4. When the import is successful, the status of the transport request changes to Succeeded. You can display more details about the import in the log of the transport request. To display the log, click on the log icon.

   

1. Launch the Mobile Services admin UI by opening the URL bookmarked earlier.

2. From the home screen navigate to Mobile Applications > Native/MDK.