Ver el código de «MDintz»

==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, ...)

'''Después de hacer un cambio en la configuración es necesario reiniciar el módulo mdintz del asterisk para que se cargue la nueva configuración.'''

==Formato invocación==

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

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

Ejemplo:

  '''MDintz,nimitz,bd,segmInsertVDNin,${ARG1},${ARG2},${ARG3},${ARG4},${ARG5},${ARG6},${ARG7},15,30,20,10'''

: - entorno=nimit
: - servicio=bd
: - comando=segmInsertVDNin


Formato de comando en CLI de asterisk:


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


Ejemplo:

  '''vm-corp*CLI> mdintz qry * gh ping'''
  mdintz Variables:
    MDintzIdentif='gh_000'
    MDintzRes='pong'
  vm-corp*CLI>


El servicio ping no requiere comando.

==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}:

===ok===
Resultado correcto.

===intz_cfg_error===
Error en el archivo de configuración.

===intz_cnx_error===
Error en la conexión al entorno.

===intz_rx_error===
Error en la respuesta recibida del entorno.

===intz_fmt_error===
Error de formato.

===intz_hangup===
El canal ha sido colgado.

===intz_error_descon===
Error desconocido.

==Versiones==

===(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. 

==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:

===host0===
Direcciín IP donde esta el entorno

===port0===
Puerto

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

===port1===

===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)

===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

===toConx===
Tiempo de espera para conectarse al entorno en segundos

Valor recomendado 5

Valor por defecto 2

===toRx===
Tiempo de espera de respuesta en segundos

Valor recomendado 10

valor por defecto 2