Configuración XML (Búsqueda) | Configuración XML (Ingreso Múltiple)

Configuración de archivo XML para Nexus (Vista Extendida)

Etiquetas

En su nueva edición Nexus permite la especificación de los atributos de la Vista Extendida a través de un archivo XML, que debe recibir el nombre de "configext<nombre_tabla>.xml" (pej: configextPER), 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 a la vista extendida a través de la facilidad php "include".
<estilo></estilo>	Determina la hoja de estilos (.css) que se utilizará en la página.
<registro></registro>	Enmarca los detalles del registro base de la vista extendida, es decir, aquel registro que se seleccionó para observar su vista extendida.	tabla='[tabla]'	Nombre de la tabla para el registro base.
		actualizar='[si/no]'	Determina si el registro tendrá la opción de actualizar activada.
		ver='[si/no]'	Determina si el registro tendrá la opción de ver activada.
<campo></campo>	Enmarca a los campos que componen cada línea tanto del registro base, como de los reportes asociados a él.
<reportes></reportes>	Indica el comienzo y fin de la definición de los reportes asociados al registro base.
<reporteX></reporteX>	Determina si el componente que sigue contituye un reporte, siendo X el número que lo identifica (reporte0, reporte1, 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.
		agregar='[si/no]'	Determina si el registro tendrá la opción de agregar activada.
		hijo='[I/E/A/1-9]'	Determina si habrá la posibilidad de añadir elementos de otras vinculados a cada registro. Por ejemplo hijo='I' agrega la columna para añadir interacciones por cada registro.
		listarsup='[si/no]'	Si el reporte utilizará listarsup para construirse.
		ordenamiento='[atributo] [tipo_ordenamiento]'	Determina el criterio a seguir para el despliegue de la información en el reporte. El valor que se le puede asignar a "atributo" corresponde a cualquier campo de la tabla para la que se construye el reporte en su formato interno, y los valores para "tipo_ordenamiento" pueden ser ASC y DESC (nuevo)
		link='[atributo]'	Determina sobre qué campo del reporte se tendrá el link de visualización. Si este parametro se combina con listarsup='si', no se crea un link en el atributo pasado, sino que se incluye la columna clave que tiene la opción VER.
		cantlistar='[#items]'	Cuando se utiliza listarsup='si' se puede establecer la cantidad de items que se mostrarán por vez con este parámetro. Toma valores numéricos del 1 en adelante obviando la cantidad máxima a listar establecida en el setup.
<tablas></tablas>	Enmarca el listado de tablas que se utilizarán en los reportes.
<tabla></tabla>	Delimita el nombre de cada tabla a ser utilizada. Si se listan varias tablas se debe colocar de primera la tabla principal (la utilizada para FROM), y luego las tablas que alimentan las condiciones de búsqueda para listar.
<campos></campos>	Delimita el listado de campos específicos que se desplegarán en el reporte.
<condiciones></condiciones>	Delimita el listado de condiciones a ser cumplidas por los registros que se muestran en el reporte.
<conexion></conexion>	Permite establecer el conector que se utilizará para el conjunto de condiciones listadas (AND, OR).	operador='[AND/OR]'	Operador lógico que interconecta las condiciones para la construcción del reporte.
<condicion></condicion>	Cada una de las condiciones a ser satisfechas

Ejemplo

Aclaremos en primera instancia que una vista extendida no es más que el despliegue, en una sola pantalla, de una cantidad de reportes asociados a un registro, y en el caso que vamos a ejemplificar implicará mostrar los datos de los relacionados e interacciones vinculados a una empresa específica.

Se explicará el uso de las etiquetas descritas, observando primero 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 lo que se desplegará para el registro base

Lo anterior se muestra por pantalla como se verá a continuación. Préstese atención en las opciones ver='si' y actualizar='si' que provocan que aparezcan los íconos de visualización y de actualización al lado del nombre de la empresa.

Posteriormente se indican los reportes que desean desplegarse en concordancia con el registro base. Para obtener el nombre interno de los campos que desean desplegarse remítase a la opción "Listar Tablas" del menú de Administración, disponible para aquellos con la permisología pertinente.

En este punto es conveniente resaltar las opción agregar='si' que como se verá en la pantalla resultante, activa la opción para agregar contactos; la opción link='PERNombre' que activa un link de visualización de detalles en el campo que se le indica, y la opción hijo='I' que agrega la columna de manipulación de interacciones en el reporte que se construye.

Otro punto al que se debe hacer referencia es la posibilidad de utilizar o no listarsup para la construcción del reporte, lo cual se indica a través de la opción listarsup='si'. Cabe destacar que listarsup es un método que tiene definido net2client para la construcción de reportes y que básicamente se diferencia (visualmente hablando) de las construcciones puras en html (listarsup='no') en que aparece el botón de regresar y una calculadora con el número total de registros conseguidos, tal como se evidencia en el siguiente ejemplo que lista nuevamente los contactos, pero ahora con listarsup.

Veamos ahora la definición para el reporte de acciones que como se verá utiliza listarsup. Cabe señalar que en el caso de las interacciones éstas se ordenan por default por el campo fecha y hora. Si el reporte fuera de contactos se ordenaría por nombre.

Lo cual arroja como resultado:

Finalmente se tiene el archivo completo XML con el despliegue por pantalla mostrado a continuación