G·Forms - Manual de instalación y...

Pastor y Landero, 1941001 Sevilla (España)tel +34 954 56 25 40www.guadaltel.comwww.gonce.es

Plataforma de Tramitación G·ONCE

G·Forms - Manual de instalación y configuración

cliente:

fecha:martes, 23 de mayo de 2017

versión:2.22.1

Queda prohibido cualquier tipo de explotación y, en particular, la reproducción,distribución, comunicación pública y/o transformación, total o parcial, porcualquier medio, de este documento sin el previo consentimiento expreso y porescrito de Guadaltel, S.A.

http://www.guadaltel.com/

http://www.gonce.es/

G·Forms - Manual de instalación yconfiguración

ÍNDICE DE CONTENIDO

1. Introducción...................................................................................4

2. Requisitos de instalación...............................................................52.1. Java JDK...................................................................................................5

2.2. Servidores de aplicaciones.......................................................................5

2.3. Servidores de base de datos....................................................................5

2.4. Navegadores.............................................................................................5

3. Instalación en base de datos.........................................................73.1. Tablespaces..............................................................................................7

3.2. Usuario y permisos....................................................................................7

3.3. Creación del modelo de datos..................................................................8

4. Compilación y empaquetado..........................................................94.1. Profiles Maven...........................................................................................9

4.2. Compilación y empaquetado...................................................................11

4.3. Configuración manual del despliegue.....................................................124.3.1. context.xml...............................................................................................124.3.2. contentManager.properties......................................................................14

4.3.3. gforms.properties......................................................................................144.3.4. log4j.xml...................................................................................................14

4.3.5. persistence.xml.........................................................................................154.3.6. trewaconf.properties.................................................................................15

4.3.7. default.properties......................................................................................164.3.8. perfilADM.properties.................................................................................16

5. Despliegue...................................................................................175.1. Tomcat 6.X o 7.X.....................................................................................17

5.1.1. Drivers de base de datos.........................................................................175.1.2. Despliegue...............................................................................................17

5.2. JBoss 6.3-Alpha y AS 7.1.1.....................................................................175.2.1. Creación de los datasources....................................................................175.2.2. Drivers de base de datos.........................................................................20

5.2.3. Despliegue...............................................................................................22

[ 2.22.1 ] 23/05/17 Pág 2 de 28


6. Cambio de estilos........................................................................23

7. Personalización de exportación a PDF........................................247.1. Estilos......................................................................................................24

7.1.1. Grupos......................................................................................................24

7.2. Cabecera de página................................................................................24

7.3. Pie de página...........................................................................................25

7.4. Imágenes.................................................................................................25

8. Migración de formularios entre entornos......................................26

9. Historial de versiones...................................................................27

[ 2.22.1 ] 23/05/17 Pág 3 de 28


1. Introducción

El objeto del presente documento es el de servir de guía para la instalación yconfiguración de G·Forms perteneciente a la Plataforma de AdministraciónElectrónica G-ONCE. Para ello, se repasarán todos los aspectos técnicos tantode instalación, configuración de los ficheros de propiedades e integración conotras aplicaciones.

[ 2.22.1 ] 23/05/17 Pág 4 de 28


2. Requisitos de instalación

2.1. Java JDK

• Java jdk1.6.X

• Java jdk1.7.X

2.2. Servidores de aplicaciones

• Tomcat 6.X.X.

• Tomcat 7.X.X.

• JBoss 6.3-Alpha

• JBoss AS 7.1.1

2.3. Servidores de base de datos

• Oracle 10g

• Oracle 11g

• PostgreSQL 8.4

• PostgreSQL 9.1

• SQL Server 2014

2.4. Navegadores

• Diseñador:

◦ Google Chrome

◦ Mozilla Firefox

• Renderizador:

◦ Google Chrome

◦ Mozilla Firefox

[ 2.22.1 ] 23/05/17 Pág 5 de 28


◦ Internet explorer 10 o superior

[ 2.22.1 ] 23/05/17 Pág 6 de 28


3. Instalación en base de datos

A continuación se detallan los pasos a seguir para realizar la instalación enbase de datos del aplicativo.

