Ejemplos de uso de variables

Puede combinar algunas de las variables para obtener resultados más complejos. Consulte los ejemplos de uso de variables en diferentes escenarios organizados por su complejidad y caso de uso.

En este artículo:

Referencias rápidas

Patrones variables comunes y sus casos de uso:

Patrón Caso de uso Ejemplo
{#variable}...{/variable} Recorrer los elementos en bucle {#markups}{name}{/markups}
{#!variable}...{/} Mostrar cuándo la variable está vacía {#!amount}$0.00{/}
{#variable}...{/}{#!variable}...{/} Mostrar valor o valor por defecto {#previousAmount}{previousAmount}{/}{#!previousAmount}0{/}
{variable | filter:"field":"value"} Filtrar datos {items | filter:"type":"SOV"}
{variable | sumBy:"field"} Calcular totales {items | sumBy:"approved"}
{#condition}...{/} Visualización condicional {#amount!="0.00"}{amount}{/}
{variable | groupItemsByXCO: 'type'} Agrupar por tipo de orden de cambio {items | groupItemsByXCO: 'COR'}

Uso básico de variables

Empiece aquí si es la primera vez que utiliza variables en plantillas de documento. Estos ejemplos cubren conceptos fundamentales que se aplican a todos los tipos de documentos.

¿Cómo se puede añadir una tabla con variables?

Puede utilizar variables y presentar los datos en forma de tabla con columnas y encabezados. A continuación se muestra un ejemplo de sintaxis:

Ejemplo de sintaxis de variables de tabla que muestra las variables de marca de revisión de apertura y cierre

Utilice la variable de sección de apertura. Empiece por # (por ejemplo, {#markups}) y finalice con / (por ejemplo, {/markups}).

Nota: No repita la misma variable de apertura y cierre en una tabla.

Uso incorrecto:

Ejemplo de uso incorrecto que muestra variables de apertura y cierre repetidas en una tabla

Uso correcto:

Ejemplo de uso correcto que muestra una estructura correcta de variable de apertura y cierre

Entre las variables de apertura y cierre, puede enumerar todos los datos necesarios, como {name} o {description}.

Ejemplo de sintaxis de variables de tabla con variables de nombre y descripción

El resultado en el documento generado:

Resultado del documento generado que muestra una tabla formateada con datos de variables

¿Cómo se muestran los valores predeterminados para las variables en blanco?

Escenario: utiliza variables como {previousAmount} y {materialsStored} en la plantilla de documento, pero, al generar documentos, algunas columnas se muestran en blanco en lugar de mostrar los valores "$0".

Para mostrar un valor por defecto cuando una variable está vacía o en blanco, utilice expresiones condicionales con el patrón siguiente:

{#variableName} {variableName} {/}{#!variableName}default_value{/}

Por ejemplo, para mostrar "0" cuando {previousAmount} está en blanco:

{#previousAmount} {previousAmount} {/}{#!previousAmount}0{/}

Esta expresión condicional funciona de la siguiente manera:

Puede aplicar este patrón a cualquier variable donde desee mostrar un valor predeterminado en lugar de celdas en blanco, como:

Ejemplos específicos de documentos

Estos ejemplos se organizan por tipo de documento para ayudarle a encontrar soluciones relevantes para su caso específico.

Solicitudes de pago

Ejemplos para personalizar hojas de cálculo y documentos de solicitud de pago.

¿Cómo se eliminan los elementos de línea vacíos desde una solicitud de pago de documento?

Para eliminar elementos de línea vacíos de una solicitud de pago, utilice la expresión condicional {#amount!="0.00"} al inicio de una tabla y {/} al final de la línea. Por ejemplo:

Ejemplo de expresión condicional para eliminar elementos de línea vacíos de las solicitudes de pago

¿Cómo se pueden mostrar solo los costes de los elementos planificados y no los importes subtotales en el documento de solicitud de pago?

Para eliminar los subtotales de las solicitudes de pago o de los contratos, puede introducir los elementos de la línea de pago con {#children.length===0}{xxx}{/}. Por ejemplo:

Ejemplo que muestra cómo eliminar subtotales mediante la condición children.length

¿Cómo se configura la hoja de cálculo de la solicitud de pago de presupuesto para dividir las órdenes de cambio por tipo?

Escenario: Ha creado un tipo de orden de cambio denominado "Transferencias de tolerancia".

Configuración de tipo de orden de cambio que muestra la configuración de Transferencias de tolerancia

Desea ver los cambios de propietario aprobados para estas tolerancias en la hoja de cálculo de Excel. ¿Cómo se hace?

  1. Escriba "Orden de cambio del propietario" para la columna de la hoja de cálculo de Excel.

    Hoja de cálculo de Excel que muestra la configuración de la columna Orden de cambio del propietario

  2. Aplique el nuevo tipo a una OCO.

    OCO con tipo de Transferencias de tolerancia aplicadas

  3. Asigne el nombre al tipo en la hoja de cálculo de Excel.

    Hoja de cálculo de Excel que muestra la configuración de un nombre de tipo coincidente

¿Cómo puedo añadir una nueva ficha sin subtotales a la hoja de cálculo de la solicitud de pago de costes?

Escenario: desea crear una nueva ficha en el plantilla de hoja de cálculo de solicitud de pago de costes por defecto que muestre solo los elementos planificados, sin mostrar los importes de los subtotales.

Para añadir una nueva ficha sin subtotales a la plantilla de hoja de cálculo de la solicitud de pago de costes, utilice el siguiente patrón de variables:

{#children.length===0}{xxx}{/}

Esta expresión condicional asegura que solo se muestren los elementos de línea sin subtotales en la ficha de la hoja de cálculo generada. {xxx} representa los campos de datos específicos que desea incluir para cada elemento de línea.

Caso de uso: esto resulta especialmente útil cuando desea proporcionar a los subcontratistas una vista clara de los elementos de trabajo individuales sin la complejidad de los cálculos de subtotales.

¿Cómo puedo añadir una ficha de COR agrupada a la hoja de cálculo de la solicitud de pago de presupuestos?

Escenario: desea crear una nueva ficha en la plantilla de hoja de cálculo de la solicitud de pago de presupuestos por defecto que agrupe los elementos por COR (solicitud de orden de cambio) sin mostrar los detalles de los elementos de coste individuales.

Por ejemplo, para añadir una nueva ficha denominada "Detalles opcionales agrupados por COR" a la plantilla de hoja de cálculo de la solicitud de pago de presupuestos, utilice el siguiente patrón de variables:

{#payment.lineView.rootItems|groupItemsByXCO: 'COR'}{number}{/payment.lineView.rootItems|groupItemsByXCO: 'COR'}

Esta variable agrupa los elementos de línea del pago por su COR asociada y muestra solo los números de COR sin los detalles del elemento de coste subyacente.

Características principales:

Nota: El documento generado no incluye detalles de elementos de coste, lo que proporciona una vista de resumen centrada en la organización de la COR.

Órdenes de cambio

Ejemplos para personalizar documentos de órdenes de cambio, incluidas RFQ, ROR y OCO.

¿Cómo se añade el contenido de la sección de comentarios a los documentos de orden de cambio?

Escenario: Desea crear un documento que contenga los comentarios durante la vida útil de una orden de cambio.

El ejemplo muestra {#rfq.comments} como etiqueta de apertura para las variables y {/rfq.comments} como etiqueta de cierre. Las otras variables relacionadas deben estar entre estas dos variables.

Por ejemplo, una RFQ con la siguiente sección de comentarios:

Sección de comentarios de RFQ que muestra varias entradas de comentarios

Añadir una tabla a un documento de Word con lo siguiente:

Plantilla de documento de Word que muestra la sintaxis de las variables de comentarios de RFQ

Trae como resultado:

Salida de documento generada que muestra la tabla de comentarios con formato

En la plantilla de documento solo se debe rellenar una línea de una tabla. El software crea la tabla con la información especificada basándose en los datos de Cost Management.

¿Cómo se organizan las órdenes de cambio ascendentes por la SOV del contrato principal?

Puede organizar las OCO y las RCP según la tabla de planificación de valores del contrato principal en la plantilla de documento. En el caso de las RCP, utilice este patrón:

Patrón de variables para organizar las COR por la Tabla de valores del contrato principal

En el caso de las OCO, reemplace rco por oco.

¿Cómo se añaden subtotales de elementos de trabajo y subtotales de marcas de revisión para los elementos de coste?

Escenario: Va a crear un documento de orden de cambio (por ejemplo, OCO) y desea que tenga dos tablas independientes. Una sería para los elementos de coste normal con un subtotal y, la otra, para los elementos de coste de marca de revisión. Desea añadir también el precio total de las órdenes de cambio. ¿Cómo se hace? A continuación, se muestra un ejemplo de las variables utilizadas en un documento:

Plantilla de documento de OCO que muestra tablas independientes para los elementos de trabajo y los subtotales de marca de revisión

¿Cómo se pueden mostrar los números de COR y OCO asociados al dividir órdenes de cambio por tipo?

Para mostrar el número de COR y OCO asociado, utilice las siguientes variables:

Plantilla de documento que muestra las variables de número de COR y OCO

Resultado:

Documento generado que muestra los números de COR y OCO en la tabla de órdenes de cambio

Contratos

Ejemplos para personalizar documentos de contrato y Planificación de valores.

¿Cómo se muestran solo los costes de los elementos planificados y no los importes de subtotal en la SOV del contrato?

Escenario: Desea crear un contrato con solo el subtotal de subelementos de SOV mostrados. No desea que un subcontratista pueda ver un elemento principal. Para ello, utilice estas variables de la plantilla de documento:

Plantilla de documento que muestra la sintaxis de variables secundarias para los subelementos de SOV

Además, no desea mostrar los valores de Coste unitario e Importe como 0 $. Puede reemplazar 0 $ por la palabra "Incluido". ¿Cómo se hace? Enriquezca variables ya utilizadas:

Se ha mejorado la plantilla de variables secundarias que reemplaza los valores 0 $ por "Incluido"

El resultado del contrato generado tendrá el aspecto siguiente:

Contrato generado que muestra los subelementos de SOV con "Incluido" sustituyendo los valores "0 $"

¿Cómo puedo hacer referencia al código de presupuesto y el nombre en las plantillas de documento de contrato?

Para hacer referencia a un código de presupuesto y un nombre en la plantilla de documento, utilice esta fórmula:

Fórmula de plantilla de documento para hacer referencia al código y el nombre del presupuesto

Por ejemplo, cuando la planificación de valores del contrato tiene este aspecto:

Tabla de valores del contrato que muestra la estructura de códigos de presupuesto

La fórmula presentada genera lo siguiente:

Generación del documento con el formato del código presupuestario y el nombre

Técnicas avanzadas

Estos ejemplos demuestran un uso sofisticado de variables para requisitos complejos de personalización de documentos.

Filtrado y lógica condicional

Técnicas avanzadas de filtrado para mostrar u ocultar datos específicos en los documentos.

¿Cómo se utiliza la función de filtro al generar documentos.

Puede utilizar la función de filtro al generar documentos. Por ejemplo, para mostrar únicamente el elemento de Contingencia de riesgo, utilice la variable {#payment.columnView.rootItems | filter:"name":"Risk Contingency"}:

Plantilla de documento que muestra la función de filtro de los elementos Contingencia de riesgo

Resultado:

Documento generado que muestra los resultados filtrados de Contingencia de riesgo

Los miembros también pueden separar la tabla de valores original con todas las SCO aprobadas en dos hojas independientes.

Para generar una hoja que incluya únicamente las SOV originales, utilice la siguiente variable:

{#payment.lineView.rootItems | filter:"associationType":"SOV"} {/payment.lineView.rootItems | filter:"associationType":"SOV"}

Para generar una hoja que incluya únicamente las SCO aprobadas, utilice la siguiente variable:

{#payment.lineView.rootItems | filter:"number":"Change Orders"} {/payment.lineView.rootItems | filter:"number":"Change Orders"}

¿Cómo puedo ocultar el coste de contingencia en el documento generado?

Plantilla de documento que muestra la configuración de visibilidad de los costes de contingencia

En situaciones en las que los administradores no desean que el coste de contingencia se muestre en el documento generado, se pueden utilizar filtros:

Configuración de filtros para ocultar los costes de contingencia de los documentos generados

Resultado:

Se ha generado un documento con los costes de contingencia ocultos correctamente

Agregación de datos

Técnicas avanzadas para calcular totales y realizar agregación de datos en los documentos.

Uso de sumBy para añadir datos

La función sumBy ayuda a añadir valores dentro del conjunto de datos.

Ejemplo 1: calcule el subtotal de los valores aprobados de los elementos de coste normal de cada PCO.

{#oco.pco}{regular | sumBy:'approved'}{/oco.pco}

Ejemplo 2: calcule el total de los valores aprobados de todos los elementos de coste de cada PCO.

{#oco.pco}{this | getAll: "costItems" | sumBy: "approved"}{/oco.pco}
Sugerencia:

La función sumBy es especialmente útil cuando se necesita mostrar totales calculados que no están disponibles directamente como variables individuales.

Página principal: Variables de Cost Management