活动设计器

概述

活动设计器可让您预览自定义 Integration Service 活动的布局，因为它们将显示在UiPath™ Studio 中。

其主要功能包括：

• 预览布局：预览自定义活动的设计，并查看它们在 Studio 中的显示方式。 在部署连接器之前，您可以将设置可视化并进行必要的调整。
• 参数设置：创建和管理参数字段，以便更灵活地自定义活动。 这包括工作流中使用的输入、输出、输入/输出参数和属性。
• 请求和响应字段：添加请求和响应字段。 这可帮助您定义活动（请求）所需的信息以及活动将返回的信息（响应）。

输入字段

要配置自定义连接器的资源，您可以使用“参数” 选项卡添加特定于请求类型的字段。 活动设计器从“参数”或“请求字段”选项卡检索所有参数和字段，并将其显示在“输入”部分下。

下图显示了资源的“参数” 选项卡。 只有一个字段标记为必填：

图 1.具有一个必填字段的参数

图 2.包含一个必填字段的请求字段

下图显示了资源的“请求字段”选项卡。 只有一个字段标记为必填字段：

下图显示了资源的“活动设计器”选项卡。 必填参数和请求字段将显示在“预览”窗口中：

编辑参数

通过单击“更多选项”，在“活动设计器”选项卡中编辑或删除参数菜单。

通过选择“位置”选项（“主要”、“次要”或“无”）来配置参数和请求字段的位置。 当您将字段设置为“必填” 时，其“位置” 会自动设置为“主要”，并且该字段将显示在活动画布的主要部分上。

更改参数在“预览”窗口中的显示方式（其显示名称和说明），方法是单击“编辑”参数名称旁边的图标。

输入参数值

在活动设计器选项卡中，您可以将参数或字段在活动画布上的位置指定为 “主要”、“次要”或 “无”。 每个选项都规定了参数的行为及其在活动画布上的显示位置。 或者，您可以将字段标记为“必填”，以自动将其位置设置为“主要”。

• 必填：此参数或字段需要具有值才能成功执行活动。 使用星号 (*) 符号将该参数标记为必需。 这意味着该值始终在画布上可见，并且您必须为其提供值。

  
  

  

  
  
• 主要: 在活动的主要部分中显示参数。 在自动化中使用该活动时，可以将其留空。
  
  

  

  
  
• 次要: 主画布中隐藏参数。 它显示在“显示其他选项”部分下。 这些字段是可选的，并且可以留空。
  
  

  

  
  
• 无: 对活动隐藏参数。 您必须使用“管理属性”向导将其添加到画布中。

对输入参数排序

输入参数的顺序决定了它们在活动的“预览”窗口中的位置。 您可以使用每个参数最左侧的图标上下拖动列表项目，以更改显示顺序。

请求字段

“请求”字段用于填充 HTTP 请求的正文。

请求字段通常与POST 、 PUT或PATCH请求（插入、更新插入或更新记录活动）相关联。

填充“请求”和“响应”字段

有两种方法可以填充请求和响应字段。

选项 1（推荐）：使用格式正确的 JSON。

1. 单击资源的“发送请求” 按钮。
2. 添加 JSON。
3. 确保已启用“发送请求时覆盖字段”选项。
4. 选择“执行” 。

如果响应成功，则系统会使用用于请求的 JSON 属性填充输入字段，并根据响应填充输出字段。

注意：如果使用此方法，请发出包含要在活动中使用的所有字段的详尽请求。

下图显示了POST请求的有效负载示例。 请注意，“发送请求时覆盖字段”字段已启用：

选项 2：从“活动设计器”选项卡中手动添加每个请求和响应字段。

1. 导航到活动设计器选项卡。
2. 在“输入”选项卡中，单击“更多选项”菜单。
3. 选择“添加请求字段” 。
4. 以与添加参数类似的方式添加请求字段的详细信息。
   
   

   

   
   
5. 要添加响应字段，请转到“输出”选项卡，然后选择“添加响应字段”选项。
   
   

   

   
   

输出字段

活动设计器中的“输出” 字段从“响应” 字段中拉取。 可以通过成功调用资源来填充值。

策划的字段

您可以将输出字段标记为“策划”。 字段值专门从响应对象中提取，并且可以分配给变量，从而在自动化中使用时，可以轻松在其他活动中访问和使用。

下图显示了策划字段 “状态”的直接显示方式：活动的“输出”部分：