Estructura del archivo de configuracion

El artículo refleja el resumen de las secciones del archivo de configuración (querycustom).

ServerConfig

La sección ServerConfig contiene información en formato de fichero .INI acerca de variables que actúan de forma global y común para todos las personas usuarias del sistema. Las variables de esta sección pueden afectar tanto al comportamiento de los clientes como al funcionamiento interno del servidor.

Opciones configurables en esta sección:

Propiedades asociadas a la ficha del empleado o empleada:

Propiedades de configuración del Gantt

PredefinedQueries

El nodo PredefinedQueries contiene el conjunto de consultas predefinidas que se ejecutan contra la base de datos para obtener información como listados de objetos maestros, selectores, informes, etc.

En la categoría Consultas preprogramadas encontraremos documentación sobre las posibilidades que ofrece esta sección.

DefaultObjectValues

El nodo DefaultObjectValues contiene el conjunto de expresiones asociadas a los eventos Crear y Actualizar objetos que pueden configurarse para modificar o inicializar el valor por defecto de cualquier atributo automático de la clase, instantes antes de grabar un objeto

En la categoría DefaultObjectValues encontraremos documentación sobre las posibilidades que ofrece esta sección.

AutoControlObjectValues

El nodo AutoControlObjectValues contiene el conjunto de expresiones asociadas a los eventos Crear y Actualizar objetos que pueden configurarse para validar las altas y/o modificaciones de cualquier clase de objeto.

En la categoría AutoControlObjectValues encontraremos documentación sobre las posibilidades que ofrece esta sección.

ClientScripts

En esta sección se configuran los diferentes eventos que se desean capturar para lanzar scripts o evaluar expresiones desde el cliente BOLD WorkPlanner.

Ver más detalles en Capturar eventos de cliente.

TBoldActionList

En el archivo de configuración (QueryCustom.xml) existe una sección llamada TBoldActionConfigList que permite configurar las opciones disponibles desde el cliente WorkPlanner para cada perfil de usuaria usuario, o incluso para cada persona usuaria definida en el sistema. En la página Configuración de acciones disponibles se puede obtener información detallada de funcionamiento.

EditorsConfig

Este nodo permite configurar para los diferentes perfiles de la persona usuaria la visibilidad y posibilidad de modificación para cada uno de los campos de las entidades del sistema. Ver Configuración de visibilidad de campos para más información.

EnumDefs

Este nodo permite definir nuevos tipos de datos enumerados que luego pueden ser utilizados en los atributos extensibles de los objetos del sistema (ver artículo DynamicClasses: extensión del modelo de datos mediante clases dinámicas).

El formato de esta sección es similar al siguiente ejemplo:

 <EnumDefs>		
  <TEnumProvincia Query="TEnumProvincia"/>
  <TEnumEstudios Query="TEnumEstudios"/>
  <TEnumGenero v1="No definido" v2="Hombre" v3="Mujer"/>
  <TEnumCobro v1="Efectivo" v2="Cuenta corriente" v3="...."/>
  ...
 </EnumDefs>

Existen dos tipos de enum posibles en el sistema:

• Los que se definen directamente dentro del propio nodo (como TEnumCobro o TEnumGenero).
• Los que se definen utilizando una Tabla secundaria (en el ejemplo anterior TEnumProvincia o TEnumEstudios).

Valor interno de los valores de enum

La etiqueta que se indica en el enum se corresponde con el valor que aparece en pantalla, sin embargo, cada enum tiene un valor interno.

• Para enums como TEnumCobro o TEnumGenero: el valor interno va desde cero (para el primer valor etiquetado) y se va incrementando correlativamente. Por ejemplo en los casos anteriores sería el número v(i-1).
• Valor de tipo query: se corresponde con un identificador interno y único (como un objeto std. del sistema).

Personalizar el orden de aparición de los valores

Cuando la persona usuaria debe escoger un valor para un atributo de tipo enumerado se le presenta una lista de opciones en el mismo orden en que se definieron los diferentes valores. Por ejemplo supongamos el siguiente caso que define los diferentes valores posibles del estado para un contrato:

<EnumContractState v1="Borrador" v2="Rechazado" v3="Rechazado por empresa" v4="Aceptado" 
  v5="Entregado a RR.HH." 
  v6="Firmado" 
  v7="Pendiente impresión" v8="Impreso" 
  v9="Introducido en SIP" v10="Afiliado" v11="Relacionado" 
  v12="Entregado a nóminas" v13="Archivado" />

Los valores aparecerían en pantalla así:

1. Borrador
2. Rechazado
3. Rechazado por empresa
4. Aceptado
5. Entregado a RR.HH.
6. Firmado
7. Pendiente impresión
8. Impreso
9. Introducido en SIP
10. Afiliado
11. Relacionado
12. Entregado a nóminas
13. Archivado

El orden modificar el orden en que se le presentan las distintas opciones a la persona usuaria utilizando el atributo adicional sortOrder. Este campo indica el orden de cada definición del enum:

<EnumContractState v1="Borrador" v2="Rechazado" v3="Rechazado por empresa" v4="Aceptado" 
  v5="Entregado a RR.HH." 
  v6="Firmado" 
  v7="Pendiente impresión" v8="Impreso" 
  v9="Introducido en SIP" v10="Afiliado" v11="Relacionado" 
  v12="Entregado a nóminas" v13="Archivado" />
  sortOrder="1,2,3,4,5,7,8,6,9,10,11,12,13"/>

Entonces el orden en pantalla sería este otro:

1. Borrador
2. Rechazado
3. Rechazado por empresa
4. Aceptado
5. Pendiente impresión
6. Impreso
7. Entregado a RR.HH.
8. Firmado
9. Introducido en SIP
10. Afiliado
11. Relacionado
12. Entregado a nóminas
13. Archivado

DynamicClass

Este nodo permite ampliar o extender los objetos del sistema mediante nuevos atributos agrupados bajo “clases”. Cada clase contiene a su vez otras clases o bien atributos básicos directamente. Las clases se asocian a los objetos del sistema de forma que aparecen vinculados en las diferentes pantallas (ver DynamicClasses: extensión del modelo de datos mediante clases dinámicas).

ClientFunctions

Este nodo permite definir fechas de entrada al ejecutar los informes en la aplicación Full Web. Por ejemplo:

  <ClientFunctions>
	<ClientFunction Name="EnumWorkerPayRollCustomDatesCounter_StartDate">
		<![CDATA[IfElse(Between(Day(Today()), 1, 6 ) OR UserLogged()=="admingps", 
                  ISODateAsString(StartOfTheMonth(StartOfTheMonth(Today())-1)), ISODateAsString(StartOfTheMonth(Today())))
                ]]>
	</ClientFunction>
	<ClientFunction Name="EnumWorkerPayRollCustomDatesCounter_EndDate">
		<![CDATA[IfElse(Between(Day(Today()), 1, 6 ) OR UserLogged()=="admingps", 
                  ISODateAsString(EndOfTheMonth(StartOfTheMonth(Today())-1)), ISODateAsString(Today()+0.5))
                ]]>
	</ClientFunction>
  </ClientFunctions>

Cada vez que se abra el informe EnumWorkerPayRollCustomDatesCounter se pondrán las fechas resultado del cálculo de las anteriores expresiones.

Ver también Personalización