阅读和查看 Automation Anywhere 文档

Automation Anywhere

关闭内容

内容

打开内容

用于将数据从 10.x Enterprise Control Room迁移到 11.x Enterprise Control Room的 API

  • 已更新:5/10/2019
    • 11.3.x
    • 探索
    • Enterprise
    • API 文档

用于将数据从 10.x Enterprise Control Room迁移到 11.x Enterprise Control Room的 API

作为具有“查看和管理迁移”角色权限的Enterprise Control Room管理员,可以使用迁移 API 将数据从 10.x Enterprise Control Room迁移到最新的Enterprise Control Room版本 11.x。

利用迁移 API,您可以:

  1. 将连接配置保存/更新到 10.x Enterprise Control Room数据库
  2. 将连接配置保存/更新到 2.x Bot Insight 数据库(如果可用)
  3. 指定用于基于角色、用户或机器人迁移数据的选项
  4. 根据为迁移指定的选项(即角色、用户或机器人)获取数据列表
  5. 查看迁移进度摘要
  6. 查看每次迁移成功/失败的实体数量的迁移统计信息
  7. 在迁移后从 10.x Enterprise Control Room获取新的和更新的机器人的列表
  8. 在迁移后从 10.x Enterprise Control Room的“我的文档”文件夹中批量迁移文件

或者,您可以使用“管理”>“迁移”模块中提供的迁移向导从 Enterprise Control Room用户界面迁移数据。请参考迁移概述以了解详细信息。

注: 本文中提供的示例仅供参考。

API 端点

使用以下端点可访问 API:

  1. 对于迁移过程,使用 <Enterprise Control Room URL>/v2/migration
  2. 要在迁移过程完成后,从源 10.x Enterprise Control Room我的文档文件夹中迁移文件,请使用 <Enterprise Control Room URL>/v1/migration

例如:

https://crdevenv.com:81/v2/migration

迁移过程 API

迁移 API 允许您使用之前提及的端点将 10.x Enterprise Control Room数据迁移到 11.x Enterprise Control Room

访问这些迁移 API 之前,必须首先使用身份验证 API 并将其作为令牌传递以使用特定迁移 API。

  1. 使用 POST 方法生成使用端点 http(s)://<hostname:port>/v1/authentication 的令牌。为此,请以服务器名称/主机名/IP端口号的形式提供Enterprise Control Room实例。

    例如,https://crdevenv.com:81/v1/authentication

  2. 在标头中提供以下请求有效负载

    “X-Authorization” :“Authorization token”

    “Content-Type” :“application/json”

  3. 在正文中提供以下请求有效负载:

    {

    "username":"<Username>",

    "password":"<Password>"

    }
    • 例如:

      {

      "usename":"Ellie.Brown",

      "password":"12345678"

      }

1.连接到源Enterprise Control Room数据库

此 API 允许您将连接配置保存和更新到源 10.x Enterprise Control Room数据库。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 在正文中提供凭证参数
  3. 使用 POST 方法通过端点 http(s)://<hostname:port>/v2/migration/connection 连接到 10.x Enterprise Control Room数据库
    • 例如,https://crdevenv.com:81/v2/migration/connection
  4. 在正文中提供以下请求参数:

    {

    "host":"string", "port":0, "databaseName":"string", "username":"string", "password":"string", "integratedSecurity":true, "encrypt":true, "privateKey":"string", "repoPath":"string"

    }
    • 例如:

      {

      "host":"PRODUCTLT",

      "port":1433,

      "databaseName":"CR104MIG",

      "username":"Ellie.Brown",

      "password":"12345678",

      "integratedSecurity":true,

      "encrypt":true,

      "privateKey":"ABC123",

      "repoPath":"D:\\Data\Automation Anywhere Server Files"

      }

  5. 单击发送

参数描述

