Schneider Electric EcoStruxure Augmented Operator Advisor - Runtime 取扱説明書

.....................................................................................................................9

...........................................................................................................................13

EcoStruxure Augmented Operator Advisor Runtime 简介 ..........................................13

EcoStruxure Augmented Operator Advisor Runtime 接口 ..........................................14

添加文档 ................................................................................................................15

使用

EcoStruxure Augmented Operator Advisor Manager

..............................16

启动 EcoStruxure Augmented Operator Advisor Manager .........................................16

用户管理 ................................................................................................................17

注释管理 ................................................................................................................21

过程管理 ................................................................................................................22

使用

Node-RED

......................................................................................................24

Node-RED 管理 .....................................................................................................24

示例：将来自 MySQL 数据库的数据整合到 EcoStruxure Augmented Operator

Advisor 中 ..............................................................................................................25

示例：将来自 EcoStruxure Augmented Operator Advisor 的数据写入到 MySQL 数

据库 ......................................................................................................................31

术语 ...........................................................................................................................35

EIO0000003611.08

安全信息

安全信息

Runtime

重要信息

在试图安装、操作、维修或维护设备之前，请仔细阅读下述说明并通过查看来熟悉设备。下

述特定信息可能会在本文其他地方或设备上出现，提示用户潜在的危险，或者提醒注意有关

阐明或简化某一过程的信息。

在“危险”或“警告”标签上添加此符号表示存在触电危险，如果不遵守使用说明，

会导致人身伤害。

这是提醒注意安全的符号。提醒用户可能存在人身伤害的危险。请遵守所有带此符号

的安全注意事项，以避免可能的人身伤害甚至死亡。

危险

危险表示若不加以避免,将会导致严重人身伤害甚至死亡的危险情况。

警告

警告表示若不加以避免,可能会导致严重人身伤害甚至死亡的危险情况。

小心

小心表示若不加以避免,可能会导致轻微或中度人身伤害的危险情况。

注意

注意用于表示与人身伤害无关的危害。

请注意

电气设备的安装、操作、维修和维护工作仅限于有资质的人员执行。施耐德电气不承担由于

使用本资料所引起的任何后果。

EIO0000003611.08

Runtime

安全信息

有资质的人员是指掌握与电气设备的制造和操作及其安装相关的技能和知识的人员，他们经

过安全培训能够发现和避免相关的危险。

8 EIO0000003611.08

关于本书

Runtime

文档范围

本文档介绍 EcoStruxure Augmented Operator Advisor Runtime 和内置 EcoStruxure

Augmented Operator Advisor Manager 。

在使用本文档前，请先阅读 EcoStruxure Augmented Operator Advisor Quick Start Guide ，

以便大概了解 EcoStruxure Augmented Operator Advisor 。

建议您在使用本产品前先接受 EcoStruxure Augmented Operator Advisor 培训。

有效性注意事项

本文档适用于 EcoStruxure Augmented Operator Advisor 的版本 2.9

。

注册商标：

• EcoStruxure

™

、 Vijeo

™

和 Harmony

™

是 Schneider Electric 的注册商标。

• Chrome

™

、 Google Pixel C

™

和 Android

™

是 Google LLC 的注册商标。

• Microsoft Edge

™

和 Windows

™

是 Microsoft Corporation 的注册商标。

• Firefox

™

是 The Mozilla Foundation 的注册商标。

• iOS

™

和 iPad

™

是 Apple 的注册商标。

• Samsung Galaxy

™

是 Samsung Electronics Co Ltd 的注册商标。

• Intel

Core

™

是 Intel Corporation 的注册商标。

• Linux

是 Linus Torvalds 的注册商标。

EIO0000003611.08

Runtime

产品相关信息

应用此产品要求控制系统的设计和操作方面的专业知识。

警告

失去控制

• 任何控制方案的设计者都必须考虑到控制路径可能出现故障的情况，并为某些关键控制

功能提供一种方法，使其在出现路径故障时以及出现路径故障后恢复至安全状态。关键

控制功能的例子包括紧急停止和越程停止。

• 对于关键控制功能，必须提供单独或冗余的控制和监视路径。

• 系统控制和监视路径可包括通讯链路。必须对暗含的无法预料的传输延迟或链接失效问

题加以考虑。

• EcoStruxure Augmented Operator Advisor 不得用作监视关键控制功能的主要工具。

• 为了保证正确运行，在投入使用前，必须对 EcoStruxure Augmented Operator Advisor

的每次执行分别进行全面测试。

未按说明操作可能导致人身伤亡或设备损坏等严重后果。

警告

意外的设备操作

• 只有在控制系统的设计和操作方面具有丰富专业知识的授权人员才能够对本产品进行编

程、安装、改动和应用。

• 请遵守当地和国家的安全法规和标准。

未按说明操作可能导致人身伤亡或设备损坏等严重后果。

小心

假场景检测

• 如果相似的设备和 / 或环境可能导致检测到假场景，请使用标签。

