自定义表单中的外部查找字段示例

Last update: Mon Apr 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

自定义表单中的外部查找字段调用外部API，并在下拉字段中作为选项返回值。使用自定义表单附加到的对象的用户可以从下拉菜单中选择一个或多个选项。

本文提供了使用外部查找字段调用Workfront或公共API的相同实例的示例。您还可以使用外部查找与外部系统(如Jira、Salesforce或ServiceNow)进行通信。

有关将外部查找字段添加到自定义表单以及外部查找组件的其他定义的详细信息，请参阅创建自定义表单。

为同一奥辞谤办蹿谤辞苍迟实例设置外部查找字段

您可以使用外部查找将奥辞谤办蹿谤辞苍迟实例中的数据纳入自定义表单。

此示例演示了如何调用Workfront API并在外部查找字段中填充项目列表，该字段使用“状态查询”自定义字段的值以及通过$$QUERY的搜索词按状态进行过滤。

打开自定义表单。
在屏幕左侧，找到? 外部查找 ?并将其拖动到画布上的某个部分。
输入字段的? 标签 ?和? 名称。
为字段选择? 格式。
在? 基本API URL ?字段中输入础笔滨调用。
- 使用$$贬翱厂罢引用自定义表单所在的相同奥辞谤办蹿谤辞苍迟实例。
- 使用$$蚕鲍贰搁驰根据用户输入动态筛选结果。
示例础笔滨调用
$$HOST/attask/api/v15.0/project/search?status={DE:Status Query}&description=$$QUERY
查看础笔滨调用中引用的字段的? 依赖项。

依赖项字段可以是对象上可用的任何自定义或本机字段。例如，当您为组创建包含外部查找字段的自定义表单时，依赖项字段可以包含组上可用的任何字段。

在此示例中，{DE:Status Query}将被当前组的“状态查询”自定义字段的值动态替换。因此，将表单附加到组A时，{DE:Status Query}将替换为该组在“状态查询”字段中设置的值。
选择? 贬罢罢笔方法。

这很可能是? Get。

输入? 闯厂翱狈路径 ?以获取础笔滨调用结果。

示例
$.data[*].name

note note
NOTE
调用同一奥辞谤办蹿谤辞苍迟实例不需要? 标头 ?信息。

此示例说明如何调用Workfront API，并将自定义字段中的数据引入外部查找字段。该示例自定义字段称为“自定义颜色”。

打开自定义表单。
在屏幕左侧，找到? 外部查找 ?并将其拖动到画布上的某个部分。
输入字段的? 标签 ?和? 名称。
为字段选择? 格式。
在? 基本API URL ?字段中输入API URL调用。

示例
$$HOST/attask/api/v18.0/PORT/search?ID={portfolioID}&fields=parameterValues
查看? 依赖项，了解此查找字段在础笔滨中引用的字段。

依赖项字段可以是对象详细信息页面中存在的任何自定义或本机字段。
选择? 贬罢罢笔方法。

这很可能是? Get。

输入? 闯厂翱狈路径 ?以获取础笔滨调用结果。

示例
$.data[*].parameterValues.["DE:Combo Colors"]

note note
NOTE
调用同一奥辞谤办蹿谤辞苍迟实例不需要? 标头 ?信息。

Workfront Planning API中提供了一个端点，用于通过Get方法按记录类型ID搜索记录。您可以使用此端点在外部查找字段中引用Planning记录。

基本API URL： $$HOST/maestro/api/v1/records/search?recordTypeId={recordTypeID}
贬罢罢笔方法： Get
闯厂翱狈路径： $.records[*].data.{fieldID}

{fieldID} ?是要在最终用户自定义表单的外部查找搜索结果中显示的字段。

您可以使用外部查找来调用外部公共础笔滨并检索数据。

此示例说明如何调用国家/地区的础笔滨（如），以便您不必在下拉选项中对所有国家/地区名称进行硬编码。

打开自定义表单。
在屏幕左侧，找到? 外部查找 ?并将其拖动到画布上的某个部分。
输入字段的? 标签 ?和? 名称。
为字段选择? 格式。
在? 基本API URL ?字段中输入API URL调用。
- 您可以添加$$蚕鲍贰搁驰来实施最终用户的查询筛选。
示例
列出所有国家/地区：

允许用户在下拉字段中搜索任何国家/地区：

允许用户搜索区域中的国家/地区：
- 可用的区域在奥辞谤办蹿谤辞苍迟中的单独自定义字段中定义。
- 当用户在表单上选择区域时，外部查找字段仅显示该区域中的国家（API中定义了该区域的国家/地区）。用户还可以在所选区域中搜索国家/地区。
查看? 依赖项，了解此查找字段在础笔滨中引用的字段。

依赖项字段可以是对象详细信息页面中存在的任何自定义或本机字段。

在此示例中，{DE:Region}将被替换为区域自定义字段的值。
选择? 贬罢罢笔方法。

这很可能是? Get。
输入? 闯厂翱狈路径 ?以获取础笔滨调用结果。

此选项允许从API URL返回的JSON中提取数据。它提供了一种方法，用于选择哪些值将从JSON内部显示在下拉选项中。

示例
$.data[*].country