创建自定义表单

• 单行文本
• 段落
• 带格式文本
• 描述性文本

（必需）键入要在该字段上方显示的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

• 单行文本
• 段落
• 带格式文本

（必需）此名称是系统标识字段的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

• 单行文本
• 段落
• 带格式文本
• 描述性文本

• 单行文本
• 段落
• 带格式文本

选择将在自定义字段中捕获的数据类型。

注释：

• 保存表单后无法编辑此字段。 如果要在数学计算中使用字段，请确保选择“数字”或“货币”格式。
• 选择“数字”或“货币”时，系统会自动截断以0开头的数字。
• 数字字段的字符限制为16。 您还可以使用文本字段输入数字并避免限制。

• 单行文本
• 段落

• 单行文本
• 段落

• 描述性文本

（必需）键入要显示在自定义字段上方的描述性标签。 您可以随时更改标签。

重要信息：

请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

（必需）此名称是系统标识字段的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

键入有关自定义字段的任何其他信息。 当用户填写自定义表单时，可以将光标悬停在问号图标上，以查看包含您在此处键入的信息的工具提示。

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

选择将在自定义字段中捕获的数据类型。

注释：

• 保存表单后无法编辑此字段。 如果要在数学计算中使用字段，请确保选择“数字”或“货币”格式。
• 选择“数字”或“货币”时，系统会自动截断以0开头的数字。
• 数字字段的字符限制为16。 您还可以使用文本字段输入数字并避免限制。

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

1. 单击 选项，然后启用以下任一选项：

   • 显示值：显示字段中每个选择的值。 默认情况下，将显示每个选项的标签。
   • 选择排序A-Z：按字母顺序对您在字段中添加的选择进行排序。

2. 对于您为用户添加的每个选项，单击齿轮图标 ，然后选择以下选项之一：

   • 默认选择：在字段中选择默认选择。

   • 隐藏选择：隐藏字段中的选择。 隐藏选项在报表中仍可访问。

   • 删除选择：从字段中删除选择。

     警告：如果当前对象使用此选项，请不要将其从字段中移除。 删除它将会导致历史数据丢失。 相反，选择选项可隐藏它，这会阻止用户将来选择它。

注意：

您可以选择的选项数量没有限制。

• 单选按钮
• 复选框组
• 单选下拉菜单
• 多选下拉框

（必需）键入要显示在自定义字段上方的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

• 键盘缓冲
• 日期

（必需）此名称是系统标识字段的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

• 键盘缓冲
• 日期

键入有关自定义字段的任何其他信息。 当用户填写自定义表单时，可以将光标悬停在问号图标上，以查看包含您在此处键入的信息的工具提示。

• 键盘缓冲
• 日期

• 日期

选择要与字段关联的对象类型。

单击“应用”或“保存+关闭”后，将无法更改该字段的对象类型。

注释：

• 如果您的Workfront管理员在Workfront用户界面中为项目组合、程序或项目自定义了名称，则该对象的默认Workfront名称将显示在此下拉列表中，而不是自定义名称中。 如果您需要此方面的帮助，请咨询您的Workfront管理员。
• iOS和Android Workfront Mobile应用程序支持以下对象类型：用户、公司、组、工作角色、Portfolio、项目、项目和模板。

• 键盘缓冲

为对象类型添加过滤器，以限制用户在使用该字段时可以选择的对象。

例如，您可以限制一个字段，这样只有当用户名满足以下条件时才可以选择用户名：

• 它们属于您指定的一个或多个组
• 它们与您指定的角色或职称相关联
• 他们与使用字段的人属于同一组

必须使用文本模式语法为所选对象类型定义过滤器。 有关使用文本模式创建过滤器的信息，请参阅使用文本模式编辑过滤器。

注释：

