IA-Connect 动态代码(预览版)
IA-Connect 是机器人流程自动化“RPA”平台,可将 RPA 功能从云添加到本地虚拟机,或通过 Citrix 或Microsoft远程桌面“RDS”连接。 这是用于开发动态代码模块的模块。
此连接器在以下产品和区域中可用:
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 逻辑应用程序 | 标准 | 除以下各项外的所有 逻辑应用区域 : - Azure 政府区域 - Azure 中国区域 - 美国国防部(DoD) |
| Power Apps | 高级 | 除以下各项外的所有 Power Apps 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| Power Automate | 高级 | 除以下各项外的所有 Power Automate 区域 : - 美国政府 (GCC) - 美国政府 (GCC High) - 由世纪互联运营的中国云 - 美国国防部(DoD) |
| 联系人 | |
|---|---|
| Name | Ultima Labs |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| 连接器元数据 | |
|---|---|
| 发布者 | Ultima Business |
| 网站 | https://www.ultima.com/ultima-labs |
| 隐私策略 | https://www.ultima.com/privacy-policy |
| 类别 | IT作;生产力 |
IA-Connect 是一个机器人过程自动化(RPA)平台,可将 RPA 功能从 Power Automate 云流添加到本地虚拟机或通过 Citrix 或Microsoft远程桌面(RDS)连接。 IA-Connect 连接器提供 800 多个作,使你可以直接从 Power Automate 云流自动执行各种类型的本地应用程序。 所有 IA-Connect作都可以直接从 Power Automate Cloud Flow 获取,可在基于云的应用程序与本地应用程序之间轻松集成,从而利用 RPA 进程中现有的 Power Automate 条件、循环、动态内容、表达式和异常处理。 利用 IA-Connect 连接器还提供流运行历史记录的完整执行历史记录和可审核性,同时无需使用单独的应用程序/控制台/工作室来开发 RPA 进程。
先决条件
若要使用任何 IA-Connect 连接器,必须安装 IA-Connect 软件。 这可以免费测试 30 天,之后需要 IA-Connect 许可证。
IA-Connect 软件由两个主要组件组成:
IA-Connect Orchestrator,它是一个可在自己的 Azure 租户中托管的 Azure WebApp。 这会处理 RPA 流到一个或多个本地或基于云的虚拟机的路由和安全性。
IA-Connect 代理和控制器,安装在要自动执行的软件可访问的虚拟机上。 此外,IA-Connect 代理可以在 Citrix 或 Microsoft 远程桌面服务 (RDS) 会话中运行,其中 RPA 命令将虚拟通道传递到远程会话以供执行。 IA-Connect 代理可以从网络共享运行,不需要安装。
可用的 IA-Connect 连接器
可用的 IA-Connect 连接器包括:
- IA-Connect 动态代码
- IA-Connect Java
- IA-Connect JML
- IA-Connect 大型机
- office IA-Connect Microsoft
- IA-Connect SAP GUI
- IA-Connect 会话
- IA-Connect UI
- IA-Connect Web 浏览器
如何获取凭据
若要接收许可证并开始 30 天的免费试用,请在我们的网站上提交请求(https://www.ultima.com/IA-Connect/Power-Automate)。
收到试用请求后,我们将通过提供的电子邮件地址与你联系,以帮助设置 IA-Connect 软件并提供试用许可证。 这是一个功能齐全的试用版,可让你在试用期内在所有 9 个 IA-Connect 连接器中测试所有 800 个作中的任意一个。
连接器入门
提交 IA-Connect 的试用请求后,你将能够下载包含 IA-Connect 软件和涵盖安装和设置的文档的 ZIP 文件。 我们还将与你联系,根据需要通过安装过程提供支持和指导。
Support
在试用期内,可以联系 Ultima Labs (IAConnect@ultima.com)获取支持和帮助。
购买 IA-Connect 许可证后,将收到支持令牌,这些令牌可以兑换为来自 Ultima 的英国技术服务中心(TSC)的定制培训或支持。
已知问题、常见错误和常见问题解答
我们的知识库包含许多文章,这些文章涵盖了任何已知问题、使用 IA-Connect 连接器和常见问题时可能发生的常见错误。 可在 IA-Connect https://support.ultima.com/ultimalabs 试用期间以及购买 IA-Connect 许可证时访问这些资源的帐户访问。
正在创建连接
连接器支持以下身份验证类型:
| 默认 | 用于创建连接的参数。 | 所有区域 | 不可共享 |
违约
适用:所有区域
用于创建连接的参数。
这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。
| Name | 类型 | Description | 必选 |
|---|---|---|---|
| API 密钥 | securestring | 此 API 的 API 密钥 | True |
| IA-Connect Orchestrator 地址 | 字符串 | 指定不带 HTTP(S) 组件的 IA-Connect 业务流程协调程序地址 | True |
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| IA-Connect 查阅表格的查阅值 |
从 Orchestrator 查找表(对于使用 Orchestrator 的自动化)或当前加载到 IA-Connect 代理中的查找表(对于使用 Orchestrator 的自动化)检索与输入数据匹配的第一行中的值。 如果 Orchestrator 的查找表的名称与加载到 IA-Connect 代理中的名称相同,则使用 Orchestrator 查找表(如果自动化通过 Orchestrator)。 |
| 从 IA-Connect 列表中获取列 |
从 IA-Connect Orchestrator 列表中检索列。 |
| 从 IA-Connect 查阅表格查找列 |
从 Orchestrator 查找表(对于使用 Orchestrator 的自动化)或当前加载到 IA-Connect 代理中的查找表(从与输入数据匹配的第一行中检索一个或多个相同命名的列),并作为表返回。 例如,查阅表格可能包含多个名为“AD 组”的输出列来表示多个 AD 组,它们将作为输出表中的单独行返回。 如果 Orchestrator 的查找表的名称与加载到 IA-Connect 代理中的名称相同,则使用 Orchestrator 查找表(如果自动化通过 Orchestrator)。 |
| 从 IA-Connect 查阅表格查找数据单元格 |
从 Orchestrator 查找表中检索所有数据单元格(对于使用 Orchestrator 的自动化),从与输入数据匹配的第一行中检索所有数据单元格,并作为表返回。 此作不支持加载到 IA-Connect 代理中的查找表。 |
| 从 JSON 获取表 |
采用 JSON 格式的输入表,并作为表返回。 这称为反序列化。 |
| 从 JSON 表中删除列 |
采用 JSON 格式的输入表,删除列或列,并返回 JSON 格式的新表。 如果要从实际表中删除列(即不是 JSON 格式),请使用作“从表中删除列”。 |
| 从 JSON 表中删除行 |
采用 JSON 格式的输入表,删除位于指定位置的行或行,并返回 JSON 格式的新表。 如果要从实际表中删除行或行(即不采用 JSON 格式),请使用作“从表中删除行”。 如果要从字符串数组中删除行或行,请使用作“从字符串数组中删除行”。 |
| 从 JSON 表列获取字符串数组 |
采用 JSON 格式的输入表,并将指定的列作为字符串数组返回。 如果要从实际表(即不是 JSON 格式)获取字符串数组,请使用作“从表获取数组”。 |
| 从 JSON 表单元格获取字符串 |
采用 JSON 格式的输入表,并将指定的单元格作为字符串返回。 |
| 从字符串中删除字符 |
获取一个输入字符串,并返回删除了指定字符的字符串。 如果未找到指定的字符,将返回原始字符串。 |
| 从字符串数组中删除项 |
获取字符串项的输入数组,删除位于指定位置的项或项,并返回新数组。 如果要从表中删除行或行,请使用作“从表中删除行”。 如果要从 JSON 格式的表中删除行或行,请使用作“从 JSON 表中删除行”。 |
| 从字符串数组获取 JSON 表 |
获取字符串项的输入数组,并作为 JSON 表返回。 |
| 从字符串数组获取表 |
获取字符串项的输入数组,并作为表返回。 |
| 从本地文件导入程序集 |
从运行 IA-Connect 控制器的计算机上传 DotNet 程序集,并将其加载到内存中的 IA-Connect 代理,并在动态 DotNet 代码引用时使用。 |
| 从表中删除列 |
获取输入表,删除列或列并返回新表。 如果要从 JSON 格式的表中删除列,请使用作“从 JSON 表中删除列”。 |
| 从表中删除行 |
获取输入表,删除位于指定位置的行或行,并返回一个新表。 如果要从字符串数组中删除行或行,请使用作“从字符串数组中删除行”。 如果要从 JSON 格式的表中删除行或行,请使用作“从 JSON 表中删除行”。 |
| 从表列获取字符串数组 |
获取输入表,并将指定的列作为字符串数组返回。 如果要从 JSON 格式的表中获取字符串数组,请使用作“从 JSON 表获取数组”。 |
| 从输入变量创建 JSON |
采用输入变量数组,并采用 JSON 格式返回,还可以选择作为 JSON 表返回。 |
| 使用正则表达式拆分字符串 |
使用正则表达式(正则表达式)匹配拆分输入字符串,并将字符串的各个拆分组件作为字符串数组返回。 |
| 删除 IA-Connect 查阅表格 |
删除当前加载到 IA-Connect 代理中的查阅表格。 |
| 删除所有 IA-Connect 查找表 |
删除当前加载到 IA-Connect 代理中的所有查找表。 |
| 加载 IA-Connect 查阅表格 |
从运行 IA-Connect 代理的计算机加载 IA-Connect 查找表。 可以通过进一步 IA-Connect作来执行数据查找来使用这些查找表。 |
|
在 |
获取一个输入字符串,并返回位于两个指定字符串之间或字符串和行尾之间的字符串的第一个实例。 |
| 对 JSON 表进行排序 |
获取输入 JSON 表,对表进行排序并返回新的 JSON 表。 如果要对实际表(即不是 JSON 格式)进行排序,请使用作“排序表”。 如果要对字符串数组进行排序,请使用作“排序字符串数组”。 |
| 对字符串数组进行排序 |
获取字符串项的输入数组,对数组进行排序并返回一个新数组。 如果要对表进行排序,请使用作“排序表”。 如果要以 JSON 格式对表进行排序,请使用作“对 JSON 表进行排序”。 |
| 将 CSV 上传到 IA-Connect Orchestrator 列表 |
将替换 CSV 数据上传到 IA-Connect Orchestrator 列表,替换任何现有内容。 |
| 将 CSV 上传到 IA-Connect Orchestrator 查找表 |
将替换 CSV 数据上传到 IA-Connect Orchestrator 查找表,替换任何现有内容。 此作不会与 IA-Connect 代理处理的查阅表(磁盘上保留的 CSV 文件)进行交互。 |
| 将一行输入变量插入 JSON 表中 |
采用 JSON 格式的输入表,在指定位置插入从输入变量创建的行,并返回 JSON 格式的新表。 输入行架构应与输入表(即使用相同的属性名称和数据类型)匹配。 如果要将行插入实际表(即不是 JSON 格式),请使用作“将行插入表中”。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。 |
| 将数组转换为 JSON |
获取输入数组并序列化为 JSON 字符串。 |
| 将行插入 JSON 表 |
采用 JSON 格式的输入表,在指定位置插入行,并返回 JSON 格式的新表。 如果要将行插入实际表(即不是 JSON 格式),请使用作“将行插入表中”。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。 |
| 将行插入字符串数组 |
获取字符串项的输入数组,在指定位置插入行并返回新数组。 如果要将行插入表中,请使用作“将行插入表中”。 如果要以 JSON 格式将行插入表中,请使用作“将行插入 JSON 表中”。 |
| 将行插入表中 |
获取输入表,在指定位置插入行并返回一个新表。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。 如果要以 JSON 格式将行插入表中,请使用作“将行插入 JSON 表中”。 |
| 排序表 |
获取输入表,对一行或多行进行排序,并返回一个新表。 如果要以 JSON 格式对表进行排序,请使用作“对 JSON 表进行排序”。 如果要对字符串数组进行排序,请使用作“排序字符串数组”。 |
|
是否安装了 Power |
在运行 IA-Connect 代理的计算机上搜索指定的 PowerShell 模块,并返回它是否已安装。 |
|
是否安装了 Power |
报告运行 IA-Connect 代理的计算机上是否提供 PowerShell 自动化。 如果 PowerShell 自动化不可用,PowerShell 自动化作将不起作用。 |
| 添加程序集搜索文件夹 |
将文件夹路径(在运行 IA-Connect 代理的计算机上)添加到 IA-Connect 代理尝试加载外部引用时要扫描的文件夹列表。 |
| 清除程序集搜索文件夹 |
重置 IA-Connect 代理在尝试加载外部引用时要扫描的文件夹的其他列表。 |
| 筛选 JSON 表 |
获取输入 JSON 表,筛选表(使用 .NET DataView 行筛选器语法),并返回新的 JSON 表。 如果要筛选实际表(即不是 JSON 格式),请使用作“筛选表”。 如果要筛选字符串数组,请使用作“筛选字符串数组”。 |
| 筛选字符串数组 |
获取字符串项的输入数组,筛选数组(使用 .NET DataView 行筛选器语法),并返回一个新数组。 如果要筛选表,请使用作“筛选表”。 如果要以 JSON 格式筛选表,请使用作“筛选 JSON 表”。 |
| 筛选表 |
获取输入表,筛选表(使用 .NET DataView 行筛选器语法),并返回一个新表。 如果要以 JSON 格式筛选表,请使用作“筛选 JSON 表”。 如果要筛选字符串数组,请使用作“筛选字符串数组”。 |
| 获取 IA-Connect Orchestrator 查找表内容 |
从业务流程协调程序上保存的 IA-Connect Orchestrator 查找表中检索所有数据。 这不会检索由 IA-Connect 代理(磁盘上保存的 CSV 文件)处理的查阅表。 |
| 获取 IA-Connect 列表内容 |
从 IA-Connect Orchestrator 列表中检索所有数据。 |
| 获取 IA-Connect 查阅表格摘要 |
检索当前加载到 IA-Connect 代理中的查阅表的摘要。 |
|
获取 Power |
获取运行 IA-Connect 代理的会话中的 PowerShell 版本。 这会检测Microsoft PowerShell v3.x 到 v5.x,而不是 PowerShell core(6.x 及更高版本)。 |
| 获取正则表达式匹配 |
对输入字符串执行正则表达式(正则表达式)匹配,并返回字符串是否匹配匹配的表达式和详细信息。 |
| 获取正则表达式匹配项 |
对输入字符串执行正则表达式(正则表达式)匹配,并返回字符串数组中的所有匹配项。 如果没有匹配项,则数组将为空。 |
| 获取正则表达式组匹配项 |
对输入字符串执行正则表达式(正则表达式)匹配,并返回匹配组名称和值的列表。 |
|
运行 Power |
在运行 IA-Connect 代理的会话中运行 PowerShell 脚本,其中脚本内容将传递到“PowerShell 脚本内容”(PowerShellScriptContents)输入中的 IA-Connect 代理。 这是运行自己的自定义 PowerShell 代码的建议作。 此作还可用于从 PowerShell 脚本的上一次执行中检索结果,以代理线程的形式运行。 代理使用 Microsoft PowerShell v3.x 到 v5.x(安装哪个版本),而不是 PowerShell 核心(6.x 及更高版本)来执行 PowerShell。 |
| 重命名 JSON 表中的列 |
采用 JSON 格式的输入表,重命名指定的列并返回 JSON 格式的新表。 如果要从实际表(即不是 JSON 格式)重命名列,请使用作“重命名表中的列”。 |
| 重命名表中的列 |
获取输入表,重命名指定的列并返回一个新表。 如果要从 JSON 格式的表中重命名列,请使用作“重命名 JSON 表中的列”。 |
IA-Connect 查阅表格的查阅值
从 Orchestrator 查找表(对于使用 Orchestrator 的自动化)或当前加载到 IA-Connect 代理中的查找表(对于使用 Orchestrator 的自动化)检索与输入数据匹配的第一行中的值。 如果 Orchestrator 的查找表的名称与加载到 IA-Connect 代理中的名称相同,则使用 Orchestrator 查找表(如果自动化通过 Orchestrator)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
业务流程协调程序查找表的名称或加载到 IA-Connect 代理中的查阅表。 |
|
输入数据 JSON
|
InputDataJSON | string |
用于查找的输入数据,采用 JSON 格式。 例如,如果查阅表格包含“JobTitle”和“Country”属性列,则可以提交以下 JSON:{ “JobTitle”: “顾问”, “Country”: “England” }。 |
|
|
搜索结果值列名称
|
SearchResultValueColumnName | True | string |
查找表中保存要读取的返回值的列。 |
|
搜索结果值列索引
|
SearchResultValueColumnIndex | integer |
如果设置为 1(默认值),将返回与请求的名称匹配的第一个结果列中的值。 设置为更高的值(N),以返回第 N 个匹配列。 |
|
|
如果没有匹配项,则引发异常
|
RaiseExceptionIfNoMatch | boolean |
如果查找与任何数据匹配,则设置为 true(默认值),以引发异常。 如果查找与任何数据匹配,则设置为 false 以返回空白字符串。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出查找值
|
OutputLookupValue | string |
从指定的查阅表格列获取的输出值,通过查找 IA-Connect 查阅表格的输入数据获得。 |
从 IA-Connect 列表中获取列
从 IA-Connect Orchestrator 列表中检索列。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
列表名称
|
ListName | True | string |
Orchestrator 列表的名称。 |
|
搜索列索引
|
SearchColumnIndex | integer |
要返回的列表中的列的索引。 这默认为 1,返回第一列。 如果要按名称检索列,请将其设置为 0 并改为指定列名。 |
|
|
搜索列名称
|
SearchColumnName | string |
如果要按名称从列表中检索列,则列表中要返回的列的名称。 如果要使用此输入,请将“搜索列索引”设置为 0。 |
|
|
返回空白单元格
|
ReturnBlankCells | boolean |
如果要在返回数据中包含空白单元格,则设置为 true。 设置为 false(默认值)以仅包含具有值的单元格。 |
|
|
如果列表不存在,则回退
|
FallBackIfListDoesNotExist | boolean |
如果指定的列表不存在,此输入将控制结果。 如果此输入设置为 false(默认值),则会出现异常。 如果此输入设置为 true,“输出列表”(采用请求的返回格式设置)将设置为回退值,该值可以为空白或所选值。 |
|
|
回退值
|
FallbackValue | string |
如果指定的列表不存在,并且输入“如果列表不存在则回退”设置为 true,则此回退值将用于以请求的返回格式设置的输出。 如果要从查找表读取数据,而某些数据项表示列表,而某些项是实际数据,则这非常有用。 |
|
|
返回格式
|
ReturnFormat | string |
返回结果时要使用的格式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出列表 JSON
|
OutputListJSON | string |
列表中的输出列,采用 JSON 格式。 |
|
输出列表
|
OutputList | array of object |
列表中的输出列,格式为数据表。 |
|
items
|
OutputList | object | |
|
输出列表数组
|
OutputListArray | array of object |
列表中的输出列,采用数组格式。 |
|
items
|
OutputListArray | object | |
|
输出中的行数
|
NumberOfRowsInOutput | integer |
输出中的行数。 |
从 IA-Connect 查阅表格查找列
从 Orchestrator 查找表(对于使用 Orchestrator 的自动化)或当前加载到 IA-Connect 代理中的查找表(从与输入数据匹配的第一行中检索一个或多个相同命名的列),并作为表返回。 例如,查阅表格可能包含多个名为“AD 组”的输出列来表示多个 AD 组,它们将作为输出表中的单独行返回。 如果 Orchestrator 的查找表的名称与加载到 IA-Connect 代理中的名称相同,则使用 Orchestrator 查找表(如果自动化通过 Orchestrator)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
业务流程协调程序查找表的名称或加载到 IA-Connect 代理中的查阅表。 |
|
输入数据 JSON
|
InputDataJSON | string |
用于查找的输入数据,采用 JSON 格式。 例如,如果查阅表格包含“JobTitle”和“Country”属性列,则可以提交以下 JSON:{ “JobTitle”: “顾问”, “Country”: “England” }。 |
|
|
搜索结果表列名称
|
SearchResultTableColumnName | True | string |
查找表中的输出列的名称,该列包含要在输出表中返回的值。 如果查阅表中只有一个输出列具有此名称,则输出表将有一行。 如果查阅表中的多个输出列共享公用名,则输出表将具有多行。 |
|
如果没有匹配项,则引发异常
|
RaiseExceptionIfNoMatch | boolean |
如果查找与任何数据匹配,则设置为 true(默认值),以引发异常。 如果查找与任何数据匹配,则设置为 false 以返回空白字符串。 |
|
|
返回空白单元格
|
ReturnBlankCells | boolean |
如果要在返回表中包括空白单元格,则设置为 true。 设置为 false(默认值)以仅包含具有值的单元格。 |
|
|
返回格式
|
ReturnFormat | string |
返回结果时要使用的格式。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出查找表 JSON
|
OutputLookupTableJSON | string |
输出表从具有指定名称的一个或多个查阅表格列读取,通过查找 IA-Connect 查阅表格的输入数据获得。 输出表将具有一列(匹配请求的结果表列名)和一行或多行(JSON 格式)。 |
|
输出查找表
|
OutputLookupTable | array of object |
输出表从具有指定名称的一个或多个查阅表格列读取,通过查找 IA-Connect 查阅表格的输入数据获得。 输出表将具有一列(与请求的结果表列名匹配)和一行或多行。 |
|
items
|
OutputLookupTable | object | |
|
输出查找数组
|
OutputLookupArray | array of object |
输出数组从具有指定名称的一个或多个查阅表格列读取,通过查找 IA-Connect 查阅表格的输入数据获得。 输出数组是包含一行或多行的单个列。 |
|
items
|
OutputLookupArray | object | |
|
输出中的行数
|
NumberOfRowsInOutput | integer |
输出中的行数。 |
从 IA-Connect 查阅表格查找数据单元格
从 Orchestrator 查找表中检索所有数据单元格(对于使用 Orchestrator 的自动化),从与输入数据匹配的第一行中检索所有数据单元格,并作为表返回。 此作不支持加载到 IA-Connect 代理中的查找表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
Orchestrator 查找表的名称。 |
|
输入数据 JSON
|
InputDataJSON | string |
用于查找的输入数据,采用 JSON 格式。 例如,如果查阅表格包含“JobTitle”和“Country”属性列,则可以提交以下 JSON:{ “JobTitle”: “顾问”, “Country”: “England” }。 |
|
|
如果没有匹配项,则引发异常
|
RaiseExceptionIfNoMatch | boolean |
如果查找与任何数据匹配,则设置为 true(默认值),以引发异常。 如果查找与任何数据匹配,则设置为 false 以返回空白字符串。 |
|
|
返回空白单元格
|
ReturnBlankCells | boolean |
如果要在返回表中包括空白单元格,则设置为 true。 设置为 false(默认值)以仅包含具有值的数据单元格。 |
|
|
返回格式
|
ReturnFormat | string |
返回结果时要使用的格式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出查找表 JSON
|
OutputLookupTableJSON | string |
包含与输入数据匹配的行中的数据单元格的输出表,通过针对 IA-Connect 查找表查找输入数据获得。 输出表将具有一行和一个或多个 JSON 格式的数据列。 |
|
输出查找表
|
OutputLookupTable | array of object |
包含与输入数据匹配的行中的数据单元格的输出表,通过针对 IA-Connect 查找表查找输入数据获得。 输出表将包含一行和一个或多个数据列。 |
|
items
|
OutputLookupTable | object | |
|
输出中的单元格数
|
NumberOfCellsInOutput | integer |
输出中的单元格数。 |
从 JSON 获取表
采用 JSON 格式的输入表,并作为表返回。 这称为反序列化。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
开始行索引
|
StartRowIndex | True | integer |
要检索的第一行的索引。 使用 1 从第一行开始,N 从第 N 行开始。 |
|
要检索的行数
|
NumberOfRowsToRetrieve | integer |
要检索的行数。 使用 0(或留空)检索所有行。 |
|
|
启动列索引
|
StartColumnIndex | integer |
要检索的第一列的索引。 使用 1 从第一列开始,N 从第 N 列开始。 如果要指定按名称检索的第一列,请将此输入留空,并改用输入“开始列名称”。 |
|
|
启动列名称
|
StartColumnName | string |
要检索的第一列的可选名称。 如果要按索引检索列,请将此输入留空,并改用输入“开始列索引”。 |
|
|
要检索的列数
|
NumberOfColumnsToRetrieve | integer |
要检索的列数。 使用 0(或留空)检索所有列。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数(应始终为 1)。 |
从 JSON 表中删除列
采用 JSON 格式的输入表,删除列或列,并返回 JSON 格式的新表。 如果要从实际表中删除列(即不是 JSON 格式),请使用作“从表中删除列”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
启动列索引
|
StartColumnIndex | integer |
要开始删除的列的索引。 使用 1 删除第一列,N 删除第 N 列。 如果要按名称删除列,请将此输入留空,并改用输入“要删除的列名”。 |
|
|
要删除的列名
|
ColumnNameToDelete | string |
要删除的列的可选名称。 如果要按索引删除列,请将此输入留空,并改用输入“开始列索引”。 |
|
|
要删除的列数
|
NumberOfColumnsToDelete | True | integer |
要删除的列数,从指定的索引或名称开始。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
从 JSON 表中删除行
采用 JSON 格式的输入表,删除位于指定位置的行或行,并返回 JSON 格式的新表。 如果要从实际表中删除行或行(即不采用 JSON 格式),请使用作“从表中删除行”。 如果要从字符串数组中删除行或行,请使用作“从字符串数组中删除行”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
开始行索引
|
StartRowIndex | True | integer |
要开始删除的行的索引。 使用 1 删除第一行,N 删除第 N 行。 |
|
要删除的行数
|
NumberOfRowsToDelete | True | integer |
要删除的行数。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
从 JSON 表列获取字符串数组
采用 JSON 格式的输入表,并将指定的列作为字符串数组返回。 如果要从实际表(即不是 JSON 格式)获取字符串数组,请使用作“从表获取数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
列索引
|
ColumnIndex | integer |
要作为数组返回的列的索引。 对第一列使用 1,第 N 列使用 N。 如果要按名称检索列,请将此输入留空,并改用输入“列名”。 |
|
|
列名称
|
ColumnName | string |
要作为数组返回的列的可选名称。 如果要按索引检索列,请将此输入留空,并改用输入“列索引”。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of string |
字符串的输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
从 JSON 表单元格获取字符串
采用 JSON 格式的输入表,并将指定的单元格作为字符串返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
行索引
|
RowIndex | integer |
包含要检索的单元格的行的索引。 第一行使用 1,第 N 行为 N。 |
|
|
列索引
|
ColumnIndex | integer |
包含要检索的单元格的列的索引。 对第一列使用 1,第 N 列使用 N。 如果要按名称检索列,请将此输入留空,并改用输入“列名”。 |
|
|
列名称
|
ColumnName | string |
包含要检索的单元格的列的可选名称。 如果要按索引检索列,请将此输入留空,并改用输入“列索引”。 |
|
|
如果单元格不存在,则回退
|
FallBackIfCellDoesNotExist | boolean |
如果指定的行索引、列索引或名称不存在,则此输入控制结果。 如果此输入设置为 false(默认值),则会出现异常。 如果此输入设置为 true,“输出字符串”将设置为回退值,该值可以为空白或所选值。 |
|
|
回退值
|
FallbackValue | string |
如果指定的行索引、列索引或名称不存在,并且输入“如果单元格不存在则回退”设置为 true,则此回退值将用于输出字符串。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出字符串
|
OutputString | string |
输出单元格内容作为字符串。 |
从字符串中删除字符
获取一个输入字符串,并返回删除了指定字符的字符串。 如果未找到指定的字符,将返回原始字符串。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入字符串
|
InputString | string |
执行字符删除的输入字符串。 |
|
|
要从输入字符串中删除的字符
|
CharactersToRemoveFromInputString | string |
包含要从输入中删除的所有字符的字符串。 例如:!@&?^*。 |
|
|
从输入字符串中删除音调符号
|
RemoveDiacriticsFromInputString | boolean |
如果设置为 true,IA-Connect 将尝试从输入字符串中删除所有音调符号,并将字符替换为同一个字符减去音调符号。 例如:将“锐重音 a”替换为“a”。 在没有直接映射到简单字符的情况下,将删除该字符。 例如:删除了德语锐号 S。 |
|
|
从输入字符串中删除非字母数字
|
RemoveNonAlphaNumericFromInputString | boolean |
如果设置为 true,IA-Connect 将从输入字符串中删除所有非字母数字字符。 |
|
|
从输入字符串中删除数字字符
|
RemoveNumericFromInputString | boolean |
如果设置为 true,IA-Connect 将从输入字符串中删除所有数值字符。 |
|
|
从输入字符串中删除小写字符
|
RemoveLowercaseCharactersFromInputString | boolean |
如果设置为 true,IA-Connect 将从输入字符串中删除所有小写字母字符。 |
|
|
从输入字符串中删除大写字符
|
RemoveUppercaseCharactersFromInputString | boolean |
如果设置为 true,IA-Connect 将从输入字符串中删除所有大写字母字符。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出字符串
|
OutputString | string |
包含已删除字符的字符串。 如果未找到指定字符,则这是原始字符串。 |
从字符串数组中删除项
获取字符串项的输入数组,删除位于指定位置的项或项,并返回新数组。 如果要从表中删除行或行,请使用作“从表中删除行”。 如果要从 JSON 格式的表中删除行或行,请使用作“从 JSON 表中删除行”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
启动项索引
|
StartItemIndex | True | integer |
要开始删除的项的索引。 使用 1 删除第一项,N 删除第 N 项。 |
|
要删除的项目数
|
NumberOfItemsToDelete | True | integer |
要删除的项数。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of string |
字符串的输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
从字符串数组获取 JSON 表
获取字符串项的输入数组,并作为 JSON 表返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
列名称
|
ColumnName | True | string |
要用于表列的名称。 |
|
删除空项
|
DropEmptyItems | boolean |
设置为 true 以忽略数组中的空项。 设置为 false 以包含所有项。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数(应始终为 1)。 |
从字符串数组获取表
获取字符串项的输入数组,并作为表返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
列名称
|
ColumnName | True | string |
要用于表列的名称。 |
|
删除空项
|
DropEmptyItems | boolean |
设置为 true 以忽略数组中的空项。 设置为 false 以包含所有项。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数(应始终为 1)。 |
从本地文件导入程序集
从运行 IA-Connect 控制器的计算机上传 DotNet 程序集,并将其加载到内存中的 IA-Connect 代理,并在动态 DotNet 代码引用时使用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
本地程序集文件路径
|
LocalAssemblyFilePath | True | string |
本地会话中本地程序集文件的文件路径(其中 IA-Connect 控制器正在运行)。 |
|
程序集名称
|
AssemblyName | True | string |
要导入的程序集的名称。 |
|
压缩
|
Compress | boolean |
程序集应该在上传之前进行压缩吗? |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
从表中删除列
获取输入表,删除列或列并返回新表。 如果要从 JSON 格式的表中删除列,请使用作“从 JSON 表中删除列”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
启动列索引
|
StartColumnIndex | integer |
要开始删除的列的索引。 使用 1 删除第一列,N 删除第 N 列。 如果要按名称删除列,请将此输入留空,并改用输入“要删除的列名”。 |
|
|
要删除的列名
|
ColumnNameToDelete | string |
要删除的列的可选名称。 如果要按索引删除列,请将此输入留空,并改用输入“开始列索引”。 |
|
|
要删除的列数
|
NumberOfColumnsToDelete | True | integer |
要删除的列数,从指定的索引或名称开始。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
从表中删除行
获取输入表,删除位于指定位置的行或行,并返回一个新表。 如果要从字符串数组中删除行或行,请使用作“从字符串数组中删除行”。 如果要从 JSON 格式的表中删除行或行,请使用作“从 JSON 表中删除行”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
开始行索引
|
StartRowIndex | True | integer |
要开始删除的行的索引。 使用 1 删除第一行,N 删除第 N 行。 |
|
要删除的行数
|
NumberOfRowsToDelete | True | integer |
要删除的行数。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
从表列获取字符串数组
获取输入表,并将指定的列作为字符串数组返回。 如果要从 JSON 格式的表中获取字符串数组,请使用作“从 JSON 表获取数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
列索引
|
ColumnIndex | integer |
要作为数组返回的列的索引。 对第一列使用 1,第 N 列使用 N。 如果要按名称检索列,请将此输入留空,并改用输入“列名”。 |
|
|
列名称
|
ColumnName | string |
要作为数组返回的列的可选名称。 如果要按索引检索列,请将此输入留空,并改用输入“列索引”。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of string |
字符串的输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
从输入变量创建 JSON
采用输入变量数组,并采用 JSON 格式返回,还可以选择作为 JSON 表返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
属性名称
|
PropertyName | string | ||
|
属性数据类型
|
DataType | string | ||
|
属性值
|
Value | string | ||
|
以 JSON 表形式返回
|
ReturnAsJSONTable | True | boolean |
如果设置为 true,则 JSON 将以表/数据表格式返回(即格式为 [{}])。 如果设置为 false,JSON 将作为单个实体返回(即格式 {})。 要使用的格式取决于使用 JSON 执行的作。 大多数 IA-Connect作需要数据表格式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON
|
OutputJSON | string |
变量及其以 JSON 格式编码的值。 |
使用正则表达式拆分字符串
使用正则表达式(正则表达式)匹配拆分输入字符串,并将字符串的各个拆分组件作为字符串数组返回。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
要拆分的输入文本
|
TextToSplit | True | string |
要与正则表达式拆分的输入文本。 |
|
正则表达式
|
Regex | True | string |
要对其拆分输入文本的正则表达式。 |
|
区分大小写的拆分
|
CaseSensitive | boolean |
对于区分大小写的拆分(例如 A 不是默认值),或者对于不区分大小写的拆分(例如 A 和 a)设置为 false,则设置为 false。 |
|
|
剪裁结果
|
TrimResults | boolean |
如果应剪裁每个输出数组元素,则设置为 true(默认值)。 |
|
|
删除空结果
|
RemoveEmptyResults | boolean |
如果应从输出数组中删除空输出数组元素(即不需要空结果),则设置为 true。 |
|
|
正则表达式超时(以秒为单位)
|
RegexTimeoutInSeconds | integer |
正则表达式在超时之前可以处理的最大秒数。这会停止某些正则表达式导致的无限循环。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of object |
包含字符串的各个组件的输出字符串数组,使用正则表达式拆分。 |
|
items
|
OutputArray | object | |
|
输出中的元素数
|
NumberOfElementsInOutput | integer |
输出数组中的元素数。 |
删除 IA-Connect 查阅表格
删除当前加载到 IA-Connect 代理中的查阅表格。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
加载到 IA-Connect 代理中的查阅表的名称。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
命令结果
|
RemoveIAConnectLookupTableResult | boolean |
命令的结果(成功或失败)。 |
|
错误消息
|
ErrorMessage | string |
如果命令未成功,将包含返回的错误消息。 |
删除所有 IA-Connect 查找表
删除当前加载到 IA-Connect 代理中的所有查找表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
命令结果
|
RemoveAllIAConnectLookupTablesResult | boolean |
命令的结果(成功或失败)。 |
|
错误消息
|
ErrorMessage | string |
如果命令未成功,将包含返回的错误消息。 |
加载 IA-Connect 查阅表格
从运行 IA-Connect 代理的计算机加载 IA-Connect 查找表。 可以通过进一步 IA-Connect作来执行数据查找来使用这些查找表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格路径
|
Path | True | string |
查阅表格的完整路径。 必须可从运行 IA-Connect 代理的会话中访问此功能。 如果指定了文件夹,则处理该文件夹下的所有文件。 |
|
如果任何表无法加载,则引发异常
|
RaiseExceptionIfAnyTableFailsToLoad | True | boolean |
如果设置为 true 并且任何 IA-Connect 查阅表格无法加载(例如,如果表中存在问题),则会引发异常。 这是默认值,因为如果任何表无法加载,这通常会导致该过程的后面部分出现异常。 如果设置为 false,则将忽略问题查找表,并且仅加载可用查阅表。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
加载的查找表数
|
NumberOfLookupTablesLoaded | integer |
已成功加载的查阅表数。 |
|
未能加载的查阅表数
|
NumberOfLookupTablesFailedToLoad | integer |
未能加载的查阅表数。 仅当“如果任何表无法加载时引发异常”设置为 false,则只会设置此异常,否则会出现异常。 |
在 <a0/a0> 之间获取字符串
获取一个输入字符串,并返回位于两个指定字符串之间或字符串和行尾之间的字符串的第一个实例。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入字符串
|
InputString | string |
在其中执行搜索的输入字符串。 |
|
|
启动搜索字符串
|
StartSearchString | string |
开始搜索字符串。 |
|
|
结束搜索字符串
|
EndSearchString | string |
如果搜索到行的末尾,则结束搜索字符串或留空。 |
|
|
按行搜索
|
SearchLineByLine | boolean |
如果要逐行搜索输入字符串,并且结果仅包含当前行中的匹配字符串,则设置为 true。 设置为 false 以将输入字符串视为单个项。 |
|
|
如果未找到,则引发异常
|
ThrowExceptionIfNotFound | boolean |
如果希望在找不到搜索字符串时引发异常,则设置为 true;如果找不到搜索字符串时作应返回“found between String”=false,则设置为 false。 |
|
|
剪裁结果
|
TrimResult | boolean |
如果希望剪裁结果之前或之后的空格或选项卡,则设置为 true。 |
|
|
搜索是正则表达式
|
SearchIsRegularExpression | boolean |
如果搜索字符串是正则表达式,则设置为 true。 如果搜索字符串是普通文本,则设置为 false。 |
|
|
区分大小写的搜索
|
CaseSensitiveSearch | boolean |
如果搜索应区分大小写,则设置为 true。 对于不区分大小写的搜索,设置为 false。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
找到搜索字符串
|
SearchStringFound | boolean |
如果“如果未找到引发异常”设置为 false,则如果找到搜索字符串,则此输出将设置为 true,否则为 false。 |
|
两者之间的字符串
|
StringBetween | string |
在指定字符串之间找到的字符串。 |
对 JSON 表进行排序
获取输入 JSON 表,对表进行排序并返回新的 JSON 表。 如果要对实际表(即不是 JSON 格式)进行排序,请使用作“排序表”。 如果要对字符串数组进行排序,请使用作“排序字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
对列名称进行排序
|
SortColumnName | True | string |
要排序依据的列名。 |
|
升序排序
|
Ascending | boolean |
设置为 true 以按升序排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 2
|
SortColumnName2 | string |
要排序依据的可选第二列名称(在第一列排序后)。 |
|
|
升序 2 排序
|
Ascending2 | boolean |
设置为 true 以按升序对第二列名进行排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 3
|
SortColumnName3 | string |
要排序依据的可选第三列名称(按第一列和第二列排序后)。 |
|
|
升序排序 3
|
Ascending3 | boolean |
设置为 true 以按升序对第三列名称进行排序。 设置为 false 以降序排序。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
对字符串数组进行排序
获取字符串项的输入数组,对数组进行排序并返回一个新数组。 如果要对表进行排序,请使用作“排序表”。 如果要以 JSON 格式对表进行排序,请使用作“对 JSON 表进行排序”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
升序排序
|
Ascending | boolean |
设置为 true 以按升序排序。 设置为 false 以降序排序。 |
|
|
区分大小写
|
CaseSensitive | boolean |
对于区分大小写的排序(即单独排序的大写和小写)设置为 true。 对于不区分大小写的排序,设置为 false。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已排序的输出数组
|
OutputArray | array of string |
字符串的排序输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
将 CSV 上传到 IA-Connect Orchestrator 列表
将替换 CSV 数据上传到 IA-Connect Orchestrator 列表,替换任何现有内容。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
列表名称
|
ListName | True | string |
Orchestrator 列表的名称。 |
|
CSV 数据
|
CSVData | True | string |
要存储在 Orchestrator 列表中的替换 CSV 数据。 如果列表已存在,列表内容将替换为此 CSV 数据。 不能提供空的 CSV 输入,但可以提供没有数据行的 CSV 标头行。 |
|
创建列表(如果不存在)
|
CreateListIfNotExist | boolean |
如果设置为 false(默认值),并且命名列表尚不存在,将引发异常。 如果设置为 true,则将创建命名列表(如果不存在)。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
命令结果
|
UploadCSVToIAConnectListResult | boolean |
命令的结果(成功或失败)。 |
|
错误消息
|
ErrorMessage | string |
如果命令未成功,将包含返回的错误消息。 |
将 CSV 上传到 IA-Connect Orchestrator 查找表
将替换 CSV 数据上传到 IA-Connect Orchestrator 查找表,替换任何现有内容。 此作不会与 IA-Connect 代理处理的查阅表(磁盘上保留的 CSV 文件)进行交互。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
Orchestrator 查找表的名称。 |
|
CSV 数据
|
CSVData | True | string |
要存储在 Orchestrator 查找表中的替换 CSV 数据。 如果查阅表格已存在,表内容将替换为此 CSV 数据。 不能提供空的 CSV 输入,但可以提供没有数据行的 CSV 标头行。 |
|
创建查阅表格(如果不存在)
|
CreateLookupTableIfNotExist | boolean |
如果设置为 false(默认值),并且命名的查阅表尚不存在,将引发异常。 如果设置为 true,则将创建命名的查阅表格(如果不存在)。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
命令结果
|
UploadCSVToIAConnectLookupTableResult | boolean |
命令的结果(成功或失败)。 |
|
错误消息
|
ErrorMessage | string |
如果命令未成功,将包含返回的错误消息。 |
将一行输入变量插入 JSON 表中
采用 JSON 格式的输入表,在指定位置插入从输入变量创建的行,并返回 JSON 格式的新表。 输入行架构应与输入表(即使用相同的属性名称和数据类型)匹配。 如果要将行插入实际表(即不是 JSON 格式),请使用作“将行插入表中”。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
行索引
|
RowIndex | True | integer |
要插入的行的索引。 使用 0 在表格开头插入,第 1 行后插入 1,N 在行 N 之后插入。-1 或等于或高于表中要插入的项数的任何数字(如果不知道表格的长度,则很有用)。 |
|
属性名称
|
PropertyName | string | ||
|
属性数据类型
|
DataType | string | ||
|
属性值
|
Value | string |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
将数组转换为 JSON
获取输入数组并序列化为 JSON 字符串。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Input 对象
|
Input object | object |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON
|
OutputJSON | string |
输出 JSON 字符串。 |
将行插入 JSON 表
采用 JSON 格式的输入表,在指定位置插入行,并返回 JSON 格式的新表。 如果要将行插入实际表(即不是 JSON 格式),请使用作“将行插入表中”。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
行索引
|
RowIndex | True | integer |
要插入的行的索引。 使用 0 在表格开头插入,第 1 行后插入 1,N 在行 N 之后插入。-1 或等于或高于表中要插入的项数的任何数字(如果不知道表格的长度,则很有用)。 |
|
要插入的 JSON 行
|
RowToInsertJSON | string |
要以 JSON 格式插入的行的内容。 如果要插入空行,请留空。 例如:若要在列“Name”中插入“Simon”,请使用 {“Name”:“Simon”} 并将“England”插入列“Country”,请使用 {“Name”:“Simon”,“Country”:“England”}。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
将行插入字符串数组
获取字符串项的输入数组,在指定位置插入行并返回新数组。 如果要将行插入表中,请使用作“将行插入表中”。 如果要以 JSON 格式将行插入表中,请使用作“将行插入 JSON 表中”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
行索引
|
RowIndex | True | integer |
要插入的行的索引。 使用 0 在数组开头插入,第 1 行后插入 1,在行 N 之后插入 N。-1 或等于或高于数组末尾要插入的项数的任何数字(如果不知道数组的长度,则很有用)。 |
|
要插入的值
|
ValueToInsert | string |
要在新行中插入的字符串值。 如果要插入空行,请留空。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of string |
字符串的输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
将行插入表中
获取输入表,在指定位置插入行并返回一个新表。 如果要将字符串插入字符串数组,请使用作“将行插入字符串数组”。 如果要以 JSON 格式将行插入表中,请使用作“将行插入 JSON 表中”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
行索引
|
RowIndex | True | integer |
要插入的行的索引。 使用 0 在表格开头插入,第 1 行后插入 1,N 在行 N 之后插入。-1 或等于或高于表中要插入的项数的任何数字(如果不知道表格的长度,则很有用)。 |
|
要插入的 JSON 行
|
RowToInsertJSON | string |
要以 JSON 格式插入的行的内容。 如果要插入空行,请留空。 例如:若要在列“Name”中插入“Simon”,请使用 {“Name”:“Simon”} 并将“England”插入列“Country”,请使用 {“Name”:“Simon”,“Country”:“England”}。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
排序表
获取输入表,对一行或多行进行排序,并返回一个新表。 如果要以 JSON 格式对表进行排序,请使用作“对 JSON 表进行排序”。 如果要对字符串数组进行排序,请使用作“排序字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
对列名称进行排序
|
SortColumnName | True | string |
要排序依据的列名。 如果要按多个列排序,请列出以逗号分隔的列。 |
|
升序排序
|
Ascending | True | boolean |
设置为 true 以按升序排序。 设置为 false 以降序排序。 |
|
对列名进行排序 2
|
SortColumnName2 | string |
要排序依据的可选第二列名称(在第一列排序后)。 |
|
|
升序 2 排序
|
Ascending2 | boolean |
设置为 true 以按升序对第二列名进行排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 3
|
SortColumnName3 | string |
要排序依据的可选第三列名称(按第一列和第二列排序后)。 |
|
|
升序排序 3
|
Ascending3 | boolean |
设置为 true 以按升序对第三列名称进行排序。 设置为 false 以降序排序。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
是否安装了 PowerShell 模块
在运行 IA-Connect 代理的计算机上搜索指定的 PowerShell 模块,并返回它是否已安装。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
PowerShell 模块
|
PowerShellModuleName | True | string |
要搜索的 PowerShell 模块的名称。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
是否安装了 PowerShell 模块
|
PowerShellModuleIsInstalled | boolean |
如果安装了指定的 PowerShell 模块,则返回 true;否则返回 false。 |
是否安装了 PowerShell 自动化
报告运行 IA-Connect 代理的计算机上是否提供 PowerShell 自动化。 如果 PowerShell 自动化不可用,PowerShell 自动化作将不起作用。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
是否安装了 PowerShell 自动化
|
PowerShellAutomationIsInstalled | boolean |
如果 PowerShell 自动化可用,则返回 true;否则返回 false。 |
添加程序集搜索文件夹
将文件夹路径(在运行 IA-Connect 代理的计算机上)添加到 IA-Connect 代理尝试加载外部引用时要扫描的文件夹列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
文件夹路径
|
FolderPath | True | string |
要添加到文件夹列表的文件夹的路径,IA-Connect 代理在尝试加载外部引用时要扫描。 |
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
清除程序集搜索文件夹
重置 IA-Connect 代理在尝试加载外部引用时要扫描的文件夹的其他列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
筛选 JSON 表
获取输入 JSON 表,筛选表(使用 .NET DataView 行筛选器语法),并返回新的 JSON 表。 如果要筛选实际表(即不是 JSON 格式),请使用作“筛选表”。 如果要筛选字符串数组,请使用作“筛选字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
过滤器
|
Filter | True | string |
.NET DataView 行筛选器语法中的筛选器。 例如:[Name] 如“*Element”。 |
|
对列名称进行排序
|
SortColumnName | string |
应用筛选器后要排序的可选列名。 如果要按多个列排序,请列出以逗号分隔的列。 |
|
|
升序排序
|
Ascending | boolean |
设置为 true 以按升序排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 2
|
SortColumnName2 | string |
要排序依据的可选第二列名称(在第一列排序后)。 |
|
|
升序 2 排序
|
Ascending2 | boolean |
设置为 true 以按升序对第二列名进行排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 3
|
SortColumnName3 | string |
要排序依据的可选第三列名称(按第一列和第二列排序后)。 |
|
|
升序排序 3
|
Ascending3 | boolean |
设置为 true 以按升序对第三列名称进行排序。 设置为 false 以降序排序。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
筛选字符串数组
获取字符串项的输入数组,筛选数组(使用 .NET DataView 行筛选器语法),并返回一个新数组。 如果要筛选表,请使用作“筛选表”。 如果要以 JSON 格式筛选表,请使用作“筛选 JSON 表”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入数组
|
InputArray | True | array of string |
字符串的输入数组。 |
|
列名称
|
ColumnName | True | string |
用于在筛选作期间保存数组的表列的名称。 然后,此名称可用作 .NET DataView 行筛选器语法中的列名称。 例如 MyColumn,然后可称为 [MyColumn]。 |
|
过滤器
|
Filter | True | string |
.NET DataView 行筛选器语法中的筛选器。 例如:[Name] 如“*Element”。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
筛选的输出数组
|
OutputArray | array of string |
筛选的字符串输出数组。 |
|
物料数量
|
NumberOfItems | integer |
输出数组中的项数。 |
筛选表
获取输入表,筛选表(使用 .NET DataView 行筛选器语法),并返回一个新表。 如果要以 JSON 格式筛选表,请使用作“筛选 JSON 表”。 如果要筛选字符串数组,请使用作“筛选字符串数组”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
过滤器
|
Filter | True | string |
.NET DataView 行筛选器语法中的筛选器。 例如:[Name] 如“*Element”。 |
|
对列名称进行排序
|
SortColumnName | string |
应用筛选器后要排序的可选列名。 如果要按多个列排序,请列出以逗号分隔的列。 |
|
|
升序排序
|
Ascending | boolean |
设置为 true 以按升序排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 2
|
SortColumnName2 | string |
要排序依据的可选第二列名称(在第一列排序后)。 |
|
|
升序 2 排序
|
Ascending2 | boolean |
设置为 true 以按升序对第二列名进行排序。 设置为 false 以降序排序。 |
|
|
对列名进行排序 3
|
SortColumnName3 | string |
要排序依据的可选第三列名称(按第一列和第二列排序后)。 |
|
|
升序排序 3
|
Ascending3 | boolean |
设置为 true 以按升序对第三列名称进行排序。 设置为 false 以降序排序。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
获取 IA-Connect Orchestrator 查找表内容
从业务流程协调程序上保存的 IA-Connect Orchestrator 查找表中检索所有数据。 这不会检索由 IA-Connect 代理(磁盘上保存的 CSV 文件)处理的查阅表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
查阅表格名称
|
LookupTableName | True | string |
Orchestrator 查找表的名称。 |
|
返回格式
|
ReturnFormat | string |
返回结果时要使用的格式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出查找表 JSON
|
OutputLookupTableJSON | string |
查找表中的输出数据,采用 JSON 格式。 |
|
输出查找表
|
OutputLookupTable | array of object |
查找表中的输出数据,格式为数据表。 |
|
items
|
OutputLookupTable | object | |
|
输出查找表 CSV
|
OutputLookupTableCSV | string |
查找表中的输出数据,采用 CSV 格式。 |
|
输出中的行数
|
NumberOfRowsInOutput | integer |
输出中的行数。 |
|
输出中的列数
|
NumberOfColumnsInOutput | integer |
输出中的列数。 |
获取 IA-Connect 列表内容
从 IA-Connect Orchestrator 列表中检索所有数据。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
列表名称
|
ListName | True | string |
Orchestrator 列表的名称。 |
|
返回格式
|
ReturnFormat | string |
返回结果时要使用的格式。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出列表 JSON
|
OutputListJSON | string |
列表中的输出数据,采用 JSON 格式。 |
|
输出列表
|
OutputList | array of object |
列表中的输出数据,采用数据表格式。 |
|
items
|
OutputList | object | |
|
输出列表 CSV
|
OutputListCSV | string |
列表中的输出数据,采用 CSV 格式。 |
|
输出中的行数
|
NumberOfRowsInOutput | integer |
输出中的行数。 |
|
输出中的列数
|
NumberOfColumnsInOutput | integer |
输出中的列数。 |
获取 IA-Connect 查阅表格摘要
检索当前加载到 IA-Connect 代理中的查阅表的摘要。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
查阅表格 JSON
|
LookupTablesJSON | array of object |
加载到 IA-Connect 代理中的查找表。 |
|
Name
|
LookupTablesJSON.Name | string | |
|
ThenColumnIndex
|
LookupTablesJSON.ThenColumnIndex | integer | |
|
NumberOfRows
|
LookupTablesJSON.NumberOfRows | integer | |
|
NumberOfColumns
|
LookupTablesJSON.NumberOfColumns | integer | |
|
NumberOfUniqueHeaderProperties
|
LookupTablesJSON.NumberOfUniqueHeaderProperties | integer | |
|
查找表数
|
NumberOfLookupTables | integer |
当前加载到 IA-Connect 代理中的查找表数。 |
获取 PowerShell 版本
获取运行 IA-Connect 代理的会话中的 PowerShell 版本。 这会检测Microsoft PowerShell v3.x 到 v5.x,而不是 PowerShell core(6.x 及更高版本)。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
计算机名称
|
ComputerName | string |
要检查 PowerShell 版本的计算机的名称。 如果留空,将使用运行 IA-Connect 代理的计算机。 |
|
|
身份验证机制
|
AuthenticationMechanism | string |
连接到远程计算机或以替代用户身份运行脚本时要使用的身份验证机制。 支持的值为“Basic”、“Credssp”、“Default”、“Digest”、“Kerberos”和“Negotiate”。 |
|
|
连接尝试
|
ConnectionAttempts | integer |
连接到远程计算机时要尝试的连接数。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
PowerShell 主版本
|
PowerShellMajorVersion | integer |
PowerShell 的主要(整数)版本。 例如:PowerShell 5.1 将返回 5。 |
|
PowerShell 次要版本
|
PowerShellMinorVersion | integer |
PowerShell 的次要版本(小数位之后)。 例如:PowerShell 5.1 将返回 1。 |
获取正则表达式匹配
对输入字符串执行正则表达式(正则表达式)匹配,并返回字符串是否匹配匹配的表达式和详细信息。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
要匹配的输入文本
|
TextToMatch | True | string |
要与正则表达式匹配的输入文本。 |
|
正则表达式
|
Regex | True | string |
要与其匹配输入文本的正则表达式。 |
|
搜索索引
|
SearchIndex | integer |
要检索的匹配结果的索引,从 1 开始。 如果要匹配第一个结果(默认行为),请输入 1。 例如:如果输入字符串应与正则表达式匹配 5 个位置,并且你对第 4 个匹配感兴趣,请输入 4。 |
|
|
区分大小写的匹配
|
CaseSensitive | boolean |
对于区分大小写的匹配(例如 A 不是默认值),或者对于不区分大小写的匹配(例如 A 和 a)设置为 false,则设置为 false。 |
|
|
正则表达式超时(以秒为单位)
|
RegexTimeoutInSeconds | integer |
正则表达式在超时之前可以处理的最大秒数。这会停止某些正则表达式导致的无限循环。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
成功匹配
|
SuccessfulMatch | boolean |
如此 如果存在成功的匹配(在指定的搜索索引处),则为 false(如果没有)。 |
|
匹配字符串值
|
MatchStringValue | string |
如果匹配成功,此字符串值将保留与正则表达式匹配的输入文本中的文本。 |
|
匹配位置索引
|
MatchIndex | integer |
如果匹配成功,此值将保留输入文本中的位置,以匹配匹配的位置。 此值从 0 开始,表示输入文本字符串的开头。 |
|
匹配字符串长度
|
MatchStringLength | integer |
如果匹配成功,则此值保存与正则表达式匹配的输入文本中的文本长度(即输出值“匹配字符串值”的长度)。 |
获取正则表达式匹配项
对输入字符串执行正则表达式(正则表达式)匹配,并返回字符串数组中的所有匹配项。 如果没有匹配项,则数组将为空。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
要匹配的输入文本
|
TextToMatch | True | string |
要与正则表达式匹配的输入文本。 |
|
正则表达式
|
Regex | True | string |
要与其匹配输入文本的正则表达式。 |
|
要执行的最大匹配项
|
MaximumMatches | integer |
要执行的正则表达式的最大匹配量。 对于无限数量的匹配项(即在不再匹配之前保持匹配),请输入任何值或值 0(默认值)。 此输入旨在通过限制匹配项数来避免无限正则表达式循环。 |
|
|
区分大小写的匹配
|
CaseSensitive | boolean |
对于区分大小写的匹配(例如 A 不是默认值),或者对于不区分大小写的匹配(例如 A 和 a)设置为 false,则设置为 false。 |
|
|
剪裁结果
|
TrimResults | boolean |
如果应剪裁每个输出数组元素,则设置为 true(默认值)。 |
|
|
删除空结果
|
RemoveEmptyResults | boolean |
如果应从输出数组中删除空输出数组元素(即不需要空结果),则设置为 true。 |
|
|
正则表达式超时(以秒为单位)
|
RegexTimeoutInSeconds | integer |
正则表达式在超时之前可以处理的最大秒数。这会停止某些正则表达式导致的无限循环。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出数组
|
OutputArray | array of object |
包含单个正则表达式匹配的输出字符串数组。 |
|
items
|
OutputArray | object | |
|
输出中的元素数
|
NumberOfElementsInOutput | integer |
输出数组中的元素数。 |
获取正则表达式组匹配项
对输入字符串执行正则表达式(正则表达式)匹配,并返回匹配组名称和值的列表。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
要匹配的输入文本
|
TextToMatch | True | string |
要与正则表达式匹配的输入文本。 |
|
正则表达式
|
Regex | True | string |
要与其匹配输入文本的正则表达式。 |
|
要检索的组
|
GroupsToRetrieve | array of string |
一个字符串数组,其中包含要检索的正则表达式组的名称。 如果提供了空白数组,则会检索所有组。 例如:如果正则表达式包含 (?<NeedsUpdating>(是|否)并指定应检索“NeedsUpdating”组,然后返回该命名组的匹配值。 |
|
|
搜索索引
|
SearchIndex | integer |
要检索的匹配结果的索引,从 1 开始。 如果要匹配第一个结果(默认行为),请输入 1。 例如:如果输入字符串应与正则表达式匹配 5 个位置,并且你对第 4 个匹配感兴趣,请输入 4。 |
|
|
区分大小写的匹配
|
CaseSensitive | boolean |
对于区分大小写的匹配(例如 A 不是默认值),或者对于不区分大小写的匹配(例如 A 和 a)设置为 false,则设置为 false。 |
|
|
正则表达式超时(以秒为单位)
|
RegexTimeoutInSeconds | integer |
正则表达式在超时之前可以处理的最大秒数。这会停止某些正则表达式导致的无限循环。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
正则表达式组
|
RegexGroups | array of object |
一个数组,其中包含正则表达式组的名称和值与输入字符串匹配。 |
|
资产
|
RegexGroups.Property | string | |
|
价值
|
RegexGroups.Value | string | |
|
组数
|
NumberOfRegexGroups | integer |
正则表达式组的数目。 |
运行 PowerShell 脚本
在运行 IA-Connect 代理的会话中运行 PowerShell 脚本,其中脚本内容将传递到“PowerShell 脚本内容”(PowerShellScriptContents)输入中的 IA-Connect 代理。 这是运行自己的自定义 PowerShell 代码的建议作。 此作还可用于从 PowerShell 脚本的上一次执行中检索结果,以代理线程的形式运行。 代理使用 Microsoft PowerShell v3.x 到 v5.x(安装哪个版本),而不是 PowerShell 核心(6.x 及更高版本)来执行 PowerShell。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
PowerShell 脚本内容
|
PowerShellScriptContents | string |
要执行的 PowerShell 脚本的内容。 IA-Connect 将通过直接传递到 PowerShell 自动化引擎来执行此脚本 as-is。 实际上未在磁盘上创建 PowerShell 脚本。 或者,可以通过输入以下内容在磁盘上运行现有的 PowerShell 脚本:返回和“scriptpath”。 例如:return & 'c:\scripts\TestScript.ps1'。 |
|
|
计算机名称
|
ComputerName | string |
要在其中运行 PowerShell 脚本的计算机的名称。 如果留空,脚本将在运行 IA-Connect 代理的计算机上运行。 |
|
|
不会导致错误
|
IsNoResultAnError | boolean |
如果 PowerShell 命令未返回任何数据,这是否显示错误? |
|
|
返回复杂类型
|
ReturnComplexTypes | boolean |
如果 PowerShell 返回数据包含“复杂”属性(例如值、数组、表或类的集合),则默认情况下,这些属性不会在 IA-Connect PowerShell 响应中返回。 输入“要作为集合返回的属性”、“要序列化的属性名称”和“要序列化的属性类型”允许指定应返回哪些“复杂”属性,以及用于设置数据格式的方法(按属性逐个属性选择最适合的属性)。 此输入允许你指定应使用任何剩余属性(即“复杂”且未显式命名的属性)执行的作。 如果设置为 true,IA-Connect 将尝试使用 ToString()返回数据的字符串表示形式。 如果设置为 false(默认值),IA-Connect 将不会返回属性。 |
|
|
将布尔值作为布尔值返回
|
ReturnBooleanAsBoolean | boolean |
布尔属性是否应作为布尔值返回? 如果为 false,则以字符串的形式返回这些字符串。 |
|
|
以十进制形式返回数字
|
ReturnNumericAsDecimal | boolean |
数值属性是否应作为数值返回? 如果为 false,则以字符串的形式返回这些字符串。 |
|
|
以日期的形式返回日期
|
ReturnDateAsDate | boolean |
日期属性是否应作为日期返回? 如果为 false,则以字符串的形式返回这些字符串。 |
|
|
要作为集合返回的属性
|
PropertiesToReturnAsCollectionJSON | string |
如果 PowerShell 返回数据包含“复杂”属性(例如值、数组、表或类的集合),则默认情况下,这些属性不会在 IA-Connect PowerShell 响应中返回。 使用此选项可以指定应尝试作为集合返回的“复杂”属性(按名称)IA-Connect。 根据属性的类型和值,还应考虑使用备用输入“属性名称序列化”和“属性类型进行序列化”(选择一个)。 此输入可以采用 JSON 或 CSV 格式输入。 例如:若要返回 EmailAddresses 和 MemberOf 数组属性,请输入 [{“PropertyName”: “EmailAddresses”}, {“PropertyName”: “MemberOf”}] (JSON 表格式),[“EmailAddresses”, “MemberOf”] (JSON 数组格式),或 EmailAddresses,MemberOf (CSV 格式)。 |
|
|
身份验证机制
|
AuthenticationMechanism | string |
连接到远程计算机或以替代用户身份运行脚本时要使用的身份验证机制。 支持的值为“Basic”、“Credssp”、“Default”、“Digest”、“Kerberos”和“Negotiate”。 |
|
|
连接尝试
|
ConnectionAttempts | integer |
连接到远程计算机时要尝试的连接数。 |
|
|
用户名
|
Username | string |
将脚本作为备用用户运行时使用的用户名。 |
|
|
密码
|
Password | password |
将脚本作为替代用户运行时要使用的密码。 |
|
|
以线程形式运行脚本
|
RunScriptAsThread | boolean |
如果设置为 false(默认值),IA-Connect 代理将立即运行 PowerShell 脚本,并在脚本完成后将结果返回到控制器。 如果运行长时间或复杂的 PowerShell 脚本,此作可能会超时。如果设置为 true,IA-Connect 代理将运行 PowerShell 脚本作为代理线程,IA-Connect 控制器(或 Orchestrator、PowerShell 模块、Blue Prism)可以监视此代理线程的状态,等待它完成。 这允许长时间或复杂的 PowerShell 脚本在不超时的情况下运行。 IA-Connect 代理 9.3 及更早版本无法将 PowerShell 脚本作为代理线程运行。 |
|
|
检索线程 ID 的输出数据
|
RetrieveOutputDataFromThreadId | integer |
如果以前以代理线程的形式运行 PowerShell 脚本,并将“等待线程的秒数”设置为 0,请提供代理线程 ID 以检索结果。 此代理线程 ID 将由之前对此作的调用提供。 如果只是运行 PowerShell 脚本(因此不检索以前的 PowerShell 脚本作为代理线程运行的结果),则设置为 0(默认值)。 |
|
|
等待线程的秒数
|
SecondsToWaitForThread | integer |
如果“以线程身份运行脚本”设置为 true,则等待代理线程完成的秒数。 如果运行 PowerShell 脚本的代理线程在此期间尚未完成,将引发异常。 设置为 0 以绕过等待:代理将继续运行 PowerShell 脚本,但也可用于下一作。 然后,可以使用作“等待代理线程成功完成”来等待代理线程完成,然后重新运行此“运行 PowerShell 脚本”作,并将输入“检索线程 ID 的输出数据”设置为代理线程 ID,从而检索脚本结果。 |
|
|
脚本包含存储的密码
|
ScriptContainsStoredPassword | boolean |
如果脚本包含 IA-Connect 存储的密码标识符(格式为 {IAConnectPassword:StoredPasswordIdentifier} 或 IA-Connect Orchestrator 泛型凭据,则设置为 true,格式为 {OrchestratorCredential:FriendlyName}。 { } 短语将被指定的密码替换,转义并放置在单引号中(除非它已在脚本中的引号中)。 |
|
|
日志详细输出
|
LogVerboseOutput | boolean |
设置为 true 可将任何 PowerShell 详细输出记录到 IA-Connect 日志中。 这对于调试很有用。 若要在脚本中详细记录,请使用以下 PowerShell:Write-Verbose“我的消息”-Verbose。 |
|
|
返回安全字符串
|
ReturnSecureStrings | boolean |
设置为 true 以返回 PowerShell 脚本输出中的任何安全字符串属性。 设置为 false(默认值),不返回作为安全字符串保存的任何属性。 仅当知道所执行的作时,才设置为 true,因为这可能会导致传输密码(如果 PowerShell 脚本输出中有密码)。 |
|
|
要序列化的属性名称
|
PropertyNamesToSerializeJSON | string |
如果 PowerShell 返回数据包含“复杂”属性(例如值、数组、表或类的集合),则默认情况下,这些属性不会在 IA-Connect PowerShell 响应中返回。 使用此选项可以指定哪些“复杂”属性(按名称)IA-Connect 应序列化为 JSON,因此它们将作为字符串类型返回(一旦收到,可以反序列化)。 根据属性及其类型和值,还应考虑使用备用输入“属性作为集合返回”和“属性类型进行序列化”(选择一个)。 例如:若要序列化 EmailAddresses 和 MemberOf 属性,请输入 [{“PropertyName”: “EmailAddresses”}, {“PropertyName”: “MemberOf”}] (JSON 表格式)、[“EmailAddresses”、“MemberOf”] (JSON 数组格式),或 EmailAddresses,MemberOf (CSV 格式)。 |
|
|
要序列化的属性类型
|
PropertyTypesToSerializeJSON | string |
如果 PowerShell 返回数据包含“复杂”属性(例如值、数组、表或类的集合),则默认情况下,这些属性不会在 IA-Connect PowerShell 响应中返回。 使用此选项可以指定哪些“复杂”属性(按类型)IA-Connect 应序列化为 JSON,因此它们将作为字符串类型返回(一旦收到,可以反序列化)。 根据属性及其类型和值,还应考虑使用备用输入“属性作为集合返回”和“属性名称进行序列化”(选择一个)。 此输入是具有单个“PropertyType”字段的集合。 例如:若要序列化类型为 Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]的任何属性, 输入 [{“PropertyType”: “Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”}] (JSON 表格式)、[“Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[]”] 或 'Microsoft.Graph.PowerShell.Models.IMicrosoftGraphServicePlanInfo[] (CSV 格式)。 |
|
|
Name
|
Name | string |
输入 PowerShell 参数的名称。 这必须满足 PowerShell 变量命名格式(即建议避免空格或特殊符号)。 PowerShell 变量名称不区分大小写。 例如:MyVariable 将导致创建变量$MyVariable。 |
|
|
字符串值
|
StringValue | string |
要分配给输入 PowerShell 参数的字符串值。 或者,如果要输入布尔值或数值,则使用其他值输入。 |
|
|
整数值
|
IntValue | integer |
要分配给输入 PowerShell 参数的整数(整数)值。 如果要输入字符串、布尔值或数值,或者使用其他值输入。 |
|
|
布尔值
|
BooleanValue | boolean |
要分配给输入 PowerShell 参数的布尔值(true 或 false)。 或者,如果要输入字符串或数值,则使用其他值输入。 |
|
|
十进制值
|
DecimalValue | double |
要分配给输入 PowerShell 参数的十进制值。 如果要输入字符串、布尔值或整数值,或者使用其他值输入。 |
|
|
对象值
|
ObjectValue | object |
要分配给输入 PowerShell 参数的对象值。 这将成为 PowerShell 脚本中的 JSON 序列化字符串变量,因此使用 ConvertFrom-Json 反序列化为对象。 如果要输入字符串、布尔值或数值,或者使用其他值输入。 |
|
|
Workflow
|
Workflow | True | string |
在此处添加以下表达式:workflow() |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
PowerShell 输出 JSON
|
PowerShellJSONOutput | string |
PowerShell 脚本的输出,格式为 JSON。 |
|
线程 ID
|
ThreadId | integer |
如果 PowerShell 脚本作为代理线程运行,则此输出将保存代理线程 ID,该 ID 可用于监视 PowerShell 脚本执行,并在脚本完成后检索 PowerShell 脚本结果。 |
重命名 JSON 表中的列
采用 JSON 格式的输入表,重命名指定的列并返回 JSON 格式的新表。 如果要从实际表(即不是 JSON 格式)重命名列,请使用作“重命名表中的列”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入 JSON 表
|
JSONTable | True | string |
JSON 格式的输入表。 |
|
源列名称
|
SourceColumnName | True | string |
要重命名的列的名称。 |
|
新列名
|
NewColumnName | True | string |
列的新名称。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出 JSON 表
|
OutputJSONTable | string |
JSON 格式的输出表。 |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |
重命名表中的列
获取输入表,重命名指定的列并返回一个新表。 如果要从 JSON 格式的表中重命名列,请使用作“重命名 JSON 表中的列”。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
输入表
|
Input table | object | ||
|
源列名称
|
SourceColumnName | True | string |
要重命名的列的名称。 |
|
新列名
|
NewColumnName | True | string |
列的新名称。 |
返回
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
输出表
|
OutputTable | array of object |
输出表。 |
|
items
|
OutputTable | object | |
|
行数
|
NumberOfRows | integer |
输出表中的行数。 |
|
列数
|
NumberOfColumns | integer |
输出表中的列数。 |