创建自定义表单

• 项目
• 任务
• 问题/请求
• 项目组合
• 文档
• 项目群
• 费用
• 用户
• 公司
• 开发周期
• 账单记录
• 组
• 团队

如果您在Workflow Ultimate包中，则还可以为这些对象创建自定义表单：

• 工作角色
• 费率卡
• 任务

• 单行文本
• 段落
• 丰富文本
• 描述性文本

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

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

• 单行文本
• 段落
• 丰富文本

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

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

• 单行文本
• 段落
• 丰富文本
• 描述性文本

• 单行文本
• 段落
• 丰富文本

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

注释：

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

• 单行文本
• 段落

选择用户查看或编辑此自定义字段之前必须具有的财务权限类型。 必须选择货币格式。

• 不需要权限：所有用户都可以看到此字段

• 常规：用户必须具有编辑或查看常规财务的权限

• 帐单：用户必须具有编辑或查看记帐费率的权限

• 成本：用户必须具有编辑或查看成本费率的权限

有关详细信息，请参阅限制对自定义字段中的财务数据的访问。

• 单行文本
• 段落

• 单行文本
• 段落

• 描述性文本

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

• 单行文本
• 段落
• 丰富文本
• 描述性文本

• 单行文本
• 段落
• 丰富文本

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

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

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

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

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

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

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

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

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

注释：

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

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

选择用户查看或编辑此自定义字段之前必须具有的财务权限类型。 必须选择货币格式。

• 不需要权限：所有用户都可以看到此字段

• 常规：用户必须具有编辑或查看常规财务的权限

• 帐单：用户必须具有编辑或查看记帐费率的权限

• 成本：用户必须具有编辑或查看成本费率的权限

有关详细信息，请参阅限制对自定义字段中的财务数据的访问。

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

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

选择以下任一选项：

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

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

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

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

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

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

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

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

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

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

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

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

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

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

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

注意：

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

选择用户查看或编辑此自定义字段之前必须具有的财务权限类型。 必须选择货币格式。

• 不需要权限：所有用户都可以看到此字段

• 常规：用户必须具有编辑或查看常规财务的权限

• 帐单：用户必须具有编辑或查看记帐费率的权限

• 成本：用户必须具有编辑或查看成本费率的权限

有关详细信息，请参阅限制对自定义字段中的财务数据的访问。

键入或粘贴API的URL。

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

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

• $$HOST — 表示当前Workfront主机，可用于对Workfront API进行/搜索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，则可以使用“$.data[*].name”选择美国和加拿大作为下拉选项：

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

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

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

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

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

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

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

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

注意：

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

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

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

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

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

提示：您可以先创建报告以测试您的筛选器，然后再将该筛选器直接添加到内部查找字段。 这将帮助您验证过滤器是否返回正确的对象。 然后，您可以在报表中切换到文本模式，复制文本模式语句并将其添加到内部查找过滤器。

注释：

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

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

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

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

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

• YouTube或Vimeo链接

• Google Drive视频链接

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

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

（必需）此名称是系统标识字段的方式。 当您首次配置字段并键入标签时，API名称字段会自动填充以匹配它。 标签和API名称字段不同步。 这样，您就可以选择更改用户看到的标签，而不必更改系统看到的名称。

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

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

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

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

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

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

当字段上存在系统筛选器时，如果您不添加自定义筛选器，则默认应用该筛选器。 自定义筛选器将覆盖系统筛选器。

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

使用动态筛选器语法根据另一个字段的值缩小此字段中的项目列表。 例如，当您在项目字段筛选器中使用?portfolioID={portfolio}.{ID}，并且自定义表单上有Portfolio本机字段时，项目字段仅显示选定项目组合中的项目。 如果Portfolio字段留空，则所有项目在项目字段中均可用。

注释：

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

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

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

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

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

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

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。

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

重要提示：请避免在此标签中使用特殊字符。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

（可选）从连接的记录类型中选择最多7个查找字段以在自定义表单中显示。 默认情况下，主字段处于选中状态，无法编辑。

您选择的已连接记录的字段显示在自定义表单的表视图中。 将表单附加到Workfront对象时，表格视图为只读。

此选项默认处于打开状态。

将字段设置为“不活动”时，该字段将从报表、筛选器和视图中排除，并且在自定义表单字段库中不再可用。