Agregar datos calculados a un formulario personalizado con el generador de formularios heredado
En un formulario personalizado, puede agregar un campo personalizado calculado que utilice datos existentes para generar datos nuevos cuando el formulario personalizado se adjunta a un objeto.
Para ello, cree una instrucción que utilice expresiones de datos y los nombres de campos existentes, que pueden ser campos personalizados, campos de datos personalizados calculados y campos Adobe Workfront integrados.
Esta instrucción calcula los datos especificados y muestra el resultado en el nuevo campo personalizado calculado.
Un campo personalizado calculado puede contener:
-
Una sencilla referencia a un único campo integrado.
note info INFO Ejemplo: Para calcular los ingresos generados por proyectos y tareas, puede crear un campo personalizado calculado que contenga el campo integrado Ingresos reales. Cuando alguien adjunta el formulario personalizado a un proyecto o tarea, los ingresos del proyecto o tarea se muestran en el campo. -
Expresión que hace referencia a uno o varios campos. Pueden ser campos personalizados, otros campos personalizados calculados y campos integrados.
note info INFO Ejemplo: Para calcular el beneficio generado por proyectos y tareas, puede crear un campo personalizado calculado denominado Beneficio que contenga una expresión matemática que reste costos de los ingresos. Para ello, se puede utilizar la expresión matemática SUB (subtract) con los campos integrados de Workfront Coste real e Ingresos reales. En los pasos siguientes, puede ver cómo se puede llevar a cabo este ejemplo.
Para obtener información sobre la creación de formularios personalizados para su organización y el tipo de campos que puede asociar a ellos, consulte Crear o editar un formulario personalizado.
Requisitos de acceso
Debe tener lo siguiente para realizar los pasos de este artículo:
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| plan de Adobe Workfront | Cualquiera |
| Licencia de Adobe Workfront* |
Actual: plan O Nuevo: estándar |
| Configuración del nivel de acceso | Acceso administrativo a formularios personalizados |
*Para saber qué configuraciones de plan, tipo de licencia o nivel de acceso tiene, póngase en contacto con su administrador de Workfront. Para obtener más información sobre los requisitos de acceso, consulte Requisitos de acceso en la documentación de Workfront.
Agregar un campo calculado a un formulario personalizado add-a-calculated-field-to-a-custom-form
Puede utilizar tanto los campos integrados de Workfront como los campos personalizados que ya ha creado en la expresión de un campo personalizado calculado.
-
Comience a crear o editar un formulario personalizado, tal como se describe en Crear o editar un formulario personalizado.
-
En el Añadir un campo pestaña, haga clic en Calculado.
En el área de visualización de la derecha, el campo muestra un valor de relleno de 12345. Este indicador le recuerda que el campo es un campo personalizado calculado mientras crea o edita el formulario personalizado. Cuando el formulario se adjunta a un objeto y los usuarios lo rellenan, ven el resultado del cálculo en el campo y no el valor 12345.
-
Especifique la siguiente información para el campo calculado:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Etiqueta Escriba una etiqueta para el campo. Esto es lo que ven los usuarios cuando utilizan el formulario personalizado. El campo Nombre, que se rellena automáticamente y coincide con Label, Workfront hace referencia a él en los informes. Este campo es obligatorio. Nombre De forma predeterminada, el Nombre de un campo es el mismo que la Etiqueta. Sin embargo, puede modificar el Nombre de un campo para que sea diferente a la Etiqueta de un campo. El campo Nombre Workfront hace referencia a en los informes. Este campo es obligatorio. Instrucciones Agregue texto para proporcionar información adicional sobre el campo y la fórmula que contiene.
También puede pegar aquí la fórmula utilizada en el cálculo del campo personalizado. En este caso, le recomendamos que actualice primero el Calculation del campo personalizado y, a continuación, copie la expresión final del campo Calculation y péguela en el campo Instructions.
Esto puede resultar útil de las siguientes maneras:
-
Como recordatorio de qué es la fórmula y cómo funciona. Esto resulta especialmente útil si planea utilizar este campo personalizado calculado en varios formularios.
-
Como información de objeto, los usuarios pueden ver cuando pasan el ratón por encima del campo. Aquí puede agregar el texto que desee que vea en la información del objeto.
Si no desea que los usuarios vean la fórmula en la información del objeto, lo que podría resultar confuso para ellos, no la agregue al campo Instrucciones. En su lugar, utilice la configuración "Mostrar fórmula en instrucciones" para mostrar u ocultar la fórmula, tal como se describe más adelante en este artículo Cree el cálculo para el campo personalizado calculado en este artículo.
Para obtener información sobre el uso del mismo campo personalizado calculado en un formulario nuevo, consulte Reutilizar un campo personalizado calculado existente en un formulario personalizado.
Formato El formato en el que desea que se almacenen y muestren los resultados del campo.
Si planea utilizar el campo en cálculos matemáticos, utilice siempre un Número o una Moneda formato. Al seleccionar Número o Moneda, el sistema trunca automáticamente los números que comienzan por 0.
IMPORTANTE:
Antes de elegir un formato, tenga en cuenta el formato correcto para el nuevo campo. El campo de formato no se puede editar después de guardar el formulario personalizado. Y seleccionar el formato incorrecto podría afectar a futuros cálculos y valores acumulados en las agrupaciones de informes y listas.
NOTA: Los campos calculados con un formato de moneda no deben incluir comillas. (Por ejemplo, use 800,00 y no "800,00"). El uso de comillas puede tener consecuencias inesperadas debido a los matices del formato de idioma para los tipos de moneda.
-
-
Continúe actualizando la información del campo personalizado como se describe en la sección Cree el cálculo para el campo personalizado calculado en este artículo.
Cree el cálculo para el campo personalizado calculado build-the-calculation-for-your-calculated-custom-field
-
Comience a crear el campo personalizado calculado, tal como se describe en la sección Agregar un campo calculado a un formulario personalizado en este artículo.
-
Clic Maximizar para abrir Editor de cálculo y genere su cálculo.
note info INFO Ejemplo: Con el ejemplo de la introducción a este artículo, puede crear un campo personalizado calculado llamado Beneficio en un formulario personalizado para proyectos y tareas. Este campo puede contener un cálculo que muestre la diferencia entre los ingresos reales y el costo real: SUB({actualRevenue},{actualCost})En este ejemplo, SUBes la expresión y los campos a los que se hace referencia sonactualRevenueyactualCost.Un cálculo suele comenzar con una expresión, seguida de paréntesis que contienen los campos a los que se desea hacer referencia cuando se adjunta el formulario personalizado a un objeto. Para obtener información sobre las expresiones disponibles, consulte Resumen de las expresiones de datos calculados.
Cada campo debe estar comprendido entre llaves, tal como se explica en la sección Sintaxis requerida en los campos personalizados calculados en este artículo. Cuando empiece a escribir el nombre de un campo, el sistema realiza sugerencias y puede seleccionar una para insertarla en el cálculo.
note note NOTE No se puede hacer referencia a campos de los siguientes tipos en un cálculo: - Campo de texto con formato
- Texto descriptivo.
Para obtener información sobre los tipos de campos personalizados, consulte Agregar un campo personalizado a un formulario personalizado. -
Haga clic en el cuadro de texto grande del cuadro Editor de cálculos y, a continuación, haga clic en buscar o expandir y haga clic en una opción del Expresiones y Campos secciones a la derecha del cuadro de texto. Esto los añade al cálculo.
También puede empezar a escribir una expresión o campo en el cuadro de texto grande y, a continuación, seleccionarlo cuando se muestre. Cada elemento se muestra con una "F" para el campo o una "E" para la expresión.
Si escribe un paréntesis de apertura, el paréntesis de cierre se agrega automáticamente.
note tip TIP Puede realizar cualquiera de las siguientes acciones para obtener ayuda con el cálculo: - 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 "Más información" para obtener más información en el artículo Resumen de las expresiones de datos calculados.
- 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.
- 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.
- En el Vista previa de un objeto existente debajo del cálculo, empiece a escribir el nombre de un objeto Workfront, selecciónelo cuando se muestre en la lista. Esto le proporciona una vista previa del aspecto que tendrá el campo cuando se adjunte el formulario al objeto.
- Expresiones de referencia en un cálculo largo utilizando los números de línea que se muestran a la izquierda.
- 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 "Más información" para obtener más información en el artículo Resumen de las expresiones de datos calculados.
-
Clic Minimizar cuando haya terminado de crear el cálculo para el campo personalizado calculado.
note note NOTE En el área de visualización de la derecha, el campo muestra un valor de relleno de 12345. Este indicador le recuerda que el campo es un campo personalizado calculado mientras crea o edita el formulario personalizado. Cuando el formulario se adjunta a un objeto y los usuarios lo rellenan, ven el resultado del cálculo en el campo y no el valor 12345. -
(Opcional) Utilice cualquiera de las siguientes opciones para configurar aún más el campo personalizado calculado:
table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Agregar lógica Puede agregar Lógica de visualización para determinar si el campo calculado se muestra, en función de al menos una opción que realice un usuario en un campo de opción múltiple anterior (Lista desplegable, Casillas de verificación o Botones de opción) al rellenar el formulario. Para obtener más información, consulte Agregar lógica de visualización y saltar lógica a un formulario personalizado.
Esto solo está disponible cuando al menos una casilla de verificación, un botón de opción o un campo desplegable precede al campo personalizado calculado en el formulario.
La lógica de omisión no está disponible para los campos personalizados calculados.
Actualizar cálculos anteriores Cuando esté editando un campo personalizado calculado existente, puede seleccionar esta opción para almacenar en déclencheur una actualización en el cálculo al guardar el formulario personalizado. Esto solo ocurre una vez al guardar el formulario personalizado. La opción vuelve a su estado deshabilitado después de hacerlo. Mostrar fórmula en las instrucciones Deje esta opción habilitada si desea que los usuarios que rellenan el formulario personalizado vean la fórmula del campo cuando pasan el ratón por encima del campo. Para obtener más información, consulte la información sobre Instrucciones anteriormente en esta tabla. -
Clic Listo cuando se completen todos los cambios en el campo personalizado calculado.
O haga clic en Aplicar para aplicar los cambios al formulario hasta el momento si desea seguir agregando campos personalizados al formulario.
O haga clic en Guardar + Cerrar cuando se completen todos los cambios en el formulario personalizado.
-
Para comprobar que el campo personalizado calculado funciona correctamente, adjunte el formulario personalizado a un objeto y, a continuación, revise el resultado en el campo personalizado calculado.
Para obtener instrucciones sobre cómo adjuntar un formulario personalizado, consulte Agregar un formulario personalizado a un objeto.
Si desea seguir creando el formulario personalizado de otras formas, puede continuar con uno de los siguientes artículos:
- Agregar un campo personalizado a un formulario personalizado
- Colocar campos y widgets personalizados en un formulario personalizado
- Agregar o editar un widget de recursos en un formulario personalizado
- Reutilizar un campo personalizado calculado existente en un formulario personalizado
- Agregar lógica de visualización y saltar lógica a un formulario personalizado
- Previsualización y cumplimentación de un formulario personalizado
Sintaxis requerida en los campos personalizados calculados
Cada campo utilizado en un campo calculado personalizado 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.
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 y debe tener el formato que aparece en la base de datos de Workfront. No puede utilizar el nombre de los campos tal como se muestran en la interfaz de Workfront.
Por ejemplo: {actualRevenue}
Los nombres de los campos distinguen entre mayúsculas y minúsculas y deben aparecer en mayúsculas o minúsculas, tal y como aparecen en el sistema de Workfront.
- 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. Los campos personalizados distinguen entre mayúsculas y minúsculas y deben recibir el formato que muestran en la interfaz de Workfront.
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 objeto principal 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
projectcomo tipo de objeto del campo:{project}.{actualRevenue}O bien, si es un campo personalizado:
{project}.{DE:profit}Si no está seguro de cuál será el tipo de objeto del objeto principal porque el formulario personalizado está configurado para varios tipos de objetos, puede utilizar la variable de filtro comodín
$$OBJCODEpara permitir que el cálculo funcione para cada uno de los tipos posibles. Para obtener más información, consulte Campos personalizados calculados en formularios personalizados de varios objetos en este artículo.
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}
Este sistema recupera la información en los siguientes pasos (en este orden):
- Desde el objeto del formulario personalizado (una tarea),
- Acceda al objeto principal de la tarea u otro objeto relacionado (proyecto) y, a continuación,
- Acceda al objeto principal o a otro objeto relacionado del proyecto (un portafolio) y, a continuación,
- Acceda al siguiente objeto relacionado con el portafolio (el propietario del portafolio).
Sintaxis de nombre para hacer referencia a un campo personalizado
Cuando se hace referencia a otro campo personalizado en un campo personalizado calculado, es necesario introducir el nombre del campo tal y como se muestra en la interfaz 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}
:name al final.{DE:Executive sponsor:name}Campos personalizados calculados en formularios personalizados de varios objetos calculated-custom-fields-in-multi-object-custom-forms
En un formulario personalizado de varios objetos, los tipos de objeto seleccionados deben ser compatibles con todos los campos a los que se hace referencia en los campos personalizados calculados del formulario.
{assignedTo}.{name}Cuando esto sucede, puede realizar una de las siguientes acciones:
- Quite uno de los dos elementos incompatibles del formulario personalizado: el tipo de objeto o el campo personalizado calculado al que se hace referencia.
- Mantener ambos elementos y utilizar la variable de filtro comodín
$$OBJCODEcomo condición en una expresión IF para crear dos versiones diferentes del campo In Charge. Esto permite que el campo funcione correctamente, independientemente del tipo de objeto al que esté adjunto el formulario.
$$OBJCODE 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:IF($$OBJCODE="PROJ",{owner}.{name},{assignedTo}.{name})Para obtener más información sobre variables como $$OBJCODE, consulte Resumen de variables de filtro comodín.
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.
note note NOTE En un formulario personalizado adjunto a un objeto, las instrucciones de fecha y hora de los campos personalizados calculados se calculan y guardan según la hora universal coordinada (UTC), no según las configuraciones de zona horaria establecidas para la instancia de su organización y el perfil de usuario. Sin embargo, los cálculos de un formulario personalizado se muestran en función de la zona horaria individual de cada usuario.