ExecuteStreamCommand
描述:
根据输入数据流的内容执行某个外部命令，然后根据命令的结果创建一个新的数据流输出。
标签:
命令执行, command, stream, execute, 命令, 执行
参数:
如下列表中，必填参数则标识为加粗. 其他未加粗参数，则表示为可选参数。表中同时提到参数默认值设置, 并且 参数还支持 表达式语言.
| 名字 | 默认值 | 允许值列表 | 描述 |
|---|---|---|---|
| 命令参数 | 传递给可执行命令的参数，参数由字符';'分隔。 支持表达式语言 (支持流属性和变量) | ||
| 命令路径 | 指定要执行的命令;如果只提供了可执行文件的名称，那么该可执行文件必须在用户的环境路径中。 支持表达式语言 (支持流属性和变量) | ||
| 忽略STDIN | 不忽略 | - 忽略 - 不忽略 | 如果设为忽略，则输入数据流的内容将不会传递给正在执行的命令。 |
| 工作目录 | 执行命令时要用作当前工作目录的目录 支持表达式语言 (支持流属性和变量) | ||
| 参数分隔符 | ; | 分隔符，用于分隔命令的参数[m默认为分号;]。必须是单个字符。 | |
| 输出为属性 | 如果设置了该选项，则stream命令的输出将被放到原始数据流的属性中，而不是放在单独的数据流中，则不再有'output stream'和'nonzero status'输出连线。该选项所填的值对应输出数据流中的属性键值。 | ||
| 属性最大字节数 | 256 | 如果将流命令的输出路由到一个属性，则该值指定最多放置到属性值上的字符数个数。这一点很重要，因为属性保存在内存中，大的属性会很快引起内存问题。如果输出的长度超过这个值，它将被截断。如果可以的话把它做小一些。 |
动态参数:
| 名字 | 值 | 描述 |
|---|---|---|
| An environment variable name | An environment variable value | 这些环境变量被传递给这个组件生成的进程中 不支持表达式语言 |
连线:
| 名字 | 描述 |
|---|---|
| output stream | 如果返回的状态码为零，则将从命令输出内容创建的数据流输出到该目标连线。 |
| nonzero status | 如果返回的状态代码不为零，则将从命令输出内容创建的数据流输出到该连线。所有路由到此连线的数据流都将受到惩罚。 |
| original | 被成功处理的数据流输出到该连线 |
读取属性:
未提供。
写入属性:
| 名字 | 描述 |
|---|---|
| execution.command | 执行命令的名称 |
| execution.command.args | 分号分隔的参数列表 |
| execution.status | 执行命令返回的退出状态代码 |
| execution.error | 执行命令返回的任何错误消息 |
状态管理:
该组件不保存状态。
限制:
| 要求权限 | 说明 |
|---|---|
| 执行代码 | 需获取平台具有的所有权限，提供操作员执行任意代码的能力 |
输入流要求:
组件必须提供输入流。
系统资源考量:
未提供。