Agregar campos calculados con el diseñador de formularios

  Cada campo debe utilizar la sintaxis explicada a continuación, con llaves alrededor de cada nombre de campo. Cuando empiece a escribir el nombre de un campo, el sistema realiza sugerencias y puede seleccionar una para insertarla en el cálculo. Si introduce datos incorrectamente en un cálculo, un mensaje de advertencia le avisará. No puede guardar el formulario a menos que edite el cálculo para que contenga campos válidos y una expresión calculada válida.

  <div class="extension note">
  <div>NOTE</div>
  <div>
  <p>Actualmente, el sistema solo realiza sugerencias cuando empieza a escribir el nombre de un campo al que desea hacer referencia en un objeto al que se adjuntará el formulario personalizado. No se sugieren campos del objeto principal.</p>
  </div>
  </div>

  **Envolver nombres de campo con llaves**

  * Si desea que el cálculo haga referencia a un campo integrado, el nombre del campo debe estar entre llaves.

    Por ejemplo: `{actualRevenue}`

    Los nombres de campo distinguen entre mayúsculas y minúsculas y deben aparecer en el cálculo exactamente como aparecen en el sistema de Workfront.

    Vaya a [Explorador de API de Workfront](https://developer.adobe.com/workfront/api-explorer/) para identificar los nombres de campo que se pueden utilizar en los cálculos.

  * Si desea que el cálculo haga referencia a un campo personalizado, el nombre del campo debe estar entre llaves y precedido por `DE:` entre corchetes.

    Por ejemplo: `{DE:Profit}`

    El sistema enumera todos los campos personalizados entre los que puede elegir al escribir `DE:`.

     * Si desea que el cálculo haga referencia a un campo que extraerá datos del *parent* objeto cuando el formulario personalizado está adjunto a un objeto, debe anteponer el nombre del campo al tipo de objeto del objeto principal, también entre llaves.

    Por ejemplo, si el formulario personalizado está configurado para trabajar con tareas y desea que el campo calcule los ingresos reales del objeto principal cuando el formulario se adjunta a una tarea, debe indicar `Project` como tipo de objeto del campo:

    `{project}.{actualRevenue}`

    O bien, si es un campo personalizado:

    `{project}.{DE:profit}`

    **Separar elementos con puntos**

    Cuando haga referencia a un objeto relacionado en un campo personalizado calculado, debe separar los nombres y atributos de los objetos con puntos.

    Por ejemplo, en un formulario personalizado de tipo de tarea, para mostrar el nombre del Propietario del Portfolio en un campo personalizado calculado, debe escribir lo siguiente:

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

    Esto determinaría lo siguiente: Desde el objeto del formulario personalizado (una tarea), puede acceder al siguiente objeto relacionado con la tarea (un proyecto). Desde allí, puede acceder al siguiente objeto relacionado con el proyecto (un portafolio) y, a continuación, hacer referencia a los campos definidos para el objeto del portafolio (el propietario)

    **Sintaxis de nombre para hacer referencia a un campo personalizado**

    Cuando haga referencia a otro campo personalizado en un campo personalizado calculado, debe introducir el nombre del campo tal y como se muestra en la interfaz de usuario de Workfront.

    Por ejemplo, para hacer referencia a la opción seleccionada en un campo personalizado denominado Patrocinador ejecutivo, debe escribir lo siguiente:

    `{DE:Executive sponsor}`

    <div class="extension note">
    <div>NOTE</div>
    <div>
    <p>La sintaxis de un campo de escritura anticipada es un poco diferente a la de otros tipos de campos porque es necesario agregar <code>:name</code> al final.</p>
    <p>Por ejemplo, para hacer referencia a la opción seleccionada en un campo de escritura anticipada personalizado denominado &quot;Patrocinador ejecutivo&quot;, escribiría:</p>
    <p><code>{DE:Executive sponsor:name}</code></p>
    </div>
    </div>


    **Campos personalizados calculados en formularios personalizados de varios objetos**

    En un formulario personalizado de varios objetos, los tipos de objeto seleccionados deben ser compatibles con al menos un campo al que se haga referencia en los campos personalizados calculados del formulario. Los campos no compatibles con el objeto mostrarán N/D en el formulario.

    Para asegurarse de que el campo calculado muestra un resultado correcto para todos los tipos de objetos, debe utilizar `$$OBJCODE` para definir un cálculo para cada tipo de objeto.

    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Ejemplo:</strong></p>
    <p>En un formulario personalizado configurado para trabajar con proyectos, tareas y problemas, puede utilizar la siguiente fórmula para mostrar el tipo de objeto:</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>En un proyecto, el campo mostrará &quot;Esto es un proyecto&quot;, en una tarea mostrará &quot;Esto es una tarea&quot; y en un problema dirá &quot;Esto es un problema&quot;.</p>
    </div>
    </div>


    <div class="extension info">
    <div>INFO</div>
    <div>
    <p><strong>Ejemplo:</strong> Aunque no hay ningún campo Asignado a: Nombre en los proyectos, hay un campo Propietario integrado (que se rellena automáticamente con el nombre de la persona que creó el proyecto, a menos que alguien cambie esto manualmente).</p>
    <p>Por lo tanto, en el campo a cargo personalizado, puede utilizar <code>$$OBJCODE</code> como se muestra a continuación, para hacer referencia al campo Propietario cuando el formulario personalizado se adjunta a un proyecto y al campo Asignado a: Nombre cuando el formulario se adjunta a una tarea:</p>
    <p><code>IF($$OBJCODE=&quot;PROJ&quot;,{owner}.{name},{assignedTo}.{name})</code></p>
    </div>
    </div>

    Para obtener más información sobre variables como `$$OBJCODE,` consulte [Resumen de variables de filtro comodín](https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/reporting-elements/understand-wildcard-filter-variables.html?lang=es).

    **Actualizaciones automáticas de campos personalizados calculados**

    Los campos personalizados calculados en un objeto se vuelven a calcular automáticamente cuando ocurren las siguientes cosas:

     * Algo en el objeto cambia, como un cálculo diario de la escala de tiempo.
     * Alguien edita otro campo al que se hace referencia mediante un campo personalizado calculado en el objeto.
     * La expresión calculada está vacía y el campo contiene un valor; esto establece el valor en nulo.

       <div class="extension note">
       <div>NOTE</div>
       <div>
       <div>En un formulario personalizado adjunto a un objeto, las instrucciones de fecha y hora de los campos personalizados calculados se calculan y guardan mediante la hora universal coordinada (UTC), no mediante las configuraciones de zona horaria establecidas para la instancia de su organización y el perfil de usuario. Los cálculos de un formulario personalizado se generan en función de las zonas horarias individuales de cada usuario.</div>
       </div>
       </div>

  <div class="extension tip">
  <div>TIP</div>
  <div>
  <p>Puede realizar cualquiera de las siguientes acciones para obtener ayuda con el cálculo:</p>
  <ul>
  <li>Pase el ratón sobre una expresión del cálculo para ver una descripción, un ejemplo que muestre cómo se puede utilizar y un vínculo &quot;Más información&quot; para obtener más información en el artículo <a href="https://experienceleague.adobe.com/docs/workfront/quicksilver/reports-and-dashboards/reports/calc-cstm-data-reports/calculated-data-expressions.html?lang=es">Resumen de las expresiones de datos calculados</a>.<br>
  <img src="assets/hover-expression-help-text.jpg" alt=""></li>
  <li>Utilice la codificación de color para identificar los componentes que ha añadido. Las expresiones se muestran en azul y los campos en verde.<br>
  <img src="assets/colors-fields-expressions.jpg" alt=""></li>
  <li>Busque errores de cálculo resaltados en rosa a medida que avanza. Puede situarse sobre un error resaltado para mostrar una breve descripción de su causa.<br>
  <img src="assets/error-help.png" alt=""></li>
  <li>En el área debajo del cálculo, previsualice los resultados de un objeto de Workfront existente.</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>Expresiones de referencia en un cálculo largo utilizando los números de línea que se muestran a la izquierda.</li>
  </ul>
  </div>
  </div>