使用表单设计器设计表单

• 单行文本
• 段落文本
• 带格式文本
• 描述性文本 — 即将推出

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

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

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再能够识别Workfront其他区域中现在可能引用该字段的自定义字段。

  例如，如果您将自定义字段添加到报表后更改其名称，Workfront将无法识别该字段在报表中的名称，并且除非您使用新名称将其重新添加到报表，否则该字段将在报表中停止正常工作。

• 我们建议您不要键入已用于内置Workfront字段的名称。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

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

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

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

注释：

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

• 单行文本
• 段落文本

• 单行文本
• 段落文本

• 描述性文本

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

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

（必需）此名称是向Workfront中的各个区域（如报表、主页和API交互）添加自定义字段时，系统识别该字段的方式。

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再能够识别Workfront其他区域中现在可能引用该字段的自定义字段。

  例如，如果您将自定义字段添加到报表后更改其名称，Workfront将无法识别该字段在报表中的名称，并且除非您使用新名称将其重新添加到报表，否则该字段将在报表中停止正常工作。

• 我们建议您不要键入已用于内置Workfront字段的名称。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

每个自定义字段名称在贵组织的Workfront实例中必须唯一。 这样，您就可以重复使用已经为其他自定义表单创建的表单。 有关详细信息，请参阅本文中的将自定义字段添加到自定义表单。

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

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

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

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

注释：

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

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

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

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

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

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

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

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

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

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

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

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

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

• 键盘缓冲
• 日期字段

（必需）此名称是向Workfront中的各个区域（如报表、主页和API交互）添加自定义字段时，系统识别该字段的方式。

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再能够识别Workfront其他区域中现在可能引用该字段的自定义字段。

  例如，如果您将自定义字段添加到报表后更改其名称，Workfront将无法识别该字段在报表中的名称，并且除非您使用新名称将其重新添加到报表，否则该字段将在报表中停止正常工作。

• 我们建议您不要键入已用于内置Workfront字段的名称。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

每个自定义字段名称在贵组织的Workfront实例中必须唯一。 这样，您就可以重复使用已经为其他自定义表单创建的表单。 有关详细信息，请参阅本文中的将自定义字段添加到自定义表单。

• 键盘缓冲
• 日期字段

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

• 键盘缓冲
• 日期字段

• 日期字段

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

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

注释：

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

• 键盘缓冲

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

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

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

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

注释：

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

• 键盘缓冲

• 键盘缓冲
• 日期字段

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

（必需）此名称是系统标识自定义字段的方式。

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再能够识别Workfront其他区域中现在可能引用该字段的自定义字段。

  例如，如果您将自定义字段添加到报表后更改其名称，Workfront将无法识别该字段在报表中的名称，并且除非您使用新名称将其重新添加到报表，否则该字段将在报表中停止正常工作。

• 我们建议您不要键入已用于内置Workfront字段的名称。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

每个自定义字段名称在贵组织的Workfront实例中必须唯一。 这样，您就可以重复使用已经为其他自定义表单创建的表单。 有关详细信息，请参阅本文中的将自定义字段添加到自定义表单。

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

注意：

• 保存表单后，可以更改格式类型，但有一个限制：对象上的所有现有值都必须能够转换为新类型。 （例如，如果格式类型为“文本”，并且对象正在存储“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进行身份验证所需的密钥值对。

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

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

（必需）此名称是系统标识构件的方式。

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

重要信息：虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再识别该构件可能在Workfront的其他区域中被引用的构件。

每个构件名称在贵组织的Workfront实例中必须唯一。 这样，您就可以重复使用已经为其他自定义表单创建的表单。

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

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

• YouTube或Vimeo链接

• Google Drive视频链接

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

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

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

（必需）此名称是系统标识字段的方式。

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再识别现在可能在Workfront其他区域引用它的字段。

• 每个字段名称在贵组织的Workfront实例中必须唯一。 这样，您就可以重复使用已经为其他自定义表单创建的表单。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

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

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

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

重要提示：请避免在此标签中使用特殊字符。 它们在报表中无法正确显示。

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

重要信息：

• 虽然可以这样做，但我们建议，在您或其他用户开始使用Workfront中的自定义表单后，不要更改此名称。 如果这样做，系统将不再能够识别Workfront其他区域中现在可能引用该字段的自定义字段。

  例如，如果您将自定义字段添加到报表后更改其名称，Workfront将无法识别该字段在报表中的名称，并且除非您使用新名称将其重新添加到报表，否则该字段将在报表中停止正常工作。

• 我们建议您不要键入已用于内置Workfront字段的名称。

• 我们建议您在自定义字段名称中不要使用句点/点字符，以防止在Workfront的不同区域使用字段时出错。

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

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