Download Manual Tecnico (Tomo II)

UNIVERSIDAD DE GUAYAQUIL
FACULTAD DE CIENCIAS MATEMÁTICAS Y FÍSICAS
CARRERA DE INGENIERÍA EN SISTEMAS
COMPUTACIONALES
IMPLEMENTACIÓN DE UN IVR PARA ATENCIÓN TELEFÓNICA A
ESTUDIANTES EN LA CARRERA DE INGENIERÍA
EN SISTEMAS COMPUTACIONALES DE LA
UNIVERSIDAD DE GUAYAQUIL
TESIS DE GRADO
MANUAL TÉCNICO
Previa a la obtención del Título de:
INGENIERO EN SISTEMAS COMPUTACIONALES
AUTORES: EMILIA ESTEFANIA RAMÍREZ SAVERIO
FREDDY ANDRES NOBOA ORRALA
TUTOR: ING. DAVID BENAVIDES
GUAYAQUIL – ECUADOR
2011
1
Contenido
1.
ARQUITECTURA DE LA SOLUCIÓN.......................................................................................... 3
2.
ARQUITECTURA DEL DESARROLLO ........................................................................................ 4
2.1. Tecnologías de la Solución ................................................................................................. 4
3.
4.
2.1.1.
El Asterisk .............................................................................................................. 4
2.1.2.
Lenguaje de Programación..................................................................................... 4
2.1.3.
Asterisk - Java ........................................................................................................ 5
2.1.4.
Diseño AGI del paquete ASTERISK-JAVA ......................................................... 6
2.1.5.
JasperReports ......................................................................................................... 7
2.1.6.
IReports .................................................................................................................. 7
2.1.7.
JavaMail ................................................................................................................. 9
2.1.8.
SoftPhone (WebPhone MIZU) ............................................................................... 9
2.1.9.
Base de Datos del Sistema ................................................................................... 12
2.1.10.
Servidor de Aplicaciones ..................................................................................... 12
2.1.11.
Servidor TTS ........................................................................................................ 13
2.1.12.
GUI ...................................................................................................................... 13
DICCIONARIO DE LIBRERIAS. ................................................................................................ 15
3.1.
INFORMACION GENERAL ...................................................................................... 15
3.2.
INFORMACION FUNCIONES. ................................................................................. 15
3.2.1.
CISCAGI-AGI ..................................................................................................... 15
3.2.2.
CISCAGI-AMI .................................................................................................... 34
3.2.3.
CISCAGIVIEWER .............................................................................................. 53
3.2.4.
CISCAGILIBRARY ............................................................................................ 54
3.2.5.
ModuloIVR .......................................................................................................... 55
DIAGRAMAS DE LA APLICACIÓN .......................................................................................... 57
4.1.
Diagrama de desarrollo CISCAGI ............................................................................... 57
4.2.
Diagrama general de secuencia CISACAGI IVR. ....................................................... 58
2
5.
4.3.
Diagrama general de secuencia CISACAGI administrador. ........................................ 59
4.4.
Diagramas UML .......................................................................................................... 60
4.6.1.
UML AGISCRIPT. .............................................................................................. 60
4.4.2.
UML CISCAGI AMI1 ......................................................................................... 61
4.6.3.
UML CISCAGI AMI2 ......................................................................................... 62
INSTALACIONES Y CONFIGURACIONES. ............................................................................... 63
5.1.
Instalación Asterisk (Distribución Elastix). ................................................................ 63
5.2.
Instalación Festival. (TTS [Conversor de texto a voz]). .............................................. 67
5.3.
Instalación Cacti (Monitorizador de Servidores). ........................................................ 69
Configurando Apache .......................................................................................................... 71
Configurando Mysql ............................................................................................................. 71
Instalando Cacti.................................................................................................................... 71
Creación de base de datos MYSQL para datos de cacti ...................................................... 73
Asignando permisos necesarios ........................................................................................... 74
Graficando la Red ................................................................................................................. 77
Viendo las graficas ............................................................................................................... 79
5.4.
Configuration AMI (Asterisk Manager Interface) ....................................................... 80
5.5.
Configuración CDR ..................................................................................................... 83
Campos del CDR ................................................................................................................... 83
5.6.
Configurando Asterisk para guardar los registros del CDR en MySQL ...................... 85
5.7.
Configuración FAST-AGI ........................................................................................... 91
ARCHIVO EXTENSIONS.CONF ............................................................................................... 92
ARCHIVO FASTAGI-MAPING.PROPERTIES ............................................................................ 92
ARCHIVO CISCAGIROUTER:XML ........................................................................................... 93
5.8.
Configuración de la Base de seguridad CISCAGISEGU ............................................ 96
3
1. ARQUITECTURA DE LA SOLUCIÓN
La Arquitectura propuesta contará de tres elementos:
• El servidor Asterisk
• El servidor de aplicaciones
• La Base de Datos
El servidor de aplicaciones se encargará de hacer las conexiones a base de datos y de
recibir la información de entrada que dará el usuario al sistema IVR así como también
procesar la información para brindar una respuesta adecuada, albergando el script del
IVR mismo. El servidor de aplicaciones se encargará también de alojar el sistema web y
requerimiento de información de la base de datos.
El servidor Asterisk será el encargado de contener la central telefónica y todas sus
bondades, contendrá el TTS (Festival) para las conversiones de texto a voz, también
CACTI (Monitorización de servidores para verificar el estado del servidor), el AGI para
la comunicación con las aplicaciones, también el CDR para reportes sobre la central
telefónica.
La base de datos el cual contendrá la información de los estudiantes de la carrera.
4
2. ARQUITECTURA DEL DESARROLLO
2.1. Tecnologías de la Solución
A continuación se detallarán las herramientas para el diseño e implementación del
sistema, indicando la justificación de la debida elección.
2.1.1. El Asterisk
Asterisk soporta muchos protocolos de VoIP, presenta capacidades que anteriormente
sólo eran encontradas en equipos propietarios, llevadas a cabo por medio de
implementaciones en software y arquitecturas funcionales.
Para el desarrollo del proyecto de tesis, se utilizará Asterisk en su versión dada la
capacidad de esta versión de interactuar con paquetes de software como Asterisk – Java,
ha ser descritos posteriormente.
2.1.2. Lenguaje de Programación
El lenguaje de programación elegido es Java. Se ha convertido en un lenguaje de
programación muy popular dada su robustez, simple sintaxis e interoperabilidad. Entre
las características principales de Java tenemos:
• Lenguaje de programación Orientado a objetos (POO) que permite la reutilización de
código, agilizando el desarrollo de software en la creación de sistemas de mayor
complejidad.
•
Lenguaje multiplataforma: Funciona de manera similar en diferentes sistemas
operativos.
5
Esto se debe a la interpretación del lenguaje realizado por la máquina virtual Java JVM;
dado que normalmente un lenguaje compilado es traducido y adaptado a un archivo
ejecutable para una determinada plataforma.
• Tiene capacidades de extender funcionalidades de un servidor web.
2.1.3.
Asterisk - Java
El API Asterisk – Java ofrece un conjunto de clases que permite la creación de
aplicaciones que puedan controlar y monitorear centrales PBX basadas en Asterisk 1.0,
1.2 y trabajos futuros en gestión de la versión 1.4. Actualmente este paquete está en su
versión 0.3 y está registrado bajo licencia Apache Versión 2.0.
El paquete Asterisk – Java está desarrollado mediante el protocolo FastAGI, por lo que
se permite poner en funcionamiento un servidor de requerimientos que recibirá y
mandará comandos por un socket TCP. Para esto será necesaria la configuración del
archivo extensions.conf ubicado en /etc/asterisk del servidor PBX.
A continuación se describirá el diseño del soporte de FastAGI del API Asterisk-Java en
su paquete org.asteriskjava.fastagi. Éste se basa en tres importantes interfaces:
AgiServer, AgiScript y MappingStrategy.
• La interfaz AgiServer tiene como responsabilidad escuchar los requerimientos AGI
provenientes de un servidor Asterisk y luego elegir el proceso para ese requerimiento,
invocarlos para proveer los medios para enviar comandos a Asterisk y recibir la
6
respuesta correspondiente. El API Asterisk-Java incluye ya la implementación de esta
interfaz en DefaultAgiServer. (Método utilizado en el proyecto)
• AgiServer usa una estrategia de mapeo (MappingStrategy) para la selección del
proceso, y esto se basa en la lectura del recurso y verificando la URL, esto es llamado
ResourceBundleMappingStrategy.
2.1.4. Diseño AGI del paquete ASTERISK-JAVA
• La tercera interfaz es el AgiScript, el cual se refiere al código mismo invocado para
atender un requerimiento. AgiScript es para Asterisk-Java lo que un servlet es para un
contenedor de servlets (servlet container). La interfaz AgiScript es bastante simple, usa
un método llamado service () al cual se le pasan el AgiRequest y el AgiChannel,
permitiendo enviar comandos Agi hacia Asterisk.
Para el desarrollo del presente proyecto se utilizarán principalmente los métodos
definidos en la clase BaseAgiScript, la cual nos ofrece control sobre acciones de la
propia central para pedir y brindar información necesaria para la implementación del
sistema IVR. Esta clase está ubicada en org.asteriskjava.fastagi y sus método son el
reflejo de los comandos AGI como métodos de una clase extensible en Java, lo que nos
permitirá ya en este ambiente generar otras clases necesarias para la interacción con la
base de datos.
Algunos de los métodos de la clase BASEAGISCIPT
7
Tipo
Nombre
Descripción
Void
Answer()
Contesta el canal
Int
Exec(String aplicacion)
Ejecuta un comando de una aplicación dada.
String
getData(String archivo)
Reproduce y espera datos para almacenar.
Void
StreamFile(String archivo)
Reproduce un archivo dado
Void
sayDigits(String cadena)
Reproduce una cadena de digitos
2.1.5. JasperReports
JasperReports es una fuente abierta de Java de presentación de informes herramienta que
puede
escribir
en
la
pantalla,
una
impresora
o
en PDF ,HTML , Microsoft
Excel , RTF , ODT , valores separados por comas y XML archivos.
Puede ser utilizado en aplicaciones Java habilitado, incluyendo Java EE o aplicaciones
Web, para generar contenido dinámico. Se lee las instrucciones de un XML o archivo.
Jaspe.
2.1.6. IReports
La herramienta iReport es un constructor / diseñador de informes visual, poderoso,
intuitivo y fácil de usar para JasperReports escrito en Java. Este instrumento permite que
los usuarios corrijan visualmente informes complejos con cartas, imágenes, sub
informes, etc. iReport está además integrado con JFreeChart, una de la biblioteca
gráficas Open Source más difundida para Java. Los datos para imprimir pueden ser
8
recuperados por varios caminos incluso múltiples uniones JDBC, TableModels,
JavaBeans, XML, etc.
Características de iReport
La lista siguiente describe algunas de las características importantes de iReport:

