将计算字段添加到表单

新增：标准

或

当前：计划

  每个字段都必须使用下面解释的语法，每个字段名称两侧都应使用大括号。 当您开始键入字段名称时，系统会提供建议，您可以选择一个来将其插入到计算中。 如果在计算中输入的数据不正确，则会出现警告消息，提醒您。 除非编辑计算以包含有效字段和有效计算表达式，否则无法保存表单。

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

    这将确定以下内容：从自定义表单（任务）的对象中，您可以访问与任务（项目）相关的下一个对象。 从那里，您可以访问项目（项目组合）的下一个相关对象，然后引用为项目组合对象（所有者）定义的字段

    用于引用自定义字段的&#x200B;**名称语法**

    在计算的自定义字段中引用其他自定义字段时，需要输入该字段在Workfront用户界面中显示的名称。

    例如，要在标记为执行发起人的自定义字段中引用所选选项，应键入以下内容：

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>typeahead字段的语法与其他类型的字段的语法略有不同，因为您需要在末尾添加<code>:name</code>。</p>
    <p>例如，要在名为“执行发起人”的自定义预输入字段中引用所选选项，您需要键入：</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **多对象自定义表单中计算的自定义字段**

    在多对象自定义表单中，所选对象类型必须与表单的计算自定义字段中引用的至少一个字段兼容。 与对象不兼容的字段在表单上将显示不适用。

    为确保计算字段显示所有对象类型的正确结果，必须使用`$$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-Hans)。

    **计算自定义字段的自动更新**

    出现以下情况时，会自动重新计算对象中已计算的自定义字段：

     * 对象上的某些内容发生了变化，例如每日时间线计算。
     * 有人编辑对象上计算自定义字段引用的另一个字段。
     * 计算表达式为空，并且字段包含一个值 — 这会将值设置为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-Hans">计算数据表达式概述</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>