Manual de Integración
Manual de Integración
Manual de Integración
Manual de Integración
De WikiCLiente
Contenido
1 Incorporación de Autentia a una Aplicación Visual Basic 6.0
2 Incorporación de Autentia a una Aplicación Visual Basic .NET y ASP.NET
3 Incorporación de Autentia a una Aplicación Java Script
4 Incorporación de Autentia a una Aplicación Java
Una vez instalado correctamente Autentia, debe aparecer en la lista de referencias registradas en el menú Project opción Referencias.
Una vez selecciona se pude continuar declarando la variable con la cual operara, lo que se debe hacer de la siguiente forma:
Luego se debe agregar al proyecto una clase para esto debe ir al menú Project a la opción Add Class Module donde deben generar una nueva y
vacía, donde ingresaran el siguiente código:
Esto define la clase que contendrán los parámetros que se intercambiaran entre la aplicación cliente y el servidor Autentia. Ahora debemos ver en
que parte del código de nuestra aplicación hacemos el llamado a autentia, para poder realizar esto lo primero que se debe hacer es instanciar la
variable autentia previamente definida:
Con esto ya estamos en condiciones de hacer el llamado a autentia, para esto debemos incorporar la siguiente línea:
Esto llamara a autentia el que pedirá la identificación de la persona asociada al rut que se paso por parámetros, desplegando la siguiente pantalla:
Por ultimo una vez identificada la persona el control retorna a la aplicación y se deben recuperar los parámetros de salida, de la siguiente forma
Resultado = pParams.Error
DescripcionError = pParams.ErrorText
NumeroAudit = pParams.NroAuditoria
En pParams.Error se retorna un valor 0 en caso de ser exitosa la verificación y un valor distinto de 0 en caso de haberse producido algún tipo de
error.
Al igual que Visual Basic 6.0, una vez instalado Autentia el primer paso es agregar la librería a las referencias, para más tarde poder utilizar sus
métodos y propiedades, como se ilustra en los siguientes pasos a continuación:
2. Seleccionar la librería que se desea agregar, en este caso es Autentia32.dll , la cual debería estar ubicada en c:\autentia\bin o en el directorio
donde se instalo Autentia y presionar el botón OK .
3. En la sección Imported Namespaces debe seleccionar AUTENTIA32Lib como se muestra en la siguiente imagen:
4. Una vez agregada la librería, el siguiente paso es declarar la variable pAutentia como Autentia que contiene todos los métodos y propiedades
que serán utilizados posteriormente.
ASP.NET
5. El código a continuación permite iniciar sesión en Autentia, puede estar dentro del evento Load o dentro de un boton, o otro objeto:
Definición de la variable Erc, la cual contiene el valor de retorno de la transacción, si este es 0 (cero), no existe problema, si el valor es distinto, hay
un problema, para tener más ayuda sobre el error se debe obtener el valor de ErcDesc.
Estas dos lineas nos muestran el método IniciarSesion que tiene como parametros el Rut del operador y en el segundo parametro de la primera
linea false, el cual indica que solicitara la huella del operador para el inicio de sesión.
6. El siguiente es un código de ejemplo el cual se utiliza para llamar una transacción de verificación:
Esta linea cumple la misma función que la anteriormente descrita en el código anterior.
Call pAutentia.ParamsInit("Rut,DV,Erc,ErcDesc,ErcDetail,ErcDetailDesc,NroAudit,oRut,oDV,oNombres,oApPaterno,oApMaterno")
En esta línea se indican las variables de entrada y de salida de la transacción,las cuales serán enviadas con valores y más tarde retornaran y podrán
ser leídas.
pAutentia.ParamsSet(1, TBRutOperador.Text)
pAutentia.ParamsSet(2, TBDV.Text)
En estas par de lineas se muestra como se asigna valores a las dos primeras variables, las cuales estan identificadas por el indice 1 y 2 y asi
sucesivamente si se quiere referenciar a otra variable para asignarle algun valor.
Erc = pAutentia.Transaccion2("$ejemplo/veriden")
De esta forma se realiza la llamada a una transacción desde VB .NET y ASP.NET, se utiliza el metodo Transaction2 y entre parentesis y comillas
se puede especificar por ejemplo, $ejemplo lo cual sería el directorio donde se encuentra la transacción propiamente tal, y en este caso veriden
sería la transacción.
En estas lineas podemos visualizar como se obtiene el valor que retorna desde la transacción, para esto tenemos el metodo ParamsGet(n) donde
entre parentesis se coloca el numero, el cual indica la posición de la variable que va ha obtener su valor.
pAutentia.TerminarSesion()
pAutentia = Nothing
Luego se deben definir los parámetros, esto se debe hacer con el siguiente código:
<script language="JavaScript">
function TParams ()
{
this.length = 6;
this.Rut = "";
this.DV = "";
this.NroLME = "";
this.Error = 0;
this.ErrorText = "";
this.NroAuditoria = "";
}
</script>
Luego se deben llenar los parámetros necesarios, se debe hacer con el siguiente código:
<script language="JavaScript">
var Params = new TParams;
Params.Rut = 11833294 ;
Params.DV = 6;
Con esto ya estamos en condiciones de hacer el llamado a autentia, para esto debemos incorporar la siguiente línea:
Esto llamara a autentia el que pedirá la identificación de la persona asociada al rut que se paso por parámetros, desplegando la misma pantalla
mostrada en el caso de Visual Basic. Por ultimo una vez identificada la persona el control retorna a la aplicación y se deben recuperar los
parámetros de salida, de la siguiente forma:
Resultado = Params.Error
DescripcionError = Params.ErrorText
NumeroAudit = Params.NroAuditoria
En Params.Error se retorna un valor 0 en caso de ser exitosa la verificación y un valor distinto de 0 en caso de haberse producido algún tipo de
error.
A continuación se describirá la Integración de Autentia con Java. Para esto utilizaremos La IDE Eclipse. Los pasos son los siguientes:
1. Se crea un nuevo proyecto, seleccionando la opción Java Project como se muestra en la siguiente imagen.
2. Una vez seleccionada la opción Java Project, se despliega esta imagen en la cual colocamos un nombre al proyecto y presionas Next.
3. Se presentara la siguiente ventana en la cual se muestra el Tab Source, visualizamos las carpetas con el nombre del proyecto y la subcarpeta de
los fuentes src.
4. En esta ventana se muestra que se debe seleccionar el Tab Libraries en el cual se agregaran las external JARs necesarias para el proyecto. Para
200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 7/12
13/03/12 Manual de Integraci n - WikiCLiente
esto presionar el botón Add External JARs.
5. Una vez seleccionado el botón Add External JARs, se desplegará el siguiente cuadro de dialogo en el cual se selecciona los jar que se quieren
agregar al proyecto. Los cuales son:
args4j-2.0.1.jar
com4j.jar
tlbimp.jar
6. En esta imagen se muestra las librerías jar ya agregadas al proyecto. El siguiente paso es presionar el botón Finish, una vez realizado esto se
genera el proyecto.
7. En esta imagen podemos visualizar el proyecto con las librerías necesarias ya incluidas.
8. El siguiente paso es agregar los paquetes de librería Autentia, para eso vamos al directorio donde se encuentra este, para ejemplo es java-
libs/com4j-20110320/wsh y copiamos el directorio autentia.
9. Seleccionamos el src del proyecto y pegamos, creándose los paquetes con las librerías para Autentia.
10. Una vez realizado lo anterior, creamos un paquete dentro del src, el cual para el ejemplo lo llamamos com.autentia.win.
11. Dentro del paquete creado anteriormente se crea un Java Class con las propiedades indicadas en la ventana anterior. Para finalizar presionar
el botón Finish.
12. Se genera el código indicado en la imagen, al cual se debe agregar ciertas lineas quedando como resultado final lo que está en el recuadro
siguiente.
package com.autentia.win;
import autentia.wsh.ClassFactory;
import autentia.wsh.IAutentia;
Para ejecutar luego este código se pasa por parámetro en el argumento el Rut, ejemplo: 9999999 9 . Dando como resultado una verificación en
Autentia para el Rut indicado.
Esta página fue modificada por última vez el 14:00, 13 mar 2012.