Parameter 描述
host Enterprise Control Room数据库主机名
port Enterprise Control Room数据库端口号
databaseName Enterprise Control Room数据库名称
username 用于连接到数据库的用户名
password 用于连接到数据库的密码
integratedSecurity 指示在连接到源数据库时是否使用 Windows 身份验证的指示符。如果要使用 Windows 身份验证,则将此参数设置为 true。默认值为 false
encrypt 指示是否使用源数据库安全连接的指示符。如果要使用安全连接,则将此参数设置为 true。默认值为 false
privateKey 用于解密源数据库中的凭证值的私钥。在初始 Enterprise Control Room设置期间,可以配置此参数。
repoPath 用于存储 Enterprise Control Room 10.x 存储库的共享存储库路径

2.获取存储的连接详细信息

此 API 允许您获取可从中迁移数据的源 10.x Enterprise Control Room数据库的存储连接详细信息。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 在正文中提供凭证参数
  3. 使用 GET 方法通过端点 http(s)://<hostname:port>/v2/migration/connection 获取 10.x Enterprise Control Room数据库的连接配置
    • 例如,https://crdevenv.com:81/v2/migration/connection
  4. 单击发送
  5. 您可以在正文数据中查看结果:

    {

    "host":"productlt",

    "port":1433,

    "databaseName":"CR104MIG",

    "username":"",

    "password":"",

    "integratedSecurity":true,

    "encrypt":false,

    "privateKey":"",

    "repoPath":"D:\\DATA\AUTOMATION ANYWHERE SERVER FILES"

    }

参数描述

Parameter 描述
host 源数据库主机
port 源数据库端口
databaseName 源数据库名称
username 用于连接到源数据库的用户名
password 用于连接到源数据库的密码
integratedSecurity 指示在连接到源数据库时是否使用 Windows 身份验证的指示符,默认值为 false
encrypt 指示是否使用与源数据库的安全连接的指示符,默认值为 false
privateKey 用于解密源数据库中的凭证值的私钥
repoPath 用于存储 Enterprise Control Room 10.x 存储库的共享存储库路径

3.连接到 2.x Bot Insight 数据库(如果可用)

此 API 允许您连接到源 2.x Bot Insight 数据库(如果可用)以迁移分析数据。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 在正文中提供凭证参数。
  3. 使用 POST 方法通过端点 http(s)://<hostname:port>/v2/migration/connection /botinsight 连接到 Bot Insight 数据库
    • 例如,https://crdevenv.com:81/v2/migration/connection/botinsight
  4. 在正文中提供以下请求参数:

    {

    "host":"string",

    "port":0,

    "databaseName":"string",

    "username":"string",

    "password":"string",

    "integratedSecurity":true,

    "encrypt":true,

    "serverUrl":"string"

    }
    • 例如:

      {

      "host":"Productlt",

      "port":8091,

      "databaseName":"BotInsight",

      "username":"Ellie.Brown",

      "password":"12345678",

      "integratedSecurity":true,

      "encrypt":true,

      "serverUrl":"https://productlt.aae.com:82/analytics"

      }

  5. 单击发送
  6. 响应状态为 200 成功操作时,连接参数成功保存

参数描述

Parameter 描述
host Bot Insight 数据库主机名
port Bot Insight 数据库端口号
databaseName Bot Insight 数据库名称
username 用于连接到数据库的用户名
password 用于连接到数据库的密码
integratedSecurity 指示在连接到源数据库时是否使用 Windows 身份验证的指示符。如果要使用 Windows 身份验证,则将此参数设置为 true。默认值为 false
encrypt 指示是否使用源数据库安全连接的指示符。如果要使用安全连接,则将此参数设置为 true。默认值为 false
serverUrl Bot Insight Visualization ServerPort 所在的服务器 URL

4.获取存储的连接详细信息

此 API 允许您获取可从中迁移数据的源 2.x Bot Insight 数据库的存储连接详细信息。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 在正文中提供凭证参数
  3. 使用 GET 方法通过端点 http(s)://<hostname:port>/v2/migration/connection/botinsight 获取 10.x Enterprise Control Room数据库的连接配置
    • 例如,https://crdevenv.com:81/v2/migration/connection/botinsight
  4. 单击发送
  5. 响应状态为 200 迁移配置时,连接参数成功保存
  6. 您可以在正文数据中查看结果:

    {

    "host":"Productlt",

    "port":8091,

    "databaseName":"BotInsight",

    "username":"Ellie.Brown",

    "password":"12345678",

    "integratedSecurity":true,

    "encrypt":true,

    "serverUrl":"https://productlt.aae.com:82/analytics"

    }