100% escrito en JAVA y además OPENSOURCE y gratuito.

Maneja el 98% de las etiquetas de JasperReports

Permite diseñar con sus propias herramientas: rectángulos, líneas, elipses,
campos de los textfields, cartas, subreportes (subreportes).

Soporta internacionalización nativamente.

Browser de la estructura del documento.

Recopilador y exportador integrados.

Soporta JDBC.

Soporta JavaBeans como orígenes de datos (éstos deben implementar la interface
JRDataSource).

Incluye Wizard‟s (asistentes) para crear automáticamente informes.

Tiene asistentes para generar los subreportes

Tiene asistentes para las plantillas.

Facilidad de instalación.
9
2.1.7. JavaMail
JavaMail es una expansión de Java que facilita el envío y recepción de e-mail desde
código java.
El JavaMail API no es parte del núcleo de Java SE, sino una extensión
opcional. Además, se requiere en Java Enterprise Edition. Los paquetes de JavaMail se
puede acceder de dos maneras:

mediante la colocación de j2ee.jar en la ruta de clases

o, mediante la colocación de dos mail.jar y activation.jar en la ruta de clases
El javax.mail API utiliza un archivo de propiedades para los nombres de servidor de
lectura y de configuración relacionados. Esta configuración anula cualquier defecto del
sistema. Por otra parte, la configuración se puede ajustar directamente en el código,
usando la API JavaMail.
2.1.8. SoftPhone (WebPhone MIZU)
El Mizu-Teléfono Web es un peso ligero estándar de VoIP de teléfono basado en
software que puede ser ejecutado desde páginas web . Basado en el estándar SIP
protocolo de la industria, es compatible con todos los dispositivos de VoIP y
servicios. Se puede llamar a cualquier otro teléfono SIP suave / teléfono IP (para la
carga gratis) o cualquier teléfono fijo y número de teléfono móvil a través de un
proveedor de servicios de VoIP de su elección.
10
El teléfono se implementa como un applet de Java o la aplicación y es totalmente
independiente de la plataforma que se ejecutan en cualquier navegador habilitado para
Java en todos los sistemas operativos (Windows, MAC, Linux, Solaris). Puede ser
utilizado como un softphone normal de funcionamiento en su sitio web o como-como los
botones de Skype (Haga clic aquí para llamar).
La persona que llama puede aceptar la llamada en un dispositivo VoIP (softphone,
teléfono IP, aplicaciones de call-centers) o puede ser contactado directamente a su
teléfono fijo o móvil. Todas las llamadas habituales características de enrutamiento se
puede habilitar (desvío de llamadas, transferencia de llamadas, etc)
Con Mizu-Teléfono Web puede agregar rápidamente las capacidades de VoIP para su
sitio web. (Página web, blog, foro, soporte / página de las ventas, sitio de redes sociales,
call center, etc.) El resto depende de tu imaginación.
Características WebPhone

SIP y RTP pila (compatible con cualquier servidor de VoIP o un dispositivo
como Cisco, Astérix, softphone, ATA y otros)

Norma applet de Java (no requiere instalación de software, se ejecuta
directamente desde todos los navegadores)

Las llamadas de VoIP con auto QoS

Protocolos de transporte: UDP, TCP, TLS, HTTP túnel
11

NAT / Firewall de apoyo, estable SIP y los puertos de RTP, la luz del protocolo
STUN y configuración automática

Protocolos de los medios de comunicación: mensajería instantánea (chat) y
capacidad de presencia

RFC: 2543, 3261, 2976, 3892, 2778, 2779, 3428, 3265, 3515, 3311, 3911, 3581,
3842, 1889, 2327, 3550, 3960, 4028, 3824, 3966, 2663, 3022

métodos compatibles: INVITE, ACK, PRACK, BYE, CANCELAR, UPDATE
MENSAJE, INFO, OPCIONES, suscribir, NOTIFICAR, CONSULTE

Codec: PCMU, PCMA, G.729 , GSM, Speex, iLBC

Banda ancha y banda ultra-ancha codec y salida estéreo

DTMF (método INFO en la señalización)

Volver a marcar, llamada espera , silencio y la transferencia (con operador y
automáticas)

Conferencia de llamadas (integrado en el mezclador RTP)

Llame al parque y recogida

Unlimited líneas

Balance de la pantalla, temporizador de llamadas

Grabación de voz (local y / o ftp upload)

Señalización y los medios de comunicación cifrado

Haga clic para llamar
12

Servidor de integración lado usando PHP,. NET, J2EE, etc

JavaScript API

Construido con su propia marca

Personalizable interfaz gráfica de usuario e idiomas

