Introducción. Como elemento de integración ofrece el enlace con aplicaciones y bases de datos de gestión ofreciendo ventanas de contactos:

Transcripción

1 char a-link 2.0 Introducción a-link es un conjunto de aplicaciones y librerías diseñado para enlazar sistemas telefónicos (PBX) con bases de datos y aplicaciones de gestión. Como interface visual de las comunicaciones permite un fácil acceso para la realización de llamadas, envío de y/o SMS, mostrando información sobre las comunicaciones activas, identificación de contactos y listines telefónicos extraídos de las aplicaciones y/o datos enlazados. Como elemento de integración ofrece el enlace con aplicaciones y bases de datos de gestión ofreciendo ventanas de contactos: - Enlace con Bases de Datos conteniendo contactos telefónicos, y/o Internet, creando ventana propia para visualización de datos. - Enlace con aplicaciones estándar (ej: Microsoft Outlook, Microsoft Access, GoldMine) visualizando ventana de contactos de la aplicación. - Enlace con cualquier tipo de aplicación mediante API e interfaces de integración de muy alto nivel. Adicionalmente, permite la grabación de llamadas mediante dispositivo hardware externo. a-link soporta dos tipos de enlace y arquitecturas según los requerimientos que el sistema telefónico determine: - Como parte del producto c-link, enlazando con este servidor para la realización de acciones y recepción de eventos telefónicos y GSM. - Enlace directo a TAPI local para sistemas telefónicos que solamente proporcionen conexiones individuales. Su uso esta destinado a proporcionar conectividad con: - Bases de datos. - Aplicaciones estándar. - Aplicaciones con limitadas necesidades o posibilidades de integración.

2 Integración: Conceptualmente las posibilidades de integración contemplan dos formas básicas: Listines: Denominados así los interfaces visuales en forma de árbol o listas maestro detalle de contactos (empresas nombres) y direcciones (teléfonos fijos, móviles, , WEB). a-link permite la integración con ilimitado numero de listines siendo presentados de forma independiente, permitiendo búsquedas, realización de llamadas, envío de SMS, y acceso a direcciones WEB. Los listines son obtenidos mediante la integración con bases de datos (SQL, ODBC) y aplicaciones estándar (Outlook, goldmine). La identificación de contactos de las comunicaciones, realizadas y/o recibidas, se realiza sobre los datos contenidos en los listines. Aplicaciones: Fundamentalmente para mostrar datos a partir de un numero de teléfono (comunicaciones entrantes y/o salientes). El interface mostrado, según el tipo de integración, será: - Ventana estándar de la aplicación, en los casos de enlace con aplicaciones estándar (Outlook, Access, goldmine). - Ventana o interface diseñado específicamente por terceros, en el caso de integraciones con aplicaciones no estándar a través del API suministrado. - Ventana propia mostrando lista de datos seleccionados en consulta SQL, en el caso de integraciones directas con bases de datos. Comunicaciones telefónicas: Adicionalmente a las funciones de integración, a-link ofrece la posibilidad de supervisar y controlar las comunicaciones: - Mediante el interface principal, de forma directa o a través de los listines, permite la realización de llamadas, envío de SMS, envío de y enlace con direcciones de Internet. - Mediante la ventana de llamada permite visualizar las comunicaciones activas, identificando, por ejemplo el origen de las llamadas recibidas. - Mediante la ventana de llamada permite la realización de acciones adicionales: responder, retener, activar, finalizar llamadas, visualizar notas de contactos y grabar comunicaciones. char a-link / 51

3 Requerimientos Enlace con c-link server de acuerdo a las especificaciones y requerimientos de este servidor: Por parte del sistema telefónico, disponer y proporcionar integración basada en el estándar TAPI de Microsoft, de amplia implantación y disponible en la inmensa mayoría de sistemas. Siendo TAPI el enlace principal, contempla la posibilidad de enlace bajo otros protocolos. Estos distintos enlaces no son suministrados en el producto estándar siendo considerados como módulos adicionales. Por este enlace principal, TAPI, c-link server esta diseñado para trabajar en plataformas Microsoft de 32 bit. Dentro de estas plataformas los requerimientos están realmente marcados por el sistema de comunicaciones, siendo sus especificaciones (TSP) las que requerirán plataformas concretas: W2000, W2003 o simplemente XP. En cualquier caso y aun utilizando el estándar TAPI, c-link permite la omisión de ciertos requerimientos tradicionales del protocolo: Servidor de telefonía sobre servidor de dominios, clientes con activación de servicios remotos de telefonía, etc. Aunque c-link soporta esta arquitectura estándar, fundamentalmente permite el enlace entre servidor y clientes mediante medios de trasporte propios, con el único requerimiento de comunicación TCP/IP. Para funciones de envío o recepción de mensajes SMS es necesario dispositivo ITS Transceiver. Para la grabación de llamadas es necesario disponer de dispositivo hardware especifico. char a-link / 51

4 Conectividad a-link ofrece, de forma estándar distintos interfaces de conectividad: Bases de datos: - SQL - ODBC. Aplicaciones estándar: - Microsoft Outlook - Microsoft Access - goldmine Aplicaciones externas: - A través de librería WIN32. - A través de lanzamiento de ejecutables. - A través datos en de archivos de texto. char a-link / 51

5 Elementos y arquitectura Sistema de telefonía [Central telefónica] Servidor WIN 32 TSP (Telephony Service Provider) [Suministrado por el sistema de comunicaciones] Servicio CTI LINK Servidor TCP WEB service ctilink.dll Microsoft TAPI Remote Service Provider A - LINK char a-link / 51

