新增計算欄位至表單

新增：標準

或

目前：計畫

  每個欄位都必須使用以下說明的語法，並在每個欄位名稱兩側加上大括弧。 當您開始輸入欄位名稱時，系統會提供建議，您可以選取一個來將其插入計算。 如果您在計算中輸入的資料不正確，警告訊息會警告您。 除非編輯計算以包含有效欄位和有效的計算運算式，否則無法儲存表單。

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>目前，只有在您開始輸入要在自訂表單將附加到的物件上參考的欄位名稱時，系統才會提出建議。 不建議使用父物件中的欄位。</p>
  </div>
  </div>

  **以大括弧括住欄位名稱**

  * 如果您希望計算參照內建欄位，欄位名稱必須用大括弧括住。

    例如： `{actualRevenue}`

    欄位名稱會區分大小寫，且在計算中必須如期顯示於Workfront系統中。

    導覽至[Workfront API Explorer](https://developer.adobe.com/workfront/api-explorer/)，以識別可在計算中使用的欄位名稱。

  * 如果您希望計算參照自訂欄位，欄位名稱必須用大括弧括住，並在括弧內以`DE:`括住。

    例如： `{DE:Profit}`

    系統列出您在輸入`DE:`時可以選擇的所有自訂欄位。

     * 如果您希望運算式參考在自訂表單附加至物件時，會從&#x200B;*parent*&#x200B;物件提取資料的欄位，則必須在欄位名稱前面加上父物件的物件型別，且必須用大括弧括住。

    例如，如果自訂表單設定為與任務搭配使用，而您想要欄位在表單附加至任務時計算父系物件的實際收入，則您需要將`Project`表示為該欄位的物件型別：

    `{project}.{actualRevenue}`

    或者，如果是自訂欄位：

    `{project}.{DE:profit}`

    **以句點分隔專案**

    當您在計算的自訂欄位中參考相關物件時，必須使用句點分隔物件名稱和屬性。

    例如，在任務型別自訂表單中，若要在計算的自訂欄位中顯示Portfolio擁有者的名稱，您可以輸入下列內容：

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

    這會決定下列專案：從自訂表單（任務）的物件中，您可以存取與任務（專案）相關的下一個物件。 從那裡，您可以存取專案的下一個相關物件（投資組合），然後參照為投資組合物件（所有者）定義的欄位

    **參照自訂欄位的名稱語法**

    當您在計算的自訂欄位中參考另一個自訂欄位時，您需要輸入顯示在Workfront使用者介面中的欄位名稱。

    例如，若要參照在標示為Executive supporter的自訂欄位中選取的選項，您可以輸入以下內容：

    `{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>


    **多物件自訂表單中的已計算自訂欄位**

    在多物件自訂表單中，選取的物件型別必須與表單的計算自訂欄位中參考的至少一個欄位相容。 與物件不相容的欄位會在表單上顯示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=zh-Hant)。

    **已計算自訂欄位的自動更新**

    當發生下列情況時，會自動重新計算物件上的已計算自訂欄位：

     * 物件上的某些專案會變更，例如每日時間表計算。
     * 有人編輯物件上計算自訂欄位參考的另一個欄位。
     * 計算的運算式是空的，而欄位包含一個值 — 這會將值設定為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=zh-Hant">計算資料運算式概觀</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>