Let’s say there is a very simple login screen with an input field for the name and a button to submit.
The button should not be responsive, as long as the login field is empty. This can be achieved with the UI Action in the Process Designer.
At first, the Event Button Press on the Login Mask is assigned to the Login Activity.
The Mobile Action element enables you to use mobile features within the application.
Drag and drop the activity ‘Mobile Action’ underneath Action into the drawing area.
Currently, there are 15 different actions implemented in Simplifier. Use the input/output mapping to define the source for the input (request) and the destination for its output (response).
The mobile actions are grouped into the following categories:
If the background mode is enabled, Simplifier Business Apps will be executed even if the app is running in the background or the display is locked. The Background Mode is enabled per Default – even you don’t use the mobile action explicit.
Default Value: enabled
With this mobile action, your mobile device can switch on/off the camera light.
You can set and lock the screen orientation of the mobile device. Possible values are Landscape, Portrait, Landscape (Primary), Landscape (Secondary), Portrait (Primary), Portrait (Secondary) and Unlock.
This mobile action will trigger a native notification on the mobile operating system (android/ios).
This mobile action will show a native toast, with a constant or by using the input mapping. You can specify the duration how long the toast should be displayed (Short or Long) and the position (Top, Center or Bottom).
Define how many milliseconds the mobile device should vibrate.
Enables devices to read NFC tags.
No input configuration required.
This action allows you to write to NFC tags.
Determine how many pictures should be taken.
Determine how many videos should be taken and set the duration (default 60 seconds).
The mobile action Play Audio just needs an audio file path.
Set the format of the code you want to scan, the orientation of the camera and write a text in the prompt property.
|Parameter||Data Type||Valid Values|
|Meter appearance||String||see table below|
|Number of counts||Integer||1, 2 (from the dropdown)|
|Integer digits||Integer/String||AUTO, 1-n|
|Fraction digits||Integer/String||AUTO, 1-n|
You can choose from the following values for meter appearance:
|mechanical_black||White text on black rollers|
|mechanical_white||Black text on white rollers|
|lcd_edl21||EDL21 and similar meters with LCD 7 (three-digit OBIS code to the left)|
For the output mapping you can use the following parameter:
|image||string||Image of the scanning process as data URL|
|line1||string||Result of scanning the first counter (always set)|
|line2||string||Result of scanning the second counter (only set if 2 counters were scanned)|
|line1ObisCode||string||Result of scanning the first counter’s OBIS code (only set if meter appearance was set to lcd_edl21)|
|line2ObisCode||string||Result of scanning the second counter’s OBIS code (only set meter appearance was set to lcd_edl21 and 2 counters were scanned)|
Text to Speech
With this mobile action, you can specify a text to be read out, as well as the output language. You can choose between English (US) and German (DE).
Speech to Text
With this mobile action, your mobile device converts human speech into text. You can choose between English (US) and German (DE) for the spoken language. Furthermore you can show a prompt with a custom message.
After mapping the according parameters you can decide which port you’d like to connect.
|success||The process will be executed after a successful login or logout.|
|error||The process will be executed after a failed login or logout.|
|already logged in||The process will be executed if the user is already logged in.|
The Server Action needs two parameters as input if you want the user of the application to fill in his username and password.
You can use a Single Sign-on if you want to allow a user to use a single set of login credentials to access multiple applications. In difference to the first login method, you have to map an additional parameter, the authentication.
Therefore you have to add this authentication method to the Simplifier in advance (this will be an admin task – take a look at “Settings for Admins“).
The name that was given to the authentication is the one that is needed as an input parameter.
This is what the input mapping should look like:
Select OAuth as login in the server action and open the mapping dialog.
Within the mapping dialog you have the opportunity to choose between two parameters:
- Service describes the OAuth service provider (e.g. Google, Amazon, Azure…) that expects a string that represents the name of a provider configured in the server settings.
- UserSync expects a Boolean value to switch between the following two possibilities:
- Login via OAuth by synching a user profile (true)
This will synchronize the retrieved information with a Simplifier user (if there is one for the credentials) or create a new user. In both cases, the current login is overwritten and all permissions are revoked.
- Login via OAuth by adding the OAuth token only to the Simplifier token of the current user or app (false)
This does not synchronize the user, but adds the received token to the current user or app profile (if the app is configured to allow anonymous users), retaining all previous logins and associated permissions.
- Login via OAuth by synching a user profile (true)
Within the mapping dialog, you have the opportunity to choose between two parameters:
- Service – must be an existing SAML authentication setting.
- UserSync – should be true if a successful login replaces the primary user login.
The behavior is analogous to the OAuth login.
For the Server Action Logout you don’t have to configure anything additionally.
Use the Server Action Template to address templates.
With the help of parameters, it is possible to pass data to the template.
Don’t forget to map the input and output. The complete template will be returned as a string.
The Server Action can be configured to send e-mails.
Enter the sender and receiver e-mail, optionally CC and Bcc. You can enter multiple e-mail addresses for the receiver, CC and Bcc – in this case, the e-mail addresses have to be separated with a semicolon. At least, enter the subject and the body in HTML. For better user experience, it is possible to maximize the editor.
It is also possible to use the mapping dialog to this instead of using the settings panel.
Important: If a mapping is set, the settings in the panel are not considered.