HTML5 Application Registrations

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.

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'.

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

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

In the Members section, click 'Add Members'

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

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'

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

Follow the same procedure as above for 'sfdocumentsearch.zip'.

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

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

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/btp/sap-btp-neo-environment/regions-and-hosts-available-for-neo-environment

account = the ID of your BTP Sub Account

application = 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 = 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

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:

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

For the next step, return to the BTP Cockpit and navigate to the BTP Sub Account -> Applications -> HTML5 Applications and click the sfdocumentsearch application

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



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

Next, register the second HTML5 application sfmydocuments. Return to the BTP Cockpit and navigate to the BTP Sub Account -> Applications -> HTML5 Applications and click the sfmydocuments application

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

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