WebDial V1.1 DOCUMENTACION DEL PROGRAMADOR

WebDial V1.1
DOCUMENTACION DEL PROGRAMADOR
DATAVOICE S.A
Para preguntas relativas a esta documentación :
Dpto. Ingeniería de DATAVOICE S.A.
Tlfno :
+34 91 361 40 16
Fax
:
+34 91 725 43 97
Está prohibida la copia, divulgación, reproducción total o parcial
de este documento tanto en su versión impresa como en soporte
informático sin el permiso expreso de DATAVOICE S.A
Introducción
WebDial es un control ActiveX de servidor Web que permite que una página ASP
realize llamadas telefónicas predictivas a grupo utilizando CSTA.
Distribución del Software
La versión actual de WebDial utiliza DVSAPI2 versión 2.0.22 y necesita tener
comunicación con un servidor CTI compatible con la versión anterior de DVSAPI2 para
funcionar correctamente.
Se deberán copiar DVSAPI2.DLL y WEBDIAL.OCX en el directorio de sistema de
Windows del Servidor Web.
Con los archivos copiados en el directorio del sistema, deberemos registrar el OCX con
el programa REGSVR32. La línea de comandos a introducir sería la siguiente:
REGSVR32 WEBDIAL.OCX
Una vez hecho esto deberemos configurar la dirección y el puerto donde se está
ejecutando el servidor CSTA . Esto se hace añadiendo las entradas
HKEY_LOCAL_MACHINE\Software\DataVoice\WebDial\Server Address, para la dirección IP
del servidor CTI y HKEY_LOCAL_MACHINE\Software\DataVoice\Server Port, para el puerto IP
del servidor CTI.
CSTAbridge V1.1
Documentación del programador
1
WebDial
Propiedades del objeto WebDial
•
Initialized
•
InitializeError
•
LastError
•
LastErrorFamily
WebDial V1.1
Documentación del programador
2
Initialized
Nos informa si el control se ha conseguido inicializar correctamente. Esta propiedad
es de sólo lectura
Tipo
Boolean
Sintáxis
<objeto>.Initialized
Donde <objeto> es una referencia a un WebDial. Si vale True es que el objeto ha
sido inicializado correctamente, si vale False es que ha ocurrido algún error en el proceso de
inicialización. El código del error lo conseguiremos a través de la propiedad InitializeError.
Ejemplo
If WebDial1.Initialized = False Then
Response.Write “Error al inicializar”
End If
WebDial V1.1
Documentación del programador
3
InitializeError
Esta propiedad informa del código del error que se ha producido al inicilizar el
control. Para interpretar el código del error deberá referirse a la lista de errores del API de
Windows.
Tipo
Long
Sintáxis
<objeto>.InitializeError
Donde <objeto> es una referencia a un WebDial. Si la propiedad vale 0 quiere decir
que el control se ha inicializado correctamente, en caso contrario la propiedad tomará un valor
de los códigos de error del API de Windows.
Ejemplo
If WebDial1.InitializeError <> 0 Then
Response.Write “Error al inicializar”
End If
WebDial V1.1
Documentación del programador
4
LastError
Devuelve el último código de error provocado por la marcación de una llamada.
Referirse a la documentación de DVSAPI2 para los posibles códigos de error. Esta propiedad
es de sólo lectura.
Tipo
Long
Sintáxis
<objeto>.LastError
Donde <objeto> es una referencia a un WebDial. El código de error será 0 si no se
ha producido ningún error, caso contrario devolverá un código de error de DVSAPI.
Ejemplo
If WebDial1.LastError <> 0 then
Response.Write “Error: “ & WebDial1.LastError
End If
WebDial V1.1
Documentación del programador
5
LastErrorFamily
Devuelve la familia del último código de error provocado por la marcación de una
llamada. Referirse a la documentación de DVSAPI2 para las posibles familias de códigos de
error. Esta propiedad es de sólo lectura
Tipo
Long
Sintáxis
<objeto>.LastErrorFamily
Donde <objeto> es una referencia a un WebDial. La familia del error será 0 si no se
ha producido ningún error, caso contrario devolverá una familia de error de DVSAPI.
Ejemplo
If WebDial1.LastError <> 0 then
Response.Write “Error: “ & WebDial1.LastError & “Tipo: “ &
WebDial1.LastErrorFamily
End If
WebDial V1.1
Documentación del programador
6
Métodos del objeto WebDial
•
MakeCall
WebDial V1.1
Documentación del programador
7
MakeCall
Realiza una llamada.
Formato
<objeto>.MakeCall
AgentsGroup,
TrunksGroup,
CmpHandle,
PhoneNumber, CorrelatorData
Donde <objeto> es una referencia a un WebDial.
AgentsGroup es el código del grupo al que va a ser distribuida la llamada.
TrunksGroup es el grupo de líneas por el que se va a realizar la llamada.
CmpHandle es el identificador único de la campaña.
PhoneNumber es el nº de teléfono.
CorrelatorData es la información que se quiere asociar con la llamada.
Valor de retorno
Boolean
•
Si el método tiene éxito devolverá True, caso contrario devolverá False y se
deberá consultar las propiedades LastError y LastErrorFamily para analizar
porqué no se ha podido realizar la llamada.
Ejemplo
If
WebDial1.MakeCall(180,
6,
1,
“917243399”,
“Cmp1”)
=
False Then
Response.Write “Error en marcación”
Else
Response.Write “Llamada realizada”
End If
WebDial V1.1
Documentación del programador
8
WebDial V1.1
Documentación del programador
9