DOCA0172ZH-09

在 SFTP 服务器上发布

简介

EcoStruxure Panel Server 提供到 SFTP 服务器的连接。

如果激活了 SFTP 发布功能,则:

  • 可以在 Panel Server 网页中监控并显示报警。

  • 报警不会以 CSV 文件发布。

  • 可以为电子邮件通知启用报警。

当 SFTP 功能处于活动状态时,云上的数据发布不可用。

可用性

Panel Server EntryUniversalAdvanced 上提供了此功能。

设置参数

发布功能在 EcoStruxure Panel Server 网页的 Settings > Publication > Publication method > SFTP 中进行设置。

SFTP Publication 设置

下表介绍了这些设置。

参数

设置

描述

Connection information

服务器

SFTP 服务器的主机名可被定义为 IP 地址值,或定义为(例如)mysftpserver.mydomain.com

Port

用于定义 SFTP 服务器 TCP 端口。通常设置为 22。

路径

用于输入在 SFTP 服务器上用来数据发布的路径。例如,如果 /home/user/ 是 SFTP 服务器的缺省目录,则使用 /mySFTPPath 配置的路径将发布于 /home/user/mySFTPPath

User ID

用于输入 SFTP 服务器访问的用户名。

Authentication method

与 SFTP 服务器的连接可以使用用户名和密码或者用户名和 SSH 密钥(PEM(隐私增强邮件)格式)来完成。

Password

用于输入 SFTP 服务器访问的密码。

Test connection

此按钮用于测试与 SFTP 服务器的连接。

Publication settings

Publication format

用于选择导出文件格式:

Publication period

用于选择对 SFTP 服务器执行的发布的频率(缺省设置:1h)。

Start

此按钮用于激活到 SFTP 服务器的数据发布。

连接到 SFTP 服务器

如要将 Panel Server 连接到 SFTP 服务器,请:

  1. 通过 Panel Server 网页的 Settings > Data management 配置要被 Panel Server 采样的数据(请参见相关主题),并在 Settings > Data management > Data Sampling 中激活采样设置。

  2. Settings > Publication 网页中,选择 SFTP 作为 Publication method

    缺省情况下,SFTP 数据发布(CSV 或 JSON 文件格式)存储在 SFTP 服务器的层级文件树的顶部。如果自定义数据存储的文件路径,请确保在 SFTP 服务器上创建并验证了该路径。有关更多信息,请参阅 SFTP 服务器的用户指南。

  3. 如要连接到 SFTP 服务器,请在 Connection information 部分输入用户名和密码或者用户名和 PEM(隐私增强邮件)格式的 SSH 密钥,然后单击 Test connection

    使用 SSH 密钥验证时,必须以 PEM 格式提供秘钥(当采用版本低于 7.8 的 OpenSSH 时,为缺省设置)。

    注: 如果 Panel Server 首次连接到此 SFTP 服务器,则会显示一条消息,要求您确认 SFTP 服务器的真实性。
  4. 执行测试后,Panel Server 网页将显示以下信息:

    • 如果成功,则文件会成功上传到 SFTP 服务器。

    • 如果出现故障,请检查 SFT P服务器参数、用户凭据和 SFTP 服务器上的写访问权限。

  5. 如要发布数据,请设置 Publication settings ,然后单击 Start

    结果:与所选采样周期相关的一个设备的数据以通用 CSV 文件格式发布到 SFTP。

  6. 如果更新 SFTP 服务器,则 SFTP 服务器指纹将更改。在这种情况下,单击 Test connection,可让您再次连接到 SFTP 服务器。

断开与发布服务的连接

如要断开 Panel Server 与 SFTP 服务器的连接,请单击 Stop

CSV 发布的文件格式

每个下游设备生成一个 .csv 文件,其中包含以相同采样周期配置的测量值。

