NETRETINA SDK
 

API  / SDK de integración

Soft Ver : 7.xx
Fecha última actualización : 19/06/2008

Documentación integración  - Información de la base de datos

Tablas útiles en la base de datos : Database.mdb [Formato Access/ SQL Server]

[Operators] - Tabla de los distintos operadores creados
[CustomerCards]
- Tabla con todos los datos de los clientes
[CustomerGroups] - Tabla con los diferentes grupos de clientes
[Customers] - Tabla con la relación de equipos que se han conectado al sistema
[Departments] - Tabla con la información de los distintos departamentos creados (Operators <-> D_ID)
[Actions] - Tabla con las acciones predefinidas como mensajes, links o recordatorios
[Chatlogs] - Tabla con el histórico de conversaciones cliente <> operador , si fuera necesario se puede proporcionar la información para acceder a los logs encriptados
[Scripts] - Tabla donde se almacenan los diferentes scripts pre-configurados en el sistema
[Systemdata] - Tabla con información interna de la versión de la aplicación y otros parámetros (no tocar)
[TicketData] - Tabla con la información del sistema de trouble ticket
[Tickets] - Tabla con la información de los tickets de soporte del trouble ticket
 

* Documentación extendida de la base de datos del software Netretina Server

Información de la personalización del componente webscript


En este momento es posible personalizar los siguientes parámetros de la aplicación al ejecutar el webscript

1 - Nombre del cliente que se conecta
2 - Código de conexión
3 - Asignación de ficha del cliente automatizada desde el script
4 - Integración del webscript bajo SSL

* Los parámetros son independientes y pueden llegarse a combinar según sus necesidades


Explicación detallada del uso de los parámetros


1 - Nombre del cliente que se conecta

Es posible llegar a crear un parámetro desde su propio website añadiendo el parámetro -userid=XXXXX donde XXXXX es el nombre del cliente


2 - Código de conexión

Es posible llegar a especificar el código de conexión del operador para poder predefinir a que operador tiene que conectar el cliente cuando se ejecuta el script añadiendo el parametro -cc=XXXXX donde XXXX es el código de conexión del script

Explicación práctica acerca de la integración de los parámetros

La cadena de conexión webscript , es una cadena de texto en formato script HTML que bastará con copiarla dentro de una página de nuestro sitio Web para poder lanzar el cliente desde el navegador de Internet Explorer.
Para poder integrar los parámetros de conexión que hemos detallado con anterioridad tendremos que hacerlo de la siguiente forma, añadiendo el contenido de estos parámetros al final del parámetro WEBCON del mismo webscript.
 

3 - Asignación de ficha del cliente automatizada desde el script

El sistema permite también llegar a asignar (relacionar directamente) un equipo que se conecte a una ficha previamente dada de alta en la base de datos de clientes de netretina , de tal manera que cuando el cliente se conecte ya aparezca automáticamente su ficha de cliente relacionada. Para poder hacer esto únicamente tendremos que añadir el parámetro -company=XX , donde XXX es el ID del cliente , de la tabla de [customercards] de la base de datos.

4 - Integración del webscript bajo SSL

Si UD desea activar la opción de comunicación SSL para el componente webscript, tan solo tiene que cambiar el prefijo http://... de la cadena de conexión del script por esta https:// de esta forma el script se ejecutará de forma segura bajo protocolo cifrado SSL.


Ejemplos

Código webscript normal

<a href="#" onclick="window.open('http://www.conectarahora.com/webretinaevo20065.asp?webcon=6e791d19707f752d79727e26657d632a7971752b7...','min','width=276,height=249,top=0,left=0')" title="Haga clic aquí para conectar con nuestro centro de soporte online"><img src="http://www.conectarahora.com/images/image2.jpg" border=0></a>

Código webscript personalizado especificando el nombre del cliente

