为进行迁移而分析 Bot Scanner 报告
- Updated: 2022/12/27
您可以分析 Bot Scanner 生成的报告，从而获得有关可迁移的 bots（Task Bots 和 MetaBots）以及流程的信息。 使用 Bot Scanner 决定立即开始迁移，还是继续等待，直到更多命令受到支持。
Bot Scanner 报告提供以下信息：
-
Bots: 在 Bot Scanner 报告中，bot 是一个在其他 bots 中使用的单独 Task Bot (.atmx)或 MetaBot (.mbot)。
机器人选项卡提供有关 bots 的详细信息，包括可迁移的、需要操作或审核的，以及无法迁移的机器人。
- 流程： 在 Bot Scanner 报告中，流程是一个 bot，不用于任何其他 bots，并且可以包含一个或多个子级 bots。
流程选项卡提供有关流程的详细信息，包括可迁移的、需要操作或审核的，以及无法迁移的流程。
- 分析的 bots 和流程数量
- 以看板的形式提供 bots 的迁移状态和流程的高级概述
- 可以和无法迁移到 Automation 360 的 bots 和流程数量
- bots 中使用的命令及其使用频率
- 当前 bots 和流程无法迁移的原因以及此类事件的频率
- 由于命令行为的变化，用户在完成迁移后需要执行的操作和审查
- 无法迁移的 Bots 和流程及其相应的错误消息
- 与流程相关的 bots 中的行数，以及每个 bots 的总行数
- 需要审核或操作的单个 bots 和流程的行号
大多数 Enterprise 10 或 Enterprise 11 功能按原样提供；但是，为了支持网页（无客户端）操作，将以不同发生实现某些功能。 对于此类功能，您必须更改 bots 的写入方式。
Bot Scanner 用于扫描使用 bots 和 Task Bots 版本的 MetaBots 创建的 Enterprise 10（Enterprise 11 和 Enterprise Client）。 文件总数包括跳过的和未扫描的文件数。
这些报告位于您在 Automation Anywhere Bot Scanner 对话框的选择目标文件夹字段中指定的输出位置。 Bot Scanner 会生成摘要报告 (summary.html) 和扫描的每个 bot 的单独 XML 报告。 它为 MetaBot 中可用的每个逻辑创建单独的报告。
它将创建 raw-data 文件夹，其中包含所扫描的每个 bot 的报告（XML 格式）。 它帮助我们的工程师进一步分析迁移流程，并在必要时采取纠正措施。 扫描的 bots 的摘要报告或单个报告中不包含任何个人身份信息 (PII)。
如果您选择与我们共享报告来帮助改进产品，请将文件压缩到 raw-data 文件夹中，并与您的客户成功经理 (CSM) 或合作伙伴支持经理 (PEM) 沟通协调。 系统不会自动与 Automation Anywhere 共享任何数据。
所有 bots 的摘要报告
- 您是否可以迁移到 Automation 360
- 已扫描的 bots 的总数
- bots 是唯一提供有关迁移到 Automation 360 的 bots 支持信息（以百分比表示）的报告。
- 仅报告提供有关支持迁移到 Automation 360 的流程的信息
- bots 和流程结合报告，提供有关支持迁移到 Automation 360 的 bots 和流程的信息。
例如，假设 Bot Scanner 已扫描 10 个 bots。 在这 10 个 bots 中，如果 8 个 bots 已做好迁移到 Automation 360 的准备，则可以迁移的 bots 百分比为 80%，现在无法迁移的 bots 百分比为 20%。
- 确定要对剩余的 5% 的 bots 执行的操作和审查，确保您可以成功迁移大多数的 bots，并确保完成迁移后可以在 Automation 360 中运行。
- 确定无需任何手动干预即可迁移到 bots 的 Automation 360。
- 确定当前无法迁移 2% 的 bots 的原因以及稍后可以迁移它们的预计时间。 原因可能是 Automation 360 中尚不支持这些命令和变量。
- 单击流程选项卡。
- 单击您要查看的消息选项卡。
- 在主任务参考列中，单击展开图标（
）以查看流程。 - 单击流程名称以查看消息。
- 确定要对剩余的 15 个流程执行的操作和审查，确保您可以成功迁移大多数的流程，并确保完成迁移后可以在 Automation 360 中使用。
- 确定无需任何手动干预即可迁移到 Automation 360 的流程。
- 确定当前无法迁移该 1 个流程的原因以及稍后可以迁移的预计时间。
原因可能是 Automation 360 中尚不支持这些命令和变量。
下图是 Bot Scanner 中的报告的示例：
下表描述了 Bot Scanner 报告示例（如上图所述）中的各种字段：
| 字段/选项 | 描述 |
|---|---|
| 1 | 提供您的 bots 迁移准备情况的摘要和状态。 根据以下内容查看迁移状态：
|
| 2 | 为 bots 提供以下信息的摘要：
|
| 3 | 提供额外的资源以简化迁移流程。 |
| 4 | 提供流程的以下信息摘要：
|
| 5 |
|
| 6 |
或 ： 请转到此视图，获取需要在迁移到 Automation 360 后执行操作的 bots 或流程的列表。
|
| 7 |
单击消息代码以查看有关 Automation 360 命令行为相较 Enterprise 11 或 Enterprise 10 行为的变化信息。 |
| 8 | 或 ： 请转到此视图，获取无需任何手动干预即可迁移到 Automation 360 的 bots 或流程列表。 |
| 9 | 或 ： 请转到此视图，获取当前无法迁移到 Automation 360 的 bots 或流程的列表。 |
| 10 | ： 转到此视图以查看可以迁移的命令列表以及在所有已扫描的 bots 中使用这些命令的次数。 |
| 11 |
单击消息代码以查看在 Automation 360 中成功运行已完成迁移的流程而必须执行的手动步骤。 您还可以查看 bot 包含的命令以及命令在 bot 中的使用频率或使用次数。 |
| 12 | 提供 bot 的位置。 |
| 13 | 提供 bot 或流程的状态。 |
| 14 |
|
| 15 | 对于流程，此字段显示在迁移到 Automation 360 后需要执行操作的流程中的 bots 的数量。 单击展开图标（），然后单击标记为需要操作的任务参考名称。 单击消息代码以查看有关 Automation 360 命令行为相较 Enterprise 11 或 Enterprise 10 行为的变化信息。 注： 此字段仅适用于流程。
|
| 16 | 对于流程，此字段显示在迁移到 Automation 360 后需要审核的流程中 bots 的数量。 单击展开图标（），然后单击标记为需要审核的任务参考名称。 单击消息代码以查看有关 Automation 360 命令行为相较 Enterprise 11 或 Enterprise 10 行为的变化信息。 注： 此字段仅适用于流程。
|
| 17 | 下载（以 CSV 文件格式）可以或无法迁移的 bots、进程或命令的列表，确保可以与其他人共享文件。 |
| 18 |
|
报告在下一版本的 Bot Scanner 可用之前有效。 当下一版本的 Bot Scanner 可用时，将显示报告到期消息。 您必须下载最新版本的 Bot Scanner，然后重新扫描 bots。
完成迁移后需要执行的验证和操作
bots 中的一些命令在 Bot Scanner 报告中标记为“需要执行审查”。 对于这些项目，您需要在完成迁移后执行特定验证或更新 bots。
以下 Bot Scanner 消息需要执行验证或执行一些操作：
-
子机器人路径是完全可变的，并在运行时进行解析。 如果在变量中指定的路径无效，机器人在执行命令时将失败。 请查看迁移机器人。
确保子 bot 位于在可变路径中指定的位置。 如果父 bot 中的路径不正确，请更新路径以指向正确的子 bot。
-
系统变量“错误描述”返回的值可能是不同的 w.r.t. 旧版本。 请查看迁移的机器人。
对于相同的错误，Automation 360 中某些错误消息的描述可能不同于 Enterprise 11 或 Enterprise 10。 如果 Enterprise 11 或 Enterprise 10 bot 配置为根据错误消息的描述做出决策，则您可能需要根据错误消息的新描述更新已完成迁移的 bot。
-
迁移 "Database - Connect" 命令完成，但“Windows 身份验证”需要额外的配置。 请参阅数据库包文档，获取更多详细信息。
完成指定的步骤，使用 Windows 身份验证连接到 Microsoft SQL Server。 请参阅 通过 Windows 身份验证连接到 Microsoft SQL Server。
-
迁移使用变量条件的“IF”命令已完成。 但是，无法确定用户变量的日期格式，因此迁移时请使用默认日期格式 mm/dd/yyyy HH:mm:ss。 请进行审查，并在必要时更改格式。
将已迁移 bot 中的日期格式更新为 Enterprise 11 中用于该 bot 的相同格式。
-
无法确定作为位置使用的变量是索引名称还是列名称。 索引位置从 0 开始（而不是 1），因此根据需要采取必要操作。
如果在 Enterprise 11 或 Enterprise 10 bot 中使用 FileData Column[$variable$] 或 Excel Column[$variable$] 系统变量，则假设您已在 $variable$ 中使用列名称。 在这种情况下，已完成迁移的 bot 包含 FileData Column{$variable$} 表达式。 如果 Enterprise 11 或 Enterprise 10 bot 中的 $variable$ 包含列号，则必须将已完成迁移的 bot 中的表达式更新为 FileDataColumn[$var.String:toNumber()$]。
-
使用凭据变量作为 MetaBot 逻辑输入的“运行逻辑”命令
Bots使用将 Credential Vault属性从Task Bot传递到MetaBot逻辑的运行逻辑命令的Automation 360可以迁移到。 凭据名称和属性名称将显示在已迁移 bot 的相应行的字段中。
如果您使用了已还原的 Enterprise 11 数据库进行迁移，则将在 locker 中为 Automation 360 Enterprise 11 中使用的凭据变量创建等效 bot。
要成功运行已迁移的 bots，请选择下列选项之一：-
选项 1： 传递凭据类型变量。
- 在子 bots 中创建凭据类型变量作为输入变量。
- 在父的action的Task Bot package 运行 bot中，更新输入值字段，将Credential Vault属性用于为子bot创建的凭据类型变量（对应于MetaBot逻辑）。
-
选项 2： 传递凭据值作为全局值。
- 在Automation 360中为运行逻辑命令中 Enterprise 11 使用的凭据创建全局值。
- 在父的action的Task Bot package 运行 bot中，更新输入值字段，将全局值用于为子bot创建的凭据类型变量（对应于MetaBot逻辑）。
如果您在安装 Enterprise 11 时未使用已还原的 Automation 360 数据库，那么在执行上述步骤之前，必须首先为 Enterprise 11 bot 中使用的凭据变量创建所需的存储柜。注： 借助 Automation 360，您可以仅将 Credential Vault 属性分配给凭据类型变量，从而增强安全性。 这可限制对 Credential Vault 属性进行任何不安全的处理，例如将这些属性分配给非凭据类型变量。 -
选项 1： 传递凭据类型变量。
单个 bot 报告
每个 bot 报告均提供有关其依赖项、变量和所用命令的信息。
单个 bot 报告类似于以下代码：
<analysis version="1.3.0">
<stat>
<dependencies ucount="0" count="0"/>
<errors ucount="6" count="12">
<error count="1">System variable $AAApplicationPathlt;/error>
<error count="1">Command [If FolderNotExist]
is not supported</error>
<error count="3">System variable $CurrentDirectorylt;/error>
<error count="3">System variable $Extensionlt;/error>
</errors>
</stat>
<commands>
<command target-action="assign" name="VariableOperation" line="1"
grp="VariableOperation" api="VarOpe">
<msg type="error" review="true" category="variable">System
variable $AAApplicationPathlt;/msg>
<msg type="info" review="false" category="default">Command
parameter [Option] of type [String] is not required.</msg>
</command>
<command target-action="createFolder" name="createFolder" line="3"
grp="FilesFolders" api="CreateFolder"/>
<command target-action="copyFiles" name="CopyFiles" line="5"
grp="FilesFolders" api="CreateFolder"/>
<command target-action="connect" name="Connect" line="3"
grp="Database" api="Connect"/>
<command target-action="OpenCSVTXT" name="ReadFrom" line="9"
grp="CsvText" api="Csv"
<msg tpye="info" review="false" category="command">Line
in 11.x client, there is no separate option given for CSV
and TEXT in Automation 360</msg>
<msg type="error" review="true" category="variable">System
variable $CurrentDirectorylt;/msg>
<msg type="error" review="true" category="variable">System
variable $Extensionlt;/msg>
<msg type="error" review="true" category="variable">System
variable $FileNamelt;/msg>
</command>
</commands>
<variables>
<variable name="$CSV-TXT-Default-DATAquot;
type="TABLE" value-type=""/>
</varaibles>
</analysis>
| 节点 | 属性 | 描述 |
|---|---|---|
| 统计数据 | -- | 提供有关依赖项、错误和警告数量的信息。 |
| -- | 依赖项 | 指定 bot 的依赖项数量。 ucount 表示唯一依赖项的数量，而 count 表示依赖项总数。 |
| -- | 错误 | 指定 bot 的错误数量。 ucount 表示唯一错误的数量，而 count 表示错误总数。 |
| 命令 | -- | 提供 bot 中使用的各种命令和操作的相关信息。 |
| -- | 命令目标操作 | 指定为命令执行的操作。 |
| -- | name | 指定命令的名称。 |
| -- | 行 | 指定命令在 bot 中可用的行号。 |
| -- | 组 | 指定命令所属的命令组。 |
| -- | API | 指定命令使用的 API 名称。 |
| -- | 消息类型 | 提供有关消息类型的信息。 error 类型表示无法将该命令迁移到 Automation 360，info 类型表示可以迁移该命令，但在迁移期间，它的一些属性会更改。 |
| -- | 审查 | 提供是否需要审查命令的相关信息。 对于 |
| -- | 类别 | 提供显示消息的命令或变量的相关信息。 |
| 变量 | 提供 bot 使用的系统变量的相关信息。 | |
| -- | 变量名称 | 指定变量的名称。 |
| -- | type | 指定变量的类型。 |
| -- | 值类型 | 指定为该变量赋值的值类型。 |
观看以下视频，了解如何分析扫描报告