報表中的參考集合
在Adobe Workfront中建立報表可讓您以清單、格線或圖表格式顯示一組物件、其個別欄位或連結物件。
如需在Workfront中建立報表的詳細資訊，請參閱建立自訂報表。
存取需求
您必須具有下列存取權才能執行本文中的步驟：
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront計畫* | 任何 |
| Adobe Workfront授權* | 計劃 |
| 存取層級設定* |
編輯對篩選器、檢視、群組的存取權 編輯報告、儀表板、行事曆的存取權 注意：如果您還是沒有存取權，請詢問您的Workfront管理員，他們是否在您的存取層級中設定其他限制。 如需Workfront管理員如何修改存取層級的詳細資訊，請參閱建立或修改自訂存取層級。 |
| 物件許可權 |
管理報表的許可權 管理檢視、篩選或分組的許可權 如需請求其他存取權的資訊，請參閱請求物件的存取權。 |
若要瞭解您擁有的計畫、授權型別或存取權，請聯絡您的Workfront管理員。
瞭解集合
集合是連結至其他物件的物件清單。
Workfront中的物件之間有下列兩種關係：
-
一對一的關係：一個物件一次只能連結到另一個物件。
例如，一個專案一次只能連結到一個投資組合。 -
一對多關係：一個物件可以一次連結到多個其他物件。
例如，一個專案可以有多個任務。 在這種情況下，任務清單會形成專案的集合。
如需在標準Report Builder中建立報表的詳細資訊，請參閱建立自訂報表。
如需使用文字模式介面建立報表的詳細資訊，請參閱：
在API Explorer中尋找集合物件及其欄位 find-collection-objects-and-their-fields-in-the-api-explorer
並非所有集合都可以報告。
若要瞭解哪些物件可以與其他的集合相關聯，您必須使用API Explorer。
如需API總管表格的詳細資訊，請參閱API總管。
若要瞭解可報告哪些集合：
-
移至API總管。
-
尋找報表的物件。
-
選取 集合 索引標籤。
note note NOTE 只有此標籤上列出的物件才能在報表中表示為您所選物件的集合。 -
按一下收藏集的物件以將其展開。
-
按一下顯示的連結，移至集合的物件。
這會開啟集合物件的 欄位 標籤。note note NOTE 只有此標籤上列出的欄位才能在集合報表中引用，或是與物件相關聯的欄位列在此標籤上。
報表中的參考集合
您可以在下列報表元素中參照集合中的物件：
- 檢視
- 篩選器
- 提示
您無法在下列報表元素中參照集合中的物件：
- 群組
- 圖表
例如，您可以從專案報告參考任務或問題集合，以在專案層級顯示任務或問題資訊。
在報表檢視中參考集合 reference-a-collection-in-the-view-of-a-report
您可以參照報表檢視中的物件集合，以顯示與報表物件相關聯的物件屬性。
例如，您可以在專案報告中顯示任務或問題資訊，方法是在報告檢視中建立任務或問題的收集欄。
您可以在集合檢視中顯示任務或問題的相關資訊，例如名稱、日期、主要受指派人、完成百分比等。
檢視以清單格式顯示任務或問題資訊，清單的每一行代表任務或問題的相關資訊。 任務或問題清單及其欄位會出現在與任務或問題所屬專案相同的行上。
在報表檢視中新增集合欄 add-a-collection-column-in-a-report-view
若要在報表檢視中新增集合欄：
-
按一下 主要 功能表
-
按一下 新報告。
-
選取報表的物件。
-
離開您的報告，使用API Explorer決定您為報告選取的物件有哪些可用的集合。
如需有關選取集合物件的詳細資訊，請參閱本文章的尋找集合物件及其在API總管中的欄位。
記下集合的物件名稱。 -
使用API Explorer，前往您要顯示在集合中的物件欄位清單。
如需尋找集合物件欄位的詳細資訊，請參閱本文章的尋找集合物件及其在API總管中的欄位。
記下您要在集合中顯示的欄位名稱。
-
導覽回您的報告，然後在 欄（檢視） 索引標籤中按一下 新增欄。
-
按一下 切換到文字模式。
-
將滑鼠移到對話方塊上，然後按一下 按一下以編輯文字。
-
在 文字模式 對話方塊中選取所有文字並將其移除，然後如果您參照的是集合物件的欄位，請貼上下列程式碼：
code language-none valueformat=HTML textmode=true type=iterate listdelimiter=<p> displayname=Column Name listmethod=nested(collection object name).lists valuefield=collection object field -
將 資料行名稱 取代為
displayname行中的資料行名稱。 -
將 集合物件名稱 取代為您在
listmethod行中的集合物件名稱，因為它出現在API Explorer中。 -
將 集合物件欄位 取代為您在
valuefield行中的集合物件欄位名稱，因為它出現在API Explorer中。如果您要在檢視中建立自訂運算式，可以將 valuefield 取代為 valueexpression。
如需有關計算自訂運算式的詳細資訊，請參閱計算資料運算式概觀。
例如，如果您想在專案報告中顯示任務清單。 此集合使用
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 的資訊，請參閱在參考問題時使用"opTask"和"issue"。
-
如果您想要在專案報告中顯示任務清單及其主要受指派人，您可以使用 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})
-
-
以下欄會顯示在專案報告中，列出每個專案中的所有任務及其主要受指派人：
-
按一下「儲存」。
-
（選用）繼續編輯報表。
或
按一下 儲存+關閉 以儲存報告。
瞭解文字模式中集合檢視的行
下表列出集合的文字模式檢視中的行：
valueformat=HTMLvalueformat應為 HTML。textmode=truetype=iteratetype一律為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
您可以參照報表篩選中的物件集合，以篩選與報表物件關聯的物件屬性。
例如，您可以在篩選陳述式中使用專案上任務或問題屬性的參照，來篩選專案報告中的任務或問題資訊。
若要在報表篩選器中新增集合的參考：
-
按一下 主要 功能表
-
按一下 新報告。
-
選取報表的物件。
-
離開您的報告，使用API Explorer決定您為報告選取的物件有哪些可用的集合。
如需有關選取集合物件的詳細資訊，請參閱本文章的尋找集合物件及其在API總管中的欄位。
記下集合的物件名稱。
-
使用API Explorer，前往您要顯示在集合中的物件欄位清單。
如需尋找集合物件欄位的詳細資訊，請參閱本文章的尋找集合物件及其在API總管中的欄位。
記下您要在集合中顯示的欄位。
-
導覽回您的報告，在 篩選器 索引標籤中，按一下 切換至文字模式。
-
在 設定報表 的篩選規則區域中，貼上下列程式碼：
code language-none collection object name:collection object field=collection object value collection object name:collection object field_Mod=value of the modifier -
將 集合物件名稱 取代為您在API Explorer中顯示的集合物件名稱。 此值通常是集合物件名稱的多種形式。
-
將 集合物件欄位 取代為您在API Explorer中顯示的集合物件欄位名稱。
-
以Workfront中顯示的集合物件值取代 集合物件值。
-
以有效的修飾元取代修飾元 的 值。
如需修飾元清單，請參閱篩選和條件修飾元。
例如，若要建置僅顯示名稱中有「行銷」之任務的專案的專案報告，請使用下列程式碼：code language-none tasks:name=Marketing tasks:name_Mod=cicontains此報表只會顯示至少一項任務名稱中有「行銷」字樣的專案。
-
若要篩選問題的名稱，請使用下列程式碼：
code language-none issues:name=Marketing issues:name_Mod=cicontainsnote tip TIP 請注意，您必須使用 issues作為集合物件名稱，而不是使用optask，問題在API Explorer中的顯示方式。 -
按一下 完成。
-
（選用）繼續編輯報表。
或
按一下 儲存+關閉 以儲存報告。
在報表的自訂提示中參考集合 reference-a-collection-in-the-custom-prompt-of-a-report
您可以在報表的自訂提示中參照物件集合，以篩選報表結果，找出與報表物件關聯的物件屬性。
例如，您可以在專案報告中使用專案上任務屬性的參照，在報告的自訂提示中提示任務資訊。
自訂提示是一種自訂篩選器，其中陳述式由&符號聯結。 建議您先在篩選器中建立陳述式，然後使用&符號聯結陳述式的各行。
如需有關使用集合參考建立篩選陳述式的詳細資訊，請參閱本文中的參考報表篩選中的集合小節。
若要在報表的自訂提示中新增集合的參考：
-
按一下 主要 功能表
-
按一下 新報告。
-
選取報表的物件。
-
使用集合參考建立篩選器，如本文中參考報表的篩選器中的集合一節所述。
-
按一下 報表設定。
-
按一下 報告提示。
-
按一下 新增提示。
-
按一下 自訂提示。
-
在 欄位 名稱 欄位中指定提示的名稱。
-
指定 下拉式清單專案標籤。
-
在 條件 欄位中指定下列專案：
code language-none collection object name:collection object field_Mod=value of the modifier -
（選擇性）指定此選擇是否預設顯示在提示中。
-
將 集合物件名稱 取代為您在API Explorer中顯示的集合物件名稱。 此值通常是集合物件名稱的多種形式。
-
將 集合物件欄位 取代為您集合物件之欄位的名稱，因為它出現在API Explorer中。
-
以Workfront中顯示的集合物件值取代 集合物件值。
例如，如果您正在篩選工作名稱包含「行銷」的專案，請將 集合物件值 取代為 行銷。
-
以有效的修飾元取代修飾元 的 值。
如需修飾元的清單，請參閱 篩選和條件修飾元。
範例： 例如，若要使用自訂提示建立專案報告，其中您只想顯示至少有一個指派給特定使用者的專案，請使用下列程式碼：
code language-none tasks:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&tasks:assignedToID_Mod=in這會產生一個報表，其中列出的所有專案都至少指派了一個任務給GUID為57cf1b7a000077c9f02f66cb09c8f86c的使用者。
note note NOTE 根據API總管，您無法參考任務的主要受指派人（「受指派人」欄位）的名稱。 您只能參考主要受指派人的ID。 例如，若要篩選將任何專案問題指派給特定使用者的任何專案，請使用以下程式碼作為自訂提示：
code language-none issues:assignedToID=57cf1b7a000077c9f02f66cb09c8f86c&issues:assignedToID_Mod=in這會產生一份報告，其中列出的所有專案都至少有一個問題指派給GUID為57cf1b7a000077c9f02f66cb09c8f86c的使用者。
note note NOTE 請注意，您必須使用 問題 作為集合物件名稱。 API總管 目前未提供問題的集合物件名稱。 -
按一下 完成。
-
（選用）繼續編輯報表。
或
按一下 儲存+關閉 以儲存報告。