• 将标签牢牢地设置到设备，并采用足够的保护措施来防止标签受损或退化。

不遵循上述说明可能导致人身伤害或设备损坏。

EIO0000003611.08

Runtime

注意

未授权的操作员访问

• 注意对用户名和密码保密。

• 用密码或其他安全机制保护平板电脑和 Runtime 设备。

• 不得与他人共享访问。

• 首次连接时，更改缺省密码。

• 定期更新密码。

• 应用相关的本地 IT 规则。

• 不得将保密性信息保存在便利贴或笔记本中。

• 不要在项目中添加机密性或敏感性用户文档。

不遵循上述说明可能导致设备损坏。

12 EIO0000003611.08

Runtime

EcoStruxure Augmented Operator Advisor

Runtime 简介

EcoStruxure Augmented Operator Advisor Runtime 安装在 Harmony GTU Open Box PC 、

Harmony iPC / 工业 PC 或标准 Windows PC 上（请参阅《 EcoStruxure Augmented

Operator Advisor 快速入门指南》）。

EcoStruxure Augmented Operator Advisor Runtime 将目标点中要显示的所有信息收集到一

起，并发送至平板电脑以便通过 EcoStruxure Augmented Operator Advisor App 来显示。它

还管理包含场景和设备照片的数据库，这些照片包含在上传的项目中。

安装 EcoStruxure Augmented Operator Advisor Runtime 前，必须满足以下前提条件：

• 必须安装 Microsoft .NET Framework 版本 4.7.2

或更高版本。

• 必须将运行时设备安装在现场或建筑物内的封闭机柜中，以防遭到未授权使用。

• EcoStruxure Augmented Operator Advisor Runtime 必须由对运行时设备具有管理员权

限的用户安装。

• 软件安装和使用的所有文件夹和文件必须存储在需要管理员权限的位置。

• 必须对安装有 EcoStruxure Augmented Operator Advisor Runtime 的硬盘加密，以（例

如，使用 BitLocker ）保护用户数据库的安全。

• 只有经授权的用户才能部署项目。针对运行时设备上项目数据文件的访问，设置权限。

EIO0000003611.08

Runtime

EcoStruxure Augmented Operator Advisor

Runtime 接口

7 8

Augmented Operator Advisor – Runtime 版本 x.y

项目

文档

设置

Node-RED

语言

AOA Manager

Augmented Operator Advisor

版本 x.y

许可证状态

已激活

访问 EcoStruxure Augmented Operator Advisor Manager, 16 页

服务器已启动

项目导入在 EcoStruxure Augmented Operator Advisor Builder 中创建的已生成的 .zip

项目文件。会显示已导入项目的信息。

文档导入 .zip

文件以在 EcoStruxure Augmented Operator Advisor Runtime 中托管文

档，或者配置对文档位置的远程访问。会显示所支持的文档数或者这些文档的 URL 地

址。

设置配置 EcoStruxure Augmented Operator Advisor Runtime 的端口设置以及与

EcoStruxure Machine Advisor 的连接（请参阅 “EcoStruxure Augmented Operator

Advisor 快速入门指南 ” ）。

Node-RED 配置与 Node-RED 的连接。

语言选择 EcoStruxure Augmented Operator Advisor Runtime 的语言。

帮助查看 EcoStruxure Augmented Operator Advisor 的用户文档。

关于显示产品版本以及许可证相关信息。

14 EIO0000003611.08

Runtime

添加文档

在文档选项卡中，可以添加先前导入 EcoStruxure Augmented Operator Advisor Builder 中的

托管文档。

根据文档的存储位置（本地或远程），可以有两种方法来添加文档。

本地文档存储在 EcoStruxure Augmented Operator Advisor Runtime 中。因此，它们可以供

EcoStruxure Augmented Operator Advisor App 随时访问，无需占用平板电脑的存储空间。

如果没有 IT 基础设施来托管文档，可以使用这个选项。

如有相关 IT 基础设施，则可以使用远程文档选项来配置到文件服务器的重定向或代理。

前提条件：添加文档之前，请设置并更新 Runtime 设备和文件服务器上的企业杀毒软件。

如要通过已导入 EcoStruxure Augmented Operator Advisor Builder 中的 .zip

文件来导入本

地文档：

启动 EcoStruxure Augmented Operator Advisor Runtime ，然后单击文档选项卡。

选择本地文档。

单击浏览，然后选择要导入的 .zip

文件。

注 : EcoStruxure Augmented Operator Advisor 使用的是代码页 437 。在创建 .zip

文

件时，如果在导入后， .zip

文件中包含的文件的名称未正确显示，则使用 Unicode

选项 (UTF-8) 。

单击应用。

结果：显示所支持的文档数。

注 : 或者，如果要添加的文档数较少，可以将所支持的文档直接复制到开始 >

EcoStruxure Augmented Operator Advisor > Runtime 文档文件夹。

如要配置对远程文档的访问：

启动 EcoStruxure Augmented Operator Advisor Runtime ，然后单击文档选项卡。

