Marcadores

Permiten definir expresiones que obtengan un resultado que contenga información de elementos de entorno o elementos relacionados con el proceso de ejecución, para ello se pueden componer expresiones que contengan vínculos a distintos elementos.

Tipos de marcadores	Ejemplo de formato
De entorno	{@CompanyName}
De parámetro	{?NumDecimales}
De dato	{#Clientes.Nombre}
De función	{=DataSum(Lineas.Cantidad)}

Los marcadores pueden contener dos partes separadas por dos puntos ( : )

• Valor, que indica el tipo de elemento campo, parámetro, variable de entorno, … utilizado para obtener el dato correspondiente y realizar algún tipo de operación sobre dicho valor.
• Formato, que permite formatear el valor utilizando una cultura y expresión de formato establecida.

Los marcadores permiten establecer un formato en función del tipo de dato correspondiente al elemento, usando las cadenas de formato de .NET para formatear dicho dato.

Tipos de dato	Ejemplo de formato
Numérico	{#Notas.ImporteNeto:#,##0.00} {#Notas.ImporteNeto:[es]N2} {#Notas.ImporteNeto:[{@UserCulture}]N2}
Fecha y hora	{@TodayServer:dd/MM/yyyy HH:mm} {@TodayServer:[en-US]g} {@TodayServer:[{@UserCulture}]g}
Texto literal (sin formateos, ni conversiones)	{?CondicionSQL:@}

También se pueden definir operaciones básicas con el dato correspondiente al elemento, haciendo que dichos operadores sean considerados como caracteres reservados y no debiendo utilizarse en el nombre de los elementos. En el caso de las fechas y horas se debe permitir realizar dichas operaciones con las diferentes partes de la fecha (día, mes, año, …)

Operadores	Descripción	Ejemplo
+	Sumar	{#EjercicioAnt[+1]}	Incrementa 1 al dato del campo EjercicioAnt
–	Restar	{@TodayServer[-1Y][-1M]}	Reduce 1 año y 1 mes a la fecha actual
*	Multiplicar	{#Valor[*10]}	Multiplica por 10 el dato del campo Valor
/	Dividir	{#Valor[/100]}	Divide por 100 el dato del campo Valor

Cultura

La cultura se tomará de la parte de configuración y debe ir entre corchetes. Si no se indica ninguna cultura, por defecto se utilizará la cultura de la empresa.

Para la expresión {Notas.ImporteNeto:[es]N2}, se tomará es como cultura para aplicar el formato.

La aplicación de la cultura sigue el estándar definido por .NET CultureInfo Class (System.Globalization).

Formato

Para aplicar formato a los valores hay que tener en cuenta la cultura a aplicar y la cadena que define el propio formato.

Para la expresión {#Notas.ImporteNeto:[es]N2}, suponiendo que obtenemos el dato 123,1 la respuesta obtenida sería “123,10”.

Los formatos son los definidos por el estándar de .NET. Aquí adjuntamos los enlaces de referencia:

Formatos numéricos:

• Cadenas con formato numérico estándar
• Cadenas con formato numérico personalizado

Formatos de fecha / hora

• Cadenas con formato de fecha y hora estándar
• Cadenas con formato de fecha y hora personalizado

Marcadores de entorno

En la definición del vínculo con marcadores de entorno se deberá incluir el símbolo @ como prefijo del elemento, por ejemplo: {@TodayServer}.

Puede consultar toda la lista de marcadores de entorno disponibles.

Marcadores de parámetro

En la definición del vínculo con marcadores de entorno se deberá incluir el símbolo ? como prefijo del elemento, por ejemplo: {?NumDecimales}.

Desde la opción de parámetros o parámetrización de la empresa puede consultar todos los parámetros disponibles.

Marcadores de dato

En la definición del marcador de dato, se especificará el símbolo # como prefijo del elemento, por ejemplo: {#Tabla.Campo}.

Este marcador debe existir en la expresión resultando, según donde se esté aplicando.

Marcadores de función

En la definición del marcador con funciones se deberá incluir el simbolo = como prefijo del elemento, por ejemplo: {=DataCount(Campo)}

Puede consultar toda la lista de marcadores de función disponibles.

Bucles en plantillas

Se ha incluido la posibilidad de realizar bucles con la etiqueta ForEach en las plantillas de notificaciones, lo cual permite, representar la información de una expresión.

Ejemplo:

Estos son los vencimientos de su factura.
<br><br>
<ForEach NAME="Vencimientos">
{#FechaEmision:[es]d} - {#FechaVto:[en]d} - {#Importe:[en]N2}<br> </ForEach>