計算フィールドをフォームに追加する

  各フィールドは、以下に説明する構文を使用する必要があります。各フィールド名を中括弧で囲みます。フィールドの名前を入力し始めると、候補が表示されるので、選択して計算に挿入できます。計算に誤ったデータを入力すると、警告メッセージが表示されます。有効なフィールドと有効な計算式を含むように計算式を編集しない限り、フォームを保存できません。

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>現在、カスタムフォームを添付するオブジェクトで参照するフィールドの名前を入力し始めた場合にのみ、候補が表示されます。親オブジェクトのフィールドは推奨されません。</p>
  </div>
  </div>

  **フィールド名を中括弧で囲む**

  * 計算で組み込みフィールドを参照する場合は、フィールド名を中括弧で囲む必要があります。

    例：`{actualRevenue}`

    フィールド名では大文字と小文字が区別され、Workfront システムでの表示を正確に計算に含める必要があります。

    [Workfront API エクスプローラー](https://developer.adobe.com/workfront/api-explorer/)に移動して、計算で使用できるフィールド名を特定します。

  * 計算でカスタムフィールドを参照する場合は、フィールド名を中括弧で囲み、括弧内の先頭に `DE:` を指定します。

    例：`{DE:Profit}`

    `DE:` を入力すると、選択できるすべてのカスタムフィールドが一覧表示されます。

     * カスタムフォームがオブジェクトに接続されているときに&#x200B;*親*&#x200B;オブジェクトからデータを取得するフィールドを計算で参照する場合は、フィールド名の前および中括弧内に親オブジェクトのオブジェクトタイプを付ける必要があります。

    例えば、タスクを使用するようにカスタムフォームを設定し、フォームがタスクに添付されたときにフィールドで親オブジェクトの実収益を計算する場合は、次のように`Project` をフィールドのオブジェクトタイプとして指定する必要があります。

    `{project}.{actualRevenue}`

    また、カスタムフィールドの場合は、次のようになります。

    `{project}.{DE:profit}`

    **項目をピリオドで区切る**

    計算カスタムフィールドで関連オブジェクトを参照する場合は、オブジェクト名と属性をピリオドで区切る必要があります。

    例えば、タスクタイプのカスタムフォームで、計算カスタムフィールドにポートフォリオ所有者の名前を表示するには、次のように入力します。

    `{project}.{porfolio}.{owner}`

    これにより、次のことが判別されます。カスタムフォームのオブジェクト（タスク）から、タスク（プロジェクト）に関連する次のオブジェクトにアクセスできます。ここから、プロジェクトの次の関連オブジェクト（ポートフォリオ）にアクセスし、ポートフォリオオブジェクト（所有者）用に定義されたフィールドを参照できます。

    **カスタムフィールドを参照するための名前の構文**

    計算カスタムフィールドで別のカスタムフィールドを参照する場合は、Workfront ユーザーインターフェイスに表示されるフィールドの名前を入力する必要があります。

    例えば、「エグゼクティブスポンサー」というラベルの付いたカスタムフィールドで選択したオプションを参照するには、次のように入力します。

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>先行入力フィールドの構文では最後に <code>:name</code> を追加する必要があるため、他のタイプのフィールドの構文とは少し異なります。</p>
    <p>例えば、「エグゼクティブスポンサー」というラベルの付いたカスタム先行入力フィールドで選択したオプションを参照するには、次のように入力します。</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **複数オブジェクトカスタムフォームの計算カスタムフィールド**

    複数オブジェクトのカスタムフォームでは、選択したオブジェクトタイプが、フォームの計算カスタムフィールドで参照されている 1 つ以上のフィールドと互換性を持つ必要があります。このオブジェクトと互換性のないフィールドは、フォームに N/A と表示されます。

    すべてのオブジェクトタイプに対して計算フィールドで正しい結果が表示されるようにするには、`$$OBJCODE` を使用して、各オブジェクトタイプに対する計算を定義します。

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>例：</strong></p>
    <p>プロジェクト、タスクおよびイシューを使用するように設定されたカスタムフォームでは、次の数式を使用してオブジェクトタイプを表示できます。</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,&quot;This is a project&quot;,IF($$OBJCODE=&quot;TASK&quot;,&quot;This is a task&quot;,&quot;This is an issue&quot;))</code></p>
    <p>プロジェクトでは「これはプロジェクトです」、タスクでは「これはタスクです」、イシューでは「これはイシューです」とフィールド上に表示されます。</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>例：</strong>&#x200B;プロジェクトには、割り当て先：名前フィールドはありませんが、組み込みの所有者フィールドがあります（手動で変更しない限り、プロジェクトの作成者の名前が自動的に入力されます）。</p>
    <p>したがって、カスタムの「担当」フィールドで、以下に示すように <code>$$OBJCODE</code> を使用して、カスタムフォームがプロジェクトに添付されている場合は「所有者」フィールドを参照でき、フォームがタスクに添付されている場合は「割り当て先：名前」フィールドを参照できます。</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    `$$OBJCODE,` のような変数について詳しくは、[ワイルドカードフィルター変数の概要](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=ja)を参照してください。

    **計算カスタムフィールドの自動更新**

    オブジェクトの計算カスタムフィールドは、次の場合に自動的に再計算します。

     * 日次のタイムライン計算など、オブジェクト上で変更があったとき。
     * オブジェクト上の計算カスタムフィールドで参照されている別のフィールドを、他のユーザーが編集したとき。
     * 計算式が空で、フィールドに値が含まれているとき（値が NULL に設定されます）。

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>オブジェクトに添付されたカスタムフォームでは、計算されたカスタムフィールドの日付と時刻のステートメントは、組織のインスタンスとユーザープロファイルに設定されたタイムゾーン設定ではなく、協定世界時（UTC）で計算および保存されます。カスタムフォームの計算は、各ユーザーの個々のタイムゾーンに基づいて生成されます。</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>次のいずれかの操作を実行して、計算に関するヘルプを確認することができます。</p>
  <ul>
  <li>計算の式にカーソルを合わせると、説明、その式の使用方法を示す例、および記事<a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=ja">計算データ式の概要</a>の詳細情報への「詳細情報」リンクが表示されます。<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>追加したコンポーネントを識別するには、色分けを使用します。式は青色で表示され、フィールドは緑色で表示されます。<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>計算エラーを見つけます。計算エラーはピンク色で強調表示されます。強調表示されたエラーの上にポインタを合わせると、その原因に関する簡単な説明が表示されます。<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>計算の下のエリアで、既存の Workfront オブジェクトの結果をプレビューします。</li>
  </ul>
  <!--or by providing test values (NOT READY YET; CHANGE THIS SCREENSHOT WHEN IT IS)-->
  <p><img src="assets/preview-calc.jpg" alt=""></p>
  <ul>
  <li>左側に表示される行番号を使用して、長い計算で式を参照します。</li>
  </ul>
  </div>
  </div>