【前沿技术RPA】 一文了解UiPath 通过Invoke Method 和 Invoke Code增强自动化功能

作者简介：博主是一位.Net开发者，同时也是RPA和低代码平台的践行者。
个人主页：会敲键盘的肘子
系列专栏：UiPath
专栏简介：UiPath在传统的RPA（Robotic process automation）的基础上，增加了See（AI通过计算机视觉阅读用户的计算机屏幕）和Think（通过机器学习来发现平台能够为用户构建什么自动化流程）从而不断帮助用户自动化构建流程，而不仅仅是用户自主发现，自主构建。并且在构建的过程当中，做到了Low-code甚至是No-code的程度，让每一位员工都可以自主使用。
座右铭：总有一天你所坚持的会反过来拥抱你。

---

写在前面：

本文专门针对RPA开发人员。Invoke Method和 Invoke Code活动通过使用VB.Net和C#代码帮助我们增强自动化项目的功能。

---

本文关键字：RPA、UiPath、Low-code、No-code、Invoke Method、Invoke Code、.Net

1️⃣ 背景

♈ 什么是RPA

RPA（Robotic process automation） 代表机器人过程自动化。

它是一种软件程序，可在与计算机应用程序交互时模仿人类行为并实现重复的、基于规则的流程的自动化。

♉ 什么是UiPath

UiPath 是一种机器人流程自动化工具，用于自动化枯燥和重复的任务。它由罗马尼亚企业家 Daniel Dines 和 Marius Trica 于 2005 年创立。它还消除了自动化无聊任务的人工干预，并为所有活动提供了拖放功能，它是最简单的 RPA 工具。

♊ 为什么使用UiPath

UiPath在传统的RPA的基础上，增加了See（AI通过计算机视觉阅读用户的计算机屏幕）和Think（通过机器学习来发现平台能够为用户构建什么自动化流程）从而不断帮助用户自动化构建流程，而不仅仅是用户自主发现，自主构建。并且在构建的过程当中，做到了Low-code甚至是No-code的程度，让每一位员工都可以自主使用。

♋ 环境

• UiPath Studio Community 2022.4.3

• Windows 10

• .Net

♌ 本文收获

• 确定应使用Invoke Method活动的情况。
• 区分静态方法和实例方法。
• 使用Invoke Method活动。
• 确定应使用Invoke Code活动的情况。
• 使用Invoke Code活动。

2️⃣ Invoke Method

• 确定应使用Invoke Method活动的情况。
• 区分静态方法和实例方法。
• 使用Invoke Method活动。

♈ 确定应使用Invoke Method活动的情况

Invoke Method活动帮助我们调用标准内置活动之外的方法。它用于调用类中的特定方法。

该活动调用指定类型或对象的公共方法。它作用于目标类型或目标对象。

• 当我们在vb.net或c#中有一个类库/DLL并想调用该方法时。

• 当我们想要使用一个不生成输出的方法（例如，Reverse），因此不能在Assign活动中使用时。

• 当我们想要使用一个生成多条输出的方法时（例如，TryParse，它生成布尔值和Int32）。无法使用分配活动分配多个值。

♉ 方法类型

根据所用方法的类型，有两种配置Invoke Method活动的方法。方法可以是静态类型或实例类型。

让我们花点时间了解更多关于这两种类型的方法，以及我们需要如何基于它们配置UiPath Studio活动。

⭐ 静态类型

当类被定义为静态时，我们不需要定义对象。因此，可以直接调用静态方法。

如果是静态方法，则使用目标类型。

⭐ 实例类型

在实例方法中，需要定义从中派生方法或成员的对象。

如果是实例方法，则使用TargetObject。

要确定方法是静态方法还是实例方法，可以在MSDN网站上查看方法。下面，您可以找到静态方法、Round（Decimal）和Instance方法Sort（Comparison＜T＞）。

♊ 静态类型示例

⭐ 场景

我们构建一个组件，该组件将接收从网站收集的输入，然后将其解析为Int32。由于某些输入无法解析，我们使用Int32.TryParse方法。

⭐ 示例

