テキストモード構文の概要
テキストモードのインタフェースを使用すると、リストおよびレポート内で、より複雑なビュー、フィルター、グループ化、およびカスタマイズされたプロンプトを作成できます。テキストモードを使用すると、標準モードのインターフェイスでは使用できないフィールドとその属性にアクセスできます。
テキストモード関する情報および開始前の考慮事項については、テキストモードの概要を参照してください。
すべてのレポート可能なフィールドとその属性の完全なリストについては、API エクスプローラーを参照してください。
テキストモードを使用したレポート(クラス、ビデオ、チュートリアルなど)の作成について詳しくは、Adobe Experience League サイトの「学習」セクションを参照してください。
テキストモードの構文に関する考慮事項
- テキストモードでレポート要素の作成を開始する前に、Adobe Workfront の構文を理解する必要があります。テキストモードの Workfront 構文は、このアプリケーションに固有のもので、その独特な特徴に慣れておく必要があります。
- レポートでテキストモードを使い始める前に、弊社の上級レポートクラスを受講し、テキストモード言語への理解を深めることを強くお勧めします。
- 標準モードのインターフェイスを使用して、ビュー、フィルターおよびグループ化をカスタマイズできます。ただし、カスタムプロンプトを作成するには、テキストモードを使用する必要があります。
テキストモードでのレポート要素の作成に関する一般的なガイドライン
テキストモードでレポートまたはリスト要素を作成する際の一般的なガイドラインを次に示します。
-
Workfront データベース内のオブジェクトや属性を参照する場合は、必ずキャメルケースを使用してください。
-
Workfront 内のオブジェクトの階層に注意してください。ビュー、フィルターおよびグループ化には、次のような違いがあります。
- レポートまたはリストオブジェクトから 3 つ離れたオブジェクトをビューに表示できます。
- グループ化、フィルターまたはカスタムプロンプトでは、メインオブジェクトから 2 つ以上離れたオブジェクトを参照することはできません。
例: ポートフォリオ所有者の名前または GUID をタスクビューに表示できます。
valuefield=project:portfolio:ownerID
タスクビューでポートフォリオ所有者のグループ化、フィルタリング、プロンプトの表示を行うことはできません。
project:portfolio:ownerID=5808f4bc00790b270a9629dd128e63fa
これらの例では、ポートフォリオ所有者 ID は、リストのオブジェクトから 3 つ離れたオブジェクトです。
Workfront のオブジェクトの階層について詳しくは、次を参照してください。
-
可能な限りワイルドカードを使用して、レポートやリストをより動的にし、異なるユーザーや類似するタイムラインで重複しないようにしてください。
キャメルケースの概要
Workfront フィールドまたはその属性をテキストモードで参照する場合、Workfront では、キャメルケースで名前を入力する必要があります。この場合、単一名フィールドのスペルは小文字になります。複合フィールドのスペルは、次のパターンに従います。
camelCaseSyntax
キャメルケースの特徴は次のとおりです。
- 最初の単語は、常に小文字で始まります。
- 後続の単語は、常に大文字で始まります。
- 単語の間にスペースはありません。
例: プロジェクトの実際の完了日を参照する場合、テキストモードのレポート要素の作成時に使用するフィールドの名前は次のようになります。
actualCompletionDate
様々なレポート要素のテキストモード構文
テキストモードを使用してレポート要素を作成する場合、以下に示す一連のレポート要素の構文の間には、次のような類似点があります。
-
ビューとグループ化では、コードと構文の行は似ています。
テキストモードで作成する場合の、ビューとグループ化のコードの主要な行について詳しくは、次を参照してください。
-
フィルターとカスタムプロンプトでは、コードと構文の行は似ています。
詳しくは、以下を参照してください。
ビューとグループ化の構文
ビューとグループ化を作成する際のコード行は似ています。
ビューおよびグループの作成について詳しくは、以下の記事を参照してください。
ビューやグループ化の最も重要なコード行は、ビューの列やグループ化で参照されるオブジェクトを識別する行です。このフィールドが Workfront データベースフィールドへの直接参照であるか、複数のフィールド間の計算であるかによって、このコード行は valuefield
か valueexpression
で始る可能性があります。
次の表に、ビューやグループ化で最も一般的なコード行を示します。
valuefield
valueexpression
valueformat
width
stretch
-
以下の例のコード行はビューとグループの間で似ていますが、グループ化のコードの各行はグループ化番号で始まることを常に念頭に置いてください。
プロジェクトリストまたはレポートでプロジェクト名でグループ化するには、第 1 層グループに対して次の行を使用します。
group.0.valuefield=name
-
ビュー内の複数の列を同じ列で編集する場合(共有列の場合と同様)、各列のコードのそれぞれの行は列番号で始まることを念頭に置いてください。
ビューの最初の列を識別するには、次の形式を使用します。
column.0.valuefield=name
列の共有について詳しくは、ビュー:複数の列の情報を 1 つの共有列に結合を参照してください。
ビューとグループ化の Valuefield
構文の概要
Valuefield=
は、ビューとグループ化で、直接参照するオブジェクトを識別する重要なコード行です。
フィールドを直接参照する構文は、グループ化とビューで同じです。
次のルールは、valuefield
行を使用して Workfront オブジェクトを参照する場合に適用されます。
-
フィールドを直接参照するには、キャメルケースを使用します。
例: タスクビューでタスクの実際の完了日を参照するには、次の行を使用します。
valuefield=actualCompletionDate
-
キャメルケースとコロンを使用して、同じオブジェクトに関して互いに関連するフィールドを区切ります。
例: タスクビューでプロジェクト予定完了日を参照するには、次の行を使用します。
valuefield=project:plannedCompletionDate
Workfront データベース内でオブジェクトが相互に参照する方法について詳しくは、API エクスプローラーを参照してください。
-
カスタムフィールドを参照する場合は、インターフェイスに表示されるとおりのフィールドの名前を使用します。
例: タスクビューでその他の詳細というラベルの付いたプロジェクトカスタムフィールドを参照するには、次の行を使用します。
valuefield=project:Additional Details
ビューとグループ化の Valueexpression
構文の概要
2 つ以上のフィールド間の計算を参照する場合は、テキストモードでビューとグループを作成する際に、コードの valuefield=
行を valueexpression=
に置き換えることができます。
計算済みグループ化を作成する方法は、ビューで計算済み列を作成する方法と似ています。
次のルールは、valueexpression
行を使用して Workfront オブジェクトを参照する場合に適用されます。
-
フィールドを直接参照し、それぞれのフィールドを中括弧で囲むには、キャメルケースを使用します。
例:
valueexpression
を使用してタスク列にタスク名フィールドを表示するには、次の行を使用します。valueexpression={name}
-
キャメルケースとピリオドを使用して、互いに関連するフィールドを区切ります。
例: タスクレポートでタスク名と連結されたプロジェクト名を表示するには、次の行を使用します。
-
ビューでは、次のようになります。
valueexpression=CONCAT({project}.{name},' - ',{name})
-
グループ内では、次のようになります。
group.0.valueexpression=CONCAT({project}.{name},' - ',{name})
Workfront データベース内でオブジェクトが相互に参照する方法について詳しくは、API エクスプローラーを参照してください。
-
-
カスタムフィールドを参照する場合は、次のルールを使用します。
- インターフェイスに表示されるとおりのフィールドの名前を使用します。
- フィールドの名前の前に「DE:」を付けます。
- フィールドを中括弧で囲みます。
- オブジェクトに関連するフィールドはピリオドで区切ります。
例: 追加の詳細プロジェクトのカスタムフィールドをタスクビューの valueexpression 行に表示するには、次の行を使用します。
valueexpression={project}.{DE:Additional Details}
-
ワイルドカードは、
valueexpression
では使用できますが、valuefield
行では使用できません。ワイルドカードについて詳しくは、ワイルドカードフィルターの概要を参照してください。
ビューとグループ化の Valueformat
の概要
ビューまたはグループ化で 2 番目に重要なコード行は、valueformat=
行です。これは、valuefield
行または valueexpression
行で指定した値をどのような形式で返すかを Workfront に指示します。valueformat
行には様々な形式を使用できますが、valueexpression
を使用する際は常に次の値を使用することをお勧めします。
valueformat=HTML
追加の valueformat
の値については、次の記事も参照してください。
ビューの width
の概要
width=
は、各列の幅をピクセル単位で指定できるコード行です。Workfront には、各フィールドの推奨幅が用意されていますが、 フィールドのタイプや形式に応じて、調整を行うこともできます。
追加の usewidths=true
コード行を使用して、列に指定された幅を強制する必要があります。
例: 幅が 80 ピクセルの列を表示するには、次の行を使用します。
width=80
usewidths=true
ビューの stretch
の概要
stretch
は、ビューで不要なスペースを占める列を識別するために使用されます。一般的なユーザーのワークスペースのユーザーインターフェイスの幅は、約 850 ピクセルです。つまり、ビューに 4 つの列(各 150 ピクセル)があり、そのビューが 850 ピクセルのうち 600 ピクセルを占有している場合です。UI には、伸縮率が指定された列に追加される、250 個の追加のピクセルがあります。
ビュー内の少なくとも 1 つの列に対して追加のコード行 usewidths=true
を使用すると、列の伸縮が適用されます。
例: 列がビュー内の空白スペースの 70%を使用できることを示すには、次の行を使用します。
stretch=70
usewidths=true
フィルターとカスタムプロンプトの構文
フィルターを作成する構文は、カスタムプロンプトを作成する構文と似ています。
フィルターとカスタムプロンプトの作成について詳しくは、次を参照してください。
テキストモードでのフィルターの作成について詳しくは、テキストモードを使用したフィルターの編集を参照してください。
次の要素を使用して、フィルターとカスタムプロンプトをテキストモードで作成できます。
-
フィルターステートメントのオブジェクトを参照するコード行。フィルターオブジェクトにはキャメルケースを使用します。
-
フィルターオブジェクトと、フィルターオブジェクトの値の修飾子を参照するコード行。この行のフィルターオブジェクトにはキャメルケースを使用します。
note tip TIP 範囲を参照する場合は、2 つの修飾子行が必要です。 -
複数のフィルターステートメントを接続するステートメントコネクタ:
-
および
これは、フィルターステートメント間のデフォルトのコネクタです。
-
または
note tip TIP ステートメントコネクタでは大文字と小文字が区別され、常に大文字が使用されます。「AND」は、テキストモードでは省略できます。
-
-
フィルターをより動的にし、現在の時刻やログインしているユーザーに合わせてカスタマイズするワイルドカード。ワイルドカードについて詳しくは、ワイルドカードフィルター変数の概要を参照してください。