• Documentation
• Configuring Access Templates

Configuring Access Templates

Groups of devices associated with the same model and with the same collection and control points can use the same template for data connectivity.

Device access templates can be divided into the following types:

• Private template applies to all the scenarios, configuration items including point files, mapping, uploading method & interval, and device timestamps.
• Public template only applies to the scenario when using the Edge mobile app to connect data.

Note

This topic describes how to configure the private template.

Before You Start

• Contact your OU administrator for OU permission. For more information, see Policies, Roles, and Permissions.
• Ensure that the device and model have been created in EnOS Management Console. For more information, see Registering Edge Device Asset.

Step 1: Create a Template

1. Log in to the EnOS Management Console and select EnOS Edge > Templates > Access Templates from the left navigation menu.
2. Choose the following methods to create a template:
   • Method 1: click New Template and fill in the required information in the pop-up window. The Device Type is the type of the sub-device to be connected to the cloud.
   • Method 2: click to copy the existing template and edit the information based on the copied one. This method is suitable for scenarios where two device templates are similar.
3. Click Confirm.

Step 2: Edit Point File

1. Click to download the standard point file (point.xlsx) according to the device protocol.
2. Fill in the point file (point.xlsx) according to the “README” sheet, and then upload the point file.

For the concepts of collection and control points, see Key Concepts.

Step 3: Map the Model Point

In the points mapping list, the system lists all model measurement points according to the model used by the device. The same model measurement point can map both collection and control points. You can choose the following methods to map the collection and control points to the model points.

Method 1: Edit Mapping Online

In the “mapping” column, click and configure collection points or control points in the pop-up window:

• In the Collect tab, click Add Formula and select the formula in the dropdown. See Point Mapping Formulas.
• In the Control tab, the function only supports one-to-one mapping.
  • For AO device points, you cannot set the value. The measurement point value is published directly by the application.
  • For DO device points, you can enter the value in the input box on the right side of the measurement point. Otherwise, it will be replaced by the measurement point value published by the application.

Method 2: Edit Mapping Offline

This method supports mapping the measurement points in various ways.

1. Click Export to export the standard mapping file (mapping.xlsx).
2. Edit the mapping file (mapping.xlsx) locally. In the mapping.xlsx, fill in the collectMapping or controlMapping column according to the following rules:
   • For the EQUAL mapping, fill in the point number of the collection point or control point.
   • For other formula mappings, fill in it according to the Format In Template column of the Points Mapping Formula.
3. Back to this page, click Import to upload the edited mapping file (mapping.xlsx).

Method 3: Auto Mapping

This method only supports measurement points in EQUAL mapping.

1. Open the standard point file (point.xlsx) that you download before.
2. Fill in the measurement point identifier in the Alias column.
3. Upload the edited point file, and then click Auto-mapping.

You can also go to the “Step 1 Edit Point Table” session, click to fill in the Alias online.

Step 3: Configure the Upload Strategy for Model Points

Under the “Step 2: Map Model Point”, click in the model point list to edit the following configuration items.

Data Upload Type

Select the Upload Type, which includes REALTIME, CHANGE, TIMER, NOT_UPLOAD, and CHANGE_TIMER.

Also, you can pre-configure the upload type tag on the model point. For more information of the tags, see Label List of Model Points.

Device Timestamp

The protocol supports OEM timestamp resolution. In the Using OEM Timestamp column:

• Select “YES” to use the OEM timestamp first.
• Select “No” to use the system timestamp by default.

Step 4 (Optional): Edit the Edge Computing Script

You can choose the following methods to update the script for edge computing.

• Method 1: click Create Script under the “Step 3: Calculate Model Point” to edit the script online.
• Method 2: click Export Script to download the standard script. Edit the script offline, and then click the Import Script to upload the edited script.