양식에 계산된 필드 추가

새로운 기능: 표준

또는

현재: 플랜

  각 필드는 각 필드 이름 주위에 중괄호를 사용하여 아래에 설명된 구문을 사용해야 합니다. 필드 이름을 입력할 때 시스템에서 제안을 하며 이를 선택하여 계산에 삽입할 수 있습니다. 계산에 데이터를 잘못 입력하면 경고 메시지가 표시됩니다. 유효한 필드와 유효한 계산된 표현식을 포함하도록 계산을 편집하지 않으면 양식을 저장할 수 없습니다.

  <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:`을(를) 입력할 때 선택할 수 있는 모든 사용자 지정 필드가 시스템에 나열됩니다.

     * 사용자 지정 양식을 개체에 첨부할 때 *parent* 개체에서 데이터를 가져오는 필드를 계산에서 참조하려면 필드 이름 앞에 부모 개체의 개체 형식(중괄호)을 추가해야 합니다.

    예를 들어 사용자 정의 양식이 작업에서 작동하도록 구성되어 있고 양식을 작업에 첨부할 때 필드가 상위 개체의 실제 매출을 계산하도록 하려면 필드의 개체 유형으로 `Project`을(를) 표시해야 합니다.

    `{project}.{actualRevenue}`

    또는 사용자 정의 필드인 경우:

    `{project}.{DE:profit}`

    **점이 있는 항목 구분**

    계산된 사용자 정의 필드에서 관련 객체를 참조할 때는 객체 이름과 속성을 마침표로 구분해야 합니다.

    예를 들어 작업 유형 사용자 정의 양식에서 계산된 사용자 정의 필드에 Portfolio 소유자의 이름을 표시하려면 다음을 입력합니다.

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

    이렇게 하면 사용자 정의 양식의 개체(작업)에서 작업(프로젝트)과 관련된 다음 개체에 액세스할 수 있습니다. 여기에서 프로젝트(포트폴리오)와 관련된 다음 오브젝트에 액세스한 다음 포트폴리오 오브젝트(소유자)에 대해 정의된 필드를 참조할 수 있습니다

    사용자 지정 필드를 참조하기 위한 **이름 구문**

    계산된 사용자 정의 필드에서 다른 사용자 정의 필드를 참조할 때 Workfront 사용자 인터페이스에 표시되는 대로 필드 이름을 입력해야 합니다.

    예를 들어, 경영 스폰서라는 레이블이 지정된 사용자 정의 필드에서 선택한 옵션을 참조하려면 다음을 입력합니다.

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>자동 완성 필드의 구문이 다른 필드 형식의 구문과 약간 다릅니다. 끝에 <code>:name</code>을(를) 추가해야 하기 때문입니다.</p>
    <p>예를 들어, &quot;경영 스폰서&quot;라는 사용자 정의 타이프 어헤드 필드에서 선택한 옵션을 참조하려면 다음을 입력합니다.</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>프로젝트에서 필드에는 &quot;This is a project&quot;, 작업에는 &quot;This is a task&quot;가 표시되고, 문제에는 &quot;This is an issue&quot;가 표시됩니다.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>예:</strong> 프로젝트에 Assigned To: Name 필드가 없지만 기본 제공된 Owner 필드가 있습니다. 이 필드는 사용자가 수동으로 변경하지 않는 한 프로젝트를 만든 사람의 이름으로 자동으로 입력됩니다.</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=ko)를 참조하십시오.

    **계산된 사용자 지정 필드의 자동 업데이트**

    다음 상황이 발생하면 오브젝트의 계산된 사용자 정의 필드가 자동으로 다시 계산됩니다.

     * 일별 타임라인 계산과 같이 오브젝트에 대한 내용이 변경됩니다.
     * 누군가 개체의 계산된 사용자 정의 필드에서 참조하는 다른 필드를 편집합니다.
     * 계산된 표현식이 비어 있고 필드에 값이 있습니다. 이 값은 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=ko">계산된 데이터 식의 개요</a>에서 자세한 정보에 대한 &quot;자세히 알아보기&quot; 링크를 볼 수 있습니다.<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>