⚠️ Importante
Antes de usar las etiquetas Block, te recomendamos leer el tutorial "Las etiquetas para personalizar los exports". Te permitirá entender su función, su creación y dónde encontrarlas.
En este tutorial, los ejemplos usan identificadores genéricos. En la práctica, recuerda reemplazarlos por los identificadores de tu propio formulario.
1. ¿Para qué sirven las etiquetas Block?
Las etiquetas Block permiten mostrar u ocultar automáticamente una parte de tu export, en función de lo que el usuario haya introducido en el formulario. Pueden condicionar la visualización de elementos como texto, tablas, fotos o etiquetas.
Permiten, entre otras cosas:
Ocultar una sección si el usuario no introduce nada en un campo.
Mostrar un contenido según el valor elegido en una lista (color, símbolo...).
Mostrar un contenido si se marca una casilla.
Mostrar u ocultar un texto según si un campo está vacío o cumplimentado.
Condicionar la visualización de un campo de foto múltiple.
Adaptar la visualización mediante un Campo de Usuario Personalizado.
Condicionar la visualización de una tabla.
Antes de comenzar, es importante identificar con precisión qué deseas obtener y a partir de qué tipo de campo.
2. Creación y posición de las etiquetas Block
La etiqueta Block se construye a partir de la etiqueta del campo que va a condicionar la visualización del contenido.
2.1 Crear una etiqueta Block simple
La etiqueta Block simple se utiliza en los siguientes casos:
Para ocultar una parte del documento cuando el campo relacionado está vacío.
Para mostrar una parte del documento si se marca una casilla.
Basta con añadir _block: después de los dos primeros # de la etiqueta del campo correspondiente.
Ejemplo: quieres ocultar un contenido si el campo Foto no está cumplimentado.
La etiqueta del campo Foto es
##photo##.Añade _block: después de los dos primeros #.
La sintaxis de la etiqueta Block es: ##_block:foto##
2.2 Crear una etiqueta Block con sufijo
A veces es necesario añadir un sufijo en la etiqueta Block. Puede ser un operador de comparación o el código de una lista/elección.
Casos de uso:
Para mostrar una parte del documento en función del elemento seleccionado en un campo Lista o Elección.
Para mostrar una parte del documento si una casilla no está marcada.
Para mostrar un contenido concreto si un campo está vacío.
Para mostrar un contenido si un campo está cumplimentado.
Para mostrar un contenido en función de la presencia o no de fotos en un campo múltiple.
Para mostrar un contenido en función de la presencia o no de un Campo de Usuario Personalizado.
Al igual que para la etiqueta Block simple, añades _block: después de los dos primeros #. Luego completas con -sufijo entre el identificador de la etiqueta y los dos últimos #.
Ejemplo: quieres mostrar un contenido si el elemento seleccionado en la lista corresponde al código 2.
La etiqueta del campo Lista es ##liste##.
Añade _block: después de los dos primeros #.
Añade -2 entre el identificador y los dos últimos #.
La sintaxis de la etiqueta Block es: ##_block:lista-2##
⚠️ Importante
Para facilitar la escritura de la etiqueta Block, es necesario codificar los elementos de los campos Lista y Elección.
2.3 ¿Dónde y cómo colocar las etiquetas Block?
Las etiquetas Block funcionan siempre de a dos para encuadrar el contenido a mostrar/ocultar, y deben posicionarse de la siguiente manera:
##_block:identificador##
Parte del documento a mostrar (texto, tabla, imagen o etiqueta)
##_block:identificador##
3. Buenas prácticas de uso
Para funcionar correctamente, las etiquetas Block deben respetar las siguientes reglas:
Règle | Explication |
Sintaxis | ##_block:identificador## ##_block:identificador-sufijo## |
Código | Es necesario codificar los elementos de los campos Lista y Elección. |
Siempre de a dos
| Una etiqueta block abre y la otra cierra la zona condicionada. Las dos etiquetas deben ser estrictamente idénticas. |
Línea dedicada | Una etiqueta block debe estar sola en su línea |
Ubicación | Usable únicamente en una plantilla Word o en un escenario de email |
Campos | Compatible con todos los tipos de campos |
Nombre | Sin acento, sin mayúsculas y sin espacios |
Tableau | Las dos etiquetas block deben estar ambas dentro de la tabla o ambas fuera
Si los blocks provienen de un campo de tabla, también deben estar en una tabla |
Salto de página / sección
| Colocarlos entre o fuera de las etiquetas Block, pero no en la misma línea |
Encabezado / pie de página | Prohibido |
Sin Shift+Intro | Solo párrafo normal, sin salto de línea |
Etiquetas anidadas | Posible, pero con orden preciso: la primera en abrirse = la última en cerrarse.
|
⚠️ Importante
No se permite acumular etiquetas Block si utilizan los operadores in o nin.
4. Los operadores de comparación
Puedes condicionar la visualización en función de un valor numérico o alfabético mediante operadores:
Operador | Significado | Syntaxe |
| Igual a | Muestra contenido si valor = 3 |
| Distinto de | Muestra contenido si valor ≠ 3 |
| Estrictamente inferior | Muestra contenido si valor < 3 |
| Inferior o igual | Muestra contenido si valor ≤ |
| Inferior o igual | Muestra contenido si valor > 3 |
| Superior o igual | Muestra contenido si valor ≥ 3 |
5. Resumen
Contexto / Uso | Permitido | Prohibido |
Word personalizado | ✅ |
|
Escenario de email | ✅ |
|
Excel personalizado |
| ⛔️ |
Encabezado / Pie de página |
| ⛔️ |
Nuevo párrafo (Intro) | ✅ |
|
Retorno de carro (Shift + Intro) |
| ⛔️ |
2 etiquetas block dentro de tabla | ✅ |
|
2 etiquetas block fuera de tabla | ✅ |
|
1 dentro de tabla y 1 fuera |
| ⛔️ |
💡 Consejo
Para facilitar la lectura y modificación de tu plantilla de export, puedes resaltar las etiquetas block con color. Este resaltado no aparecerá en el export final, pero te permitirá localizarlas rápidamente si necesitas revisar la plantilla.
No dudes en consultar los demás tutoriales disponibles en la sección dedicada a las Etiquetas Block.