我们从一个赋值活动开始，该活动实例化并将值添加到字符串数组中。

接下来，我们使用for-each循环解析每个值并记录结果。

最后，我们将结果相加。需要注意的是，并非数组中的所有值都可以转换为整数。我们知道，这也可能发生在生产环境中。

**如果无法转换数据，parse方法将抛出异常。**这就是为什么我们将改用try parse方法。try parse方法当前输入到For Each中Assign活动的值字段中。在Assign活动之后，我们将记录转换后的结果，然后记录解析后的结果。

循环中的最后一个活动是另一个赋值活动，它将总金额的值相加。

让我们在调试模式下运行工作流，看看会发生什么。

一切都按预期进行了。

让我们检查输出面板的结果。正确记录转换结果。

“不适用”值的转换标记为False，但所有分析结果均为0。

尽管金额被设置为try parse方法的参数，但assign活动不会将解析的值分配给不在其to字段中的变量。

这可以通过Invoke Method活动来解决。让我们将For Each容器中的赋值活动替换为调用活动。让我们给它起一个描述性的名字。

关于Invoke Method最重要的一点是，目标类型和目标对象参数是互斥的。

我们对静态方法使用目标类型，对实例方法使用目标对象。如果两者都填写了，我们将得到一个错误。

如果我们不确定所使用的方法的类型，一种快速的方法是查看MSDN页面以查找该方法。如果它包含静态，则它是一个静态方法，我们需要在调用方法活动中使用目标类型参数。如果没有，则它是一个实例活动，我们需要在调用方法活动中设置目标对象。

除了检查方法的类型之外，了解方法签名对于配置其参数非常有用。

由于Integer 32 try parse是一个静态方法，我们将使用目标类型选项，并将其设置为“Int32”。方法名为try-parse。

接下来，让我们编辑该方法的参数。

首先，我们需要为要解析的值添加一个in参数，该参数的类型为string，值为AmountText。

其次，我们将为int32类型的输出量添加一个out参数，值为AmountValue。

最后，我们将在Properties面板的result字段中添加布尔变量converted successfully。

让我们再次在调试中运行工作流，看看现在发生了什么。

让我们检查输出面板。已记录单个值和总金额。成功了！

注意，不适用值的解析结果仍然是0，这是默认值。转换的状态为false。

⭐ 回顾

我们使用赋值活动来实例化字符串数组并将其添加到字符串数组中。为了解析每个值，我们使用for each循环活动，并用日志消息活动记录每个转换。

我们在InvokeMethod活动中使用了try parse解析方法。请记住，**目标类型和目标对象参数是互斥的。**如果两者都填写了，我们将得到一个错误。一旦使用调用的方法解析了每个值，就会将其添加到总金额中。

• 我们以分配文本数组活动开始项目，以解析字符串中定义的Int32值

• 如果转换成功，我们使用日志消息进行打印

• 我们使用Log消息打印解析结果

• 我们使用Assign活动将当前值添加到总金额中。

• 由于解析不成功，我们将For Each容器中的第一个Assign活动替换为Invoke Method活动

• 我们为此工作流使用了目标类型，因为它是一个静态方法

• 我们编辑了此方法的参数：

  • 在字符串类型的参数中，Amount Text变量。

  • Out参数，类型为Int32，Amount Value变量。

  • 我们将布尔变量Converted Successfully添加到Result字段。

♋ 实例类型示例

⭐ 场景

使用Invoke Method活动调用实例方法来反转列表中元素的顺序。我们有一个产品列表，我们希望按照与开始时相反的顺序显示元素。我们将使用reverse的方法。

⭐ 示例

让我们先添加一个序列，并给它一个描述性的名称。

接下来，我们将创建产品变量列表。让我们打开变量面板，创建一个名为Products的变量，并将变量类型设置为字符串列表。我们现在需要做的是实例化列表。

让我们添加一个分配活动，并给它一个描述性的名称。

现在，我们可以在To字段中添加变量，并使用表达式：来自A B C的字符串的新列表来实例化它。

让我们看看调用方法之前列表的样子。我们将级别设置为Info，并使用字符串连接方法显示值。

