|
| 1 | +--- |
| 2 | +title: Deploy the SAP SuccessFactors Extension to Cloud Foundry |
| 3 | +description: In this phase of the development you will deploy the finished extension to BTP Cloud Foundry environment. |
| 4 | +auto_validation: true |
| 5 | +time: 8 |
| 6 | +tags: [ tutorial>beginner, software-product>sap-btp--cloud-foundry-environment] |
| 7 | +primary_tag: software-product-function>sap-cloud-application-programming-model |
| 8 | +--- |
| 9 | + |
| 10 | +## Prerequisites |
| 11 | + - Complete the tutorial: [**Prepare to Develop the SAP SuccessFactors Extension**](cap-extend-sfsf-intro) |
| 12 | + - Complete the tutorial: [**Jump start the SAP SuccessFactors Extension CAP Project**](cap-extend-sfsf-jumpstart) |
| 13 | + - Complete the tutorial: [**Import SAP SuccessFactors OData Services definitions**](cap-extend-sfsf-import-services) |
| 14 | + - Complete the tutorial: [**Create the CDS Data Model for the SAP SuccessFactors Extension**](cap-extend-sfsf-data-model) |
| 15 | + - Complete the tutorial: [**Create the CAP Service for the SAP SuccessFactors Extension**](cap-extend-sfsf-create-service) |
| 16 | + - Complete the tutorial: [**Add Business Logic to the SAP SuccessFactors Extension**](cap-extend-sfsf-add-logic) |
| 17 | + - Complete the tutorial: [**Prepare the SAP SuccessFactors Extension UI with CDS Annotations**](cap-extend-sfsf-ui-annotations) |
| 18 | + - Complete the tutorial: [**Add Security to the SAP SuccessFactors Extension**](cap-extend-sfsf-add-security) |
| 19 | + - Complete the tutorial: [**Deploy the SAP SuccessFactors Extension Database to SAP HANA Cloud**](cap-extend-sfsf-deploy-hc) |
| 20 | + - Complete the tutorial: [**Develop the SAP Fiori Elements Application for the SAP SuccessFactors Extension**](cap-extend-sfsf-fiori-elements) |
| 21 | + |
| 22 | +## Details |
| 23 | +### You will learn |
| 24 | + - How to **build the MTA archive** |
| 25 | + - How to **deploy the MTA archive** to Cloud Foundry |
| 26 | + - How to **assign a role collection** to a BTP business user |
| 27 | + - How to **launch and test** the deployed application |
| 28 | + |
| 29 | +--- |
| 30 | + |
| 31 | +[ACCORDION-BEGIN [Step 1: ](Build the MTA Archive)] |
| 32 | + |
| 33 | +Before you build the MTA Archive for deployment, do not forget to switch back the database from **in-memory `SQLite`** to **SAP HANA** (if not already). For that, just open the `package.json` file from the CAP service and set the `cds.requires.db.kind` parameter to `hana` like demonstrated below: |
| 34 | + |
| 35 | + |
| 36 | + |
| 37 | +Now you can start the procedure to build the archive. You begin by building the CAP service. |
| 38 | + |
| 39 | +In the **Terminal** type `cds build –-production` and press **Enter** (don't forget to press `CTRL+C` to terminate `cds watch` if it was previously running). |
| 40 | + |
| 41 | + |
| 42 | + |
| 43 | +On the **left-hand pane** right-click the `mta.yaml` file and select **Build MTA Project**. |
| 44 | + |
| 45 | + |
| 46 | + |
| 47 | +It's going to take some seconds until the build process completes. When it does, it will display a message "**Terminal will be reused by tasks**" in a dedicated terminal named "**Task Build MTA Project**". Look for the message "**Build succeeded**" among the lines in that console to make sure the build process was successful. |
| 48 | + |
| 49 | + |
| 50 | + |
| 51 | +If the process is successful you'll notice that a file named `sfsf-projman_1.0.0.mtar` will be generated into a new folder named `mta_archives` like demonstrated below: |
| 52 | + |
| 53 | + |
| 54 | + |
| 55 | +[DONE] |
| 56 | +[ACCORDION-END] |
| 57 | + |
| 58 | +[ACCORDION-BEGIN [Step 2: ](Deploy the MTA Archive)] |
| 59 | + |
| 60 | +> **IMPORTANT NOTE**: before you trigger the process to deploy the MTA archive to Cloud Foundry you **MUST** make sure you **comply with two requirements**: |
| 61 | +> |
| 62 | +> 1. You are properly **logged to Cloud Foundry** as instructed in **step 2** of the tutorial: [**Jump start the SAP SuccessFactors Extension CAP Project**](cap-extend-sfsf-jumpstart) |
| 63 | +> 2. Your **SAP HANA Cloud database is up and running** (remember that everything shuts down overnight on **trial accounts**!) |
| 64 | +
|
| 65 | +On the **left-hand pane** right-click the `sfsf-projman_1.0.0.mtar` file and select **Deploy MTA Archive**. |
| 66 | + |
| 67 | + |
| 68 | + |
| 69 | +It's going to take a while until the deployment process finishes. When it does, it will display a message "**Terminal will be reused by tasks**" in a dedicated terminal named "**Task Deploy MTA Archive**". Look for the message "**Process finished**" in the last lines and see that **there's no errors/failures listed** among the other lines in that console to make sure the deployment process was truly successful. |
| 70 | + |
| 71 | + |
| 72 | + |
| 73 | +[DONE] |
| 74 | +[ACCORDION-END] |
| 75 | + |
| 76 | + |
| 77 | +[ACCORDION-BEGIN [Step 3: ](Assign Admin Role to your Business User)] |
| 78 | + |
| 79 | +Before you jump into testing the application, you must remember that it's meant for **project administrators**, meaning, users with the Admin role assigned. So, assign the role to your user in SAP BTP. |
| 80 | + |
| 81 | +In the **SAP BTP cockpit**, on the **left-hand pane** expand the **Security** menu and click on **Role Collections**. On the right side, using the **search box**, search for the `sfsf_projman_Administrator` role and click on it. |
| 82 | + |
| 83 | + |
| 84 | + |
| 85 | +Click on the **Edit** button at the top-right corner, then, in the **Users** list, select the **Default identity provider** from the dropdown list and provide your **SAP BTP user ID** and your **e-mail** (usually in trial accounts they are both your e-mail). Click on the "**+**"" button on top of the list and then click on the **Save** button at the top-right corner. |
| 86 | + |
| 87 | + |
| 88 | + |
| 89 | +Now you are OK to test the application. |
| 90 | + |
| 91 | +[DONE] |
| 92 | +[ACCORDION-END] |
| 93 | + |
| 94 | +[ACCORDION-BEGIN [Step 4: ](Test the Deployed Application)] |
| 95 | + |
| 96 | +On the **left-hand pane**, click on **HTML5 Applications** and locate your **Business Solution** (`sfsf-projman-<your subdomain>`). Then, click on the link of the **Application Name**. |
| 97 | + |
| 98 | + |
| 99 | + |
| 100 | +An **SAP Fiori Launchpad** will open-up in a new browser tab with the **application tile** in it: |
| 101 | + |
| 102 | + |
| 103 | + |
| 104 | +Click on the tile and the **List Report page** for the **Project** entity will be loaded: |
| 105 | + |
| 106 | + |
| 107 | + |
| 108 | +Now, click on the **Go** button and the **initial test data** (loaded to the HANA database from the CSV files) will be displayed: |
| 109 | + |
| 110 | + |
| 111 | + |
| 112 | +And that's it! You have successfully deployed a **fully working SAP Fiori Elements application** to **SAP BTP Cloud Foundry**! |
| 113 | + |
| 114 | +You can, now, test it at your will, in the same way you did using the **Fiori Preview** in **step 6** of the tutorial: [**Prepare the SAP SuccessFactors Extension UI with CDS Annotations**](cap-extend-sfsf-ui-annotations). |
| 115 | + |
| 116 | +Finally, the last step in the journey of this tutorial group is to add your application to a **user-driven launchpad** using **SAP BTP's Launchpad Service**. |
| 117 | + |
| 118 | +[DONE] |
| 119 | +[ACCORDION-END] |
| 120 | + |
| 121 | +[ACCORDION-BEGIN [Step 5: ](Check Your Knowledge)] |
| 122 | + |
| 123 | +[VALIDATE_1] |
| 124 | +[ACCORDION-END] |
0 commit comments