Diferencia entre revisiones de «Aplicaciones Básicas»

De Asterisk Wiki
Ir a la navegación Ir a la búsqueda
Línea 108: Línea 108:
 
Muy parecida a la aplicación esta constituye el formato condicional para que se produzca la redirección. Consideremos que GoTo se ejecuta siempre, pero en este caso, si utilizamos una expresión regular como podemos ver en [[Introducción Dialplan]], que devuelva un valor Booleano (0 o 1), entonces redirigiremos el canal hacía un punto del dialplan, u otro (o simplemente dejaremos que la llamada continue su curso).
 
Muy parecida a la aplicación esta constituye el formato condicional para que se produzca la redirección. Consideremos que GoTo se ejecuta siempre, pero en este caso, si utilizamos una expresión regular como podemos ver en [[Introducción Dialplan]], que devuelva un valor Booleano (0 o 1), entonces redirigiremos el canal hacía un punto del dialplan, u otro (o simplemente dejaremos que la llamada continue su curso).
  
En este caso la sintaxis es la siguiente: '''Gotoif(<expresion_regular_condicional>?<redirección_si_verdadero:<redireccion_si_falso>).
+
En este caso la sintaxis es la siguiente: '''Gotoif(<expresion_regular_condicional>?<redirección_si_verdadero:<redireccion_si_falso>)'''.
 
* Si no especificamos la redirección en el caso que no se cumpla la condición (si falso), entonces la extensión continua en la siguiente prioridad por su cauce.
 
* Si no especificamos la redirección en el caso que no se cumpla la condición (si falso), entonces la extensión continua en la siguiente prioridad por su cauce.
 
* Las opciones <redireccion_si_verdadero/falso> siguen la misma estructura de redirección que la utilizada en el apartado '''GoTo'''.
 
* Las opciones <redireccion_si_verdadero/falso> siguen la misma estructura de redirección que la utilizada en el apartado '''GoTo'''.
Línea 118: Línea 118:
  
 
Con esta estructura tenemos potencial para hacer todo tipo de algoritmos, considerando que el "valor" de entrada que manipulamos es la llamada. Esto es muy práctico sobre todo cuando realizamos las funciones que por doquier suelen ser más complejas en los sistemas de marcación, los IVR (Interactive Voice Response), sistemas de respuesta de voz interactiva, en las que el llamante, va interactuando con la máquina para obtener determinadas funcionalidades (por ejemplo saber el saldo de su cuenta de crédito, realizar autentificación en sistemas seguros, comprar un producto sin ser atendido, etc). Esto se ve más a fondo en el apartado [[Dialplan Avanzado]].
 
Con esta estructura tenemos potencial para hacer todo tipo de algoritmos, considerando que el "valor" de entrada que manipulamos es la llamada. Esto es muy práctico sobre todo cuando realizamos las funciones que por doquier suelen ser más complejas en los sistemas de marcación, los IVR (Interactive Voice Response), sistemas de respuesta de voz interactiva, en las que el llamante, va interactuando con la máquina para obtener determinadas funcionalidades (por ejemplo saber el saldo de su cuenta de crédito, realizar autentificación en sistemas seguros, comprar un producto sin ser atendido, etc). Esto se ve más a fondo en el apartado [[Dialplan Avanzado]].
 +
 +
=== Aplicación GoToIfTime ===
 +
 +
Haciendo una combinación aún más allá, existe una variante de GoToIf, y es especificando un momento concreto como expresión de la condición. Por lo demás todo es igual.
 +
 +
La sintaxis sería la siguiente: '''Gotoiftime(<condicion_temporal>?<redireccion_si_verdadero>:<redireccion_si_falso>)'''
 +
 +
Evidentemente vamos a enfocar en la condicion temporal, si alguna vez hemos utilizado el sistema CRONTAB de *NIX es muy parecida la notación:
 +
 +
* Para considerar validas todas las posibilidades de cualquier parámetro mostrado a continuación, se especificaría con un Asterisco ('''*''')
 +
* Para cada valor incluso se pueden considerar múltiples posibilidades para que se cumpla la condición utilizando una barra vertical ('''|'''), sería algo así como un condicional OR.
 +
* Se pueden además especificar intervalos entre dos posibles parámetros con un guión ('''-'''), por ejemplo en caso de un día del mes a otro, sería 10-20.
 +
* El primer parámetro sería el tiempo horario, en horas y minutos. Ejemplo: 11:00.
 +
* El segundo parámetro sería el dia de la semana, primeras tres letras del día de la semana en inglés.<ref http://en.wikipedia.org/wiki/Weekday_names Ejemplo: Thursday sería thu.
  
 
== Aplicación Background ==
 
== Aplicación Background ==

Revisión del 13:23 15 may 2012

Format.png Formatear
Esta página necesita ser editada para cumplir los requisitos del wiki.
Puedes revisar todas las páginas sin suficiente formato en este enlace.
Alert.png To Do
Esta página necesita ser completada.
Puedes revisar todas las páginas por completar en este enlace.


El mundo de las Aplicaciones en Asterisk es tan extenso que merece ser tratado independientemente. Concretamente existen una serie de aplicaciones que son utilizadas recurrentemente, y es importante que sean vistas y tratadas de manera especifica, como parte del formato de construcción de nuestros Planes de Marcación.

Logo Asterisk

Aplicación Answer

Traducción directa de "Responder". La función de esta aplicación básicamente es la de descolgar la llamada entrante. Puede resultar trivial, pero hay que entender que en función de las aplicaciones que vengan a continuación es posible que sea necesario que nuestra máquina Asterisk ya tenga el control sobre el canal entrante (mediante el uso de esta aplicación), o no lo requiera de momento.

A nivel de mensaje SIP ejecutar esta aplicación es lo mismo que enviar un mensaje al par que llama de OK. Hay que considerar que en el momento que lanzamos esta aplicación al descolgar la llamada, ya comenzaría el ciclo de facturación del llamante por lo que eventualmente, a no ser que sea estrictamente necesario, no es una buena idea incluirla en nuestro dialplan por sistema o costumbre. Tenemos que saber si las aplicaciones sucesivas, realmente requieren que el canal este "contestado" para que funcionen correctamente.

Puede recibir un solo parámetro Answer(<retraso>), numérico en milisegundos, tiempo que esperara antes de recepcionar la llamada. Es equivalente a poner la aplicación Wait previa a esta, por lo que no es muy común, dado que "complica" un poco el código.

Aplicación Progress

Contrariamente a la aplicación Answer, es posible enviar un mensaje llamado 183 Session Progress. Es considerado una forma de enviar "Audio por adelantado" y solo funciona evidentemente en entornos donde este mensaje sea permitido como SIP e IAX. Con este mensaje lanzado, podríamos a continuación ejecutar alguna aplicación o recurso que necesite este mensaje "Early Audio" como laMúsica en Espera

Aplicación Playback

La sintaxis especifica es: PlayBack(archivo1[&archivoN],opciones)

Sirve para reproducir una pista de audio contenida en un fichero dentro de nuestra máquina. El método de seleccion de esta pista, si solo especificamos el nombre, lo consultará en el directorio asociado al lenguaje que estemos utilizando para el canal especifico. Si en nuestro fichero de configuración SIP, definimos por defecto el lenguaje Español (es), y es un dispositivo SIP el que accede a la extensión que ejecuta esta aplicación de reproducción entonces consultaría en el directorio especifico de pistas en español (var/lib/asterisk/sounds/es/), y si no lo encuentra, consultaría en el directorio general (var/lib/asterisk/sounds/).

Durante la reproducción, la aplicación tiene el control del canal, esto quiere decir, que no se permiten lanzar otras Aplicaciones simultáneamente.

Esta aplicación ademas de recibir el archivo a reproducir, también puede recibir opciones. Las más comunes:

  • skip: solo se reproducirá la pista, única y exclusivamente, si antes se ha ejecutado la aplicación Answer, sino, saltaría sin reproducir nada.
  • noanswer: en este caso, si el tipo de canal soporta "Early Audio", lanza la pista, sin descolgar la llamada.

Sin opciones por defecto, descuelga la llamada, reproduce el mensaje

Aplicación Hangup

Simplemente, cuelga la llamada. No es necesario pasarle ningún parámetro especifico.

Al contrario de la aplicación Answer, esta aplicación si resulta interesante posicionarla al final de un proceso de una extensión, dado que si por ejemplo, el destinatario de la llamada, después de establecer contacto, cuelga la llamada, a nosotros no se nos colgaría, a no ser que lo hagamos expresamente en nuestro dispositivo. En cambio si esta aplicación esta disponible, al colgar la llamada, se lanzaría la aplicación y nos llevaría a la extension "h" según podemos ver en Introducción Dialplan, y a continuación si se nos colgaría la llamada automáticamente.

Aplicaciones para Depuración de Errores

Aplicación NoOp

Significa literalmente No Operation, es decir, Sin Operación, así que esta aplicación no hace nada. ¿Utilidad? Se puede insertar cualquier mensaje a voluntad, inclusive variables y se visualizarían directamente durante el registro de detalle en nuestra interfaz CLI. Es muy práctica para saber por ejemplo el estado de una variable en un momento determinado si estamos teniendo algún tipo de problema que no somos capaces de resolver, por tanto es una gran aplicación para Depuración en tiempo real.

Considerar también que es una muy buena práctica poner esta aplicación, en la prioridad numero 1. Ya que al no hacer nada especial, directamente podemos empezar a poner aplicaciones a voluntad en las siguientes prioridades utilizando el sistema de conteo automático (n, n+1) y podemos luego alterar el orden o incluir nuevas aplicaciones a voluntad en el futuro sin que afecte al orden de prioridades.

Ejemplo. Si tenemos la siguiente secuencia:

exten => 111,1,Answer()
same => n,Dial(...)
same => n,Hangup()

Si queremos introducir una aplicación al principio, tendríamos que modificar bastante código:

exten => 111,1,Wait(3)
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

En cambio si hubieramos tenido una operación NoOp() al principio, hubiera sido muy fácil insertarlo

exten => 111,1,NoOp()
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

Solamente agregando una linea a la secuencia. Puede resultar insignificante, pero es un sistema para mantener un código con mayor flexibilidad y calidad.

exten => 111,1,NoOp()
same => n,Wait(3)
same => n,Answer()
same => n,Dial(...)
same => n,Hangup()

Aplicación Verbose

Es exactamente igual que la aplicación NoOp con la diferencia que NoOp siempre imprime en el nivel de detalle (verbose) número 3 o superior, y esta aplicación puede especificar el nivel concreto.

Recordar que los niveles de Detalle (verbose) se pueden especificar tanto al cargar la interfaz CLI con el parámetro -v (-vvv 3 niveles por ejemplo), tanto por defecto en el archivo asterisk.conf

Aplicación DumpChan

Muestra información sobre el canal en curso. Puede recibir un parámetro DumpChan(<nivel>) siendo al igual que la aplicación Verbose, el nivel desde el cual podríamos ver esta información.

Aplicaciones para el Control de Flujo

Estas son las aplicaciones clásicas para obtener los comportamientos esenciales de todo lenguaje de programación. Principalmente hablamos de los eventos condicionales y los bucles. Para ello se aplica un sistema muy parecido al de Ensamblador, con bucles basados en GOTO y condicionales basados en GOTOIF.

Aplicación GoTo

Su funcionamiento estándar es el de enviar un canal en un momento determinado (prioridad) de la extensión en la que se encuentra a otro lugar diferente dentro del plan de marcación.

La sintaxis para esta "redirección" es la siguiente: Goto(<contexto>,<extensión>,<prioridad>/<etiqueta>)

  • Si solo se definen dos valores, estos hacen referencia a <extensión>,<prioridad>/<etiqueta>
  • Si solo se define un valor, entonces hace referencia a una <prioridad> o <etiqueta> de esa extensión

Supongamos que tenemos dos contextos [dia] y [noche], ambos con la extensión 111 por igual. Si queremos ir supongamos a la etiqueta "publico" de la extensión 111 despues cualquier parte de la etensión 111 del contexto día podriamos hacerlo de la siguiente forma:

Archivo: /etc/asterisk/extensions.conf
[dia]
exten => 111,1,...
same => n,...
same => n,Goto(noche,111,publico) --->

[noche]=> 111,1,...
same => n,...
same => n(publico),... <---


Aplicación GoToIf

Muy parecida a la aplicación esta constituye el formato condicional para que se produzca la redirección. Consideremos que GoTo se ejecuta siempre, pero en este caso, si utilizamos una expresión regular como podemos ver en Introducción Dialplan, que devuelva un valor Booleano (0 o 1), entonces redirigiremos el canal hacía un punto del dialplan, u otro (o simplemente dejaremos que la llamada continue su curso).

En este caso la sintaxis es la siguiente: Gotoif(<expresion_regular_condicional>?<redirección_si_verdadero:<redireccion_si_falso>).

  • Si no especificamos la redirección en el caso que no se cumpla la condición (si falso), entonces la extensión continua en la siguiente prioridad por su cauce.
  • Las opciones <redireccion_si_verdadero/falso> siguen la misma estructura de redirección que la utilizada en el apartado GoTo.

Con esto, y como ejemplo vamos a diseñar un pequeño bucle muy sencillo de tipo FOR (bucle con contador, que va pasando secuencialmente por todos los valores del mismo):

Archivo: /etc/asterisk/extensions.conf
[bucle]
exten => 111,1,Set(i=1)
same => n(for),GoToIf($[${i}>10?fin_for)
same => n,NoOp(El valor de i es: ${i})
same => n,Set(i=$[${i}+1])
same => n,GoTo(for)
same => n(fin_for),...


Con esta estructura tenemos potencial para hacer todo tipo de algoritmos, considerando que el "valor" de entrada que manipulamos es la llamada. Esto es muy práctico sobre todo cuando realizamos las funciones que por doquier suelen ser más complejas en los sistemas de marcación, los IVR (Interactive Voice Response), sistemas de respuesta de voz interactiva, en las que el llamante, va interactuando con la máquina para obtener determinadas funcionalidades (por ejemplo saber el saldo de su cuenta de crédito, realizar autentificación en sistemas seguros, comprar un producto sin ser atendido, etc). Esto se ve más a fondo en el apartado Dialplan Avanzado.

Aplicación GoToIfTime

Haciendo una combinación aún más allá, existe una variante de GoToIf, y es especificando un momento concreto como expresión de la condición. Por lo demás todo es igual.

La sintaxis sería la siguiente: Gotoiftime(<condicion_temporal>?<redireccion_si_verdadero>:<redireccion_si_falso>)

Evidentemente vamos a enfocar en la condicion temporal, si alguna vez hemos utilizado el sistema CRONTAB de *NIX es muy parecida la notación:

  • Para considerar validas todas las posibilidades de cualquier parámetro mostrado a continuación, se especificaría con un Asterisco (*)
  • Para cada valor incluso se pueden considerar múltiples posibilidades para que se cumpla la condición utilizando una barra vertical (|), sería algo así como un condicional OR.
  • Se pueden además especificar intervalos entre dos posibles parámetros con un guión (-), por ejemplo en caso de un día del mes a otro, sería 10-20.
  • El primer parámetro sería el tiempo horario, en horas y minutos. Ejemplo: 11:00.
  • El segundo parámetro sería el dia de la semana, primeras tres letras del día de la semana en inglés.Error en la cita: Etiqueta <ref> no válida;

nombres no válidos, p. ej. demasiados

Referencias


Véase también

Enlaces Externos