You are on page 1of 17

1

“Modulo Contrato Mutuo Acuerdo"

Elaborado por: Walter Geovanni Lopez Rivera


MANUAL TECNICO



San Salvador 2 de mayo de 2014


2
INDICE


Contenido
INSTALACIÓN DEL MODULO .................................................................................................... 3
Instalando WampServer .............................................................................................................. 3
Instalando Postgresql ................................................................................................................... 7
Instalando Composer ................................................................................................................. 11
CONFIGURACIÓN ....................................................................................................................... 12
ZENDSERVICE\LIVEDOCX ....................................................................................................... 14
PRUEBA DEL MODULO .............................................................................................................. 16














3
INSTALACIÓN 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.
También incluye PHPMyAdmin y SQLiteManager para manejar tus bases de datos en un
plis plas.
El primer paso es descargar WampServer desde la página 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
imágenes:











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 ubicación 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 instalación 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
informático 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 ubicarán los ficheros necesarios
para le ejecución de PostgreSQL 9.1, en nuestro caso C:/PostgreSQL91

fig. 10


8
A continuación seleccionaremos la unidad y carpeta donde se ubicarán 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 instalación introduciremos la contraseña para este usuario:

fig. 12
Introduciremos el puerto que se usará para conexión con PostgreSQL, por defecto 5432:


9

fig. 13
Seleccionaremos la configuración regional que será usada por el motor de base de datos
PostgreSQL, en nuestro caso dejaremos "Configuración Regional por defecto":

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


10

fig. 15

Tras la instalación, el asistente nos dará la posibilidad de iniciar Stack Builder que es una
aplicación 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. Después 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 dirección: 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 configuración de la base de datos, que
llenaremos con los datos que correspondan. (fig. 18)


12

fig. 18
CONFIGURACIÓN
Si posteriormente queremos cambiar la base de datos con toda la información 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 combinación 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
combinación de correspondencia en PHP.
Para poder utilizar esta librería tenemos que agregar librerías de zend para esto lo
haremos utilizando composer este archivo se encuentra en la raíz 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 líneas ejecutaremos en consola (cmd) lo siguiente:
C.\wamp\www\pera>php composer.phar update zendframework/zendservice-
livedocx

Y con cada línea que agreguemos del composer, realizaremos esto, también es posible
utilizar el comando: php composer.phar install, pero este comando actualizara todo
incluso la versión de symfony y si queremos trabajar con una versión anterior, no es
recomendable realizarlo.
Si necesitamos más librerías de zend podemos verificar la siguiente página 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 generación del documento dinámicamente para eso insertamos un
campo:


15
Buscamos en el menú la opción “Insertar”, después buscamos la opción “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 código básico de esta librería 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 código nos pide un nombre de usuario y una contraseña, para eso nos registramos en
la página:
https://www.livedocx.com/user/account_registration.aspx
Una vez registrados podemos colocar esa información en las líneas que piden el nombre
de usuario y contraseña.
PRUEBA DEL MODULO
Ir a la dirección: 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 botón “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 módulo.
Al guardar el archivo y abrir el documento podremos ver lo siguiente:

fig. 24