• 如果您正在编辑现有的自定义表单，则将过滤器添加到“预输入”字段不会移除用户已使用该字段添加的任何对象（在过滤器的范围外）。
• 此筛选器在移动设备上不可用。 如果您将过滤器用于“预输入”字段，则该字段将显示在不受过滤器影响的用户移动设备上。

• 键盘缓冲

• 键盘缓冲
• 日期

（必需）键入要显示在自定义字段上方的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

（必需）此名称是系统标识字段的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

选择将在自定义字段中捕获的数据类型。

注意：

• 保存表单后，可以更改格式类型，但有一个限制：对象上的所有现有值都必须能够转换为新类型。 （例如，如果格式类型为“文本”，并且对象正在存储“abc”值，则您无法转换该字段，并且会收到一个错误，说明系统无法将“abc”转换为数字/货币。） 如果要在数学计算中使用字段，请确保选择“数字”或“货币”格式。
• 选择“数字”或“货币”时，系统会自动截断以0开头的数字。
• 数字字段的字符限制为16。 您还可以使用文本字段输入数字并避免限制。

键入或粘贴API的URL。

API URL必须返回要在下拉列表中显示的选项的JSON内容。 您可以使用JSON路径字段从返回的JSON中选择特定值作为下拉选项。

输入API URL时，您可以选择在URL中传递以下值：

• $$HOST — 表示当前Workfront主机，可用于对Workfront API进行/search API调用。 使用此通配符时，将处理身份验证，用户无需发送身份验证标头。 （例如，用户可以使用基本URL $$HOST/attask/api/task/search搜索任务，它将允许搜索任务并从返回的任务列表中选择值。）

• $$QUERY — 这表示最终用户在字段中键入的搜索文本，并允许您为最终用户实施查询筛选。 （用户将在下拉列表中搜索值。）

  如果所引用的API允许这样做，则还可以在搜索查询中包含修饰符以标识搜索应如何工作。 例如，您可以使用以下内容作为基本API URL，以允许人员搜索包含特定文本的任何Workfront项目： $$HOST/attask/api/v15.0/proj/search?name=$$QUERY&name_Mod=contains。

  在API基础知识中了解有关Workfront搜索修饰符的更多信息。

  注意： 如果您未使用$$QUERY，并且搜索框中的用户类型文本将缩小您现有的选择范围。 但是，如果您使用$$QUERY并且用户键入了任何内容，则会对您的API执行新的网络调用。 因此，如果您的API中有超过2000个值，并且该API支持查询，则您可以利用$$QUERY不仅从现有2000个值中进行搜索，还可以从具有缩小选项的原始API中进行搜索。

• {fieldName} — 其中fieldName是Workfront中的任何自定义或本机字段。 这样，在将已选字段的值传递到外部查找字段以筛选下拉选项时，您可以实施级联下拉选项过滤器。 （例如，表单上已存在区域字段，并且您正在将国家/地区列表从API缩小到特定区域的国家/地区。）

  对于依赖其他字段的外部查找字段（使用{fieldName}语法），从API返回的选项仅限于匹配在其他字段中输入的任何字符串或值的选项。 （列表和报告不支持此功能。）

• {referenceObject}。{fieldName} — 其中字段是对象的一部分。 此语法类似于自定义表达式。 (例如，portfolioID={project}。{portfolioID})

注意： 请查看文档以了解您正在使用的API，以便获取您可以定义的特定查询。

键入或粘贴API的JSON路径。

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

例如，如果API URL返回的JSON格式为：

   {
    数据： {
      { name： "USA"}，
      { name： "Canada"}
    }
   }

然后，您可以使用“$.data[*].name”选择“美国”和“加拿大”作为下拉选项。

有关JSON路径并确保编写正确JSON路径的更多信息，请参阅https://jsonpath.com/。

单击 添加标头，然后键入或粘贴使用API进行身份验证所需的密钥值对。

注意： 标头字段不是存储凭据的安全位置，您应该小心输入和保存的内容。

