Velneo vmodapache V7 7.6

Transcripción

1 Qué es Velneo vmodapache V7?...2 Modo básico de funcionamiento del módulo Velneo vmodapache V7...2 Descargar, instalar y activar Velneo vserver V7...2 Descargar e instalar el módulo Velneo vmodapache V7...3 Descargar e instalar el servidor Apache y configurar en el archivo de configuración de Apache (httpd.conf) la carga del módulo Velneo vmodapache V7...3 Desarrollar e instanciar un proyecto que contendrá los procesos que, ejectuados desde la web, retornarán el código html a servir...3 Configurar en el archivo de configuración de Apache (httpd.conf) las directivas de virtualhost o location para el servicio de páginas de Velneo V7...3 Nomenclatura de objetos en urls...5 Procesos...5 Dibujos...7 Campos de tipo objeto dibujo...8 Variable CONTENT_TYPE...9 1

2 Qué es Velneo vmodapache V7? Se trata del módulo Apache para soluciones web. Es un módulo web del servidor Web Apache que permite servir vía web diversos objetos de instancias de un proyecto de Velneo V7. Desde un único servidor Apache podremos servir páginas de proyectos de distintintos servidores de Velneo V7 (Velneo vserver V7). En la versión 7.2 este módulo solamente está disponible para sistemas operativos Windows y es compatible solamente con la versión 2.2 de Apache. En la versión actual el módulo sirve procesos, dibujos y campos de tipo objeto dibujo. Modo básico de funcionamiento del módulo Velneo vmodapache V7 1) Al inciar el servidor web Apache se inicia el módulo, el cual conecta con el/los Velneo vserver V7. 2) Un navegador (IExplorer, Mozilla, etc.) hace una petición al servidor web de Apache. 3) Dependiendo de la url, el módulo Velneo vmodapache V7 procesa esa petición (según lo que hayamos especificado en la configuración del servidor web Apache). Si la petición no la procesa el módulo, se la pasa a Apache. 4) El módulo Velneo vmodapache V7 devuelve la salida, ya sea el resultado de un proceso (página web) o una imagen al servidor web Apache. 5) El servidor web Apache envía la salida al navegador. Esta configuración permite usar todas las funcionalidades del servidor web de Apache y distribuir la aplicación de Velneo V7 como queramos (no es necesario que el servidor web Apache esté en la misma máquina que Velneo vserver V7). Además Velneo vmodapache V7 es multi-hilo, por lo que es posible atender a multitutd de peticiones web de forma simultánea con un solo enganche. Desde la web podremos ejecutar, básicamente, procesos que retornarán el código html a servir. Esos procesos, en úlitma instancia, retornarán una cadena texto con el código html, mediante el comando de instrucción de proceso Set dato de retorno del proceso. Para poder servir páginas web desde aplicaciones de Velneo V7 necesitaremos: Descargar, instalar y activar Velneo vserver V7. Descargar e instalar el módulo Velneo vmodapache V7. Descargar e instalar la versión 2.2 del servidor Apache y configurar en el archivo de configuración de Apache (httpd.conf) la carga del módulo Velneo vmodapache V7. Desarrollar e instanciar un proyecto que contendrá los procesos que, ejectuados desde la web, retornarán el código html a servir. Configurar en el archivo de configuración de Apache (httpd.conf) las directivas de virtualhost o location para el servicio de páginas de Velneo V7. A continuación iremos explicando cada uno de estos pasos. Descargar, instalar y activar Velneo vserver V7 Encontrarás toda la información en el capítulo dedicado a Velneo vserver V7. 2

