Unit 6: Building Applications¶
After asset onboarding and data configuration, you can build application menus to define how the application functions are combined and visually presented. Application menus can come from the following sources:
For generic menus, you can reuse the menus of EnOS Industry Application Common Building Blocks (CBBs). For example, reuse the Asset Map menu of Unified Monitoring to monitor asset status, and reuse the alarm-related menus of Alarm Management for configuring alarm rules, viewing alarms, and other scenarios.
For menus with customized needs, you can use Digital Twin Visualization to configure custom menus.
Before You Start¶
Before start, ensure the following items:
Application creators, asset administrators, and system administrators have been assigned the required permissions. If not, contact the application administrator.
Asset administrators have decided the alarm trigger conditions, levels, types and content for the application. For example, when the temperature of battery cells is higher than the threshold value, an alarm is triggered; the generated alarm is of the “Info”, “Warning” or “Fault” level; the alarm type is “Status Alarm”; the alarm content is “battery cell temperature is too high”.
Task 2: Creating Applications¶
With the generic and custom menus provided by CBBs, you can combine and configure the application menus according to actual needs to quickly reuse the common capabilities that EnOS has consolidated from industry practices.
Procedure ¶
There are two ways to create an application.
Registering an application in EnOS Management Console.
Creating an application shortcut in EnOS Application Portal.
Registering Applications¶
Performed By |
Performed In |
---|---|
Application Creator |
EnOS Management Console |
Log in to EnOS Management Console and select Application Registration in the left navigation bar.
Select the Apps of This OU tab and choose Create Application.
Fill in the basic information of the application and select Confirm.
In the Apps of This OU tab, select the application created in the previous step.
Select the Menu tab and choose Create Menu. Create all menus in order as needed.
For the menus reused from CBBs, fill in URL with the URL of the corresponding CBB. For the URL of each CBB menu, contact the system administrator.
For the menu customized using Digital Twin Visualization, fill in URL with the URL of the page copied in the previous task.
(Optional) If you need to use the Alarm Statistics menu of Alarm Management, contact the system administrator to obtain the page template of the menu and import the template in Digital Twin Visualization. For how to import templates, see Importing Page Templates.
Creating Application Shortcuts¶
Performed By |
Performed In |
---|---|
Application Creator |
EnOS Application Portal |
Log in to EnOS Application Portal and select Admin Console > Application Management.
In the application list, find any CBB whose menu you want to reuse, hover over the corresponding ellipsis (…) and select New Shortcut.
On the Shortcut Details page, select Edit. In the pop-up window, fill in the basic information as required and select Submit.
Select Add Menus > Add from other applications. Select the CBB you want to use in the pop-up window, check the menu you want to reuse and select Submit.
Follow the previous step to add all the CBB menus that need to be reused in turn.
(Optional) If you want to change the menu name, select Edit of the target menu under Added Menus. Change the menu name as needed in the pop-up window.
(Optional) If you want to create a top-level menu, select Add Menus > Add top-level menu and fill in the menu information as required.
Select Sort, sort and restructure all menus by dragging and dropping them in the pop-up window, and select Submit.
(Optional) If you need to use the Alarm Statistics menu of Alarm Management, contact the system administrator to obtain the page template of the menu and import the template in Digital Twin Visualization. For how to import templates, see Importing Page Templates.
Results¶
After application administrators assign application permissions, authorized users can access the created application in EnOS Application Portal, which displays all configured menus in order.
(Optional) Task 4: Configuring Alarms¶
If the application uses the alarm-related capabilities provided by Alarm Management, you need to configure alarm rules according to the actual scenario to define how alarms are triggered in the application.
Procedure¶
Configure alarm severities, types, and rules by the following steps.
Creating Alert Severities and Alert Types¶
Performed By |
Performed In |
---|---|
Asset Administrator |
EnOS Management Console |
Select Alert Engine > Alert Severity from the left navigation pane of EnOS Management Console.
Select New Severity. Enter the ID and description of the severity in the pop-up window and select Confirm.
Select Alert Types from the left navigation pane and select New Type. Enter the ID and description of the type in the pop-up window and select Confirm.
Contact the system administrator to configure alarm groups to define the domains where alarm severities and types can be configured, the device types that can generate alarms, and the alarm severities and types that can be selected when you configure alarm rules.
Configuring Alarm Rules¶
Performed By |
Performed In |
---|---|
Asset Administrator |
EnOS Application Portal |
Select Alarm Management from the application list of Application Portal and select Alarm Rules from the left navigation pane.
Select New Rule to create alarm rules in different alarm severities where:
Alarm Group: Select the domains defined in Creating Alert Severities and Types.
Alarm Severity: Select the severities created in Creating Alert Severities and Types.
Alarm Type: Select the types created in Creating Alert Severities and Types.
Provide the system administrator with the environment information and OU ID to apply for the “Configuring Alarm Data Subscription” and “Enabling Alarm Message Monitoring” services, so that the alerts generated in Alert Engine will be automatically synchronized to the alarm list in Alarm Management.
(Optional) If you want to configure email, SMS, or pop-up notifications for alarms, select Alarm Notification from the left navigation pane, select New Notification, and configure alarm notification rules as required. For more information, see Managing Alarm Notification Rules.
Select Alarm Response from the left navigation pane, select New Response Configuration > Acknowledge Response / Ticket Response, and configure alarm response rules as required. For more information, see Managing Alarm Response Rules.
(Optional) If you want to customize the fields in the alarm list, select Alarm Config from the left navigation pane, select New Configuration on the Field Configuration tab, and configure the fields in the alarm list as required. For more information, see Creating a Field Configuration Rule.
Results¶
The application generates alarms in different severities when the alarm rules are triggered, and sends notifications to relevant users based on configurations.
(Optional) Task 5: Configuring Control Rules¶
If the application needs the remote control capability provided by Fleet Control, application creators need to contact the system administrator to configure control rules. After configuration, the control panel is displayed in the corresponding menus to issue control commands.
(Optional) Task 6: Configuring Data Quality Rules¶
Performed By |
Performed In |
---|---|
Asset Administrator |
EnOS Application Portal |
If the application needs the data assessment capabilities provided by Data Quality, you need to configure data quality rules to define how to assess data according to actual scenarios.
Procedure¶
Select Data Quality from the application list in EnOS Application Portal.
(Optional) Select Configuration Management > System Configuration from the left navigation pane, select New on the Quality Dimension Table tab, and configure information such as models and attributes as required. For more information, see Creating a Quality Dimension Table.
Select Assessment > Assessment Rules from the left navigation pane, select New Monitoring Group, and configure data source and monitoring objects as required. For more information, see Creating Monitoring Groups and Monitoring Objects.
Select Configure Rule on the Assessment Rules page, select New Rule on the Rule Configuration page, and configure quality assessment rules for selected monitoring objects as required. For more information, see Configuring Quality Assessment Rules.
Results¶
After configuration, the application assess the data according to the defined quality assessment rules.
(Optional) Task 7: Configuring Work Management Forms¶
Performed By |
Performed In |
---|---|
Application Creator |
EnOS Application Portal |
If the application requires the work order and service request management capabilities provided by Work Management and the default form fields of work orders and service requests are unable to meet the needs, you can customize the form fields.
Procedure¶
Download and fill out the
Form Configuration Template
. You can modify the existing fields, add new fields or configure different fields for different types of work orders in the template.Select Work Management from the application list in EnOS Application Portal.
Select Settings > Custom Fields from the left navigation pane.
Select Default Form Field Configuration and upload the completed template file.
(Optional) If you want to customize field permissions, configure field permissions for different workflow nodes by the following steps.
Select Field Permission Configuration and select Download Configuration File.
The first workbook of the configuration file displays the fields currently in use, and the second workbook displays all fields available. Add or delete the fields in the first workbook as required.
Upload the modified configuration file.
Results¶
After configuration, the forms in the related work management menus display the fields as configured.
(Optional) Task 8: Configuring Report Templates¶
Performed By |
Performed In |
---|---|
Application Creator |
EnOS Application Portal |
If the application needs the report customization and management capabilities provided by Reporting Tool, you can configure report templates as required to display data in the form of charts, tables, and texts.
Procedure¶
Select Reporting Tool from the application list in EnOS Application Portal.
Select Report Templates from the left navigation pane and create a new template by the following ways:
If you want to use an existing BIRT template, upload the report template. For more information, see Uploading a Custom Report Template.
If there is no existing template, use the online editor to design a template. For more information, see Creating a Custom Report Template.
Results¶
After configuration, the application can generate reports and display data based on the uploaded or created templates.