ドキュメントWorkfrontWorkfront ガイド

レポート内のコレクションの参照

Last update: Mon Jun 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー

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 では、オブジェクト間に次の 2 つの関係があります。

  • 1 対 1 の関係：1 つのオブジェクトは、一度に 1 つの他のオブジェクトにのみリンクできます。
    例えば、1 つのプロジェクトを一度に 1 つのポートフォリオにのみリンクできます。

  • 一対多の関係：1 つのオブジェクトは、一度に複数の他のオブジェクトにリンクできます。
    例えば、1 つのプロジェクトに複数のタスクを含めることができます。この場合、タスクのリストはプロジェクトのコレクションを生成します。

IMPORTANT
標準の Report Builder を使用して、オブジェクト間の 1 対 1 の関係を示すレポートを作成できます。ただし、Report Builder のテキストモードインターフェイスを使用して作成できるのは、オブジェクト間の 1 対多の関係を示すレポートのみです。

標準 Report Builder でのレポートの作成について詳しくは、カスタムレポートの作成を参照してください。

テキストモードインターフェイスを使用したレポートの作成について詳しくは、次を参照してください。

API エクスプローラーでのコレクションオブジェクトとそのフィールドの検索 find-collection-objects-and-their-fields-in-the-api-explorer

すべてのコレクションをレポートできるわけではありません。

どのオブジェクトを他のコレクションと関連付けることができるかについては、API エクスプローラーを使用する必要があります。
API エクスプローラーテーブルについて詳しくは、API エクスプローラーを参照してください。

レポートできるコレクションを確認するには、次の手順に従います。

  1. API エクスプローラーに移動します。

  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

レポートビューにコレクション列を追加 add-a-collection-column-in-a-report-view

レポートビューにコレクション列を追加するには、以下の手順を実行します。

  1. メイン ​メニュー 、「レポート」の順にクリックします。

  2. 「新規レポート」をクリックします。

  3. レポートのオブジェクトを選択します。

  4. レポートから移動して、API エクスプローラーを選択し、レポート用に選択したオブジェクトに対して使用できるコレクションを決定します。

    コレクションのオブジェクトの選択について詳しくは、この記事にある API エクスプローラーでコレクションオブジェクトとそのフィールドを検索の節を参照してください。
    コレクションのオブジェクトの名前をメモします。

  5. API エクスプローラーを使用して、コレクションに表示するオブジェクトのフィールドのリストに移動します。

    コレクションのオブジェクトのフィールドの検索について詳しくは、この記事にある API エクスプローラーでコレクションオブジェクトとそのフィールドを検索の節を参照してください。

    コレクションに表示するフィールドの名前をメモします。

  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. 列名 ​を、displayname 行の列の名前に置き換えます。

  11. コレクションオブジェクト名 ​を、API エクスプローラーに表示されている listmethod 行のコレクションオブジェクトの名前に置き換えます。

  12. コレクションオブジェクトフィールド ​を、API エクスプローラーに表示されている valuefield 行のコレクションオブジェクトフィールドの名前に置き換えます。

    ビューでカスタム式を作成する場合は、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

      コレクションでは、イシューのデータベース名である opTasks ではなく、listmethod 行に issues を使用する必要があることに注意してください。イシューを参照する際に issue を使用する場合と opTask を使用する場合について詳しくは、イシューを参照する際に「opTask」と「issue」を使用を参照してください。

    • プロジェクトレポート内のタスクのリストとそのプライマリ当者を表示する際に、プライマリ当者の名前の隣にあるタスクの名前を参照するには、valuefield の代わりに valueexpression 行を使用します。

      次のコードを使用して、列を作成します。

      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. 次の列は、プロジェクトレポートに表示され、各プロジェクトのすべてのタスクはプライマリ担当者と共に表示されます。

  14. 「保存」をクリックします。

  15. （オプション）レポートの編集を続けます。

    または

    「保存して閉じる」をクリックしてレポートを保存します。

テキストモードでコレクションビューの行について

コレクションのテキストモードビューの行についての概要を次の表に示します。

サンプルの行
説明
valueformat=HTML
この行には様々な値を使用できますが、コレクションリストの valueformat は HTML をお勧めします。
textmode=true
この行は、列がテキストモードを使用して設定されたことを示します。この行を削除すると、Workfront はデフォルトでその行を再び追加します。
type=iterate
ビュー作成時は、リストの type は常に iterate です。
listdelimiter=<p>

