Etiquetas para personalizar sus reportes y correos electrónicos
  • 28 Nov 2024
  • 14 Minutos para leer
  • Oscuro
    Ligero

Etiquetas para personalizar sus reportes y correos electrónicos

  • Oscuro
    Ligero

Resumen del artículo

Cada campo de tu formulario está definido por un identificador, por ejemplo, ##cliente##. Llamamos a este código una Etiqueta. Las etiquetas se utilizan para personalizar tus informes, correos electrónicos y exportaciones de datos.


Reglas generales

Primero, algunas informaciones sobre las etiquetas:

  • Cada campo tiene una etiqueta "raíz" construida a partir del nombre del campo: ##nombre_del_campo##. La raíz es modificable hasta el primer registro del formulario que sigue a su creación.
  • Cada etiqueta puede completarse con un "sufijo": ##nombre_del_campo:time##, por ejemplo.
  • No puede haber 2 etiquetas idénticas en un mismo formulario.
  • Se utilizan en documentos Word personalizados, Excel personalizados y correos electrónicos.
  • También puedes utilizarlas en el nombre de los archivos de exportación. 
A diferencia de la etiqueta Block, la etiqueta simple funciona en el encabezado y el pie de página del documento Word.

El formato de la etiqueta

La etiqueta siempre se construye de esta manera : ##nombre_del_campo## . No puede haber espacios dentro de una etiqueta. Además, un _ (guion bajo)  se inserta automáticamente en cada palabra.

Es posible añadir un sufijo a una etiqueta para personalizar la información.  Por ejemplo : ##photo-100×100## se utiliza para definir 

Las etiquetas se encuentran en el menú  [Ayuda] de cada campo. Para acceder a ellas, debes entrar al campo haciendo clic en el botón modificar  Accès aux paramètres du champ.

Después de guardar el formulario, si modificas el nombre de un campo, su etiqueta no se modifica. De esta manera, no será necesario cambiar las etiquetas en el/los archivo(s) de exportación personalizada.

El formato de la etiqueta debe respetarse estrictamente; de lo contrario, la información introducida no se mostrará correctamente en tu exportación.

Todas las etiquetas del formulario se encuentran en las Opciones del formulario, en la pestaña [Información]. La primera parte muestra las etiquetas específicas del formulario, mientras que la segunda ofrece etiquetas especiales.

Después de guardar tu formulario por primera vez, puedes descargar un ejemplo de Word o Excel desde el menú Exportaciones haciendo clic en [+ Agregar una nueva exportación]. Luego, solo tendrás que hacer clic en el botón [Descargar el ejemplo]. De esta forma, obtendrás un archivo que contiene todas las etiquetas de tu formulario.

Tanto en las Opciones del formulario como en las Opciones de los campos, al pasar el cursor sobre una etiqueta, esta cambia de color. Con un simple clic izquierdo, se copiará automáticamente. Luego, puedes pegarla directamente en un archivo de exportación.

Las etiquetas para crear tu documento

Las etiquetas especiales te permiten llevar la personalización aún más lejos. Puedes encontrar toda la información sobre estas etiquetas al final de la pestaña Información.

Para que las etiquetas funcionen correctamente, es imprescindible que todos los caracteres tengan el mismo tamaño, color y fuente.

Añadir datos especiales

