Marcadores | Aliquo Software https://www.aliquo.software Software de gestión de negocios Tue, 20 May 2025 12:15:01 +0000 es hourly 1 https://wordpress.org/?v=6.9.4 https://www.aliquo.software/wp-content/uploads/2022/03/cropped-Q-500X500-32x32.png Marcadores | Aliquo Software https://www.aliquo.software 32 32 Marcadores de función https://www.aliquo.software/documentacion/configuracion/configuracion_marcadores/functionmarkers/ Thu, 30 Jun 2022 15:58:12 +0000 https://www.aliquo.software/?p=22714 Los marcadores de función permiten obtener información del sistema u operaciones sobre los datos de una expresión dada y se utilizará el carácter punto y coma (;) como separador de los distintos parámetros de la función, pudiendo indicarse directamente el valor del parámetro o incluyéndolo entre comillas dobles (").

MarcadorValorEjemplos
{=DataCount(table)}Devuelve el número de elementos que contiene la tabla indicada.

Parámetros:
– table: nombre de la tabla sobre la cual contar los elementos.
{=DataCount(Tabla)}
{=DataSum(field)}Devuelve la suma del campo indicado.

Parámetros:
– field: nombre del campo que contiene el valor a sumar.		{=DataSum(Tabla.Campo)}
{=DataMin(field)}Devuelve el valor más bajo del campo indicado.

Parámetros:
– field: nombre del campo sobre el cual se obtendrá el valor mínimo.		{=DataMin(Tabla.Campo)}
{=DataMax(field)}Devuelve el valor más alto del campo indicado.

Parámetros:
– field: nombre del campo sobre el cual se obtendrá el valor máximo.		{=DataMax(Tabla.Campo)}
{=DataFile(field)}Devuelve el contenido del archivo correspondiente al identificador del archivo indicado en el campo.

Parámetros:
– field: nombre del campo que contiene el Id del archivo.		{=DataFile(Campo)}
{=DataImageFile(field; width; height; resolution)}
{=DataImageFile(field; width; height; resolution; hAlign; vAlign)}		Devuelve la imagen del archivo correspondiente al identificador del archivo indicado en el campo, así como los ajustes de tamaños, resolución y orientación deseados.

Parámetros:
– field: nombre del campo que contiene el Id del archivo de imagen.
– width: ancho de la imagen resultante.
– height: altura de la imagen resultante.
– resolution: resolución de la imagen resultante.
– hAlign: alineación horizontal de la imagen del archivo dentro del marco de la imagen resultante (0 – Izquierda, 1 – Centro, 2 – Derecha).
– vAlign: alineación vertical de la imagen del archivo dentro del marco de la imagen resultante (0 – Superior, 1 – Centro, 2 – Inferior).		{=DataImageFile(Campo;200;200;150)}
{=DataImageFile(Campo;200;200;150;1;1)}
{=DataImageBarcode(field; type; width; height)}
{=DataImageBarcode(field; type; width; height; showText)}
{=DataImageBarcode(field; type; width; height; showText; noPadding)}		Devuelve la imagen de un tipo de código de barras correspondiente al contenido del campo indicado.

Parámetros:
– field: nombre del campo que contiene el texto a representar.
– type: tipo de código de barras a representar (CODE_39, CODE_128, GS1_128, EAN_13, QR_Code).
– width: ancho de la imagen resultante.
– height: altura de la imagen resultante.
– showText: indica si se mostrará el texto del contenido representado (true, false).
– noPadding: no agrega un área blanca alrededor del código de barras generado.		{=DataImageBarcode(Campo;EAN_13;200;100)}{=DataImageBarcode(Campo;QR_CODE;100;100;false)}
{=DataImageBarcode(Campo;QR_CODE;100;100;false;true)}
{=DataJoin(field)}
{=DataJoin(field; sep)}
{=DataJoin(field; sep; prefix)}
{=DataJoin(field; sep; prefix; suffix)}		Devuelve un texto formado con los contenidos del campo indicado, separando cada contenido por el carácter indicado, por defecto la coma (,).
Además se puede establecer un prefijo y/o un sufijo para cada uno los contenidos del campo.

Parámetros:
– field: nombre del campo que contiene el dato.
– sep: carácter utilizado como separador.
– prefix: cadena que se incluirá como prefijo del dato.
– suffix: cadena que se incluirá como sufijo del dato.		{=DataJoin(Tabla.Campo)}
{=DataJoin(Tabla.Campo;"–")}
{=DataJoin(Tabla.Campo;"–";"[")}
{=DataJoin(Tabla.Campo;"–";"[";"]")}
{=TableUserConditions(table)}Devuelve la condición de usuario correspondiente a la tabla indicada.

