13/03/12 Manual de Integraci n - WikiCLiente

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

Incorporaci n de Autentia a una Aplicaci n Visual Basic 6.0

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:

Public WithEvents pAutentia As Autentia

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:

Public length As Long

Public Rut As String
Public DV As String
Public NroLME As String
Public Error As Long
Public ErrorText As String
Public NroAuditoria As String

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:

Set pAutentia = New Autentia

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 1/12

13/03/12 Manual de Integraci n - WikiCLiente
Luego se proceder a llenar los parámetros, esto se puede hacer de la siguiente forma:

Dim pParams As New Params

pParams.length = 5 Cantidad de parámetros incluidos los de entrada (3) y los

de salida (2)
pParams.Rut = “11833294” Rut sin DV sin . ni guión
pParams.DV = “6” Digito Verificador

Con esto ya estamos en condiciones de hacer el llamado a autentia, para esto debemos incorporar la siguiente línea:

erc = pAutentia.Transaccion("firma", pParams)

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.

En pParams.ErrorText se retorna una descripción del error en caso de existir.

Y en pParams.NroAuditoria se retorna el valor de la llave de auditoria, que es del tipo LMED-M12T-8SC3-TWSB

NOTA.- El valor retornado en el parámetro NroAuditoria es la llave que se

debe almacenar en sus sistemas para luego poder incorporarla a la
licencia médica electr nica.

Incorporaci n de Autentia a una Aplicaci n Visual Basic .NET y ASP.NET

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:

1. Se debe presionar el botón Add .

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 2/12

13/03/12 Manual de Integraci n - WikiCLiente

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:

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 3/12

13/03/12 Manual de Integraci n - WikiCLiente

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.

Public WithEvents pAutentia As Autentia

Esta linea debe situarse en la zona de declaración (Declarations)

Vis al Basic .NET

Public Class FrmTransac

Public WithEvents pAutentia As Autentia

ASP.NET

Partial Public Class _Default

Inherits System.Web.UI.Page
Public WithEvents pAutentia As Autentia

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:

Vis al Basic .NET y ASP.NET

Dim Erc As Integer

pAutentia = New Autentia
Erc = pAutentia.TerminarSesion
Erc = pAutentia.IniciarSesion(TBRutOperador.Text, False)

Explicando línea por línea el ejemplo:

Dim Erc As Integer

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.

Erc = pAutentia.IniciarSesion(TBRutOperador.Text, False)

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:

Vis al Basic .NET y ASP.NET

Dim Erc As Integer

pAutentia = New Autentia
Try
Call pAutentia.ParamsInit("Rut,DV,Erc,ErcDesc,ErcDetail,ErcDetailDesc,NroAudit,oRut,oDV,oNombres,oApPaterno,oApMaterno")
pAutentia.ParamsSet(1, TBRutOperador.Text) 'al parametro 1 (rut) le asigna el valor
pAutentia.ParamsSet(2, TBDV.Text) 'al parametro 2 (DV) le asigna el valor
Erc = pAutentia.Transaccion2("$ejemplo/veriden")
Catch ex As Exception
MsgBox(ex.ToString)
End Try
TBDS.Text = "Rut: " & TBRutOperador.Text & vbCrLf
TBDS.Text = TBDS.Text & "DV: " & TBDV.Text & vbCrLf
TBDE.Text = "Erc: " & Erc + pAutentia.ParamsGet(3) & vbCrLf
TBDE.Text = TBDE.Text & "Descripcion: " & pAutentia.ParamsGet(4) & vbCrLf
TBDE.Text = TBDE.Text & "ErcDetail: " & pAutentia.ParamsGet(5) & vbCrLf
TBDE.Text = TBDE.Text & "ErcDetail Descripcion: " & pAutentia.ParamsGet(6) & vbCrLf

Explicando línea por línea el ejemplo:

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 4/12

13/03/12 Manual de Integraci n - WikiCLiente
Dim Erc As Integer

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.

TBDE.Text = "Erc: " & Erc + pAutentia.ParamsGet(3) & vbCrLf

TBDE.Text = TBDE.Text & "Descripcion: " & pAutentia.ParamsGet(4) & vbCrLf

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.

7. Para terminar la llamada a una transacción se utiliza las siguientes lineas:

pAutentia.TerminarSesion()
pAutentia = Nothing

Incorporaci n de Autentia a una Aplicaci n Java Script

La forma es mediante un tag <OBJECT>, en la forma:

<OBJECT ID="Autentia" CLASSID="CLSID:592B9D7E-51C9-401F-A03C-4DE61FF7008D">

</OBJECT>

Esto puede ir dentro del <BODY> ya que es invisible en ejecución

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;

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 5/12

13/03/12 Manual de Integraci n - WikiCLiente
Params.NroLME = 123456 ;
</script>

Con esto ya estamos en condiciones de hacer el llamado a autentia, para esto debemos incorporar la siguiente línea:

res = Autentia.Transaccion ("firma",Params);

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.

En Params.ErrorText se retorna una descripción del error en caso de existir.

Y en Params.NroAuditoria se retorna el valor de la llave de auditoria, que es del tipo LMED-M12T-8SC3-TWSB

NOTA.- El valor retornado en el parámetro NroAuditoria es la llave que se debe

almacenar en sus sistemas para luego poder incorporarla a la licencia
médica electr nica.

Incorporaci n de Autentia a una Aplicaci n Java

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.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 6/12

13/03/12 Manual de Integraci n - WikiCLiente

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.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 8/12

13/03/12 Manual de Integraci n - WikiCLiente

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.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 9/12

13/03/12 Manual de Integraci n - WikiCLiente

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.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 10/12

13/03/12 Manual de Integraci n - WikiCLiente

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;

public class TestIntegAutentiaJ

{
public static void main(String[] args) {
IAutentia pAutentia = ClassFactory.createAutentia();
pAutentia.paramsInit("Rut,DV,Erc,ErcDesc,NombreCliente,NroAudit,oRut,oDV,oNombres,oApPaterno,oApMaterno");
pAutentia.paramsSet(1, args[0]);
pAutentia.paramsSet(2, args[1]);
pAutentia.transaccion2("$INSTITUCION/veriden");
System.out.println(pAutentia.paramsGet(3));
System.out.println(pAutentia.paramsGet(4));
System.out.println(pAutentia.paramsGet(6));
}
}

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.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 11/12

13/03/12 Manual de Integraci n - WikiCLiente
Obtenido de "http://200.0.156.162/index.php/Manual_de_Integraci%C3%B3n"

Esta página fue modificada por última vez el 14:00, 13 mar 2012.

200.0.156.162/index.php?title=Manual_de_Integraci n&printable=yes 12/12