参数描述

Parameter 描述
host Bot Insight 数据库主机名
port Bot Insight 数据库端口号
databaseName Bot Insight 数据库名称
username 用于连接到数据库的用户名
password 用于连接到数据库的密码
integratedSecurity 指示在连接到源数据库时是否使用 Windows 身份验证的指示符。如果要使用 Windows 身份验证,则将此参数设置为 true。默认值为 false
encrypt 指示是否使用源数据库安全连接的指示符。如果要使用安全连接,则将此参数设置为 true。默认值为 false
serverUrl Bot Insight Visualization ServerPort 所在的服务器 URL

5.源数据库中可供迁移的 TYPE 实体列表

此 API 通过 TYPE 参数返回源数据库中可供迁移的实体列表。使用“角色”、“用户”、“机器人”或“计划”选项中的任一选项,可以迁移与选定参数关联的所有数据。

注: 对于数据的选择性迁移(即根据指定的参数仅选择某些数据),请使用Enterprise Control Room中提供的迁移向导
  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过 http(s)://<hostname:port>/v2/migration/connection /entities 端点(后跟可包含以下任一选项的 TYPE 参数 - 角色用户机器人或计划)连接到 Enterprise Control Room数据库
    • 例如,https://crdevenv.com:81/v2/migration/connection/entities?Type=ROLE
  3. 单击“发送”
  4. 当响应状态为 200 时,返回数据
  5. 在正文中显示基于 TYPE 参数的实体列表。

    {

    "entities":

    [

    { "id":"0", "type":"ROLE", "sourceId":"1", "targetId":"0", "name":"Admin", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"2", "targetId":"0", "name":"Basic", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"3", "targetId":"0", "name":"IQBotValidator", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"4", "targetId":"0", "name":"AnalyticsExperts", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"5", "targetId":"0", "name":"AnalyticsConsumers", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"6", "targetId":"0", "name":"BotAgentUser", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"7", "targetId":"0", "name":"BotFarmAdmin", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"8", "targetId":"0", "name":"IQBotServices", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"9", "targetId":"0", "name":"Bot Creator 10x", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"10", "targetId":"0", "name":"Bot Runner 10x", "status":"SUCCESS", "reason":"" },

    { "id":"0", "type":"ROLE", "sourceId":"11", "targetId":"0", "name":"Bot Scheduler 10x", "status":"SUCCESS", "reason":"" }

    ]

    }

参数描述

Parameter 描述
id 迁移 ID
type 选定要迁移的实体类型 - 角色、用户或机器人
sourceId 源数据库中实体的 ID
targetId 目标数据库中迁移后的实体的 ID
name 源数据库中实体的名称
status 特定实体的迁移状态
reason 该特定实体迁移失败的原因

6.根据用户输入准备迁移数据

此 API 允许您根据为迁移指定的实体类型的子部分来迁移具有关联数据的实体。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 使用 POST 方法通过端点 http(s)://<hostname:port>/v2/migration/prepare 迁移数据
    • 例如,https://crdevenv.com:81/v2/migration/prepare
  3. 在正文中提供以下请求有效负载:

    {

    "selected":

    [

    { "type":"<enitity type>",

    "sourceId":"string" }

    ],

    "excludes":[ "<entity type>"

    ]

    }
    • 例如:

      { "selected":[ { "type":"ROLE", "sourceId":"12" } ], "excludes":[ "BOT" ] }

  4. 单击“发送”
  5. 当响应状态为 200 时,已成功列出数据以进行迁移
  6. 在正文中显示结果

    { "selected":

    [

    { "type":"ROLE", "sourceId":"12" } ],

    "excludes":[ "BOT" ]

    }

参数描述

Parameter 描述
type 选定要迁移的实体类型 - 角色、用户或机器人和计划
sourceId 源数据库中实体的 ID
excludes

从迁移中排除的实体名称。可用选项取决于所选的实体类型。

因此,当您选择角色用户时,您可以排除机器人和计划;当您选择机器人和计划时,您可以排除MetaBot和/或覆盖现有机器人

7.启动迁移

此 API 允许您启动迁移过程。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 POST 方法通过端点 http(s)://<hostname:port>/v2/migration/start/async 迁移数据
    • 例如,https://crdevenv.com:81/v2/migration/start/async

  3. 单击“发送”
  4. 当响应状态为 200 成功操作时,数据迁移成功启动
  5. 在正文数据中显示结果

    {

    "id":1,

    "name":"2018.07.17.16.13.48.ellie.brown",

    "createdBy":1,

    "migrationType":"ROLE_EXCLUDE_BOT_SCHEDULE"

    }

参数描述

Parameter 描述
id 迁移 ID
名称 启动迁移的用户的名称
createdBy 启动迁移的实体的 ID,即 Enterprise Control Room管理员
migrationType 选择的迁移类型 - 角色、用户或机器人和计划

8.按 ID 列出迁移对象

此 API 根据使用启动迁移 API 生成的 ID 列出迁移对象详细信息。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v2/migration/<id> 按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v2/migration/9

  3. 单击“发送”。
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    {

    "id":"9",

    "name":"2018.07.17.16.13.48.ellie.brown",

    "startTime":"2018-07-17T10:43:48.127Z",

    "endTime":"2018-07-17T10:43:49.833Z",

    "createdBy":"1",

    "migrationType":"ROLE_EXCLUDE_BOT_SCHEDULE",

    "entities":[]

    }

参数描述

Parameter 描述
id 迁移 ID
名称 启动迁移的用户的名称
startTime 启动迁移的时间
endTime 完成迁移的时间
createdBy 启动迁移的实体的 ID,即 Enterprise Control Room管理员
entities 迁移过程中迁移的实体列表
migrationType 选择的迁移类型 - 角色、用户或机器人和计划

9.迁移进度

此 API 允许您查看进行中的迁移过程。

  1. 在标头中提供“X-Authorization”和“Content Type”参数。
  2. 在正文中提供凭证参数
  3. 使用 GET 方法通过端点 http(s)://<hostname:port>/v2/migration/pogress 按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v2/migration/progress

  4. 单击“发送”。
  5. 当响应状态为 200 时,对象详细信息成功列出
  6. 在正文数据中显示详细信息:

    {

    "migration":

    { "id":"10", "name":"2018.07.17.16.55.59.ellie.brown", "startTime":"2018-07-17T11:25:59.800Z", "endTime":"2018-07-17T11:26:16.002Z", "createdBy":"1", "migrationType":"BOT_EXCLUDE_MetaBot", "entities":[] },

    "current":"SCHEDULE",

    "progress":

    {

    "BOT":{ "total":"10", "successful":"7", "failed":"0", "skipped":"3" },

    "SCHEDULE":{ "total":"8", "successful":"8", "failed":"0", "skipped":"0" }

    }

    }

参数描述

Parameter 描述
id 迁移 ID
名称 显示的迁移名称
startTime 迁移过程开始时的时间戳
endTime 迁移过程完成时的时间戳。迁移进行中时为空
createdBy 创建/启动迁移过程的用户的 ID
current 当前正在迁移的实体类型 -“ROLE”、“USER”、“CREDENTIAL”、“BOT”或“SCHEDULE”
progress

实体的进度 -

  • 总计 - 要迁移的特定类型的实体总数
  • 成功 - 已成功迁移的实体数量
  • 失败 - 迁移失败的实体数量
  • 跳过 - 迁移期间跳过的实体数

10.迁移统计信息 - 每次迁移中成功/失败的实体数量

