1. Bigle Academy
  2. Plantillas - Crear etiquetas
  3. Tipos de uso de etiquetas de apertura y cierre

Etiquetas para condicionar textos al valor de un campo numérico

La plataforma nos brinda la posibilidad de configurar un campo de tipo Número de forma que, en función del valor introducido en el formulario, se muestre una frase u otra en el documento final.

Para que esto suceda, en la plantilla, debemos incluir los textos que queramos condicionar entre las siguientes etiquetas de apertura y cierre:

  • Superior al valor:
    {#numberRAW >2}Texto A{/}
  • Igual al valor:
    {#numberRAW ===2}Texto B{/}
  • Inferior al valor:
    {#numberRAW <2}Texto C{/}


Las etiquetas de apertura ({#numberRAW >2}, {#numberRAW ===2} y {#numberRAW <2}) están formadas por:

  • La misma etiqueta del campo numérico (en este caso, “number”):
Etiqueta del campo
  • RAW >2”, “RAW ===2” y “RAW <2”, que determinan la condición en la que aparecerá el texto:
    • RAW >2”: cuando el valor del campo sea superior a 2, se mostrará el “Texto A”.
    • RAW ===2”: cuando el valor del campo sea igual a 2, se mostrará el “Texto B”.
    • RAW <2”: cuando el valor del campo sea inferior a 2, se mostrará el “Texto C”.
  •  “2” es el valor que condiciona cada uno de los textos del ejemplo anterior, pero podrá variar en función del resultado deseado.

Por otro lado, la etiqueta de cierre es la misma en cada ocasión: {/}

 

En una misma plantilla, podemos usar tanto las tres configuraciones de etiquetas anteriores, como dos de ellas o solamente una, según las necesidades de cada caso. Además, podemos combinar distintas etiquetas en una misma frase.

A continuación, varios ejemplos empleando la etiqueta del campo Número, las etiquetas para condicionar textos al valor del campo y la etiqueta de transformación de números a palabras (aprende más sobre ellas en este artículo):

{#numberRAW >2}Texto A: {numberLETTERS} ({number}){/}

  • Si introducimos un valor superior a 2 (por ejemplo, 5) aparecerá esta frase:
    Texto A: CINCO (5)

{#numberRAW ===2}Texto B: {numberLETTERS} ({number}){/}

  • Si el valor introducido es 2, aparecerá esta frase:
    Texto B: DOS (2)

{#numberRAW <2}Texto C: {numberLETTERS} ({number}){/}

  • Si introducimos un valor inferior a 2 (por ejemplo, 1) aparecerá esta frase:
    Texto C: UNO (1)

 

Recuerda que, aunque en los ejemplos anteriores hemos utilizado el número 2, se puede utilizar esta configuración con otros valores. Del mismo modo, “Texto A”, “Texto B” y “Texto C” deberán sustituirse por los textos reales que queramos condicionar y “number” por la etiqueta del campo Número.


Para aprender más sobre el campo de tipo Número y las opciones que ofrece, consulta este artículo.

Casos de uso


Caso 1:

Es posible condicionar más de un fragmento de texto en una misma frase. En el siguiente ejemplo, en el que el campo hace referencia al número de años (“{years}”), nos interesa que cuando el valor sea 1, aparezca la palabra “año” (en singular) y, cuando sea superior a 1, aparezca la palabra “años” (en plural):

{yearsLETTERS} ({years}){#yearsRAW >1} años{/}{#yearsRAW ===1} año{/}

  • Si el valor del campo es superior a 1 (por ejemplo, 5) aparecerá esta frase:
    CINCO (5) años
  • En cambio, si el valor del campo es 1, aparecerá esta otra:
    UN (1) año

Caso 2:

Vayamos a por un ejemplo algo más complejo. Supongamos que, dependiendo de la duración de un contrato, queremos que la cantidad de la cláusula de penalización varíe. Por ejemplo, queremos que, si la duración es de 5 años o menos, la cantidad sea de 1.000 € y, si la duración es de más de 5 años, la cantidad sea de 2.000 €.

Caso de uso

En este caso, crearemos dos campos en los que introducir la cuantía económica de cada situación: 

  • Uno se podría titular "Cuantía de la cláusula de penalización para una duración de contrato de 5 años o menos" (con la etiqueta "{penaltyclause1}").
  • El otro se podría titular "Cuantía de la cláusula de penalización para una duración de contrato de más de 5 años" (con la etiqueta "{penaltyclause2}").

Teniendo en cuenta que la aparición de una cantidad u otra debe depender del número de años que dure el contrato, crearemos un campo numérico (con la etiqueta "{years}") y le condicionaremos los otros dos campos:

El contrato durará {yearsLETTERS} ({years}){#yearsRAW >1} años{/}{#yearsRAW ===1} año{/}. La cantidad de penalización será de {#yearsRAW <5}{penaltyclause1}{/}{#yearsRAW ===5}{penaltyclause1}{/}{#yearsRAW >5}{penaltyclause2}{/}.


Con esta configuración, después de rellenar los campos del formulario con las respectivas cantidades de 1.000 € y 2.000 €, y de introducir un número de años:

  • Si introducimos "1" en el campo {years}, aparecerá esta frase:
    El contrato durará UN (1) año. La cantidad de penalización será de 1.000 €.
  • Si introducimos "5" en el campo {years}, aparecerá esta frase:
    El contrato durará CINCO (5) años. La cantidad de penalización será de 1.000 €.
  • Si introducimos "8" en el campo {years}, aparecerá esta frase:
    El contrato durará OCHO (8) años. La cantidad de penalización será de 2.000 €.