これは、リスト内の値を区切るために使用される区切り文字です。
値の間に改行を追加する <p> の使用をお勧めします。

また、次の機能も使用できます。

‍ （ゼロ幅の結合子）。コレクションの値は、それらの間に区切りはありません。
, =コンマ区切り。コレクションの値は、コンマで区切られ、スペースは含まれません。
/ =スラッシュ区切り。コレクションの値はスラッシュで区切られます。
- =ダッシュ区切り。コレクションの値はダッシュで区切られます。
この行を空のままにすると、デフォルトでは、コレクションの値の間にコンマとスペースが追加されます。

displayname=列名
列名 を新しい列の実際の名前に置き換えます。
listmethod=nested(collection object name).list

この行は、参照するコレクションを定義します。

API エクスプローラーに表示されるように、コレクションオブジェクト名 をコレクション内で参照するオブジェクトの名前に置き換えます。この値は、通常、コレクションオブジェクト名の複数形式です。

valuefield=collection object field

この行は、コレクションオブジェクトから参照するフィールドを定義します。

API エクスプローラーに表示されるように、コレクションオブジェクトフィールド をコレクション内で参照するオブジェクトのフィールドの名前に置き換えます。

この行を次に置き換えることができます。

valueexpression=計算済みコレクションオブジェクトフィールド

valueexpression を使用すると、計算済みカスタム式を列に表示できます。

valueexpression 行のフォーマット方法について詳しくは、テキストモードの構文の概要を参照してください。

コレクションビューの制限事項 limitations-of-a-collection-view

コレクションビューを作成する際は、次の制限事項を考慮してください。

  • コレクションデータの表示順序は変更できません。
  • コレクションビューには条件付き書式を適用できません。
  • コレクション内のオブジェクトをクリック可能なリンクにすることはできません。
  • 別のコレクションのコレクションビューは作成できません。
    例えば、各タスクのすべての担当者をプロジェクトレポートに表示することはできません。プライマリ担当者は、プロジェクトビューの各タスクに対してのみ表示できます。

レポートのフィルターでコレクションの参照 reference-a-collection-in-the-filter-of-a-report

レポートのフィルターでオブジェクトのコレクションを参照し、レポートのオブジェクトに関連付けられたオブジェクトの属性をフィルタリングできます。

例えば、フィルターステートメントでタスクの属性やプロジェクトのイシューを参照して、プロジェクトレポート内のタスクまたはイシューの情報をフィルタリングできます。

レポートフィルターでコレクションへの参照を追加するには、次の手順に従います。

  1. メイン ​メニュー をクリックし、次に「レポート」をクリックします。

  2. 「新規レポート」をクリックします。

  3. レポートのオブジェクトを選択します。

  4. レポートから移動して、API エクスプローラーを選択し、レポート用に選択したオブジェクトに対して使用できるコレクションを決定します。

    コレクションのオブジェクトの選択について詳しくは、この記事にある API エクスプローラーでコレクションオブジェクトとそのフィールドを検索の節を参照してください。

    コレクションのオブジェクトの名前をメモします。

  5. API エクスプローラーを使用して、コレクションに表示するオブジェクトのフィールドのリストに移動します。

    コレクションのオブジェクトのフィールドの検索について詳しくは、この記事にある API エクスプローラーでコレクションオブジェクトとそのフィールドを検索の節を参照してください。

    コレクションに表示するフィールドをメモします。

  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. コレクションオブジェクト名 ​を、API エクスプローラーに表示されているコレクションオブジェクトの名前に置き換えます。この値は、通常、コレクションオブジェクト名の複数形式です。

  9. コレクションオブジェクトフィールド ​を、API エクスプローラーに表示されているコレクションオブジェクトのフィールドの名前に置き換えます。

  10. コレクションオブジェクトの値 ​を、Workfront に表示されるコレクションオブジェクトの値に置き換えます。

  11. 修飾子の値 ​を有効な修飾子に置き換えます。

    修飾子のリストについて詳しくは、フィルターおよび条件修飾子を参照してください。
    例えば、名前に「マーケティング」が含まれるタスクのみを表示するプロジェクトレポートを作成するには、次のコードを使用します。

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

    このレポートには、名前に「マーケティング」という単語を含むタスクが 1 つ以上あるプロジェクトのみが表示されます。

  12. イシューの名前をフィルタリングするには、次のコードを使用します。

    code language-none 
    issues:name=Marketing