6 Aplicaciones, módulos y archivos \charwin \cti\applink Instalación Cliente a-link applink.exe applink.pdf alinkcmd.exe dblink.exe dblink.ini dbpb.exe gmlink.exe gmpb.exe tmsol97l.exe tmsol00l.exe msolpb.exe taspdbg.exe taspmcall.exe alinkcmd.exe tasptxt.exe Aplicación a-link Documentación a-link Integración API Integración BD Configuración enlaces SQL Enlace listines BD Integración goldmine Enlace listin goldmine Integración outlook 97 (OLE) Integración outlook 2000 (COM) Enlace listin outlook Integración API Integración API Integración API Integración API \system\ autorun.exe Utilidad de reinicio \windows dbexpdrv.ini Configuración enlaces SQL \System32\ ctilink.dll tapilink.dll Enlace c-link Enlace TAPI chardbg.dll Integración API dbexpdb2.dll Enlace DB2 dbexpint.dll Enlace Interbase dbexpinf.dll Enlace Informix dbexpmys.dll Enlace mysql 3.22.x dbexpmysql.dll Enlace mysql 3.23.x dbexpmda.dll Enlace mysql 4.x dbexpora.dll Enlace Oracle dbexpoda.dll Enlace Oracle 7,8,9, 10, NET dbexpmss.dll Enlace MS SQL dbexpsda.dll Enlace MS SQL Server En el proceso de instalación se solicitara instalación de Borland Databse Engine. Ente gestor de datos solo será necesario para enlazar con goldmine en versiones DBase. char a-link / 51

7 \charwin \cti\applink\sdk\samples Instalación SDK Ejemplos de los tipos de enlace en diferentes lenguajes de programación, incluyendo ejecutables compilados para realizar test de las conexiones. Solo será necesaria a efectos de desarrollo y test de enlace con aplicaciones externas. \charwin \brc\ Instalación Administrador de grabaciones admbrc.exe Aplicación para administración de grabaciones brc.pdf Documentación sistema de grabación. char a-link / 51

8 Descripción La aplicación se ejecuta normalmente en modo oculto, siendo accesible a través de icono en barra de tareas y el menú de acciones asociado (clic derecho sobre icono) Ventana principal: La ventana principal de la aplicación esta diseñada básicamente para la realización de acciones de comunicación (llamadas, sms, , acceso a direcciones Internet), de forma manual, mediante la introducción de destino y realización de llamada, o a través de los contactos y acciones de los listines. char a-link / 51

9 Barra de acciones: Permite introducir de forma manual destino de llamada, mostrar lista de comunicaciones y efectuar llamadas o envío de SMS. La lista de comunicaciones almacena las llamadas recibidas y realizadas, mostrando ámbito, flujo, fecha, destino, contacto, resultado y duración, permitiendo la re llamada. El icono de estado muestra el estado de la conexión con el servidor c-link e inmediatamente a la realización de una acción (llamar, colgar, etc) alerta de posibles errores. La barra inferior, en este caso, mostrará descripción de la incidencia. Ventana de listines: Llamar: Realiza llamada telefónica al destino seleccionado. Enviar SMS: Envía SMS a destino seleccionado. Este destino habitualmente será numero de teléfono móvil. Sin embargo, dependiendo del operador telefónico, se podrán enviar SMS a destinos fijos. En este caso habitualmente el operador realizara llamada al teléfono fijo de destino y mediante conversión de texto a voz difundirá el mensaje. Enviar Envío de a la dirección seleccionada a través del servidor de correo predefinido en el sistema. Ir a sitio WEB: Enlaza mediante el explorador del sistema con la dirección web seleccionada. Notas del contacto: Muestra campos de notas del contacto seleccionado de acuerdo a posibilidades del tipo de listin al que pertenezca. Refrescar: Fuerza al refresco de los datos del listin activo. Este proceso se ejecuta en segundo plano y según el tipo de listin y su volumen puede tardar minutos en completarse. Mientras se realiza el refresco se muestra la indicación importando manteniendo la vista de los contactos actuales. char a-link / 51

10 Ventana de llamadas: Mostrada, según configuración, para cada comunicación realizada o recibida. Muestra información sobre el tipo de llamada, duración y datos sobre el origen o destino, identificando el contacto. Permite realizar acciones sobre la llamada: - Responder. - Pausa activación. - Finalizar llamada. - Mostrar notas del contacto. - Grabar finalizar grabación. char a-link / 51

11 Menú principal Menú principal \ aplicación \ configurar \ general: Lanzar aplicación al iniciar el sistema: Crea elimina acceso directo a la aplicación en el menú de inicio del sistema. Enlace CTI: Enlace c-link (servidor:puerto): Permite definir la dirección del servidor c-link y puerto de comunicación (defecto 10001). La ausencia de estos parámetros determinara conexión TAPI local. En este caso las funciones de envío SMS no estarán disponibles. Usuario contraseña: (Solo en caso de enlace con servidor c-link). Nombre de usuario y contraseña registrados en servidor c-link. Por defecto la aplicación tomara como usuario el que inicio la sesión en el sistema y como password la dirección ip local del equipo cliente. El usuario introducido será dado de alta automáticamente en el servidor c-link en el primer inicio de sesión. Extensión: Dirección de la extensión asociada al usuario a-link. Prefijo de acceso alinea externa: Ruta de acceso a línea externa que se incluirá como prefijo al numero externo. Permitir envío SMS a teléfonos fijos: Permite habilitar la posibilidad de envío de SMS a números identificados como externos (no móviles, no extensiones). Ventana de llamada: Permite activar desactivar el tipo y ámbito de las comunicaciones en las que se mostrara ventana de llamada (entrantes salientes, internas externas, en cualquier combinación). Posición: Permite definir la posición por defecto de la ventana. (Centrada, esquinas superiores - inferiores, derecha izquierda). Grabación de llamada: Permite activar desactivar el tipo y ámbito de las comunicaciones sobre las que se realizará grabación automática de llamadas (entrantes salientes, internas externas, en cualquier combinación). La grabación automática de algún tipo de llamadas no impide las grabación manual del resto. Destino: Capeta de destino de las grabaciones. Por defecto la carpeta por defecto de BRC explorer (Administrador de grabaciones). Las llamadas que cumplan los filtros asignados serán grabadas en formato WAV en la carpeta especificada, iniciándose la grabación en el momento de la conexión de la llamada. La denominación del archivo será asignada automáticamente de acuerdo al formato: BRC_<año:4><mes:2><dia:2>_<hora:2><minutos:2><segundos:2><milisegundos:3>_<linea>.WAV Ejemplo: Llamada de fecha 1/4/2007 a las 12:15:00 de la línea (extensión) 202: BRC_ _ _202.wav char a-link / 51

