Remote configuration of the mobile application profile

Applies to version: 2016.1.x; Author: Jacek Język

To begin using the WEBCON BPS application for the mobile, users are required to correctly configure the profile connecting them with the server. The profile can be created manually by the user based on the known server address, domain name, and login credentials.

 

 

The profile configuration can also be prepared in advance by the system administrator and then given to the specific user in the form of a BPSX file. In this case, all that the user has to do is download it onto their device and launch it. The application is ready to work as soon as the profile is configured.

---

 

BPSX file structure

The BPSX file has an XML format and identifies all the necessary profile parameters.

 

PARAMETER NAME	COMMENT
Name	Profile name. When opening the BPSX file, and a profile with an identical name already exists on the mobile device, the user will be asked to choose: To update the current profile with the new settings Leave the existing profile unchanged
Address	Server address.
Domain	User domain name.
User	User login.
Password	User password. It’s important to note that it is stored in the BPSX file openly. This parameter can be left empty, which means that the user will have to input the password personally during log-in.
Language	Profile language. Available options: pl-PL en-US es-ES
AutoLogin	Specifies if the application saves the profile password. If the <Password> parameter was not entered, the user will have to enter a valid password. Subsequent log-ins will not require entering the password. Available options: true – save profile password false – don’t save the profile password, user will have to enter the password on each log-in
UsePush	Specifies if the application uses the PUSH notifications. Available options: true – use PUSH notifications false – don’t use the PUSH notifications
ExternalLogin	Specifies if the application uses the external authentication. Available options: true – use external authentication false – don’t use the external authentication, application uses <Domain>, <User> and <Password> parameters on connection with the server

 

Here is a sample BPSX file. It contains the DEMONSTRATION profile definition which works in the context of the t.green user in the TRIAL domain. The parameter <Password> is not filled which means that the user will have to enter the password when logging in.
<?xml version=”1.0″ encoding=”utf-8″ standalone=”yes”?>

<Profile>

    <Name>DEMONSTRATION</Name>

    <Address>http://mobile.webcon.com/bps2/</Address>

    <Domain>TRIAL</Domain>

    <User>t.green</User>

    <Password></Password>

    <Language>en-EN</Language>

    <AutoLogin>false</AutoLogin>

    <UsePush>false</UsePush>

    <ExternalLogin>false</ExternalLogin>

</Profile>

---

 

Running a BPSX file on a mobile device

The file prepared as shown above should be saved as a .BPSX file (i.e.: Profile.BPSX) and then sent to the appropriate user.

The easiest way to deliver the file is to send it as an e-mail attachment.

After receiving the e-mail the user has to save the attachment.

 

Launch the saved file by clicking on it in the download notification window.

 

The WEBCON BPS application should now automatically launch and confirm the creation of the profile with a message.

 

To log onto the new profile, switch to it in the log-in window.

---