issues:name_Mod=cicontains
    note tip
    TIP
    コレクション オブジェクト名には、API エクスプローラーでイシューを表示する際に使用する optask ではなく、issues を使用する必要があることに注意してください。

  13. 「完了」をクリックします。

  14. （オプション）レポートの編集を続けます。

    または

    「保存して閉じる」をクリックしてレポートを保存します。

レポートのカスタムプロンプトでコレクションを参照 reference-a-collection-in-the-custom-prompt-of-a-report

レポートのカスタムプロンプトでオブジェクトのコレクションを参照して、レポートのオブジェクトに関連付けられたオブジェクトの属性についてレポートの結果をフィルタリングできます。

例えば、レポートのカスタムプロンプトでプロジェクトのタスクの属性への参照を使用することにより、プロジェクトレポートでタスク情報の入力を求めることができます。

NOTE
標準プロンプトでは、コレクションを参照できません。

カスタムプロンプトは、ステートメントがアンパサンド記号で結合されたカスタムフィルターです。まずフィルターでステートメントを作成し、アンパサンドを使用してステートメントの行を結合することをお勧めします。

コレクション参照を含むフィルターステートメントの作成について詳しくは、レポートのフィルターでコレクションを参照を参照してください。

レポートのカスタムプロンプトでコレクションへの参照を追加するには、以下のように行います。

  1. メイン ​メニュー 、「レポート」の順にクリックします。

  2. 「新規レポート」をクリックします。

  3. レポートのオブジェクトを選択します。

  4. この記事にあるレポートのフィルターでコレクションを参照の節の説明に従って、コレクション参照を含むフィルターを作成します。

  5. 「レポート設定」をクリックします。

  6. 「レポートのプロンプト」をクリックします。

  7. 「プロンプトを追加」をクリックします。

  8. 「カスタムプロンプト」をクリックします。

  9. 「フィールド ​ 名」フィールドでプロンプトの名前を指定します。

  10. ドロップダウン項目のラベル ​を指定します。

  11. 「状況」フィールドで以下を指定します。

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

  12. （オプション）この選択肢がデフォルトでプロンプトに表示されるかどうかを指定します。

  13. コレクションオブジェクト名 ​を、API エクスプローラーに表示されているコレクションオブジェクトの名前に置き換えます。この値は、通常、コレクションオブジェクト名の複数形です。

  14. コレクションオブジェクトフィールド ​を、API エクスプローラに表示されているコレクションオブジェクトのフィールドの名前に置き換えます。

  15. コレクションオブジェクトの値 ​を、Workfront に表示されるコレクションオブジェクトの値に置き換えます。

    例えば、タスク名に「マーケティング」が含まれるプロジェクトをフィルタリングする場合は、コレクションオブジェクトの値 ​を、マーケティング ​に置き換えます。

  16. 修飾子の値 ​を有効な修飾子に置き換えます。

    修飾子のリストについて詳しくは、フィルターおよび条件修飾子を参照してください。

    例： ​例えば、特定のユーザーに 1 つ以上のタスクが割り当てられているプロジェクトのみを表示するカスタムプロンプトを使用してプロジェクトレポートを作成するには、次のコードを使用します。

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

    これにより、GUID が 57cf1b7a000077c9f02f66cb09c8f86c のユーザーに割り当てられたタスクをリストされたすべてのプロジェクトに 1 つ以上含むレポートが生成されます。

    note note
    NOTE
    API エクスプローラーにあるように、タスクのプライマリ担当者（「割り当て先」フィールド）の名前を参照することはできません。参照できるのは、プライマリ担当者の ID のみです。

    例えば、プロジェクトのイシューによって特定のユーザーに割り当てられたプロジェクトをフィルタリングするには、次のコードをカスタムプロンプトに使用します。

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

    これにより、GUID が 57cf1b7a000077c9f02f66cb09c8f86c のユーザーに割り当てられたイシューをリストされたすべてのプロジェクトに 1 つ以上含むレポートが生成されます。

    note note
    NOTE
    コレクションオブジェクト名に​ イシュー ​を使用する必要があることに注意してください。現時点で、API エクスプローラーにイシューのコレクションオブジェクト名は用意されていません。

  17. 「完了」をクリックします。

  18. （オプション）レポートの編集を続けます。

    または

    「保存して閉じる」をクリックしてレポートを保存します。

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