选择远程文档。

选择重定向或代理，然后输入文档位置的 URL 地址。

单击应用。

EIO0000003611.08

Runtime

使用

EcoStruxure Augmented Operator

Advisor Manager

EcoStruxure Augmented Operator Advisor Runtime 包括 EcoStruxure Augmented Operator

Advisor Manager ，它在安装了 EcoStruxure Augmented Operator Advisor Runtime （请参阅

《 EcoStruxure Augmented Operator Advisor 快速入门指南》）时自动安装。

利用 EcoStruxure Augmented Operator Advisor Manager 软件，您可以：

• 管理用户证书（ Runtime/Manager 和 Operator ），并在用户选项卡中查看所有用户（已

添加的、已删除的或已修改的用户）。

• 在 EcoStruxure Augmented Operator Advisor App 的生产者选项卡中，查看操作员完成

的所有操作。

• 在 EcoStruxure Augmented Operator Advisor App 的注释选项卡中，查看操作员创建的

所有场景注释。

启动 EcoStruxure Augmented Operator Advisor

Manager

启动 EcoStruxure Augmented Operator Advisor Manager 之前，确保 Runtime 设备上安装

有 EcoStruxure Augmented Operator Advisor Runtime Runtime 设备上安装有 EcoStruxure

Augmented Operator Advisor Runtime ，已配置防火，且端口检查成功完成（请参阅

《 EcoStruxure Augmented Operator Advisor 快速入门指南》）。

注 : 只有拥有 Admin 权限的用户才能够登录到 EcoStruxure Augmented Operator

Advisor Manager 软件。

如要启动 EcoStruxure Augmented Operator Advisor Manager ：

16 EIO0000003611.08

步骤

Runtime

操作

打开 EcoStruxure Augmented Operator Advisor Runtime ，然后单击 AOA Manager 。

结果： EcoStruxure Augmented Operator Advisor Manager 在缺省 Web 浏览器中打开。

注 :

• 首次启动软件时，会激活许可证，如果使用的是试用版本，则会显示许可证的剩余有效

天数。

• 必须保持 EcoStruxure Augmented Operator Advisor Runtime 在后台运行。如果

EcoStruxure Augmented Operator Advisor Runtime 未运行，就无法登录到 EcoStruxure

Augmented Operator Advisor Manager 。

使用缺省用户名和密码 (admin/admin) 登录。

Augmented Operator Advisor Manager

语言

密码密码

3 在打开的窗口中，按照说明输入新管理员密码。

注 :

• 将密码保存在安全的地方，并提供适当的保护。

• 如要重置已忘记的密码，需联系技术支持部。

用户管理

概述

EcoStruxure Augmented Operator Advisor 的用户有三种类型：

• Builder 用户

EIO0000003611.08

Runtime

• Runtime/Manager 管理员

• Operator 用户

Builder 用户是那些将访问 EcoStruxure Augmented Operator Advisor Builder 的用户。没有

证书的用户可以在 Builder 登录屏幕中注册。

Runtime/Manager 管理员负责使用 EcoStruxure Augmented Operator Advisor Manager 配

置用户和安全设置。 Runtime/Manager 管理员必须拥有管理员权限（最高安全级别）。

Operator 用户是那些将使用 EcoStruxure Augmented Operator Advisor App 的用户。根据

他们的不同用户权限（安全级别），他们将访问应用程序中的不同对象。在 Builder 项目

中，对象具有安全级别数值。安全级别数值等于或大于对象安全级别的 Operator 用户可以查

看对象并与对象交互。否则，对象被隐藏或无法访问。

注 :

• EcoStruxure Augmented Operator Advisor Manager 仅能够管理（创建 / 修改 / 删除）

用户（ Runtime 和 Operator ）。无法创建 Builder 用户。

• 无法删除 Admin 组。

创建组

Runtime 设备上的 EcoStruxure Augmented Operator Advisor Manager 能够用于创建 / 修改 /

删除组，并为这些组配置安全设置。

Operator 用户被划分为若干组。组内允许：

• 在操作员之间分享活动。

• 定义安全级别，以便针对项目内的特定内容提供或限制访问权限。

例如，为特定生产线的 Operator 用户创建的组。这有助于避免操作员受到别组活动的干扰。

在 EcoStruxure Augmented Operator Advisor App 中，同组内的 Operator 用户可查看相同

的信息，并分享其活动的历史记录。每个 Operator 用户可以查看同组其他用户上次使用的或

使用得最多的场景和过程。

以下过程说明了如何在 EcoStruxure Augmented Operator Advisor Manager 中创建组：

18 EIO0000003611.08

步骤

操作

单击用户选项卡。

Runtime

单击添加组，创建新用户组。

对组命名，并输入安全级别。

安全级别是介于 0 与 65535 之间的数字。数字越大，安全权限就越大。 Admin 权限对应于最高安

全级别 65535 。组内的所有用户都具有该组的安全级别。

单击确认，确认组创建。

