活动设计器

概述

活动设计器是连接器生成器的一项新功能。 活动设计器可让您预览自定义 Integration Service 活动的布局，因为它们将显示在UiPath™ Studio 中。

其主要功能包括：

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

输入字段

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

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

下图显示了资源的“活动设计器”选项卡。 相同的参数在左侧列出，但“预览”窗口中仅显示标记为“必填”的字段：

编辑参数

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

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

输入参数值

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

• 必需：使用星号 (*) 符号将参数标记为必需。 这意味着它在画布上始终可见，并且必须为其提供值。

  
  

  

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

  

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

  

  
  

对输入参数排序

输入参数的顺序决定了参数在活动“预览”窗口中的位置。 您可以使用拖动更改顺序图标位于每个参数旁边。

例如，要将“时间” 字段移至“输入”部分的顶部，请将相应的图标向上。

在活动的“预览” 窗口中，系统会根据字段分配到的组（“ 必填 ”、“ 主要 ” 和“ 其他 ”），按照在“ 输入 ” 选项卡中列出的顺序显示字段。

请求字段

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

请求字段通常与POST 、 PUT或PATCH请求（插入、更新插入或更新记录活动）相关联。 如果将请求字段添加到GET或DELETE请求（列出、获取或删除活动），系统将显示一条错误消息，通知您该操作不会显示该字段。

下图显示了尝试将请求字段添加到DELETE资源时显示的错误消息：

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

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

选项 1（推荐）

使用格式正确的 JSON。

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

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

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

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

选项 2

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

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

   

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

   

   
   

输出字段

“活动设计器”中的“输出”字段从“响应”字段中拉取。 成功向资源发出请求后，即可填充这些值。

策划的字段

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

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