Skip to content

Commit ae0f8be

Browse files
committed
Merge branch 'rebranding'
2 parents eeb007c + 056c926 commit ae0f8be

File tree

23 files changed

+41
-33
lines changed

23 files changed

+41
-33
lines changed

README.md

Lines changed: 21 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,24 @@
1-
# Examples of HTML5 Applications for SAP Cloud Platform Multi-Cloud Environment
1+
# Examples of HTML5 Applications for SAP Business Technology Platform Multi-Cloud Environements
22

33
[![REUSE status](https://api.reuse.software/badge/github.com/SAP-samples/multi-cloud-html5-apps-samples/)](https://api.reuse.software/info/github.com/SAP-samples/multi-cloud-html5-apps-samples/)
44

5-
This repository contains examples of HTML5 applications for the SAP Cloud Platform Cloud Foundry environment. The examples show how you can use standalone application routers or HTML5 Applications Runtime managed by SAP Cloud Platform to achieve different goals and they demonstrate the capabilities of the HTML5 Application Repository service in the Cloud Foundry environment.
5+
This repository contains examples of HTML5 applications for multiple SAP BTP environments. The examples show how you can use standalone application routers or managed application routers to achieve different goals and they demonstrate the capabilities of the SAP HTML5 Application Repository service for SAP BTP.
66

7-
On the Cloud Foundry environment of SAP Cloud Platform, you can run an application that was uploaded to the HTML5 Application Repository using one of the following options: a standalone application router or HTML5 Applications Runtime managed by SAP Cloud Platform. Both options allow you to serve static content from the HTML5 Application Repository, authenticate users, rewrite URLs, and forward or proxy requests to other micro services while propagating user information. However, the option that is managed by SAP Cloud Platform brings many benefits, such as:
7+
On the Cloud Foundry and Kyma environment of SAP BTP, you can run an application that was uploaded to the SAP HTML5 Application Repository service for SAP BTP using one of the following options: a standalone application router or a managed application router. Both options allow you to serve static content from the HTML5 Application Repository, authenticate users, rewrite URLs, and forward or proxy requests to other micro services while propagating user information. However, the option that is managed brings many benefits, such as:
88
- Simplifying and speeding up your development and deployment experience
99
- Saving resources by running a serverless HTML5 application, which doesn’t require any application runtime
1010
- Lower maintenance efforts by leveraging the most up-to-date routing capabilities
1111
- Meeting the changing demand for HTML5 applications by automatically adjusting the service to maintain consistent and predictable performance
1212

13-
In general, we recommend using the HTML5 Applications Runtime managed by SAP Cloud Platform. Use an standalone application router preferably only in advanced cases, for example when application router extensibility is required.
13+
In general, we recommend using the managed application router. Use an standalone application router preferably only in advanced cases, for example when application router extensibility is required.
1414

1515
For more information, see
16-
- [Developing HTML5 Applications Managed by SAP Cloud Platform](https://help.sap.com/viewer/ad4b9f0b14b0458cad9bd27bf435637d/Cloud/en-US/c1b9d6facfc942e3bca664ae06387e9b.html)
16+
- [Developing HTML5 Applications with the Managed Application Router](https://help.sap.com/viewer/ad4b9f0b14b0458cad9bd27bf435637d/Cloud/en-US/c1b9d6facfc942e3bca664ae06387e9b.html)
1717
- [Developing HTML5 Applications in the Cloud Foundry Environment](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/11d77aa154f64c2e83cc9652a78bb985.html)
1818

19-
Before you start with the examples, please make sure that you are familiar with the basic concepts of HTML5 web apps in Cloud Foundry, such as Cloud Foundry applications, services, service bindings. For more information, see [this video](https://www.youtube.com/watch?v=emnl-y9btdU).
19+
# Examples for SAP BTP, Cloud Foundry Environment
20+
21+
Before you start with the examples, please make sure that you are familiar with the basic concepts of HTML5 web apps in the Cloud Foundry environment, such as Cloud Foundry applications, services, service bindings. For more information, see [this video](https://www.youtube.com/watch?v=emnl-y9btdU).
2022

2123
The HTML5 Application Repository can hold any UI project independent of the used framework. Use the following commands of the [Cloud Foundry CLI plugin](https://sap.github.io/cf-html5-apps-repo-cli-plugin/) plugin to upload the HTML5 apps to the application repository:
2224

@@ -31,7 +33,7 @@ cf html5-push
3133
For information about how to upload a react-based application to the HTML5 Application Repository, see [this blog post](https://blogs.sap.com/2019/06/03/cloudfoundryfun-5-play-asteroids-powered-by-react-secured-by-sap-cloud-platform/).
3234

3335
## Requirements
34-
- You have an SAP Cloud Platform trial account in the region Europe (Frankfurt). For creating the trial account, see this [tutorial](https://developers.sap.com/tutorials/hcp-create-trial-account.html).
36+
- You have an SAP BTP Trial account in the region Europe (Frankfurt). For creating the trial account, see this [tutorial](https://developers.sap.com/tutorials/hcp-create-trial-account.html).
3537
- Node.js LTS version 10 is installed: <https://nodejs.org/en/download>
3638
- Cloud Foundry Command Line tool (cf CLI) is installed. For more information, see this [tutorial](https://developers.sap.com/tutorials/cp-cf-download-cli.html)
3739
- The Multi-Target Application Cloud Foundry CLI [Plugin](https://github.com/cloudfoundry-incubator/multiapps-cli-plugin) (MultiApps CF CLI Plugin) is installed :
@@ -52,17 +54,23 @@ For information about how to upload a react-based application to the HTML5 Appli
5254
5355
- [Basic App stored on HTML5 Application Repository, using XSUAA service, and destination service](standalone-approuter-html5-runtime-mta-hello-world)
5456
55-
- [SAP Fiori app integrated with SAP Cloud Platform Portal](standalone-portal-mta)
57+
- [SAP Fiori app integrated with SAP Cloud Portal service](standalone-portal-mta)
58+
59+
- [SAP Fiori app integrated with SAP Cloud Portal service and using UI5 flexibility service for key users](standalone-portal-keyuser-mta)
60+
61+
62+
## HTML5 Apps Using the Managed Application Router
63+
64+
In contrast to the examples above, you don't need an application router for the following apps, which use the managed application router. This reduces the total cost of ownership (TCO) and you don't have to update the application router manually.
5665
57-
- [SAP Fiori app integrated with SAP Cloud Platform Portal and using UI5 flexibility service for key users](standalone-portal-keyuser-mta)
66+
- [Basic HTML5 App with a Managed Application Router, XSUAA service, and destination service](managed-html5-runtime-basic-mta)
67+
- [SAP Fiori App with a Managed Application Router, XSUAA service, and destination service](managed-html5-runtime-fiori-mta)
5868
5969
60-
## HTML5 Apps Using the HTML5 Applications Runtime Managed by SAP Cloud Platform
6170
62-
In contrast to the examples above, you don't need an application router for the following apps, which use the HTML5 Applications Runtime managed by SAP Cloud Platform. This reduces the total cost of ownership (TCO) and you don't have to update the application router manually.
71+
# Examples for SAP BTP, Kubernetes Environment
6372
64-
- [Basic HTML5 app that is managed by SAP Cloud Platform with XSUAA service and destination service](managed-html5-runtime-basic-mta)
65-
- [SAP Fiori app that is managed by SAP Cloud Platform with XSUAA service and destination service](managed-html5-runtime-fiori-mta)
73+
Coming soon...
6674
6775
6876
## Known Issues
1.5 MB
Loading

managed-html5-runtime-basic-mta/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "managed-html5-runtime-basic-mta",
33
"dependencies": {
4-
"mbt": "^1.0.16"
4+
"mbt": "^1.1.0"
55
},
66
"scripts": {
77
"build": "mbt build"

managed-html5-runtime-basic-mta/readme.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Basic HTML5 App on HTML5 Application Runtime managed by SAP Cloud Platform
1+
# Basic HTML5 App with a Managed Application Router
22

33
## Diagram
44

@@ -7,11 +7,11 @@
77

88
## Description
99

10-
This is an example of an HTML5 app that is managed by SAP Cloud Platform and is integrated into a SAP Cloud Launchpad. During the build process (`mbt build`), the app is compressed into a zip file. During the deployment (`cf deploy`), the HTML5 app is pushed to the HTML5 Application Repository and uses the Authentication & Authorization service (XSUAA service) and the destination service.
10+
This is an example of an HTML5 app that is accessed by a managed application router and is integrated into the SAP Launchpad service. During the build process (`mbt build`), the app is compressed into a zip file. During the deployment (`cf deploy`), the HTML5 app is pushed to the HTML5 Application Repository and uses the Authentication & Authorization service (XSUAA service) and the destination service.
1111

1212
## Download and Deployment
13-
1. Subscribe to the [launchpad service](https://developers.sap.com/tutorials/cp-portal-cloud-foundry-getting-started.html) if you haven't done so before.
14-
2. Download the source code:
13+
1. Subscribe to the [SAP Launchpad service](https://developers.sap.com/tutorials/cp-portal-cloud-foundry-getting-started.html) if you haven't done so before.
14+
1. Download the source code:
1515
```
1616
git clone https://github.com/SAP-samples/multi-cloud-html5-apps-samples
1717
cd multi-cloud-html5-apps-samples/managed-html5-runtime-basic-mta
1.5 MB
Loading

managed-html5-runtime-fiori-mta/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,6 @@
99
"devDependencies": {
1010
"npm-run-all": "^4.1.5",
1111
"cross-var": "^1.1.0",
12-
"mbt": "^1.0.16"
12+
"mbt": "^1.1.0"
1313
}
1414
}

managed-html5-runtime-fiori-mta/readme.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# SAP Fiori app on HTML5 Runtime Managed by SAP Cloud Platform
1+
# SAP Fiori App with a Managed Application Router
22

33
## Diagram
44

@@ -7,7 +7,7 @@
77

88
## Description
99

10-
This is an example of an SAP Fiori app that is managed by SAP Cloud Platform. The SAP Fiori app is exposed to an SAP Cloud Platform Launchpad and is visible in the content manager of the launchpad. The app is deployed to the HTML5 Application Repository and uses the Authentication & Authorization service (XSUAA service) and the destination service.
10+
This is an example of an SAP Fiori app that is accessed by a managed application router. The SAP Fiori app is exposed to the SAP Launchpad service and is visible in the content manager of the launchpad. The app is deployed to the HTML5 Application Repository and uses the Authentication & Authorization service (XSUAA service) and the destination service.
1111

1212
The web app that is contained in the `uimodule.zip` defines the following properties in the `manifest.json` file. Otherwise, the correspoding values in the `mta.yaml` descriptor need to be updated as well.
1313

Loading

standalone-approuter-html5-local-dir/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"name": "appouter",
33
"description": "Node.js based application router service for html5-apps",
44
"dependencies": {
5-
"@sap/approuter": "^8.5.0"
5+
"@sap/approuter": "^9.1.0"
66
},
77
"scripts": {
88
"start": "node node_modules/@sap/approuter/approuter.js"

standalone-approuter-html5-local-dir/readme.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@
66

77
## Description
88

9-
This is an example of an HTML5 app that you maintain on a standalone application router in your own space. The app is directly embedded into your subaccount on the Cloud Foundry environment. That means the static content of the is not stored and managed in the HTML5 Application Repository of SAP Cloud Platform.
9+
This is an example of an HTML5 app that you maintain on a standalone application router in your own space. The app is directly embedded into your subaccount on the Cloud Foundry environment. That means the static content of the is **not** stored and managed in the HTML5 Application Repository of SAP BTP.
1010

1111

1212
## Download and Installation

0 commit comments

Comments
 (0)