我们将使用逗号作为分隔符并输入变量名。

我们将采用reverse的方法。

请注意，列表reverse方法的签名中不包含static。

此外，它不会产生输出，这意味着我们不能在赋值活动中使用它，因为它会引发验证错误。

让我们添加Invoke Method活动，重命名它，添加products变量作为目标对象，并输入Reverse作为方法名称。

接下来，我们将在调用Reverse方法后记录列表。我们还可以重命名日志消息活动，将日志级别设置为information，并将上一个日志消息活动中使用的表达式添加为消息。

我们可以看到在调用方法之前记录的消息中元素的顺序是A B C。

之后是C B A。

⭐ 回顾

• 我们将项目作为一个序列启动，并在变量面板variable中定义属性，

• 我们使用Assign活动填充列表。assign活动中的值将是New List（Of String）From｛“A”，“B”，“C”｝

• 我们使用Log消息打印元素列表

• 我们使用Invoke Method调用Reverse方法

• 我们使用Log消息打印反转列表

3️⃣ Invoke Code

• 确定应使用Invoke Code活动的情况。
• 使用Invoke Code活动。

♈ 确定应使用Invoke Code活动的情况

Invoke Code活动同步调用VB.NET或C#代码，可以选择向其传递输入参数列表。此活动还可以向调用者工作流返回参数。

• 当我们想要简化工作流程中的数据操作程序时。

• 当我们希望通过用一个Invoke Code活动替换多个活动来减少“分配”和“调用方法”活动的数量时。

• 当我们需要为流程中的某些步骤编写自定义代码时。

♉ 添加命名空间

在Invoke Code活动中使用VB.NET代码时，必须将程序集添加到Import面板中，以便它们在执行代码时发挥作用。在Studio中，“名称空间”面板用于添加/删除名称空间。

要向库中添加新的名称空间，请遵循以下方法：

• 打开“导入”面板。

• 在Enter或Select namespace字段中，开始键入您感兴趣的命名空间。请注意，在您键入时会提供建议，以防您不完全确定要查找的内- 容。

• （可选）单击下拉箭头以查看和浏览所有可用的名称空间。

• 选择所需的命名空间。命名空间将添加到“导入的命名空间”列表中。

♊ 示例

⭐ 场景

我们将在工作流中使用Invoke Code，以检查任何两个给定文件是否相同。为此，我们需要从下面的代码段开始计算文件。

Private Sub SHA1EncryptData()

Dim FilePath As String = "Report-DE763212-1.xlsx"
Dim Result As String = ""
Dim Encryptor As New System.Security.Cryptography.SHA256CryptoServiceProvider
 
' Create a fileStream For the file.
Dim fileStream As FileStream = File.OpenRead(FilePath)
' Be sure it's positioned to the beginning of the stream.
fileStream.Position = 0

' Compute the hash code for the fileStream
Dim bytesToHash() As Byte = Encryptor.ComputeHash(fileStream)
 
' Close the fileStream
fileStream.Close()

' Convert the hash bytes to user-friendly text
For Each item As Byte In bytesToHash
Result += item.ToString("x2")
Next

End Sub

⭐ 示例

我们将构建一个自动过程，通过比较两个文本文件的哈希代码来检查它们是否具有相同的内容。

从一个新项目开始，在这里我们将添加一个序列，给它一个描述性的名称，并添加一个注释来解释自动化将做什么。

让我们向工作流中添加两个选择文件活动。然后将第一个重命名为“选择第一个文件”。

在其中，我们将在Output字段中创建一个新变量，我们将其称为First File。此变量将存储选定的第一个文件的路径。

第二个活动将命名为“选择第二个文件”，并将第二文件的路径存储在名为“第二文件路径”的变量中。

让我们添加一个Invoke Code活动。它将帮助我们计算第一个文件的哈希代码，因此我们可以稍后将其与第二个文件的散列代码进行比较。让我们给它起一个反映这一点的名字。

现在我们只需要调用这段代码。

Private Sub SHA1EncryptData()