Las etiquetas para los datos especiales se identifican fácilmente gracias al _ (guion bajo) colocado justo después de los dos hashtags ##. Por ejemplo: ##_etiqueta##.

  • ##_last_name## : apellido del usuario
  • ##_first_name## : nombre del usuario
  • ##_phone## : teléfono  del usuario
  • ##_email## : email del usuario
  • ##_recipient_last_name## : apellido del destinatario
  • ##_recipient_first_name## : nombre del destinatario
  • ##_recipient_email## : email del destinatario
  • ##_login## : Identificación del usuario
  • ##_answer_time##: fecha y hora de registro del dato
  • ##_answer_time##: fecha de registro del dato
  • ##_answer_time##: hora de registro del dato
  • ##_generation_time##: fecha de generación de la exportación personalizada
  • ##_update_time##: fecha y hora de la última modificación del dato
  • ##_id##: identificador único
  • ##_record_number##: n.º de respuesta para este dato (identificador)
  • ##_line_number##: permite mostrar las líneas en una tabla
  • ##_user_refn##: permite obtener el campo de usuario personalizado n
  • ##_history##: permite obtener el historial de tu dato
  • ##_line_number:tabla1## : permite mostrar las líneas de una tabla cuando hay varias tablas presentes en el informe; tableau1 es la etiqueta de la tabla en cuestión. 
  • ##id_de_campo[n]## : permite recuperar la entrada de un elemento en una línea específica dentro de una tabla. Por ejemplo, si tienes una casilla de verificación en tu tabla y deseas recuperar su valor en la línea 3, puedes usar la etiqueta ##casilla_de_verificacion[3]##.
    Para recuperar la entrada de un elemento de tipo múltiple, debes estructurar tu etiqueta de la siguiente manera : ##id_de_campo[n]:y##, "n" siendo "n" el número de la línea y "y" el número del medio. Por ejemplo, si deseas recuperar tu tercer dibujo en la línea 2 de tu tabla, usarás esta etiqueta:  ##dibujo[2]:3##
  • ##id_de_campo:caption## : permite recuperar el título de un campo
  • ##_start_time## : planificación – fecha de inicio del evento
  • ##_end_time## :planificación – fecha de finalización del evento
  • ##_company_code## : muestra el código de la empresa
  • ##_form_id## : muestra el ID del formulario
  • ##_export_id## : muestra el ID de la exportación

Las etiquetas de elementos múltiples (foto, esquema, dibujo y archivo adjunto) 

  • ##element:n## : elemento n

"n" corresponde al número del elemento. La numeración comienza en 1.

Si tu usuario inserta 3 fotos, deberás incluir las siguientes etiquetas en tu archivo de exportación :  ##photo:1##, ##photo:2##, ##photo:3## .

Puedes usar una tabla para una mejor presentación de tus elementos múltiples.

Las etiquetas de Fecha y Hora

Cuando obtienes la información de un campo de Fecha y Hora, el formato predeterminado es: dd/mm/aaaa hh. Puedes personalizar la visualización de esta información utilizando las siguientes etiquetas:

Si la etiqueta de nuestro elemento es ##fecha_y_hora##:

  • ##fecha_y_hora## : formato numérico (01/01/2022 13:29)  
  • ##fecha_y_hora:dateonly## : permite mostrar solo la fecha (01/01/2022) 
  • ##fecha_y_hora:timeonly## : permite mostrar solo la hora (13:29) 
  • ##fecha_y_hora:short## : formato de texto corto (1.º Ene. 2022 a las 13:29) 
  • ##fecha_y_hora:medium## : formato de texto medio (1.º de enero de 2022 a las 13:29) 
  • ##fecha_y_hora:long## : formato de texto largo ( Sábado, 1.º de enero 2022 à 13:29)
  • ##fecha_y_hora:iso## : formato ISO  (2022-01-01 13:29)
  • ##fecha_y_hora:dateonly:iso## : permite mostrar solo la fecha en formato ISO  (2022-01-01)

Otras etiquetas también están disponibles.  No dudes en consultar este truco para descubrir más.

Las etiquetas de  Geolocalización

Generales

Si la etiqueta de nuestro elemento es ##geolocalizacion##:

  • ##geolocalizacion##: muestra las coordenadas GPS con un enlace. 
  • ##geolocalizacion:latitud## et ##geolocalizacion:longitud## : permiten obtener la latitud y longitud
  • ##geolocalizacion:altitud## : permite obtener la altitud junto con la geolocalización. 
  • ##geolocalizacion:gms## : permite obtener la latitud y la longitud en formato gms (grados minutos segundos)
  • ##geolocalizacion:latitud:gms## : permite obtener la latitud en formato gms (grados, minutos, segundos). 
  • ##geolocalizacion:longitud:gms## : permite obtener la longitud en formato gms (grados minutos segundos)
  • ##geolocalizacion:altitud:gms## : permite obtener la altitud en formato  gms. Sin embargo, el resultado es idéntico al obtenido con la etiqueta  ##geolocalizacion:altitud## ya que se mide en metros. 
  • ##geolocalizacion:link## : muestra un enlace que dirige a un mapa al hacer clic sobre él. 
  • ##geolocalizacion:time## :indica la hora de la geolocalización. 
  • ##geolocalizacion:qrcode## : permite generar un Código QR que, al imprimirlo y escanearlo, abre una aplicación de GPS con las coordenadas indicadas en Kizeo Forms. 
  • ##geolocalizacion:map-z12-largoxaltura-satelite## :permite mostrar un mapa de tipo satélite. 
    • z12 corresponde al nivel de zoom aplicado en el mapa mundial. Para que te hagas una idea:  : 1 muestra el mapa del mundo,  18 muestra la calle correspondiente, 12 muestra aproximadamente el barrio
    • largoxaltura permite dimensionar la imagen. Por ejemplo, puedes ingresar 200×200.
    • satelite corresponde al tipo de mapa. Puedes elegir entre roadmap (el tipo de mapa por defecto ), satelite (imagen satelital desde Google Earth ), hybrid (una combinación de roadmap y satelite ) y por último terrain (muestra un mapa físico basado en la información del terreno)
Solo puedes usar uno de estos elementos a la vez, por ejemplo:   ##geolocalizacion:map-z12-satellite##

📖 Más información sobre el  Campo de Geolocalización.

Los campos que pueden ser geolocalizados y registrar automáticamente la hora

Los campos Foto, Firma, Etiqueta NFC y Código de barras pueden capturar automáticamente la geolocalización al agregar una foto, siempre que la opción [Tomar la localización automática] esté activada en el campo.

Puedes encontrar esta opción en la pestaña [Avanzado] de cada uno de los campos mencionados anteriormente.

Esta geolocalización puede mostrarse en tu documento personalizado. Para ello, simplemente debes añadir en tu archivo de exportación las siguientes etiquetas:  :##etiqueta_de_campo:latitud## y ##etiqueta_de_campo:longitud##.
Por ejemplo, utilizando las etiquetas ##photo_magasin:latitude## et ##photo_magasin:longitude##, puedes mostrar la geolocalización al tomar una foto desde el campo Foto tienda del formulario Orden de compra. 

Estos campos pueden registrar la fecha y la hora en las que se tomó la información : ##etiqueta_de_campo:time##.
También puedes combinar esta etiqueta con diferentes formatos de fecha, agregando, por ejemplo.  : ##etiqueta_de_campo:time:iso##.

Es necesario marcar la casilla [Tomar la localización automáticamente] en las opciones de tu elemento, en la pestaña [Avanzado].

📖 En savoir plus sur la marca de tiempo y la geolocalización.

Las etiquetas de Fotos, Dibujos y Firmas

Puedes definir el tamaño en píxeles de tus imágenes (foto simple, dibujo simple, firma) según las siguientes opciones:

  • ##etiqueta_de_campo## : si no quieres preocuparte por el tamaño
  • ##etiqueta_de_campo-largoxaltura## : si desea definir la anchura y la altura
  • ##etiqueta_de_campo-largox## : si sólo desea definir la anchura
  • ##etiqueta_de_campo-xaltura## : si sólo desea definir la altura
Puedes especificar la altura y/o el ancho de la imagen según prefieras. El valor que no indiques se calculará automáticamente para mantener las proporciones de tu foto. Por ejemplo, si deseas que una firma tenga 100 píxeles de alto, inserta la etiqueta de tu firma seguida de x100, como en:  ##firma-x100##.

📖 Más información sobre las fotos en los reportes personalizados.