Parámetros:
– table: nombre de la tabla sobre la cual se obtendrá la condición.
{=TableUserConditions("Clientes")}
{=FirstMonthDayDate(date)}Devuelve la fecha correspondiente al primer día del mes de la fecha indicada.

Parámetros:
– date: fecha sobre la cual obtener el primer día del mes.		{=FirstMonthDayDate({@TodayServer})}
{=LastMonthDayDate(date)}Devuelve la fecha correspondiente al último día del mes de la fecha indicada.

Parámetros:
– date: fecha sobre la cual obtener el último día del mes.		{=LastMonthDayDate({@TodayServer})}
{=FirstWeekDayDate(date)}
{=FirstWeekDayDate(date; culture)}		Devuelve la fecha correspondiente al primer día de la semana de la fecha indicada, utilizando la cultura de la empresa o la cultura indicada.

Parámetros:
– date: fecha sobre la cual obtener el primer día de la semana.
– culture: cultura utilizada en el proceso.		{=FirstWeekDayDate({@TodayServer})}
{=FirstWeekDayDate({@TodayServer};{@UserCulture})}
{=LastWeekDayDate(date)}
{=LastWeekDayDate(date; culture)}		Devuelve la fecha correspondiente al último día de la semana de la fecha indicada, utilizando la cultura de la empresa o la cultura indicada.

Parámetros:
– date: fecha sobre la cual obtener el último día de la semana.
– culture: cultura utilizada en el proceso.		{=LastWeekDayDate({@TodayServer})}
{=LastWeekDayDate({@TodayServer};{@UserCulture})}
{=ListMonths()}
{=ListMonths(culture)}		Devuelve una cadena formada con los nombres y números de los meses, separando con punto y coma (;) el nombre y número del mes, y separando con una barra vertical (|) los distintos meses (por ejemplo: Enero;1|Febrero;2|…). Además se utilizará la cultura de la empresa o la cultura indicada.

Parámetros:
– culture: cultura utilizada en el proceso.		{=ListMonths()}
{=ListMonths("en-US")}
{=ListMonths({@UserCulture})}


]]> Marcadores de entorno https://www.aliquo.software/documentacion/configuracion/configuracion_marcadores/environmentmarkers/ Thu, 30 Jun 2022 15:58:04 +0000 https://www.aliquo.software/?p=22665 Los marcadores de entorno permiten incorporar información del entorno que se obtiene de la empresa, del usuario, del servidor o del registro actual.


Marcadores de servidor

MarcadorValor
{@TodayServer}Fecha y hora del servidor
{@TodayServerYear}Año de la fecha del servidor
{@TodayServerMonth}Mes de la fecha del servidor
{@TodayServerDay}Día de la fecha del servidor
{@TodayServerUTC}Fecha y hora UTC actual
{@TodayServerUTCYear}Año de la fecha UTC actual
{@TodayServerUTCMonth}Mes de la fecha UTC actual
{@TodayServerUTCDay}Día de la fecha UTC actual


Marcadores de usuario

MarcadorValor
{@UserId}Identificador de usuario
{@UserName}Nombre de usuario
{@UserEmail}E-mail de usuario
{@UserLanguage}Idioma del usuario
{@UserCulture}Cultura del usuario
{@UserTimeZone}Desplazamiento horario del usuario, formato ([+|-]TZH:TZM)
{@UserAgentCode}Código de agente correspondiente al usuario
{@UserEmployeeCode}Código de empleado correspondiente al usuario


Marcadores de empresa

MarcadorValor
{@CompanyName}Nombre común de la empresa
{@CompanyAddress}Dirección de la empresa
{@CompanyCity}Localidad de la empresa
{@CompanyState}Provincia de la empresa
{@CompanyZipCode}Código postal de la empresa
{@CompanyCountry}Nombre del país de la empresa
{@CompanyCountryCode}Código del país de la empresa
{@CompanyVatName}Nombre físcal de la empresa
{@CompanyVatNumber}N.I.F. de la empresa
{@CompanyEmail}E-mail de la empresa
{@CompanyWeb}Página web de la empresa
{@CompanyPhone1}Teléfono 1 de la empresa
{@CompanyPhone2}Teléfono 2 de la empresa
{@CompanyPhone3}Teléfono 3 de la empresa
{@CompanyCulture}Cultura de la empresa
{@FinanceStartDate}Fecha de inicio contable


Marcadores de analítica