<a href="#" onclick="window.open('http://www.conectarahora.com/webretinaevo20065.asp?webcon=6e791d19707f752d79727e26657d632a7971752b7...@-userid=Invitado ejemplo','min','width=276,height=249,top=0,left=0')" title="Haga clic aquí para conectar con nuestro centro de soporte online"><img src="http://www.conectarahora.com/images/image2.jpg" border=0></a>

Código webscript personalizado especificando el código de conexión

<a href="#" onclick="window.open('http://www.conectarahora.com/webretinaevo20065.asp?webcon=6e791d19707f752d79727e26657d632a7971752b7...@-cc=D2121','min','width=276,height=249,top=0,left=0')" title="Haga clic aquí para conectar con nuestro centro de soporte online"><img src="http://www.conectarahora.com/images/image2.jpg" border=0></a>

Código webscript personalizado especificando el código de conexión y el nombre del cliente

<a href="#" onclick="window.open('http://www.conectarahora.com/webretinaevo20065.asp?webcon=6e791d19707f752d79727e26657d632a7971752b7...@-cc=D2121 -userid=Invitado','min','width=276,height=249,top=0,left=0')" title="Haga clic aquí para conectar con nuestro centro de soporte online"><img src="http://www.conectarahora.com/images/image2.jpg" border=0></a>

Código webscript personalizado especificando el código de cliente para asignarlo automaticamente

<a href="#" onclick="window.open('http://www.conectarahora.com/webretinaevo20065.asp?webcon=6e791d19707f752d79727e26657d632a7971752b7...@-company=14','min','width=276,height=249,top=0,left=0')" title="Haga clic aquí para conectar con nuestro centro de soporte online"><img src="http://www.conectarahora.com/images/image2.jpg" border=0></a>
 

Los parámetros son independientes, por lo que se pueden combinar según la necesidad de la integración

Información adicional
 

Código de conexión

La obtención del código de conexión se puede obtener mediante la ejecución de una función ASP que pasándolo el numero ID del operador nos devuelve el código de conexión

Función ASP disponible aquí

Ejemplo de integración


Encriptar o desencriptar cadenas en la base de datos de Netretina

Existe cierta información en la base de datos de netretina que se almacena de forma cifrada, por motivos de seguridad, UD puede acceder a estos campos mediante el uso de las funciones ASP XorEncode y XorDecode.
 

Funciones ASP disponibles aquí

Ejemplo de integración


Información necesaria para la correcta integración de las funciones XOR

Como acceder a los datos desde IIS en ASP

Pueden crear una conexión ODBC a la base de datos del sistema directamente apuntando al archivo DATABASE.MDB ubicado en la carpeta DATA dentro de la carpeta de instalación del software Netretina.

Ejemplo de cadena de conexión en formato ASP :

"Driver={Microsoft Access Driver (*.mdb)};DBQ=C:\\Archivos de programa\\NETRETINA\\Data\\Database.mdb;Uid=;Pwd=;"

 

La documentación de programación e integración Web aquí explicada únicamente contempla el escenario de programación en ASP (active server pages) de Microsoft.

Si Uds. utilizan PHP  o otro lenguaje para realizar la integración no duden en consultarnos si requieren ayuda para poder integrar el sistema en su empresa.

Configuración a medida de la ventana de conexión popup del ActiveX

Existe la posibilidad de especificar una imagen para que sustituya el texto y el icono que sale una vez cargado el Activex. Para poder hacerlo únicamente se tiene que especificar de esta forma, al final de la cadena webcon del script añadir el siguiente parámetro &customlogo=XXXXXXXXXXXXXX  , donde XXXXXXXXXXX es una referencia directa completa a la imagen deseada , ejemplo &customlogo=http://www.netretina.com/images/shield-green-72.gif
 


Consultas de integración

Pueden consultas otras consultas de integración directamente a soporte@netretina.com , la API del sistema Netretina es altamente configurable pero en este momento solo están publicadas estas funcionalidades a la espera de ir añadiendo otras funcionalidades. Si Uds. requieren alguna funcionalidad que creen que pueda ser de interés generalizado no duden en contactar con nosotros para ver la posibilidad de su publicación.
 

www.netretina.com