12 Menú principal \ aplicación \ configurar \ listines: Los listines pueden ser visualizados en secciones (ventanas) individuales o simplemente utilizados para asignación de contacto de llamadas sin interface visual. El interface de configuración permite: Activar el uso de listines: Los listines configurados pueden ser activados desactivados. La activación implica su uso en la asignación de contactos a las llamadas. Visualizar ocultar listines: La marca en cada listin activo implica la visualización del mismo en la ventana principal. La ocultación no deshabilita su uso en la asignación de contactos. En este caso esta asignación se realiza mediante enlace y búsqueda en tiempo real para cada llamada, por lo que el proceso puede resultar mas lento que en el caso de visualización. Por el contrario en este segundo modo de trabajo las modificaciones realizadas en las aplicaciones o bases de datos no serán reflejadas hasta la importación de datos en la forma programada. Frecuencia de la importación: - Importar datos al inicio: Lanza procesos de importación al iniciar la aplicación. - Importación programada: Importara datos en la frecuencia (minutos) programada. Los parámetros de importación son independientes para cada listin. Sus valores deben ser los que razonablemente se consideren necesarios de acuerdo a la frecuencia de modificaciones y el volumen de datos que contienen. Prioridad: (Botones subir bajar). El orden de la ventana de listines activos supondrá la prioridad de búsqueda para la asignación de contactos. El caso de listines visuales también marcara el orden de las pestañas de la ventana de listines. Formato de los datos a mostrar: Indica el formato de los contactos mostrados en la ventana de listines y llamadas: Empresa persona. Mediante las plantillas %FOLDER (Empresa, organización) %ITEM (persona o descripción). Los datos de la ultima importación realizada son almacenados en <carpeta a-link>\pbsdata\<nombre del listin>.dat. char a-link / 51

13 Configurar listines: Bases de datos: a-link permite el enlace con bases de datos directo a través de SQL y/o ODBC. De forma común, independientemente del tipo de enlace, la integración se basa en consulta SQL y asignación de campos a distintos tipos de contactos (teléfono, móvil, , web) y descriptores apropiados. Esta consulta y asignación puede ser distinta para los diferentes modos de trabajo con el listin: - Listin: Listines visibles. - Búsqueda: Listines ocultos. - Notas: Búsqueda de contacto para presentación de notas. Se permite la conexión con ilimitado numero de bases de datos. El proceso de enlace comienza creando una nueva conexión (opción nuevo ). Cada conexión es interpretada como listin independiente. Los parámetros de cada conexión son almacenados en archivo INI situado en el path de la aplicación con la denominación <nombre de la conexión>.ini Conexión: Parámetros de la conexión según el tipo de enlace: - SQL - ODBC Conexión \ SQL: Enlace: Tipo de conexión: SQL. Gestor de datos: Selección del gestor de datos entre los soportados para conexión directa: - DB2 - Interbase - mysql 3.22.x - mysql 3.23.x - mysql 4.x - mysql 4.x direct (Conexión directa, no requiere librería cliente libmysql.dll). - Informix - MSSQL - SQL Server - Oracle (general) - Oracle NET - Oracle (10g,9i,8i,8,7). Parámetros: Parámetros de la conexión según el gestor de datos seleccionado. Obligadamente será necesario indicar los valores, particulares de la instalación, correspondientes a: hostname: Servidor del gestor de datos. database: Base de datos a enlazar. user_name: Usuario. password: Clave del usuario. char a-link / 51

14 En caso de listines visibles el enlace con la base de datos no mantiene una conexión permanente, solo es utilizado en los procesos de importación de acuerdo a la frecuencia definida y en el momento de solicitar notas de contactos. Por el contrario, en el caso de listines ocultos la conexión es permanente. Conexión \ ODBC: Enlace: Tipo de conexión: ODBC. Parámetros: Cadena utilizada para la realización de la conexión. Esta cadena puede ser introducida: Manualmente (usuarios avanzados): Indicando los parámetros necesarios de acuerdo a las especificaciones y requerimientos del proveedor ODBC. Ej: Enlace Microsoft access: Provider=MSDASQL.1;Persist Security Info=False;Extended Properties="DSN=MS Access Database;DBQ=C:\BD\Datos.mdb;DefaultDir=C:\BD;DriverId=25;FIL=MS Access;MaxBufferSize=2048;PageTimeout=5;UID=admin;" Mediante interface del sistema (Botón Parámetros): Enlaza con el administrador ODBC del sistema. Ejemplo de enlace con Microsoft Access (XP profesional): - Ventana: Proveedor del vinculo de datos \ conexión - Opción Usar la cadena de conexión - Generar - Origen de datos del equipo - Selección del origen de datos instalado, doble clic para acceso a configuración. - Usuario, contraseña - Base de datos (seleccionar) - Aceptar. Base de datos: Carpeta y base de datos a enlazar, opcional). y no necesaria en caso de que este dato este incluido en la cadena de enlace. Espera de conexión: Espera para la conexión efectiva, valor por defecto 15 segundos. Listin: Configuración de consulta y asignación de parámetros para enlace con listines visibles. El proceso se basa en: - Definición de consulta SQL de acuerdo a la sintaxis del gestor de bases de datos utilizado. - Realización de consulta (botón Consulta). Esta acción permite verificar el enlace con la base de datos y proporciona los campos disponibles para asignación de propiedades. Los listines de base de datos son presentados en modo maestro detalle: Maestro: Contacto (organización) Detalle: Direccion1, direccion2.. direccion n char a-link / 51

15 Campos: Contacto: Asignación del campo que se utilizara para identificar el contacto del listin. Organización: Asignación del campo que se utilizará para identificar la organización del contacto. Visualmente se mostrara en formato contacto (organización). Direcciones: Permite seleccionar los campos que contienen direcciones y asignarles sus propiedades. Campo: Acceso mediante control tipo lista mostrado al sobrevolar la celda. Selección del campo o uno de los campos que contienen direcciones a tratar. Contacto: Acceso mediante control tipo lista mostrado al entrar en la celda. Selección del campo que se mostrara como contacto. Esta asignación es opcional y solo será necesaria en el caso de consultas que retornen varios campos de direcciones asociados a distintos contactos: Ejemplo: Base de datos con campos: empresa telefono_empresa fax_empresa genrente telefono_gerente comercial telefono comercial Contacto: empresa Dirección 1: Campo: telefono_empresa. Contacto: (ninguno, se asume contacto principal) Dirección 2: Campo: telefono_gerente. Contacto: gerente. Dirección 3: Campo: telefono_comercial: Contacto: comercial Descripción: Descripción que se desea se muestre en el caso de que no exista asociación de contacto con campo específico o este campo no retorne valor. Basado en el ejemplo anterior: Dirección 4: Campo: fax_empresa. Contacto: (ninguno). Descripción: Fax. Tipo: Acceso mediante control tipo lista mostrado al entrar en la celda. Selección del tipo de dirección: Teléfono, móvil, , red, web, a determinar. En este último caso el proceso de importación intentara determinar el tipo de dirección en base a: - Si la dirección se interpretara como - Si la dirección contiene www. se interpretara como dirección WEB - Si la dirección comienza por prefijo móvil 6 (defecto, España) se interpretara como móvil. Si la dirección de acuerdo a los criterios anteriores no es clasificada dentro de ninguno de los tipos posibles se interpretara como teléfono fijo. char a-link / 51

16 Búsqueda: Configuración de consulta y asignación de parámetros para enlace con listines ocultos. El proceso se basa en: - Definición de consulta SQL de acuerdo a la sintaxis del gestor de bases de datos utilizado. - Realización de consulta (botón Consulta). Esta acción permite verificar el enlace con la base de datos y proporciona los campos disponibles para asignación de propiedades. La definición de la consulta debe representar una selección basada en un mumero concreto: Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 La plantilla %NUMERO1 es fija y deben ser indicada como asignación del numero a buscar. Esta plantilla será reemplazada por el numero telefónico para el que se realizara la consulta. En caso de bases de datos con numeración canónica uniforme en todos los campos se posibilita la platilla %NUMERO2. Esta será remplazada por el numero sobre el que se realiza la consulta en formato canónico. En este caso la consulta SQL se debe realizar de acuerdo a la sintaxis apropiada. Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 OR NUMERO_TELEFONO=%NUMERO2. Contacto: Asignación del campo que se utilizara para identificar el contacto del listin. Organización: Asignación del campo que se utilizara para identificar la organización del contacto. Visualmente se mostrara en formato contacto (organización). Notas: Configuración de consulta y asignación de parámetros para enlace con bases de datos para recuperación de posible campo conteniendo notas del contacto. El proceso se basa en: - Definición de consulta SQL de acuerdo a la sintaxis del gestor de bases de datos utilizado. - Realización de consulta (botón Consulta). Esta acción permite verificar el enlace con la base de datos y proporciona los campos disponibles para asignación de propiedades. La definición de la consulta debe representar una selección basada en un mumero concreto: Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 La plantilla %NUMERO1 es fija y deben ser indicada como asignación del numero a buscar. Esta plantilla será remplazada por el numero telefónico para el que se realizara la consulta. En caso de bases de datos con numeración canónica uniforme en todos los campos se posibilita la platilla %NUMERO2. Esta será remplazada por el número sobre el que se realiza la consulta en formato canónico. En este caso la consulta SQL se debe realizar de acuerdo ala sintaxis apropiada. char a-link / 51

17 Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 OR NUMERO_TELEFONO=%NUMERO2. Notas: Asingancion del campo que se utilizara para retornar las notas del contacto. char a-link / 51

18 Configurar listines: Microsoft Outlook : La integración con Microsoft Outlook permite el acceso a las diferentes carpetas de contactos disponibles en la aplicación local. Cada carpeta de contactos será tratada como listin independiente, siendo mostrado en ventanas individuales. Estas carpetas son identificadas de forma automática. Por este motivo es posible que la apertura de la ventana de configuración de listines pueda demorarse segundos o incluso minutos según la cantidad de datos a verificar. La configuración permite seleccionar los distintos campos correspondientes a teléfonos y direcciones ( , web) disponibles en Outlook, a efectos de su importación y tratamiento. Asimismo es posible filtrar contactos sin direcciones disponibles, así como indicar la Organización del contacto. <contacto> (<organización>) char a-link / 51

19 Configurar listines: GoldMine : La integración con listines GoldMine permite el acceso a las diferentes carpetas de contactos disponibles. Esta integración accede directamente a las bases de datos de GoldMine, tanto en sus versiones DBF como SQL. Para versiones DBF es indispensable que el gestor de datos Borland Databse Engine se encuentre instalado localmente. Entorno: goldmine: Carpeta donde se encuentra el ejecutable local de la aplicación (gmw6.exe, para versión 6). versión: Versión de goldmine (5,6 ). GMbase: Ubicación de la tabla CAL, típicamente carpeta gmbase en versiones DBF. Bases de datos de conjunto de contactos: Permite definir distintos enlaces con bases de datos de contacto, distintos listines. (Opciones crear modificar eliminar). Descripción: Descripción suministrada por el usuario que identificara el listin. Tipo: (DBF SQL). El tipo definirá los parámetros necesarios para la configuración del enlace: Base de datos: (Común) Carpeta (DBF) o base de datos (SQL) donde se encuentran los datos de contactos (entre otras tabla CONTACT1), típicamente carpeta common en versiones DBF. Servidor: (Únicamente SQL). Servidor donde se encuentra la base de datos. Usuario: Usuario de GoldMine. Password: Password de GoldMine correspondiente al usuario. Datos y formatos: Definición de datos a importar y formatos de presentación. Teléfono (1-3): Seleccionar si se desea la importación de teléfono principal (1) y secundarios (2-3). Seleccionar si se desea la importación de direcciones . WEB: Seleccionar si se desea la importación de direcciones WEB. Datos de contactos adicionales: Seleccionar si se desea la importación de datos de contactos secundarios. Identificador de teléfono móvil (ext): Identificador en el campo EXT asociado a cada teléfono que indicara que se trata de teléfono móvil, por defecto Coche, Identificador de extensión (ext): Identificador en el campo EXT asociado a cada teléfono que indicara que se trata de extensión interna. char a-link / 51

20 Identificador de datos privados (ext): Identificador en el campo EXT asociado a cada teléfono que indicara que se trata de un teléfono privado que no se mostrara en el listin. Mostrar empresa en contacto: Mostrara el nombre de empresa como datos del contacto: <contacto> (<empresa>). No mostrar contactos sin teléfonos ni direcciones: No serán mostrados contactos que no tengan datos o no los contengan de acuerdo a los filtros seleccionados. char a-link / 51

21 Menú principal \ aplicación \ configurar \ integración: Los mecanismos de integración de a-link proporcionan: - La posibilidad de presentar ventanas (o realizar procesos específicos) en tiempo real, para cualquier tipo de llamadas, conteniendo datos del contacto de una comunicación con el fin de facilitar el tratamiento con el contacto. - Facilitar a aplicaciones externas las acciones relacionadas con comunicaciones (llamar, transferir, finalizar, enviar SMS, grabar llamadas) Estos mecanismos de integración están diseñados para: - La integración con bases de datos, sin intervención de aplicaciones ni procesos externos. - La integración con aplicaciones estándar (Microsoft Outlook, Microsoft Access, GoldMine ). - La integración con cualquier aplicación externa que por necesidades o limitaciones solo requieran o permiten una integración de muy alto nivel. Notificación de llamadas a aplicaciones externas: Permite seleccionar el tipo de llamadas (flujo y ámbito) para las cuales se realizaran las acciones de enlace configuradas. Permite seleccionar en el caso de llamadas recibidas realizar el enlace en base a: - Numero de origen: Es la función habitual. Realizará el enlace a partir del número de origen de la llamada. Función típica, por ejemplo, para identificar clientes en una organización comercial. - Número llamado: Realizara el enlace partir del numero al que se realiza una llamada. Especialmente útil, por ejemplo, para identificar destinatarios en centros de negocio. Origen restringido: Habilita la posibilidad de enlazar aun cuando el origen de la llamada sea restringido (oculto). Formato de notificación: Numeración canónica: Permite transformar, en caso necesario, el numero utilizado para el enlace en formato canónico. Necesario en caso de enlaces en los que en la base de datos o aplicación se utilice este estándar para la totalidad de los contactos. Insertar prefijo: Inserta el prefijo indicado al numero de teléfono utilizado en el enlace. Esto es necesario en caso de bases de datos o aplicaciones en los que los contactos contengan, por ejemplo, ruta de acceso a linea externa. char a-link / 51

22 Notificar a : Selección del tipo de datos o aplicación con la que se desea la integración y parámetros de este enlace: - Aplicaciones Externas (TASP API). - Microsoft Outlook - Microsoft Access - Ejecutable estandar. - GoldMine - Base de datos (ODBC SQL). En cualquiera de los casos se posibilita, una vez definido el enlace realizar test de la integración. Detalles sobre las características y configuración de cada tipo de integración son facilitados al final de este documento. char a-link / 51

23 Menú principal \ aplicación \ clave de usuario: Permite restringir el acceso a la configuración de la aplicación. Menú principal \ aplicación \ Gestión de grabaciones: Opción únicamente visible en caso de existir administrador de grabaciones (BRC explorer) instalado localmente. Este modulo es un componente de instalación opcional. Enlaza con BRC explorer para audición y gestión de grabaciones. char a-link / 51

24 Integración con aplicaciones y bases de datos Utilidades Adicionalmente a los mecanismos de integración facilitados por c-link (librerías win32, ocx, xml tcp/ip, http, soap) a-link proporciona mecanismos de integración con aplicaciones estándar, bases de datos y de muy alto nivel con aplicaciones externas. Además de los mecanismos definidos para los distintos tipos de integración contemplados, a-link proporciona una serie de utilidades que pueden ser utilizadas, como complemento o alternativa, con cualquiera de los tipos de enlace: - Ejecutable para realización de acciones. - Volcado de datos de comunicaciones a archivo de texto. Ejecutable para realización de acciones Facilita mecanismo para la realización de llamadas, grabación y acciones relacionadas. Las aplicaciones que utilicen este enlace simplemente deben lanzar un ejecutable estándar,indicando mediante parámetros de ejecución la acción (comando) a realizar. De esta forma, el lanzamiento de ejecutable como respuesta a una acción del usuario o a sus propios procesos, puede acceder al sistema telefónico. Típicamente es utilizada por aplicaciones estándar en las que no es posible realizar modificaciones en su desarrollo, pero contemplan conectividad mediante la ejecución de aplicaciones. Así, bastaría el lanzamiento de <carpeta a-link>alinkcmd.exe con distintos parámetros (comando / datos) según la acción a realizar: Acción Comando Datos Realizar llamada 1 Numero de destino Transferir llamada activa a destino 2 Número de destino Finalizar llamada activa 3 Envío de SMS (*) 4 Numero de destino Texto (opcional) Grabar llamada 5 Archivo de destino (*) En caso de acción de envío SMS el tercer parámetro (texto) es opcional: Si no se incluye parámetro indicando texto del mensaje se mostrará ventana para su introducción por parte del usuario. Ejemplos: Llamada a destino : cmd c:\charwin\applink\alinkcmd.exe Transferir llamada activa a destino : cmd c:\charwin\applink\alinkcmd.exe Finalizar llamada activa: cmd c:\charwin\applink\alinkcmd.exe 3 Envío SMS llamame a destino : cmd c:\charwin\applink\alinkcmd.exe llamame char a-link / 51

25 Grabar llamada en archivo c:\record\llamada.wav: cmd c:\charwin\applink\alinkcmd.exe 5 c:\record\llamada.wav Volcado de datos de llamada a archivo de texto Facilita mecanismo para la detección de llamadas e identificación de contactos a través de la lectura de archivo de texto. Típicamente es utilizado por aplicaciones que no permiten modificaciones de desarrollo pero proporcionan la posibilidad de lectura continuada de archivos de texto para proceso de su contenido. La utilidad es activada mediante uno de los medios de integración proporcionados por a-link: El enlace con aplicaciones estándar. De esta forma, la activación del volcado se realiza indicando, como configuración de este tipo de integración, el enlace con ejecutable estándar <carpeta a-link> tasptxt.exe. En el momento de la notificación y de acuerdo a este tipo de integración se lanza la utilidad, generando este proceso la creación o sobre escritura de archivo de texto conteniendo el número telefónico de la comunicación implicada (origen en caso de llamadas recibidas, destino en caso de llamadas realizadas). Este archivo de texto, por defecto, se sitúa en la carpeta donde se encuentra la aplicación a-link, con la denominación tasptxt.txt. La ubicación y nombre de este archivo de volcado puede ser modificado mediante creación de archivo ini en carpeta a-lin, denominado tasptxt.ini y conteniendo: [general] file= <carpeta y nombre de archivo de destino> char a-link / 51

