What’s New?

This section describes the new services and features in this release.

API

For details of updated APIs, log into the EnOS Console and click EnOS API > Release Notes from the navigation menu.

Model Service

API Description
Search Thing Model A new parameter dataDefinition is supported in ThingAttribute struct, ThingMeasurepoint struct, and ThingDatapoint struct to define the data type represented by the datatype parameter in the structure.

Alert Service

API Description
Create Alert Type A new parameter parentTypeId is supported in generateType struct to indicate the alert type ID of the parent alert.
Update Alert Type A new parameter parentTypeId is supported in generateType struct to indicate the alert type ID of the parent alert.

Application Portal Service

API Description
Authorize Asset Authorize the new asset created on EnOS platform to the asset creator
Check Asset Permission Check if the current user has the access permission of the requested asset
Choose Organization Select the organization that the user needs to use after login
Create Message Create common messages and alert message on the Application Portal
Get App Menu and Permission Get the list of application menu and permission
Get Assets by Application Get all assets that the current user can access under a specified application
Get Assets by Organization Get all the assets that a specified user can access under a specified organization
Get Asset Structure Get the upstream organizational structure of the organizational structure in which the asset is located
Get Colors of the Message Icon Get the collection of colors that the message icon can be configured
Get Manageable User List Get a list of all users that can be managed under the current account
Get Message Ringtones Get the collection of ringtones that the message can be configured
Get Organization List List the organizations which the current user belongs according to the Access Token
Get Organization User List Authorize the application to get a list of all users under a specified organization without logging in the Application Portal
Get Token Information Get information about the currently logged-in user according to the Access Token
Get User Information Get the information of the current user
Log In Log in the account
Log Out Log out the account
Refresh Access Token Request a new Access Token with the Refresh Token
Revoke Refresh Token Revoke user’s Refresh Token
Sync Asset Synchronize assets with specified tags on the EnOS to the Application Portal
Update Message Update the status of the message

Common Resource

We added support of data archiving resource management and archiving real-time alert records. Details are as follows:

Resource Management

In this release, we added support of requesting data archiving resource, which is compatible with the enhancement to Data Archiving. Before configuring data archiving jobs, you need to request data archiving resource based on your business needs. The following resource specifications are available:

  • Standard: Able to archive 5,000 points/second
  • Standard X 2: Able to archive 10,000 points/second
  • Standard X 4: Able to archive 20,000 points/second
  • Standard X 8: Able to archive 40,000 points/second

For more information, see Resource Management on EnOS.

Data Archiving

In this release, we added support of archiving real-time alert records, which is featured by:

  • Support of archiving both history alert records and active alerts
  • Support of archiving specified fields in alert records

For more information, see Archiving Data.

EnOS Edge

API

Added the following new APIs:

  • Get Asset
  • Set Measurement Point

Edge Management

The following enhancements are made to enhance user experience:

  • Supports exporting the data report of collection points in .xlsx in Test Connection .
  • Supports automatically calculating offset value for devices under a connection in Access Management .
  • Supports viewing and recording logs of and above logging level Debug (including debug, info, warning, error, and fatal) in Log tab in Test Connection .

Edge Computing

Added the following options for General Destination operator so that data can be imported into the following destinations:

  • To Other Pipeline
  • To Realtime
  • To EnOS
  • To Alarm
../_images/stream_analytics.gif

HMI

Supports deploying the graph pages created by HMI tools onto EnOS Edge. Users can use their EnOS accounts with proper access to log in to App Portal to view the graph pages deployed on EnOS Edge. For more information, see About EnOS Graph Editor

Device Connection

Device Asset

  • Supports searching for device asset by tag. A tag consists of a key and value in the form of Key : Value :
    • Supports searching with multiple tags. The relation between tags is OR. For example, if you search with two tags, Key1 : Value1 , Key2 : Value2, you are searching for devices with either Key1 : Value1 or Key2 : Value2 or both.
    • If you search with a tag whose value is left blank, all tags of the tag key you entered will be displayed as results. For example, if you search with Key3:(Value left blank), you are searching all tags with the key being Key3.
