Schneider Electric EcoStruxure Plant Data Expert User Manual

EcoStruxure Plant Data Expert
User Manual
EIO0000004482.02
04/2022
www.se.com
Legal Information
The Schneider Electric brand and any trademarks of Schneider Electric SE and its
subsidiaries referred to in this guide are the property of Schneider Electric SE or its
subsidiaries. All other brands may be trademarks of their respective owners.
This guide and its content are protected under applicable copyright laws and furnished for
informational use only. No part of this guide may be reproduced or transmitted in any form or
by any means (electronic, mechanical, photocopying, recording, or otherwise), for any
purpose, without the prior written permission of Schneider Electric.
Schneider Electric does not grant any right or license for commercial use of the guide or its
content, except for a non-exclusive and personal license to consult it on an "as is" basis.
Schneider Electric products and equipment should be installed, operated, serviced, and
maintained only by qualified personnel.
As standards, specifications, and designs change from time to time, information contained in
this guide may be subject to change without notice.
To the extent permitted by applicable law, no responsibility or liability is assumed by
Schneider Electric and its subsidiaries for any errors or omissions in the informational
content of this material or consequences arising out of or resulting from the use of the
information contained herein.
As part of a group of responsible, inclusive companies, we are updating our communications
that contain non-inclusive terminology. Until we complete this process, however, our content
may still contain standardized industry terms that may be deemed inappropriate by our
customers.
Table of Contents
Safety Information ....................................................................................................7
About the Book .........................................................................................................9
Cybersecurity .......................................................................................................... 11
Overview ..................................................................................................................14
Installing EcoStruxure Plant Data Expert ............................................................15
Prerequisites .........................................................................................................16
Before Installation ..................................................................................................17
Network Configuration ......................................................................................17
Configuring the Remote Connection...................................................................19
Installing EcoStruxure Plant Data Expert..................................................................20
Installing SQL Server 2019................................................................................20
Installing EcoStruxure Plant Data Expert ............................................................22
Installing AVEVA Edge 2020..............................................................................26
Docker Proxy Settings ......................................................................................27
Completing the Installation ................................................................................30
Licensing ...............................................................................................................31
License Requirements ......................................................................................31
Activating a License..........................................................................................31
Configuring EcoStruxure Plant Data Expert ......................................................32
Prerequisites .........................................................................................................33
Logging In to EcoStruxure Plant Data Expert ............................................................34
Logging In........................................................................................................34
Recovering a Forgotten Password .....................................................................35
Logging Out .....................................................................................................37
User Management..................................................................................................38
Creating Users .................................................................................................38
Modifying Users ...............................................................................................39
Removing Users...............................................................................................39
EcoStruxure Plant Data Expert Settings ...................................................................40
EcoStruxure Plant Data Expert Description.........................................................41
Box Settings.....................................................................................................42
EIO0000004482.02
3
Projects .................................................................................................................46
Creating a Project.............................................................................................46
Modifying a Project ...........................................................................................46
Exporting a Project ...........................................................................................47
Importing a Project ...........................................................................................48
Removing a Project ..........................................................................................48
Data Flow ..............................................................................................................49
Overview .........................................................................................................49
Creating a Custom Data Model ..........................................................................53
Creating Elements ......................................................................................53
Modifying Elements.....................................................................................54
Exporting Elements.....................................................................................54
Importing Elements .....................................................................................55
Export From OT Flow For The External Mapping ...........................................56
Importing a Data Model Hierarchy......................................................................57
Exporting a Data Model Hierarchy......................................................................57
OT Settings......................................................................................................59
Creating IT Flow Message Types .......................................................................59
Message Type Settings.....................................................................................61
Adding and Configuring Connected Nodes ...............................................................62
Adding a Driver Data Source .............................................................................62
Configuring Driver Data Source Stations.......................................................65
Modifying Driver Data Source Stations .........................................................66
Removing Driver Data Source Stations.........................................................67
Configuring Driver Data Source Attributes.....................................................67
Modifying Driver Data Source Attributes .......................................................74
OPC Mapping.............................................................................................77
Removing Driver Data Source Attributes.......................................................80
Adding an MQTT Driver Data Source .................................................................80
Adding a Node-Red Driver Data Source .............................................................85
Adding an IT System Data Source .....................................................................86
Configuring IT System Data Source Messages .............................................88
Modifying IT System Data Source Messages ................................................90
Removing IT System Data Source Messages................................................90
Removing a Connected Node............................................................................90
4
EIO0000004482.02
Adding and Configuring Application Nodes...............................................................92
Adding an Application Node ..............................................................................92
Configuring an Application Node........................................................................92
Removing an Application Node..........................................................................93
Computations ........................................................................................................94
Creating a Computation ....................................................................................94
Modifying a Computation...................................................................................95
Removing a Computation..................................................................................96
Conditions .............................................................................................................97
Creating a Condition .........................................................................................97
Modifying a Condition .......................................................................................98
Removing a Condition.......................................................................................99
Monitoring ........................................................................................................... 100
Alerts and Notifications ......................................................................................... 101
Configuring Notifications ................................................................................. 101
Box Diagnostics ............................................................................................. 102
Removing Alerts ............................................................................................. 102
EcoStruxure Plant Data Expert API for External Applications ................................... 104
EIO0000004482.02
5
Safety Information
Important Information
Read these instructions carefully, and look at the equipment to become familiar with the
device before trying to install, operate, service, or maintain it. The following special
messages may appear throughout this documentation or on the equipment to warn of
potential hazards or to call attention to information that clarifies or simplifies a procedure.
The addition of this symbol to a “Danger” or “Warning” safety label indicates that an
electrical hazard exists which will result in personal injury if the instructions are not
followed.
This is the safety alert symbol. It is used to alert you to potential personal injury
hazards. Obey all safety messages that follow this symbol to avoid possible injury or
death.
!
DANGER
DANGER indicates a hazardous situation which, if not avoided, will result in death or serious
injury.
!
WARNING
WARNING indicates a hazardous situation which, if not avoided, could result in death or
serious injury.
!
CAUTION
CAUTION indicates a hazardous situation which, if not avoided, could result in minor or
moderate injury.
NOTICE
NOTICE is used to address practices not related to physical injury.
EIO0000004482.02
7
Please Note
Electrical equipment should be installed, operated, serviced, and maintained only by
qualified personnel. No responsibility is assumed by Schneider Electric for any
consequences arising out of the use of this material.
A qualified person is one who has skills and knowledge related to the construction and
operation of electrical equipment and its installation, and has received safety training to
recognize and avoid the hazards involved.
8
EIO0000004482.02
About the Book
Document Scope
This manual describes the steps to install and configure EcoStruxure Plant Data Expert.
Validity Note
This document is valid for version 22.1 of EcoStruxure Plant Data Expert.
Registered trademarks:
•
EcoStruxure™ and Harmony™ are registered trademarks of Schneider Electric.
•
Chrome™ and Chromium™ are registered trademarks of Google LLC.
•
Microsoft Edge™ and Windows™ are registered trademarks of Microsoft Corporation.
•
AVEVA™ Edge 2020 Studio is a registered trademark of AVEVA Group PLC.
The technical characteristics of the devices described in the present document also appear
online. To access the information online, go to the Schneider Electric home page www.se.
com/ww/en/download/.
The characteristics that are described in the present document should be the same as those
characteristics that appear online. In line with our policy of constant improvement, we may
revise content over time to improve clarity and accuracy. If you see a difference between the
document and online information, use the online information as your reference.
Related Documents
Title of Documentation
Reference Number
EcoStruxure Plant Advisor User Manual
EIO0000004481 (ENG) (https://www.schneiderelectric.com/en/download/document/EIO0000004481)
You can download these technical publications, the present document and other technical
information from our website www.se.com/en/download/.
EIO0000004482.02
9
Product Related Information
WARNING
UNAUTHENTICATED ACCESS AND SUBSEQUENT UNAUTHORIZED MACHINE
OPERATION
•
Evaluate whether your environment or your machines are connected to your critical
infrastructure and, if so, take appropriate steps in terms of prevention, based on
Defense-in-Depth, before connecting the automation system to any network.
•
Limit the number of devices connected to a network to the minimum necessary.
•
Isolate your industrial network from other networks inside your company.
•
Protect any network against unintended access by using firewalls, VPN, or other,
proven security measures.
•
Monitor activities within your systems.
•
Prevent subject devices from direct access or direct link by unauthorized parties or
unauthenticated actions.
•
Prepare a recovery plan including backup of your system and process information.
Failure to follow these instructions can result in death, serious injury, or equipment
damage.
WARNING
UNINTENDED EQUIPMENT OPERATION
•
Allow only authorized personnel, with training in the design or the operation of the
application and the system process to program, install, modify, and use this product.
•
Follow local and national safety codes and standards.
Failure to follow these instructions can result in death, serious injury, or equipment
damage.
CAUTION
UNAUTHORIZED OR MALICIOUS ACCESS
•
Take adequate cybersecurity precautions when installing an IIoT system, connecting
your industrial network to an outside network.
•
Follow the cybersecurity guidelines provided in this user manual and contact your local
IT administrator for specific measures regarding the cybersecurity of your system.
Failure to follow these instructions can result in injury or equipment damage.
10
EIO0000004482.02
Cybersecurity
Overview
Because of the IIoT design, industrial and control systems are increasingly vulnerable to
cyber-attacks for the following reasons:
•
Harmony iPCs are commercially available in the market.
•
Publishing nodes can be remotely accessible.
•
IIoT designs are a strategic location in industrial processes that are of interest to
hackers.
To secure the industrial installation, the following fundamental characteristics should be
considered:
•
Availability of the system to help ensure that the system remains operational
•
Integrity of the data to maintain the integrity of information
•
Confidentiality to avoid information disclosure
General Practices
To keep the system as secured as possible, secure the environment where the Box is
installed.
Unauthorized persons may gain access to the Harmony iPC as well as to other devices on
the network/fieldbus of the machine and connected networks via insufficiently secure access
to the software and networks.
Before creating user login details, cross-check again if it is necessary to give access to
others. Users may have one of two permissions (full access/read-only access). Admin login
and password details must be secured.
To avoid unauthorized access to the Harmony iPC, you must have the:
•
Operating system, libraries, runtime environments, etc. are installed and correctly
configured.
•
Patch management controls to ensure that all software is kept up-to-date.
•
Configuration change management controls.
•
Malicious code detection and prevention controls, for example:
•
◦
Anti-virus signature and pattern updates are applied in a timely fashion.
◦
Application whitelisting.
Access control and permission management.
EIO0000004482.02
11
•
Backup and restore functionality.
•
Area where the Harmony iPC is placed must be physically protected to keep the device
as safe as possible.
•
Communication between Node-Red and EcoStruxure Plant Data Expert performance
over MQTT requires MQTTS.
•
The MQTTS is ensured via certificates.
•
To avoid the user credentials of devices (Modbus PLC and Edge Box), NDA must be
signed by the process engineer.
Cybersecurity Certification
Schneider Electric developed cybersecurity guidelines based on ISA Secure
recommendations.
WARNING
UNAUTHENTICATED ACCESS AND SUBSEQUENT UNAUTHORIZED MACHINE
OPERATION
•
Evaluate whether your environment or your machines are connected to your critical
infrastructure and, if so, take appropriate steps in terms of prevention, based on
Defense-in-Depth, before connecting the automation system to any network.
•
Limit the number of devices connected to a network to the minimum necessary.
•
Isolate your industrial network from other networks inside your company.
•
Protect any network against unintended access by using firewalls, VPN, or other,
proven security measures.
•
Monitor activities within your systems.
•
Prevent subject devices from direct access or direct link by unauthorized parties or
unauthenticated actions.
•
Prepare a recovery plan including backup of your system and process information.
Failure to follow these instructions can result in death, serious injury, or equipment
damage.
12
EIO0000004482.02
CAUTION
UNAUTHORIZED OR MALICIOUS ACCESS
•
Take adequate cybersecurity precautions when installing an IIoT system, connecting
your industrial network to an outside network.
•
Follow the cybersecurity guidelines provided in this user manual and contact your local
IT administrator for specific measures regarding the cybersecurity of your system.
Failure to follow these instructions can result in injury or equipment damage.
EIO0000004482.02
13
Overview
EcoStruxure Plant Data Expert is a software solution for the monitoring of industrial sites
and equipment, in order to optimize maintenance and performance.
EcoStruxure Plant Data Expert collects data from your connected equipment (systems,
devices, sensors,...) inside an industrial site, and from your connected SQL database. The
data is processed and sent to a data repository in the EcoStruxure Plant Advisor — Data
Hub, or accessed using applications developed with the Schneider Electric API. In
EcoStruxure Plant Data Expert you can monitor and be notified of the state of your
equipment and data.
14
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
What’s in This Part
Prerequisites ...........................................................................16
Before Installation ....................................................................17
Installing EcoStruxure Plant Data Expert ...................................20
Licensing.................................................................................31
EIO0000004482.02
15
Prerequisites
Prerequisites
Hardware Requirements
You can install EcoStruxure Plant Data Expert on a Harmony iPC HMIP6, i3, i5 and i7 box.
In this manual, we refer to the Harmony iPC HMIP6 box as Harmony iPC.
You must connect a keyboard, a mouse and a display when accessing the Harmony iPC for
the first time. Then, if required, you can configure the remote connection, page 19 to access
the Harmony iPC through a remote PC. The remote connection must be turned off, after
EcoStruxure Plant Data Expert has been installed.
System Requirements
The following minimum requirements must be met:
•
Operating system: Minimal version of Windows 10 (Build 1809), 64–bit.
•
Hard disk space: 128GB (minimum)
•
RAM: 8 GB.
The internet connection is mandatory for the installation.
The supported language is English.
16
EIO0000004482.02
Before Installation
Before Installation
What’s in This Chapter
Network Configuration..............................................................17
Configuring the Remote Connection ..........................................19
Before you can install EcoStruxure Plant Data Expert:
1. Power on the Harmony iPC.
2. Connect a keyboard, a mouse, and a display.
3. Connect the Harmony iPC to the internet using an ETH cable. The IP settings must be
set to Obtain an IP address automatically (DHCP mode), page 17.
NOTE: By default, only ETH cable connection to the Harmony iPC is available.
Additional items need to be installed to enable the WiFi and 3G/4G mobile
connection.
4. EcoStruxure Plant Data Expert and EcoStruxure Plant Advisor must be time
synchronized for consistency and correct interpretations of the data. Verify that the
Windows HMI timezone and date/time are consistent before installing EcoStruxure
Plant Data Expert or configuring the properties (for example, using the same network
time server).
5. Unzip the Edge_Software_Installer.zip file provided by your local Schneider Electric
distributor.
Result: The Edge_Software_Installer folder is created, containing the setup.exe file,
the SQL Server 2019 installation file, and other items.
Network Configuration
To activate the network connection on the Harmony iPC:
1. In the Start menu, click Settings.
2. In the Windows Settings, click Network & Internet.
3. Click Status in the list of settings on the left.
4. Click Change adapter options
Result: A window, containing the available network adapters opens.
EIO0000004482.02
17
Before Installation
5. Right-click one of the Ethernet network adapters, then in the list of options click
Enable.
Result: The network adapter is activated.
6. Right-click the network adapter again, then in the list of options click Properties.
7. In the Networking tab, select the Internet Protocol Version 4 (TCP/IPv4) checkbox,
then click Properties.
8. In the General tab, select Obtain an IP address automatically, then click OK.
18
EIO0000004482.02
Before Installation
9. Click OK again to close the dialog box.
Configuring the Remote Connection
To access the Harmony iPC through a remote PC, configure the remote connection.
1. On the Harmony iPC, in the Start menu, click Settings.
2. In the Windows Settings, click System.
3. Click Remote Desktop in the list of settings on the left.
4. Activate Enable Remote Desktop and click Confirm.
5. If required, configure the advanced settings.
6. In the Start menu of the remote PC, click Remote Desktop Connection.
7. Enter the Harmony iPC IP address.
8. Click Connect.
Result: You are now connected to the Harmony iPC on your remote PC. You can remotely
see the Windows screen and perform actions on the Harmony iPC. A keyboard, a mouse,
and a display are not required on the Harmony iPC.
Post-requisite: After you have completed the installation procedure, remember to turn off
the remote connection on the Harmony iPC, as it could be used for unauthorized access to
data on your Harmony iPC. Follow the security recommendations of your IT department.
EIO0000004482.02
19
Installing EcoStruxure Plant Data Expert
Installing EcoStruxure Plant Data Expert
What’s in This Chapter
Installing SQL Server 2019 .......................................................20
Installing EcoStruxure Plant Data Expert ...................................22
Installing AVEVA Edge 2020 .....................................................26
Docker Proxy Settings..............................................................27
Completing the Installation .......................................................30
If you are installing EcoStruxure Plant Data Expert for the first time, the installation
procedure includes the installation of several components. The procedure is executed in the
following order:
1. Installing SQL Server 2019, page 20
2. Installing EcoStruxure Plant Data Expert, page 22
3. Installing AVEVA Edge 2020, page 26
4. Configuring the Docker proxy settings, page 27
5. Completing the installation, page 30
If you are reinstalling:
•
EcoStruxure Plant Data Expert or AVEVA Edge 2020 — start the procedure from step 3
•
SQL Server 2019 — follow only step 1
•
Docker Desktop — start the procedure from step 2
Installing SQL Server 2019
1. Open the Edge_Software_Installer folder, created after unzipping the Edge_
Software_Installer.zip file.
2. Double-click the SQLEXPR_x64_UNI.exe file, then in the dialog box click Yes to allow
the installation.
3. Click OK.
Result: The SQL Server Installation Center opens.
20
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
4. Click New SQL Server stand-alone installation or add features to an existing
installation.
a. On the License Terms window that opens, click on the checkbox I accept the
license terms and Privacy Statement and then click Next.
b. On the Microsoft Update window that opens, it is not necessary to click the
checkbox for updates, click Next.
c. On the Product Updates window that opens, it is not necessary to wait for the
scan to complete, click Next.
NOTE: The Install Setup files window opens, wait a couple of minutes for
installation of the files to complete.
d. On the Install Rules window that opens, click Next.
NOTE: The Windows Firewall warning message can be ignored.
e. On the Feature Selection window that opens, click Next.
f. On the Instance Configuration window that opens, click Next.
g. On the Server Configuration window that opens, click Next.
h. On the Database Engine Configuration window that opens, click Next.
EIO0000004482.02
21
Installing EcoStruxure Plant Data Expert
NOTE: The Installation Progress window opens, wait a couple of minutes.
5. When the installation is finished, click Close and then you can also Close the SQL
Server Installation Center.
Installing EcoStruxure Plant Data Expert
You need to install SQL Server 2019 before installing EcoStruxure Plant Data Expert (only at
first installation).
1. Open the Edge_Software_Installer folder, created after unzipping the Edge_
Software_Installer.zip file.
2. Double-click the setup.exe file, then in the dialog box click Yes to allow the installation.
Result: The list of required items is displayed.
3. Click Install to start the installation, wait for the items to be installed.
NOTE: An internet connection is mandatory. If you do not have an internet
connection, the installation of Docker will fail.
Result: Welcome to the Installation Wizard for EcoStruxure Plant Data Expert
window opens.
4. Click Next and then click Enable Hyper-V and Reboot.
Result: The Harmony iPC is rebooted. When the Harmony iPC starts again, a Docker
Desktop dialog box opens requesting to enable file sharing.
NOTE: Enabling the Hyper-V is only required for the first time installation of
EcoStruxure Plant Data Expert.
22
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
5. After the reboot, Docker will launch automatically.
Result: The Docker Desktop Update window opens, click Skip This Build.
NOTE: Do not update Docker as this will cause issues in the current installation
process.
6. Again, double-click the setup.exe file, then in the dialog box click Yes.
Result: Welcome to the Installation Wizard for EcoStruxure Plant Data Expert
window opens again.
EIO0000004482.02
23
Installing EcoStruxure Plant Data Expert
7. Click Next.
Result: The Login Information window opens.
Under the Logon Information window, enter the Windows user name and password,
used to connect to the Harmony iPC, then click Next.
NOTE: If you want to Verify Username and Password, select the checkbox.
8. Click OK on the Logon verification succeeded window that opens.
9. Under the Readme and Release Notes window that opens, you have the choice to
select Display the contents of the Readme file and/or Display the contents of the
Release Notes and click Next.
– If you selected only the Display the contents of the Readme file, the Readme file
window opens. Read the following readme information carefully and then click Next.
– If you selected only the Display the contents of the Release Notes, the Release
Notes window opens. Read the following release notes carefully and then click
Next.
10. Under the License Agreement window that opens in order to continue, select I accept
the terms in the license agreement and click Next.
24
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
11. Under Customer Information, enter your first name, your last name and your company
name, then click Next.
12. Under the Destination Folder window that opens, if you want to save your installation
in a different folder on your PC, click Change... if not, click Next.
13. Under the Setup Type window that opens, select the setup type that best suits your
needs:
– Typical: The most common program features will be installed. Recommended for
most users and for first time installation.
– Complete: All program features will be installed. (Requires the most disk space).
– Compact: The minimum required program features will be installed. (Requires the
least disk space).
– Custom: Choose which program features you want to install and where they will be
installed. Recommended for advanced users.
Depending on which Setup Type you choose, click Next.
14. Under the Application Languages window that opens, click Next.
15. Under Ready to Install the Program window that opens, click Install to begin the
installation.
Result: The IIS window opens. It is important that the user enables the Windows IIS
feature before performing the first time installation.
EIO0000004482.02
25
Installing EcoStruxure Plant Data Expert
16. Click Enable IIS.
Result: cmd.exe and Dism.exe starts to run in the background.
17. The Ready to Install the Program window opens again, click Install and wait until the
preparation is complete.
Result: You are then requested to install AVEVA Edge 2020.
Installing AVEVA Edge 2020
When the installer opens again, click Next to start the installation of AVEVA Edge 2020. If
you are reinstalling EcoStruxure Plant Data Expert, you can choose to skip AVEVA Edge
2020 installation.
1. In the AVEVA Edge 2020 installer, select English language and click OK.
Result: The AVEVA Edge 2020 — InstallShield Wizard window opens.
2. Click Install.
Result: The Welcome to the InstallShield Wizard for AVEVA Edge 2020 window
opens.
3. Click Next.
4. Under the License Agreement window that opens, read the information, then click Yes
to accept the terms.
5. Under the Third Party License Agreement window that opens, read the information,
then click Yes to accept the terms.
6. Under the Customer Information window that opens, enter your Windows user name
and the name of your company, then click Next.
7. Under the Choose Destination Folder window that opens, if you want to save your
installation in a different folder on your PC, click Change... if not, click Next.
8. Under the Select Features window that opens, click Next.
NOTE: If you modify any of the selected items, some features may not be available
in EcoStruxure Plant Data Expert.
9. Under Ready to Install the Program window that opens, click Install.
Result: The Setup Status window opens for the computing of space requirements.
NOTE: Please take note that it can take a minimum of 40 minutes to compute the
space requirements. If you want to avoid waiting 40 minutes, go to next step.
26
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
10. On your windows search bar, search for Settings.
a. Click Update & security.
b. Click Windows Defender.
c. Click Virus & threat protection.
d. Click Settings of the Virus & threat protection.
e. Disable the protection in real time.
Under Windows Security window that opens, click Yes and the computing of
space requirements should start.
NOTE: Once the computing of space requirements is completed, you can reenable the protection.
11. Under InstallShield Wizard Complete window that opens, you have the option if you
want to view the Release Notes file, select the checkbox and click Finish.
Result: The installation of AVEVA Edge 2020 is completed. The installer continues the
installation of EcoStruxure Plant Data Expert.
Docker Proxy Settings
Before you can complete the installation, if you are using a proxy, you need to set the proxy
settings for Docker Desktop.
Under Docker Settings, select the appropriate action:
•
Follow the instructions to set the proxy settings, then click Apply and Restart, or
EIO0000004482.02
27
Installing EcoStruxure Plant Data Expert
•
If you are not using a proxy, select the I have set the settings checkbox, then click
Next
The installation of the EcoStruxure Plant Data Expert continues.
Under Docker Resources settings, you need to file share on a drive, follow the below
instructions:
28
EIO0000004482.02
Installing EcoStruxure Plant Data Expert
Under Docker Resources settings, if you want to activate the proxies, follow the below
instructions:
EIO0000004482.02
29
Installing EcoStruxure Plant Data Expert
Completing the Installation
1. In the Installation Wizard, select the Open Release Notes checkbox and click Finish.
Result: The release notes file is displayed. A dialog box opens.
2. In the dialog box, click Yes.
Result: The Harmony iPC is rebooted. The installation is complete and EcoStruxure Plant
Data Expert and Docker Desktop are running on the Harmony iPC.
EcoStruxure Plant Data Expert and Docker Desktop start automatically each time the
Harmony iPC is started.
The EcoStruxure Plant Data Expert folder is created in the Start menu, containing the
following icons:
•
EcoStruxure Plant Data Expert Start — click if you need to launch EcoStruxure Plant
Data Expert manually.
•
EcoStruxure Plant Data Expert Stop — click if you need to close EcoStruxure Plant
Data Expert.
The EcoStruxure Plant Data Expert documentation is available in Local Disk (C:) >
Program Files (x86) > Schneider Electric > EcoStruxure Plant Data Expert >
Documentation, and a shortcut to this folder is created on the desktop.
30
EIO0000004482.02
Licensing
Licensing
What’s in This Chapter
License Requirements..............................................................31
Activating a License .................................................................31
License Requirements
A trial version of EcoStruxure Plant Data Expert is available. The trial version is free to
download and use up to 42 days, and the trial licence is automatically activated the first time
you login to EcoStruxure Plant Data Expert. At any time during the trial period, you can
purchase a permanent license and activate the software.
The following license types are available:
License Type
Expires in
Trial
42 days
Permanent
Does not expire
Activating a License
1. On the desktop, double click the License Manager icon, installed during the installation
of EcoStruxure Plant Data Expert.
2. Click the EcoStruxure Plant Data Expert licence, then click Activate.
Result: A dialog box opens.
3. Type your activation ID.
4. Click Next.
5. Click Finish.
Result: Your license is activated. You can close the License Manager.
EIO0000004482.02
31
Configuring EcoStruxure Plant Data Expert
What’s in This Part
Prerequisites ...........................................................................33
Logging In to EcoStruxure Plant Data Expert..............................34
User Management ...................................................................38
EcoStruxure Plant Data Expert Settings.....................................40
Projects...................................................................................46
Data Flow................................................................................49
Adding and Configuring Connected Nodes.................................62
Adding and Configuring Application Nodes ................................92
Computations ..........................................................................94
Conditions ...............................................................................97
Monitoring ............................................................................. 100
Alerts and Notifications........................................................... 101
EcoStruxure Plant Data Expert API for External
Applications........................................................................... 104
32
EIO0000004482.02
Prerequisites
Prerequisites
The following prerequisites must be satisfied before configuring the EcoStruxure Plant Data
Expert:
1. You must connect a keyboard, a mouse and a display to the Harmony iPC, or use a
remote connection, page 19.
2. EcoStruxure Plant Data Expert must be installed and running on the Harmony iPC.
3. Docker Desktop must be running on the Harmony iPC.
The running state of EcoStruxure Plant Data Expert and Docker Desktop can be verified in
the Windows Task Scheduler.
Any of the following web browsers can be used to access EcoStruxure Plant Data Expert on
the Harmony iPC:
•
Google Chrome (version 84 or later)
•
Microsoft Edge (version 84 or later)
•
Any web browser using Chromium
EIO0000004482.02
33
Logging In to EcoStruxure Plant Data Expert
Logging In to EcoStruxure Plant Data Expert
What’s in This Chapter
Logging In ...............................................................................34
Recovering a Forgotten Password ............................................35
Logging Out.............................................................................37
When logging in to EcoStruxure Plant Data Expert for the first time:
•
Use the default user name (edge) and the default password (edge), or the user name
and password provided by the administrator if you are a standard user. Upon first
connection, you must change the password. The password must contain at least 8
characters, including at least 1 special character (for example, _/-%*;:!?,&), and it must
be different from the current one.
•
Save the three recovery tokens displayed after modifying the password (administrator
user profile only). The tokens are required to recover the access to EcoStruxure Plant
Data Expert in case you forget your password.
Logging In
To access a project, you first need to log in with your user name and password credentials.
34
EIO0000004482.02
Logging In to EcoStruxure Plant Data Expert
1. Open a web browser and enter this URL: https://localhost.
Result: The login window opens.
2. In the Username box, enter your user name.
3. In the Password box, enter your password.
4. Click Login.
Recovering a Forgotten Password
If you have a standard user profile, request a new password to your administrator. If you
have an administrator user profile, click Forgot Password? on the login page and follow the
steps to recover your access.
1. On the login page of EcoStruxure Plant Data Expert, click Forgot Password?.
EIO0000004482.02
35
Logging In to EcoStruxure Plant Data Expert
2. On the next page:
a. Enter your Username.
b. Enter each of the three recovery tokens created at your first connexion.
c. Enter the New Password.
d. Enter again the new password in Confirm Password.
e. Click Submit.
Result: Three new recovery tokens are created. These tokens are to be used to
recover your access in case you forget your password.
3. Click Continue.
Result: You are logged in to EcoStruxure Plant Data Expert.
36
EIO0000004482.02
Logging In to EcoStruxure Plant Data Expert
Logging Out
1. Click your user name in the top right corner of the main window in EcoStruxure Plant
Data Expert.
2. Click Logout.
Result: EcoStruxure Plant Data Expert saves all your changes automatically. You do not
need to save your changes manually before logging out.
EIO0000004482.02
37
User Management
User Management
What’s in This Chapter
Creating Users ........................................................................38
Modifying Users.......................................................................39
Removing Users ......................................................................39
EcoStruxure Plant Data Expert can be accessed by the following types of users:
•
Standard User — read/write access to all the configurations, no access to User
Management.
•
Administrator — full access to all configuration parameters and User Management..
To manage user rights, you have to login as Administrator. You can then modify and delete
existing user profiles, or you can create additional users. The first administrator user is
created when logging in to EcoStruxure Plant Data Expert for the first time.
As a Standard User, you cannot import projects nor CSV files in the driver.
Creating Users
1. On the toolbar, click Menu > User Management.
Result: The list of existing user profiles is displayed.
2. Click Create user.
3. Enter the required personal information.
4. In the Role list, click the type of user to be created.
5. Enter the Username and the Password of the new user.
At first connection, the user is requested to modify their password.
6. Click Create User.
38
EIO0000004482.02
User Management
Modifying Users
1. On the toolbar, click Menu > User Management.
Result: The list of existing user profiles is displayed. You can search a user in the list
using the search box.
2. In the list of users, click
next to the user to be modified.
Result: The Update User dialog box opens.
3. Modify the required information.
NOTE: If you modify a user role from Administrator to Standard, the recovery
tokens received at first connection become invalid.
NOTE: If you modify a user role from Standard to Administrator, this user
receives the three recovery tokens at the next login.
4. Click Update User to apply your modifications.
Removing Users
1. On the toolbar, click Menu > User Management.
Result: The list of existing user profiles is displayed. You can search a user in the list
using the search box.
2. In the list of users, click
next to the user to be removed.
3. Click Confirm.
EIO0000004482.02
39
EcoStruxure Plant Data Expert Settings
EcoStruxure Plant Data Expert Settings
What’s in This Chapter
EcoStruxure Plant Data Expert Description ................................41
Box Settings ............................................................................42
40
EIO0000004482.02
EcoStruxure Plant Data Expert Settings
EcoStruxure Plant Data Expert Description
The following graphic shows the user interface after logging in:
1. Menu. Contains the following list of controls:
a. Projects
b. Box Settings
c. User Management
d. Diagnostics
e. Certificates
f. Files
g. About
h. Help
i. Licensing
2. Project toolbar — Displays icons for project-specific actions and the active project
name.
3. Tabs to access the Flow, Connected Nodes, Application Nodes, Computations, or
Conditions.
4. Alert center — Displays the number of alerts sent by EcoStruxure Plant Data Expert.
5. Shows the currently logged in user name. Contains the following list of controls:
a. Profile
b. Change Password
c. Logout
6. Project page.
EIO0000004482.02
41
EcoStruxure Plant Data Expert Settings
Box Settings
To access the Harmony iPC configuration settings in EcoStruxure Plant Data Expert, click
Menu > Box Settings on the toolbar.
Network Settings
EcoStruxure Plant Data Expert connects automatically to the configured application node.
If required, configure the IP address of your proxy server in Proxy.
Data Hub Enrollment Settings
Through the enrollment, the Harmony iPC is connected and identified by the EcoStruxure
Plant Advisor — Data Hub as a compatible device.
To configure the enrollment:
1. In Device ID, enter the ID, created by the EcoStruxure Plant Advisor — Data Hub
during the configuration of your data source.
2. In Primary Key, enter the key, created by the EcoStruxure Plant Advisor — Data Hub
during the configuration of your data source.
SFTP Settings
With EcoStruxure Plant Data Expert, the data is not only collected and processed from the
devices, sensors and other industrial equipment, but also from files uploaded on an FTP
server.
The SFTP settings enable the Harmony iPC to access the storage created on an existing
FTP server, in order to collect the data files and send them to the application node.
To configure the SFTP communication, enter the parameters of your FTP server and the
location of the files, then click Save.
The SFTP settings can be tested by clicking Test.
42
EIO0000004482.02
EcoStruxure Plant Data Expert Settings
SMTP Settings
In SMTP settings, you can configure the mail server to send notifications.
To configure the SMTP communication, enter the parameters of your outgoing mail server,
then click Save.
The SMTP settings can be tested by clicking Test.
OT Polling Period
In OT Polling Period, you can configure the frequency of data values collection from your
connected driver data sources to EcoStruxure Plant Data Expert. Enter a period of time
between 1 second and 12 hours (for example, 25s, or 30m, or 3h) in Data Collection
Frequency and click Save.
EIO0000004482.02
43
MQTT Certificate Management
The only way to communicate with the Message Queuing Telemetry Transport (MQTT) is to
use a secure connection and that is with MQTTS. The user has to provide a certificate to
communicate between Node-Red and EcoStruxure Plant Data Expert. Node-Red needs to
be running in order for the certificates to be validated.
1. To create a certificate in MQTT, click
to access the Menu and select Certificates.
Result: The Generate Certificate window opens.
2. Enter a Validity Period (days).
NOTE: A maximum of 398 days.
3. Under Certificate for, select a certificate.
44
EIO0000004482.02
4. Click Generate And Download.
Result: Depending on your browser, allow the download of the following files to your
local PC — private.pk, public.pem and ca.pem.
NOTE: Using Node-Red, with the MQTT Node, it requests for the certificate (ca.
pem), the public certificate (public.pem), and the private key (private.pk) to enable
secure communication over MQTT between Node-Red (EcoStruxure Plant Data
Expert Essential) and EcoStruxure Plant Data Expert Performance.
NOTE: If you want to work with Node-Red (EcoStruxure Plant Data Expert
Essential), refer to Adding a Node-Red Driver Data Source, page 85.
EIO0000004482.02
45
Projects
Projects
What’s in This Chapter
Creating a Project ....................................................................46
Modifying a Project ..................................................................46
Exporting a Project...................................................................47
Importing a Project...................................................................48
Removing a Project..................................................................48
An overview of the active project and its content is available from the project page, or in
Menu > Projects.
Creating a Project
1. On the home page of EcoStruxure Plant Data Expert, click Create Project
Result: The Create Project window opens.
NOTE: You can import your data model hierarchy or create/import your custom data
model.
2. Enter the Project name, and optionally a project description.
3. Click Save.
Result: The Configure Data Model window opens.
NOTE: The user can import a model at this stage or decide to import later.
Modifying a Project
1. On the toolbar, click Menu > Projects.
2. Click on the right of the project name.
3. In the drop-down list, select Settings.
4. Modify the required information.
Note: If you modify the type of data model, you must add and configure again the
connected nodes, the application node and the message types as the data model is
deleted.
46
EIO0000004482.02
Projects
5. Click Save.
Exporting a Project
You can generate and export a copy of your project configuration and save it locally on the
Harmony iPC. This exported copy can be used to restore your project.
1. On the toolbar, click Menu > Projects.
2. Click on the right of the project name.
3. In the drop-down list, select Generate For Export..
4. In the Export Project dialog box, enter a password to encrypt the exported project file.
NOTE: The password is requested by EcoStruxure Plant Data Expert when you
import the exported file. Only Administrator users can import projects.
5. Click Generate.
Result: The export project file is generated.
6. Click on the right of the project name.
7. Click Download Last Exported File.
Result: The file is downloaded in the default location on the Harmony iPC.
NOTE: You will need to use the password to open the downloaded file.
EIO0000004482.02
47
Projects
Importing a Project
If there is no existing project in EcoStruxure Plant Data Expert, you can only import one if
you are logged into EcoStruxure Plant Data Expert as an Administrator user
To import a project:
1. On the toolbar, click Menu > Projects.
2. Click Import Project.
Result: The Import Project dialog box opens.
3. Click Choose a Project File.
4. Browse and click the file to be imported, then click Open.
5. Enter the Password of the imported file.
6. Optionally, select the Update Settings? checkbox.
NOTE: When you import an exported project, you can either keep the current box
settings, page 42, or select the checkbox to update the Harmony iPC settings with
the settings of the imported project.
7. Click Submit.
Removing a Project
Only users who have Administrator access can remove projects.
1. On the toolbar, click Menu > Projects.
2. Click on the right of the project name.
3. In the drop-down list select Delete, then click Confirm.
48
EIO0000004482.02
Data Flow
Data Flow
What’s in This Chapter
Overview.................................................................................49
Creating a Custom Data Model .................................................53
Importing a Data Model Hierarchy .............................................57
Exporting a Data Model Hierarchy .............................................57
OT Settings .............................................................................59
Creating IT Flow Message Types ..............................................59
Message Type Settings ............................................................61
After creating the project, you can create OT Flow (Operational Technology) and/or IT Flow
(Information Technology) in the FLOW tab of EcoStruxure Plant Data Expert.
To create OT Flow, you can import a data model hierarchy created in the EcoStruxure Plant
Advisor — Data Hub, or create your custom data model. Then you can configure the OT
Flow to collect data from the created connected nodes. A data model shows the
organization of the different equipment used to collect data.
To create IT Flow, you need to configure first in a connected node the configuration to
access to the SQL database (parameter tab), and select tables and columns you are
interested in (messages tab). Then in the IT Flow, you need to configure message types to
send queries and collect data from the SQL database configured as a connected node.
Overview
OT Flow
In the OT tab, you can see the configuration with a custom data model and an imported data
model hierarchy. You can also see an overview of the items and display the equipment
properties from selecting the work unit.
EIO0000004482.02
49
Data Flow
The following graphic shows the OT Flow configuration with a custom data model, created
in the FLOW tab:
1. Equipment — The data model hierarchy, imported a hierarchical model, users cannot
change any data (equipment or properties, adding removing or renaming).
2. Element — The equipment name and its properties, configured as attributes in the
CONNECTED NODES tab.
3. Connected Node — The driver data source configured in the CONNECTED NODES
tab.
4. Read Value
5. Writing Value — Not available in this version 22.1.
6. Application Nodes — The destination where the data is sent, configured in the
APPLICATION NODES tab.
7. Settings — You can connect the equipment property to an application node.
8. Elements — The data model, created in EcoStruxure Plant Data Expert.
9. Filter — Filter menu.
NOTE: The conversion of IEC 1131 elementary type are automatically done by
EcoStruxure Plant Data Expert on its supported types which are: Numeric, Boolean,
String, Date and Timespan.
50
EIO0000004482.02
Data Flow
The following graphic shows the OT Flow configuration with an imported data model
hierarchy:
1. Equipment — The data model hierarchy, imported from the EcoStruxure Plant Advisor
— Data Hub.
2. Data Model — The equipment name and its properties, configured as attributes in the
CONNECTED NODES tab.
3. Connected Node — The driver data source configured in the CONNECTED NODES
tab.
4. Reading Value
5. Writing Value — Not available in this version 22.1.
6. Application Nodes — The destination where the data is sent, configured in the
APPLICATION NODES tab.
7. Settings — You can connect the equipment property to an application node or to the list
of computations using the gear icon.
8. Page — You can display all the equipment properties by navigating over the model from
page to page, each page displays 10 rows or a user can select the number of records per
page (10, 20, 50 or all).
9. Elements — The data model, created in EcoStruxure Plant Data Expert
10. Filter — Filter menu.
EIO0000004482.02
51
Data Flow
IT Flow
The following graphic shows the IT configuration in the FLOW tab:
1. A message type — the query created and configured to collect data from the connected
SQL database.
2. Search box.
3. Attribute — the name of the message type and the names of the columns in the
database where the collected data is stored.
4. Message — the names of the messages configured in the connected node and used in
the message type.
5. Condition — click to open a condition configuration in the CONDITIONS tab.
6. Adding an Attribute — you can select from which table and columns of the messages
to collect data with the message type.
7. Message type settings — you can connect the message type to an application node,
modify the namespace or the trigger and remove the message type. If the trigger is an
event, only via a Web API SDK user can send these events to trigger the message type
execution.
For more details, please refer to API Documentation located on the Menu at the top
left hand side of the screen of EcoStruxure Plant Data Expert under HELP.
NOTE: If within a message type you refer to attributes from multiple messages
(from connected node), EcoStruxure Plant Data Expert will create as many queries
52
EIO0000004482.02
Data Flow
compared to the messages used.
Creating a Custom Data Model
Creating Elements
You need to create each connected element and its properties. The properties are used to
process the data by creating computations and conditions.
1. In the FLOW tab, click OT.
2. Click next to Elements and then click Create Element.
Result: The Create Element dialog box opens.
3. Enter the name of the connected element.
Example: Sawmill SW345
4. Create properties as follows:
a. Enter the name of the property.
Example: Speed
b. Enter a unit of measurement (optional).
Example: minutes, meters, ...
c. Select a data type in the drop-down list — String, Date, Numeric, or Boolean.
NOTE: You can click + to create more properties if required.
NOTE: Once created, the property cannot be modified. You can remove it by
clicking
EIO0000004482.02
53
Data Flow
5. Click Create Element.
NOTE: After the element is created, its name cannot be modified. You can remove
the element by clicking
on the OT window.
Modifying Elements
You can add new properties or remove existing properties from the created element.
To modify the elements:
1. In the FLOW tab, click on the OT.
2. Click on Elements and then select the element to be modified.
3. Click
on the configuration window.
Result: The Update Element dialog box opens.
You can rename the Element and its Properties.
4. To add new property to the element, click + and then create property as follows:
a. Enter the name of the property.
b. Enter a unit of measurement (optional).
c. Select a data type in the drop-down list — String, Date, Numeric, or Boolean.
NOTE: You can click + to create more properties if required.
5. To remove a property, click
6. Click Update Element
Exporting Elements
You can export the custom elements to import it later in a Flow.
1. Click on the FLOW tab.
2. Click on the OT, then click next to Elements.
54
EIO0000004482.02
Data Flow
3. Click Export Elements.
Result: The Export Elements dialog box opens.
4. In the Export Elements dialog box, enter a password to encrypt the exported file.
Result: The custom elements containing the corresponding properties is automatically
downloaded on your local PC.
NOTE: The exported file format is .EPDE, you can import it in another Flow, refer to
Importing Elements, page 55.
Importing Elements
The following procedure describes how to import the custom elements, that was previously
exported from EcoStruxure Plant Data Expert.
1. Click on the FLOW tab.
NOTE: If the custom elements already exists, click on the OT Polling Period, then
click next to Elements and then click, Import Elements.
Result: The Import Custom Elements dialog box opens.
2. Click Import Elements.
EIO0000004482.02
55
Data Flow
3. Browse and select the .EPDE file, containing the corresponding custom elements, then
click Open.
4. Click Submit to import the custom elements.
Result: If the custom elements already exists, it is replaced by the new elements. The
imported elements can be modified in EcoStruxure Plant Data Expert. If you need to modify
the custom elements or add new properties, refer to Modifying Elements, page 54.
NOTE: If you add new properties to the current flow and then you export the previous
version of the elements, the new properties you have added will not be deleted.
Export From OT Flow For The External Mapping
You can export a .CSV file used for the external mapping in the connected nodes.
1. Click on the FLOW tab.
2. Click on the OT, then click next to Elements.
3. Click Export CSV file.
Result: The .CSV file containing the list of the element properties is automatically
downloaded on your local PC.
NOTE: The exported file contains columns (the highlighted ones) dedicated to the
external mapping, you need to complete it as shown in the following example:
NOTE: If the StationName is empty, after the import the StationName takes the
StationAddress, but if a StationName is given for two different StationAddress
then the file cannot be imported.
56
EIO0000004482.02
Data Flow
Importing a Data Model Hierarchy
The following procedure describes how to import a data model hierarchy, that was
previously created in the EcoStruxure Plant Advisor — Data Hub:
1. Click the FLOW tab.
NOTE: If a data model hierarchy already exists, click OT Flow tab, then click next
to Equipment and then click, Import Model.
Result: The Configure Data Model dialog box opens.
2. Click Import Model.
3. Browse and select the JSON file, containing the corresponding hierarchy, then click
Open.
4. Click Submit to import the hierarchy.
Result: If a data model hierarchy already exists, it is removed and replaced by the new
hierarchy. The imported hierarchy cannot be modified in EcoStruxure Plant Data Expert. If
you need to modify the data model hierarchy or add new equipment, modify it where it is
created, then import it again in EcoStruxure Plant Data Expert.
Exporting a Data Model Hierarchy
You can export the Data Model Hierarchy properties from EcoStruxure Plant Data Expert as
a .CSV file to do the external mapping (mapping the variables to the corresponding
properties). This mapping file is to be imported into EcoStruxure Plant Data Expert, refer to
Import Attributes From CSV, page 72. For the external mapping, refer to CSV External
Mapping, page 72.
To export Data Model Hierarchy:
1. Click on the FLOW tab.
EIO0000004482.02
57
Data Flow
2. Click on the OT, then click next to Equipments and then click on Export Hierarchy
as CSV.
Result: The file containing the data model hierarchy is automatically downloaded on
your local PC.
NOTE: The exported file contains columns (the highlighted ones) dedicated to the
external mapping in the connected nodes, you need to complete it.
NOTE: You may split this file into multiple CSV files with different properties, if you
want to import the mapping on different connected nodes.
58
EIO0000004482.02
Data Flow
OT Settings
You can configure an application node, page 92 for one or several values in the list:
1. In the FLOW tab, click OT.
2. In the list of variables, select the checkbox of one or more variables to be modified.
Result: The Settings sidebar opens on the right of the list.
3. In the Settings sidebar, select the checkbox next to the name of the application node.
4. Click Save.
Result: The application node is configured for the selected variables.
Creating IT Flow Message Types
In IT Flow, you can create message types. The message types are used to send queries
and collect specific data from the connected SQL database.
Before you can create message types, you must connect and configure the SQL database
as an IT system data source, page 86 in the CONNECTED NODES tab.
1. In the FLOW tab, click IT Flow.
EIO0000004482.02
59
Data Flow
2. Click + next to Message Types.
Result: The Create Message Type dialog box opens.
3. Enter a Name of the message type.
Example: Material Consumed
4. Optionally, in Namespace enter a description of the information contained in the
message type.
5. Select a Connected Node, where the collected data is located in the database.
6. Select a Trigger for the queries to the database:
a. Polling — enter the frequency of sending queries to the database to collect data.
The minimum polling rate is 1 minute for a Message Types.
Example: 10m or 2h.
b. Event — enter the name of the external application to send queries to the
database. The external application is developed using the EcoStruxure Plant Data
Expert API for external applications, page 104.
CAUTION
MISSING OR FALSE TRIGGERS
Verify trigger configuration before commissioning the application.
Failure to follow these instructions can result in injury or equipment damage.
7. Click Create.
Result: The message type is added to the list of message types.
8. Click the name of the new message type in the left sidebar.
60
EIO0000004482.02
Data Flow
9. Click
which is located on the right of the screen to add your attribute.
Result: The Select Attributes from Connected Node dialog box opens. The
messages of the IT system data source and their variables are displayed.
10. Select the required message variables, representing the columns of the SQL database
where the data to be collected by this message type is stored.
NOTE: EcoStruxure Plant Data Expert creates a data file for each message used in
the message type. Then the data files are either sent to the configured application
node, or they can be retrieved with an application developed using the EcoStruxure
Plant Data Expert API for external applications, page 104.
11. Click Update.
Message Type Settings
1. In the Flow tab, click IT.
2. In the list of message types, click the message type to be modified.
Result: The message type settings are displayed.
3. If required, modify the namespace or the trigger.
4. If required, select the application node where the data is to be sent.
5. Click Save.
EIO0000004482.02
61
Adding and Configuring Connected Nodes
Adding and Configuring Connected Nodes
What’s in This Chapter
Adding a Driver Data Source.....................................................62
Adding an MQTT Driver Data Source ........................................80
Adding a Node-Red Driver Data Source.....................................85
Adding an IT System Data Source.............................................86
Removing a Connected Node ...................................................90
The connected nodes are data sources, equipment or database, installed or connected to
the Harmony iPC, and sending data to EcoStruxure Plant Data Expert. Two types of data
sources can be added in EcoStruxure Plant Data Expert — driver or IT system.
Adding a Driver Data Source
A driver data source is a connected node where you configure your connected equipment
(machine, device, sensor,...) to send data to EcoStruxure Plant Data Expert through a
communication protocol. To collect the data, each equipment property must be connected to
its variable when configuring the attributes of the driver data source.
1. Click the CONNECTED NODES tab.
62
EIO0000004482.02
Adding and Configuring Connected Nodes
2. Click
NOTE: The plus button turns to grey when applied.
Result: The Create New Data Source dialog box opens.
3. Enter a Name of the driver data source.
Example: M580
4. Click Driver to select the OT data source.
5. In the list of available communication protocols, click the communication protocol to be
used to connect to the data source.
EIO0000004482.02
63
Adding and Configuring Connected Nodes
6. Click Create.
NOTE: For the generic Driver, make sure that the information about the Name, the
Driver and the Description (optional) is added.
NOTE: For the OPCUA, make sure that the information about the Server
Endpoint, the User Name and the Password is added.
NOTE: For the OPCDA, make sure that the information about the Server Address
and choose the Specification is added.
64
EIO0000004482.02
Adding and Configuring Connected Nodes
To update the Behaviour Settings, click Edit.
Configuring Driver Data Source Stations
In Stations, you can configure your driver data sources. For example when you have a
driver and in the output of the driver you have different devices, these are called stations for
which each device can specify their variables.
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Stations.
EIO0000004482.02
65
Adding and Configuring Connected Nodes
3. Click
on the right of the Stations window.
Result: The Data Source — Attributes — Create/Modif... dialog box opens.
NOTE: You can choose to precise the stations by an address (11.123.12.4:502) and
a logical name: (PLCProcessA).
4. Enter a Station Name, if this is not filled then the Station Name takes the Station
Address by default (optional).
5. Enter a Station Address which is mandatory.
Example: 10.10.0.65 for Modbus TCP communication driver.
NOTE: If you are creating your Node-Red Data Source and you want to use a
secure connection, enter ssl://localhost:8883.
6. You can enable a PLC watch dog by checking the box and then you can enter the
information (optional).
7. Click Save.
Result: The Data Source is then added to the Stations window.
NOTE: You can keep track of the status of your stations (devices) or your driver.
You can see if they are connected or disconnected.
Modifying Driver Data Source Stations
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Stations.
3. Select one of the existing stations in the table.
66
EIO0000004482.02
Adding and Configuring Connected Nodes
4. Click
on the right of the Stations window.
Result: The Data Source — Attributes — Create/Modif... dialog box opens.
5. Modify the required information.
6. Click Save.
Removing Driver Data Source Stations
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Stations.
3. In the list of stations, click the station to be removed.
4. Click
on the right of the Stations window.
5. Click Yes to confirm the removal of the station.
Configuring Driver Data Source Attributes
In Attributes, you can add and configure the variables of the driver data source. The
variables can be connected to an element property (custom data model) or an equipment
property (data model hierarchy). You can also perform a manual mapping and an import/
export of your data sources.
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
EIO0000004482.02
67
Adding and Configuring Connected Nodes
2. Click Attributes.
NOTE: For the generic driver, if you use Manual Mapping, you need to provide the
Station and the Address.
NOTE: For the OPCUA, if you use Manual Mapping, you need to provide the
Browse Path and the Node ID.
NOTE: For the OPCDA, if you use Manual Mapping, you need to provide the Item.
68
EIO0000004482.02
Adding and Configuring Connected Nodes
NOTE: If you want to convert the value in the data source (for example, Celsius to
Fahrenheit), modify Scale Div and Scale Add with the required values.
3. Click
on the right of the Attributes window.
Result: The Data Source — Attributes — Import from Data Model dialog box opens.
EIO0000004482.02
69
Adding and Configuring Connected Nodes
4. Select your Equipment Property by clicking on the box on the left hand side of the
screen and then click Save.
NOTE: A delay can occur when you select multiple attributes to be imported,
therefore please wait for a couple of seconds before clicking Save. If you click Save
too quickly, there is a risk that some of the attributes may not appear on the
Attributes tab.
Result: The variable(s) is(are) added to the list of attributes.
NOTE: The Equipment Property is the type of variable to be collected from the
equipment defined in the data model.
NOTE: You can either Select All if you want to add all of your properties to be
imported or you can filter and select the property as required.
NOTE: You can use the Reload button which performs the manual synchronization
of the data model properties from the flow.
NOTE: You can also select multiple attributes and can assign in one operation all
the properties to an existing station that you have already created. Click,
right hand side of the Attributes window and then click Assign Station.
on the
Result: The Select Station dialog box opens.
Select your station and then click Save.
Export Attributes to CSV
After configuring the driver data source attributes, you can export the list of attributes to a
CSV file or part of the list from EcoStruxure Plant Data Expert. To see the exported CSV
format, refer to CSV External Mapping, page 72.
70
EIO0000004482.02
Adding and Configuring Connected Nodes
1. Click,
to Export Attributes to CSV.
Result: The Export Attributes to CSV dialog box opens.
Be sure to use the correct delimiter, if some of the information in the CSV file contains
characters that could be in conflict with the separators, this could cause an error. Please
use a separator in CSV format that is not used in the CSV. Example: Station Name is
"PLC1,Device1". Comma cannot be used as a delimiter.
2. Before Export, you can choose a delimiter. Select either Comma, Semicolon, Tab or
Pipe.
NOTE: To export only the selected attributes, check the box Only Selected
Attributes.
EIO0000004482.02
71
Adding and Configuring Connected Nodes
3. Click Export and the CSV file is saved to your local PC.
CSV External Mapping
For the import/export of .CSV file from Connected Nodes, please verify the order of the
column information. Do not add any other columns than expected.
•
For the Generic driver: Property, StationAddress, VariableAddress, StationName, Scale
Div, Scale Add, VariableName.
•
For the OPC: Property, Browse Path, NodeId, Scale Div, Scale Add, Type.
For the generic driver mapping, the import/export of .CSV file from the Connected Nodes
cannot be manipulated. The Type column is empty.
For the OPCUA mapping, the import/export of .CSV format is the StationAddress becomes
BrowsePath and the VARAddress becomes the NodeID.
For the export from Connected Nodes, the Typecolumn is empty.
For the OPCDA mapping, the import/export of .CSV format is the VARAddress becomes
Item (variable name in OPCDA) and StationAddress must be empty, has not to be
completed by the user.
For the export from Connected Nodes, the Type and the StationAddress columns are
empty.
Import Attributes From CSV
You can import the list of attributes or an updated file previously exported from the Flow or
from the Connected Nodes.
72
EIO0000004482.02
Adding and Configuring Connected Nodes
1. Click,
to Import Attributes from CSV.
Result: The Import Attributes from CSV dialog box opens.
NOTE: Fields Property, Type, Station/BrowsePath, Address/NodeID, Station
Name are mandatory when importing attributes from CSV, please make sure that
these have been updated accordingly before proceeding.
Be sure to use the correct delimiter, if some of the information in the CSV file contains
characters that could be in conflict with the separators, this could cause an error. Please
use a separator in CSV format that is not used in the CSV. Example: Station Name is
"PLC1,Device1". Comma cannot be used as a delimiter.
2. Click Choose a CSV file from you local PC.
EIO0000004482.02
73
Adding and Configuring Connected Nodes
3. Before Import, you can choose a delimiter. Select either Comma, Semicolon, Tab or
Pipe.
NOTE: You have the option to check the boxes Ignore errors or Replace existing
attributes before performing the Import. However please be aware that if you
ignore the errors, it’s still possible to Import.
4. Click Import
Result: The Data Source — Attributes — Import from CSV Status window opens.
NOTE: If you have an invalid CSV file, you can click Download Log to verify the
errors. A CSV file will then be saved to your local PC.
5. Click OK and then click Save and Build.
Modifying Driver Data Source Attributes
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Attributes.
3. Select one of the existing attributes in the table.
4. Click
on the right of the Attributes window.
Result: The Edit Attributes dialog box opens.
NOTE: If you are connected to the Node-Red, proceed to step 5.
74
EIO0000004482.02
Adding and Configuring Connected Nodes
5. There are two ways to do the mapping:
– Manual mapping:
1. Select Station or click
2. Enter the Address of the variable.
Example: %MW2
NOTE: If you are performing a mapping for Node-Red, the address must be the
same as what is given on Node-Red program.
3. If you want to convert the value in the data source (for example, Celsius to Fahrenheit),
modify Scale Div and Scale Add with the required values.
4. Click Save.
Result: The Manual Mapping is complete and the information is now updated on the
Attribute window.
NOTE: For each property you want to map, you do not have to Close the Edit
Attribute window, you can map multiple properties at a given time.
5. If you have finished mapping your properties, click Close.
EIO0000004482.02
75
Adding and Configuring Connected Nodes
6. Click Save and Build.
OR
– From File:
1. Click From File.
Result: The other Edit Attributes dialog box opens.
2. Click
to select a CSV file.
Result: The Data Attributes — Import from CSV dialog box opens.
76
EIO0000004482.02
Adding and Configuring Connected Nodes
Be sure to use the correct delimiter, if some of the information in the CSV file contains
characters that could be in conflict with the separators, this could cause an error. Please
use a separator in CSV format that is not used in the CSV. Example: Station Name is
"PLC1,Device1". Comma cannot be used as a delimiter.
3. Click Choose a CSV file from you local PC.
4. Before Import, you can choose a delimiter. Select either Comma, Semicolon, Tab or
Pipe.
5. Click Import.
6. Result: The From File is complete and the information is now updated on the Attribute
window. To view, click Close.
OPC Mapping
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Attributes.
3. Select one of the existing attributes in the table.
4. Click
on the right of the Attributes window.
Result: The Edit Attributes dialog box opens.
EIO0000004482.02
77
Adding and Configuring Connected Nodes
5. You have two ways to do the mapping for the drivers connected to OPC Server:
– Manual mapping:
1. Click Manual from Edit Attribute tab.
2. Enter the Browse Path and the Note ID.
3. If you want to convert the value in the data source (for example, Celsius to Fahrenheit),
modify Scale Div and Scale Add with the required values.
4. Click Save.
NOTE: Please note for OPCDA, you need to provide the Item for Manual
mapping.
78
EIO0000004482.02
Adding and Configuring Connected Nodes
OR
– From OPC Server (directly connected from OPC Server):
1. Select From OPC Server.
NOTE: It may take a couple of minutes for the root folder to display.
Result: The Root is displayed, you can browse for all the variables.
2. Select the Attribute you want to map.
3. Select the corresponding variable.
4. Click on Save.
NOTE: Before closing the From OPC Server tab, you can continue to do the
mapping to all the other Attributes. You can repeat the sequence by selecting a
new property and select a variable from the Root.
EIO0000004482.02
79
Adding and Configuring Connected Nodes
5. Click on Close.
6. Click on Save and Build.Result: The Commit changes confirmation dialog box
appears, click Yes to update the database and create the communications.
NOTE: You can Export Attributes to CSV from Data Source, refer to Export
Attributes to CSV, page 70.
Removing Driver Data Source Attributes
1. Click the CONNECTED NODES tab and select a driver data source in the left sidebar.
2. Click Attributes.
3. In the list of attributes, click on the attribute and then click on the checkbox on the right
of the Attributes window.
4. Click
which is also on the right of the Attributes window.
5. Click Delete from the drop-down list to remove the attribute.
Adding an MQTT Driver Data Source
1. Click the CONNECTED NODES tab.
80
EIO0000004482.02
Adding and Configuring Connected Nodes
2. Click
NOTE: The plus button turns to grey when applied.
Result: The Create New Data Source dialog box opens.
3. Enter a Name of the driver data source.
Example: MQTT
EIO0000004482.02
81
Adding and Configuring Connected Nodes
4. Click Driver and select MQTT [v1.14].
82
EIO0000004482.02
Adding and Configuring Connected Nodes
5. Click Create.
Result: The MQTT Data Source is created.
6. To upload certificates, click MQTT Certificates under the Behaviour Settings.
Result: The MQTT Certificates dialog box opens.
EIO0000004482.02
83
Adding and Configuring Connected Nodes
7. Click Add.
Result: The MQTT Add Certificate dialog box opens.
8. Under MQTT Add Certificate, insert an applicable Host, Port and from the dropdown
list select an Encryption Protocol.
NOTE: If you want to download the certificate, click Download.
9. Click Add and your MQTT Certificate is complete.
10. To add the MQTT Authentication Settings, click MQTT Authentication Settings under
the Behaviour Settings.
Result: The MQTT Authentication Settings dialog box opens.
11. To insert a Station, User Name and Password, click
information and then click OK.
84
update the necessary
EIO0000004482.02
Adding and Configuring Connected Nodes
12. To add the Stations for the MQTT Driver Data Source, go to Configuring Driver Data
Source Stations, page 65.
13. To add the Attributes for the MQTT Driver Data Source, go to Configuring Driver Data
Source Attributes, page 67.
Adding a Node-Red Driver Data Source
When the certificates are generated, you can configure the MQTT Broker to perform the
communication between Node-Red and EcoStruxure Plant Data Expert. It is important that
Node-Red software in running in order for the communication to be successful.
1. Click CONNECTED NODES.
a. Click
on the top left hand of the window next to Data Sources.
Result: The Create New Data Source window opens.
b. Locate a Driver in the table list called NRED, enter the Name of the driver and click
Create.
Example: Node-Red
Result: The Node-Red Driver is created.
NOTE: Certificates do not need to be uploaded to the Driver for the Node-Red
configuration as they are automatically received from the broker inside
EcoStruxure Plant Data Expert.
2. Configure your Stations to communicate with the MQTT broker which is embeded in
EcoStruxure Plant Data Expert, refer to Configuring Driver Data Source Stations, page
65.
EIO0000004482.02
85
Adding and Configuring Connected Nodes
3. Configure your Attributes, to also communicate with the MQTT broker which is
embeded in EcoStruxure Plant Data Expert, refer to Configuring Driver Data Source
Attributes, page 67.
When you have successfully configured your data source, you can now perform the
communication to read the values from Node-Red and EcoStruxure Plant Data Expert.
To see if the communication is successful between Node-Red and EcoStruxure Plant Data
Expert, under the FLOW > OT tab, filter your property and you will be able to visualize your
Value in the Read Value column.
Adding an IT System Data Source
An IT system data source is a connected node, connected to one SQL database installed
locally on the Harmony iPC or on a remote PC. To collect the data, you must configure the
messages of the IT system data source by connecting each message to a table in the
database and the columns of the table where the data to be collected is stored. Then you
can create message types, page 59 to send queries to the database.
1. Click the CONNECTED NODES tab.
2. Click
Result: Create New Data Source dialog box opens.
3. Enter a Name of the data source.
Example: Material Consumed
4. Click IT System to select the type of data source.
86
EIO0000004482.02
Adding and Configuring Connected Nodes
5. Enter the Connection String to connect to the SQL database. If not provided, you can
create your connection string as follows:
a. Click SQL Server Connection String Builder.
Result: The Select Column dialog box opens.
NOTE: The Provider should already be filled in, unable to edit.
b. Under Server Name, enter the server name of your SQL database in the following
format:
•
(LOCAL)\ServerName or (IP address)\ServerName for locally installed
database
•
(IP address)\ServerName for a remote database
c. Under Initial Catalog (Database Name), enter the name of your SQL database.
Example: SE_PlantDataExpert
d. Optionally, select the Use Windows Authentication checkbox if you want to use
the Windows authentication for the access to your SQL database.
e. Click Save.
Result: The connection string is added in the Connection String box. If the Use
Windows Authentication checkbox is cleared, then the connection string is
incomplete.
6. If not using the Windows authentication, enter the User and the Password of your SQL
database.
Result: The connection string is complete.
7. Click Test connection to test the connection with the SQL database.
Result: If your configuration is correct, then the connection is successful.
EIO0000004482.02
87
Adding and Configuring Connected Nodes
8. Click Save.
Result: The data source is added to the list of connected nodes. Click Edit if you want to
modify it or remove it.
Configuring IT System Data Source Messages
You can collect the data contained in the tables and the columns of a connected database
by creating and configuring messages. The messages are then used to create message
types in the Flow tab.
1. Click the CONNECTED NODES tab and select an IT system data source in the left
sidebar.
2. Click Messages.
3. Click
on the right of the Messages window.
Result: The IT Systems — Message Create dialog box opens.
4. Enter a Name of the message.
Example: Material Input
5. To add the table in the database where the data to be collected is stored:
a. Either click , then in the IT Systems - Message Create — Select Table dialog
box that opens, select the table and click Save.
b. Or select the Manual Configuration checkbox, then click
and in the Value
Input dialog box that opens, enter the name of the table and click Ok.
88
EIO0000004482.02
Adding and Configuring Connected Nodes
6. Click Add Column, then:
a. Either select a column(s) from the table in the IT Systems - Message Create Select Columns dialog box that opens, then click Add.
Result: The message(s) is(are) added to the list of messages.
b. Once you have added the column(s), click Close.
NOTE: A delay can occur when you select multiple messages, therefore please
wait for a couple of seconds before clicking Save. If you click Save too quickly,
there is a risk that some of the messages may not appear on the Messages
tab.
c. Click Save.
d. Or enter the name of a column from the table in the Value Input dialog box that
opens, then click Ok.
Result: The message is added to the list of messages.
Click Save.
NOTE: To remove a column, tick the box in the Remove column and then click
Remove Columns. The Removal Confirmation dialog box opens, then you can
select Yes.
7. Click Save and Build on the right of the Messages window, then click Yes to build and
apply the message configuration.
EIO0000004482.02
89
Adding and Configuring Connected Nodes
Modifying IT System Data Source Messages
1. Click the CONNECTED NODES tab and select an IT system data source in the left
sidebar.
2. Click Messages.
3. Click
on the right of the Messages window.
Result: The IT Systems — Message Create dialog box opens.
4. Modify the required information.
5. Click Save.
6. Click Save and Build on the right of the Messages window, then click Yes to build and
apply the message configuration.
Removing IT System Data Source Messages
1. Click the CONNECTED NODES tab and select an IT system data source in the left
sidebar.
2. Click Messages.
3. In the list of messages, click the message to be removed.
4. Click
on the right of the Messages window.
5. Click Yes.
NOTE: Be aware, if you have one a more message types associated to the
message you want to remove, you will not be able to remove it at this point.
6. Click Save and Build on the right of the Messages window, then click Yes to build and
apply the message configuration.
Removing a Connected Node
If an IT system data source contains messages that are used in a message type, you first
need to remove these messages from the message type, before you can remove the IT
system data source. A driver data source can be removed without removing its attributes.
90
EIO0000004482.02
Adding and Configuring Connected Nodes
You cannot remove a connected node if the information is referenced such as a Variable
mapped to a property, a property used in a condition or a computation and a message used
in a message type.
1. Click the CONNECTED NODES tab.
2. In the left sidebar, click the data source to be removed.
Result: The data source parameters are displayed.
3. Click Edit.
Result: The Delete button is displayed.
4. Click Delete, then click Yes on the Delete Data Source window that pops up.
EIO0000004482.02
91
Adding and Configuring Application Nodes
Adding and Configuring Application Nodes
What’s in This Chapter
Adding an Application Node......................................................92
Configuring an Application Node ...............................................92
Removing an Application Node .................................................93
An application node is the destination in the EcoStruxure Plant Advisor — Data Hub where
the data collected from the driver and IT system data sources is sent, after being processed
by EcoStruxure Plant Data Expert.
Adding an Application Node
1. Click the APPLICATION NODES tab.
2. Click +.
Result: The Add Application Node dialog box opens.
3. In Node Name, enter a name of the application node.
4. Click Add Application Node.
Configuring an Application Node
1. Click the APPLICATION NODES tab.
2. Click the application node to be configured.
The status icon on the left of the application node name indicates if you are connected
to the data destination.
3. In Period, select the frequency of sending data to the destination. You can choose
between 10 minutes (for compressed data files of size up to 1 MB) and 1 hour (for
compressed data files of size up to 100 MB).
4. Optionally, activate Send notification when communication is lost and configure the
notification, page 101 to inform you if the connection between EcoStruxure Plant Data
Expert and the destination is unavailable.
92
EIO0000004482.02
Adding and Configuring Application Nodes
5. Optionally, configure Send notification when buffer overflow occurs to inform you
when the buffer is full. This occurs when EcoStruxure Plant Data Expert receives more
data than it is configured to send to the application node.
6. In Expiration Period (hours), enter the number of hours before ending the data
transfer to the destination. When the expiration period ends, the data files are archived
and you can verify which data has not been transferred. The maximum expiration
period is 36 hours.
7. Optionally, activate Send notification when data expires and configure the
notification, page 101 to inform you if the transfer is unsuccessful.
8. Click Save.
Removing an Application Node
1. Click the APPLICATION NODES tab.
2. Click the application node to be removed.
3. Click
on the right of the application node configuration page.
4. Click Confirm.
EIO0000004482.02
93
Computations
Computations
What’s in This Chapter
Creating a Computation............................................................94
Modifying a Computation ..........................................................95
Removing a Computation .........................................................96
In EcoStruxure Plant Data Expert, you can create computations with the value of different
driver source variables, before sending the data to the application node. A computation can
be created with the value of one or several variables. You can create up to seven
computations in a project.
Creating a Computation
1. Click the COMPUTATIONS tab.
2. Click
3. In Name, enter a name of the computation.
4. Click
to select the variable where the result of the computation is to be stored.
Result: The Select Equipment Properties dialog box opens.
5. Click the variable in the list, then click Save.
94
EIO0000004482.02
Computations
6. Click Add Properties to add a variable for the computation.
Result: The Create Computation — Associate Equipment Property with Variable
dialog box opens.
7. Click the variable in the list, then click Add.
NOTE: You can add as many properties as you desire.
8. Once you have finished adding your properties, click Close.
9. Click the letter (B, C,...) next to the variable to be added in FORMULA.
10. To add the required action, click the corresponding symbols under BUILD FORMULA.
11. Click Insert to save the computation formula.
Result: The computation is added to the list of computations.
12. Click the new computation in the list.
13. Click Save and Build on the bottom right of the Computation window, then click Yes to
build and save your computation.
Modifying a Computation
1. Click the COMPUTATIONS tab.
2. In the list of computations, click the computation to be modified.
3. Click
on the right of the Computation window.
Result: The computation configuration opens.
EIO0000004482.02
95
Computations
4. Modify the required values.
5. Click Save.
6. Click Save and Build on the bottom right of the Computation window, then click Yes to
build and save your computation.
Removing a Computation
1. Click the COMPUTATIONS tab.
2. In the list of computations, click the computation to be removed.
3. Click
on the right of the Computation window.
4. Click Yes.
5. Click
on the right of the Computation window, then click Yes to build and save your
modifications.
96
EIO0000004482.02
Conditions
Conditions
What’s in This Chapter
Creating a Condition ................................................................97
Modifying a Condition...............................................................98
Removing a Condition ..............................................................99
In EcoStruxure Plant Data Expert, you can create conditions with the value of different driver
data source variables in order to collect specific data from the connected equipment, and
then select which variables to be sent to the application node.
Creating a Condition
1. Click the Conditions tab.
2. Click
.
3. In Name, enter a name of the condition.
4. Click Add Properties to add a variable for the condition.
Result: The Select Equipment Properties dialog box opens.
5. Click a variable in the list, then click Save.
NOTE: You can add up to seven properties.
EIO0000004482.02
97
Conditions
6. Click the letter (B, C,...) next to the variable to be added in CONDITION.
7. To add the required action, click the corresponding symbols under BUILD CONDITION.
NOTE: The condition cannot exceed 1024 characters, as displayed in the Preview.
If you reach 1024 characters, no more symbols or properties can be added to the
condition.
8. Under ACTION, select one of the following:
a. Forward — click Add Variables, then select the variables where the condition
result is to be sent, and click Save. The variables are sent to the application node
only when the condition is reached.
NOTE: You can add up to nine variables.
b. Alert — create a notification, page 101 and configure the frequency of sending the
result to the application node.
9. Click Save to save the condition.
Result: The condition is added to the list of conditions.
10. Click the new condition in the list.
11. Click
on the right of the Conditions window, then click Yes to build and save your
condition.
Modifying a Condition
1. Click the CONDITIONS tab.
98
EIO0000004482.02
Conditions
2. In the list of conditions, click the condition to be modified.
3. Click
on the right of the Conditions window.
Result: The condition configuration opens.
4. Modify the required values.
5. Click Save.
6. Click
on the right of the Conditions window, then click Yes to build and save your
modifications.
Removing a Condition
1. Click the CONDITIONS tab.
2. In the list of conditions, click the condition to be removed.
3. Click
on the right of the Conditions window.
4. Click Yes to confirm for deleting item.
EIO0000004482.02
99
Monitoring
Monitoring
In the FLOW tab, you can see an overview of the items and the state of your projects by
clicking on the Monitoring IT subtab.
1. Filter — Filter menu.
a. Type — the data type of the variable value.
b. Connected Nodes — the data sources, equipment or database, installed or connected
to the Harmony iPC, and sending data to EcoStruxure Plant Data Expert.
c. Application Nodes — the data collected from the driver and IT system data sources is
sent, after being processed by EcoStruxure Plant Data Expert.
2. List of variables:
a. Name — the name of the message type.
b. Type — the message type.
c. File Name —the file generated by EcoStruxure Plant Data Expert.
d. Connected Node — the name of the connected node configured to access to a
database.
e. Application Nodes — where the result of the message type is sent to.
100
EIO0000004482.02
Alerts and Notifications
Alerts and Notifications
What’s in This Chapter
Configuring Notifications......................................................... 101
Box Diagnostics..................................................................... 102
Removing Alerts .................................................................... 102
In EcoStruxure Plant Data Expert, you can associate a notification to any alert and configure
it to inform you about the state of your equipment. Some alerts are activated by default (for
example, CPU or memory alert).
An overview of all the alerts sent by EcoStruxure Plant Data Expert is available in the
internal alert center.
The active alerts are sent automatically by EcoStruxure Plant Data Expert. To receive
notifications by e-mail or to set specific parameters, you need to configure the notifications.
Notifications can be set during the configuration of connected nodes and application nodes.
You can also set notifications to inform you about the state of your Harmony iPC, or the
expiration of your license.
Configuring Notifications
1. Activate an alert:
a. When creating or modifying your connected nodes or application nodes
b. In Menu > Diagnostics
c. In Menu > Licensing
d. In Menu > Files > Archive
2. Select Notification if it’s unselected and then click
.
Result: The Notification Settings dialog box opens.
3. In Priority, select the required priority.
4. By default, the notifications are sent to the internal alert center. Select the E-mail
checkbox and enter an email to receive notifications by email.
NOTE: You need to configure the SMTP settings, page 43 in order to receive emails.
5. In Frequency, select how often to receive notifications.
EIO0000004482.02
101
Alerts and Notifications
6. Click Save.
Box Diagnostics
In Menu > Diagnostics > Performance, you can configure notifications, page 101 to inform
you about the state of your Harmony iPC.
The following state parameters are available:
•
CPU
•
Memory
•
Ethernet
•
Disk
For more information on the state of these parameters, click Download Log Files. The log
files are automatically downloaded in the default location on the PC.
Removing Alerts
Click the toolbar icon of the internal alert center to see the list of alerts sent by EcoStruxure
Plant Data Expert.
102
EIO0000004482.02
Alerts and Notifications
After viewing the received alerts, they can be removed from the list as follows:
1. Click
next to ALERTS.
Result: Empty checkboxes appear on the left of each item in the list.
2. Either select the checkbox of the alert to be removed, or select the checkbox next to
Priority if you want to remove all the alerts in the list.
3. Click Acknowledge Selected Alerts in the down right corner, then click Confirm.
EIO0000004482.02
103
EcoStruxure Plant Data Expert API for External
Applications
EcoStruxure Plant Data Expert API for
External Applications
With the EcoStruxure Plant Data Expert API, you can access the content of your project
from your external applications. You can test the requests to the API, during your application
development, using a swagger tool.
The EcoStruxure Plant Data Expert API documentation is available in Menu > Help > API
Documentation.
A sample JS file is available in the Local Disk (C:) > Program Files (x86) > Schneider
Electric > EcoStruxure Plant Data Expert > Documentation > sample > application > js
folder, created during the installation of EcoStruxure Plant Data Expert. This script file
provides access to the EcoStruxure Plant Data Expert API and examples of basic calls.
104
EIO0000004482.02
Schneider Electric
35 rue Joseph Monier
92500 Rueil Malmaison
France
+ 33 (0) 1 41 29 70 00
www.se.com
As standards, specifications, and design change from time to
time, please ask for confirmation of the information given in
this publication.
© 2022 Schneider Electric. All rights reserved.
EIO0000004482.02

* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project