Define el tamaño en píxeles de tus fotos y dibujos múltiples

  • ##etiqueta_de_campo:n##: si no quieres preocuparte por el tamaño
  • ##etiqueta_de_campo:n-largoxaltura## : si desea definir la anchura y la altura
  • ##etiqueta_de_campo:n-largox## : si sólo desea definir la anchura
  • ##etiqueta_de_campo:n-xaltura## : si sólo desea definir la altura

n corresponde al número de la imagen. La numeración comienza desde 1.

Para una mejor presentación de tus múltiples fotos, te recomendamos que utilices una tabla.

Muestra la fecha y la hora en que se tomaron las fotos

Si la etiqueta de nuestro elemento es ##foto## :

  • ##foto:time##: muestra la fecha y hora de inserción de la foto en los datos
  • ##foto:time:short## : para visualizar la fecha y la hora en formato de texto corto (1 feb. 2022)
  • ##foto:time:medium##: para visualizar la fecha y la hora en formato de texto medio (1 de febrero de 2022)
  • ##foto:time:long## : para mostrar la fecha y la hora en formato de texto largo (martes 1 de febrero de 2022)
  • ##foto:time:iso## : para visualizar la fecha y la hora en formato iso (2022-02-01)

También hay otras etiquetas disponibles. No dudes en consultar esta guía para descubrir más opciones.

Mostrar la fecha y la hora de registro de tus firmas

Si la etiqueta de nuestro elemento es ##firma## :

  • ##firma:time## : muestra la fecha y hora en que se guardó la firma
  • ##firma:time:short## : para visualizar la fecha y la hora en formato de texto corto (1 feb. 2022)
  • ##firma:time:medium## : para visualizar la fecha y la hora en formato de texto medio (1 de febrero de 2022)
  • ##firma:long## : para mostrar la fecha y la hora en formato de texto largo (martes 1 de febrero de 2022)
  • ##firma:time:iso## :  para visualizar la fecha y la hora en formato iso (2022-02-01)

También hay otras etiquetas disponibles. No dudes en consultar esta guía para descubrir más opciones.

Muestra la latitud y longitud de tus fotos y firmas

Si las etiquetas de nuestros elementos son ##foto## et ##firma## :

##foto:latitud##y ##foto:longitud## : muestra la latitud y longitud de la toma de la foto
##firma:latitud##y ##firma:longitud## : muestra la latitud y longitud de la firma.

Debe marcar la casilla[Tomar la ubicación automáticamente] en las opciones de su artículo, pestaña Avanzado.

Mostrar un enlace hacia tus fotos y firmas

Si las etiquetas de nuestros elementos son  ##foto## y ##firma## :

  • ##foto:link## : Permite obtener un enlace hacia la foto al hacer clic sobre ella: 
  • ##firma:link## : Permite obtener un enlace hacia la firma al hacer clic sobre ella: 

Etiquetas de código de barras/código QR

Mostrar tus códigos de barras en formato 128B

Si la etiqueta de nuestro elemento es ##codigo_barra## :

  • ##codigo_barra:128## : si no quieres preocuparte por el tamaño.
  • ##codigo_barra:128-largeurxhauteur## : si deseas definir la anchura y la altura.

Mostrar tus códigos en formato Código QR 

Si la etiqueta de nuestro elemento es ##codigo_barra## :

  • ##codigo_barra:qrcodigo## : si no quieres preocuparte por el tamaño
  • ##codigo_barra:qrcodigo-largoxaltura## : si deseas definir la anchura y la altura
  • ##codigo_barra:hora## : muestra la hora de la lectura del código de barras

Mostrar tus diferentes campos en formato 128B y QR Code

Ahora puede utilizar estos dos formatos con los siguientes campos: 

  • Campo de entrada
  • Zona de texto
  • Deslizador
  • Tag NFC
  • Cálculo
  • Referencia
  • Contador

Por ejemplo, si la etiqueta de nuestro campo es ##campo## :

  • ##campo:128## : si queremos materializar nuestro campo en un formato específico 128B.
  • ##campo:qrcode## : si queremos materializar nuestro campo en el formato de código QR .

