NETRETINA Software de control r

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]

[Operators] - Tabla de los distintos operadores creados

- ID : Numero ID del operador en la tabla (auto-incremental)
- ScreenName : Nombre de pantalla del operador
- Username : Nombre del login de usuario
- Pass : Contraseña (encriptada), si lo requieren se puede llegar a dar más información al respecto
- Active : Esta cuenta esta habilitada para su uso, en caso contrario el login no funcionaria
- Cellular : Información teléfono Mobil
- Email : Email del operador
- Constring : parámetro interno de netretina que identifica la conexión del operador (no tocar)
- Lastcon : Última conexión del operador
- Status : 0 = desconectado, 1=conectado, 2 =conectado pero en modo offline
- IsAdmin : El operador es administrador
- D_ID : Id del departamento al que pertenece este operador

[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

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í

Function GenerateConnectionCode(AOpID) GenerateConnectionCode = Chr(64 + AOpID) & CStr(Year(Now) + Month(Now) + Day(Now)) End Function

Ejemplo de integración

<% Function GenerateConnectionCode(AOpID) GenerateConnectionCode = Chr(64 + AOpID) & CStr(Year(Now) + Month (Now) + Day(Now)) End Function %> <HTML> <BODY> <% dim toencode OperatorID = 1 Response.Write ("Código de conexión del operador ID=1 ---> " & generateconnectioncode(OperatorID)) %> </BODY> </HTML>

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í

Function StrConv(sValue) iPos = 1 Do While InStr(iPos, sValue, " ", 1) <> 0 iSpace = InStr(iPos, sValue, " ", 1) sTemp = sTemp & UCase(Mid(sValue, iPos, 1)) sTemp = sTemp & LCase(Mid(sValue, iPos + 1, _ iSpace - iPos)) iPos = iSpace + 1 Loop sTemp = sTemp & UCase(Mid(sValue, iPos, 1)) sTemp = sTemp & LCase(Mid(sValue, iPos + 1)) StrConv = sTemp End Function Function XorEncode(key, source) Dim i Dim c Dim rslt Dim addzeroes For i = 1 To Len(source) If Len(key) > 0 Then c = (Asc(Mid(key, 1 + ((i - 1) Mod Len(key)), 1)) Xor Asc(Mid(source, i, 1))) Else c = Asc(Mid(source, i, 1)) End If If Len(Hex(c)) < 2 Then addzeroes = "0" Else addzeroes = "" rslt = rslt & StrConv(addzeroes & Hex(c)) Next XorEncode = rslt End Function Function XorDecode(key, source) Dim i Dim c Dim rslt For i = 0 To (Len(source) \ 2 - 1) c = Chr(CLng("&H" & Mid(source, (i * 2) + 1, 2))) If Len(key) > 0 Then c = Chr(Asc(Mid(key, 1 + (i Mod Len(key)), 1)) Xor Asc(c)) End If rslt = rslt & c Next XorDecode = rslt End Function

Ejemplo de integración

<% Function StrConv(sValue) iPos = 1 Do While InStr(iPos, sValue, " ", 1) <> 0 iSpace = InStr(iPos, sValue, " ", 1) sTemp = sTemp & UCase(Mid(sValue, iPos, 1)) sTemp = sTemp & LCase(Mid(sValue, iPos + 1, _ iSpace - iPos)) iPos = iSpace + 1 Loop sTemp = sTemp & UCase(Mid(sValue, iPos, 1)) sTemp = sTemp & LCase(Mid(sValue, iPos + 1)) StrConv = sTemp End Function Function XorEncode(key, source) Dim i Dim c Dim rslt Dim addzeroes For i = 1 To Len(source) If Len(key) > 0 Then c = (Asc(Mid(key, 1 + ((i - 1) Mod Len(key)), 1)) Xor Asc(Mid(source, i, 1))) Else c = Asc(Mid(source, i, 1)) End If If Len(Hex(c)) < 2 Then addzeroes = "0" Else addzeroes = "" rslt = rslt & StrConv(addzeroes & Hex(c)) Next XorEncode = rslt End Function Function XorDecode(key, source) Dim i Dim c Dim rslt For i = 0 To (Len(source) \ 2 - 1) c = Chr(CLng("&H" & Mid(source, (i * 2) + 1, 2))) If Len(key) > 0 Then c = Chr(Asc(Mid(key, 1 + (i Mod Len(key)), 1)) Xor Asc(c)) End If rslt = rslt & c Next XorDecode = rslt End Function %> <HTML> <BODY> <% dim encodedtext,decodedtext, enckey enckey = "NOTES" encodedtext = "06203824732b3c202a732b3c74303d6e3b3136276e3f3537326e2a386530 3b2e30373c6e2b31653d213b35367374667469733e2e2620302b6f2530366e 29212b3027203a24" decodedtext = XorDecode(enckey,encodedtext) response.write (decodedtext) response.write ("<br>") encodedtext = XorEncode(enckey,decodedtext) response.write (encodedtext) %> </BODY> </HTML>

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

El campo de comentarios/observaciones que se almacena en la tabla [CUSTOMERCARDS] esta encriptado con la funcionalidad XOR y tiene como key de encriptación la cadena "NOTES"

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.