レガシーフォームビルダーを使用した計算データのカスタムフォームへの追加
カスタムフォームでは、カスタムフォームがオブジェクトに添付される際に、既存のデータを使用して新しいデータを生成する計算済みカスタムフィールドを追加できます。
これを行うには、データ式と既存のフィールドの名前を使用するステートメントを作成します。このステートメントには、カスタムフィールド、計算カスタムデータフィールド、組み込み Adobe Workfront フィールドを使用できます。
このステートメントは、入力したデータを計算し、新しい計算カスタムフィールドに結果を表示します。
計算済みカスタムフィールドには、次の値を含めることができます。
-
単一の組み込みフィールドへのシンプルな参照。
note info INFO 例： プロジェクトとタスクによって生成された収益を計算するには、組み込みフィールド「実収益」を含む計算カスタムフィールドを作成できます。誰かがカスタムフォームをプロジェクトまたはタスクに添付すると、プロジェクトまたはタスクの収益がフィールドに表示されます。 -
1 つ以上のフィールドを参照する式。これには、カスタムフィールド、その他の計算済みカスタムフィールド、組み込みフィールドを指定できます。
note info INFO 例： プロジェクトやタスクによって生成される利益を計算するには、収益からコストを差し引く数式を含む「利益」という計算済みカスタムフィールドを作成できます。 これを行うには、組み込みの Workfront フィールド、「実際のコスト」と「実収益」）で数式 SUB（減算）を使用できます。 以下の手順で、この例の実行方法を確認できます。
組織のカスタムフォームの作成と、それらに関連付けることができるフィールドのタイプについて詳しくは、カスタムフォームの作成または編集を参照してください。
アクセス要件
この記事の手順を実行するには、以下を保有している必要があります。
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront プラン | 任意 |
| Adobe Workfront プラン* |
現在：プラン または 新規：標準 |
| アクセスレベル設定 | カスタムフォームへの管理アクセス権 |
*ご利用のプラン、ライセンスタイプまたはアクセスレベル設定を確認するには、Workfront 管理者にお問い合わせください。アクセス要件については、Workfront ドキュメントのアクセス要件を参照してください。
カスタムフォームに計算フィールドを追加 add-a-calculated-field-to-a-custom-form
組み込みの Workfront フィールドと、計算カスタムフィールドの式で作成済みのカスタムフィールドの両方を使用できます。
-
カスタムフォームの作成または編集の説明に従って、カスタムフォームの作成または編集を開始します。
-
「フィールドを追加」タブで、「計算済み」クリックします。
右側の表示エリアで、フィールドに入力値 12345 が表示されます。これは、カスタムフォームの作成中または編集中に、そのフィールドが計算カスタムフィールドであることを示す単なるインジケーターです。フォームがオブジェクトに添付され、ユーザーがフォームに入力すると、フィールドには 12345 の値ではなく計算結果が表示されます。
-
計算フィールドには次の情報を指定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header ラベル フィールドのラベルを入力します。これは、ユーザーがカスタムフォームを使用する際に表示される情報です。フィールドの 名前 は、自動的に入力され、ラベルと一致し、Workfront によってレポートで参照されます。必須フィールドです。 名前 デフォルトでは、フィールドの名前はラベルと同じです。ただし、フィールドの名前を変更して、フィールドのラベルとは異なる名前にすることができます。フィールドの 名前 は、Workfront によってレポートで参照されます。必須フィールドです。 手順 テキストを追加して、フィールドおよびその中の数式に関する追加情報を入力できます。
また、カスタムフィールドの計算に使用する数式をここに貼り付けることもできます。この場合、まずカスタムフィールドの計算を更新し、次に「計算」フィールドから最終式をコピーして、「手順」フィールドに貼り付けることをお勧めします。
これは、次の方法で役立ちます。
-
数式の内容と仕組みを確認するために使用します。これは、複数のフォームでこの計算カスタムフィールドを使用する予定がある場合に特に便利です。
-
フィールドにポインタを合わせると、ツールチップとして表示されます。ツールヒントに表示したいテキストをここに追加できます。
ユーザーが混乱する可能性があるため、ツールチップに数式が表示されないようにしたい場合は、「手順」フィールドに追加しないでください。代わりに、「手順に数式を表示する」設定を使用して、数式の表示と非表示を切り替えます。詳しくは、この記事の計算済みカスタムフィールドの計算を作成を参照してください。
新しいフォームで既存の計算カスタムフィールドを使用する方法について詳しくは、カスタムフォームでの既存の計算カスタムフィールドの再利用を参照してください。
形式 フィールドの結果を保存および表示する形式です。
フィールドを数学計算で使用する場合は、常に 数字 または 通貨 形式を使用してください。「数値」または「通貨」を選択すると、0 から始まる数値が自動的に切り捨てられます。
重要：
形式を選択する前に、新しいフィールドに適した形式を検討してください。カスタムフォームを保存した後は、形式フィールドを編集できません。また、誤った形式を選択すると、今後の計算や集計値がレポートやリストのグループ化に影響を受ける可能性があります。
メモ： 通貨形式の計算フィールドには引用符を含めないでください。例えば、"800.00" ではなく、800.00 を使用してください。引用符を使用すると、通貨タイプの言語形式の微妙な違いにより、予期しない結果が生じる可能性があります。
-
-
引き続き、カスタムフィールドの情報を更新します。詳しくは、この記事の計算カスタムフィールドの計算を作成の節を参照してください。
計算カスタムフィールドの計算を作成 build-the-calculation-for-your-calculated-custom-field
-
計算カスタムフィールドの作成を開始します。詳しくは、この記事のカスタムフォームに計算フィールドを追加の節を参照してください。
-
最大化 をクリックして 計算エディター を開き、計算を作成します。
note info INFO 例： この記事の冒頭の例を使用すると、プロジェクトとタスクのカスタムフォームに「利益」という名前の計算カスタムフィールドを作成できます。このフィールドには、実収益と実際のコストの差を表示する計算を含めることができます。 SUB({actualRevenue},{actualCost})この例では、 SUB式であり、参照されるフィールドがactualRevenueとactualCostです。計算は、通常、式で始まり、カスタムフォームがオブジェクトに添付される際に参照するフィールドを含む括弧が続きます。使用可能な式について詳しくは、計算データ式の概要を参照してください。
それぞれのフィールドを中括弧で囲む必要があります。詳しくは、この記事のセクション計算カスタムフィールドに必要な構文を参照してください。フィールドの名前を入力し始めると、候補が表示されるので、選択して計算に挿入できます。
note note NOTE 計算では、次のタイプのフィールドを参照できません。 - 書式付きテキストフィールド
- 説明テキスト
カスタムフィールドのタイプについて詳しくは、カスタムフォームにカスタムフィールドを追加を参照してください。 -
「計算エディター」ボックスの大きなテキストボックスをクリックし、「検索」または「展開」をクリックして、そのテキストボックスの右にある「式 と フィールド」セクションのオプションをクリックします。これにより、計算に追加されます。
また、大きいテキストボックスに式やフィールドを入力し、表示されたときに選択することもできます。各項目には、フィールドには「F」、式には「E」が表示されます。
開き丸括弧を入力すると、閉じ丸括弧が自動的に追加されます。
note tip TIP 次のいずれかの操作を実行して、計算に関するヘルプを確認することができます。 - 計算の式にカーソルを合わせると、説明、その式の使用方法を示す例、および記事計算データ式の概要の詳細情報への「詳細情報」リンクが表示されます。
- 追加したコンポーネントを識別するには、色分けを使用します。式は青色で表示され、フィールドは緑色で表示されます。
- 計算エラーを見つけます。計算エラーはピンク色で強調表示されます。強調表示されたエラーの上にポインタを合わせると、その原因に関する簡単な説明が表示されます。
- 計算の下の 既存のオブジェクトのプレビュー エリアで、Workfront オブジェクトの名前を入力し、リストに表示されたら選択します。これにより、フォームがオブジェクトに添付されたときに、フィールドがどのように表示されるかをプレビューできます。
- 左側に表示される行番号を使用して、長い計算で式を参照します。
- 計算の式にカーソルを合わせると、説明、その式の使用方法を示す例、および記事計算データ式の概要の詳細情報への「詳細情報」リンクが表示されます。
-
計算カスタムフィールドの計算を完了したら、「最小化」をクリックします。
note note NOTE 右側の表示エリアで、フィールドに入力値 12345 が表示されます。これは、カスタムフォームの作成中または編集中に、そのフィールドが計算カスタムフィールドであることを示す単なるインジケーターです。フォームがオブジェクトに添付され、ユーザーがフォームに入力すると、フィールドには 12345 の値ではなく計算結果が表示されます。 -
（オプション）次のいずれかのオプションを使用して、計算カスタムフィールドをさらに設定します。
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header ロジックを追加 ユーザーがフォームの入力時に、直前の複数選択肢フィールド（ドロップダウン、チェックボックス、ラジオボタン）で 1 つ以上選択した場合に、表示ロジックを追加して、計算フィールドを表示するかどうかを決定できます。詳しくは、表示ロジックの追加とカスタムフォームへのロジックのスキップを参照してください。
これは、フォーム上の計算カスタムフィールドの前に、1 つ以上のチェックボックス、ラジオボタン、ドロップダウンフィールドがある場合にのみ使用できます。
計算カスタムフィールドにはスキップロジックを使用できません。
以前の計算を更新 既存の計算カスタムフィールドの編集時にこのオプションを選択して、カスタムフォームを保存するときに計算の更新をトリガーできます。これは、カスタムフォームを保存するときに 1 回だけ発生します。その後、このオプションは無効状態に戻ります。 手順に式を表示する カスタムフォームに入力するユーザーがフィールドにポインタを合わせたときに、そのフィールドの数式を表示する場合は、このオプションを有効のままにします。詳しくは、この表の前半にある説明を参照してください。 -
計算カスタムフィールドの変更がすべて完了したら、「完了」をクリックします。
カスタムフィールドのフォームへの追加を続行する場合は、「適用」をクリックして、これまでの変更をフォームに適用します。
または、カスタムフォームですべての変更が完了したら、「保存して閉じる」をクリックします。
-
計算カスタムフィールドが正しく機能することを確かめるには、カスタムフォームをオブジェクトに添付し、計算カスタムフィールドの結果を確認します。
カスタムフォームを添付する手順については、オブジェクトへのカスタムフォームの追加を参照してください。
他の方法でカスタムフォームの作成を続ける場合は、次のいずれかの記事に進んでください。
計算カスタムフィールドで必要な構文
カスタム計算フィールドで使用される各フィールドは、以下に説明する構文を使用する必要があります。各フィールド名を中括弧で囲みます。フィールドの名前を入力し始めると、候補が表示されるので、選択して計算に挿入できます。計算に誤ったデータを入力すると、警告メッセージが表示されます。有効なフィールドと有効な計算式を含むように計算式を編集しない限り、フォームを保存できません。
フィールド名を中括弧で囲む
- 計算で組み込みフィールドを参照する場合は、フィールド名を中括弧で囲み、Workfront データベースに表示される形式にする必要があります。Workfront インターフェイスに表示されるフィールドの名前は使用できません。
例：{actualRevenue}
フィールド名では大文字と小文字が区別され、Workfront システムでの表示と同じように、キャメルケース形式で表示する必要があります。
- 計算でカスタムフィールドを参照する場合は、フィールド名の前に
DE:を付けて、全体を中括弧で囲みます。カスタムフィールドでは大文字と小文字が区別され、Workfront インターフェイスで表示される形式にする必要があります。
例：{DE:Profit}
DE: を入力すると、選択できるすべてのカスタムフィールドが一覧表示されます。
-
カスタムフォームがオブジェクトに接続されているときに親オブジェクトからデータを取得するフィールドを計算で参照する場合は、フィールド名の前および中括弧内に親オブジェクトのオブジェクトタイプを付ける必要があります。
例えば、タスクを使用するようにカスタムフォームを設定し、フォームがタスクに添付されたときにフィールドで親オブジェクトの実収益を計算する場合は、次のように
projectをフィールドのオブジェクトタイプとして指定する必要があります。{project}.{actualRevenue}また、カスタムフィールドの場合は、次のようになります。
{project}.{DE:profit}カスタムフォームが複数のオブジェクトタイプに対して設定されているので親オブジェクトのオブジェクトタイプが不明な場合は、ワイルドカードフィルター変数
$$OBJCODEを使用して、可能性のあるタイプごとに計算が正常に行われるようにすることができます。詳しくは、この記事の複数オブジェクトのカスタムフォームの計算カスタムフィールドを参照してください。
項目をピリオドで区切る
計算カスタムフィールドで関連オブジェクトを参照する場合は、オブジェクト名と属性をピリオドで区切る必要があります。
例えば、タスクタイプのカスタムフォームで、計算カスタムフィールドにポートフォリオ所有者の名前を表示するには、次のように入力します。
{project}.{porfolio}.{owner}
このシステムでは、次の手順（この順序）で情報を取得します。
- カスタムフォームのオブジェクト（タスク）から、
- タスクの親または別の関連オブジェクト（プロジェクト）にアクセスし、
- 親またはプロジェクトの別の関連オブジェクト（ポートフォリオ）にアクセスし、
- ポートフォリオに関連する次のオブジェクト（ポートフォリオの所有者）にアクセスします。
カスタムフィールドを参照するための名前構文
計算カスタムフィールドで別のカスタムフィールドを参照する場合は、Workfront インターフェイスに表示されるフィールドの名前を入力する必要があります。
例えば、「エグゼクティブスポンサー」というラベルの付いたカスタムフィールドで選択したオプションを参照するには、次のように入力します。
{DE:Executive sponsor}
:name を追加する必要があるため、他のタイプのフィールドの構文とは異なります。{DE:Executive sponsor:name}複数オブジェクトのカスタムフォームの計算カスタムフィールド calculated-custom-fields-in-multi-object-custom-forms
複数オブジェクトのカスタムフォームでは、選択したオブジェクトタイプが、フォームの計算カスタムフィールドで参照されているすべてのフィールドと互換性を持っている必要があります。互換性がない場合は、調整を行うように警告するメッセージが表示されます。
{assignedTo}.{name}この場合、以下のいずれかを行えます。
- カスタムフォームから互換性のない 2 つのアイテム（オブジェクトタイプまたは参照先の計算カスタムフィールド）のうち 1 つを削除します。
- 両方のアイテムを保持し、ワイルドカードフィルター変数
$$OBJCODEを IF 式の条件として使用して、In Charge フィールドの 2 つの異なるバージョンを作成します。これにより、フォームが添付されているオブジェクトのタイプに関係なく、フィールドが正常に機能します。
$$OBJCODE を使用して、カスタムフォームがプロジェクトに添付されている場合は「所有者」フィールドを参照でき、フォームがタスクに添付されている場合は「割り当て先：名前」フィールドを参照できます。IF($$OBJCODE="PROJ",{owner}.{name},{assignedTo}.{name})$$OBJCODE, のような変数について詳しくは、ワイルドカードフィルター変数の概要を参照してください。
計算カスタムフィールドの自動更新
オブジェクトの計算カスタムフィールドは、次の場合に自動的に再計算します。
-
日次のタイムライン計算など、オブジェクト上で変更があったとき。
-
オブジェクト上の計算カスタムフィールドで参照されている別のフィールドを、他のユーザーが編集したとき。
-
計算式が空で、フィールドに値が含まれているとき（値が NULL に設定されます）。
note note NOTE オブジェクトに添付されたカスタムフォームでは、計算カスタムフィールドの日付および時刻のステートメントは、組織のインスタンスとユーザープロファイルに設定されたタイムゾーン設定ではなく、協定世界時（UTC）に従って計算および保存されます。ただし、カスタムフォームの計算は、各ユーザーの個々のタイムゾーンに基づいて表示されます。