📖 Para saber más sobre el Campo  Códigos de-barras y códigos QR.

Etiquetas de casilla de verificación

Visualización de las casillas de verificación

Si la etiqueta de nuestro elemento es ##case_a_cocher## :

  • ##casilla_de_verificacion:Si:No## : Si aparecerá si la casilla esta marcada y No en caso contrario.
  • ##casilla_de_verificacion:☑:☐## : habrá una casilla marcada o una vacía.

También puedes definir el color de visualización de tu casilla de verificación según la respuesta :

  • ##casilla_de_verificacion:Si:## : Si aparecerá en verde si la casilla está marcada.
  • ##casilla_de_verificacion::No## : No aparecerá en rojo si la casilla no está marcada.

📖 Para saber más sobre la visualización de la casilla  de la verificación.

Visualización de tus campos de lista y opciones en formato de  casilla de verificación 

Puedes hacer que aparezca una casilla marcada o no marcada frente a los diferentes elementos de una lista.  Por ejemplo, nuestra lista contiene los siguientes elementos: Tren, Auto, Avión, y la etiqueta del campo es  ##lista## :

  • ##lista-Tren:☑:☐## : Si el elemento Tren está seleccionado, aparecerá marcado ☑︎ aparecerá delante; de lo contrario, habrá una casilla vacía  ☐.
  • ##lista-Auto:☑:☐## : Si el elemento Auto está seleccionado, aparecerá marcado ☑︎ aparecerá delante, de lo contrario estará vacía ☐.
  • ##lista-Avion:☑:☐## : Si el elemento Avión está seleccionado, una casilla marcada ☑︎ aparecerá delante, de lo contrario estará vacía  ☐.
Si los elementos de la lista o del campo de opciones son grupos de palabras, es imprescindible definir un Código para cada elemento; de lo contrario, las etiquetas no funcionarán. 

Por ejemplo (Código:Elemento) : 

A:Avión de turismo

  • T:Tren de alta velocidad
  • C:Coche de carreras

En nuestro ejemplo, la siguiente etiqueta permitirá mostrar una casilla marcada  ☑︎ si el elemento "Coche de carreras" está seleccionado; de lo contrario, habrá una casilla vacía  ☐ :##lista-C:☑:☐##.

📖Más información sobre la Lista de Códigos y en la visualización de casillas de verificación.

Las etiquetas Lista y Opción

General

Si la etiqueta de nuestro elemento es ##lista## :

  • ##lista:id## : muestra el ID de la Lista Externa
  • ##lista-elemento:☑:☐## : permite mostrar una casilla marcada o una casilla vacía delante de los elementos de la lista (no dudes en consultar nuestro tutotial dedicado a  la visualización de casillas de verificación para más información)
  • ##lista:label## : permite forzar la etiqueta (El Excel personalizado muestra por defecto el código)
  • ##lista:code## : permite forzar el código (El Word personalizado muestra por defecto la etiqueta)
  • ##lista-Avion:X:## : para mostrar una (X) en lugar del elemento Avion
Si los elementos de tu lista son grupos de palabraspor ejemplo “Avion de turismo“, “Tren de alta velocidad“ o “Auto de carreras“, es imprescindible  definir un código para utilizar ciertas etiquetas.

Para definir un Código, ve a las opciones de tu campo de lista o elección y escribe los elementos en el formato Código:Elemento. Por ejemplo (Código:Elemento):

  • A:Avion de turismo
  • T:Tren de alta velocidad
  • C:Coche de carreras

La sintaxis para hacer una cruz (X) cuando el valor seleccionado = “Avion de turismo“ será por lo tanto: ##lista-A:X:##

📖 Más información sobre la Lista Codificada.

Definir un color de visualización

Puedes definir el color de visualización de cada elemento. Por ejemplo, tienes una lista codificada compuesta por los tres elementos siguientes (Código:Elemento):

  • T:Tren
  • C:Coche
  • A:Avion
Your title goes here
Para ello, debe haber asignado un código a cada elemento de la lista.

