---
title: HTML5 Application Registrations
slug: docuflow-guides/cac8-html5-application-registrations
docTags: 
createdAt: 2022-11-17T16:57:10.000Z
---

This section will demonstrate how install the HTML5 applications into the BTP Sub Account that has been integrated into the SuccessFactors system in the previous section.

### SAP Web IDE Full-Stack Service

If not already enabled, SAP Web IDE Full-Stack Service must be enabled in the sub account.

To enable this, in the sub account navigate to 'Services' and then select the tile/option 'SAP Web IDE Full-Stack' and then click '**Enable**'.

### Security Permissions

**NOTE:** This section will require the BTP Command Line Interface (CLI). If you do not have this installed please see the sub section ***'BTP Command Line Interface'***

First, Permissions must be given to allow configuration of the BTP Sub Account.and Web Applcations.

To Enable security for the Web Applications, navigate to **Security->Authorizations**

- Enter the S User ID and click 'Show Assignments'
- Click 'Assign' and then select
  - Subaccount 'SAP Web IDE xxx'
  - Application: di
  - Role: DiAdministrator
- Click 'Assign' and then select:
  - Subaccount 'SAP Web IDE xxx'
  - Application: featurediscovery
  - Role: DevXAdministrator

Next, Navigate to the ***'Members'*** section of the BTP Sub Account

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/T8djBDH8ltgoTNfn6z1Qv_image.png" size="22" width="1300" height="3195" position="flex-start" showCaption="false"}

In the Members section, click ***'Add Members'***

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/8PS9cJWzCSATX6Thm7BOA_image.png" size="36" width="1300" height="391" position="flex-start" showCaption="false"}

Enter the ***User id*** and select the permissions you want this user account to have the BTP Sub Account.

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/Ngzz-q2O0pCqKmxzfCpU0_image.png" size="50" width="1300" height="842" position="flex-start" showCaption="false"}

Next, upload the HTML5 Applications to the BTP Sub Account. These applications are supplied in a .zip format.

Navigate to ***Applications->HTML5 Applications*** in the BTP Sub Account and click ***'Import from File'***

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/dE2KVC0kpC4PTdRu1pmTG_image.png" size="78" width="1300" height="408" position="flex-start" showCaption="false"}

In the dialog, select the ***'sfmydocuments.zip'***, enter the version number 1 and click 'Import'

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/UQ6J2-T7yKf4kenZApARX_image.png" size="34" width="1300" height="1123" position="flex-start" showCaption="false"}

Follow the same procedure as above for ***'sfdocumentsearch.zip'***.&#x20;

Once completed the applications should be listed in the HTML5 Applications screen.

### Enable Application Access

**NOTE:** This next step required the BTP Command Line Interface (CLI). If you do not have this toolset installed, see the sub topic ***'BTP Command Line Interface (CLI)'***

**NOTE:** The following examples are shown on windows but can be adapted for any other command line/shell

Open a Command Prompt/Shell and navigate to the ***'Tools'*** directory of the BTP Tools installation

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/888v63cc24FuOST-QaIsN_image.png" size="58" width="1300" height="836" position="flex-start" showCaption="false"}

Setup a properties file (e.g. ***config.properties***) with the information that will be required for the connection. This will make the process easier.

***NOTE: For a list of BTP Host values/locations:*** [](https://help.sap.com/docs/SAP_Web_IDE/825270ffffe74d9f988a0f0066ad59f0/975b3207acf94599a9a48beb36257ebc.html)

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/_yTfqPw65uM3NNEI3T4py_image.png" size="60" width="1300" height="721" position="flex-start" showCaption="false"}

**account** = the ID of your BTP Sub Account

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/6M9gnBVbOHtzLzMZZxVnp_image.png" size="40" width="1300" height="818" position="center" showCaption="false"}

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/Y7KypKvudkr5bxkO9bsNc_image.png" size="40" width="1300" height="1285" position="center" showCaption="false"}

**application&#x20;**= name of the application be registered. This process will be done twice, once for sfdocumentsearch and once for sfmydocuments. Note: use one of these values, run the command below, then alter this value and run the command again.

**user&#x20;**= your SAP User Account. If you have a SAP Universal ID you will want to specify your S-ID, otherwise you can use the email associated with your S-ID

With the Command Prompt BTP CLI tools, execute the following command (use your properties file name)

***neo.bat hcmcloud-enable-application-access config.properties***

NOTE: if you are not using the properites file method, the full command would be:

`neo hcmcloud-enable-application-access --application <my_application> --application-type java --account <my_extension_subaccount> --user <user id> --host us1.hana.ondemand.com`

Next, modify the config.properties file so that **application=sfmydocuments** to allow registration of the **sfmydocuments** application

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/reZLWJl_TZs99aTgg6Ic6_image.png" size="60" width="1300" height="680" position="flex-start" showCaption="false"}

With the Command Prompt BTP CLI tools, execute the following command (use your properties file name)
**neo.bat hcmcloud-enable-application-access config.properties**

After registration example:

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/KdTyfa4TqE107DZ-0azy3_image.png" size="80" width="1300" height="1060" position="flex-start" showCaption="false"}

### Register oData Connection

Finally, using the CLI register an oData connection (only one required for both applications)

Edit the **config.properties** file and comment out the application and:

Edit out the application application type properties:

`#application=sfdocumentsearch`

`#application-type=html5`

Add a new value for the name of the connection:

**name=sfapps\_odata**

***Neo.bat hcmcloud-create-connection config.properties***

### Set oData Connection in HTML5 Applications

For the next step, return to the **BTP Cockpit** and navigate to the ***BTP Sub Account -> Applications -> HTML5 Applications&#x20;***&#x61;nd click the sfdocumentsearch application

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/nWvPVr2pD239TkAjUWrtr_image.png" size="78" width="1300" height="586" position="flex-start" showCaption="false"}

Under **'Required Destinations'** set the **'Mapped Subaccount Destination'**

![](https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/FLzT-8yDYROJxH3veVNXR_image.png)



Next, Click the **'Versioning'** section, under **'History'** section select the **'Versions'** and set the **'Mapped Subaccount Destination'**

![](https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/plkDx73goIkczsDrqFTiZ_image.png)

Next, register the second HTML5 application sfmydocuments. Return to the **BTP Cockpit** and navigate to the ***BTP Sub Account -> Applications -> HTML5 Applications&#x20;***&#x61;nd click the **sfmydocuments&#x20;**&#x61;pplication

::Image[]{src="https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/j-tAua8FqivBZeXqH2Obx_image.png" size="78" width="1300" height="613" position="flex-start" showCaption="false"}

Under **'Required Destinations'** set the **'Mapped Subaccount Destination'**

![](https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/nsrqzDlN0mOSiJaHW9_xp_image.png)

Next, Click the **'Versioning'** section, under **'History'** section select the **'Versions'** and set the **'Mapped Subaccount Destination'**

![](https://api.archbee.com/api/optimize/1hH4CNQG9tP4YS-TB-TC6/RQUZQvPn1eMsnWaoiY5FP_image.png)