MarcadorValor
{@Dimension1Name}Nombre de la dimensión 1
{@Dimension1ForSupplier}Indica si la dimensión 1 está activa para proveedores
{@Dimension1ForCustomer}Indica si la dimensión 1 está activa para clientes
{@Dimension1ForProduct}Indica si la dimensión 1 está activa para artículos
{@Dimension1ForAccount}Indica si la dimensión 1 está activa para cuentas
{@Dimension1ForFixedAsset}Indica si la dimensión 1 está activa para activos fijos
{@Dimension2Name}Nombre de la dimensión 2
{@Dimension2ForSupplier}Indica si la dimensión 2 está activa para proveedores
{@Dimension2ForCustomer}Indica si la dimensión 2 está activa para clientes
{@Dimension2ForProduct}Indica si la dimensión 2 está activa para artículos
{@Dimension2ForAccount}Indica si la dimensión 2 está activa para cuentas
{@Dimension2ForFixedAsset}Indica si la dimensión 2 está activa para activos fijos
{@Dimension3Name}Nombre de la dimensión 3
{@Dimension3ForSupplier}Indica si la dimensión 3 está activa para proveedores
{@Dimension3ForCustomer}Indica si la dimensión 3 está activa para clientes
{@Dimension3ForProduct}Indica si la dimensión 3 está activa para artículos
{@Dimension3ForAccount}Indica si la dimensión 3 está activa para cuentas
{@Dimension3ForFixedAsset}Indica si la dimensión 3 está activa para activos fijos
{@Dimension4Name}Nombre de la dimensión 4
{@Dimension4ForSupplier}Indica si la dimensión 4 está activa para proveedores
{@Dimension4ForCustomer}Indica si la dimensión 4 está activa para clientes
{@Dimension4ForProduct}Indica si la dimensión 4 está activa para artículos
{@Dimension4ForAccount}Indica si la dimensión 4 está activa para cuentas
{@Dimension4ForFixedAsset}Indica si la dimensión 4 está activa para activos fijos
{@Dimension5Name}Nombre de la dimensión 5
{@Dimension5ForSupplier}Indica si la dimensión 5 está activa para proveedores
{@Dimension5ForCustomer}Indica si la dimensión 5 está activa para clientes
{@Dimension5ForProduct}Indica si la dimensión 5 está activa para artículos
{@Dimension5ForAccount}Indica si la dimensión 5 está activa para cuentas
{@Dimension5ForFixedAsset}Indica si la dimensión 15 está activa para activos fijos
{@Dimension6Name}Nombre de la dimensión 6
{@Dimension6ForSupplier}Indica si la dimensión 6 está activa para proveedores
{@Dimension6ForCustomer}Indica si la dimensión 6 está activa para clientes
{@Dimension6ForProduct}Indica si la dimensión 6 está activa para artículos
{@Dimension6ForAccount}Indica si la dimensión 6 está activa para cuentas
{@Dimension6ForFixedAsset}Indica si la dimensión 16 está activa para activos fijos
{@Dimension7Name}Nombre de la dimensión 7
{@Dimension7ForSupplier}Indica si la dimensión 7 está activa para proveedores
{@Dimension7ForCustomer}Indica si la dimensión 7 está activa para clientes
{@Dimension7ForProduct}Indica si la dimensión 7 está activa para artículos
{@Dimension7ForAccount}Indica si la dimensión 7 está activa para cuentas
{@Dimension7ForFixedAsset}Indica si la dimensión 7 está activa para activos fijos
{@Dimension8Name}Nombre de la dimensión 8
{@Dimension8ForSupplier}Indica si la dimensión 8 está activa para proveedores
{@Dimension8ForCustomer}Indica si la dimensión 8 está activa para clientes
{@Dimension8ForProduct}Indica si la dimensión 8 está activa para artículos
{@Dimension8ForAccount}Indica si la dimensión 8 está activa para cuentas
{@Dimension8ForFixedAsset}Indica si la dimensión 8 está activa para activos fijos


Marcadores específicos


Marcadores para tareas de notificaciones
MarcadorValor
{@DateExecution}Fecha y hora de la ejecución de la tarea, según la zona horario indicada
{@DateExecutionUTC}Fecha y hora UTC de la ejecución
{@DateLastExecution}Fecha y hora de la última ejecución de la tarea, según la zona horario indicada
{@DateLastExecutionUTC}Fecha y hora UTC de la última ejecución


Marcadores para el envío automatizado de facturas de clientes
MarcadorValor
{@InvoiceMask}Devuelve el número de factura según la especificación del parámetro [MASCARA_DOCUMENTO]


]]> Marcadores https://www.aliquo.software/documentacion/configuracion/configuracion_marcadores/markers/ Thu, 30 Jun 2022 15:57:54 +0000 https://www.aliquo.software/?p=22674 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 marcadoresEjemplo 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 datoEjemplo 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, …)

OperadoresDescripciónEjemplo
+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:


Formatos de fecha / hora



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>

]]>