Skip to content

Commit a70bd0a

Browse files
committed
Automatic commit: Move 'cap-extend-sfsf-deploy-cf' from QA to Production
1 parent 3dc1236 commit a70bd0a

14 files changed

Lines changed: 124 additions & 0 deletions
32.7 KB
Loading
22.3 KB
Loading
Lines changed: 124 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,124 @@
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+
![Figure 1 – Switch the database back to HANA](switch-hana.png)
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+
![Figure 2 – Build CAP service](cds-build.png)
42+
43+
On the **left-hand pane** right-click the `mta.yaml` file and select **Build MTA Project**.
44+
45+
![Figure 3 – Build MTA Project](build-mta.png)
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+
![Figure 4 – Successful build](successful-build.png)
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+
![Figure 5 – MTA Archive generated](mta-archive.png)
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+
![Figure 6 – Deploy MTA Archive](deploy-mta.png)
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+
![Figure 7 – Successful deployment](successful-deploy.png)
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+
![Figure 8 – Find Role Collection](find-role.png)
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+
![Figure 9 – Add user to Role Collection](add-user.png)
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+
![Figure 10 – Start application](launch-app.png)
99+
100+
An **SAP Fiori Launchpad** will open-up in a new browser tab with the **application tile** in it:
101+
102+
![Figure 11 – SAP Fiori Launchpad](launchpad.png)
103+
104+
Click on the tile and the **List Report page** for the **Project** entity will be loaded:
105+
106+
![Figure 12 – List Report page for Project entity](list-report.png)
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+
![Figure 13 – Initial test data displayed](test-data.png)
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]
3.07 KB
Loading
12 KB
Loading
33.1 KB
Loading
31.4 KB
Loading
13.1 KB
Loading
27.6 KB
Loading
7.16 KB
Loading

0 commit comments

Comments
 (0)