Las plantillas de documentos contienen códigos simbólicos que se utilizan en lugar de diferentes datos.
Por ejemplo, usa el código {DocumentCreateTime} en una plantilla de documento para insertar la hora actual de creación del documento al formulario de impresión.
Códigos simbólicos: ¿qué son y para qué se utilizan?
Puedes modificar códigos simbólicos en plantillas de documentos para utilizar diferentes formatos de datos.
Tipos de modificadores
Agrega modificadores después de la tilde (~) al código simbólico para cambiar el formato de datos.
{DocumentCreateTime~d.m.Y h:i:s}, DocumentCreateTime es el código simbólico del campo y d.m.Y h:i:s es el modificador.Puedes modificar códigos simbólicos para los siguientes tipos de datos:
Además, puedes utilizar modificadores para obtener valores de campos múltiples.
Modificadores de la fecha y la hora
De forma predeterminada, el formato de la fecha en una plantilla de documento es el mismo que se utiliza en el país al que pertenece esta plantilla.
Configurar plantillas de documentos en CRM
Por ejemplo, utiliza el código {DocumentCreateTime~d.m.Y h:s} para agregar la fecha y la hora de creación del documento.
Formatos de la fecha y la hora
Modificadores de la fecha:
d.m.y- 21.09.23d.m.Y- 21.09.2023j, n, Y- 21, 9, 2023j F, Y— 21 Septiembre, 2023
Modificadores del tiempo:
H:i:s- 11:01:01
Modificadores combinados:
Y-m-d H:i:s- 2023-09-21 11:01:01F j, Y, G:i- Septiembre 21, 2023, 11:01
Más información sobre los posibles formatos de la fecha y la hora
Modificadores del nombre
Puedes modificar el formato del nombre agregando palabras especiales en el código simbólico. Los modificadores del nombre solo funcionan con campos del sistema.
Por ejemplo, utiliza el código {FormattedName~Format=#TITLE# #NAME# #SECOND_NAME_SHORT# #LAST_NAME#} para agregar el saludo, el nombre, la primera letra del segundo nombre y el apellido del cliente.
Formatos del nombre
#TITLE#- saludo#NAME#- nombre#LAST_NAME#- apellido#SECOND_NAME#- segundo nombre#NAME_SHORT#- primera letra del nombre#LAST_NAME_SHORT#- primera letra del apellido#SECOND_NAME_SHORT#- primera letra del segundo nombre
Modificadores de la dirección
De forma predeterminada, el formato de la dirección en una plantilla de documento es el mismo que se utiliza en el país al que pertenece esta plantilla. Pero también puedes modificarlo y usar un formato diferente.
Configurar plantillas de documentos en CRM
Por ejemplo, utiliza el código {Address~Format=3,Separator=3} para agregar la dirección en el formato de América del Norte.
Formatos de la dirección y el separador
Modificadores de la dirección:
Format=1– EuropaFormat=2– Reino UnidoFormat=3– América del NorteFormat=4– Rusia (Calle > País)Format=5– Rusia (País > Calle)
Modificadores del separador:
Separator=1– comaSeparator=2– sin separadorSeparator=3– salto de línea
Modificadores del importe total
Puedes modificar el código simbólico del importe total de tal manera que aparezcan ceros insignificantes y el símbolo de moneda después del punto.
Parámetros disponibles:
- WZ (With zeros). Por defecto, Bitrix24 muestra los ceros decimales en montos monetarios. Con WZ=N, los ceros finales se ocultan (por ejemplo, 120.00 se convertirá en 120). Por defecto, los ceros se muestran en campos como
{TotalRaw}(precio original),{TaxesTaxRate}(tasa de impuestos),{TotalSum}(monto total). En campos tabulares como{ProductsProductPriceRawNetto}(precio sin impuestos) y{ProductsProductPriceRawSum}(total sin impuestos), los ceros solo se muestran si usas el modificador WZ=Y. - NS (No sign). Si el valor es NS=Y, no se muestra el símbolo de moneda. Si el valor es NS=N, se incluye el símbolo de moneda.
- SN (Show No VAT). Si el valor es SN=Y, la tasa de impuestos se muestra sin el signo de porcentaje, solo el número (por ejemplo,
{TaxesTaxRate~SN=Y}mostrará 20 en lugar de 20%). - WP (With Percent). Si el valor es WP=Y, se añade el signo de porcentaje a la tasa de impuestos (por ejemplo,
{TaxesTaxRate~WP=Y}mostrará 20%, y{TaxesTaxRate~WP=N}no mostrará el signo de porcentaje).
Por ejemplo, utiliza el código {TotalSum~WZ=Y,NS=N} para agregar el importe total y la moneda, y {TaxesTaxRate~WP=Y, SN=Y} para mostrar la tasa de impuestos con el signo de porcentaje.
Formatos del importe total
WZ(With zeros) – si tieneWZ=Y, entonces el importe total se muestra con ceros (por ejemplo, 15,00 USD en vez de 15 USD)NS(No sign) – si tieneNS=N, se muestra el símbolo de la moneda (por ejemplo, 15$), y si tieneNS=Y– no.
Modificadores del número de teléfono
Utiliza el modificador ~format= para cambiar el formato del número de teléfono.
Por ejemplo, utiliza el código {ClientPhone~format=E.164} para agregar el número de teléfono del cliente.
Formatos del número de teléfono
E.164- +12223334455International- +1 222 333-44-55National- 1(222) 333-44-55
Modificadores del tamaño del texto
Utiliza el modificador ~letterCase= para cambiar el tamaño del texto.
Por ejemplo, escribe "21 SEPTIEMBRE 2023" en lugar de "21 Septiembre 2023" utilizando el código {DocumentCreateTime~format=d F Y,letterCase=upper}.
Formatos del tamaño del texto
upper- MAYÚSCULAlower- minúsculatitle- Mayúscula Para La Primera Letra De Cada Palabra
Utilizar modificadores para obtener valores de campos múltiples
En el CRM hay campos en los que se pueden añadir varios valores. Por ejemplo, en el campo Teléfono se puede indicar un número del trabajo y otro personal. Estos campos se denominan campos múltiples.
Para mostrar los valores necesarios de un campo múltiple en un documento, utiliza uno de estos tres modificadores.
El modificador ~mfirst= muestra uno o todos los valores del campo. Funciona con los campos del sistema del CRM, por ejemplo, Teléfono, Correo electrónico, Messenger, así como con los campos múltiples personalizados.
Campos del sistema en el CRM
mfirst=y: solo el primer valor. Utilízalo si el documento necesita un único número principal. Por ejemplo,{ContactPhone~mfirst=y}mostrará el primer teléfono del contacto.mfirst=n: todos los valores. Utilízalo si necesitas mostrar todos los números a la vez. Por ejemplo, si un contacto tiene dos teléfonos, uno del trabajo y otro móvil,{ContactPhone~mfirst=n}mostrará ambos separados por comas: +34 111 111 111, +34 999 999 999.
De forma predeterminada, los valores se separan con una coma. Si necesitas que cada número aparezca en una línea independiente, por ejemplo, en un acta o un contrato donde la lista de teléfonos sea más fácil de leer en formato de columna, añade ~mseparator=2. Entonces {ContactPhone~mfirst=n,mseparator=2} mostrará:
+34 111 111 111
+34 999 999 999
El modificador ~index= muestra un producto concreto de la lista de productos de una negociación. La numeración comienza desde cero: el primer producto es ~index=0, el segundo ~index=1, y así sucesivamente.
index=0: el primer producto. Por ejemplo,{ProductsProductName~index=0}mostrará el nombre del primer producto de la negociación.index=1: el segundo producto. Por ejemplo,{ProductsProductName~index=1}mostrará el nombre del segundo producto.index=2: el tercer producto. Por ejemplo, si la negociación contiene tres productos: portátil, ratón y bolsa, entonces{ProductsProductName~index=2}mostrará bolsa.
El modificador funciona solo con la lista de productos y únicamente si el código del campo está colocado fuera de la tabla en la plantilla. No funciona con los campos del sistema ni con los campos personalizados; para ellos utiliza ~mfirst=.
El modificador ~all=y muestra todos los elementos del campo Vincular a elementos de CRM. Este es un campo del sistema que se crea en la configuración del CRM. Permite vincular, por ejemplo, otras entidades del CRM a una negociación, como varias compañías o cotizaciones.
all=y: todos los elementos vinculados. Por ejemplo, si una negociación está vinculada a dos compañías y una cotización,{CódigoDelCampo~all=y}mostrará los ID de los tres elementos separados por comas.
Este modificador no funciona con otros campos.
- Un modificador es un código especial que cambia el formato de un campo.
- Los modificadores se encuentran dentro del código simbólico después de la tilde (
~). Por ejemplo, en el código{DocumentCreateTime~d.m.Y h:i:s}, DocumentCreateTime es el código simbólico del campo y d.m.Y h:i:s es el modificador. - En Bitrix24, se admiten varios tipos de modificadores: fecha y hora, dirección, nombre, importe total, teléfono, texto.
- Usando modificadores, puedes mostrar tanto todos los valores de un campo múltiple como uno específico, por ejemplo, el tercer elemento de la lista.
Resumen
Artículos recomendados: