创建 API Task

您可以使用 Automation Anywhere Control Room 支持的各种软件包创建 API Task。

先决条件

您必须具有 Bot Creator 许可证。
本主题介绍如何使用示例 API 创建 API Task，该 API 将美国邮政编码作为输入，并将地点和州名称作为输出返回。 您可以针对场景创建包含特定操作的 API Task。

过程

  1. 登录到您的 Automation Anywhere Control Room 实例作为机器人创造程序。
  2. 创建新 API Task：
    1. 在左侧窗格中，单击自动化。
    2. 单击新建 > API Task 。
    3. 在创建 API Task 窗口中，输入 API Task 名称。
    4. 接受默认文件夹位置：\Bots\。
      要更改 API Task 的存储位置，请单击选择并按照提示操作。
    5. 单击创建和编辑。
  3. 创建 ZipCode 变量作为输入，将用于邮政编码 URL。
  4. 使用 Get 方法 action 来检索邮政编码的地点和状态。
    注： 大多数常见的企业应用程序都有预构建的软件包可用。 有关受支持软件包的列表，请参阅 表 1。
    1. 双击或拖动REST 网页服务 > Get 方法 action。
      REST 网页服务 - Get 方法
    2. 输入以下 URI。$ZipCode$ 在 URI 中是步骤 3 中创建的输入变量。 
      https://api.zippopotam.us/us/$ZipCode$
      注：

      您可以在单个 API Task 中调用多个 API。 这可以简化您的自动化过程，并减少对多个独立任务的需求。 例如，您可以调用 API 1 来获取产品数据，调用 API 2 来获取定价数据，然后在同一个 API Task 中调用 API 3 来创建报价。

    3. 在身份验证模式下拉列表中，选择无身份验证，因为此端点不需要身份验证。
      注： 通常，端点需要进行身份验证以确保只有授权的应用程序可以访问数据。 选择适当的身份验证机制以允许访问您想要访问的端点。
    4. 为将输出分配给变量字段创建 pDictZipCodeApiResponse 变量。 有关创建变量的详细信息，请参阅 创建变量。
      注：
      • 完整的 API JSON 响应已分配给该字典变量：pDictZipCodeApiResponse。
      • 以下变量类型不支持用于 API Tasks： 文件、窗口和表单。
  5. 从操作窗格中，拖动 JSON > 开始会话 操作并将其放入 REST 网页服务 操作下方的画布中。
    1. 在数据源字段中，选择文本并输入 $pDictZipCodeApiResponse{Body}$。
    2. 在 JSON 对象会话字段中，选择本地会话，然后输入默认。

      API Task 字典
      您现在已获取完整的正文。 接下来的任务是从正文中提取所需的字段。 以下展示了一个示例 JSON 正文：
      { "post code": "90210", "country": "United States", "country abbreviation": "US", "places": [ { "place name": "Beverly Hills", "longitude": "-118.4065", "state": "California", "state abbreviation": "CA", "latitude": "34.0901" } ] }
  6. 从 JSON 中提取地名。
    1. 从操作窗格中，拖动JSON > 获取节点值 action，并将其放入JSON > 州/省会话操作下方的画布中。
    2. 指定要提取的节点。 例如，要提取地点，您可以使用 places[0].["place name"]。
    3. 创建变量 Place 并将输出分配给此变量。
  7. 从 JSON 中提取州/省。
    1. 从操作窗格中，拖动JSON > 获取节点值 action，并将其放入JSON > 州/省会话操作下方的画布中。
    2. 指定要提取的节点。 例如，要提取地点，您可以使用 places[0].["state"]。
    3. 创建一个变量 State 并将输出分配给此变量。
  8. 单击保存。
    要测试 API Task，请单击调试器。 调试时，使用本地设备执行 API Task。 此示例中创建的 API Task 可检索任何邮政编码输入的地点和州/省。