3 Descargar e instalar el módulo Velneo vmodapache V7 Accede a la página de descargas de este sitio web, descarga el producto e instálalo en la máquina donde vayas a instalar el servidor Apache. En este punto aclarar que el servidor Apache y Velneo vserver V7 no tienen por qué estar en la misma máquina; pueden estar en máquinas diferentes. Además, tal y como se comenta al comienzo de este capítulo, desde un único servidor Apache podemos servir páginas de distintos servidores de Velneo V7. Descargar e instalar el servidor Apache y configurar en el archivo de configuración de Apache (httpd.conf) la carga del módulo Velneo vmodapache V7 El nombre del archivo correspondiente al módulo vmodapache V7 se llama llama mod_velneo.so; éste no es instalado en el directorio de módulos de Apache, sino que se instala en el directorio de Velneo V7 por defecto (C:\Archivos de programa\velneo\v7); el motivo de ello es que dicho módulo usa una serie de librerías que son instaladas en dicho directorio. Por tanto, para declarar su carga, no debemos incluir la senda completa del mismo y entrecomillarla si ésta contiene espacios en blanco: #Carga el módulo de Velneo LoadModule velneo_module "C:/Archivos de programa/velneo/v7/mod_velneo.so" Desarrollar e instanciar un proyecto que contendrá los procesos que, ejectuados desde la web, retornarán el código html a servir Consultar en la zona info el capítulo dedicado a Velneo vdevelop V7. Configurar en el archivo de configuración de Apache (httpd.conf) las directivas de virtualhost o location para el servicio de páginas de Velneo V7 Podremos, o bien, establecer una directiva de location, o bien una directiva de virtualhost. La declaración de una directiva de location sería: <Location /senda_base> sethandler velneo Vrl vatp://usuario:contraseña@servidor[:num_puerto]/id_instancia </Location> senda_base será la senda base para la web del proyecto a servir. En el parámetro Vrl se indicará la VRL del servidor, usuario, contraseña e identificador de la instancia que va a ser atacada vía web. Si el usuario especificado no tiene contraseña, no se incluirá dicho parámetro, pero sí los dos puntos:...usuario:@servidor..." En el caso de que el usuario o la contraseña incluya caracteres especiales tales \, etc. éstos no podrán ser escritos directamente en la cadena sino que tendrán que ir codificados en su equivalente html (%CODIGO_CARACTER). Ejemplo: Ejemplo: Si la contraseña del usuario es 123@45, la especificaríamos así: 123%4045 3

4 Si el número de puerto del servicio VATP es el 690, no habrá que especificarlo tampoco en la VRL, ya que éste es el puerto por defecto para el servicio. Ejemplo #Ejemplo de directivas location Velneo en httpd.conf <Location /gestion> sethandler velneo Vrl </Location> Supongamos que en el proyecto de destino hemos creado un proceso llamado INDEX; la url para ejecutarlo sería: IP_SERVIDOR será la IP o el nombre del servidor donde está alojado el servidor apache. gestion es la senda base que hemos especificado en el archivo de configuración de Apache. index.pro Objeto a ejecutar de la instancia de Velneo, la extensión ".pro" lo identifica como un proceso. Declaración de una directiva de virtualhost: Esta podremos declararla tanto en el fichero httpd.conf como en el fichero httpd-vhosts.conf de Apache, en caso de hacerlo en el segundo, tendremos que asegurarnos que en el fichero httpd.conf se incluya la llamada al fichero httpd-vhosts.conf, mediante el comando: Include conf/extra/httpd-vhosts.conf Habitualmente este include suele venir declarado en el fichero pero a modo de comentario: #Include conf/extra/httpd-vhosts.conf Para habilitar la llamada simplemente habrá que quitarle el carácter #. La directiva de virtualhost la declararemos del modo siguiente: <VirtualHost *:número_puerto> ServerName nombre_servidor sethandler velneo Vrl vatp://usuario:contraseña@servidor[:num_puerto]/id_instancia </VirtualHost> número_puerto será el número de puerto de escucha para la web. nombre_servidor será el nombre del servidor virtual. En el parámetro Vrl se indicará la VRL del servidor, usuario, contraseña e identificador de la instancia que va a ser atacada vía web. Si el usuario especificado no tiene contraseña, no se incluirá dicho parámetro, pero sí los dos puntos:...usuario:@servidor..." 4