（必需）键入要在小部件上方显示的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

（必需）此名称是系统标识构件的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

（必需）键入或粘贴构件存储在Internet上的URL。

如果要添加视频构件，当前可通过在URL框中添加以下内容来实现此目的：

• YouTube或Vimeo链接

• Google Drive视频链接

• 视频链接，带有MP4和MOV扩展

• 视频链接已上传到Workfront实例中的文档区域。 有关说明，请参阅本文中的“文档”区域中的将视频小组件添加到自定义表单。

（必需）键入要在该字段上方显示的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

（必需）此名称是系统标识字段的方式。 当您首次配置字段并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

（必需）选择Workfront原生字段。

仅表单对象的本机字段可用。 例如，如果表单设计器顶部的“对象类型”列表显示“项目”，则您将能够选择项目的本机字段，但不能选择特定于任务的字段。

为参考字段添加过滤器，以限制用户在使用字段时可以选择的项目列表。

例如，您可以限制一个字段，这样只有当用户名满足以下条件时才可以选择用户名：

• 它们属于您指定的一个或多个组
• 它们与您指定的角色或职称相关联
• 他们与使用字段的人属于同一组

必须使用文本模式语法为所选的引用字段定义过滤器。 有关使用文本模式创建过滤器的信息，请参阅使用文本模式编辑过滤器。

注释：

• 仅当您引用本机预输入字段(如“Portfolio”、“公司”或“所有者”)时，过滤器选项才可用。
• 如果您正在编辑现有的自定义表单，将过滤器添加到本机字段不会移除用户已使用该字段添加的任何对象（在过滤器的范围外）。
• 此筛选器在移动设备上不可用。 如果您将过滤器用于本机字段，则该字段将显示在不受过滤器影响的用户移动设备上。

（必需）键入要在小部件上方显示的描述性标签。 您可以随时更改标签。

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。 有关详细信息，请参阅有关字段名称和标签的注释。

（必需）此名称是系统标识构件的方式。 首次配置构件并键入标签时，会自动填充名称字段以匹配它。 但是“标签”和“名称”字段不同步，这使您能够自由更改用户看到的标签，而无需更改系统看到的名称。

有关详细信息，请参阅有关字段名称和标签的注释。

（必需）键入或粘贴有效的XD原型链接。

注意：在Adobe XD中，共享选项卡上的链接访问设置必须设置为具有链接的任何人。 否则，用户将无法查看原型。

（必需）键入要在该字段上方显示的描述性标签。 您可以随时更改标签。

重要信息：

请避免在此标签中使用特殊字符。

我们建议您选择一个标签，以便轻松识别Planning记录的来源。 添加诸如工作区名称或记录类型名称之类的信息。

（推荐）键入有关字段的任何其他信息。 当用户填写自定义表单时，可以将光标悬停在问号图标上，以查看包含您在此处键入的信息的工具提示。

在这里，您可以添加有关记录和所连接对象的明确信息。

（必需）选择连接到Workfront Planning中的记录类型的Workfront对象类型。

您可以从以下对象类型中进行选择：

• 项目
• 项目组合
• 项目群
• 公司
• 组

只有表单对象类型的Workfront对象类型可用。

例如，如果表单设计器顶部的“对象类型”列表显示“项目”，则在此字段中只能选择“项目”，而不能选择“项目组合”，尽管项目组合也可以连接到记录类型。

（必需）选择您要在Workfront中显示的记录来自的Planning工作区。

只有连接到您在“对象类型”字段中选择的对象类型的工作区才会显示。

（必需）选择与Workfront对象类型相关的Workfront Planning记录类型。

只显示与您在对象类型字段中选择的对象类型有连接的记录类型。

（必需）选择要在Workfront对象上显示的选定Planning记录类型与Workfront对象类型之间的连接字段。

注释

同一对象和记录类型之间可以有多个连接字段，但只能选择一个字段。