Dim FilePath As String = "Report-DE763212-1.xlsx"
Dim Result As String = ""
Dim Encryptor As New System.Security.Cryptography.SHA256CryptoServiceProvider
 
' Create a fileStream For the file.
Dim fileStream As FileStream = File.OpenRead(FilePath)
' Be sure it's positioned to the beginning of the stream.
fileStream.Position = 0

' Compute the hash code for the fileStream
Dim bytesToHash() As Byte = Encryptor.ComputeHash(fileStream)
 
' Close the fileStream
fileStream.Close()

' Convert the hash bytes to user-friendly text
For Each item As Byte In bytesToHash
Result += item.ToString("x2")
Next

End Sub

因此，我们将转到代码源。这是为我们的文件生成哈希代码的代码。我们将复制代码，返回Invoke Code活动，打开代码编辑器并粘贴它。

为了确保它能够工作，我们将删除前3行。

第一行是方法或过程的名称。调用代码活动不支持函数、过程或方法。

第二行是文件路径变量的声明。我们将用输入参数替换它，并将该参数映射到变量。

第三行是结果变量的声明。

我们也将用输出参数替换这个参数，并将值映射到变量。我们还将删除最后一行，因为它标志着方法或过程的结束。

让我们将输入和输出参数添加到调用代码活动中。首先，我们将添加名为string类型的“firstfilepath”的In参数，并将其映射到“firstfile-path”变量。

然后，具有Out方向和类型字符串的第二个参数Result将映射到First File Hash Code参数。

让我们添加一个日志消息活动来打印第一个文件哈希代码。这将使日志级别设置为info，消息“First File Hash signature”+First File哈希代码变量的值。

我们将重复该过程以生成第二个文件的哈希代码。我们将添加一个新的调用代码活动，

并简单地从第一个活动复制代码。

接下来，我们将创建输入和输出参数，并将它们映射到第二个文件的相应变量。

与之前一样，我们将添加一个日志消息活动来打印第二个文件的哈希签名。

现在，让我们检查比较的文件是否相同或不同。让我们将if活动添加到序列中，并将其重命名为if相同的哈希代码。

我们将设置以下条件：文件哈希代码等于第二个文件哈希代码。如果条件为真，我们需要一条日志消息来显示“文件相同”现在，让我们复制相同的日志消息，将其添加到Else部分并将其修改为：“文件的内容不同！”

让我们单击“运行”，看看会发生什么。

在第一次运行中，我们将比较测试文件1和测试文件2。我们已经知道文件的内容不同。正如我们在输出面板中看到的，工作流返回了正确的结果！

让我们尝试另一个文件对，更准确地说是文件1和3。在这种情况下，我们知道这些文件是相同的。

我们的工作流程再次返回了正确的结果！它确定这些文件是相同的。让我们快速查看一下测试文件。

测试文件1的内部写入了“测试文件1”，测试文件2的内部写入“测试文件2”，但测试文件3的内部写入有“测试文件3”。测试文件1和测试文件3生成的哈希签名是相同的，因为其中的内容是相同的。

而来自文件2的哈希签名不同，因为内容不同于其他文件。

我们的项目按预期进行。

⭐ 回顾

• 我们以一个序列开始项目

• 我们使用了2个“选择文件”活动

• 我们使用Invoke Code活动调用SHA256哈希代码

• 我们定义了第二个Invoke Code活动的参数

• 我们使用日志消息来捕获第一个测试文件的哈希签名

• 然后，我们使用第二个Invoke Code活动来计算第二个文件的哈希代码。

• 我们定义了第二个Invoke Code活动的参数

• 我们使用日志消息来捕获第二个测试文件的哈希签名

• 我们使用IF活动设置打印结果的条件。

• 我们使用了条件“FirstFileHashCode.Equals（SecondFileHashCode）”

• 如果哈希签名相同，则记录消息“文件相同”

• Else日志消息“文件不同”

4️⃣ 参考资料

Invoke Code

---

⭐写在结尾：

文章中出现的任何错误请大家批评指出，一定及时修改。

希望写在这里的小伙伴能给个三连支持！