26 Integración con aplicaciones y bases de datos Microsoft Outlook La integración con Outlook permite visualizar la ventana de contactos mostrando el correspondiente al numero de teléfono de la comunicación. Versión: Versión de Outlook, 97 (enlace OLE) 2000 (enlace COM) y versiones posteriores. En caso de dificultades en la realización de enlace 2000 habitualmente el enlace 97 resulta efectivo, aunque puede resultar mas lento. Buscar formato mediante numero - Tal y como es recibido: No se efectúa translación alguna en el numero telefónico, siendo utilizado de forma literal para su búsqueda entre los contactos disponibles. - Canónico: Se realiza traslación del numero telefónico proporcionado por el sistema telefónico a su formato canónico (+xxxxxx). - Ambos: Se realiza búsqueda de numero suministrado por el sistema telefónico y su traslación a numeración canónica en caso de no ser localizado. Esta opción demora la búsqueda pero será imprescindible en instalaciones en las que los números de teléfono puedan representarse en ambos formatos. En caso de no identificarse el contacto de una comunicación se presentara ventana, permitiendo: - Crear un nuevo contacto: Creara nuevo contacto en Microsoft Outlook. - Asociar a contacto existente: Asociara el número de teléfono a un contacto existente, de forma que nuevas comunicaciones puedan presentar directamente al contacto asociado. Esta asociación se almacena en archivo de traslación <carpeta a-link>numberid.dat char a-link / 51

27 Integración con aplicaciones y bases de datos Microsoft Access La integración con Access permite visualizar ventanas definidas mostrando el contacto correspondiente al numero de teléfono de la comunicación. El enlace se basa en el lanzamiento de esta aplicación y ejecución de macro definida expresamente para búsqueda de contactos. Ejecutable: Carpeta y ejecutable de Access, típicamente msaccess.exe. Base de datos: Carpeta y base de datos (*.mdb) con la que se desea enlazar. Macro: Macro definida en Access para búsqueda de contacto. Ej: MacroContactos : Accion: Abrir formulario. Condicion WHERE: [Contactos]![Teléfono]=Comando() O [Contactos]![Tel Móvil]=Comando() O [Contactos]![Fax]=Comando(). En la instalación del SDK a-link se incluyen ejemplos de bases de datos y macro definida (<carpeta a- link>\sdk\samples\accesslink\). char a-link / 51

28 Integración con aplicaciones y bases de datos GoldMine La integración con GoldMine permite visualizar la ventana de contactos mostrando el correspondiente al numero de teléfono de la comunicación. Este enlace se realiza tanto a nivel del API propietario facilitado por GoldMine como mediante el acceso directo a las bases de datos. Esta característica permite ofrecer una integración basada en cualquier número telefónico de un contacto y obliga, en versiones DBF, a la instalación local de Borland Database Engine. Determinados parámetros de configuración son compartidos por los mecanismos de integración de listines con GoldMine. Por este motivo se debe configurar esta integración de listines con la aplicación, aun cuando no se active su enlace. Ejecutable: Carpeta y ejecutable de GoldMine (ej: \Goldmine\gmw6.exe para versión 6). Este parámetro es opcional. Dado que GoldMine debe estar ejecutándose para la realización del enlace, esta configuración permite lanzarla en el caso de no estar activa. Buscar teléfonos secundarios: Realiza identificación de contacto en teléfonos secundarios. Esto supone acceso directo a Base de Datos previo al enlace con la aplicación. Buscar contactos secundarios: Realiza identificación de contacto en teléfonos de contactos secundarios. Esto supone acceso directo a Base de Datos previo al enlace con la aplicación. Acción - Mostrar dialogo de acciones: Presenta dialogo de acciones predefinido en GoldMine. Este dialogo de acciones se limita a identificar el contacto dando opción a la apertura de ventana con sus datos. - Abrir contacto en nueva ventana: Abre el contacto en una nueva ventana manteniendo ventanas de posibles contactos abiertos previamente. - Mostrar contacto en ventana activa: Sustituye los datos de un contacto visible por los del identificado. Mostrar lista de contactos si no encontrado: (Solo efectivo en caso de acción distinta a Mostrar dialogo de acciones): Muestra la lista del centro de contactos permitiendo seleccionar interlocutor de forma manual. Optimización del enlace: En GoldMine edicion Corporate, es posible la creación de botones a los que se pueden asociar eventos: - Barra de elementos - (Click derecho) menú: Agregar nuevo elemento - Aplicación externa. char a-link / 51

29 Mediante esta posibilidad se permite integrar botón en barra de elementos para, por ejemplo, realizar llamada o enviar SMS a traves de la utilidad de integración alinkcmd.exe. Ej: Botón para realización de llamada: - Titulo: Llamar - Aplicación: <carpeta a-link>\alinkcmd.exe - Línea de comandos: Seleccionar detalles de contacto numero de telefono: ** phone ** - Introducir en línea de comandos parámetro de realización de llamada 1 : 1 **phone** - Aceptar char a-link / 51

30 Integración con aplicaciones y bases de datos Ejecutable externo Mediante esta posibilidad se permite enlazar con una aplicación externa lanzando el ejecutable seleccionado e indicando mediante parámetro de ejecución el número de teléfono correspondiente a una comunicación telefónica. El desarrollador del ejecutable, identificara el parámetro enviado y realizara los procesos que correspondan. Ejecutable: Carpeta y ejecutable que se lanzara en el proceso de integración con el numero de teléfono de la comunicación como primer y único parámetro. char a-link / 51

31 Integración con aplicaciones y bases de datos Base de datos Este enlace permite seleccionar determinados campos de una base de datos mostrando, en ventana propia, los campos seleccionados correspondientes al los registros relacionados con el numero de teléfono de una comunicación. Enlace: Parámetros de la conexión según el tipo de enlace: - SQL - ODBC Conexión \SQL: Enlace: Tipo de conexión: SQL. Gestor de datos: Selección del gestor de datos entre los soportados para conexión directa: - DB2 - Interbase - mysql 3.22.x - mysql 3.23.x - mysql 4.x - mysql 4.x direct (Conexión directa no requiere librería cliente libmysql.dll). - Informix - MSSQL - SQL Server - Oracle (general) - Oracle NET - Oracle (10g,9i,8i,8,7). Parámetros: Parámetros de la conexión según el gestor de datos seleccionado. Obligadamente será necesario indicar los valores correspondientes a: hostname: Servidor del gestor de datos. database: Base de datos a enlazar. user_name: Usuario. password: Clave del usuario. Conexión \ODBC: Enlace: Tipo de conexión: ODBC. Parámetros: Cadena utilizada para el enlace. Esta cadena puede ser introducida: Manualmente (usuarios avanzados): Indicando los parámetros necesarios de acuerdo a las especificaciones y requerimientos del proveedor ODBC. char a-link / 51