此 API 允许您查看每次迁移中成功或失败的实体的数量。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v2/migration/statistics 按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v2/migration/statistics

  3. 单击“发送”。
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    {

    "items":[

    { "id":"1", "name":"2018.07.13.11.14.59.ellie.brown", "startTime":"2018-07-13T05:44:59.787Z", "endTime":"2018-07-13T06:56:25.537Z", "createdBy":"1", "duration":"4285s", "numSuccess":0, "numFailed":0, "numSkipped":0 },

    { "id":"2", "name":"2018.07.13.12.28.08.ellie.brown", "startTime":"2018-07-13T06:58:09.283Z", "endTime":"2018-07-13T06:58:12.910Z", "createdBy":"1", "duration":"3s", "numSuccess":1, "numFailed":1, "numSkipped":0 },

    { "id":"3", "name":"2018.07.13.12.40.34.ellie.brown", "startTime":"2018-07-13T07:10:34.470Z", "endTime":"2018-07-13T07:10:40.060Z", "createdBy":"1", "duration":"5s", "numSuccess":10, "numFailed":0, "numSkipped":0 },

    { "id":"4", "name":"2018.07.13.12.42.19.ellie.brown", "startTime":"2018-07-13T07:12:20.007Z", "endTime":"2018-07-13T07:12:23.107Z", "createdBy":"1", "duration":"3s", "numSuccess":0, "numFailed":0, "numSkipped":6 },

    { "id":"5", "name":"2018.07.13.13.39.53.ellie.brown", "startTime":"2018-07-13T08:09:53.113Z", "endTime":"2018-07-13T08:10:02.673Z", "createdBy":"1", "duration":"9s", "numSuccess":4, "numFailed":0, "numSkipped":0 }

    ]

    }

参数描述

Parameter 描述
id 迁移 ID
名称 显示的迁移名称
startTime 迁移过程开始时的时间戳
endTime 迁移过程完成时的时间戳。迁移进行中时为空
createdBy 创建对象的用户的 ID
duration 迁移持续时间(以秒或纳秒为单位)
numSuccess 成功迁移的项数
numFailed 无法迁移的项数
numSkipped 迁移期间跳过的项数

迁移后 API

在完成此过程后使用这些迁移 API

  1. 从 10.x Enterprise Control Room的“我的文档”文件夹导入文件
  2. 从 10.x Enterprise Control Room获取自上次迁移运行以来的新的或修改的机器人列表
    注: 访问这些 API 之前,必须首先使用身份验证 API 并将其作为令牌传递以使用特定迁移 API。
  3. 使用 POST 方法生成使用端点 http(s)://<hostname:port>/v1/authentication 的令牌。为此,请以服务器名称/主机名/IP端口号的形式提供Enterprise Control Room实例。

    例如,https://crdevenv.com:81/v1/authentication

  4. 在标头中提供以下请求有效负载

    “X-Authorization” :“Authorization token”

    “Content-Type” :“application/json”

  5. 在正文中提供以下请求有效负载:

    {

    "username":"<Username>",

    "password":"<Password>"

    }

  • 例如:

    {

    "usename":"Ellie.Brown",

    "password":"12345678"

    }

重要: 如果在使用任何或所有迁移后 API 时显示错误代码 404,请重新使用 API 从 10.x Enterprise Control Room获取根文件夹列表,即 http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories

A. 从“我的文档”文件夹导入文件

使用一组特定的 API 从 10.x Enterprise Control Room的“我的文档”文件夹迁移文件。这些 API 允许您导入大量文件,这些文件既可以作为依赖项在机器人中使用,也可以单独用于自动化。

1.从 10.x Enterprise Control Room获取根文件夹列表

此 API 允许您获取 10.x Enterprise Control Room存储库中可用的文件夹列表。这将帮助您了解源 Enterprise Control Room中可用的文件夹结构。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v1/migration/legacyrepository/rootDirectories(后跟 excludeMetaBot 参数)按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v1/migration/legacyrepository/rootDirectories?excludeMetaBot=true

  3. 单击“发送”
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    [

    { "name":"My Docs", "path":"Automation Anywhere\\My Docs" },

    { "name":"My Exes", "path":"Automation Anywhere\\My Exes" },

    { "name":"My Reports", "path":"Automation Anywhere\\My Reports" },

    { "name":"My Scripts", "path":"Automation Anywhere\\My Scripts" },

    { "name":"My Tasks", "path":"Automation Anywhere\\My Tasks" },

    { "name":"My Workflow", "path":"Automation Anywhere\\My Workflow" }

    ]