EIO0000003611.08

Runtime

创建 Operator 用户

Runtime 设备上的 EcoStruxure Augmented Operator Advisor Manager 可用于创建 / 修改 / 删

除 Operator 用户。

如要访问 EcoStruxure Augmented Operator Advisor App 中的项目，首先需要创建组，然后

创建属于此组的 Operator 用户。

以下过程说明了如何在 EcoStruxure Augmented Operator Advisor Manager 中创建

Operator 用户：

步骤

操作

单击用户选项卡，然后单击添加用户，以创建新用户。

输入您的用户名和密码。

选择用户所属的组。

单击确认，确认用户创建。

注 : 您可以选中专用模式复选框，为用户授予专用权限。 Expert 用户能够跳转到任一步骤，而

非 Expert 用户则必须一一沿循这些步骤。

EIO0000003611.08

更改 Runtime/Manager 用户密码

Runtime

在页面右上角，单击 Runtime/Manager 用户的详细信息，从下拉列表中选择配置信息，更改

密码。

注释管理

注释选项卡

在此选项卡中，您可以看到操作员在 App 中创建的所有注释。当在其平板设备上运行 App

时，操作员可以在场景或子场景中创建注释。操作员输入到 “ 注释 ” 中的信息可以用来改善项

目。此列表仅列出最近的 1000 个条目。

1 2 3 4 5

Augmented Operator Advisor Manager

用户过程注释

注释 admin

A admin 更换滤网 - 更换滤网。上次更换为 2019 年

A admin 胎压过低 -

前胎胎压过低

A admin 问题 1 - 上次更换时，未正确安装滤网

4 分钟前

6 分钟前

1 小时前

胎压过低

A admin

年

月

日

15:06

（

前胎胎压过低

Spiders.pdf

上次修改执行人 admin

修改时间

删除日期

10/05/2021 15:50:39

从未删除

项目

区域

场景

Excav1

AR1

Dev 桥

EIO0000003611.08

Runtime

注释列表中的注释以时间顺序排列。尚未查看过的新注释或经修改的注释显示为粗体。

每个列表条目包含：

• 复选框，

• 创建或修改注释的用户的用户名，

• 注释的名称和描述，

• 注释自创建或修改起经过了多长时间。

单击列表条目，可在右侧显示注释详细信息和附件。日期和时间显示为 EcoStruxure

Augmented Operator Advisor App 的本地时间。

导出选定项。在导出包含附件的注释时，附件不会一同导出。导出文件存储为 .csv

格

式，以逗号作为分隔符。

将选定项从 EcoStruxure Augmented Operator Advisor Manager 中永久删除。

重新加载将列表与 EcoStruxure Augmented Operator Advisor Runtime 同步。

绿色 / 灰色指示绿色表示注释在 EcoStruxure Augmented Operator Advisor App 中可

用。灰色表示注释已从 App 中删除，且仅在 EcoStruxure Augmented Operator Advisor

Manager 中可用。

在注释包含附件时才显示

注 : 可以通过 EcoStruxure Augmented Operator Advisor Runtime V2.8

将附件添加

到注释。如果使用早先的版本，则只能创建不含附件的注释。

过程管理

过程选项卡

在此选项卡中，您可以看到操作员在 EcoStruxure Augmented Operator Advisor App 中执行

的所有过程的列表。您可以看到项目的名称、过程执行的日期和时间、所采取的具体步骤、

以及执行过程的用户的名称。此列表仅列出最近的 1000 个条目。

22 EIO0000003611.08

1 2 3 4

Augmented Operator Advisor Manager

用户过程

历史记录

注释

A admin 更换（10/5/2021 15:54:12）

A admin 更换（10/5/2021 15:53:52）

A admin 滤网（10/5/2021 15:53:13）

A admin 轮胎（10/5/2021 15:50:49）

A admin 更换（10/5/2021 15:12:20） admin 更换（10/5/2021 15:08:05）

A admin 轮胎（10/5/2021 15:02:19） admin

更换（10/5/2021 15:12:20）

0 分钟 1 分钟前

0 分钟 2 分钟前

2 分钟 2 分钟前

1 分钟 5 分钟前

4 分钟 43 分钟前

0 分钟 1 小时前

2 分钟 1 小时前

A admin

开始日期 10/05/2021 ， 15:08:41

结束日期 10/05/2021 ， 15:12:20

持续时间 4 分钟

开始

10/05/2021

15:12:03

2021 年 10 月 5 日 15:12（43 分钟前）

项目

区域

Excav 1

AR1

步骤 1 admin 3 分 22 秒专用模式开

Runtime

10/05/2021

15:12:20

结束 admin

过程列表中的过程以时间顺序排列。每个列表条目包含：

• 复选框，

• 执行过程的用户的用户名，

• 过程名称，以及执行过程的日期和时间，

• 过程的持续时间，

• 自过程执行起经过了多长时间。

单击列表条目，可在右侧显示过程的详细信息。如果过程包含附件，则单击附件，可全

