阅读和查看 Automation Anywhere 文档

Automation 360

关闭内容

内容

打开内容

为进行迁移而分析 Bot Scanner 报告

  • 已更新:2022/03/29
    • Automation 360 v.x
    • 迁移
    • RPA Workspace

为进行迁移而分析 Bot Scanner 报告

您可以分析 Bot Scanner 生成的报告,从而获得可迁移的 botsTaskBotsMetaBots)的相关信息。使用 Bot Scanner 决定立即开始迁移,还是继续等待,直到更多命令受到支持。

Bot Scanner 提供了 bots 的以下相关重要信息:
  • 已分析的 bots 数量
  • 可以和无法迁移到 Automation 360bots 数量及百分比
  • bots 中使用的命令和变量及其使用频率
  • 当前无法迁移 bots 的原因以及此类事件的频率
  • 由于命令行为的变化,用户在完成迁移后需要执行的操作和审查
重要: 为了实现与 Enterprise 10Enterprise 11 版本的 100% 功能等效性,Automation 360 经常更新。支持迁移到 Automation 360bots、命令和变量的百分比将增加,直到下一个版本达到 100%。也就是说,对于您在 Enterprise 10Enterprise 11 中执行的每项功能,Automation 360 中都有等效功能。

大多数 Enterprise 10Enterprise 11 功能按原样提供;但是,为了支持网页(无客户端)操作,将以不同发生实现某些功能。对于此类功能,您必须更改 bots 的写入方式。

Bot Scanner 用于扫描使用 Enterprise 10Enterprise 11 版本的 Enterprise Client 创建的 botsTaskBotsMetaBots)。文件总数包括跳过的和未扫描的文件数。

这些报告位于您在 Automation Anywhere Bot Scanner 对话框的选择目标文件夹字段中指定的输出位置。Bot Scanner 会为其扫描的每个 bot 生成摘要报告和单独的报告。它为 MetaBot 中可用的每个逻辑创建单独的报告。

它将创建 raw-data 文件夹,其中包含所扫描的每个 bot 的报告(XML 格式)。它帮助我们的工程师进一步分析迁移流程,并在必要时采取纠正措施。扫描的 bots 的摘要报告或单个报告中不包含任何个人身份信息 (PII)。

如果您选择与我们共享报告来帮助改进产品,请将文件压缩到 raw-data 文件夹中,并与您的客户成功经理 (CSM) 或合作伙伴支持经理 (PEM) 沟通协调。系统不会自动与 Automation Anywhere 共享任何数据。

系统将在包含各种报告的 raw-data 文件夹中创建四个文件夹:
  • Migratable_Bots:包含可以迁移到 Automation 360bots 的报告。
  • Non_Migratable_Bots:包含无法迁移到 Automation 360bots 的报告。
  • Failed_to_Analyze:包含 Bot Scanner 分析失败的 bots 的报告。
  • MetaBots:包含可以和无法迁移到 Automation 360MetaBots 的报告以及 Bot Scanner 分析失败的机器人的报告。

所有 bots 的摘要报告

摘要报告提供了您是否可以迁移到 Automation 360、已扫描 bots 的总数,以及支持迁移到 Automation 360bots(以百分比表示)的相关信息。

例如,假设 Bot Scanner 已扫描 10 个 bots。在这 10 个 bots 中,如果 8 个 bots 已做好迁移到 Automation 360 的准备,则可以迁移的 bots 百分比为 80%,现在无法迁移的 bots 百分比为 20%。

查看 Bot Scanner 报告
假设以下场景:您一共扫描了 1618 个 bots,其中的 98%(1614 个bots)可以迁移到 Automation 360。但 5% 的 bots 需要在完成迁移后执行操作,而 2%(4 个 bots)由于某些原因目前无法迁移。在上述场景中,通过使用 Bot Scanner 报告,您可以执行以下操作:
  • 确定要对剩余的 5% 的 bots 执行的操作和审查,确保您可以成功迁移大多数的 bots,并确保完成迁移后可以在 Automation 360 中运行它们。
  • 确定无需任何手动干预即可迁移到 Automation 360bots
  • 确定当前无法迁移 2% 的 bots 的原因以及稍后可以迁移它们的预计时间。原因可能是 Automation 360 中尚不支持这些命令和变量。

下图是 Bot Scanner 中的报告的示例:

Bot Scanner 报告示例

下表描述了 Bot Scanner 报告示例(如上图所述)中的各种字段:

字段/选项 描述
Bot Scanner 报告选项 1 可以迁移的 Bot > 需要执行操作 > Bot:请转到此视图,获取需要在迁移到 Automation 360 后执行操作的 bots (5%) 的列表。
Bot Scanner 报告选项 2
  • Bot 名称:要查看特定 bot 所需执行的操作的消息,请单击 bot 名称。此消息提供在 Automation 360 中成功运行已完成迁移的 bot 而必须执行的手动步骤。
  • 您还可以查看 bot 包含的命令以及命令在 bot 中的使用频率或使用次数。
注: 每条消息都包含原因以及完成迁移后您需要执行的操作。如需获取此类消息的列表,请参阅 需要采取操作的消息。使用消息代码(例如 A101)可快速查看特定消息。
Bot Scanner 报告选项 3
  • 可以迁移的 Bot > 需要执行审查 > Bot:请转到此视图,获取可以迁移到 Automation 360 并应在完成迁移后执行审查的 bots 列表。
  • 要查看特定 bot 所需执行的审查的消息,请单击 bot 名称。此消息提供有关 Automation 360 命令行为相较 Enterprise 11Enterprise 10 行为的变化信息。
注: 每个消息都包含完成迁移后您必须审查的信息。如需获取此类消息的列表,请参阅 查看所需消息。使用消息代码(例如 R102)可快速查看特定消息。
Bot Scanner 报告选项 4 可以迁移的 Bot > 无需审查 > Bot:请转到此视图,获取无需任何手动干预即可迁移到 Automation 360bots 列表。单击此列表中的任意 bot 名称,离线查看 XML 报告。
Bot Scanner 报告选项 5
  • 现在无法迁移的 Bot > Bot:请转到此视图,获取当前无法迁移到 Automation 360bots 列表(此场景中为 2% 的 bots)。
  • 要查看特定 bot 的错误消息,请单击 bot 名称。此消息提供正在阻止迁移特定 bot 的命令的详细信息,以及命令在 bot 中的行号。
注: 每条消息都包含无法迁移特定 bot 的原因。如需获取此类消息的列表,请参阅 错误消息。使用消息代码(例如 E101)可快速查看特定消息。
重要: 如果无法迁移任何子 bots,则无法迁移其父 bot。同样,如果无法迁移 MetaBot 中的任何可用逻辑,则无法迁移 MetaBot
Bot Scanner 报告选项 6
  • 可以迁移的 Bot > 命令:请转到此视图,获取可以迁移的命令列表以及在所有已扫描的 bots 中使用这些命令的次数,并查看为每个类别(“需要执行操作”、“需要执行审查”和“无需审查”)提供的这些详细信息。
  • 无法迁移的 Bot > 命令:请转到此视图,获取无法迁移到 Automation 360 的命令和系统变量的列表。

    您还可以查看以下信息:由于子 bots 中使用的命令或变量不受支持而受影响的父 bots 数量、命令或系统变量在所有已扫描的 bots 中的使用频率,以及即将发布的版本(提供可随之进行迁移的相应命令或变量)。

Bot Scanner 报告选项 7 下载(以 CSV 文件格式)可以或无法迁移的 bots 或命令的列表,确保您可以离线查看文件或与其他人共享文件。

报告在下一版本的 Bot Scanner 可用之前有效。当下一版本的 Bot Scanner 可用时,将显示报告到期消息。您必须下载最新版本的 Bot Scanner,然后重新扫描 bots

完成迁移后需要执行的验证和操作

bots 中的一些命令在 Bot Scanner 报告中标记为“需要执行审查”。对于这些项目,您需要在完成迁移后执行特定验证或更新 bots