32 ej enlace Microsoft access: Provider=MSDASQL.1;Persist Security Info=False;Extended Properties="DSN=MS Access Database;DBQ=C:\BD\Datos.mdb;DefaultDir=C:\BD;DriverId=25;FIL=MS Access;MaxBufferSize=2048;PageTimeout=5;UID=admin;" Mediante interface del sistema (Botón Parámetros): Enlaza con el administrador ODBC del sistema. Ejemplo enlace con Microsoft Access (XP profesional): - Ventana Proveedor del vinculo de datos \ conexión - Opción Usar la cadena de conexión - Generar - Origen de datos del equipo - Selección del origen de datos instalado - Doble clic - Usuario, contraseña - Base de datos (seleccionar) - Aceptar. Base de datos: Carpeta y base de datos a enlazar (opcional). Espera de conexión: Espera para la conexión efectiva, valor por defecto 15 segundos. Consulta: Configuración de consulta a realizar para identificación de contacto y selección de campos a mostrar. El proceso se basa en: - Definición de consulta SQL de acuerdo a la sintaxis del gestor de bases de datos utilizado. - Realización de consulta (botón Consulta). Esta acción permite verificar el enlace con la base de datos y proporciona los campos disponibles para asignación de propiedades. La definición de la consulta debe representar una selección basada en un numero concreto: Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 La plantilla %NUMERO1 es fija y deben ser indicadas como asignación del número a buscar. Esta plantilla será reemplazada por el número de teléfono para el que se realizará la consulta. En caso de bases de datos con posible numeración canónica uniforme o no para todos los campos, se ofrece la platilla %NUMERO2. Esta platilla será remplazada por el número sobre el que se realiza la consulta en formato canónico. En este caso la consulta SQL se debe realizar de acuerdo ala sintaxis apropiada. Ejemplo: SELECT * FROM DATOS WHERE NUMERO_TELEFONO=%NUMERO1 OR NUMERO_TELEFONO=%NUMERO2. char a-link / 51

33 Campos: Asignación de descriptores a los campos de la consulta. Titulo: Asignación del campo que se utilizara para identificar el contacto del listin, mostrado en el titulo de la ventana. Asignación de campos: Los campos obtenidos en la consulta se asignaran a cadenas de descripción para ser mostrados en la ventana de integración: Descripción: contenido del campo. Los campos no seleccionados no serán visualizados. Los campos seleccionados que no contengan descripción serán mostrados tomando como descripción el nombre del campo. Campo: Acceso mediante control tipo lista mostrado al entrar en la celda. Selección de uno de los campos obtenidos en la consulta. Descripción: Introducción de cadena utilizada como titulo del campo mostrado. Ejemplo: Consulta: SELECT * FROM telefonos JOIN contactosec ON telefonos.idcontactosec=contactosec.orden JOIN contactoppal ON telefonos.idcontactoppal=contactoppal.orden WHERE telefonos.numero="%number1" Asignación de campos: Titulo: EMPRESA Campos: Campo: CONTACTO. Descripción: Contacto Campo: EMPRESA. Descripción: Empresa. Ejecución, numero entrante : char a-link / 51

34 Integración con aplicaciones y bases de datos Integración con aplicaciones externas (TASP API) Permite la integración con aplicaciones externas a través de API propietario. Este API es similar al empleado por otras aplicaciones: char TASP, char BUP. Descripción El API de integración proporciona un interfaz de alto nivel para permitir a aplicaciones externas recibir datos y enviar órdenes a los dispositivos de telefonía conectados. Notificación de Eventos: - Notificación de Llamadas (realizadas y / o recibidas). - Notificación de Fin de llamada. Las notificaciones se realizan mediante: - La llamada a las funciones correspondientes exportadas por DLL externa. - La ejecución de archivo EXE con traspaso de parámetros de notificación. En el caso de enlace a DLL externa y dado que los procesos ejecutados por la aplicación (DLL) externa pueden no retornar inmediatamente -Ej. : Presentación de ventanas modales- se contemplan dos posibilidades: - Enlace mediante proceso puente : Las notificaciones serán enviadas a distintas instancias de la DLL externa. - Enlace directo con DLL externa: Las notificaciones serán enviadas a una única instancia de la DLL externa, siendo su responsabilidad el retorno inmediato de las funciones llamadas. (Los ejemplos suministrados se deben realizar mediante este tipo de enlace.) TASPBDG.EXE char a-link DLL EXTERNA char a-link / 51

35 Recepción de Ordenes: - Realizar Llamada. - Obtención de Datos Actuales de Llamada. - Transferir Llamada. - Finalizar Llamada. Las órdenes son enviadas a char a-link mediante funciones exportadas por DLL de enlace: APLICACIÓN EXTERNA CHARDBG.DLL char a-link Ejemplos: Ejemplos de estas funciones de enlace se encuentran en la instalación de a-link SDK: <carpeta a- link>\sdk\samples: external_alink alink_external\dll alink_external\exe Ejecutable (EXE) para realización de llamadas y acciones sobre llamadas mediante CHARDBG.DLL Librería (Dll) para recepción de notificaciones (inicio final) de llamadas Ejecutable (EXE) para recepción de notificaciones (inicio final) de llamadas Códigos de Retorno (CHARDBG.DLL): TASP_OK 0 Operación Realizada TASP_BRIDGEERROR -1 Error interno en chardbg.dll TASP_NOTFOUND -2 a-link no está en ejecución y no se puede lanzar TASP_BUSY -3 a-link está ocupado y no puede ejecutar la orden TASP_COMMANDTIMEOUT -4 Sobrepasado tiempo límite para ejecución de la orden TASP_DATAERROR -5 No se puede ejecutar la orden. Datos no válidos TASP_REJECT -6 Orden rechazada. No es permitida por el tipo de licencia TASP_NOTSUPPORTED -7 Orden no soportada por el dispositivo TASP_NOTIFYFAIL -8 Error al notificar orden. TASP_ERROR -9 Error interno de a-link. char a-link / 51

