DLL package

动态链接库 (DLL) 文件包含 Windows 程序可以使用的共享函数库。 DLL package 使用 .dll 文件作为参考,并从 bot 调用函数。

开始之前

DLL package 中执行以下 actions,作为使用可用 actions 的一部分:
注:
  • 由于 AutomationAnywhere.ManagedDLLWrapper.exe 使用 32 位库,因此支持 32 位 DLL 函数。
  • 如果您使用自定义 DLL 创建 bots,并且该自定义 DLL 依赖于 Apache log4net 库,那么我们建议使用:
    • 自定义 DLL 中的 log4net 版本2.0.11 或更高版本。
    • 即使 Bot Agent 更新是可选的,也要更新 Bot Agent(版本 21.210 或更高版本)。
  • 仅支持使用 Microsoft .NET Framework 构建的 DLL。
  • Run DLL package 兼容以下版本的 Microsoft .NET: 4.6、4.7 和 4.8。
  • 当您创建一个 bot 并在循环中使用本地会话时,请确保在 bot 中使用关闭会话 action。 如果您不使用关闭会话命令,本地会话将在循环的每次迭代中打开 AutomationAnywhere.ManagedDLLWrapper.exe。 因此,您将耗尽内存空间,bot 将会失败。
重要信息: 如果在父级 bot 和子级 bot 中使用不同版本的 DLL package,当前将不支持在 bots 之间共享会话的功能。 要在父级和子级 bots 之间共享会话,请确保在父级和子级 bots 中使用相同版本的软件包。
  1. 使用打开 action 可指定要使用的 .dll 文件的位置和会话名称。 对其他 actions 使用此相同会话名称。 引用的 .dll 自动添加为 bot 依赖项。
  2. 使用运行函数 action.dll运行函数,并将其输出值保存为变量。
  3. 运行所需函数后,关闭 .dll 引用。 务必关闭 .dll 引用,以释放操作系统的内存。

    Windows 和 Microsoft .NET Framework 的相应版本在运行 DLL 的设备上可用。

    要查看 bot 启动器日志,请导航到 C:\ProgramData\AutomationAnywhere\BotRunner\Logs\<current month>\Bot_Launcher-<today's date>.log.zip。 每个压缩的文件夹包含一个包含代码执行数据的文件,这对于调试很有用。

注: 如果 .dll 文件使用来自另一个 .dll 文件的 .NET 功能或类,则必须添加第二个 .dll 文件作为 bot 的手动依赖项。

Bot 依赖项

当您导入多个 DLL(其中一个主要 DLL 并从中引用其他 DLL)时,请确保在一个文件夹中包含所有 DLL。 此外,必须使用与主 DLL 中使用的名称不同的会话名称来调用引用的 DLL。 如果在主 DLL 和引用 DLL 中使用相同的会话名称,则 bot 执行将失败。

Actions 在 DLL 中 package

The DLL package 包括以下actions:

Action 描述
关闭

请参阅 关闭 action

打开

请参阅 打开 action

运行函数 请参阅 使用 Run 函数 action

DLL 函数中支持的数据类型

下表列出了可在 DLL 函数中用作输入或输出参数的变量和数据类型。
注: 运行函数 action 不支持参数到函数将输出分配到变量字段中的任何用户定义的数据类型。
变量类型作为输入或输出参数 .NET 中受支持的数据类型
字符串
  • Char
  • 字节
  • 字符串
  • 字符串
  • SByte
数字
  • UInt16
  • Int16
  • UInt32
  • Int32
  • UInt64
  • Int64
  • Int
  • 单点
  • 小数
  • Float
  • 双划线
布尔值
  • 布尔值
  • 布尔
日期时间
  • 日期时间
列表
  • UInt16[]
  • [Int16[]]
  • Int32[]
  • Int64[]
  • Int[]
  • Char[]
  • Single[]
  • Decimal[]
  • Float[]
  • Double[]
  • Boolean[]
  • bool[]
  • Byte[]
  • String[]
  • Datetime[]
  • 列表<UInt16>
  • 列表<Int16>
  • 列表<Int32>
  • 列表<Int64>
  • 列表<Int>
  • 列表<Char>
  • 列表<Single>
  • 列表<Decimal>
  • 列表<Float>
  • 列表<Double>
  • 列表<Boolean>
  • 列表<bool>
  • 列表<Byte>
  • 列表<String>
  • 列表<Datetime>
  • 列表<SByte>
  • 列表<UInt32>
  • 列表<UInt64>
注: C# IList 数据类型不受支持,并且无法与 Automation 360 List 数据类型一起使用。
  • UInt16[,]
  • Int16[,]
  • Int32[,]
  • Int64[,]
  • Int[,]
  • Char[,]
  • Single[,]
  • Decimal[,]
  • Float[,]
  • Double[,]
  • Boolean[,]
  • bool[,]
  • Byte[,]
  • String[,]
  • Datetime[,]
  • Byte[,]
  • UInt32[,]
  • UInt64[,]
注: 表格 类型变量相当于 .NET 中的二维数组类型变量。
字典
  • 字典<String,UInt16>
  • 字典<String,Int16>
  • 字典<String,Int32>
  • 字典<String,Int64>
  • 字典<String,Int>
  • 字典<String,Char>
  • 字典<String,Single>
  • 字典<String,Decimal>
  • 字典<String,Float>
  • 字典<String,Double>
  • 字典<String,Boolean>
  • 字典<String,bool>
  • 字典<String,Byte>
  • 字典<String,String>
  • 字典<String,Datetime>
  • 字典<Int,String>
  • 字典<Decimal,String>
  • 字典<Boolean,String>
  • 字典<String,SByte>
  • 字典<String,UInt32>
  • 字典<String,UInt64>
注: 在创建 .Net DLL 函数时,使用 IDictionary 数据类型代替 Dictionary 数据类型。