3.1. Tablespaces

Para el correcto funcionamiento del sistema en base de datos es necesariodisponer de dos tablespaces, uno para los índices y otro para los datos. CREATE TABLESPACE "TS_GFORMS_DATOS" SIZE 512M;

CREATE TABLESPACE "TS_GFORMS_INDICES" SIZE 256M;

Si se decide usar un nombre distinto del propuesto, los scripts de instalaciónen base de datos deben ser revisados y modificados con los nombres detablespaces correctos.

Se recomienda activar la opción de crecimiento automático. El tamaño dechunk es algo complejo de definir a priori. Un tamaño pequeño repercute en unmejor aprovechamiento del espacio pero un mayor número de llamadas adisco, acceso por tanto más lento. Un tamaño mayor implica un mayordesaprovechamiento del espacio pero un acceso más rápido, al ser menor ennumero de accesos al disco. Es por ello recomendable estudiar los valoresobtenidos en el entorno de pruebas para poder extrapolar una configuraciónajustada y equilibrada en producción.

Los valores iniciales indicados inicialmente son un buen punto de partida, perocada DBA puede ajustar los mismos a los valores que estime oportuno.

3.2. Usuario y permisos

Es necesario un usuario de base de datos para que sea el propietario de losobjetos y con el que se conectará la aplicación al esquema de base de datos.Dicho usuario debe tener permisos sobre los objetos del esquema y suesquema por defecto será “TS_GFORMS_DATOS”.CREATE USER "GFORMS" IDENTIFIED BY "XXXXX" DEFAULT TABLESPACE "TS_GFORMS_DATOS" TEMPORARY TABLESPACE "TEMP";GRANT CREATE TRIGGER TO "GFORMS";GRANT CREATE PROCEDURE TO "GFORMS";GRANT CREATE SEQUENCE TO "GFORMS";GRANT CREATE SYNONYM TO "GFORMS";GRANT CREATE TABLE TO "GFORMS";GRANT ALTER SESSION TO "GFORMS";

[ 2.22.1 ] 23/05/17 Pág 7 de 28


GRANT CREATE SESSION TO "GFORMS";ALTER USER "GFORMS" QUOTA UNLIMITED ON "TS_GFORMS_DATOS";ALTER USER "GFORMS" QUOTA UNLIMITED ON "TS_GFORMS_INDICES";GRANT CREATE SYNONYM TO GFORMS;

3.3. Creación del modelo de datos

Para la generación del modelo de datos, en la carpeta src/main/sql/completese encuentran los scripts de creación tanto para Oracle, PostgreSQL o SQLServer en respectivas carpetas “script_creacion.sql”. También existe unarchivo “script_datos.sql” con los scripts de inserción de datos en la tabla delCatálogo de Expresiones, necesario para el funcionamiento básico deG·Forms.

[ 2.22.1 ] 23/05/17 Pág 8 de 28


4. Compilación y empaquetado

G·Forms está desarrollado en formato maven para poder ser configurado yempaquetado a través de dicha herramienta. A continuación se detallan losdistintos perfiles de configuración existentes en la herramienta así como losficheros de configuración y las instrucciones para la compilación yempaquetado del desplegable.

4.1. Profiles Maven

Existen los siguiente profiles de Maven:

Nombre Tipo Descripción

guadaltel-desarrollo-emasesaConfiguracióngeneral

Configuración de entorno Emasesaen Guadaltel

guadaltel-desarrollo-moad Configuracióngeneral

Configuración de entorno MOAD enGuadaltel

guadaltel-desarrolloConfiguracióngeneral

Configuración de entorno dedesarrollo en Guadaltel

guadaltel-local Configuracióngeneral

Configuración de entorno local

bd-desarrollo-oracle10g Base de datosConfiguración de base de datos dedesarrollo en Guadaltel (Oracle10g)

bd-localhost-postgres84 Base de datos Configuración de base de datoslocal (PostgreSQL-8.4)

bd-localhost-postgres91 Base de datosConfiguración de base de datoslocal (PostgreSQL-9.1)

server-jboss6 Servidor deaplicaciones

Configuración de servidor JBoss6.3-Alpha