屏显示此附件。

导出选定项。导出文件存储为 .csv

格式，以逗号作为分隔符。

将选定项从 EcoStruxure Augmented Operator Advisor Manager 中永久删除。

重新加载将列表与 EcoStruxure Augmented Operator Advisor Runtime 同步。

EIO0000003611.08

Runtime

使用

Node-RED

Node-RED 管理

简介

Node-RED 是一款开源可视化编程工具，它几乎不需要编程技能。它使用的是预编程且可重

复使用的代码块（称为节点）。节点线连接在一起，以创建数据流。您可以将 Node-RED 流

连接到目标点，进而在您的增强现实应用程序中显示 SQL 数据库。

如要使用 Node-RED ，请从 nodered.org

进行下载，然后将其安装到 Runtime 设备上。

EcoStruxure Augmented Operator Advisor Runtime 兼容 Node-RED 所推荐的 Node.js 14.

LTS 。

EcoStruxure Augmented Operator Advisor 节点位于开始 > EcoStruxure Augmented

Operator Advisor > Runtime 节点文件夹中。

用户身份验证的配置和设置直接在 Node-RED 中执行。有关更多信息，请参阅 Node-RED

文档。

设置

在 EcoStruxure Augmented Operator Advisor Runtime 的 Node-RED 选项卡中，可以配置

Node-RED 与 EcoStruxure Augmented Operator Advisor Runtime 之间的连接。

1 2

Augmented Operator Advisor – Runtime 版本 x.y

Node-RED 端口 1880 应用

项目

端口 1880 的状态已停止 3

文档

版本

路径 C:\Users\user12345\AppData\Roa 浏览

0.20.1

设置自动启动

Node-RED 启动 7

24 EIO0000003611.08

Runtime

1 在 Runtime 设备上安装 Node-RED 期间定义的端口号。

2 单击可应用端口号（如果对其进行了修改）。

3 已启动 / 已停止。显示 Node-RED 状态（ Node-RED 是否在运行）。

4 显示正使用的 Node-RED 版本。

5 单击浏览按钮，选择所使用的 Node-RED 启动脚本所在的文件夹，然后进行验证，随后便

会显示所选文件夹的路径。

6 或者，如要在下次启动 EcoStruxure Augmented Operator Advisor Runtime 时自动启动

Node-RED ，则勾选自动启动复选框（路径字段的输入必须正确）。

7 启动 / 停止。单击可手动启动或停止 Node-RED （路径字段的输入必须正确）。

示例

：

将来自 MySQL 数据库的数据整合到

EcoStruxure Augmented Operator Advisor 中

概述

MySQL 数据可以被整合到 EcoStruxure Augmented Operator Advisor 中。这里提供了两个

示例，说如如何执行此操作。

起始样例

下面的样例显示了 SQL 变量在 EcoStruxure Augmented Operator Advisor 中的整合。在调

用了 SQL 之后， MySQL 数据库会返回两行数组，其中包含变量名称和相关值。来自

MySQL 数据库每个变量名称都与 EcoStruxure Augmented Operator Advisor 变量相关联。

EIO0000003611.08

Runtime

将起始样例流部署到 Node-RED 中

如要在 Node-RED 中部署此数据流：

首先，复制以下代码。

