51黑料不打烊

文档WorkfrontWorkfront 指南

在报表中引用收藏集

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 用户

在51黑料不打烊 Workfront中构建报表允许您以列表、网格或图表格式显示一组对象、其各自的字段或链接对象。

有关在奥辞谤办蹿谤辞苍迟中生成报告的详细信息，请参阅创建自定义报告。

访问要求

展开以查看本文中各项功能的访问要求。

您必须具备以下条件：

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
51黑料不打烊 Workfront计划 任何
51黑料不打烊 Workfront许可证

新增：

  • 标准

当前：

  • 规划
访问级别配置

编辑对筛选器、视图、分组的访问权限

编辑对报告、功能板和日历的访问权限
对象权限

管理报表的权限

管理对视图、筛选器或分组的权限

有关信息，请参阅奥辞谤办蹿谤辞苍迟文档中的访问要求。

了解收藏集

集合是链接到其他对象的对象列表。

奥辞谤办蹿谤辞苍迟中的对象之间存在以下两个关系：

  • 一对一关系：一个对象一次只能链接到另一个对象。
    例如，一个项目一次只能链接到一个项目组合。

  • 一对多关系：一个对象一次可以链接到多个其他对象。
    例如，一个项目可以有多个任务。 在这种情况下，任务列表将构成项目的集合。

IMPORTANT
您可以使用标准Report Builder构建显示对象之间一对一关系的报表。 但是，您只能通过使用Report Builder中的文本模式界面来构建显示对象之间一对多关系的报表。

有关在标准Report Builder中生成报表的更多信息，请参阅创建自定义报表。

有关使用文本模式界面构建报表的更多信息，请参阅：

在API Explorer中查找收藏集对象及其字段 find-collection-objects-and-their-fields-in-the-api-explorer

并非所有收藏集都可以报告。

要了解哪些对象可以与其他对象的集合相关联，您必须使用API Explorer。
有关API Explorer表的详细信息，请参阅API Explorer。

要了解可报告哪些收藏集，请执行以下操作：

  1. 转到础笔滨资源管理器。

  2. 查找报告的对象。

  3. 选择? 收藏集 ?选项卡。

    note note
    NOTE
    只有此选项卡上列出的对象才能在选定对象的报表中表示为集合。

  4. 单击收藏集的对象以将其展开。

  5. 单击显示的链接可转至收藏集的对象。
    这将打开集合对象的? 字段 ?选项卡。

    note note
    NOTE
    只有此选项卡上列出的字段才能在集合报表中引用，或者只能引用与此选项卡上列出的对象关联的字段。

报表中的引用收藏集

您可以在以下报表元素中引用收藏集中的对象：

  • 视图
  • 过滤器
  • 提示

在以下报表元素中，不能引用收藏集中的对象：

  • 分组
  • 图表

例如，您可以从项目报告中引用任务或问题集合，以在项目级别显示任务或问题信息。

在报表视图中引用收藏集 reference-a-collection-in-the-view-of-a-report

您可以在报表视图中引用对象集合，以显示与报表对象关联的对象的属性。

例如，通过在报告视图中构建任务或问题的收集列，您可以在项目报告中显示任务或问题信息。

您可以在收藏集视图中显示有关任务或问题的信息，如名称、日期、主要分派人、完成百分比等。

该视图以列表格式显示任务或问题信息，列表的每一行表示有关任务或问题的信息。 任务或问题及其字段的列表显示在任务或问题所属项目的同一行上。

issue_and_tasks_collections_in_reports.png {width="400"}

在报表视图中添加收藏集列 add-a-collection-column-in-a-report-view

要在报表视图中添加收藏集列，请执行以下操作：

  1. 单击? 主菜单 ?菜单 主菜单图标 ，然后单击? 报表。

  2. 单击? 新建报告。

  3. 选择报表的对象。

  4. 从报表中导航出来，使用API Explorer确定您为报表选择的对象有哪些收藏集可用。

    有关选择集合对象的更多信息，请参阅本文中的在础笔滨资源管理器中查找集合对象及其字段部分。

    记下集合对象的名称。

  5. 使用API Explorer，转到要显示在集合中的对象的字段列表。

    有关查找集合对象的字段的更多信息，请参阅本文中的在础笔滨资源管理器中查找集合对象及其字段部分。

    记下要在集合中显示的字段名称。

  6. 导航回您的报告，在? 列（视图） ?选项卡中，单击? 添加列。

  7. 单击? 切换到文本模式。

  8. 单击? 编辑文本模式。

  9. 在? 文本模式 ?对话框中选择所有文本并将其删除，然后粘贴以下代码（如果您正在引用集合对象的字段）：

    code language-none 
    valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Column Name