server-jboss711Servidor deaplicaciones

Configuración de servidor JBoss AS7.1.1

server-tomcat6 Servidor de Configuración de servidor Apache

[ 2.22.1 ] 23/05/17 Pág 9 de 28


aplicaciones Tomcat 6.X o 7.X

jdk16 JDK Configuración de JDK 1.6

jdk17 JDK Configuración de JDK 1.7

trewa16 Trew@ Integración con API de Trew@ v1.6

trewa2 Trew@ Integración con API de Trew@ v2

trewa-ext2 Trew@-extensión v2

Integración con API de extensiónTrew@ v2

[ 2.22.1 ] 23/05/17 Pág 10 de 28


4.2. Compilación y empaquetado

Para compilar y empaquetar el war a desplegar en el servidor de aplicacioneses necesario hacerlo a través de maven v2.2.1 haciendo uso de los profilesnecesarios en función del entorno donde se realice la instalación.Para la correcta configuración de G·Forms se tiene que activar un perfilgeneral, uno de base de datos, uno de JDK y otro de servidor de aplicaciones(el profile de trewa es opcional si se va a hacer uso de expresiones Trew@).El perfil de base de datos, como su nombre indica, define las propiedades deconexión a base de datos:

• Configuración de hibernate (fichero "persistence.xml")

• Definición de datasources (fichero "context.xml").

El perfil de configuración general define las propiedades de configuración de:

• Configuración de almacenamiento de XML de formulario (fichero“contentManager.properties”)

• Configuración de tickets de seguridad (fichero “ticket.properties”)

• Usuario y clave de acceso a G·Forms (fichero “gforms.properties”)

• DataSource para expresiones de consulta SQL (ficheros“persistence.xml” y "context.xml")

• Configuración de log (fichero “log4j.xml”)

• Configuración de Trew@ (ficheros "default.properties","perfilADM.properties" y "trewaconf.properties")

Para realizar la compilación y empaquetado de G·Forms bastará con lanzar lasiguiente instrucción:mvn clean package -P <perfilConfiguracionGeneral>,<perfilBaseDatos>,<prefilServidorAplicaciones>,<perfilJDK>,<perfilesOpcionales>...

Para poder realizar la compilación de G·Forms se hace uso de una serie decomponentes cuyos artifactos deben estar desplegados en el repositoriomaven que se vaya a emplear para la compilación y empaquetado:

Librería GroupId ArtifactId Versión

[ 2.22.1 ] 23/05/17 Pág 11 de 28


G·FormsWS Client es.guadaltel.gforms gforms-ws-client 1.6.0

TohuG·Forms

es.guadaltel.gforms tohu-core 1.3.1-gforms

RichfacesG·Forms

org.richfaces.framework richfaces-impl3.3.3.Final.ie10patch

Ticket es.guadaltel.framework ticket 0.0.1

Validadores es.gdtel.validadores validadores 1.0.2

Content-manager

es.guadaltel.framework.contentmanager contentManager-siaper

1.0.2

Trewav1.6 (*) es.gdtel.trewa trewa-api 1.10.2-r2

Trewa v2(*)

cjap.scae.trewa trewa-api 2.1.0

TrewaExtensiónv2 (*)

es.guadaltel.trewa.ext gtrewa-api 1.0.8-2.1.0

(*) Si se va a realizar la integración con Trew@

4.3. Configuración manual del despliegue

Si no se desea compilar y empaquetar el desplegable a través de maven existela opción de modificar manualmente las propiedades dentro de un fichero WARproporcionado. A continuación se detallan los ficheros a editar con el detalle desus propiedades.

4.3.1. context.xmlgforms/META-INF/context.xml

En este fichero se configuran la conexión de de G·Forms a su propio esquemaasí como las conexiones a sistemas externos a los cuales se desea conectarG·Forms para realizar sobre ellos consultas SQL a través de las expresiones.

[ 2.22.1 ] 23/05/17 Pág 12 de 28


Si no se desea configurar ningún sistema externo, se recomienda configurar laconexión al modelo de datos de G·Forms.<Resource name="jdbc/gformsDS" auth="Container"

type="javax.sql.DataSource" driverClassName="#DRIVERBD_GF#" url="jdbc:oracle:thin:@#SERVIDOR_GF#:#PUERTO_GF#:#SID_GF#" maxActive="20" maxIdle="10" maxWait="-1" username="#USUARIO_GF#" password="#PASSWORD_GF#" validationQuery="#VALIDATIONQUERY_GF#"/>

<Resource name="jdbc/gformsSQLExpressions" auth="Container"type="javax.sql.DataSource" driverClassName="#DRIVERBD_EX#" url="jdbc:oracle:thin:@#SERVIDOR_GF#:#PUERTO_EX#:#SID_EX#" maxActive="20" axIdle="10" maxWait="-1" username="#USUARIO_EX#" password="#PASSWORD_EX#" validationQuery="#VALIDATIONQUERY_EX#” />

• #DRIVERBD_GF#: Driver de Base de datos de G·Forms.

• #SERVIDOR_GF#: Host de base de datos de G·Forms.

• #PUERTO_GF#: Puerto de base de datos de G·Forms.

• #SID_GF#: SID de base de datos de G·Forms.

• #USUARIO_GF#: Usuario de conexión a base de datos de G·Forms.

• #PASSWORD_GF#: Password de conexión a base de datos deG·Forms.

• #VALIDATIONQUERY_GF#: Query empleada para comprobar estadode conexión a base de datos de G·Forms. Suele emplearse "SELECT 1FROM DUAL" para Oracle o "SELECT 1" para PostgreSQL o SQLServer.

• #DRIVERBD_EX#: Driver de Base de datos del sistema paraexpresiones.

• #SERVIDOR_EX#: Host de base de datos del sistema paraexpresiones.

• #PUERTO_EX#: Puerto de base de datos del sistema para expresiones.

• #SID_EX#: SID de base de datos del sistema para expresiones.

• #USUARIO_EX#: Usuario de conexión a base de datos del sistema paraexpresiones.

• #PASSWORD_EX#: Password de conexión a base de datos del sistemapara expresiones.

[ 2.22.1 ] 23/05/17 Pág 13 de 28


• #VALIDATIONQUERY_EX#: Query empleada para comprobar estadode conexión a base de datos del sistema para expresiones. Sueleemplearse "SELECT 1 FROM DUAL" para Oracle o "SELECT 1" paraPostgreSQL y SQL Server.

4.3.2. contentManager.propertiesgforms/WEB-INF/classes/contentManager.properties

Este fichero alberga la configuración para el almacenado de los formularios enel sistema. Es importante que el usuario que ejecute el proceso del servidor deaplicaciones tenga permisos de lectura y escritura sobre la carpeta que aquí seespecifique.contentManager.siaper.rootdirectory=#RUTA#

• #RUTA#: Ruta física en el servidor de aplicaciones donde sealmacenarán los formularios.

4.3.3. gforms.propertiesgforms/WEB-INF/classes/gforms.properties

En este fichero se configura el usuario administrador que tendrá permisos deacceso total a la herramienta de gestión de formularios. También contiene unapropiedad que indica como se gestionarán las peticiones Ajax en la cola.gforms.usuario=#USUARIO#gforms.password=#PASSWORD#ajax.queue=#MODO_COLA#

• #MODO_COLA#: Opciones:

◦ noLimit = Cola sin límite

◦ fireNew = Cola a 1 (dispara el nuevo evento en la cola)

◦ fireNext = Cola a 1 (dispara el evento primero en la cola)

4.3.4. log4j.xmlgforms/WEB-INF/classes/log4j.xml

En este fichero se configuran las propiedades de logging. Por defecto, los logsvienen configurados en modo INFO y para comprimirse automáticamentecuando estos alcanzan 200MB.<param name="File" value="#RUTA#" />

[ 2.22.1 ] 23/05/17 Pág 14 de 28


• #RUTA#: Ruta física donde se almacenarán los ficheros de log.

4.3.5. persistence.xmlgforms/WEB-INF/classes/META-INF/persistence.xml

En este fichero se configuran los datasources que usa G·Forms tanto para laconexión a su propio esquema de base de datos como al esquema para lasexpresiones.<persistence-unit name="gformsDataSource" transaction-type="RESOURCE_LOCAL"> ... <properties> ... <property name="hibernate.dialect" value="#DIALECTO_GF#" /> <property name="hibernate.connection.datasource" value="#DATASOURCE_GF#" /> </properties></persistence-unit><persistence-unit name="gformsSQLExpressions" transaction-type="RESOURCE_LOCAL"> <non-jta-data-source>#DATASOURCE_EX#</non-jta-data-source> ... <properties> <property name="hibernate.dialect" value="#DIALECTO_EX#" /> ... </properties></persistence-unit>

• #DIALECTO_GF#: Dialecto de base de datos de G·Forms.

• #DATASOURCE_GF#: Nombre JNDI del datasource del esquema deG·Forms.

• #DATASOURCE_EX#: Nombre JNDI del datasource del esquema deexpresiones.

• #DIALECTO_EX#: Dialecto de base de datos de expresiones.

4.3.6. trewaconf.propertiesgforms/WEB-INF/classes/trewa/conf/trewaconf.properties

En este fichero se indica la configuración de log de trewa. Si no se integra conTrew@ no es necesario editar el fichero.log_4j_configuration_file=#RUTA#

• #RUTA#: Ruta física del fichero de configuración de log de G·Forms. Noes el fichero donde se vuelca el log si no el fichero de configuraciónlog4j.xml.

[ 2.22.1 ] 23/05/17 Pág 15 de 28


4.3.7. default.propertiesgforms/WEB-INF/classes/trewa/conf/perfiles/default.properties

En este fichero se configura la conexión del perfil por defecto de trewa. Si nose integra con Trew@ no es necesario editar el fichero.nombreMaquina=#SERVIDOR#puerto=#PUERTO#nombreBD=#SID#nombreUsuario=#USUARIO#claveUsuario=#PASSWORD#

• #SERVIDOR#: Host de base de datos de trewa.

• #PUERTO#: Puerto de base de datos de trewa.

• #SID#: SID de base de datos de trewa.

• #USUARIO#: Usuario de conexión a base de datos de trewa.

• #PASSWORD#: Password de conexión a base de datos de trewa.

4.3.8. perfilADM.properties

gforms/WEB-INF/classes/trewa/conf/perfiles/perfilADM.properties

En este fichero se configura la conexión del perfil administrador de trewa. Si nose integra con Trew@ no es necesario editar el fichero.nombreMaquina=#SERVIDOR#puerto=#PUERTO#nombreBD=#SID#nombreUsuario=#USUARIO#claveUsuario=#PASSWORD#

• #SERVIDOR#: Host de base de datos de trewa.

• #PUERTO#: Puerto de base de datos de trewa.

• #SID#: SID de base de datos de trewa.

• #USUARIO#: Usuario de conexión a base de datos de trewa.

• #PASSWORD#: Password de conexión a base de datos de trewa.

[ 2.22.1 ] 23/05/17 Pág 16 de 28


5. Despliegue

A continuación se distinguen los despliegues sobre los distintos servidores deaplicaciones certificados.

5.1. Tomcat 6.X o 7.X

Para desplegar la aplicación en esta versión de servidor se deben seguir lossiguientes pasos, siempre que hayamos partido de un WAR para versión deservidor Tomcat.

5.1.1. Drivers de base de datos

Para la conexión de G·Forms a través de datasources es necesario que elservidor de aplicaciones disponga de los drivers de base de datos. Para ellocopiaremos el driver de base de datos correspondiente (ojdbcX.jar opostgresqlX.jar) al directorio de librerías comunes del Tomcat.

$TOMCAT_HOME$/lib

5.1.2. Despliegue

Una vez configurados los drivers de base de datos en el servidor deaplicaciones bastará con copiar el fichero de la aplicación a la ruta siguiente:

$TOMCAT_HOME$/webapps

5.2. JBoss 6.3-Alpha y AS 7.1.1

Para desplegar la aplicación en esta versión de servidor se deben seguir lossiguientes pasos, siempre que hayamos partido de un WAR para versión deservidor JBoss 6.3-Alpha.

5.2.1. Creación de los datasources

A continuación se detallan los pasos a seguir para crear los datasources queemplea G·Forms para sus conexiones a base de datos.

[ 2.22.1 ] 23/05/17 Pág 17 de 28


• Abrir el fichero de configuración de Jboss:

$JBOSS_HOME$/standalone/configuration/standalone.xml

• Localizar la etiqueta “datasources”:<subsystem xmlns="urn:jboss:domain:datasources:1.0"> <datasources> ... </datasources></subsystem>

• Introducir los datasources necesarios para la aplicación, revisando losvalores de conexión:<datasource jndi-name="java:jboss/datasources/jdbc/gformsDS" pool-name="gformsDS" enabled="true" use-java-context="true" use-ccm="true"> <connection-url>#URL_BD_GFORMS#</connection-url> <driver>#DRIVER_GFORMS#</driver> <pool> <min-pool-size>5</min-pool-size> <max-pool-size>100</max-pool-size> <prefill>true</prefill> </pool> <security> <user-name>#USUARIO_GFORMS#</user-name> <password>#PASSWORD_GFORMS#</password> </security> <validation> <check-valid-connection-sql>#VALIDATION_QUERY_GFORMS#</check-valid-connection-sql> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> <use-fast-fail>false</use-fast-fail> </validation></datasource><datasource jndi-name="java:jboss/datasources/jdbc/gformsSQLExpressions" pool-name="gformsSQLExpressions" enabled="true" use-java-context="true" use-ccm="true"> <connection-url>#URL_BD_EXT#</connection-url> <driver>#DRIVER_EXT#</driver> <pool> <min-pool-size>5</min-pool-size> <max-pool-size>100</max-pool-size> <prefill>true</prefill> </pool> <security> <user-name>#USUARIO_GFORMS#</user-name> <password>#PASSWORD_GFORMS#</password> </security> <validation> <check-valid-connection-sql>#VALIDATION_QUERY_EXT#</check-

[ 2.22.1 ] 23/05/17 Pág 18 de 28


valid-connection-sql> <validate-on-match>false</validate-on-match> <background-validation>false</background-validation> <use-fast-fail>false</use-fast-fail> </validation></datasource>

◦ #URL_BD_GFORMS#: URL de conexión a la base de datos deG·Forms (jdbc:oracle:thin:@hostname:port:sid ,jdbc:postgresql://hostname:port/sid ojdbc:sqlserver://hostname:port;databaseName= sid según motor deBBDD).

◦ #DRIVER_GFORMS#: Driver de BBDD empleado para conexión conla base de datos de G·Forms (jdbc:oracle:thin:@hostname:port:sid ,jdbc:postgresql://hostname:port/sid ojdbc:sqlserver://hostname:port;databaseName= sid según motor deBBDD).

◦ #USUARIO_GFORMS#: Usuario de conexión al esquema deG·Forms.

◦ #PASSWORD_GFORMS#: Clave de usuario de conexión alesquema de G·Forms.

◦ #VALIDATION_QUERY_GFORMS#: Query empleada paracomprobar estado de conexión a base de datos de G·Forms. Sueleemplearse "SELECT 1 FROM DUAL" para Oracle o "SELECT 1"para PostgreSQL y SQL Server.

◦ #URL_BD_EXT#: URL de conexión a la base de datos paraexpresiones (jdbc:oracle:thin:@hostname:port:sid ,jdbc:postgresql://hostname:port/sid ojdbc:sqlserver://hostname:port;databaseName= sid según motor deBBDD).

◦ #USUARIO_EXT#: Usuario de conexión al esquema paraexpresiones.

◦ #PASSWORD_EXT#: Clave de usuario de conexión al esquemapara expresiones.

◦ #DRIVER_EXT#: Driver de BBDD empleado para conexión con labase de datos para expresiones(jdbc:oracle:thin:@hostname:port:sid ,jdbc:postgresql://hostname:port/sid o

[ 2.22.1 ] 23/05/17 Pág 19 de 28


jdbc:sqlserver://hostname:port;databaseName= sid según motor deBBDD).

◦ #VALIDATION_QUERY_EXT#: Query empleada para comprobarestado de conexión a base de datos del sistema para expresiones.Suele emplearse "SELECT 1 FROM DUAL" para Oracle o "SELECT1" para PostgreSQL y SQL Server.

Este pool de base de datos tiene por defecto 5 conexiones de mínimo y100 de máximo. Estos valores también pueden ser adaptados enfunción a la carga de trabajo del servidor de aplicaciones. Losparámetros recomendados de configuración de estos valores soninicialmente:<min-pool-size>5</min-pool-size><max-pool-size>100</max-pool-size>

Si no se va a emplear un origen de datos externo para su uso enexpresiones se recomienda introducir los mismos datos de conexión quese emplean para el esquema de G·Forms.

5.2.2. Drivers de base de datos

En los datasource definidos anteriormente en el fichero "standalone.xml" sehace referencia a un driver que no viene por defecto en el servidor deaplicaciones, por lo que lo añadimos a continuación del datasource y dentro dela etiqueta <drivers> el driver del motor de base de datos a los que seconectan:

• Driver Oracle<drivers> <driver name="com.oracle" module="com.oracle"> <xa-datasource-class>oracle.jdbc.xa.client.OracleXADataSource</xa-datasource-class> </driver></drivers>

• Driver PostgreSQL<drivers> <driver name="org.postgresql" module="org.postgresql"> <xa-datasource-class>org.postgresql.Driver</xa-datasource-class> </driver></drivers>

• Driver SQL Server<drivers> <driver name="com.microsoft" module="com.microsoft"> <xa-datasource-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</xa-datasource-class>

[ 2.22.1 ] 23/05/17 Pág 20 de 28


</driver></drivers>

Estos drivers hacen referencia a un módulo nuevo llamado “com.oracle”,“org.postgres” o “com.microsoft” que tampoco existen en el servidor, por lo quees necesario darlos de alta. Estos módulos se encuentran en la siguiente ruta:

$JBOSS_HOME$/modules

Cada módulo se encuentran dentro del directorio al que hace referencia sunombre, por lo tanto tendremos que crear la estructura de carpetas en funcióndel módulo que se vaya a emplear:

• Módulo Oracle

Se crea el árbol de carpetas "com/oracle" y en su interior se guarda eldriver de base de datos a emplear "ojdbcX.jar". Además se debe crearun fichero XML llamado "module.xml" con el siguiente contenido:<?xml version="1.0" encoding="UTF-8"?><module xmlns="urn:jboss:module:1.0" name="com.oracle"> <resources> <resource-root path="ojdbcX.jar"/> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module>

• Módulo PostgreSQL

Se crea el árbol de carpetas "org/postgres/main" y en su interior seguarda el driver de base de datos a emplear "postgresqlX.jar". Ademásse debe crear un fichero XML llamado "module.xml" con el siguientecontenido:<?xml version="1.0" encoding="UTF-8"?><module xmlns="urn:jboss:module:1.0" name="org.postgresql"> <resources> <resource-root path="postgresqlX.jar"/> </resources></module>

• Módulo SQL Server

Se crea el árbol de carpetas "com/microsoft/main" y en su interior seguarda el driver de base de datos a emplear "sqljdbc-X.jar". Además sedebe crear un fichero XML llamado "module.xml" con el siguientecontenido:

[ 2.22.1 ] 23/05/17 Pág 21 de 28


<?xml version="1.0" encoding="UTF-8"?><module xmlns="urn:jboss:module:1.0" name="com.microsoft"> <resources> <resource-root path="sqljdbc-X.jar"/> </resources></module>

5.2.3. Despliegue

Una vez realizados los pasos anteriores, y asegurándonos de que el servidorde aplicaciones Jboss se encuentra parado, sólo nos queda copiar el war a lacarpeta de despliegue:

$JBOSS_HOME$/standalone/deployments

[ 2.22.1 ] 23/05/17 Pág 22 de 28


6. Cambio de estilos.

G·Forms permite cambiar fácilmente los estilos completos de la aplicaciónhaciendo dos modificaciones, en el “web.xml” y renombrando o modificandounas imagenes que se encuentran en “webapp/static/gforms/images”.

En el “web.xml” se define la skin de Richfaces que se va a utilizar (ruby,emeraldTown, laguna, etc...) o el nombre de la redefinición de skin que sedebe encontrar en “META-INF/skins” (por ejemplo madrid cuyo fichero se llamaen el citado directorio “madrid.skin.properties”)

Además las imágenes:

• custom_button_background_active.png

• custom_button_background.png

deben modificarse para que se ajusten al skin elegido. En el mismo directoriose encuentran ya varios ejemplos para los skins utilizados anteriormente (ruby,laguna, madrid, etc...), basta con copiar de nuevo dentro del mismo directoriola imagen elegida, por ejemplo para ruby“custom_button_background_active_ruby.png”, y ponerle como nombre“custom_button_background_active.png”. Igual para la otra imagen.

[ 2.22.1 ] 23/05/17 Pág 23 de 28


7. Personalización de exportación a PDF

G·Forms permite la exportación de una instancia de formulario a formato PDFdesde el propio renderizador.

Para ello se basa en la tecnología Freemarker para transformar la instancia deformulario a formato HTML y mediante iText lo transforma al PDF resultante.

Gracias a la flexibilidad del formato HTML es posible personalizar eldocumento resultante de forma sencilla editando ciertos ficheros en laaplicación.

Dado que Freemarker evalúa en tiempo de ejecución sus fuentes, no esnecesario reiniciar el servidor de aplicaciones para probar los cambiosrealizados en los ficheros implicados en la exportación.

A continuación se detallan las opciones de personalización.

7.1. Estilos

Es posible modificar los estilos de ciertos elementos del formulario editandoalgunas clases CSS definidas en el fichero /gforms/src/main/webapp/WEB-INF/drl/exportHTML/styles.ftl.7.1.1. Grupos

Los grupos se exportan como tablas de una sola columna y dos filas, donde laprimera fila contiene el nombre del grupo y la segunda el contenido del mismo.Mediante las clases .group_table y .group_table_header.

7.2. Cabecera de página

Se puede diseñar una cabecera de página editando el fichero/gforms/src/main/webapp/WEB-INF/drl/exportHTML/header.ftl e introduciendoel código HTML que se desee usar como cabecera.

Por defecto viene vacía.

[ 2.22.1 ] 23/05/17 Pág 24 de 28


7.3. Pie de página

Se puede diseñar un pie de página editando el fichero/gforms/src/main/webapp/WEB-INF/drl/exportHTML/footer.ftl e introduciendo elcódigo HTML que se desee usar como pie.

Por defecto viene con el número de página alineado a la derecha.

7.4. Imágenes

Se pueden introducir imágenes para su uso tanto en la cabecera como en elpie de página. Para ello bastará con copiar los ficheros de dichas imágenes enla ruta /gforms/src/main/webapp/WEB-INF/drl/exportHTML/img/.

Tras ello bastará con hacer uso de la imagen a través de la etiqueta HTML<img src=”img/nombrefichero.ext” .../>.

[ 2.22.1 ] 23/05/17 Pág 25 de 28


8. Migración de formularios entre entornos

Dede la versión 2.11.0, la migración de formularios se puede realizar mediantela utilidad de exportación e importación de formularios. Para más informaciónconsultar el manual de usuario.

[ 2.22.1 ] 23/05/17 Pág 26 de 28


9. Historial de versiones

Versión Fecha Autor Descripción

2.9.0 27/01/2015 Manuel Martín SoriaPrimera versión del manual de instalación, separado del manual de instalación-configuración-desarrollo.

2.10.0 16/03/215 Manuel Martín Soria Actualización para v2.10.0.

2.10.1 09/04/2015 Manuel Martín Soria Actualización para versión 2.10.1.






2.10.7 27/05/2015 Manuel Martín Soria Actualización para versión 2.10.7
















[ 2.22.1 ] 23/05/17 Pág 27 de 28















[ 2.22.1 ] 23/05/17 Pág 28 de 28

G·Forms - Manual de instalación y...

Documents

Transcript of G·Forms - Manual de instalación y...