[{"id":"90aecf00.2d5e3","type":"debug","z":"4a407662.78a494","name":"-

Optional help node for debugging the Augmented Operator result","active":true,"tosidebar":true,"console": false,"complete":"statusCode","x":830,"y":500,"wires":[]},

{"id":"56ad79c5.7a0d98","type":"Augmented-Operatorserver","z":"4a407662.78a494","arserverport":"8082","arservermethod":"PUT","arserverbufferinterval":"0","x":760,"y":460,"wires":

[["90aecf00.2d5e3"]]},{"id":"93b1903e.49d6d","type":"Augmented-

Operatorvariable","z":"4a407662.78a494","arservervarnamespace":"","arservervarname":"ARvar2","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":580,"y":420,"wires":

[["56ad79c5.7a0d98"]]},{"id":"f6f6007e.2ccff","type":"Augmented-

Operatorvariable","z":"4a407662.78a494","arservervarnamespace":"","arservervarname":"ARvar1","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":580,"y":380,"wires":

[["56ad79c5.7a0d98"]]},{"id":"cc9333f9.

d89d8","type":"change","z":"4a407662.78a494","name":"","rules":

[{"t":"set","p":"payload","pt":"msg","to":"payload.

value","tot":"msg"},

{"t":"set","p":"topic","pt":"msg","to":"","tot":"str"}],"action":"","property":"","from":"","to":"","reg": false,"x":420,"y":360,"wires":[["93b1903e.49d6d"]]},

26 EIO0000003611.08

Runtime

{"id":"3ffbe32c.1d252c","type":"function","z":"4a407662.78a494","name":"Error mgnt","func":"var msg1 = {};\nvar msg2 = {};\nif (msg.

status.text == \"connection refused\" || msg.status.text == \"Error

\" || msg.status.text == \"ETIMEDOUT\" || msg.status.text == \"not yet connected\" || msg.status.text == \"ER_ACCESS_DENIED_ERROR\")

{\n msg1.ar_datamodel_quality = \"bad\";\n name = \"ARvar1\";\n msg1.ar_datamodel_

msg1.ar_datamodel_value = \"\";\n msg1.

ar_datamodel_type = \"String\";\n msg2.ar_datamodel_quality =

\"bad\";\n msg2.ar_datamodel_name = \"ARvar2\";\n datamodel_value = \"\";\n msg2.ar_

msg2.ar_datamodel_type = \"String\";\n return [msg1, msg2];

\n}","outputs":2,"noerr":0,"x":400,"y":460,"wires":

[["f6f6007e.2ccff"],["93b1903e.49d6d"]]},{"id":"5f0845cd.

f3e794","type":"change","z":"4a407662.78a494","name":"","rules":

[{"t":"set","p":"payload","pt":"msg","to":"payload.

value","tot":"msg"},

{"t":"set","p":"topic","pt":"msg","to":"","tot":"str"}],"action":"","property":"","from":"","to":"","reg": false,"x":420,"y":320,"wires":[["f6f6007e.2ccff"]]},

{"id":"1fd8516b.749863","type":"switch","z":"4a407662.78a494","name":"","property":"payload.name","propertyType":"msg","rules":

[{"t":"eq","v":"sqlVar1","vt":"str"},

{"t":"eq","v":"sqlVar2","vt":"str"}],"checkall":"false","outputs":2,"x":350,"y":280,"wires":[["5f0845cd.f3e794"],["cc9333f9.

d89d8"]]},{"id":"4b5f5f41.

bc5f9","type":"status","z":"4a407662.78a494","name":"","scope":

["5bc4cfc.4e291f"],"x":360,"y":440,"wires":[["3ffbe32c.1d252c"]]},

{"id":"f654da85.781e58","type":"split","z":"4a407662.78a494","name":"","splt":"","x":310,"y":240,"wires":[["1fd8516b.749863"]]},

{"id":"5bc4cfc.4e291f","type":"mysql","z":"4a407662.78a494","mydb":"f330429e.16cc","name":"Mysql localhost testdb","x":230,"y":200,"wires":[["f654da85.781e58"]]},

{"id":"1325a0b0.35b78f","type":"function","z":"4a407662.78a494","name":"SQL Select","func":"msg.topic=\"select name,value from testtable where name in ('sqlVar1', 'sqlVar2')\";\nreturn msg;","outputs":1,"noerr":0,"x":170,"y":160,"wires":

[["5bc4cfc.4e291f"]]},{"id":"b5677935.

c8f01","type":"inject","z":"4a407662.78a494","name":"every second","topic":"","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"x":130,"y":120,"wires":

[["1325a0b0.35b78f"]]},

{"id":"f330429e.16cc","type":"MySQLdatabase","z":"","host":"127.0.0.1","port":"3306","db":"testdb","tz":""}]

EIO0000003611.08

Runtime

在 Node-RED 的屏幕右上角，单击图标，然后选择导入 > 剪贴板，粘贴此代码。

如果从 PDF 文件复制示例代码，则将需要先删除所有换行符，然后才能进行下个步骤。

单击导入，创建数据流。

中间样例

下面的样例显示了 SQL 变量在 EcoStruxure Augmented Operator Advisor 中的整合。这种

样例与前一种样例的区别在于，它能够在不添加新节点的情况下整合多个 SQL 变量。

将中间样例流部署到 Node-RED 中

如要在 Node-RED 中部署此数据流：

首先，复制以下代码。

[{"id":"82287384.fcd2e8","type":"subflow","name":"Write SQL variables to Augmented Operator","info":"","in":

[{"x":40,"y":80,"wires":[{"id":"860c4ff9.0252f"}]}],"out":

[{"x":460,"y":160,"wires":[{"id":"fc909389.37f018","port":0}]}]},

{"id":"860c4ff9.0252f","type":"function","z":"82287384.

fcd2e8","name":"Variable producing","func":"\nif (! msg.

SQLARassociationTable[msg.payload.name]){\n node.error(\"Error:

The variable SQL:'\" + msg.payload.name + \"' does not exists in

SQL to AR association table!\");\n} else{\n //Setup the msg specific entry ('ar_datamodel_name','ar_datamodel_type','ar_ datamodel_value') for AR variable producing:\n msg.ar_datamodel_

name = msg.SQLARassociationTable[msg.payload.name].name;\n msg.

ar_datamodel_type = msg.SQLARassociationTable[msg.payload.name].

type;\n msg.ar_datamodel_value = msg.payload.value;\n msg.

topic = msg.payload.name;\n return msg;\n}\nnode.error(\"Could not send the msg properly. Please check your flow!\");\nreturn

EIO0000003611.08

Runtime msg;","outputs":1,"noerr":0,"x":170,"y":80,"wires":

[["b39542af.112ba8"]]},{"id":"b39542af.112ba8","type":"Augmented-

Operator-variable","z":"82287384.

fcd2e8","arservervarnamespace":"","arservervarname":"","arserverdatatype":"String","arservervalueType":"msg","arservervalue":"payload","x":230,"y":120,"wires":[["fc909389.37f018"]]},

{"id":"fc909389.37f018","type":"Augmented-Operatorserver","z":"82287384.

fcd2e8","arserverport":"8082","arservermethod":"PUT","arserverbufferinterval":"0","x":320,"y":160,"wires":[[]]},

{"id":"e94fdc14.677f9","type":"mysql","z":"ac2dce00.6e948","mydb":"2f8ee0b8.083b","name":"Mysql localhost testdb","x":350,"y":160,"wires":[["3cc7c810.d30728"]]},

{"id":"dd8448f7.41a148","type":"inject","z":"ac2dce00.6e948","name":"every minute","topic":"select name,value from testtable where name in ('sqlVar1',

'sqlVar2')","payload":"","payloadType":"date","repeat":"","crontab":"","once":false,"x":290,"y":120,"wires":[["e94fdc14.677f9"]]},

{"id":"537d55bf.43727c","type":"debug","z":"ac2dce00.6e948","name":"-

Optional help node for debugging the Augmented Operator result","active": true,"console":"false","complete":"statusCode","x":590,"y":320,"wires":[]},{"id":"3cc7c810.

d30728","type":"split","z":"ac2dce00.6e948","name":"Split each rows returned into multiple msg","splt":"","x":440,"y":200,"wires":

[["ce0e683e.de3758"]]},{"id":"ce0e683e.

de3758","type":"function","z":"ac2dce00.6e948","name":"EDIT HERE your SQL/AR variables association table","func":"//Set of Augmented

Operator Advisor types:\n//========================Do not change

Begin.========================\nconst AR_TYPES= {\n\"String\":

\"String\",\n\"WString\":\"WString\",\n\"Boolean\":\"Boolean\",\n

\"Int8\" :\"Int8\",\n\"Int16\" :\"Int16\",\n\"Int32\" :\"Int32\",\n

\"UInt8\" :\"UInt8\",\n\"UInt16\" :\"UInt16\",\n\"UInt32\" :

\"UInt32\",\n\"Float\" :\"Float\",\n\"Double\" :\"Double\",\n

\"SByte\" :\"SByte\",\n\"Byte\" :\"Byte\",\n\"Time\" :\"Time\",\n

\"Date\" :\"Date\",\n\"DateTime\":\"DateTime\",\n\"TimeOfDay\":

\"TimeOfDay\"\n};\n//========================Do not change End.

========================\n\n/*Association table that associates SQL variables with AR ones:\nOne entry per variables. Each entry must follow this model:\n\"SQL_variable_name\": {\n name:\"AR_variable_ name\",\n type: AR_TYPES[\"<types>\"] // <= choose <types> under AR_TYPES\n \n },\n \ni.e: The folowing association table contains two entry:\nIn this exemple:\n-Entry 1: The SQL variable

\"sqlVar1\" is associated to an AR variable \"ARvar1\" of type

\"String\"\n-Entry 2: The SQL variable \"sqlVar2\" is associated to

EIO0000003611.08

Runtime

an AR variable \"ARvar2\" of type \"Int32\"\n*/\nmsg.

SQLARassociationTable = {\n //----------Entry 1 begin----------\n

\"sqlVar1\": {\n name:\"ARvar1\",\n type: AR_TYPES[\"String\"]\n },

\n //----------Entry 1 end----------\n //----------Entry 2 begin----------\n \"sqlVar2\": {\n name:\"ARvar2\",\n type: AR_

TYPES[\"Int32\"]\n }\n //----------Entry 2 end----------\n};\n\n

\n//========================Do not change from here=============================\nreturn msg;","outputs":1,"noerr":0,"x":500,"y":240,"wires":[["4837af90.

ab286"]]},

{"id":"5d8695ae.320bdc","type":"comment","z":"ac2dce00.6e948","name":"Write SQL variables to Augmented

Operator","info":"","x":490,"y":80,"wires":[]},{"id":"78478719.

cb0c78","type":"status","z":"ac2dce00.6e948","name":"","scope":

["e94fdc14.677f9"],"x":120,"y":160,"wires":[["576d2b7b.725b64"]]},

{"id":"576d2b7b.725b64","type":"function","z":"ac2dce00.6e948","name":"Error mgnt","func":"if (msg.status.text == \"connection refused

\" || msg.status.text == \"Error\" || msg.status.text ==

\"ETIMEDOUT\" || msg.status.text == \"not yet connected\" || msg.

status.text == \"ER_ACCESS_DENIED_ERROR\"){\n msg.payload = [{name:

\"sqlVar1\",value:\"\"},{name:\"sqlVar2\",value:\"\"}];\n msg.ar_

datamodel_quality = \"bad\";\n return msg; \n}

\n","outputs":1,"noerr":0,"x":150,"y":200,"wires":[["3cc7c810.

d30728"]]},{"id":"4837af90.ab286","type":"subflow:82287384.

fcd2e8","z":"ac2dce00.6e948","x":490,"y":280,"wires":

[["537d55bf.43727c"]]},

{"id":"2f8ee0b8.083b","type":"MySQLdatabase","z":"","host":"127.0.0.1","port":"3306","db":"testdb","tz":""}]

在 Node-RED 的屏幕右上角，单击图标，然后选择导入 > 剪贴板，粘贴此代码。

如果从 PDF 文件复制示例代码，则将需要先删除所有换行符，然后才能进行下个步骤。

单击导入，创建数据流。

30 EIO0000003611.08

示例

：

将来自 EcoStruxure Augmented Operator

Advisor 的数据写入到 MySQL 数据库

Runtime

概述

以变量形式表示的数据可以从 EcoStruxure Augmented Operator Advisor 获得，以用于将特

定表格中的特定行更新到 MySQL 数据库中。

EcoStruxure Augmented Operator Advisor 至 MySQL 样

例

将 EcoStruxure Augmented Operator Advisor 至 MySQL

流部署到 Node-RED 中

如要在 Node-RED 中部署此数据流：

首先，复制以下代码。

[{"id":"a0324778.c46a68","type":"subflow","name":"Read Augmented

Operator variables","info":"","in":[{"x":60,"y":40,"wires":

[{"id":"f4336d.17329c9"}]}],"out":[{"x":380,"y":40,"wires":

[{"id":"f4336d.17329c9","port":0}]}]},

{"id":"f4336d.17329c9","type":"Augmented-Operatorserver","z":"a0324778.

c46a68","arserverport":"8082","arservermethod":"GET","arserverbufferinterval":"0","x":220,"y":40,"wires":[[]]},

EIO0000003611.08

Runtime

{"id":"86b03067.4a069","type":"mysql","z":"b2a4893f.279948","mydb":"4245994d.cf0238","name":"Mysql localhost testdb","x":570,"y":620,"wires":[["8ae7a977.6d8148"]]},

{"id":"2c5bfb31.025954","type":"inject","z":"b2a4893f.279948","name":"every minute","topic":"","payload":"ARvar1,

ARvar2","payloadType":"str","repeat":"","crontab":"","once": false,"x":230,"y":460,"wires":[["27f48cc7.5d36b4"]]},

{"id":"fb4ea7ae.03f268","type":"function","z":"b2a4893f.279948","name":"EDIT HERE your AR/SQL variables association table","func":"/

*Association table that associates SQL variables with AR ones:\nOne entry per variables. Each entry must follow this model:\n\"AR_ variable_name\": {\n name:\"SQL_variable_name\"\n },\n

\ni.e: The folowing association table contains two entry:\nIn this exemple:\n-Entry 1: The AR variable \"ARvar1\" is associated to an

SQL variable \"sqlVar1\"\n-Entry 2: The AR variable \"ARvar2\" is associated to an SQL variable \"sqlVar2\"\n*/\ nARSQLassociationTable = {\n begin----------\n

//----------Entry 1

\"ARvar1\": {\n name:\"sqlVar1\",\n

\n }, \n //----------Entry 1 end----------\n

//----------Entry 2 begin----------\n \"ARvar2\": {\n name:\"sqlVar2\",\n }\n //----------Entry 2 end----------\n};

\n\nmsg.topic = \"UPDATE testtable SET value = '<VALUE>' WHERE name

= '<NAME>';\".replace(\"<VALUE>\",msg.payload.value).replace

(\"<NAME>\", ARSQLassociationTable[msg.parts.key].name);

\n//========================Do not change from here=============================\nreturn msg;","outputs":1,"noerr":0,"x":440,"y":580,"wires":

[["86b03067.4a069"]]},

{"id":"8ae7a977.6d8148","type":"debug","z":"b2a4893f.279948","name":"Optional help node for debug the MySQL server result","active": true,"console":"false","complete":"payload.

message","x":720,"y":660,"wires":[]},

{"id":"e46fd4ee.2f7318","type":"split","z":"b2a4893f.279948","name":"","splt":"","x":530,"y":540,"wires":[["fb4ea7ae.03f268"]]},

{"id":"b5bb57a3.

d9eb38","type":"json","z":"b2a4893f.279948","name":"","x":410,"y":540,"wires":[["e46fd4ee.2f7318"]]},

{"id":"27f48cc7.5d36b4","type":"subflow:a0324778.

c46a68","z":"b2a4893f.279948","name":"","x":390,"y":500,"wires":

[["b5bb57a3.d9eb38"]]},

{"id":"704bcb69.9c7f24","type":"comment","z":"b2a4893f.279948","name":"Write Augmented Operator variables to

SQL","info":"","x":450,"y":420,"wires":[]},{"id":"4245994d.

32 EIO0000003611.08