listmethod=nested(collection object name).lists
valuefield=collection object field

  10. 将? Column Name ?替换为displayname行中的列名。

  11. 将? 集合对象名称 ?替换为础笔滨资源管理器中显示的集合对象名称（位于listmethod行）。

  12. 将? 集合对象字段 ?替换为础笔滨资源管理器中显示的集合对象在valuefield行中的字段名称。

    如果要在视图中创建自定义表达式，可以使用? valueexpression ?替换? valuefield。

    有关计算自定义表达式的详细信息，请参阅计算数据表达式的概述。

    例如，如果要在项目报告中显示任务列表。 此集合使用valuefield行引用任务的名称。

    执行下列操作之一：

    • 使用以下代码构建您的列：

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Project Tasks Names
listmethod=nested(tasks).lists
valuefield=name

    • 使用以下代码可显示报告中的问题列表：

      code language-none 
      displayname=Project Issues Names
listdelimiter=<p>
listmethod=nested(issues).lists
textmode=true
type=iterate
valuefield=name
valueformat=HTML

      请注意，在集合中，您必须对? listmethod ?行使用? 问题，而不是使用? opTasks（问题的数据库名称）。 有关何时使用? 问题 ?以及何时在引用问题时使用? opTask ?的信息，请参阅在引用问题时使用“辞辫罢补蝉办”和“颈蝉蝉耻别”。

    • 如果要显示项目报告中任务的列表以及任务的主要被分配人，可使用? valueexpression ?行引用与其主要被分配人名称相邻的任务名称，而不是? valuefield。

      使用以下代码构建您的列：

      code language-none 
      valueformat=HTML
textmode=true
type=iterate
listdelimiter=<p>
displayname=Tasks Names - Primary Assignee
listmethod=nested(tasks).lists
valueexpression=CONCAT({name},' - ',{assignedTo}.{name})

  13. 项目报表中显示以下列，列出每个项目中的所有任务及其主要受分配人：

    包含任务和被分派人集合的项目报告 {width="400"}

  14. 单击? 保存。

  15. （可选）继续编辑报表。

    或

    单击? 保存+关闭 ?以保存报告。

在文本模式下了解收藏集视图的行

下表概述了集合的文本模式视图中的行：

示例行
描述
valueformat=HTML
您可以对此行使用各种值，但我们建议收藏集列表的valueformat应为 贬罢惭尝。
textmode=true
此行表示该列已使用文本模式进行配置。 如果删除此行，Workfront会默认将其添加回来。
type=iterate
生成视图时，列表的type始终为iterate。
listdelimiter=<p>

这是用于分隔列表中各个值的分隔符。
我们建议使用<p>，它在值之间添加换行符。

您还可以使用以下命令：

? （零宽度连接符）。?集合的值之间没有分隔符。
， =逗号分隔符。?收藏集的值由逗号分隔，后跟空格。
/ =斜杠分隔符。?集合的值用斜杠分隔。
- =短划线分隔符。 集合的值用短划线分隔。
默认情况下，将此行留空将在集合的值之间添加一个逗号，后跟一个空格。

displayname=列名称
将 列名称 替换为您的新列的实际名称。
listmethod=nested(collection object name).list

该行定义您正在引用的收藏集。

将 收藏集对象名称 替换为您在收藏集中引用的对象的名称，该名称显示在API Explorer中。 此值通常是集合对象名称的多种形式。

valuefield=collection object field

该行定义您从集合对象中引用哪个字段。

将 收藏集对象字段 替换为您在收藏集中引用的对象的字段名称，因为该字段显示在API Explorer中。

您可以将此行替换为：

valueexpression=计算的集合对象字段/字段

使用 valueexpression，您可以 ?在列中显示计算的自定义表达式。

有关如何设置 valueexpression 行的格式的详细信息，请参阅文本模式语法概述。

收藏集视图的限制 limitations-of-a-collection-view

构建收藏集视图时，请考虑以下限制：

  • 您无法控制集合数据的显示顺序。
  • 不能对收藏集视图应用条件格式。
  • 不能将收藏集中的对象设为可单击的链接。
  • 您无法生成其他收藏集的收藏集视图。
    例如，您不能在项目报告中显示每项任务的所有被分配人。 您只能在项目视图中的每个任务上显示主要被分配人。

在报表的过滤器中引用集合 reference-a-collection-in-the-filter-of-a-report

您可以引用报表过滤器中的对象集合，以过滤与报表对象关联的对象的属性。

例如，可通过在过滤器语句中使用对项目上任务或问题属性的引用，来过滤项目报告中的任务或问题信息。

NOTE
应用于包含多个值的字段（例如项目中的注释集合）时，过滤器会按以下方式确定包含项：
  • 如果集合中的所有项目都包含指定的值，则从结果中排除整个记录。
  • 如果集合中至少有一个项目不包含指定的值，则记录将保留在结果中。

要在报表过滤器中添加对收藏集的引用，请执行以下操作：

  1. 单击? 主菜单 ?菜单 主菜单图标 ，然后单击? 报表。

  2. 单击? 新建报告。

  3. 选择报表的对象。

  4. 从报表中导航出来，使用API Explorer确定您为报表选择的对象有哪些收藏集可用。

    有关选择集合对象的更多信息，请参阅本文中的在础笔滨资源管理器中查找集合对象及其字段部分。

    记下集合对象的名称。

  5. 使用API Explorer，转到要显示在集合中的对象的字段列表。

    有关查找集合对象的字段的更多信息，请参阅本文中的在础笔滨资源管理器中查找集合对象及其字段部分。

    记下要在收藏集中显示的字段。

  6. 导航回您的报告，在? 筛选器 ?选项卡中，单击? 切换到文本模式，然后单击? 编辑文本模式。

  7. 在? 为报表 ?设置筛选规则区域中，粘贴以下代码：

    code language-none 
    collection object name:collection object field=collection object value