5 Si el número de puerto del servicio VATP es el 690, no habrá que especificarlo tampoco en la VRL, ya que éste es el puerto por defecto para el servicio. Ejemplo #Ejemplo de directivas virtualhost de Velneo <VirtualHost *:80> ServerName midominio.com sethandler velneo Vrl </VirtualHost> Supongamos que en el proyecto de destino hemos creado un proceso llamado INDEX; la url para ejecutarlo sería: midominio.com será el nombre del dominio. gestion es la senda base que hemos especificado en el archivo de configuración de Apache. index.pro Objeto a ejecutar de la instancia de Velneo, la extensión ".pro" lo identifica como un proceso. Una vez configurado el servidor Apache, lo reiniciaremos para que tome la nueva configuración y ya estará listo para servir la web de nuestro proyecto. Los procesos ejecutados vía web han de ser ejecutados en primer plano, no pueden ser ejecutados en un plano diferente. Nomenclatura de objetos en urls Vía web, podremos hacer uso de los objetos siguientes: Procesos El Proceso es el objeto que se usará para componer y retornar el código html de las páginas que se desea servir. En una url un proceso se identificará de la forma siguiente: [ID_PROYECTO_EXT][/]ID_PROCESO[.pro] [ID_PROYECTO_EXT][/]: Es el identificador del proyecto (ID_PROYECTO) y su extensión (EXT) donde está alojado el proceso que se desea ejecutar. Solamente será necesario especificarlo cuando el proceso a ejecutar se encuentre en un proyecto heredado. Si el proceso a ejecutar está en el proyecto actual no se especificará. El identificador del proyecto será el valor establecido en la propiedad Nombre del formulario de propiedades del proyecto: 5

6 La extensión (EXT) será dat si el proceso a ejecutar está en un proyecto de datos heredado y app si está en un proyecto de aplicación heredado. El indetificador del proyecto y la extensión irán separados por un carácter de subrayado: _. El carácter separador / no se incluirá si no se incluye el identificador del proyecto. ID_PROCESO: Será el identificador del proceso a ejecutar, siendo la extensión.pro opcional. [.pro]: Estensión identificativa del objeto. La de un proceso será.pro. Es opcional. Si en una url no se incluye la extensión del objeto, Velneo V7 asumirá por defecto que se trata de un proceso. Ejemplos: o Llamada al proceso con indetificador INDEX del proyecto actual. o Llamada al proceso INDEX del proyecto de datos heredado llamado "vmanagement". NOTA: Es muy importante recordar que los procesos ejecutables vía web han de tener activada la propidad Accesible web. Si esta propiedad no está activada en un proceso, éste no podrá ser ejecutado vía web. Si queremos que el proceso a ejecutar reciba parámetros, tendremos que crear en el proceso tantas variables locales de tipo alfabético como parámetros se necesiten pasar y en la pasarela cgi resolver cada una con el mismo identificador que tenga la variable local en el proceso. Ejemplo: En un proyecto tenemos declarado el proceso siguiente: 6

7 Este proceso tiene decladas dos variables locales de tipo alfabético ID y NAME, que son usadas para dar de alta un registro en una tabla. La declaración del proceso y los parámetros en la pasarela cgi debería ser:...alta_de_ficha.pro?id=xxxxx&name=yyyyyy Dibujos Es posible servir vía web dibujos declarados en el proyecto actual o en un proyecto heredado. La forma de referenciar un dibujo en una URL es similar a la de los procesos: [ID_PROYECTO_ext][/]ID_DIBUJO.ext [ID_PROYECTO_ext][/]: Es el identificador del proyecto (ID_PROYECTO) y su extensión (ext) donde está alojado el dibujo que se desea servir. Solamente será necesario especificarlo cuando el dibujo se encuentre en un proyecto heredado. Si el dibujo está en el proyecto actual no se especificará. El identificador del proyecto será el valor establecido en la propiedad Nombre del formulario de propiedades del proyecto y ha de escribirse exactamente igual a como lo hemos establecido,respetando mayúsculas y minúsculas: 7

