Configuración XML (Búsqueda) | Configuración XML (Vista Extendida)

Configuración de archivo XML para Nexus (Ingreso Múltiple)

Etiquetas

En su nueva edición Nexus permite la especificación de los atributos de la forma de Ingreso Múltiple a través de un archivo XML, que debe recibir el nombre de "configuracionnexus1.xml", y debe estar ubicado en la carpeta de la aplicación (ZZZ/BD/EE/EEE/). Para configurar tal archivo se utilizan las siguientes etiquetas:

Etiqueta	Uso	Atributos	Uso
<nexusconf></nexusconf>	Etiqueta general que identifica al archivo como configuracion XML para Nexus.
<incluir></incluir>	Archivos que se agregaran al ingreso múltiple a través de la facilidad php "include".
<titulo></titulo>	Se refiere tanto al título general del ingreso múltiple, como a los títulos de cada porción o forma de ingreso.
<enlace></enlace>	Enmarca el nombre de los enlaces a ser creados entre los datos a ser ingresados.	origen='[atributo]'	Nombre del atributo con el que se establecerá el enlace al realizar el ingreso.
<enlace></enlace>		numorigen='[numero]'	Número que corresponde al número del ingreso con el que se establecerá el enlace.
<linea></linea>	Cada una de las lineas que conforman la forma y que pueden estar integradas por uno o más campos.
<campo></campo>	Enmarca a los campos que componen cada línea en los ingresos.	size='[tamaño]'	Tamaño del campo cuando éste es del tipo text.
		maxlength='[longitud]'	Cantidad máxima de caracteres que admite el campo cuando éste es del tipo text.
		rows='[nro. filas]'	Cantidad de filas para los campos textarea.
		cols='[nro. columnas]'	Cantidad de columnas para los campos textarea.
		default='[valor campo]'	Valor inicial (default) para los campos tipo lista.
<ingresos></ingresos>	Indica el comienzo y fin de la definición de las formas de ingreso.
<ingresoX></ingresoX>	Determina si el componente que sigue contituye una forma de ingreso, siendo X el número que lo identifica (ingreso0, ingreso1, etc.)	div='[division]'	Div de ubicación en la página (reconocido por la hoja de estilos). Puede tomar los valores uno,dos,tres, etc.
		tabla='[tabla]'	Tabla en la que se llevará a cabo el ingreso de datos.
		obligatorio='[si/no]'	Determina si el ingreso de datos en la forma es obligatorio u opcional

Ejemplo

A continuación se explicará el uso de las etiquetas descritas a través de un ejemplo, observando en primera instancia cada fragmento del archivo XML junto con el resultado que arroja por pantalla, y finalmente una pantalla del resultado en conjunto.

Comencemos por observar cómo se indica el título principal de la página de ingreso múltiple.

Con lo cual se obtiene el siguiente resultado por pantalla.

Posteriormente se definen cada uno de los ingresos a incluirse en la pantalla de ingreso múltiple. Para ello se abre la etiqueta de "ingresos" y dentro de ella se comienza a definir ingreso por ingreso, tal como se evidencia en la secuencia presentada a continuación.

Los nombres utilizados para los campos corresponden a las definiciones que poseen internamente, y que pueden consultarse en el Módulo de Administración bajo la opción "Listar Tablas" si se tiene el acceso pertinente. Del fragmento anterior de XML se obtiene por pantalla lo siguiente:

Veamos ahora la definición de otro ingreso, prestando atención a la etiqueta "obligatorio" que permite indicar si esa forma de ingreso debe ser rellenada ya que la inclusión de sus datos es obligatoria en la operación. En este caso no se requiere de la información del representante para realizar el ingreso exitosamente.

Esto arroja como resultado:

Finalmente tenemos la forma para rellenar los datos de las interacciones, y se aprovechará la ocasión para ahondar en el modus operandi de la etiqueta "enlace".

Obsérvese que para las interacciones se tienen definidos dos enlaces que tienen el mismo valor para "origen", y que difieren tanto en el valor de "numorigen" como en los nombres que reciben (INTEnlace1 en un caso e INTPersona en otro). Ahora bien, el "origen" se refiere al nombre del campo (hidden) en la forma de la que se obtendrá el valor para establecer el enlace, y "numorigen" es el número de la forma específica que posee esa información, así si deseamos vincular la interacción a la empresa que estamos creando, el origen será "Codigo" (definido así por default), y la forma de la que se obtiene es la 0 (véase que en el XML la forma para empresa se denotó como ingreso0). Por tanto, el INTEnlace1 que relaciona a la empresa con la interacción recibirá el valor del código de la empresa creada. En conclusión, cuando se registren los datos, se crearán también las conexiones entre la empresa y su relacionado y entre estos y las interacciones, tal como se estableció en el archivo XML.

Finalmente uniendo todas las partes obtenemos la siguiente especificación en XML

Que se traduce en