导出的 CSV 文件的名称遵循命名规则 ReducedID_DeviceName_DateTime.csv,其中:

  • ReducedID

    是设备的内部标识符,它使生成的文件对于将共享同一名称(例如,10_mb21_zd)的设备是唯一的。
  • DeviceName 是为下游设备指定的名称。

  • DateTime 是与文件发布时间对应的时间戳,以 YYYYMMDDhhmmssSSS 格式向下表示到毫秒。

  • .csv 文件名中仅允许使用以下字符:UTF-8 和基础 ASCII(32 至 7F,不包括 \ / : * ? " < > |)。任何不受支持的字符都将替换为 ~

示例:考虑以下文件名:
11_mb_F160 3P 3P+N_20221104084830994.csv其中:

  • ReducedID11_mb

  • DeviceNameF160 3P 3P+N,设备名称。

    注: 如果用户尚未更新此名称,则此名称为缺省值(产品型号)。

  • DateTime20221104084830994,即,2022 年 11 月 4 日 8:48:30.994 生成。

.csv 文件内容仅支持对设备名称、事件名称、测量名称和文件名进行 UTF-8 标准字符编码。

.csv 文件的所有数据字段中的引号有助于确保与特殊字符兼容。

下表提供了 .csv 文件每行的详细信息,以及示例数据:

.csv 文件中的数据

描述

1

Gateway Name,Gateway SN,Gateway IP Address,Gateway MAC Address,Device Name,Device Local ID,Device Type ID,Device Type Name,Logging Interval,Historical Intervals

此行包含第 2 行中信息的列标题:

  • Gateway Name:调试期间为 Panel Server 指定的名称

  • Gateway SN: 的序列号Panel Server

  • Gateway IPPanel Server 的 IP 地址

  • Gateway MAC AddressPanel Server 的 MAC 地址

  • Device Name:调试期间为设备指定的名称

  • Device Local ID:被记录的设备的型号,在整个 Panel Server 中具有唯一性

  • Device Type ID:设备型号

  • Device Type Name:设备型号

  • Logging Interval:以分钟表示的采样周期

  • Historical Intervals:此文件中记录数据的总行数

2

Device TypeEcoStruxure Panel Server,542206310926,10.195.253.81,00:00:54:E5:8A:36,F160 3P 3P+N,modbus:1_mb_81,F160 3P 3P+N,F160 3P 3P+N,5,7

此行包含与生成文件的 Panel Server 以及作为测量值采样对象的下游设备有关的信息。

3

4

,,,Topic ID1,Topic ID2

此行包含主题 ID 的列标题。主题 ID 是对记录数量的引用。为某个量指定的名称在不同的设备和语言之间可能有所不同。主题 ID 用于识别数量(不计设备或语言)。主题 ID 在整个 Panel Server 中具有唯一性。

注: 前 3 个逗号用于电子表格应用程序中的布局用途。

5

,,,"modbus:1_mb_VAB","modbus:1_mb_VAN"

此行包含记录测量值的主题 ID。

6

7

Error,UTC Offset (minutes),Local Time Stamp,RmsVoltagePhsAB (V),RmsVoltagePhsAN (V)

此行包含在第 8 行和之后记录的数据的列标题:

  • Error0(成功),19(当至少一个测量值无效或不可用于采样 (NaN) 时)。

  • UTC Offset (minutes):本地时间戳相对于 UTC 时区的偏移。

  • Local Time Stamp:样本的日期和时间

从第四项开始,每个度量用其名称和单位(如果知道)来描述。

8 及其之后

0,0,2022-11-04 08:10:00,127.80000305,235.3999939

0,0,2022-11-04 08:15:00,128.1000061,235.69999695

0,0,2022-11-04 08:20:00,127.69999695,234.8999939

这些行中包含记录的数据。

JSON 发布的文件格式

生成一个 .json 文件,其中包含以相同采样周期配置的多个下游设备的测量值。

导出的 JSON 文件的名称遵循命名约定 DateTime.json,其中 DateTime 是与文件发布时间对应的时间戳,以 YYYYMMDDhmmhmmssSSS 格式表示为毫秒。

下面各行提供了包含两个时间序列列表和多个记录集合的数据的 .json 文件:

QR Code is a registered trademark of DENSO WAVE INCORPORATED in Japan and other countries.

这有帮助吗?