8 y el sufijo dat ha de ser escrito todo en minúsculas. El carácter separador / no se incluirá si no se incluye el identificador del proyecto. ID_DIBUJO: El el identificador dado al dibujo en el proyecto..ext: Será la extensión; ésta podrá ser o bien.png o bien.jpg indistintamente. Ejemplos: o Llamada al dibujo LOGO del proyecto actual. Llamada al dibujo LOGO del proyecto de datos heredado llamado "vmanagement". Campos de tipo objeto dibujo En los procesos ejecutados vía web podremos leer registos de tablas del proyecto en curso o de proyectos heredados para, por ejemplo, ir componiendo código html para devolver una página web el contenido de sus campos. Para obtener el contenido de un campo simplemente incluiremos su identificador en la fórmula donde queramos objtenerlo, pero un campo de tipo objeto dibujo de un registro es un caso especial, dado que el dibujo no es almacenado en el fichero de datos sino en un fichero a parte llamado contenedor, lo que se guarda en el campo es una etiqueta que referencia al objeto en el contenedor. Para poder servir la imagen correspondiente a este tipo de campo tendremos que especificar la url siguiente: obj/id_proyecto_dat/id_tabla/etiqueta.ext obj: Es el prefijo que indica que se trata de un campo objeto. Es obligatoria su especificación. ID_PROYECTO_dat: Es el identificador del proyecto de datos donde está declarada la tabla que contiene el campo objeto dibujo. Es obligatoria su especificación y ha de escribirse exactamente igual a como lo hemos establecido,respetando mayúsculas y minúsculas: 8

9 y el sufijo dat ha de ser escrito todo en minúsculas. ID_TABLA: Es el identificador de la la tabla que contiene el campo objeto dibujo. Es obligatoria su especificación. ETIQUETA: Es la etiqueta que referencia al objeto en el contenedor. Dicha etiqueta, tal y como hemos indicado anteriormente, es almacenada en el campo objeto dibujo de la tabla. Es obligatoria su especificación..ext: Será la extensión; ésta podrá ser o bien.png o bien.jpg indistintamente. NOTA: Solamente podremos presentar imágenes de tablas declaradas en el proyecto en curso o en proyectos heredados de forma directa. Esto quiere decir que en un proyecto de aplicación que hereda un proyecto de datos podremos servir vía web una imagen de un registro de una tabla del mismo, pero si queremos hacerlo en un proyecto de aplicación que a su vez hereda otro que es el que hereda el proyecto de datos, no podremos servir la imagen. En este caso lo recomendable sería hacer que nuestro proyecto herede directamente ese proyecto de datos. Ejemplo: La fórmula siguiente se corresponde con una línea de proceso cuyo origen es una Ficha de la tabla de MAESTROS del proyecto TutorvModApache y en ella se está componiendo un código html que devolverá una fila que devolverá el contenido de los campos ID, NOMBRE y el campo objeto dibujo (FOTO) de un registro: El código html que esta fórmula generará al ejecutar el proceso a través de Velneo vmodapache será: <tr><td>2</td><td>nombre Maestro 2</td><td><img src="obj/tutorvmodapache_dat/maestros/jpg00002.png"></td></tr> Variable CONTENT_TYPE Usada en un proceso nos permitirá especificar la codificación de caracteres utilizada al codificar el documento. Para ello simplemente tendremos que declarar una variable local en el proceso cuyo identificador sea CONTENT_TYPE. Para establecer su contenido usaremos el comando de instrucción de proceso Set. Ejemplo: Set ( CONTENT_TYPE, "text/html; charset=iso " ) Esta declaración dice que el tipo de contenido del documento es text/html, y la codificación de caracteres utilizada es la ISO

10 Simplemente declarando este Set en el proceso ya se enviará en el encabezado de la comunicación http la información sobre la codificación de caracteres que hayamos establecido. 10