MDintz

1 Descripción

Esta aplicación permite invocar desde es el dialplan de asterisk distintos servicios desarrollados por MDtel. Cada uno de estos servicios es denominado entorno.

Los diferentes entornos que puede invocar la aplicación MDintz se definen en el archivo de configuración como secciones.

Cada uno de los entornos proporciona diferentes servicios y cada uno de los servicios tiene comandos. Por ejemplo, el entorno intz-nimitz tiene varios servicios (ping, BD, regExpr) y el como ejemplo, el servicio BD tienen diferentes comandos (sqlDato, enrutar, ...)

2 Formato invocación

Formato de comando en dialplan de asterisk (el separador ',' puede ser sustituido por '|'):

 MDintz(<entorno(nimitz)>,<servicio>,<comando>,<par1>,<par2>,...,<parN>)

Formato de comando en CLI de asterisk:

 mdintz qry <nHostFijo(*,0..3)> <entorno(nimitz)> <servicio> <comando> <par1> <par2>...<parN>

3 Retornos generales

Cuando un retorno comienza por el caracter "+", indica a app_mdintz que debe reintentar en otro intz-nimitz.

Retornos genéricos en ${MDintzRes}:

3.1 ok

Resultado correcto.

3.2 intz_cfg_error

Error en el archivo de configuración.

3.3 intz_cnx_error

Error en la conexión al entorno.

3.4 intz_rx_error

Error en la respuesta recibida del entorno.

3.5 intz_fmt_error

Error de formato.

3.6 intz_hangup

El canal ha sido colgado.

3.7 intz_error_descon

Error desconocido.

4 Versiones

4.1 (versión 20170130)

La mejora introducida en esta versión es su capacidad de integrarse con un servidor intz desarrollado en tomcat en base al uso de protocolo http, siendo esto transparente para el dialplan.

Lo que se ha hecho es incorporar dos nuevos campo en /etc/asterisk/MDintz.conf:

• protocolo. Valores:

 . nimitz (por defecto para compatibilidad hacia atrás)
 . http1 (nuevo para conectarse con tomcat usando http/get)
 . http2 (nuevo y preferido para conectarse con tomcat usando http/post)

• url. Cadena sin host y sin "entorno" que permite construir la url a la que se conectará en tomcat. Sólo se usa si el protocolo es http1 o http2.

5 Configuración

El archivo de configuración es /etc/asterisk/MDintz.conf

El archivo de configuración cuenta con diferentes secciones, siendo cada sección un entorno diferente al que podrá invocar el MDintz desde el dialplan.

Dentro de cada sección los parámetros de configuración son los siguientes:

5.1 host0

Direcciín IP donde esta el entorno

5.2 port0

Puerto

5.3 host1

Host que se utiliza cuando el host0 no ha contestado o responde con un retorno (MDintzRes) que empieza con el carácter +

5.5 protocolo

Protocolo a utilizar con el entorno:

Valores:
 . nimitz (por defecto para compatibilidad hacia atrás)
 . http1 (nuevo para conectarse con tomcat usando http/get)
 . http2 (nuevo y preferido para conectarse con tomcat usando http/post)

5.6 url

Cadena sin host y sin "entorno" que permite construir la url a la que se conectará en tomcat. Sólo se usa si el protocolo es http1 o http2.

Valor por defecto "" que asume que la url de conexión tiene formato /entorno

5.7 toConx

Tiempo de espera para conectarse al entorno en segundos

Valor recomendado 5

Valor por defecto 2

5.8 toRx

Tiempo de espera de respuesta en segundos

Valor recomendado 10

valor por defecto 2