参数描述

Parameter 描述
名称 目录/文件夹的名称
path 目录/文件夹路径

2.从 10.x 控制室获取根文件夹的子文件夹列表

此 API 允许您获取 10.x Enterprise Control Room存储库中可用的给定根文件夹的子文件夹列表。这将帮助您了解源Enterprise Control Room的文件夹结构。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v1/migration/legacyrepository/childDirectories(后跟 path 参数)按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v1/migration/legacyrepository/childDirectories?path=Automation Anywhere\My Docs

  3. 单击“发送”。
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    {

    "folders":

    [

    { "name":"Log-Files", "path":"Automation Anywhere\\My Docs\\Log-Files" }

    ]

    }

参数描述

Parameter 描述
folders 子目录的列表
名称 目录/文件夹的名称
path 目录/文件夹路径

3.获取给定文件夹中的文件列表

此 API 允许您获取源 Enterprise Control Room存储库中的给定文件夹内可用的文件的列表。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v1/migration/legacyrepository/childFiles(后跟 pathexcludeMetaBot 参数)按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v1/migration/legacyrepository/childFiles?path=Automation Anywhere\My Docs\Log-Files&excludeMetaBot=false

  3. 单击“发送”
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    {

    "files":

    [

    { "id":"280", "name":"ActiveMQServer-2018-Jul-17-2.log.zip", "path":"Automation Anywhere\\My Docs\\Log-Files\\ActiveMQServer-2018-Jul-17-2.log.zip" },

    { "id":"281", "name":"IgniteServer-2018-Jul-17-4.log.zip", "path":"Automation Anywhere\\My Docs\\Log-Files\\IgniteServer-2018-Jul-17-4.log.zip" },

    { "id":"283", "name":"WebCR_Ignite-2018-Jul-17-4.log.zip", "path":"Automation Anywhere\\My Docs\\Log-Files\\WebCR_Ignite-2018-Jul-17-4.log.zip" },

    { "id":"284", "name":"WebCR_License-2018-Jul-17-4.log.zip", "path":"Automation Anywhere\\My Docs\\Log-Files\\WebCR_License-2018-Jul-17-4.log.zip" },

    { "id":"292", "name":"WebCR_Migration-2018-Jul-17-4.log", "path":"Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log" },

    { "id":"285", "name":"WebCR_Migration-2018-Jul-17-4.log.zip", "path":"Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.log.zip" },

    { "id":"293", "name":"WebCR_Migration-2018-Jul-17-4.txt", "path":"Automation Anywhere\\My Docs\\Log-Files\\WebCR_Migration-2018-Jul-17-4.txt" }

    ]

    }

参数描述

Parameter 描述
files 子文件的列表
id 机器人的文件 ID
名称 目录/文件夹的名称
path 目录/文件夹路径

4.在 Enterprise Control Room 10.x 中按名称搜索文件夹

此 API 允许您从源 Enterprise Control Room我的文档存储库中按给定名称搜索文件夹。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 GET 方法通过端点 http(s)://<hostname:port>/v1/migration/legacyrepository/folders(后跟 taskName 参数)按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v1/migration/legacyrepository/folders?taskName=Import-Table

  3. 单击“发送”
  4. 当响应状态为 200 时,对象详细信息成功列出
  5. 在正文数据中显示详细信息:

    {

    "paths":

    [ "Automation Anywhere\\My Docs\\Import-Table" ]

    }

参数描述

Parameter 描述
paths 目录/文件夹路径列表

5.获取 Enterprise Control Room 10.x 中给定文件夹的文件列表