../_images/tag_searching.gif
  • Supports redirecting to Asset Tree by clicking view_asset_tree in the Operations column.

Model

  • Supports searching for model elements by identifier.
  • Supports internationalization settings for the value description of an enum variable.

Data Asset Management

We added support of StreamSets Calculator Library V0.0.4, Data Catalog, and stream processing templates for electric energy calculation by power. Details are as follows:

StreamSets Calculator

In this release, we added support of StreamSets Calculator Library V0.0.4. The calculators for asset information query, data processing, data quality tagging, and electric energy calculation are updated with new functions and configurations. You can leverage the new calculator library to develop customized and advanced stream data processing jobs to meet the requirements of various business scenarios. For more information, see Calculator Library 0.0.4 Documentation.

Data Catalog

We added support of the Data Catalog offering, for querying and managing the metadata information of data assets in your OU. You can quickly query the metadata of measuring points, assets, Hive tables, and services. Tag templates are provided for tagging data assets, thus improving the efficiency of data asset management.

../_images/data_catalog.gif

For more information, see Data Catalog.

Templates for Electric Energy Calculation

In this release, we added support of 2 stream processing templates for electric energy calculation by instant power and average power. If the power value in a specific time interval is relatively stable, use the Electric Energy Calculation by Instant Power template; if the power value in a time interval is not stable, use the Electric Energy Calculation by Average Power template. For more information, see Configuring an Electric Energy Calculation Job.

Data Analytics

In this release, we added support of Algorithm Model Hosting. Details are as follows:

Algorithm Model Hosting

We added support of the Algorithm Model Hosting offering for quick deployment of “predictive” machine learning algorithm models, which is featured by:

  • Algorithm model source files are stored and managed in GitLab projects, achieving version control of source files.
  • Algorithm models can be deployed in multiple running environments, including Python 2.7, Python 3.6, and R 3.6.
  • When a model is deployed successfully, the service will be automatically initialized and hosted on EnOS APIM.
  • When a model is deployed, you can debug the service quickly by calling the service within the product interface.

The workflow of hosting algorithm models is shown as follows:

../_images/model_deployment_workflow.png

The following figure shows the steps of deploying an algorithm model:

../_images/deploying_model.gif

The following figure shows the steps of debugging the service that is hosted after the algorithm model is deployed:

../_images/debugging_model.gif

For more information, see Algorithm Model Hosting.

Application Enablement

API Management

  • Provide Get Started document to help user quickly create, deploy, and publish API to customers through API Management. Refer to Get Started.
  • Statistics is newly supported in API Monitor. You can view the API request number and the invoking delay in the latest hour, the current day, and the current week. Refer to Monitoring APIs.

Application Portal

In this release, we added support of security settings, API authorization for applications, customized operation button for messages, and language settings. Details are as follows:

Security Settings

Based on security requirement, system administrator can configure password rules for all internal account users when they set or reset account password. The following password rules can effectively protect user account security:

  • Required combinations
  • Password length
  • Retry times
  • Reuse cycle

Based on security requirement, the system administrator can configure the login security of all users. The following login rules can effectively protect user account login security:

  • Enable or disable multiple login sessions
  • Login session expiring time
  • White list and black list of login IPs
../_images/app_portal_security.gif

For more information, see Security Settings.

API Authorization

Based on business needs, the OU administrator can set whether to authorize applications to access user information and asset data of the OU through API authorization.

  • User information: User name, email, name, and phone number
  • Asset data: asset ID and asset name
../_images/app_api_authorization.png

For more information, see API Authorization for Applications.

Customized Operation to Messages

Application developers can customize the operation button for messages. With the operation button enabled by the application developer, applications send messages to the message center of Application Portal, the customized operation button will be displayed beside the summary of messages. When users click the operation button, the message will be removed from the message center of Application Portal.

../_images/app_portal_message_center.png

For more information, see Managing Application Messages.

Language Settings

Based on the needs of users, the OU administrator can set whether to enable multiple language UI of Application Portal. With single language UI set, users cannot switch languages when using Application Portal. With multiple language UI set, users can switch languages in the user profile menu.

../_images/app_portal_language.png

For more information, see OU Settings.