通过服务器名称建立 FTP 连接的作业块对于建立指定了服务器名称的 FTP 连接，将使用以下数据结构。使用 DNS 将服务器名称分配给 IP 地址。 表格 3- 7FTP_CONNECT_NAME 参数 类型 取值范围 含义/说明 InterfaceID HW_ANY 模块起始地址 调用指令时，在LADDR 参数中传送 CP 的模块起始地址。 在“属性 > 地址 > 输入”(Properties >Addresses > Inputs) 下，可以找到 CP 组态中 CP 的模块起始地址。 ID CONN_OUC 1,2...64 在 FTP 连接上处理 FTP 作业。该参数可识别所用的连接。 ConnectionType BYTE 0连接类型“FTP” ActiveEstablishm ent BOOL TRUE TRUE = 主动连接建立 FTPcmd BYTE1 FTP 命令 "CONNECT" 调用该指令时执行的 FTP 命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD(页 56)”部分。 注意： 此处指定的 FTP 命令必须与在 CMD 输入参数中指定的命令相同。 CertIndex BYTE 0= FTP 1 = FTPS 在此处选择协议类型 FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的STEP 7 项目外组态 FTP 服务器，则必须导入 FTP 服务器的证书。 UserName STRING[32]’benutzer’ 用于登录 FTP 服务器的用户名 Password STRING[32] ’passwort’ 用于登录 FTP服务器的密码 FTPserverName STRING[254] FTP 服务器的 IP 地址。
读写访问和其它 FTP 命令的作业块以下数据结构可用于 FTP 命令 store、retrieve、delete 和 append。 表格 3- 8FTP_FILENAME 参数 类型 取值范围 含义/说明 InterfaceID HW_ANY 模块起始地址 调用指令时，在LADDR 参数中传送 CP 的模块起始地址。 在“属性 > 地址 > 输入”(Properties >Addresses > Inputs) 下，可以找到 CP 组态中 CP 的模块起始地址。 ID CONN_OUC 1,2...64 在 FTP 连接上处理 FTP 作业。该参数可识别所用的连接。 ConnectionType BYTE 0连接类型“FTP” ActiveEstablishm ent BOOL TRUE TRUE = 主动连接建立 FTPcmd BYTE2, 3, 4, 6 FTP 命令 "STORE / RETRIEVE / DELETE / APPEND" 调用该指令时执行的FTP 命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD (页 56)”部分。 注意： 此处指定的 FTP命令必须与在 CMD 输入参数中指定的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS 在此处选择协议类型FTP 或 FTPS。 有关 FTPS 的注意事项： 如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器，则必须导入FTP 服务器的证书。 DataBlockNumbe r UINT 在此指定的数据块包含要读取/写入的文件 DB。LenFilename UINT 0...1000 不评估用于指定文件名总长度的参数“LenFilename” 。而是评估“Filename”参数字符串中的长度信息。 Filename ARRAY[0..3] OF STRING[254]目标文件或源文件的文件名。 文件名的四个字符串连在一起，作为一个完整字符 串传输给服务器。 RETR_PART FTP 命令的作业块以下数据结构用于 RETR_PART FTP 命令。FTP_FILENAME_PART 参数 类型 取值范围 含义/说明InterfaceID HW_ANY 模块起始地址 调用指令时，在 LADDR 参数中传送 CP 的模块起始地址。 在“属性 >地址 > 输入”(Properties > Addresses > Inputs) 下，可以找到 CP 组态中 CP的模块起始地址。 ID CONN_OUC 1, 2...64 在 FTP 连接上处理 FTP 作业。该参数可识别所用的连接。ConnectionType BYTE 0 连接类型“FTP” ActiveEstablishm ent BOOL TRUE TRUE= 主动连接建立 FTPcmd BYTE 7 FTP 命令 "RETR_PART" 调用该指令时执行的 FTP命令。关于命令类型的取值范围，可参见“输入参数 - FTP_CMD (页 56)”部分。 此处指定的 FTP 命令必须与在 CMD输入参数中指定的命令相同。 CertIndex BYTE 0 = FTP 1 = FTPS 在此处选择协议类型 FTP 或 FTPS。有关 FTPS 的注意事项：如果在 FTP 客户端的 STEP 7 项目外组态 FTP 服务器，则必须导入 FTP 服务器的证书。Offset DWORD 从将要读取的那个文件算起的偏移量(以字节计)。 Length DWORD在“OFFSET”中指定的数值处开始读取的子长(以字节 计)。 特性： • 如果指定“DW#16#FFFFFFFF”，将读取文件的可用剩余部分。 如果没有出现其它错误，则结果“正确”(DONE = 1，STATUS = 0)。 • 当OFFSET >原始文件长度时： 目标文件长度(文件DB中的ACT_LENGTH)：CPU上的0 字节。如果没有出现其它错误，则结果“正确”(DONE = 1，STATUS = 0)。 • 当OFFSET + LEN >原始文件长度(且LEN ≠ 0xFFFFFFFF)时： 目标文件长度(文件DB中的ACT_LENGTH)：从“OFFSET”开始的可用字节。 如果没有出现其它错误，则结果“正确”(DONE = 1，STATUS = 0)。命令类型 NOOP 和 QUIT的参数提供 同时为 FTP_CMD 提供对具有以下命令类型的作业块的引用： CMD = 0 (NOOP) CMD = 5 (QUIT)由于这些命令类型执行时，不对作业块的内容进行评估，因此指定作业块的类型 (UDT) 不重要。 说明 对 FTP作业块的引用丢失时的响应 如果未提供引用，则不执行命令。指令将在保持锁定在明显的执行状态下，不会为接口上 的用户程序提供任何反馈。输出参数和状态信息FTP_CMD 参数 BUSY、DONE 和 ERROR 使用参数 BUSY、DONE、ERROR 和 STATUS控制执行状态。BUSY 参数指示处理状态。使用 DONE 参数检查作业是否已正确执行。如果在执行 "FTP_CMD"的期间出错，则会设置 ERROR 参数。错误信息在 STATUS 参数中输出。 下表列出了参数 BUSY、DONE 和 ERROR之间的关系评估 • 评估 BUSY = 0 BUSY = 0 之前，请勿评估状态显示。 • 状态 8FxxH 有关以状态 8FxxH编码的条目，请参见“STEP 7 标准和系统函数”参考手册中的信息。描述通过RET_VAL输出参数进行错误评估的章节 含详细信息。用于FTP 客户端操作的数据块（文件 DB）的结构 工作原理 要使用 FTP 传送数据，请在 S7 站的 CPU 上创建数据块（文件DB）。这些数据块必须具有特定结构，以便作为可传送文件由 FTP 服务进行处理。它们由下列部分组成： • 部分1：文件DB报头(具有固定长度，20字节) • 部分 2：“Array [..] of Byte”或“Array [..] ofChar”类型的用户数据（具有可变的长度和结构） 数据一致性 确保不在同一时间多次访问同一文件 DB。 创建文件 DB 1. 在STEP 7 中创建一个新数据块。 2. 打开块编辑器。 3. 在 DB 的块编辑器中，选择要用作文件 DB 起始行的行。 4.在“数据类型”(Data type) 列中，使用键盘输入类型“FILE_DB_HEADER”。 将创建文件 DB所需的带报头结构的数据结构。 5. 将“WRITEACCESS”参数设置为“true”以启用访问。 6.在“MAX_LENGTH”参数中输入用户数据长度的值。 7. 之后，为要发送的用户数据创建一个“Array [..] ofByte”或“Array [..] of Char”类型的数据字段。 字段的大小必须与报头中所规定的“MAX_LENGTH”相匹配。从FTP_CMD 程序块评估“LOCKED”和“NEW”状态位 • 在版本为 1.2 的“FTP_CMD”程序块中，不会评估FILE_DB_HEADER 的“LOCKED”和“NEW”状态位。 使用 FTP 服务器的功能或者使用同一文件 DB时，不能排除同时多次访问同一数据区的可能性。这将导致数据不一致。 • 在版本 1.5 或更高版本的“FTP_CMD”程序块中，正确设置FILE_DB_HEADER 的状态位“LOCKED”和“NEW”。评估这两个状态位。自 STEP 7 ProfessionalV12 SP1 开始提供版本 1.5。 说明 避免数据不一致 确保不在同一时间多次访问同一文件 DB。 安全性有关安全功能的范围和使用的概览信息，请参见工业以太网安全 (页 17)部分。 有关安全功能的组态限制，请参见安全特性 (页21)部分。 要组态安全功能，需要创建一个安全用户，请参见安全用户 (页 70)部分。 安全用户 创建安全用户组态安全功能需要具备相关的组态权限。为此，需要通过相应权限创建至少一个安全用户 。 导航到全局安全设置>“用户和角色”>“用户”选项卡。 1. 创建用户并组态参数。 2. 在“分配的角色”下方区域为该用户分配角色“NETStandard”或“NET Administrator”。 登录后，该用户可以在 STEP 7 项目中进行所需的设置。在以后使用安全参数时，请继续以该用户身份登录。