Net2Client tiene una serie de programas que pueden ser invocados por el asesor, permitiendo la reutilización de código y acelerando los tiempos de desarrollo. En este capítulo se descirbe como utilizar algunos de estos programas. Anteriormente los programas act.htm y ver.htm eran llamados para actualizar y visualizar registros (respectivamente) y actint.htm y verint.htm, con el mismo propósito, pero en los registros de la tabla INT. Todos esos programas fueron reemplazados por el programa rec.htm, sin embargo se han dejado en el sistema por compatibilidad hacia atrás, pero no debería ser utilizados a partir de la versión 4.4.
El programa rec.htm y su pareja rec.php permiten el ingreso, la actualización y la visualización de un registro de una tabla. El primer programa presenta la pantalla de ingreso o la visualización de datos y el segundo, cuando se trata de una actualización, la actualización, propiamente dicha. Adicionalmente rec.htm tiene un botón que permite que el usuario elimine el registro, en cuyo caso se invoca al programa eliminar.htm (para confirmar la eliminación) y luego eliminar.php (para realizarla).
Para invocar el programa rec.htm, además del "COKO", se deben pasar los parámetros siguientes en el Query String:
echo "<a href=rec.htm?$COKO"."PER=0,Enlace1=$row1[AR1Codigo],A=$CookieAGENTE> <img border='0' src='imagenes/mas.gif' alt='Haga clic aquí para añadir un contacto'></a>"
echo "<a href='act.htm?$COKO"."*PER=340'>340 - Juan Pérez</a>";
En el primer ejemplo, se han colocado las instrucciones para que haya una imagen con un signo más, que al ser pinchada lleve al programa de ingreso de datos, en donde se va a añadir un registro a la tabla PER, con el enlace a la tabla AR1 y el agente preinicializados.
En el segundo ejemplo, se está escribiendo "340 - Juan Pérez" como un enlace, que al ser pinchado va a permitir la visualización del registro número 340, perteneciente a Juan Pérez. Si se omite el asterisco delante de "PER", en vez de la visualización, se tendría la oportunidad de realizar una actualización.
El programa rec.htm ha sido diseñado para que sirva en una gran variedad de casos. Su objetivo es servir para cualquier necesidad de visualización, creación o actualización de un registro. Su utilización eficiente y controlada a través de los parámetros que se van a mencionar a continuación y del uso de hojas de estilos evita tener que escribir programas, maximizando la re-utilización de código. Para el aspecto, se han añadido todo tipo de "clases" y "id" en el código generado, de forma que el asesor pueda controlar la apariencia de los datos e inclusive pueda darle dinamismo a la forma, ocultando y mostrando datos según los datos ingresados. Para hacer esto, se recomienda usar el botón derecho y "ver código fuente" para ver el código y conocer las etiquetas que se están utilizando.
| Parámetro | Uso |
|---|---|
| CamposAMostrar | Permite limitar los campos que van a aparecer en la actualización. Para hacer esto, se debe pasar como parámetro la variable CamposAMostrar con los nombres internos que se desea que aparezcan, separados por comas. Cualquier campo que no esté en esa lista, será ignorado. |
| AjustarFrame | Escribir "SI" cuando el programa es ejecutado dentro de un iframe y se quiere que el frame se ajuste al tamaño apropiado |
| Ancho | Ancho, en pixeles, que se desea para mostrar los resultados. También puede ser indicado en forma porcentual |
| Titulo | Título deseado para la pantalla de actualización. Si se escribe "NO", omite el título. Si no se incluye ningún valor, escribe el nombre de la tabla y después, cuando se trata de una actualización, el número de registro y el nombre del mismo. |
| FrameResultadoOK | |
| HojaEstilos | |
| OcultarDueno | Si tiene el valor "SI" no pone el dueño del registro |
| OcultarCodigo | Si tiene el valor "SI" no pone el código del registro |
| Control de botones y enlaces | |
| BotonesAccion | Indica donde se desean los botones de Acción ("OK", "Cancelar" y "Eliminar Registro"). Valores posibles:
Este parámetro es definido en la tabla de parámetros |
OmitirBotonOK |
Si se escribe "SI" omite el botón de (OK,Cancelar,Eliminar Registro), en las actualizaciones |
| ImgBotonOK ImgBotonCancel ImgBotonDel |
Si se incluye un valor, lo utiliza para poner el botón de (OK,Cancelar,Eliminar Registro) como una imagen, en vez de un botón con un texto. En este caso, se puede utilizar un texto en el "alt" con el parámetro siguiente. |
| AltImgBotonOK AltImgBotonCancel AltImgBotonDel |
Texto deseado como "alt" cuando se utiliza una imagen. Si se omite se utiliza el texto (OK,Cancelar,Eliminar Registro) |
| TextoBotonOK TextoBotonCancel TextoBotonDel |
El texto deseado para el botón de (OK,Cancelar,Eliminar Registro). Si se omite se utiliza la palabra ("OK","Cancelar","Eliminar Registro") |
| NOENLACES | Si se escribe el valor "SI", se omiten los enlaces a registros hijos cuando se trata de ver un registro |
El programa rec.php, normalmente retorna al último listado que se realizado. Si se desea un retorno diferente, se debe grabar en el campo COKRetorno del "cokie" del sistema la dirección de regreso, o incluir el valor "Actual", si se quiere regresar a la pantalla que invocó, directamente con un goback.
GrabarCokie("COKRetorno","Actual");
o
GrabarCokie("COKRetorno","http://www.mipagina.com/gracias.htm");
">Más información sobre retornos
El programa act.htm y su pareja act.php permiten el ingreso y la actualización de un registro de una tabla. El primer programa presenta la pantalla de ingreso de datos y el segundo realiza la actualización. Adicionalmente act.htm tiene un botón que permite que el usuario elimine el registro, en cuyo caso se invoca al programa eliminar.htm (para confirmar la eliminación) y luego eliminar.php (para realizarla).
Para invocar el programa act.htm, además del "COKO", se deben pasar los parámetros siguientes:
echo "<a href=act.htm?$COKO"."PER,0,Enlace1=$row1[AR1Codigo],A=$CookieAGENTE> <img border='0' src='imagenes/mas.gif' alt='Haga clic aquí para añadir un contacto'></a>"
echo "<a href='act.htm?$COKO"."AR3,0,EnlaceP=$Codigo'> <img border='0' src='imagenes/mas.gif' alt='Haga clic aquí para añadir una orden a este contacto'></a>";
Es posible limitar los campos que van a aparecer en la actualización. Para hacer esto, se debe pasar como parámetro la variable CamposAMostrar con los nombres internos que se desea que aparezcan. Cualquier campo que no esté en esa lista, será ignorado.
El programa act.php, normalmente retorna al último listado que se realizado. Si se desea un retorno diferente, se debe grabar en el campo COKRetorno del "cokie" del sistema la dirección de regreso, o incluir el valor "Actual", si se quiere regresar a la pantalla que invocó, directamente con un goback.
GrabarCokie("COKRetorno","Actual");
o
GrabarCokie("COKRetorno","http://www.mipagina.com/gracias.htm");
">Más información sobre retornos
Este programa es muy similar al anterior (act.htm), con la única diferencia en que no recibe el parámetro XXX (nombre de la tabla) ya que la actualización es siempre a la tabla INT. También invoca los programas act.php y eliminar.htm/php.
El programa ver.htm permite la consulta de un registro de una tabla. Adicionalmente ver.htm tiene un botón que permite modificar un registro, invocando al act.htm y al act.php, y otro botón que permite que el usuario elimine el registro, en cuyo caso se invoca al programa eliminar.htm (para confirmar la eliminación) y luego eliminar.php (para realizarla).
Para invocar el programa ver.htm, además del "COKO", se deben pasar los parámetros siguientes:
echo "<a href=ver.htm?$COKO"."PER,6NOENLACES>
El programa ver.php, normalmente retorna al último listado que se realizado. Si se desea un retorno diferente, se debe grabar en el campo COKRetorno del "cokie" del sistema la dirección de regreso, o incluir el valor "Actual", si se quiere regresar a la pantalla que invocó, directamente con un goback.
GrabarCokie("COKRetorno","Actual");
o
GrabarCokie("COKRetorno","http://www.mipagina.com/gracias.htm");
">Más información sobre retornos
Este programa es muy similar al anterior (ver.htm), con la única diferencia en que no recibe el parámetro XXX (nombre de la tabla) ya que es el ver de la tabla INT. También invoca los programas act.htm/php y eliminar.htm/php.
El programa searchBoxes permite el despliegue de cajas de búsqueda sin la necesidad de incluir el paquete "nex" en las opciones de setup de una aplicación.
Se debe colocar un require de searchBoxes tomando en cuenta, por un lado, la ruta de ubicación de la aplicación que se está desarrollando y por otro, la ubicación de searchBoxes como tal (new/rutinas/). Se recomienda que el programa que realiza el require sea invocado a través de versup para tener disponibles las variables de ambiente. Necesita que antes del require se declare:
$NombreArchivo="configuracionPrueba.xml";
require("rutinas/searchBoxes.php");
$StringXML="<nexusconf><estilo>estilobusqueda.css</estilo>...."
require("rutinas/searchBoxes.php");
Sin ser llamado a través de versup se deben declarar una serie de variables para la correcta ejecución del programa:
$Idioma="esp";
$RutaN2C="http://wwww.net2client.com/new";
$RutaAplic="http://wwww.net2client.com/ZZZ/07/30/300";
$BD="07";
$EEE="300";
$EE="30";
$CodigoAgente=$CookieAGENTE;
require("../../rutinas/searchBoxes.php");
Nótese que la ruta del require es distinta dado que se hace relativa a la aplicación y no a versup.