Múltiples ficheros de personalización

Para reducir la complejidad del fichero de personalización (querycustom.xml) es posible repartir su contenido en múltiples ficheros y subcarpetas.

Para ello es necesario que exista la subcarpeta “ext” en la misma ubicación que el fichero querycustom.xml. Cualquier fichero que exista bajo esta carpeta o sus subcarpetas y con extensión XML se leerá buscando las mismas secciones que habitualmente se colocarían dentro del mismo fichero querycustom.xml.

Cuando se lanza la reconfiguración del servidor se realiza un “barrido” de todos los ficheros bajo la carpeta “ext” incorporando la configuración de forma secuencial.

IMPORTANTE! Si se repite una misma definición en múltiples ficheros (o dentro del mismo) 
y dentro de la carpeta "ext", la última definición sobreescribirá las anteriores. 
Un error fácil de cometer es hacer un copy&paste del mismo fichero XML en la misma carpeta 
con lo cual actualmente eso se traducirá en que existirá una configuración DUPLICADA con 
resultados impredecibles a menos que se le cambie la extensión al fichero "copia de seguridad".

1 Notas

Actualmente el reparto de secciones del XML se limita a los siguientes nodos:

• XMLExtAttributes: esto permite repartir la definición de los informes en múltiples ficheros lo que facilita bastante la búsqueda y organización. Por ejemplo: podemos tener un fichero con las definiciones de cada informe organizadas de la siguiente forma:
  • WorkerOldCounter_Dyn.xml: con la definición del informe correspondiente
  • WorkerCounter.xml: ídem
  • WorkerActionByNeed.xml: ídem
  • etc…
• Functions: esta sección permite definir funciones externas. También es posible sacar fuera del query o querycustom esta sección y se pueden repartir las definiciones de funciones en múltiples ficheros. Ver Biblioteca de funciones externas.

2 Ficheros de personalización por defecto

Por defecto se buscan ficheros adicionales de configuración en las siguientes carpetas (dentro de la carpeta upgrade, junto al query.xml std.):

• .\ext\global\*.xml
• .\ext\flavours\<sabor>\*.xml

El valor <sabor> dependerá de lo que se haya configurado para la instancia del servidor en la pestaña Variables del PlannerConfig en el campo Identificador de sabor. Su objetivo es seleccionar una parametrización por defecto preconfigurada que sea la más correcta para cada instancia arrancada del servidor.