此 API 允许您获取源Enterprise Control Room我的文档存储库中给定文件夹内的文件列表。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 POST 方法通过端点 http(s)://<hostname:port>/v1/legacyrepository/files 获取给定文件夹的文件列表
    • 例如,https://crdevenv.com:81/v1/legacyrepository/files

  3. 在正文中提供文件夹路径列表作为请求有效负载

    [

    "string"

    ]
    • 例如,下面列出了可用的文件

      [

      "Automation Anywhere\\My Docs\\Import-Table"

      ]

  4. 单击“发送”
  5. 当响应状态为 200 时,对象详细信息成功列出
  6. 响应详细信息将显示在正文数据中:

    {

    "files":

    [

    { "id":1281, "type":"BOT", "sourceId":"1281", "targetId":0, "name":"Automation Anywhere\\My Docs\\Import-Table\\Import-Table.txt", "status":"SUCCESS", "reason":"" },

    { "id":293, "type":"BOT", "sourceId":"293", "targetId":0, "name":"Automation Anywhere\\My Docs\\Import-Table\\WebCR_Migration-2018-Jul-17-4.txt", "status":"SUCCESS", "reason":"" }

    ]

    }

参数描述

Parameter 描述
files 子文件的列表
type 文件类型
sourceId 源数据库中实体的 ID
targetId 目标数据库中迁移后的实体的 ID
名称 目录/文件夹的名称
status 响应状态 -“成功”、“已跳过”或“失败”
reason “失败”或“已跳过”状态的原因描述

B. 在数据迁移到 11.x 之后从 10.x 迁移新的或修改的机器人

此 API 允许您在数据迁移到目标 Enterprise Control Room版本 11.x 后,获取源 Enterprise Control Room版本 10.x 中新的或修改的机器人列表。从本质上说,此 API 允许您继续使用 10.x 环境,而 11.x 环境已准备好投入生产。

  1. 在标头中提供“X-Authorization”参数。
  2. 使用 POST 方法通过端点 http(s)://<hostname:port>/v1/legacyrepository/changedfiles 按 ID 获取对象详细信息
    • 例如,https://crdevenv.com:81/v1/legacyrepository/changedfiles
  3. 在正文中提供文件夹路径列表作为请求有效负载

    {

    "changeSince":"<last migration date and time>"

    }

    • 例如,下面列出在迁移后更新的机器人名称

      {

      "changeSince":"2018-06-25T12:05:00+05:30"

      }

    提示: 不要指定 changeSince 参数来考虑上次迁移日期和时间的增量。
  4. 单击“发送”。
  5. 当响应状态为 200 时,对象详细信息成功列出
  6. 响应详细信息将显示在正文数据中:

    {

    "changedfiles":

    [

    { "type":"BOT", "sourceId":"6", "name":"Automation Anywhere\\My Tasks\\Sample Tasks\\Import-Table.atmx" },

    { "type":"BOT", "sourceId":"7", "name":"Automation Anywhere\\My Tasks\\Sample Tasks\\List-Variable.atmx" }

    ]

    }

参数描述

Parameter 描述
changedFiles 自上次迁移运行以来已更改或新的实体列表
type 实体类型
sourceId 源数据库中实体的 ID
名称 目录/文件夹的名称

API 响应代码

Http(s) 状态代码 响应 - 描述 纠正措施
200 成功操作 不适用
400 错误请求 使用有效参数重试
401 需要身份验证 通过提供身份验证参数进行重试
403 未经授权访问 确保您具有执行此操作的适当权限
404 未找到 确保Enterprise Control Room中存在所请求的数据
409 冲突 确保提供的参数正确
500 内部服务器错误 确保服务器已启动并且正在运行
501 权限错误 确保您具有所需的权限

审核日志

审核日志会显示每个迁移实体的独立条目。

审核日志,显示已迁移的每个实体的详细信息

在启动迁移过程时,会在审核日志中记录一个迁移已开始条目。同样,在迁移过程完成时,会记录一个迁移已完成条目。在这两个条目之间,将为每个迁移的实体记录迁移条目,例如创建更新或上传操作。

单击 查看过程的详细信息。
发送反馈