以下 Bot Scanner 消息需要执行验证或执行一些操作:

  • 子机器人路径是完全可变的,并在运行时进行解析。如果在变量中指定的路径无效,bot 在执行命令时将失败。请审查迁移 bot。

    确保子 bot 位于在可变路径中指定的位置。如果父 bot 中的路径不正确,请更新路径以指向正确的子 bot

  • 系统变量“错误描述”返回的值可能是不同的 w.r.t. 旧版本。请审查已完成迁移的 bot。

    对于相同的错误,Automation 360 中某些错误消息的描述可能不同于 Enterprise 11Enterprise 10。如果 Enterprise 11Enterprise 10 bot 配置为根据错误消息的描述做出决策,则您可能需要根据错误消息的新描述更新已完成迁移的 bot

  • 迁移“数据库 - 连接”命令完成,但“Windows 身份验证”需要额外的配置。请参阅数据库包文档,获取更多详细信息。

    完成指定的步骤,使用 Windows 身份验证连接到 Microsoft SQL Server。请参阅 通过 Windows 身份验证连接到 Microsoft SQL Server

  • 迁移使用变量条件的“IF”命令已完成。但是,无法确定用户变量的日期格式,因此迁移时请使用默认日期格式 mm/dd/yyyy HH:mm:ss。请进行审查,并在必要时更改格式。

    将已迁移 bot 中的日期格式更新为 Enterprise 11 中用于该 bot 的相同格式。

  • 无法确定作为位置使用的变量是索引名称还是列名称。索引位置从 0 开始(而不是 1),因此根据需要采取必要操作。

    如果在 Enterprise 11Enterprise 10 bot 中使用 FileData Column[$variable$] 或 Excel Column[$variable$] 系统变量,则假设您已在 $variable$ 中使用列名称。在这种情况下,已完成迁移的 bot 包含 FileData Column{$variable$} 表达式。如果 Enterprise 11Enterprise 10 bot 中的 $variable$ 包含列号,则必须将已完成迁移的 bot 中的表达式更新为 FileDataColumn[$var.String:toNumber()$]。

  • 使用凭据变量作为 MetaBot 逻辑输入的“运行逻辑”命令

    使用将 Credential Vault 属性从 TaskBot 传递到 MetaBot 逻辑的运行逻辑命令的 Bots 可以迁移到 Automation 360。凭据名称和属性名称将显示在已迁移 bot 的相应行的字段中。

    如果您使用了已还原的 Enterprise 11 数据库进行迁移,则将在 Automation 360 中为 Enterprise 11 bot 中使用的凭据变量创建等效 locker

    要成功运行已迁移的 bots,请选择下列选项之一:
    • 选项 1:传递凭据类型变量。
      1. 在子 bots 中创建凭据类型变量作为输入变量。
      2. 在父 botTask Bot package运行 action 中,更新输入值字段,将 Credential Vault 属性用于为子 bot 创建的凭据类型变量(对应于 MetaBot 逻辑)。
    • 选项 2:传递凭据值作为全局值。
      1. Automation 360 中为 Enterprise 11运行逻辑命令中使用的凭据创建全局值。
      2. 在父 botTask Bot package运行 action 中,更新输入值字段,将全局值用于为子 bot 创建的凭据类型变量(对应于 MetaBot 逻辑)。
    如果您在安装 Automation 360 时未使用已还原的 Enterprise 11 数据库,那么在执行上述步骤之前,必须首先为 Enterprise 11 bot 中使用的凭据变量创建所需的存储柜。
    注: 借助 Automation 360,您可以仅将 Credential Vault 属性分配给凭据类型变量,从而增强安全性。这可限制对 Credential Vault 属性进行任何不安全的处理,例如将这些属性分配给非凭据类型变量。

单个 bot 报告

每个 bot 报告均提供有关其依赖项、变量和所用命令的信息。

单个 bot 报告类似于以下代码:


            <analysis version="1.3.0">
                <stat>
                    <dependencies ucount="0" count="0"/>
                    <errors ucount="6" count="12">
                        <error count="1">System variable $AAApplicationPath$</error>
                        <error count="1">Command [If FolderNotExist] 
                        is not supported</error>
                        <error count="3">System variable $CurrentDirectory$</error>
                        <error count="3">System variable $Extension$</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 $AAApplicationPath$</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 $CurrentDirectory$</msg>
                            <msg type="error" review="true" category="variable">System 
                            variable $Extension$</msg>
                            <msg type="error" review="true" category="variable">System 
                            variable $FileName$</msg>
                        </command>
                    </commands>
                    <variables>
                        <variable name="$CSV-TXT-Default-DATA$" 
                        type="TABLE" value-type=""/>
                    </varaibles>
                </analysis>
            
下表描述了上图所显的 XML 报告中可用的各种属性:
节点 属性 描述
统计数据 -- 提供有关依赖项、错误和警告数量的信息。
-- 依赖项 指定 bot 的依赖项数量。ucount 表示唯一依赖项的数量,而 count 表示依赖项总数。
-- 错误 指定 bot 的错误数量。ucount 表示唯一错误的数量,而 count 表示错误总数。
命令 -- 提供 bot 中使用的各种命令和操作的相关信息。
-- 命令目标操作 指定为命令执行的操作。
-- 名称 指定命令的名称。
-- 指定命令在 bot 中可用的行号。
--