1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0.29 | 新增「Bat 脚本」节点 |
| 4.1.0 | 「脚本参数」下拉框中显示已配置参数 |
1.2 功能简介
新增「Bat 脚本」节点，支持调用远程 Windows 环境中的 Bat 脚本文件。如下图所示：
2. 使用限制
1）被调用的 Bat 脚本文件需要在 Windows 环境中。
2）FineDataLink 远程调用 Bat 脚本文件的前提是建立 SSH 数据连接；其中，Windows 常见版本中，下表中的 Windows 支持 ssh 功能：
| 桌面版 | 服务器版 |
|---|---|
| Windows 1.0、Windows 2.0、Windows 3.0、Windows 3.1、Windows 95、Windows 98、Windows Me、Windows XP、Windows Vista、Windows 7、Windows 8、Windows 8.1和Windows 10、Windows 11 | Windows NT 3.1、Windows NT 3.5、Windows NT 3.51、Windows NT 4.0、Windows 2000、Windows Server 2003、Windows Server 2008、Windows Server 2008 R2、Windows Server 2012、Windows Server 2012 R2、Windows Server 2016、Windows Server 2019 |
| 若需要调用上述 Windows 环境中的 Bat 脚本，Windows 环境中需要安装 openSSH | |
以下版本 Windows 操作系统内置了 openSSH 工具：
桌面版从 Windows10 build 1809 开始、服务器版从 Windows Server2019 开始，均内置了 openSSH 。详情请参见：OpenSSH for Windows 概述
3）禁止脚本路径和参数值中包含 & | > < 四种操作字符；参数值中如果含有空格，需要用户自己在首尾添加"
4）被调用的 bat 脚本中，不支持 pause 命令。
3. 示例
3.1 场景模拟
chengji.bat 脚本包含学生成绩信息，该脚本可接收学生姓名参数（name），取出对应学生成绩；将取出的数据输出到 test.txt 文件中，test.txt 为自动创建的文件，且与 chengji.bat 脚本在同一路径下。
示例数据：bat脚本数据.zip
3.2 新建 SSH 数据连接
使用「Bat 脚本」节点执行 Bat 脚本前，需要先配置 SSH 协议数据连接，远程连接目标服务器。如下图所示：
3.3 取出学生姓名并作为参数输出
1）取出学生姓名数据。如下图所示：
2）将取出的学生姓名数据作为参数输出。
Bat 脚本中接收的参数名为 name，所以此处参数名也为 name ；取出第一列所有行的数据；默认值只是为了下游节点提前预览设置的，实际运行时不会用到这个默认值，直接从右侧的「参数预览」中复制即可。
如下图所示：
3.4 设置 Bat 脚本节点
拖入「Bat 脚本」节点，设置要执行的 Bat 脚本文件，添加 3.3 节设置的脚本参数。如下图所示：
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| SSH 连接 | 下拉所有可选的 SSH 连接 |
| 脚本路径 | 填写 SSH 目标端要执行的 Bat 脚本完整路径：
|
| 脚本参数 | 1）指定传递给脚本的参数：
2）4.1.0 及之后版本，参数下拉框中显示已配置参数，分为任务内参数、全局参数：
|
| 命令超时配置 | 脚本开始执行到完全执行完毕的超时时间，默认选择无限制 执行X秒后超时中断，X值的范围：0~1000000 |
| 字符编码 | 指定输出字符编码，默认为UTF-8 下拉框内容：
|
3.5 效果查看
1）点击「保存并运行」按钮，任务执行成功后，如下图所示：
2）可看到 Bat 脚本所在的路径下自动生成了 test.txt 文件，文件内容如下图所示：
