Unit 2: Creating an Application¶
Operator |
Location |
|---|---|
Application builder |
EnOS Application Portal > Developer Console, EnOS Application Portal administration console |
This unit explains how application builders use the acquired Unified Monitoring component to create a visualized monitoring application in EnOS that meets their business needs.
Prerequisites¶
Before you begin, make sure that your account has been assigned permission to access the Application Registration and Service Account menus in EnOS Application Portal > Developer Console. If it has not, contact the system administrator.
Step 1: Registering an Application¶
Sign in to EnOS Application Portal > Developer Console and select Application Registration from the left navigation pane.
On the Organization Applications tab, select Create Application.
On the application creation page, enter the following information.
Field
Description
Application name
Enter Smart Monitoring.
Identifier
Enter monitor.
Application URL
Customize the URL of the application. This can be left empty.
Application category
Select an application category, such as General.
Application type
Select web to indicate that the application runs on the web.
Description
Describe the functions of the application, for example, Intelligent monitoring of multi-domain assets.
Select OK.
After completing the preceding steps, application builders can see the application named Smart Monitoring, along with basic information such as its Access Key, category, and type, on the Application Registration > Organization Applications tab.
Step 3: Creating Permission Points¶
Permission points determine whether users can perform specific operations in an application. On Landing Pages, users need the corresponding permission points to:
Configure the features of a Landing Page
Manage the components on a page
Manage Landing Page templates
Control related devices or sites
Therefore, application builders need to add the corresponding permission points to the application as follows:
On the Application Registration > Organization Applications tab, select the Smart Monitoring application card to open the application details page.
On the Permission Point Management tab of the application details page, select Create Permission Point.
In the pop-up window, enter the following information.
Field
Description
Name
Enter a permission-point name, for example,
Configure Page Features.Identifier
Enter
monitor_ou_template.Description
Describe the functions of the permission point, for example,
Access permission for the feature configuration page.Note
Application builders can customize permission-point names and descriptions, but the permission-point identifiers must be consistent with the identifiers given in this tutorial.
Select OK.
Repeat the preceding steps to configure the following permission points for the Smart Monitoring application.
Name
Identifier
Description
Edit Components
dtv_edit
Edits the DTV components displayed on the current Landing Page.
Manage Components and Templates
dtv_ou_edit
Edits the DTV components displayed on the current Landing Page. Manages Landing Page templates.
Control Assets
control_execute
Controls device and site assets.
For these permission points:
Users with the Configure Page Features permission can select Function Configurations
in the upper-right corner of the page and configure the features on the page.
Users with the Edit Components permission can select Edit Page
in the upper-right corner of the page to add, delete, configure, or move the components on the current page.
Users with the Manage Components and Templates permission can select Templates in the upper-left corner of the page to manage the templates of Landing Pages.
Users with the Control Assets permission can select Control in the upper-right corner of the page to control the assets on the page.
Note
The control panel needs to be configured in the Fleet Control component in advance.
Step 4: Authorizing the Service Account¶
EnOS controls the resources that an application can access by assigning policies to the application. To ensure that the Smart Monitoring application can retrieve data such as the attributes, measurement points, and metrics of assets in the OU, assign the corresponding policy to the Smart Monitoring application as follows:
From the left navigation pane of EnOS Application Portal > Developer Console, select Identity and Authorization > Service Account.
Select Authorize
for the Smart Monitoring application to open the authorization page.On the Policy List tab, select Add Policy Permission.
In the pop-up window, select the plus icon of the administrator predefined permission and select Save to assign this permission to the Smart Monitoring application.
After completing the preceding steps, the Smart Monitoring application can retrieve data such as the attributes, measurement points, and metrics of assets in the OU. For more information about service account authorization, see Obtain an SA Account.
Step 5: Enabling the Application¶
Applications created or acquired in EnOS Application Portal > Developer Console are automatically synchronized to the application management page in the EnOS Application Portal administration console. Enable the Smart Monitoring application through the following steps and display the application in the left navigation pane of Application Portal for later access:
Sign in to EnOS Application Portal and select Administration Console
.In the left navigation pane of the administration console, select Application Management.
Hover over the ellipsis icon (…) of the Smart Monitoring application and select Manage.
In the Application Settings section, select the Enable Application and Display this application in the navigation pane check boxes.
After completing the preceding steps, users with access permission can select and access Smart Monitoring from the left navigation pane of Application Portal. For more information about enabling and displaying applications in Application Portal, see Manage Applications.
Step 6: Assigning Access Permissions¶
Contact the OU administrator to assign the required permissions to the current account, so that the account can access the menus in the Smart Monitoring application and view the relevant assets and asset data. Also, to ensure that the current account can configure Smart Monitoring pages, contact the OU administrator to assign the following permission points to the account.
Permission point |
Required or optional |
Description |
|---|---|---|
Configure Page Features |
Required |
Ensures that the current account can configure the page features. |
Manage Components and Templates |
Required |
Ensures that the current account can edit the DTV components displayed on the page and manage the page templates. |
Edit Components |
Optional |
Ensures that the current account can edit the DTV components displayed on the page. If the Manage Components and Templates permission point has been assigned, this permission point does not need to be assigned to the current account. |
Control Assets |
Optional |
Ensures that the current account can control assets on the page. |