📖 Más información sobre la Lista Codificada.

El formato de las siguientes etiquetas te permitirá definir un color para cada elemento :

  • ##lista-T:Tren:## : si se desea que el elemento Tren aparezca en verde si es seleccionado
  • ##lista-C:Coche:## : si se desea que el elemento Coche aparezca en rojo al seleccionarlo
  • ##lista-A:Avion:## : si se desea que el elemento Avion aparezca en azul si es seleccionado

Visualización de imágenes

También puedes hacer que aparezcan caracteres Unicode como respuesta. El sitio Unicode Table te ofrece los caracteres compatibles nuestro système.

En Mac, para que estas imágenes se muestren en tu informe,  la etiqueta correspondiente debe estar en una fuente particular que es “MS Reference Sans Serif“. De lo contrario, funcionan correctamente en PC y en PDF en Mac.

La sintaxis para hacer aparecer ✈︎ cuando el valor = Avion :

  • Categoría : ##lista-Avion:✈︎:##

Etiquetas de lista con viñetas y salto de línea

Esta diferentes etiquetas funcionan con los Campos Lista y Elección. Si las etiquetas de nuestros campos son ##lista## y ##Eleccion## :

  • En un documento Word personalizado :
    • ##lista:break## et ##eleccion:break## : permiten mostrar los elementos seleccionados uno debajo del otro.
  • En un documento Excel personalizado :
    • ##lista:break## et ##eleccion:break## : permiten que aparezcan saltos de línea entre los elements de tus campos Liste y Elección
    • ##lista:unordered## et ##eleccion:unordered## : permiten tener un elemento de tus campos Lista y Elección por línea, precedido de un guión
    • ##lista:ordered## et ##eleccion:ordered## : permiten tener un elemento de tus campos Lista y Elección por línea, precedido de una numeración

Las etiquetas de Lista Jerárquica

Tienes una Lista Jerárquica y quieres mostrar en tu documento Word o Excel personalizado toda o parte de la jerarquía . Las etiquetas a continuación  te permitirán hacerlo.

Tomemos como ejemplo la siguiente Lista Jerárquica : FR-fr:France\83:Var\83700:Saint-Raphaël y la etiqueta de nuestro campo es ##lista##.

  • La sintaxis para mostrar el conjunto de la jerarquía es : ##lista:path##

En el Word personalizado, obtendrás : « France / Var »
Mientras que en el Excel personalizado tendrás : « FR-fr / 83 »

  • La sintaxispara mostrar el conjunto de la jerarquía + el valor es : ##lista:fullpath##

En el Word personalizado, obtendrás : « France / Var / Saint-Raphaël »
Mientras que en el Excel personalizado tendrás : « FR-fr / 83 / 83700 »

  • La sintaxis para mostrar cada elemento de la jerarquía es la siguiente  : ##lista:path-1##, ##lista:path-2##, etc…

En el Word personalizado obtendrás :

  • ##lista:path-1## mostrará « France »
  • ##lista:path-2## mostrará « Var »

En el Excel personalizado tendrás :

  • ##lista:path-1## mostrará  « FR-fr »
  • ##lista:path-2## mostrará  « 83 »
  • Para mostrar el Código tanto en las exportaciones Word como Excel, puedes usar las siguientes variantes  : ##lista:pathcode-1## / ##lista:fullpathcode##
  • Para mostrar la etiqueta tanto en las exportaciones Word como Excel, puedes usar las siguientes variantes  : ##lista:pathlabel-1## / ##lista:fullpathlabel##

Etiquetas de la tabla

Para más información sobre la gestión de tablas en las exportaciones personalizadas , visita nuestro tutorial sobre la personalización de tablas en Word y Excel.

La Etiqueta Block para mostrar u ocultar una tabla o un bloque de párrafo

La Etiqueta Block permite mostrar u ocultar una parte de tu documento Word o tu correo electrónico que contenga texto, tablas, imágenes, etc. Para más información, visita el tutorial sobre la etiqueta block.