Enterprise Resource Planning Blogs by SAP
Get insights and updates about cloud ERP and RISE with SAP, SAP S/4HANA and SAP S/4HANA Cloud, and more enterprise management capabilities with SAP blog posts.
cancel
Showing results for 
Search instead for 
Did you mean: 
Arunachalam
Advisor
Advisor

In this How to guide, I will take you through the steps required to Download, Import and Deploy SAP Service and Asset Manager metadata definitions to Mobile Services.

Scenario:
1. Download SAP Service and Asset Manager 2310 metadata definitions.
2. Import in SAP Business Application Studio.
3. Deploy in SAP Mobile Services.

Step 1: Downloading metadata definitions

SAP Service and Asset Manager client application is developed with Mobile Development Kit (MDK), which is a metadata-based application development platform. Main application functionalities of SAP Service and Asset Manager are controlled by MDK metadata. With each release of SAP Service and Asset Manager, the complete set of application metadata definitions are released.

To find metadata files for SAP Service and Asset Manager releases, use SAP for Me software center:
https://me.sap.com/softwarecenter

Search By Category SAP Mobile Solutions SAP SERVICE AND ASSET MANAGER→ SAP SERVICE AND ASSET MANAGER SAP SERVICE AND ASSET MANAGER nnnn. ‘nnnn’ is the release number of SAP Service and Asset Manager.

SVC ASSET MGR METADATA nnnn – SAP Service and Asset Manager application metadata. The file name has the format ASSETMGRMTADTA###_#-########.zip
SWDC_SSAM_Metadata.png
Download the ZIP file. In case of multiple items, download the latest Patch Level ZIP file.

Step 2: Importing in SAP Business Application Studio


SAP Business Application Studio is a new SAP Business Technology Platform (SAP BTP) service that offers a modern development environment tailored for efficient development of business applications for the SAP Intelligent Enterprise.

SAP Business Application Studio is based on Code-OSS, an open-source repo used for building Visual Studio Code. Available as a cloud service, SAP Business Application Studio provides a desktop-like experience similar to leading IDEs, with command line and optimized editors.

Contact your BTP Admin for BAS subscription and launch link. Sample link format:
https://<subaccount_string>.<region_string>.applicationstudio.cloud.sap/

  1. Launch Business Application Studio via link.
  2. Create the Dev Space.
    A dev space is a pre-configured private environment (your own "virtual machine" on the cloud) where you can develop, build, test, and run using pre-installed runtimes and tools. Enter name of your choice and choose SAP Mobile Application.
    BAS_Create_DevSpace.png
  3. Start the Dev Space.
    Upon creation of the Dev Space, start the dev space if it does not automatically start.
    DevSpaceStopped.png
  4. Launch the Dev Space.
    To launch the Dev Space, click the Dev Space Name hyperlink.
    DevSapceRunning.png
  5. Go to Menu, select File → open Folder.
    Enter /home/user/projects and hit OK.
    Once within Dev Space, choose Import (or) Go to Menu, select File → Import Project.
    DevSpaceImport.png
  6. Select the ASSETMGRMTADTA00P_1-70008341.ZIP file that was downloaded from Software Center. It will upload, extract and open the project automatically.
    To manually open the project, Go to Menu, select File → open Folder.
    Enter /home/user/projects, choose project and hit OK.
    SAM2310Metadata.png
  7. Delete the SIGNATURE.SMF file.
    SignatureSMF.png
  8. Go to Menu, Select View → Command Palette >CF: Login to Cloud Foundry.
    Screenshot 2024-01-31 at 4.52.46 PM.png
  9. Enter Cloud Foundry Endpoint and login using preferred authentication method.
    BAS_CF_SignIn.png
    Select your Org and Space.
    Misc_BAS_Set_Org_and_Space.png
    Note: You can find API Endpoint in SAP BTP Cockpit - Subaccount Overview.
    BTP_CF_API_Endpoint.png
  10. Add MDK Bundler externals from Branding SDK.

    To find Branding SDK files for SAP Service and Asset Manager releases, use SAP for Me software center:
    https://me.sap.com/softwarecenter

    Search By Category → SAP Mobile Solutions → SAP SERVICE AND ASSET MANAGER→ SAP SERVICE AND ASSET MANAGER → SAP SERVICE AND ASSET MANAGER nnnn. ‘nnnn’ is the release number of SAP Service and Asset Manager.

    Screenshot 2024-01-31 at 5.44.55 PM.png
    bundlerExternals to be included are available in Branding SDK → SAPAssetManager →  SAM.mdkproject →  MDKProject.json
    Screenshot 2024-01-31 at 5.50.27 PM.png
    In Business Application Studio, Go to Menu, Select File → Preferences → Settings.
    Search for Mdk: Bundler Externals
    Choose Edit in settings.json, add the externals from MDKProject.json like below and save.
    bundlerExternals.png

Step 3: Deploying in SAP Mobile Services


SAP Mobile Services is a cloud-based offering that is complemented by various development tools such as the native SDKs for iOS, Android, the mobile development kit or SAP Mobile Cards.

Application is already created in Mobile Services via App Create Program. It can also be created manually in Mobile Services, but applicable only in non-productive environment. Refer 3320366 - SAP Service & Asset Manager Production App Create and Metrics and Checklist for more details.
  1. Start the Deployment.
    Right click on the Application.app file in the project root directory and select MDK Deploy.
    BAS_MDK_Deploy.png
  2. You will see a series of prompts to deploy the app.
    Select Mobile Services as the deployment target.
    DeployPrompt1.png
    Select standard as the Mobile Services landscape.
    DeployPrompt2.png
    Select the appropriate application from Mobile Services.
    DeployPrompt3.png
    Select No to Include source map file for debugging.
    DeployPrompt4.png

    Select MDK 23.4+ as target MDK client version.

    3c_DeployPrompt5.png
    If the schema version of your project is lower than 6.0 and there are .ts files in the Extensions folder, you will be prompted to choose the target client version. Choose appropriate version based on your target MDK client version.

    _SchemaVersion can be maintained in Application.app

    Misc_MDK_SchemaVersion.png
    In the .project.json file, Build section contains target client option configuration. Check detailed explanation in the following table:
    Misc_MDK_TargetClientVersion.png

    Deployment process will be initiated. MDK: Deploy will perform following tasks.

    1. MDK Validation
    2. MDK Bundling
    3. Uploading bundled zip to your app in Mobile Services
    4. Deploying the bundle to your app in Mobile Services

    Misc_BAS_DeploymentStarted.png
    If the application deploys successfully, a message with the current revision is displayed.

    3d_DeployedSuccessfullyBAS.png
    Confirm that the deployment is finished successfully in Mobile Services.
    DeploymentSuccessful.png
    This completes the metadata deployment process.

Install and start SAP Service and Asset Manager from the Apple App Store and Google Play Store on your device.

5 Comments