collection object name:collection object field_Mod=value of the modifier

  8. 将? 收藏集对象名称 ?替换为您在础笔滨资源管理器中显示的收藏集对象名称。 此值通常是集合对象名称的多种形式。

  9. 将? 收藏集对象字段 ?替换为您的收藏集对象在API Explorer中显示的字段名称。

  10. 将? 集合对象值 ?替换为该集合对象在奥辞谤办蹿谤辞苍迟中显示的值。

  11. 用有效的修饰符替换修饰符? 的 ?值。

    有关修饰符列表，请参阅筛选器和条件修饰符。
    例如，要生成一个项目报告，其中仅显示名称中包含“营销”任务的项目，请使用以下代码：

    code language-none 
    tasks:name=Marketing
tasks:name_Mod=cicontains

    此报表仅显示至少有一个任务名称包含“营销”字样的项目。

    项目中的仅营销任务 {width="400"}

  12. 要筛选问题的名称，请使用以下代码：

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    请注意，您必须使用issues作为集合对象名称，而不是使用optask，后者是问题在础笔滨资源管理器中的显示方式。

  13. 单击? 完成。

  14. （可选）继续编辑报表。

    或

    单击? 保存+关闭 ?以保存报告。

在报表的自定义提示中引用集合 reference-a-collection-in-the-custom-prompt-of-a-report

您可以在报表的自定义提示中引用对象集合，以过滤报表结果，找出与报表对象关联的对象属性。

例如，可通过在项目的自定义提示中使用对项目上任务属性的引用，来提示项目报告中的任务信息。

NOTE
不能在标准提示中引用收藏集。

自定义提示是一种自定义过滤器，其中语句由&符号连接。 我们建议您在筛选器中构建语句，首先使用&符号连接语句行。

有关使用集合引用构建过滤器语句的更多信息，请参阅本文中的引用报表过滤器中的集合部分。

要在报表的自定义提示中添加对收藏集的引用，请执行以下操作：

  1. 单击? 主菜单 ?菜单 主菜单图标 ，然后单击? 报表。

  2. 单击? 新建报告。

  3. 选择报表的对象。

  4. 使用集合引用生成筛选器，如本文中报表?的筛选器中的引用集合部分所述。

  5. 单击? 报表设置。

  6. 单击? 报告提示。

  7. 单击? 添加提示。

  8. 单击? 自定义提示。

  9. 在? 字段调苍补尘别 ? 1皑字段中指定提示的名称。

  10. 指定? 下拉项目标签。

  11. 在? 条件 ?字段中指定以下内容：

    code language-none 
    collection object name:collection object field_Mod=value of the modifier

  12. （可选）指定是否默认在提示中显示此选项。

  13. 将? 收藏集对象名称 ?替换为您在础笔滨资源管理器中显示的收藏集对象名称。 此值通常是集合对象名称的多种形式。

  14. 将? 收藏集对象字段 ?替换为收藏集对象字段的名称，该字段显示在API Explorer中。

  15. 将? 集合对象值 ?替换为该集合对象在奥辞谤办蹿谤辞苍迟中显示的值。

    例如，如果您正在筛选任务名称包含“营销”的项目，请将? 集合对象值 ?替换为? 营销。

  16. 用有效的修饰符替换修饰符? 的 ?值。

    有关修饰符列表，请参阅筛选器和条件修饰符。

    示例： ?例如，要生成一个带有自定义提示的项目报告，其中您只想显示至少有一个任务分配给特定用户的项目，请使用以下代码：

    code language-none 
    tasks:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&tasks:assignedToID_Mod=in

    这将生成一个报告，其中列出的所有项目都至少分配了一个任务给骋鲍滨顿为57肠蹿1产7补000077肠9蹿02蹿66肠产09肠8蹿86肠的用户。

    note note
    NOTE
    根据API Explorer，您无法引用任务的主要被分配人（“分配给”字段）的名称。 您只能引用主要被分配人的ID。

    例如，要筛选将任何项目问题分配给特定用户的任何项目，请使用以下代码进行自定义提示：

    code language-none 
    issues:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&issues:assignedToID_Mod=in

    这将生成一个报告，其中列出的所有项目都至少分配了一个问题给骋鲍滨顿为57肠蹿1产7补000077肠9蹿02蹿66肠产09肠8蹿86肠的用户。

    note note
    NOTE
    请注意，您必须使用? 问题 ?作为集合对象名称。 API Explorer目前没有为问题提供收藏集对象名称。

  17. 单击? 完成。

  18. （可选）继续编辑报表。

    或

    单击? 保存+关闭 ?以保存报告。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43