Las plantillas de documentos contienen códigos simbólicos que se utilizan en lugar de diferentes datos.
Por ejemplo, el código {DocumentCreateTime}
utilizado en una plantilla de documento se reemplaza por el tiempo real de creación del documento en el formulario de impresión.
Aprenda más sobre los códigos simbólicos
Puede modificar códigos simbólicos en plantillas de documentos para utilizar diferentes formatos de datos según sus necesidades.
Tipos de modificadores
Agregue 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.Puede modificar códigos simbólicos para los siguientes tipos de datos:
Además, puede 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.
Ver las configuraciones de la plantilla
Por ejemplo, agregue la fecha y la hora de creación del documento utilizando el código {DocumentCreateTime~d.m.Y h:s}
.
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
Aprenda más sobre los posibles formatos de la fecha y la hora
Modificadores del nombre
Puede modificar el formato del nombre agregando palabras especiales en el código simbólico.
Por ejemplo, agregue el saludo, el nombre, la primera letra del segundo nombre y el apellido del cliente utilizando el código {FormattedName~Format=#TITLE# #NAME# #SECOND_NAME_SHORT# #LAST_NAME#}
.
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 puede modificarlo y usar un formato diferente.
Ver las configuraciones de la plantilla
Por ejemplo, agregue la dirección en el formato de América del Norte utilizando el código {Address~Format=3,Separator=3}
.
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
Puede 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.
Por ejemplo, agregue el importe total y la moneda utilizando el código {TotalSum~WZ=Y,NS=N}
.
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
Utilice el modificador ~format=
para cambiar el formato del número de teléfono.
Por ejemplo, agregue el número de teléfono del cliente utilizando el código {ClientPhone~format=E.164}
.
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
Utilice el modificador ~letterCase=
para cambiar el tamaño del texto.
Por ejemplo, escriba "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 CRM, hay campos múltiples, o sea, que pueden tener varios valores. Por ejemplo, en el campos estándar Teléfono, puede agregar varios números de teléfono.
Utilice el modificador ~mfirst=
para obtener varios valores de un campo múltiple:
mfirst=y
— obtener solo el primer valor del campomfirst=n
— obtener todos los valores del campo
Por ejemplo, agregue todos los números de teléfono del cliente utilizando el código {Phone~mfirst=n}
. Recuerde que también puede utilizar diferentes separadores.
Utilice el modificador ~index=
para obtener ciertos elementos de la lista. La numeración de los elementos de la lista empieza desde cero, por lo que ~index=1
es un modificador para obtener el segundo elemento de la lista.
Por ejemplo, agregue el tercer producto de la lista utilizando el código {ProductsProductName~index=2}
.
- 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, puede 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: