1

Modulo Contrato Mutuo Acuerdo"

Elaborado por: Walter Geovanni Lopez Rivera


MANUAL TECNICO



San Salvador 2 de mayo de 2014


2
INDICE


Contenido
INSTALACIN DEL MODULO .................................................................................................... 3
Instalando WampServer .............................................................................................................. 3
Instalando Postgresql ................................................................................................................... 7
Instalando Composer ................................................................................................................. 11
CONFIGURACIN ....................................................................................................................... 12
ZENDSERVICE\LIVEDOCX ....................................................................................................... 14
PRUEBA DEL MODULO .............................................................................................................. 16














3
INSTALACIN DEL MODULO

Instalando WampServer
Utilizaremos Wampserver
1
el cual es un entorno de desarrollo web para Windows con el
que se puede crear aplicaciones web con Apache, PHP y bases de datos MySQL database.
Tambin incluye PHPMyAdmin y SQLiteManager para manejar tus bases de datos en un
plis plas.
El primer paso es descargar WampServer desde la pgina oficial:
http://www.wampserver.com/en/
Una vez descargado ejecutaremos el programa wampserver.exe (fig. 1) para instalar el lenguaje php,
el servidor web y el sistema gestor de base de datos MySql. Como se indica en las siguientes
imgenes:











Al dar clic en la fig. 1 se abre el cuadro de dialogo de la fig. 2, este nos muestra los componentes a
instalarse en el equipo. Damos clic en siguiente para continuar.


1
Podemos usar otro entorno de desarrollo como xampp
fig. 1
fig. 2


4
La fig. 3 nos muestra el contrato de licencia elegimos aceptarlo y damos clic en siguiente.

fig. 3
Elegimos la ubicacin donde queremos instalar WampServer y damos clic en siguiente (fig. 4).

fig. 4


5
La fig. 5 nos muestra lo que vamos a instalar para corroborar, si esta todo bien damos clic en instalar.

fig. 5
El proceso de instalacin comienza y dura unos minutos (fig. 6).

fig. 6



6
Damos clic en finalizar y opcionalmente iniciamos el servidor si lo deseamos (fig. 7).

fig. 7
Para instalar el modulo seleccionamos la carpeta pera, que es donde se encuentra todo el sistema
informtico y la subimos al directorio del dominio o subdominio del servidor web, el cual para nuestro
caso es: C:\wamp\www
La carpeta muestra una serie de carpetas y archivos que componen el sistema. La carpeta db contiene
el script de la base de datos (fig. 8).

fig. 8



7
Instalando Postgresql
Para configurar la base de datos debemos instalar postgresql 9.1 que lo podemos descargar desde el
siguiente enlace: http://www.postgresql.org/download/windows/ al ejecutar el instalador nos aparecer
lo siguiente:(fig. 9).

fig. 9
Seleccionaremos el directorio (unidad y carpeta) donde se ubicarn los ficheros necesarios
para le ejecucin de PostgreSQL 9.1, en nuestro caso C:/PostgreSQL91

fig. 10


8
A continuacin seleccionaremos la unidad y carpeta donde se ubicarn los datos de las
bases de datos de nuestro servidor de bases de datos PostgreSQL, en nuestro caso:
C:/PostgreSQL/datos

fig. 11
El asistente para instalar PostgreSQL 9.1 crear un usuario en el sistema operativo llamado
"postgres", en este paso de la instalacin introduciremos la contrasea para este usuario:

fig. 12
Introduciremos el puerto que se usar para conexin con PostgreSQL, por defecto 5432:


9

fig. 13
Seleccionaremos la configuracin regional que ser usada por el motor de base de datos
PostgreSQL, en nuestro caso dejaremos "Configuracin Regional por defecto":

fig. 14
Antes de iniciar la instalacin definitiva de PostgreSQL 9.1, el asistente nos indicar que el
programa est listo para iniciar la instalacin de PostgreSQL. Pulsaremos "Siguiente" para
continuar:


10

fig. 15

Tras la instalacin, el asistente nos dar la posibilidad de iniciar Stack Builder que es una
aplicacin que nos permitir instalar componentes y software adicional para PostgreSQL.

fig. 16




11
Instalando Composer
Instalaremos composer, para eso lo descargamos del siguiente enlace:
https://getcomposer.org/doc/00-intro.md
Basta con seguir el asistente del instalador para instalar composer. Despus ejecutaremos desde
consola (cmd) en la carpeta donde se encuentra el proyecto el siguiente comando:
C:\wamp\www\pera>composer install

Esperamos unos minutos para instalar composer en el proyecto
Ingresamos a la siguiente direccin: http://localhost/pera/web/config.php, nos aparecer la figura (fig
17)
Si todo est bien podemos dar al enlace Configure your Symfony Application online


fig. 17
Al hacerlo podremos ver que aparecer una configuracin de la base de datos, que
llenaremos con los datos que correspondan. (fig. 18)


12

fig. 18
CONFIGURACIN
Si posteriormente queremos cambiar la base de datos con toda la informacin sobre
usuario, etc, realizarlo en el archivo parameters.yml, que se encuentra en
pera\app\config

fig. 19


13
Para generar las entidades de la base de datos realizaremos lo siguiente desde la consola
de comandos (cmd):
C:\wamp\www\pera>php app/console doctrine:mapping:convert xml
./src/juntoscontrato/mutuoacuerdoBundle/doctrine/metadata/orm from-
database forc





C:\wamp\www\pera>console doctrine:mapping:import
juntoscontratomutuoacuerdoBundle annotation



C:\wamp\www\pera>console doctrine:generate:entities
juntoscontratomutuoacuerdoBundle








14
ZENDSERVICE\LIVEDOCX

LiveDocx es un servicio SOAP que permite a los desarrolladores generar documentos de
texto mediante la combinacin de texto estructurado o datos de imagen desde PHP con
una plantilla creada en un procesador de textos. El documento resultante se puede
guardar como un archivo PDF, DOCX, DOC, HTML o RTF. LiveDocx implementa de
combinacin de correspondencia en PHP.
Para poder utilizar esta librera tenemos que agregar libreras de zend para esto lo
haremos utilizando composer este archivo se encuentra en la raz del proyecto
composer.json , agregaremos lo siguiente:
"require": {
"zendframework/zend-config": "2.0.*",
"zendframework/zend-http": "2.0.*",
"zendframework/zend-log":"2.*",
"zendframework/zend-uri":"2.*",
"zendframework/zend-i18n":"2.*",
"zendframework/zend-validator":"2.*",
"zendframework/zend-version":"2.*",
"zendframework/zendservice-livedocx":"2.*"
},

Una vez agregamos estas lneas ejecutaremos en consola (cmd) lo siguiente:
C.\wamp\www\pera>php composer.phar update zendframework/zendservice-
livedocx

Y con cada lnea que agreguemos del composer, realizaremos esto, tambin es posible
utilizar el comando: php composer.phar install, pero este comando actualizara todo
incluso la versin de symfony y si queremos trabajar con una versin anterior, no es
recomendable realizarlo.
Si necesitamos ms libreras de zend podemos verificar la siguiente pgina y agregarlas a
nuestro proyecto:
http://framework.zend.com/downloads/composer
Creando Plantillas en Microsoft Word
Tenemos que crear una plantilla con las variables que nosotros queremos enviar al
documento para la generacin del documento dinmicamente para eso insertamos un
campo:


15
Buscamos en el men la opcin Insertar, despus buscamos la opcin campo, con lo
que nos aparecer:

fig. 20

Al hacer esto nos aparecer en el documento lo siguiente figura 21:

fig. 21
Hacemos lo mismo con todas las variables que necesitemos en el documento a realizar,
esta plantilla se llama template.docx y se encuentra en: pera/src/
juntoscontrato/mutuoacuerdoBundle/Controller
El cdigo bsico de esta librera es el siguiente:
$contratoDocx = new \ZendService\LiveDocx\MailMerge();
$contratoDocx->setUsername('username')
->setPassword('password')
->setService
(\ZendService\LiveDocx\MailMerge::SERVICE_FREE);
$contratoDocx->setLocalTemplate(__DIR__.'\template.docx');
$contratoDocx->assign('datosmiembros', $datosmiembros);
//agregamos todas las variables de esta manera del documento a generar


16
$contratoDocx->createDocument();
$document = $contratoDocx->retrieveDocument('docx');
file_put_contents(__DIR__.'/../doc/contrato.docx', $document);
unset($contratoDocx);

En el cdigo nos pide un nombre de usuario y una contrasea, para eso nos registramos en
la pgina:
https://www.livedocx.com/user/account_registration.aspx
Una vez registrados podemos colocar esa informacin en las lneas que piden el nombre
de usuario y contrasea.
PRUEBA DEL MODULO
Ir a la direccin: http://localhost/pera/web/app_dev.php/generar
A parecer lo siguiente:

fig. 22
En donde se puede seleccionar todos los grupos disponibles para generar el documento de
contrato de mutuo acuerdo.
Al seleccionar el botn generar, se podr guardar el documento en cualquier lugar de
nuestro disco duro:

fig. 23


17
El nombre del archivo ser: contrato + numero aleatorio, esto se realiz de esta manera por
si al mismo tiempo se generan varios archivos, no se d un conflicto y perdida de datos,
este documento temporalmente es creado en la carpeta doc del mdulo.
Al guardar el archivo y abrir el documento podremos ver lo siguiente:

fig. 24