App Setings

The Application Settings panel lets you control how your app behaves and who can access it. It allows you to configure the app’s entry flow and manage user permissions all in one place.

How to Access the Settings #

On the main screen of your Engini’s App, you can find the setting button on the top bar.

Click on the settings menu the next popup window will appear.

App Button Color #

This option lets you choose the color of your application’s tile as it appears on the main Apps page.

Changing this color helps visually distinguish your app from others apps and makes it easier for users to identify it quickly.

Home Screen #

The Home Screen option lets you choose which screen the user will see first when opening the app. You simply select one of your existing screens from the list, and that screen becomes the app’s starting point.

Platform support #

The Platform Support setting defines the target environment where your app or feature will be accessible and optimized. This configuration ensures that the layout, navigation, and functionality adapt correctly to the user’s hardware.

1. Both (Default)
   This is the standard setting that allows the application to work on both computers and mobile devices. The layout automatically adjusts to fit any screen size, ensuring a smooth experience whether the user is on a laptop or a smartphone.
2. Desktop
   This setting restricts access exclusively to desktop and laptop computers. The application is optimized for large screens and mouse input. If a user tries to log in from a mobile device, they will see an error message stating that the platform is not supported.

3. Mobile
   This setting restricts access exclusively to mobile devices such as smartphones and tablets. The interface is designed specifically for touch interactions. If a user attempts to access the application from a computer, they will be blocked by an error message.

4. Unified Mobile
   This setting forces a consistent mobile-first view across all devices. Unlike the other options, the application will always display the mobile user interface even when it is accessed on a desktop computer. This ensures that every user sees the exact same mobile optimized layout regardless of their hardware.

Authenticated Users #

This setting controls which logged-in users are authorized to access the application. When this option is enabled, you can define the scope of access by choosing between Public or Private visibility and share the application directly using the Copy Link button.

• Public
  Selecting Public grants access to all authenticated users within your organization or environment. Any user who has a valid login and the application link will be able to open and interact with the app.
• Private
  Selecting Private restricts access to a specific subset of users. Even if a user is logged in, they will only be able to access the application if they have been explicitly granted permission or assigned to a required role. This provides an additional layer of security for sensitive internal tools.

Anonymous Users #

When this option is enabled, the application can be accessed by anyone. By using the anonymous user link, the app is publicly available and no sign-in to Engini is required.

Session Variables #

Session Variable is a temporary value that the app stores only for the current user session. This means the variable exists while the user is using the app.

• Press on Add Variable button and choose a Name and the Type of the variable:
  1. Name
     Customize the name to describe the field’s purpose.
  2. Type
     Click on the “Type” button and the tooltip will popup showing the field’s types you can use.
  3. Variable Saved
     Press the V Button to save the variable.
• Note: You can use these variables in filters within the app’s properties section and in business rules.

Session Variable Use Case #

This guide explains how the Phone and ValidUntil session variables store the user’s details during the session. When the user enters a phone number and clicks the Login button, the system verifies the number, updates the session, and allows anonymous access for the next 8 hours.

1. Session Variables
   We created 2 session variables- Phone, ValidUntil. These variables hold the user’s details for the duration of their session.

Note: The values are stored only for the current session and reset automatically when the app is closed or refreshed.

2. Entering a Phone Number on the Screen
   
   Clicking on “כניסה” button – it will activate a business rule.
3. Business Rule
   Once the user clicks the Login button on the screen, a business rule is triggered.
   
4. Get Records
   We check whether this phone number exists in our system (in the table).

• If yes
  • Update session variables
    
    This action updates the phone number in the session and sets the ValidUntil value to 8 hours from now, allowing the user to access the app without logging in during that period.
  • Open Form
    
    The user is navigated directly to the delivery documents screen.
• If No, we are displaying error message to the user.