36 Estructuras de datos Byte Aligned CALLDATA call_id Dword Identificador de llamada call_type Integer Tipo de Llamada call_number char [25] Número call_duration Dword Duración de la llamada call_status Byte Estado de la llamada reserved char [1024] Reservado para uso futuro call_id call_type Identificador Llamada Tipo de Llamada: 0: Desconocido. 1: Externa. 2: Interna. 3: Conferencia. call_number call_duration call_status Número de origen o destino de la llamada. Segundos de duración de la llamada en el momento de la consulta Estado de la llamada: 1: Notificación Llamada Entrando 2: Realizando llamada (Saliente) 3: Destino Ocupado (Saliente) 4: Conectado (Saliente) 5: Aparcada (Saliente Entrante) 6: Conferencia (Saliente Entrante) 7: Desconectando (Saliente Entrante) char a-link / 51

37 Constantes Tipo de llamada: CALLTYPE_UNKNOWN CALLTYPE_EXTERNAL CALLTYPE_INTERNAL CALLTYPE_CONFERENCE 1 Llamada de tipo desconocido. 2 Llamada externa. 3 Llamada Interna. 4 Conferencia entre llamadas. Estado de la llamada: CALLSTATUS_NONE CALLSTATUS_OFFERING CALLSTATUS_PROGRESS CALLSTATUS_BUSY CALLSTATUS_CONNECT CALLSTATUS_PAUSE CALLSTATUS_CONFERENCE CALLSTATUS_DISCONNECT 0 La Llamada No Existe. 1 Llamada Entrante pendiente de ser contestada. 2 Realizando conexión de la Llamada. 3 Destino de la llamada ocupado. 4 Llamada conectada (Hablando) 5 Llamada aparcada. 6 La Llamada forma parte de una conferencia. 7 Realizando desconexión de la Llamada. Funciones CHARDBG.DLL: Todas las funciones son del tipo STDCALL tasp_requestmakecall Realización de llamada tasp_getcallinfo Obtención de datos de llamada (estructura) tasp_getcallinfo_bp Obtención de datos de llamada (Parámetros) tasp_requesttransfer Trasferir llamada tasp_dropcall Finalizar llamada tasp_getnumcalls Obtener número de llamadas activas tasp_requestmakeintrudecall Intrusión en llamada de extensión tasp_makecall tasp_transfercall Realización de llamada. Obsoleta Transferencia de llamada. Obsoleta. Códigos de retorno: TASPRESULT_OK TASPRESULT_BRIDGEERROR TASPRESULT_NOTFOUND TASPRESULT_BUSY TASPRESULT_COMMANDTIMEOUT TASPRESULT_DATAERROR TASPRESULT_REJECT TASPRESULT_NOTSUPPORTED TASPRESULT_NOTIFYFAIL TASPRESULT_ERROR 0 Proceso realizado con éxito. -1 Error interno en CHARDBG.DLL -2 No se encuentra ejecutable de TASP (chardial.exe) -3 Interface TASP con aplicaciones externas ocupado. -4 Se ha excedido el tiempo límite para la ejecución. -5 Error en los parámetros de la función. -6 Comando rechazado. Nivel de licencia insuficiente. -7 Función no soportada por el dispositivo. -8 Fallo en la notificación a TASP -9 Error en TASP char a-link / 51

38 Notificación Llamada (DLL EXTERNA): Función de la DLL externa. Llamada por a-link como Notificación de Llamada Entrante. Integer Tasp_newCall ( calldata LPCALLDATA ) Parámetros CallData Puntero a estructura CALLDATA conteniendo los valores iniciales de la llamada. Valores de Retorno TASP_OK si ejecutada. Ver códigos de retorno. char a-link / 51

39 Notificación Llamada (EJECUTABLE EXTERNO): Ejecución de EXE externo con paso de parámetros correspondientes a la nueva llamada entrante: APLICACIÓN_EXTERNA.EXE N [identificador de Llamada] [Tipo de llamada] [Número] [Duración] [Estado] Parámetros 1 Identificador de Notificación Nueva Llamada: N. 2 Identificador de la Llamada. 3 Tipo de Llamada (Constantes: Tipos de Llamada) 4 Número de Origen: Si llamante anónimo :? 5 Duración: Si notificación anterior al descolgado = 0 6 Estado de la Llamada (Constantes: Estado Llamada.) char a-link / 51

40 Finalización Llamada (DLL EXTERNA): Función de la DLL externa. Llamada por char TASP como Mensaje de Finalización de Llamada Entrante. Integer Tasp_endCall ( calldata LPCALLDATA ) Parámetros CallData Puntero a estructura CALLDATA conteniendo los valores finales de la llamada. Valores de Retorno TASP_OK si ejecutada. Ver códigos de retorno. char a-link / 51

41 Finalización de Llamada (EJECUTABLE EXTERNO): Ejecución de EXE externo con paso de parámetros Llamada finalizada: APLICACIÓN_EXTERNA.EXE E [identificador de Llamada] [Tipo de llamada] [Número] [Duración] [Estado] Parámetros 1 Identificador de Notificación Finalización Llamada: E. 2 Identificador de la Llamada. 3 Tipo de Llamada (Constantes: Tipos de Llamada) 4 Número de Origen: Si llamante anónimo :? 5 Duración de la llamada. 6 Estado de la Llamada (Constantes: Estado Llamada). char a-link / 51

42 Realización de Llamada (Enlace con CHARDBG.DLL): CHARDBG.DLL Realización de Llamada Saliente. Integer Tasp_makeCall ( internal INTEGER call_type BYTE call_destination LPCSTR call_id LPDWORD ) Parámetros Internal Uso reservado en procesos internos por char TASP. DEBE SER 0. call_type Tipo de Llamada. Ver Constantes Tipos de llamada. call_destination Puntero a cadena terminada en carácter nulo, conteniendo el número de destino. call_id Puntero a DWORD de retorno del identificador de llamada. Valores de Retorno TASP_OK si ejecutada. Ver códigos de retorno. char a-link / 51