Funciones personalizadas
2.1.9. Base de Datos del Sistema
La base de datos elegida para el sistema IVR es Mysql, sistema de base de datos
relacional orientado a funcionar más en sincronía con las necesidades del Internet; por lo
que es el sistema preferido por las empresas dada su robustez y fidelidad.
Para la interacción con la base de datos desde los Scripts generados en Java para el
funcionamiento del Sistema IVR y su interacción con el sistema de base de datos se
utilizará el paquete mysql-conector-java-5.1.7.jar de MySQL compatible con JDK.
Para una mejor organización de las sentencias SQL (Structured Query Language) se
utilizarán paquetes y procedimientos almacenados en el mismo servidor de base de datos
con el fin de poder hacer transacciones para el desarrollo del sistema.
2.1.10. Servidor de Aplicaciones
El servidor de aplicaciones elegido para albergar la aplicación web de inscripción inicial
del flujo del servicio IVR es el BlazeDS que no es más que un Tomcat 5.5.12, el cual se
encuentra bajo licencia Open Source (Código Abierto) y fue creado en conjunto por
13
Apache Software Foundation y Sun Microsystems y que permite interactuar con
aplicaciones Flex y AIR enviando las consultas mediante protocolos AMF.
Una de las ventajas del uso de BlazeDS es que al estar desarrollado en Java, sólo
requerirá de una máquina virtual Java JVM para funcionar correctamente
indistintamente de la plataforma operativa en la que se encuentre.
2.1.11. Servidor TTS
Como parte de la tecnología anexa usada en los sistemas IVR, descritos en el capítulo
anterior, se ha visto necesaria la inclusión de un servidor TTS (Text to Speech) en el
desarrollo del presente proyecto. Para esto se ha elegido el sistema “Festival”,
desarrollado por el CSTR (The Centre for Speech Technology Research) de la
Universidad de Edimburgo, Inglaterra. “Festival” es un marco de trabajo que permite
construir sistemas de síntesis de voz. La versión actual de este sistema es el 2.0 y que
está disponible para descarga, ofreciendo soporte tanto en inglés americano y británico
así también como en español.
2.1.12. GUI
El diseño de la interfaz gráfica del aplicativo web que acompaña al servicio telefónico es
un juego de páginas en FLEX - AIR dada la sencillez de este lenguaje y la necesidad de
14
tan sólo un navegador web el único requerimiento seria que estas navegadores soporten
flash.
La arquitectura MVC o Modelo-Vista-Controlador se encarga de separar la presentación,
la lógica de control y el estado de la aplicación con el objetivo de hacer el sistema
modular; es decir, una parte puede ser cambiada sin alterar la otra.
El “controlador” será el encargado de recibir los requerimientos y es el responsable de
tomar acciones apropiadas en respuesta a cada requerimiento. El “modelo” está referido
a la representación del estado de la aplicación en la base de datos y los DAOS;
Finalmente la “vista” tomará la información provista por el “controlador” y el “modelo”
y la presenta al usuario.
Cabe notar que la vista del proyecto está formada por un modelo Factory method el cual
nos permite crear pantallas genéricas de manera sencilla y sin tener que crear clases lo
hace dinámicamente obteniendo la forma de las pantallas de una plantilla XML
guardada en una base de datos.
15
3. DICCIONARIO DE LIBRERIAS.
3.1.
INFORMACION GENERAL
Documentación técnica de las funciones del servidor java de conexiones AMI y AGI.
Para esto tenemos dos proyectos:
CISCAGI – AMI: encargado de conectarse con el manager de Asterisk e interactuar con
las diversas líneas de comando y con los archivos de configuración.
CISCAGI – AGI: Encargado de mantener levantado un servidor AGI para que este
reciba las reciba y envié procesos por voz siendo este un Dial Plan.
3.2.
INFORMACION FUNCIONES.
3.2.1. CISCAGI-AGI
Class Summary
Clase encargada levantar un servidor fastagi
Constructor Detail
CiscAgiScriptIVR
public CiscAgiScriptIVR()
CiscAgiScriptIVR
Method Detail
ivrRespuesta
public java.lang.String
ivrRespuesta(java.lang.String routerSoundsIVR,
16
org.asteriskjava.fastagi.AgiChannel channel,
long time,
int maximoNumeroDigits)
throws java.lang.Exception
Ivr de bienvenidas estos archivos de sonido no pueden ser
interrunpidos hasta que se termine el audio.
Parameters:
routerSoundsIVR channel Throws:
java.lang.Exception
candado
public java.lang.String
candado(java.lang.String routerSoundsIVR,
java.lang.Long time,
int maximoNumDigits)
throws java.lang.Exception
Candado de seguridad [ingreso de cedula]
17
Returns:
Throws:
java.lang.Exception
readAccion
public void readAccion(java.lang.String accion,
org.asteriskjava.fastagi.AgiChannel channel,
java.lang.String modo)
throws java.lang.Exception
Throws:
java.lang.Exception
cerrarLlamada
public void cerrarLlamada()
throws org.asteriskjava.fastagi.AgiException
Throws:
org.asteriskjava.fastagi.AgiException
inicializador
public int inicializador()
18
ivrSinInterrupcion
public boolean ivrSinInterrupcion()
ivrConInterrupcionTiempo
public boolean ivrConInterrupcionTiempo()
verificaSiTieneCandado
public boolean verificaSiTieneCandado()
verificaDtmfTienedata
public boolean verificaDtmfTienedata()
verificaAccionEnOpcion
public boolean verificaAccionEnOpcion()
service
public void service(org.asteriskjava.fastagi.AgiRequest request,
org.asteriskjava.fastagi.AgiChannel channel)
19
Clase encargada de manejar las distintas funciones e interpretarlas
para la clase agiscript encargada de retornar el IVR (dialplan)
Methods inherited from class com.ciscagi.dao.SecuryDao
consultaItem, consultaItems, consultaOpciones, getLogon, proce
dimientoAlmacenado, procedimientoAlmacenadoItems,procedi
mientoAlmacenadoItemsPorMenu, procedimientoAlmacenadoO
pcionesPorMenuItems
FuncionalidadesAgi
Script
Methods inherited from class com.ciscagi.utilitarios.Utils
anidarXml, convertstring, diferenciaDias, differenceTime, esCe
dulaValida, fechaHoraActual, formarFormasxml,formarJournalx
ml, formarSignxml, generarDate, generarHora, generarNumero
ConCeros, getVersion, leerDocDOM, loadXml, main,messagex
ml, messagexml, messagexml1, messageXmlPrinter, obtenerCan
tidadDigitos, obtenerFechaDeFormateoEspecial,readDocDOM,
readNodosxml, redondeoDecimalDouble, validarNulo, verificar
Cedula, verificarXml
20
Methods inherited from class
com.ciscagi.utilitarios.Formateador
fechaStringValue, generarDateSql, generarDateTimeUtil, genera
rDateUtil
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait,
wait, wait
Field Detail
items
public int items
privates ****************************
ivr
public java.lang.String ivr
timeout
public java.lang.Long timeout
21
digits
public int digits
candado
public java.lang.String candado
digitsLock
public int digitsLock
opc
public int opc
ivrLock
public java.lang.String ivrLock
idopc
public int idopc
idivr
22
public int idivr
accion
public java.lang.String accion
send
public java.lang.String send
avanza
public boolean avanza
mailEstud
public java.lang.String mailEstud
Method Detail
getIdopc
public int getIdopc()
setIdopc
public void setIdopc(int idopc)
23
getIdivr
public int getIdivr()
setIdivr
public void setIdivr(int idivr)
getAccion
public java.lang.String getAccion()
setAccion
public void setAccion(java.lang.String accion)
getSend
public java.lang.String getSend()
setSend
public void setSend(java.lang.String send)
getIvrLock
public java.lang.String getIvrLock()
24
setIvrLock
public void setIvrLock(java.lang.String ivrLock)
getItems
public int getItems()
setItems
public void setItems(int items)
getIvr
public java.lang.String getIvr()
setIvr
public void setIvr(java.lang.String ivr)
getTimeout
public java.lang.Long getTimeout()
setTimeout
25
public void setTimeout(java.lang.Long timeout)
getDigits
public int getDigits()
setDigits
public void setDigits(int digits)
getCandado
public java.lang.String getCandado()
setCandado
public void setCandado(java.lang.String candado)
getDigitsLock
public int getDigitsLock()
getDigitsLock
public void getDigitsLock(int digitsLock)
26
getOpc
public int getOpc()
setOpc
public void setOpc(int opc)
items
public void items(ReadXMLIVR readm)
throws java.lang.Exception
Throws:
java.lang.Exception
opcion
public void opcion(ReadXMLIVR readm,
int opc)
nextItemsIvr
public void nextItemsIvr(int it,
ReadXMLIVR readm)
Determina el siguiente items
27
Parameters:
items readm Throws:
java.lang.Exception
sayTTS
public void sayTTS(java.lang.String string,
org.asteriskjava.fastagi.AgiChannel channel)
throws java.lang.Exception
Función encargada de transformar texto a voz en español
usando tts festival
Parameters:
string channel Throws:
java.lang.Exception
envioMail
public int envioMail(java.lang.String messages,
28
java.lang.String destinatario,
java.lang.String cedula)
stringConvertSounds
public java.lang.String
stringConvertSounds(java.lang.String string,
org.asteriskjava.fastagi.AgiChannel channel)
throws java.lang.Exception
Funcion encargada de convertir una determinada cadena a
un archivo de sonido devolviendo su ubicacion y nombre
Parameters:
string channel Returns:
String (ubicacion y nombre del archivo)
Throws:
java.lang.Exception
eliminarUlaw
29
public void eliminarUlaw(java.lang.String ruta,
org.asteriskjava.fastagi.AgiChannel channel)
throws java.lang.Exception
Elimina los archivos de audio creados por el tts y despues
reproducidos en la llamada esperando un digito de
respuesta para acceder una respuesta IVR
Parameters:
ruta channel Throws:
java.lang.Exception
verificaDataCandado
public boolean verificaDataCandado(java.lang.String candado,
org.asteriskjava.fastagi.AgiChannel channel)
ReadXMLConsulta
Constructor Detail
30
ReadXMLConsulta
public ReadXMLConsulta(java.lang.String archivo)
cosntructor ****************************
Method Detail
GetOpcionesMS
public java.util.List<java.util.Vector> getOpcionesMS()
getters and setters ****************************
setOpcionesMS
public void
setOpcionesMS(java.util.List<java.util.Vector> opcionesMS)
getOpcionesTS
public java.util.List<java.util.Vector> getOpcionesTS()
setOpcionesTS
public void
setOpcionesTS(java.util.List<java.util.Vector> opcionesTS)
31
getOpcionesHC
public java.util.List<java.util.Vector> getOpcionesHC()
setOpcionesHC
public void
setOpcionesHC(java.util.List<java.util.Vector> opcionesHC)
crearDocDOM
public org.w3c.dom.Document
crearDocDOM(java.lang.String fichero)
Busca file dentro de repositorio
Parameters:
fichero Returns:
Document
leerDocDOM
public void leerDocDOM(org.w3c.dom.Document docDOM)
Lee file tipo Document el debe tener un xml y es recorrido
uno a uno sus nodos para setear campos de conexion
32
Parameters:
docDOM -
Constructor Detail
ReadXMLIVR
public ReadXMLIVR(java.lang.String archivo)
cosntructor ****************************
Method Detail
GetItems
public java.util.List<java.util.Vector> getItems()
ReadXMLIVR
getters and setters ****************************
setItems
public void setItems(java.util.List<java.util.Vector> items)
getOpciones
public java.util.List<java.util.Vector> getOpciones()
setOpciones
33
public void
setOpciones(java.util.List<java.util.Vector> opciones)
crearDocDOM
public org.w3c.dom.Document
crearDocDOM(java.lang.String fichero)
Busca file dentro de repositorio
Parameters:
fichero Returns:
Document
leerDocDOM
public void leerDocDOM(org.w3c.dom.Document docDOM)
Lee file tipo Document el debe tener un xml y es recorrido
uno a uno sus nodos para setear campos de conexion
Parameters:
docDOM -
34
3.2.2. CISCAGI-AMI
Class Summary
Clase que permite la comunicacion con la base de datos.
Constructor Summary
BaseDatosManager()
Constructor que permite iniciar la comunicación con la base de
datos.
Method Summary
BaseDatosManage
java.lang.String[] listarExtensiones()
r
Permite obtener una lista de las
extensiones asignadas a usuarios en la base de
datos.
static void
main(java.lang.String[] args)
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait,
35
wait
Constructor Detail
BaseDatosManager
public BaseDatosManager()
Constructor que permite iniciar la comunicación con la
base de datos.
Method Detail
listarExtensiones
public java.lang.String[] listarExtensiones()
Permite obtener una lista de las extensiones asignadas a
usuarios en la base de datos.
Returns:
El array con las extensiones
Clase que permite establecer y terminar una conexión con la API
ConexionManager Manager de Asterisk.
Field Summary
36
org.asteriskjava.manager.ManagerConnect managerConnectio
ion
n
Identificador
lara la conexión con
la API Manager que
se establecerá
Constructor Summary
ConexionManager()
Permite crear la ManagerConnection necesaria para
conectarse a la API Manager.
Method Summary
void finalizarConexion()
Finaliza la conexión a la API Manager.
void iniciarConexion()
Inicia la conexión a la API Manager.
37
Methods inherited from class
org.asteriskjava.manager.AbstractManagerEventListener
OnManagerEvent
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait,
wait
Field Detail
managerConnection
public org.asteriskjava.manager.ManagerConnection
managerConnection
Identificador lara la conexión con la API Manager que se
establecerá
Constructor Detail
ConexionManager
public ConexionManager()
throws java.io.IOException
Permite crear la ManagerConnection necesaria para
38
conectarse a la API Manager.
Throws:
java.io.IOException - Si la conexión de red falla
Method Detail
iniciarConexion
public void iniciarConexion()
throws java.io.IOException,
org.asteriskjava.manager.AuthenticationFailedException,
org.asteriskjava.manager.TimeoutException
Inicia la conexión a la API Manager.
Throws:
java.io.IOException - Si la conexión de red falla
org.asteriskjava.manager.AuthenticationFailedException Si falla la autenticación en Asterisk
org.asteriskjava.manager.TimeoutException - Si se excede
del Timeout
finalizarConexion
public void finalizarConexion()
39
Finaliza la conexión a la API Manager.
Clase que permite leer y escribir en los archivos de configuración
de la centralita PBX Asterisk.
Constructor Detail
ConfiguracionFicheros
public ConfiguracionFicheros(java.lang.String file)
throws java.io.IOException,
ConfiguracionFich
org.asteriskjava.manager.AuthenticationFailedException,
org.asteriskjava.manager.TimeoutException
eros
Constructor que permite inicializar la conexión a la API
Manager de Asterisk, así como los campos de la clase.
Parameters:
file - Nombre del archivo de configuración a leer/escribir
Throws:
java.io.IOException - Si la conexión de red falla
org.asteriskjava.manager.AuthenticationFailedException Si falla la autenticación en Asterisk
40
org.asteriskjava.manager.TimeoutException - Si se excede
del Timeout
ConfiguracionFicheros
public ConfiguracionFicheros(java.lang.String file,
ConexionManager con)
throws java.io.IOException,
org.asteriskjava.manager.AuthenticationFailedException,
org.asteriskjava.manager.TimeoutException
Constructor que permite asociar este servicio a una
conexión a la API Manager de Asterisk ya creada e
inicializada.
Parameters:
file - Nombre del archivo de configuración a leer/escribir
con - ConexionManager ya inicializada
Throws:
java.io.IOException - Si la conexión de red falla
org.asteriskjava.manager.AuthenticationFailedException Si falla la autenticación en Asterisk
41
org.asteriskjava.manager.TimeoutException - Si se excede
del Timeout
Method Detail
listarCategorias
public void listarCategorias()
Permite lanzar la acción GetConfigAction para el archivo
de configuración cuyo nombre sea el que figura en el
campo archivo.
Además, después obtiene una lista de las categorías
disponibles y la almacena en el campo cat.
Throws:
java.io.IOException - Si la conexión de red falla
org.asteriskjava.manager.TimeoutException - Si se excede
del Timeout
buscarCategoria
public int buscarCategoria(java.lang.String categ)
Permite buscar una categoría determinada dentro de un
archivo de configuración de Asterisk.
42
Previamente debe haberse ejecutado el
código listarCategorias().
Parameters:
categ - El nombre de la categoría a buscar
Returns:
-1 si no lo encontró. Un valor mayor que 0 indicará la
posición que ocupa la categoría en la variable cat
See Also:
org.yournamehere.server.ConfiguracionFicheros#listarCate
gorias()
listarCaracteristicas
public java.lang.String[][] listarCaracteristicas(int index)
Obtiene las características de una categoría concreta,
indicada con su índice (lugar que ocupa en el campo cat.
Si no se conociera el índice del mismo, pero sí el nombre
de la categoría, hay que usar primero el
código buscarCategoria(String), el cual devolverá el índice
deseado.
Parameters:
43
index - El índice que ocupa la categoría de la que queremos
extraer las características
Returns:
La lista de características, separando en la primera columna
el nombre de la característica y en la segunda el valor de la
misma. Por filas, las diferentes características
See Also:
org.tutatisk.server.ConfiguracionFicheros#buscarCategoria
(java.lang.String)
buscarCaracteristica
public int buscarCaracteristica(java.lang.String[][] lista,
java.lang.String carac)
Permite buscar una característica determinada dentro del
array de características pasado como argumento.
Previamente se recomienda haber ejecutado el
código listarCaracteristicas(int) para obtener el array que
pasar como argumento.
Parameters:
carac - El nombre de la característica a buscar
44
Returns:
-1 si no lo encontró. Un valor mayor que 0 indicará la
posición que ocupa la característica en la variable lista
See Also:
org.yournamehere.server.ConfiguracionFicheros#listarCara
cteristicas(int)
crearAccionEscritura
public MyUpdateConfigAction crearAccionEscritura()
Permite crear la acción MyUpdateConfigAction para poder
realizar la escritura en los archivos de configuración de
Asterisk.
Posteriormente a este código, habrá que añadir los
comandos a enviar y enviar la acción. Para ello
ver incluirComandos(String[], String[], String[], String[],
String[],
MyUpdateConfigAction) y enviarAccionEscritura(MyUpda
teConfigAction).
Returns:
La acción MyUpdateConfigAction creada
45
incluirComandos
public void incluirComandos(java.lang.String[] com,
java.lang.String[] cat,
java.lang.String[] var,
java.lang.String[] val,
java.lang.String[] mat,
MyUpdateConfigAction accion)
Permite añadir a una acción MyUpdateConfigAction
múltiples comandos para escribir.Cada comando completo
estará formado por un elemento de cada array de String
pasado como argumento.
Por ejemplo, para enviar dos comandos, cada uno de esos 5
arrays tendrá una longitud de 2, y en el índice 0 estará el
primer comando y en el índice 1 estará el segundo.
Parameters:
com - Array con todos los comandos a enviar
sucesivamente. Para ello, ver los comandos en los campos
estáticos de MyUpdateConfigAction
cat - Array con todas las categorías a las que se referirán
46
cada uno de los comandos anteriores
var - Array con las variables para cada comando
val - Array con los valores de las variables anteriores
mat - Array con los valores match para los anteriores
comandos
accion - Acción MyUpdateConfigAction sobre la que
añadir los comandos
enviarAccionEscritura
public void
enviarAccionEscritura(MyUpdateConfigAction accion)
throws java.io.IOException,
org.asteriskjava.manager.TimeoutException
Permite enviar la acción ya completa
MyUpdateConfigAction a la conexión a la API Manager.
Parameters:
accion - La acción MyUpdateConfigAction a enviar
Throws:
java.io.IOException - Si la conexión de red falla
org.asteriskjava.manager.TimeoutException - Si se excede
47
del Timeout
getArchivo
public java.lang.String getArchivo()
Devuelve el campo archivo
Returns:
El nombre del archivo de configuración a leer/escribir
setArchivo
public void setArchivo(java.lang.String arc)
Modifica el campo archivo
Parameters:
arc - El nombre del archivo de configuración a leer/escribir
Clase que permite gestionar todo lo relacionado con usuarios:
Registro Modificación de datos Eliminación de usuario
GestionUsuarios
Constructor Detail
GestionUsuarios
public GestionUsuarios(java.lang.String usuario,
48
java.lang.String password,
java.lang.String dni,
java.lang.String extension,
java.lang.String nombre,
java.lang.String apellido1,
java.lang.String apellido2,
java.lang.String email,
java.lang.String telefono,
java.lang.String tipo,
BaseDatosManager bbdd)
Inicializa un objeto. Inicializa el usuario. Se le pasa como
argumento la manager de la base de datos.
Parameters:
usuario - El nick de usuario
password - La contraseña para el acceso web
dni - El DNI de la persona en formato 11111111A. A su
vez, la clave por defecto para la conexión SIP será el DNI
sin la letra, en este caso, 11111111 (al querer que sea
numérico)
extension - La extensión escogida por el usuario
49
nombre - El nombre del usuario
apellido1 - El primer apellido
apellido2 - El segundo apellido
email - El email
telefono - El teléfono de contacto del usuario (ajeno al
sistema)
tipo - El tipo de usuario que es. Hay tres disponibles:
Alumno, Profesor y Administrador
bbdd - La manager de la base de datos
Method Detail
Registrar
public java.lang.String registrar()
Permite registrar un usuario en el sistema, tanto en la base
de datos como en la centralita asterisk.
Returns:
Mensaje de éxito/fracaso al registrar usuario
setUsuario
public void setUsuario(Usuario us)
50
Modifica el usuario sobre el que se realiza la gestión
Parameters:
us - CiscagiUsuario a gestionar
eliminar
public java.lang.String eliminar()
Permite eliminar un usuario en el sistema, tanto en la base
de datos como en la centralita asterisk.
Returns:
Mensaje de éxito/fracaso al eliminar usuario
modificar
public java.lang.String modificar(Usuario us,
java.lang.String passAsterisk)
Permite modificar los datos de un usuario ya registrado.
Además, da la opción de que la contraseña web sea
diferente de la contraseña de la extensión del usuario y
de su buzón de voz. Al crear el usuario, por defecto se
habà an cogido los números del DNI (la letra no).
Parameters:
51
us - Los datos del nuevo usuario, dentro de un objeto de la
clase CiscagiUsuario
passAsterisk - La contraseña que queremos poner a la
extensión y buzón de voz
Returns:
Mensaje de éxito/fracaso al modificar usuario
Clase encargada de ejecutar las distinas acciones con el AMI
Constructor Detail
MyUpdateConfigAction
public MyUpdateConfigAction()
MyUpdateConfig
MyUpdateConfigAction
Action
public MyUpdateConfigAction(java.lang.String srcFilename,
java.lang.String dstFilename,
boolean reload)
Method Detail
addCommand
public void addCommand(java.lang.String action,
52
java.lang.String cat,
java.lang.String var,
java.lang.String value,
java.lang.String match)
Overrides:
addCommand in
class org.asteriskjava.manager.action.UpdateConfigAction
ghostActionString
public java.lang.String ghostActionString()
getReload
public java.lang.String getReload()
Overrides:
getReload in
class org.asteriskjava.manager.action.UpdateConfigAction
Documentación técnico de clases de cliente Flex y sus distintas paqueterías.
En el aplicativo cliente AIR/Flex esta dividido en tres proyectos:
53
CISCAGI VIEWER : Proyecto AIR/Flex encargado de proveer la interfaz
grafica y principal del proyecto.
CISCAGI LIBRARY: Proyecto tipo Modules encargado de proveer las
diferentes librerías y clases utilitarios para el resto del proyecto.
ModuloIVR: Modulo encargado de generar interfaz grafica para consulta
de menú IVR estas no se generan de manera genérica ya que su i nterfaz
en un poco más compleja pero el proyecto AIR/Flex permite generar
formas genéricas así también permite el ingreso de módulos de extensión
swf. Estos ingresos si son de manera fácil solo bastaría con ingresarlo
dentro de la base objetos.
3.2.3. CISCAGIVIEWER
Packages
src.default
Contiene las distintos utilitarios utilizados tales como definiciones
src.assets
de hojas de estilo, imágenes, skins, fonts.
Contiene paquetes tales como:
ciscagi: Contiene clases principales del proyecto tales como:
src.com

Clases de conexiones a SQL Lite

Clases de conexiones via com.
54

Clases de mapeo para los distintos eventos.

Clases de manejo de interfaces GUI genéricas, objeto
abierto y modules de extensión swf.
flexmdi: Contiene clases actiosnscripts para los manejo de diseños
de las distintas GUI, tales como el uso de reflejos, manejo de las
hojas de estilo y skins.
3.2.4. CISCAGILIBRARY
Packages
Contiene las distintos utilitarios utilizados tales como definiciones
assets.images
de hojas de estilo, imágenes.
Contiene paquetes tales como:
Constants:Contiene el definiciones de contantes utilizados en los
proyectos.
alexsoft.common
Controls: Contiene clases actiosnscripts para los distintos
controles generales de las GUI.
Log :Contiene las constantes de clase Logs.
Utilis: Contiene los distintos clases que ayudaran con utilitarios
55
básicos tales como las diferentes validaciones tanto de
identificación , fechas, formatos etc.
Contiene las distintas clases de manejo de eventos para las
alexsoft.events
diferentes formas.
Contiene las clases tipo entidades para el manejo de objetos
alexsoft.vo
predeterminados para este proyecto.
3.2.5. ModuloIVR
Packages
Contiene la clase:
Class moduloivr.mxml
See Also:
src.default
Clase encargada de presentar la GUI principal que invocara a los
distintos mxml para funciones de consulta de totales y de
transacciones.
src.modules
Contiene paquetes tales como:
56
events: Contiene la definiciones manejo de eventos.
maps: Contiene las rutas de los eventos sucitados en el proyecto
GUI.
model :Contiene las clases manejadoras de funciones
trascendentales para el modulo.
ui: Contiene los distintos clases GUI para transacciones y consulta
de totales.
57
4. DIAGRAMAS DE LA APLICACIÓN
4.1.
Diagrama de desarrollo CISCAGI
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
58
4.2.
Diagrama general de secuencia CISACAGI IVR.
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
59
4.3.
Diagrama general de secuencia CISACAGI administrador.
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
60
4.4.
Diagramas UML
4.6.1. UML AGISCRIPT.
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
61
4.4.2. UML CISCAGI AMI1
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
62
4.6.3. UML CISCAGI AMI2
Fuente: Datos de la Investigación
Elaborado: Autores de la Tesis
63
5. INSTALACIONES Y CONFIGURACIONES.
5.1.
Instalación Asterisk (Distribución Elastix).
Inserte el CD de instalación de Elastix al momento de encender su máquina. Una vez
hecho esto aparecerá una pantalla como la siguiente:
Si usted es un usuario experto puede ingresar en modo avanzado digitando el comando:
advanced
Caso contrario espere, el CD de instalación iniciará la instalación automáticamente ó
presione enter.
Proceda a escoger el tipo de teclado de acuerdo al idioma. Si su teclado es de idioma
español seleccione la opción es:
64
Seleccione la hora zona horaria de su región:
Digite la contraseña que será usada por el administrador de Elastix. Recuerde que esta es
una parte crítica para la seguridad del sistema.
65
Nota: Los procedimientos a continuación los realizará el CD de instalación de manera
automática.
Primero se buscará las dependencias necesarias para la instalación:
66
Luego se procede con la instalación, inicialmente usted verá algo como esto:
Imagen del proceso de instalación por finalizar:
Una vez se realice la instalación completa, se procede a reiniciar el sistema.
Luego de reiniciar el sistema usted podrá escoger entre las opciones de boot la distro de
Elastix.
Ingrese como usuario root y la contraseña digitada al momento de la instalación.
67
5.2.
Instalación Festival. (TTS [Conversor de texto a voz]).
Una vez instalado Asterisk, se procederá a la instalación de los paquetes adicionales para
el funcionamiento del sistema e iniciaremos con el Festival, software usado para las
funciones del TTS. Para esto se ejecutamos en el promt del root el comando “yum install
festival”, esta sentencia descargará, descomprimirá e instalará el paquete festival que de
manera predeterminada viene en inglés, así que ahora procedemos a instalar el paquete
de español disponible en [FES2007], descargando el archivo de extensión .tar.gz y
descomprimiéndolo para un mejor desempeño en nuestro entorno.
Para programar el lenguaje a ser utilizado, alteraremos el archivo festival.scm, ubicado
en /usr/share/festival, al cual le agregaremos el siguiente script para usar por defecto el
lenguaje español en modo servidor:
ARCHIVO FESTIVAL.SCM – LENGUAJE ESPAÑOL
(language_spanish)
(set! voice_default 'voice_pc_diphone)
Una vez hecho esto, agregaremos un script en el mismo archivo que permitirá que
Asterisk interactúe directamente con Festival, el cual define la forma en que Asterisk
pasará las cadenas de texto a ser reproducidas:
ARCHIVO FESTIVAL.SCM – INTERACCION ASTERISK
;; Command for Asterisk begin
68
(define (tts_textasterisk string mode)
"(tts_textasterisk STRING MODE)
Apply tts to STRING. This function is specifically designed for
use in server mode so a single function call may synthesize the string.
This function name may be added to the server safe functions."
(utt.send.wave.client (utt.wave.resample (utt.wave.rescale (utt.synth
(eval (list 'Utterance 'Text string))) 5) 8000)))
;;; Command for Asterisk end
Finalmente se crea un usuario en el archivo festival.conf ubicado en /etc/asterisk en el
cual indicaremos las características de la conexión entre Asterisk y Festival, indicando la
ubicación del host Festival, en el caso de este proyecto encontrándose juntos: el puerto y
el comando, entre otros:
ARCHIVO /ETC/ASTERISK/FESTIVAL.CONF
[general]
host=localhost
port=1314
usecache=yes
cachedir=/var/cache/asterisk/festival/
festivalcommand=(tts_textasterisk "%s" 'file)(quit)\n
69
5.3.
Instalación Cacti (Monitorizador de Servidores).
Esta herramienta gráfica de red que extrae los datos desde el snmp para poder
monitorizar de manera gráficas los recursos de nuestros servidores y otros equipos en la
red.
Dependencias a instalar:
MySQL: Almacenar datos cacti.
Servidor de NET-SNMP - SNMP (Simple Network Management Protocol).
PHP con el módulo Net-SNMP - SNMP de datos de Access mediante PHP.
Apache / lighttpd / ngnix servidor web: servidor web para mostrar gráficos creados con
PHP y RRDtool.
Luego de instaladas estas dependencias, ejecutamos el comando “php –m | less” para
verificar que PHP tenga los siguientes módulos externos:
-mysql
-snmp
-xml
-session
-sockets
El siguiente paso será editar el archivo de configuración “/etc/php.ini” y modificar el
siguiente parámetro:
extensión_dir = /etc/php.d
70
En ese directorio se encuentran mayormente las librerías necesarias, pero en caso de
CentOs y otras distribuciones, estas librerías se encuentran en “/usr/lib/php/modules”
así que necesitaremos copiar las librerías ubicadas en ese directorio y copiarlas a
“/etc/php.d”, con el siguiente comando lo hacemos:
cp /usr/lib/php/modules/* /etc/php.d/
Y verificamos, modificamos o creamos los siguientes archivos del directorio /etc/php.d/
En /etc/php.d/mysql.ini
; Enable mysql extension module
extension=mysql.so
En /etc/php.d/snmp.ini
; Enable snmp extension module
extension=snmp.so
Luego de verificar que este todo correcto hasta el momento, debemos modificar el
archivo /etc/php.ini, verificando que este parámetro este de la siguiente manera:
file_upload = on ::: Para permitir la importación de plantillas :::
71
Configurando Apache
Editamos el archivo de configuración /etc/httpd/conf.d/php.conf y verificamos que los
siguientes parámetros estén de la siguiente manera:
LoadModule php5_module modules/libphp5.so
AddHandler php5-script .php
AddType text/html .php
DirectoryIndex index.php
Configurando Mysql
Subimos el servicio de mysql, con el comando ''service mysqld start''
Le damos una password a root:
mysqladmin –-user=root password „contraseña‟
Instalando Cacti
Para instalar cacti en CentOS es necesario tener los repositorios RPMforge, para su
instalación:
Descargamos los repositorios dependiendo de su arquitectura:
X86:
wget http://packages.sw.be/rpmforge-release/rpmforge-release-0.5.1-1.el5.rf.i386.rpm
72
X86_64:
Wget http://packages.sw.be/rpmforge-release/rpmforge-release-0.5.11.el5.rf.x86_64.rpm
Importamos las llaves Públicas:
rpm --import http://apt.sw.be/RPM-GPG-KEY.dag.txt
Instalamos el paquete:
rpm –i rpmforge-release-XXX.XXX.XXX.rpm
Y verificamos que se instalaron los repositorios con:
yum check-update
Luego podemos instalar Cacti, con todas las dependencias necesarias.
yum install cacti
Entre las dependencias que se instalaran están:
-rrdtool
-perl-rrdtool
73
Cuando finalice la instalación, podemos verificar que Cacti se instalo en /var/www/cacti,
y que creó un alias en /etc/http/conf.d/ llamado cacti.conf
Creación de base de datos MYSQL para datos de cacti
Nos ubicamos en /var/www/cacti, y usamos mysql para crear nuestra base de datos para
cacti.
Shell>mysqladmin –-user=root –p create cacti
shell> mysql --user=root -p cacti < cacti.sql
shell> mysql --user=root -p mysql
mysql> GRANT ALL ON cacti.* TO cacti@localhost IDENTIFIED BY „Contraseña‟;
mysql> flush privileges;
mysql> exit
Editamos el archivo /var/www/cacti/include/config.php, y verificamos que los siguientes
parámetros estén de la siguiente manera:
$database_type = "mysql";
$database_default = "cacti";
$database_hostname = "127.0.0.1";
74
$database_username = "cacti";
$database_password = "contraseña";
Asignando permisos necesarios
Nos ubicamos en el directorio /var/www/, y le cambiamos el propietario a la carpeta
cacti, le ponemos como propietario a apache.
chown –R apache.apache cacti/
Entramos al directorio cacti, y le cambiamos el usuario a las carpetas rra y log.
chown –R cacti rra/ log/
Agregamos a /etc/crontab, lo siguiente:
*/5 * * * * cacti php /var/www/html/cacti/poller.php > /dev/null 2>&1
Reiniciamos los servicios
service httpd restart
service snmpd restart
service mysqld restart
75
Y entramos desde nuestro explorador a htto://localhost/cacti/
Elegimos nueva instalación
76
3er Paso – Confirmamos todas las rutas
En caso de falta de paquetes, instalar net-snmp-utils
4to Paso – Ingresar a Cacti
El UserName y el Password son admin, luego nos pedirá que escribamos la nueva
contraseña.
77
Graficando la Red
El primer paso para crear gráficas de la red es agregando un host por cada host en la red
que se desea crear gráficas. Un host especifica detalles importantes como el nombre del
host, parámetros SNMP y el tipo de host.
Para manejar equipos dentro de Cacti, haga click en Devices en el menú de la izquierda.
Luego haga click en Add para llenar el formulario de una nuevo equipo. Los primeros
dos campos, Description y Hostname son los únicos campos que requieren entrada más
allá de las por defecto. Si su tipo de host está definido bajo el menú desplegable,
asegúrese de seleccionar este en el menú. Usted siempre puede elegir “Generic SNMPenables host” si solo va a graficar tráfico o “None” si no está seguro.
Ahora que ha creado nuevos equipos, es tiempo de crear gráficas para el mismo. Para
hacer esto, selección del menú de la izquierda la opción “New Graphs”. Si aun está en la
78
pantalla de editar el equipo, seleccione “Create Graphs for this Host” para ver una
pantalla similar a la siguiente imagen mostrada mas abajo.
El menú desplegable que contiene cada equipo debe ser usado para seleccionar el equipo
al cual usted quiere crear nuevas gráficas. El concepto básico en esta página es simple,
seleccione el cuadro de verificación en cada columna que usted quiere crear una grafica
y haga click en “Create”.
Si usted está creando gráficas dentro de la caja “Data Query”, hay algunas cosas
adicionales para tener en mente. Primero es que se puede encontrar con la situación
mostrada en la grafica mostrada más arriba con la consulta de datos “SNMP – Interface
Statistics”. Si esto ocurre usted quizás quiera consultar la sección en consultas de datos
en depuración para ver porque su consulta de datos no está retornando ningún resultado.
También, usted quiera ver el menú desplegable debajo de algunas cajas de consulta de
datos. Cambiando el valor de este menú afecta cual tipo de grafica Cacti construirá
79
después de hacer click en el botón “Create”. Cacti solo muestra este menú cuando hay
más de un tipo de donde escoger, así que puede que no se muestre en todos los casos.
Una vez ha seleccionado las gráficas que quiere crear, simplemente haga click en el
botón “Create” al final de la página. Usted será llevado a una nueva página que le
permite especificar información adicional sobre las gráficas que esta por crear. Solo vera
los campos que no son parte de cada plantilla, de todas formas el valor viene
automáticamente de la plantilla. Cuando todos los valores en esta página parezcan
correctos, haga click en el botón “Create” una última vez para crear finalmente las
gráficas.
Si le gustaría editar o eliminar gráficas después de haberlas creado, use el enlace “Graph
Management” en el menú de la izquierda de la pagina.
Viendo las graficas
En la parte superior de la página haga click en el boton “graphs” para ver las graficas.
80
5.4.
Configuration AMI (Asterisk Manager Interface)
La Interface de Administración de Asterisk, cuando se encuentra habilitada, abre un
socket TCP/IP (utiliza como puerto por defecto el 5038), éste es utilizado por un
programa cliente que se conecta a Asterisk y con ello tiene la facultad de ejecutar
comandos y leer las respuestas y eventos generados por el PBX. Para poder utilizar esta
característica es necesario establecer una sesión de administrador (Manager Sesión) y
autenticarse como tal. Para tal efecto debemos crear una cuenta de administración
(nombre de usuario y contraseña) en el archivo /etc/asterisk/manager.conf. En este
mismo archivo se establecerán los permisos y atribuciones a los que cada cuenta tiene
derecho.
Esta interfaz permite a las aplicaciones externas la capacidad de crear, monitorizar y
gestionar Asterisk.
Es decir que permite la manipulación de los archivos de configuración de los contextos
de los distintos archivos de configuración del Asterisk.
Para esto debemos acceder al asterisk y ubicarnos en la siguiente ruta
/etc/asterisk/manager.conf
Este archivo deberá contener lo siguiente:
81
[general]
displaysystemname = yes
enabled = yes
port = 5038
bindaddr = 127.0.0.1
displayconnects = yes
; Cuenta de usuario astmanproxy
[usuario]
secret = supersegura
; Contraseña
deny=0.0.0.0/0.0.0.0
; Host's a los que se les niega conexión
permit=127.0.0.1/255.255.255.255 ; Host's a los que se les permite conexión (localhost
en este caso)
; Permisos de lectura y escritura para 'usuario'
read = system,call,log,verbose,command,agent,user,config
write = system,call,log,verbose,command,agent,user,config
Para nuestro proyecto quedaría así:
82
;
; Asterisk Call Management support
;
[general]
enabled = yes
port = 5038
bindaddr = 0.0.0.0
[admin]
secret = elastix456
;deny=0.0.0.0/0.0.0.0
;permit=127.0.0.1/255.255.255.0
permit=0.0.0.0/0.0.0.0
read =all,system,call,log,verbose,command,agent,user,agi,config,originate,a
write =all,system,call,log,verbose,command,agent,user,agi,config,originate,a
#include manager_additional.conf
#include manager_custom.conf
El puerto por defecto es el 5038 se deberá dar permisos de IP
permit=0.0.0.0/0.0.0.0
En las siguientes líneas se dará permisos de escritura y lectura al AMI
read =all,system,call,log,verbose,command,agent,user,agi,config,originate,a
83
write =all,system,call,log,verbose,command,agent,user,agi,config,originate,a
Las líneas resaltadas son los permisos agregados siendo los más importantes agi,
originate para manipular el AMI.
El user y Password para ingresar al AMI mediante una aplicación para este caso es
user=admin Password=elastix456 (la clave varia segun la distribución asterisk a usar
esto es para Elastix.).
5.5.
Configuración CDR
CDR (Call Detail Records)
Un registro de detalle de llamadas (CDR) es el registro informático producido por una
central telefónica con los detalles de una llamada originada, interna o externa del lugar
de operaciones del PBX.
Asterisk normalmente almacena el Registro de Detalles de Llamadas en valores
separados por coma en el archivo (CSV). Si desea que el CDR sea almacenado en una
base de datos, tendrá que cargar el módulo apropiado y definir el archivo en cuestión.
Campos del CDR
1. accountcode: ¿Qué número de cuenta de usar: cuenta de facturación de Asterisk,
2. src: Caller * número de identificación.
3. dst: Extensión de destino.
4. dcontext: Contexto de destino.
5. clid: Caller * ID con el texto.
6. Channel: Canal utilizado.
84
7. dstchannel: Canal de destino, si procede.
8. lastapp: La última aplicación en su caso.
9. lastdata: La última solicitud de datos.
10. start: Inicio de la llamada (fecha/hora).
11. answer: Respuesta de la llamada (fecha/hora).
12. end: Fin de la llamada (fecha/hora).
13. duration: Tiempo total en el sistema, en segundos (entero), de marcar para colgar.
14. billsec: Llamada en tiempo total es, en cuestión de segundos (entero), de respuesta a
Colgar.
15. disposition: ¿Qué pasó con la llamada?
RESPONDIDAS, NO RESPONDIDAS, OCUPADA, FALLIDA (en algunos backends
CDR, por ejemplo, ODBC, estos pueden ser números enteros; en cuenta que
información más detallada se puede encontrar en la variable
HANGUPCAUSE).
16. amaflags: ¿Qué parámetros de uso? FACTURACIÓN, IGNORAR, etc.
Especificado en una base por canal como accountcode.
17. user field: Un usuario definido por el campo.
$ dialplan
85
5.6.
Configurando Asterisk para guardar los registros del CDR en MySQL
Por default Asterisk guarda los registros de llamadas en un archivo llamado Master.csv
el cuál es un archivo de texto separado por comas, pero para otros fines a veces es
necesario tenerlo en una base de datos para su posterior consulta, por ello pongo aquí un
tutorial de como conectar Asterisk a MySQL para guardar los CDRs.
Por cuestión de licencias de MySQL, Asterisk ya no incluye la opción de guardar los
registros en una base de datos de MySQL, por lo que ahora esa opción viene en
Asterisk-addons el cuál se tiene que bajar para la versión de Asterisk a usar y
compilarla.
wgethttp://downloads.asterisk.org/pub/telephony/asterisk/releases/asterisk-addons1.4.9.tar.gz
sudo tar -xzvf asterisk-addons-1.4.9.tar.gz
cd asterisk-addons-1.4.9
#Luego de que se descargue y se descomprima la versión de Asterisk Addons se tendrán
que editar los siguientes archivos
sudo editor cdr/cdr_addon_mysql.c
#agregar al principio la siguiente línea tal como está
#define MYSQL_LOGUNIQUEID
sudo editor cdr/Makefile
86
#agregar al final la siguiente línea tal como está
CFLAGS+=-DMYSQL_LOGUNIQUEID
#ahora si compilamos asterisk-addons
sudo make clean && sudo ./configure && sudo make && sudo make install
#si es una instalación nueva tendrías que ejecutar despues sudo make samples, si no, no
es recomendable para que no borre configuraciones ya realizadas.
#si todo salió bien en la compilación ahora edita el archivo
sudo editor /etc/asterisk/modules.conf
# y agrega al final
load => cdr_addon_mysql.so
#ahora crea un usuario con su password y una base de datos de mysql que será para el
cdr de asterisk
mysql -u root -p
create database asteriskcdrdb;
grant all privileges on asterisk.* to asterisk@localhost identified by"password";
flush privileges;
exit;
sudo editor asterisk.sql
# crea un archivo y agrega lo siguiente
87
CREATE TABLE `cdr` (
`calldate` datetime NOT NULL default '0000-00-00 00:00:00',
`clid` varchar(80) NOT NULL default ,
`SRC`
V A R C HA R (80)
NOT NULL
DE FA UL T
,
`dst` varchar(80) NOT NULL default ,
` D C ON T E X T `
V A R C HA R (80)
NOT NULL
D E FA UL T
,
`channel` varchar(80) NOT NULL default ,
`DSTCHANNEL `
V A R C HA R (80)
NOT NULL
DE F AU L T
,
`lastapp` varchar(80) NOT NULL default ,
`LASTDATA`
V A R C H A R (80)
NOT NULL
D E FA UL T
,
`duration` int(11) NOT NULL default '0',
`billsec` int(11) NOT NULL default '0',
`disposition` varchar(45) NOT NULL default ,
` AM A F L A GS `
I N T (11)
` A C C O U N T C OD E `
NOT NULL
V A R C HA R (20)
DE FA UL T
NOT NULL
'0',
DE FA UL T
`uniqueid` varchar(32) NOT NULL default ,
` U S E R FI E L D `
V A R C H A R (255)
NOT NULL
DE F AU L T
);
ALTER TABLE `cdr` ADD INDEX ( `calldate` );
ALTER TABLE `cdr` ADD INDEX ( `dst` );
,
88
ALTER TABLE `cdr` ADD INDEX ( `accountcode` );
#ahora ejecutemos el script de sql
mysql -u asterisk -p asteriskcdrdb < asterisk.sql
#ahora solo falta editar la conexión de asterisk a mysql, para eso editar el siguiente
archivo
sudo editor /etc/asterisk/cdr_mysql.conf
#aqui editar los siguientes valores
[global]
hostname = localhost
dbname=asteriskcdrdb
table=cdr
password = password
user = Asterisk
port=3306
sock=/var/run/mysqld/mysqld.sock
userfield=1
#es importante que en sock= asignes dónde mysql coloca ese arhivo en Debian y
ubuntu por default lo pone en /var/run/mysqld/mysqld.sock
89
#Ahora ya teniendo casi todo listo solo inicia asterisk
sudo asterisk start
#si usas freepbx entonces
sudo amportal restart
#verificamos que se haya cargado el módulo de mysql para Asterisk
sudo asterisk -rvvv
PhylevnMobile*CLI> module show like mysql
#y debería mostrar algo como lo siguiente
Module
Description
Use
cdr_addon_mysql.so
MySQL CDR
Backend
0
Interface
0
Driver
0
app_addon_sql_mysql.so
res_config_mysql.so
Simple Mysql
MySQL RealTime Configuration
3 modules loadedI>
#ahora vemos el status de la conexión de MySQL
PhylevnMobile*CLI> cdr mysql status
#y mostraría algo como lo siguiente
Count
90
Connected to asteriskcdrdb@localhost, port 3306 using table cdr for 1hours, 1 minutes,
0 seconds.
Wrote 1 records since last restart.
-- Registered IAX2 '300' (AUTHENTICATED) at 127.0.0.1:32768
#Si dice Not Connected entonces verificar los parámetros de conexión a la base de
datos e igual checar que la base de datos esté dada de alta.
#salimos
PhylevnMobile*CLI> exit
#ahora marcamos algún número desde un Softphone o teléfono IP para verificar que
esté trabajando.
#Checamos el registro de la base de datos
mysql .u asterisk -p asteriskcdrdb
mysql> select * from cdr;
+---------------------+-------------+-----+--------+-----------+------------------+
| calldate
| clid
| src | dst
| dcontext | channel
+---------------------+-------------+-----+--------+-----------+------------------+
| 2009-07-21 21:36:44 | "1103" <Support> | 1103 | vmu101
91
+---------------------+-------------+-----+--------+-----------+------------------+
1 row in set (0.00 sec)
5.7.
Configuración FAST-AGI
El archivo extensions.conf, el cual se encuentra en “/etc/asterisk” y contiene el plan de
discado (dialplan) del contexto “sistema”, será configurado asignando un número al
sistema IVR, el cuál será la extensión 601. Esta extensión hará referencia al servidor
AGI y al nombre mapeado en fastagi-mapping.properties, archivo de propiedades que
será explicado más adelante. Adicionalmente se implementaron 2 extensiones llamadas
“usuario0” y “usuario1” en los archivos iax.conf y sip.conf respectivamente para
pruebas iniciales en el mismo contexto.
Adicionalmente se creó la carpeta “tesis” en la ruta /home/ivrciscagi/error,
/home/ivrciscagi/general,
/home/ivrciscagi/menu
para
almacenar
las
locuciones
grabadas.
Nota: Estas rutas también se deben configura en la base ciscagisegu en la definición del
dial plan ahí se definen las rutas donde están los archivos de sonido.
92
ARCHIVO EXTENSIONS.CONF
[sistema]
exten => 1234,1,Dial(IAX2/usuario0)
exten => 1234,2,Hangup()
exten => 1235,1,Dial(SIP/usuario1)
exten => 1235,2,Hangup()
exten => 600,1,Answer
exten => 600,2,SetMusicOnHold(default)
exten => 600,5,Background(/tesis/en/00)
[outbound-allroutes]
exten => #TELEFONICO,1,Agi(agi:// 127.0.0.1/hello.agi)
exten => #TELEFONICO,2,Hangup
[INbound-allroutes]
exten => #TELEFONICO,1,Agi(agi://127.0.0.1/hello.agi)
exten => #TELEFONICO,2,Hangup
ARCHIVO FASTAGI-MAPING.PROPERTIES
hello.agi = com.ciscagifastagi.fastagi.CiscAgiScriptIVR
Para esto debemos contar con el paquete Asterisk-Java en una ubicación del sistema de
archivos, y el archivo fastagi-mapping.properties, el cual será el encargado de mapear el
93
script realizado en Java correspondiente a la lógica del negocio del IVR a una extensión
“.agi” , la cual será empleada para invocar el script remotamente, utilizando el socket ya
explicado previamente.
El archivo antes mencionado referencia al código propio del IVR llamado
CiscAgiScriptIVR.java, el cual se colocará también en la misma ubicación del sistema
de archivos que el archivo de mapeo, o en su defecto se colocará la ruta entera de la
ubicación de CiscAgiScriptIVR.java en el archivo fastagi-mapping.properties.
Con
esto
realizado
sólo
queda
levantar
el
servidor,
ejecutando
org.asteriskjava.fastagi.DefaultAgiServer, el cual levantará el hilo respectivo para recibir
los requerimientos FASTAGI vía el puerto 4573.
Para la manipulación de ésta variable, se generó el archivo fastagi-mapping.properties,
ciscagirouter.xml y se colocó en el Classpath al momento de la ejecución.
ARCHIVO CISCAGIROUTER:XML
<?xml version="1.0" encoding="UTF-8"?>
<configuracion>
<!--* Archivo de configuración que me permite setear las distintas bases con la
que interactuara el proyecto CiscAgi-Voice entre las cuales están los login y direcciones
ip para ingreso a base de seguridades, base de datos de respuesta según ivr (en este caso
94
base de estudiantes de la carrera ingeniería en sistemas), manager del asterisk (para
permisos de acceso creación y lectura de archivos en las rutas /etc/asterisk/).*******
example:
Conexión a base sql
<base>sql</base>
<url>jdbc:sqlserver://</url>
<url>jdbc:microsoft:sqlserver://</url>
<serverName>asserver</serverName>
<portNumber>1492</portNumber>
<databaseName>Fenix</databaseName>
<userName>sa</userName>
<password>alexsoft</password>
<selectMethod>cursor</selectMethod>
-->
<!-- Conexión a MangerAsterisk; quien proporciona los permisos de conexión al
Asterisk y sus distintos archivos para su manipulación tanto lectura y escritura. -->
<managerserver>192.168.188.129</managerserver>
<managerlogin>admin</managerlogin>
<managerpass>elastix456</managerpass>
95
<!-- Conexion a Asterisk -->
<urlAsterisk>jdbc:mysql://</urlAsterisk>
<serverNameAsterisk>192.168.188.129</serverNameAsterisk>
<portNumberAsterisk>3306</portNumberAsterisk>
<databaseNameAsterisk>asterisk</databaseNameAsterisk>
<userNameAsterisk>root</userNameAsterisk>
<passwordAsterisk>123456</passwordAsterisk>
<selectMethod>cursor</selectMethod>
<!-- Conexion a Base Seguridad -->
<urlSecury>jdbc:mysql://</urlSecury>
<serverNameSecury>127.0.0.1</serverNameSecury>
<portNumberSecury>3306</portNumberSecury>
<databaseNameSecury>ciscagisegu</databaseNameSecury>
<userNameSecury>root</userNameSecury>
<passwordSecury>alexsoftsa</passwordSecury>
<selectMethod>cursor</selectMethod>
<!-- Conexion a Base Estudiantes -->
<urlCisc>jdbc:mysql://</urlCisc>
96
<serverNameCisc>127.0.0.1</serverNameCisc>
<portNumberCisc>3306</portNumberCisc>
<databaseNameCisc>ciscbd</databaseNameCisc>
<userNameCisc>root</userNameCisc>
<passwordCisc>alexsoftsa</passwordCisc>
<selectMethod>cursor</selectMethod>
<tiempoBase>10</tiempoBase>
</configuracion>
Este archivo contiene las rutas user y password de las base de datos con las que se va a
obtener el dialplan y la información a presentar en este caso el de la base de estudiantes.
Ahora solo queda correr el jar generado desde la consola java –jar CiscAgiFastAgi.jar.
Y está listo para escuchar inBounds u OutBounds según sean los requerimientos y
generar el dial plan para responder con la operadora automática.
Nota. Este jar se lo puede dejar corriendo como demonio o servicio según sean los
requerimientos.
5.8.
Configuración de la Base de seguridad CISCAGISEGU
Esta base maneja los niveles de seguridad del aplicativo web así como también guarda el
dial plan que se generara en la central esta base contiene las rutas de los archivos de
97
sonido así como también las acciones a seguir dependiendo del ingreso DTMF al
realizar una consulta.
Aquí una breve explicación del contenido de sus tablas y procedimientos:
Contiene 7 tablas y 4 procedimientos.
Tables:
Items: Contiene los ítems es decir todas las líneas dialplan
MenuIvr: Contiene las descripciones de los diferentes dialplan y define el principal y
con que ítems está ligado.
98
MenuOpcion: Contiene las diferentes acciones a tomar dependiendo de la línea
escogida.
Permisos: Permiso de visualización en el administrador web.
Screen: Pantallas con las que interactuara el administrador web es de donde tomara las
diversas pantallas a utilizar.
Sesiones
User: Permisos de usuario para el administrador web.
Procedures:
ConsultaItems
99
ConsultaItemsPorMenu
ConsultaOpcionesPorItem
ConsultaOpcionesPorMenuItem
Las tablas contiene la información que se visualice más abajo el Proyecto lo que realice
es transformar esta información obtenida desde la base y transformarla en un XML el
cual es cargado en una variable y guardado cuando inicie el aplicativo.(No realiza una
consulta a la base por cada llamada para extraer la información del dialplan lo hace una
sola vez para no cargar demasiado al servidor lo hace al subir el servicio Fastagi).
<?xml version='1.0' encoding='iso-8859-1'?>
<ivr>
<items ivr='/home/ivrciscagi/general/bienvenida' id='1' timeout='0' digits='0'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
<items ivr='/home/ivrciscagi/menu/001001000' id='2' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' >
<opciones opc='1' accion='' idivr='3' send='v' />
<opciones opc='2' accion='' idivr='9' send='v' />
<opciones opc='0' accion='EXT' idivr='0' send='o' />
<opciones opc='3' accion='EXT' idivr='0' send='e' />
</items>
100
<items ivr='/home/ivrciscagi/menu/001002000' id='3' timeout='20000' digits='1'
candado='c' digitsLock='10' ivrLock='/home/ivrciscagi/general/candado' >
<opciones opc='1' accion='' idivr='4' send='v' />
<opciones opc='2' accion='' idivr='6' send='v' />
<opciones opc='3' accion='' idivr='5' send='v' />
<opciones opc='4' accion='' idivr='7' send='v' />
<opciones opc='0' accion='' idivr='2' send='v' />
</items>
<items ivr='/home/ivrciscagi/menu/001003000' id='4' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' >
<opciones opc='1' accion='NP1' idivr='0' send='v' />
<opciones opc='2' accion='NP2' idivr='0' send='v' />
<opciones opc='3' accion='REC' idivr='0' send='v' />
<opciones opc='0' accion='' idivr='3' send='v' />
</items>
<items ivr='/home/ivrciscagi/menu/001004000' id='5' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
<items ivr='/home/ivrciscagi/menu/001005000' id='6' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' >
<opciones opc='1' accion='CNH' idivr='0' send='m' />
101
<opciones opc='2' accion='CNH' idivr='0' send='m' />
<opciones opc='0' accion='' idivr='3' send='v' />
</items>
<items ivr='/home/ivrciscagi/menu/001006000' id='7' timeout='0' digits='0'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
<items ivr='/home/ivrciscagi/menu/001007000' id='8' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
<items ivr='/home/ivrciscagi/menu/001008000' id='9' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' >
<opciones opc='1' accion='' idivr='8' send='v' />
<opciones opc='2' accion='' idivr='11' send='v' />
<opciones opc='3' accion='' idivr='10' send='v' />
<opciones opc='0' accion='' idivr='3' send='v' />
</items>
<items ivr='/home/ivrciscagi/menu/001009000' id='10' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
<items ivr='/home/ivrciscagi/menu/001010000' id='11' timeout='20000' digits='1'
candado='" "' digitsLock='0' ivrLock='" "' ></items>
</ivr>
Aquí interpretaremos un ítem para su mejor comprensión:
102
<items ivr='/home/ivrciscagi/general/bienvenida' id='1' timeout='0' digits='0' candado='"
"' digitsLock='0' ivrLock='" "' ></items>
Items = dialplan
Propiedades
Ivr: Esta propiedad contiene la ruta del archive de sonido a invocar (recordar que estos
archivos de sonido deben estar en una ruta del servidor Asterisk).
Id: Esta propiedad indica el número del sonido a interpretar es decir la línea que se
emitirá por sonido.
Timeout: Esta propiedad es encargada de determinar si tiene un tiempo espera para
terminar la locución completa caso contrario si es igual a 0 esta se cortaría en caso de
escuchar un tono DTMF.
Recordar que los valores de Timeout están en milisegundos.
Digits: indica cuantos tonos DTMF va escuchar para generar una orden, ejemplo en el
caso del candado digital se deberá ingresar 10 dígitos que forman el número de cédula,
por tanto esperará 10 tonos DTMF para enviar a una acción. Pero por default será 1.
Candado: Si se va a habilitar un candado digital por defecto será el numero de cedula y
se pondrá c caso contrario será un espacio en blanco.
<items
ivr='/home/ivrciscagi/menu/001002000'
id='3'
timeout='20000'
candado='c' digitsLock='10' ivrLock='/home/ivrciscagi/general/candado' >
<opciones opc='1' accion='' idivr='4' send='v' />
digits='1'
103
<opciones opc='2' accion='' idivr='6' send='v' />
<opciones opc='3' accion='' idivr='5' send='v' />
<opciones opc='4' accion='' idivr='7' send='v' />
<opciones opc='0' accion='' idivr='2' send='v' />
</items>
Aquí
por
ejemplo
primero
emitirá
ivrLock='/home/ivrciscagi/general/candado'
el
sonido
que
este
en
y esperara tantos tonos DTMF como
indique digitsLock='10' una vez realizado el candado si es correcta la validación
entonces emitirá el sonido grabado en ivr='/home/ivrciscagi/menu/001002000' y según
el digito marcado escogerá una opción:
<opciones opc='1' accion='' idivr='4' send='v' />
<opciones opc='2' accion='' idivr='6' send='v' />
<opciones opc='3' accion='' idivr='5' send='v' />
<opciones opc='4' accion='' idivr='7' send='v' />
<opciones opc='0' accion='' idivr='2' send='v' />
DigitsLock: Esta propiedad va amarrada al candado digital aquí se definen el numero de
tonos DTMF escuchara para efectuar una acción.
104
IvrLock: Esta propiedad se encarga de contener la ruta de un archivo de sonido a
escuchar antes de ingresar el candado digital.
Opciones
<items
ivr='/home/ivrciscagi/menu/001008000'
id='9'
timeout='20000'
digits='1'
candado='" "' digitsLock='0' ivrLock='" "' >
<opciones opc='1' accion='' idivr='8' send='v' />
<opciones opc='2' accion='' idivr='11' send='v' />
<opciones opc='3' accion='' idivr='10' send='v' />
<opciones opc='0' accion='' idivr='3' send='v' />
</items>
Una vez escuchado el sonido de determinada línea si el digito DTMF es igual a uno
definido dentro de opciones entonces genera una acción.
Aquí definimos el significado de las propiedades.
Opc: numero de tono DTMF escogido si es igual al definido en opc entonces tiene una
acción caso contrario no existe esa opción.
Accion: Esta propiedad genera una acción definida por unas variables

Accion =CNH Consulta de notas de estudiantes por parcial.

Accion =NP1 Consulta de notas de estudiantes parcial 1.

Accion =NP2 Consulta de notas de estudiantes parcial 2.
105

Accion =REC Consulta de notas de estudiantes mejoramiento.

Accion =PRO Consulta de notas de estudiantes promedio.
Send: Este indica el tipo de acción que se generara es decir solo hay dos eventos envió
por mail o enviar las notas vía sonido.
send =m Envió por mail
send = m Envió por sonido
Idivr: Indica a que línea o ítems deberá ser accesada y enviada vía sonido para esto la
propiedad acción deberá estar vacía.