manual para Desarrolladores elastix


 

 

 

 

 

 

 

 

 

 

Manual para Desarrolladores


 


 

 
VERSIONAMIENTO
Versión Versión de
Elastix
1

2.3.0

Fecha

Elaborado por

Detalles

16-Ene-2012

Ing. Alberto Santos

Documentación Inicial


 


 

 

Introducción
El presente manual es una guía para desarrolladores en la utilización del Framework
Elastix para la creación de nuevos módulos.En este manual se explicará como se puede crear un módulo Elastix, Fundamentos
Básicos del Framework Elastix, y cómo llegar a convertir nuestro nuevo módulo en
un Addon de Elastix.

1. Creación de un nuevo módulo Elastix
Para la creación de un nuevo módulo de Elastix usaremos el addon
“Developer”, disponible en el módulo de Addons de Elastix.
1.1 Instalación del Addon Developer
§

Ingresamos a lainterfaz Elastix como usuario administrador y vamos a la
pestaña de “Addons”, una vez que termine de cargar los addons disponibles
buscamos el que diga “Developer”.


 
Imagen 1.- Identificación del addon “Developer”.


 


 

 
§

Ya identificado el addon damos click en el botón “Install” respectivo.

§

Luego de esto se inicia el proceso de instalación del addon, por lo que se debeesperar unos minutos hasta que finalice la instalación.


 


 
Imagen 2.- Finalización de la instalación del addon “Developer”.

§

Luego de esto salimos de la interfaz y volvemos a ingresar como administrador.
Debemos ver una nueva pestaña de menú con el nombre “Developer”.

1.2 Utilizando el Elastix Developer
El addon Developer nos permitirá crear de manera transparente para nosotros elesqueleto inicial de código necesario para elaborar un módulo de Elastix, lo que
puede constituir un ahorro de horas en muchos casos.
El addon para desarrolladores tiene tres submenús pero el que nos interesa se llama
“Constructor de Módulos” o “Build Module” y es el primer submenú.
La función del constructor de módulos es generar el esqueleto de código del nuevo
módulo que estamos creando, para queluego podamos continuar con el desarrollo
extendiendo este código inicial.
Al crear un modulo desde aquí, se generará lo siguiente:


 


 

 
§

El menú (o los menús) dentro de la interfaz Web de Elastix. Es decir que ya no
tendremos que modificar manualmente la base de datos menu.db.

§

El código esqueleto, el cual se encontrará dentro de una carpeta cuyo nombre
será igual al ID delmódulo. Esta carpeta será ubicada a su vez dentro de la
carpeta /var/www/html/modules que es donde residen todos los módulos
de Elastix. Es decir que ya no tenemos que crear manualmente esta carpeta.

§

Pantallas prototipo. Estas pantallas pueden ser de tres tipos: formulario, reporte
y enmarcado.

Veamos ahora cómo luce el constructor de módulos.

Imagen 3.-
 El constructor de módulos incluido enel addon Developer


 

Como podemos observar, el constructor de módulos se encuentra dividido en tres
partes:
§
§
§

Información General.
Localización.
Descripción del módulo.

Información General
Esta sección nos permite definir el nombre e identificador único del módulo, así
como también los datos de la persona que crea el modulo para comentarlas en las
cabeceras de cada archivo deprogramación en PHP. También nos permite

 


 

 
configurar el nivel de accesibilidad que tendrá el módulo a través del parámetro
“Permisos de Grupo”.

Imagen 4.- Sección de información general dentro del constructor de módulos

Localización
En esta sección se configura el lugar, dentro del menú general, donde vamos a
ubicar el nuevo módulo. Por omisión esta sección luce como la siguientefigura.


 
Imagen 5.- Sección donde se configura la ubicación del módulo

Si decimos que el módulo es de nivel 3 entonces aparecerán automáticamente
nuevos campos para ingresar los identificadores de los menús padres de nivel 1 y
nivel 2.

Imagen 6.- Aparecen nuevos campos si se dice que el módulo será de nivel 3

Para clarificar el significado de los campos mostrados en esta sección veamos la...