...
Fecha | Revisión | Observaciones |
24/01/2005 | 1.0.1 | Generación del documento |
24/11/2005 | 01.41 | Inclusión campo 74,75 |
21/03/2006 | 01.52 | Encriptacion |
19/07/2006 | 01.63 | Agregado campos para transacciones de debito |
22/09/2006 | 01.74 | Libreria para vb |
02/10/2006 | 01.85 | Agregado y actualización de información de la librería JAVA. |
14/05/2007 | 1.06 | Reestructuración del documento. Incorporación de información del protocolo Synthesis (llavecitas) |
05/10/2010 | 1.1.47 | Agregado de parámetro de configuración librería dinámica TOTALNODESNUMBER y INITIALNODENUMBER |
19/04/2012 | 1.1.68 | Agregado de mayor flexibilidad para configurar los archivos de configuración. Agregado de logeo nativo de Java. |
01/09/2014 | 1.1.79 | Revisión de parámetros de configuración de la librería. |
10/02/2015 | 1.1.810 | Agregado de la modalidad VirtualVTOLClient para locales virtuales donde VTOL Server gestionará la asignación de nodos. |
01/12/2016 | 1.1.911 | Agregado de comunicación sobre protocolo SSL. Detalle de los nuevos parámetros de configuración disponibles para SSL. |
28/03/2018 | 1.12 | Modificación en las revisiones del documento. |
Índice
Índice |
---|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
VTOL cuenta con una librería desarrollada en Java la cual provee las funciones necesarias para realizar autorizaciones de diversos tipos de transacciones, además de las transacciones de control propio y común a cualquier implementación de VTOL Server.
La librería es en realidad un módulo cliente que se comunica vía TCP/IP con el servidor de transacciones (VTOL).
A continuación se hará una descripción de los contenidos de la librería que ayudarán a comprender su funcionamiento. Antes se hará una introducción a la Mensajería de VTOL.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Synthesis establece un protocolo de comunicación para la interacción POS - VTOL, el cual se denomina "Protocolo Synthesis" o "llavecitas". Dicho protocolo se basa en un esquema recursivo compuesto por campos y separadores. A continuación se provee una especificación detallada de su estructura junto con los consecuentes diagramas para un mejor entendimiento.
Para implementar esta mensajería, VTOL provee una librería en el cual se encuentra la declaración de funciones y las definiciones de constantes y tipos necesarias. La librería es en realidad un módulo cliente que se comunica vía TCP/IP con el servidor de transacciones VTOL. El cliente podrá implementar esta mensajería sin utilizar la librería, pero deberá respetar el formato de la misma.
...
La estructura posee dos partes separadas que son el Header y el Mensaje propiamente dicho.
Âncora | ||||
---|---|---|---|---|
|
Dentro del Header viaja información específica del mensaje que se encuentra a continuación del mismo, como ser su longitud y si requiere o no una respuesta. Para ello fueron destinados 6 bytes que se distribuyen de la siguiente manera: los primeros 4 bytes son destinados a la longitud (expresado en hexadecimal, con el último byte como el más significativo) y los últimos 2 indican la necesidad de recibir o no una respuesta (expresado en hexadecimal, con el último byte como el más significativo)
Un ejemplo de lo explicado anteriormente podría ser el siguiente:
...
Nota |
---|
Nota: Se ordena la longitud A101colocando el byte más significativo a la izquierda, con lo cual resulta: 101A. |
Âncora | ||||
---|---|---|---|---|
|
A continuación del Header se encuentra el Mensaje propiamente dicho, el cual contiene la información que el emisor desea transmitirle al sistema receptor.
La estructura de los mensajes son que se muestra en la siguiente ilustración:
...
El mensaje anterior posee 5 campos, los cuales se identifican con los números 1, 2, 26, 27 y 28. A continuación de cada uno de ellos (luego del separador ":") se encuentra el valor de cada campo. En el ejemplo presentado, para el campo 1 el valor es "5", para el campo 2 el valor es "1" y así sucesivamente.
Âncora | ||||
---|---|---|---|---|
|
Para realizar el escape de un caracter especial se deberá usar "{}" inmediatamente antes del carácter a escapar.
Ejemplo:
A continuación se presenta un campo cuyo valor incluye el carácter ; y se muestra como escapar el mismo:
{1:14\;56}
Âncora | ||||
---|---|---|---|---|
|
- Solicitud de Autorización, este mensaje lo genera el punto de venta cada vez que se requiere autorizar una operación. Se envían los datos requeridos de acuerdo al tipo de operación. Adicionalmente se envía información de control de mensajes.
- Respuesta de Autorización, este mensaje lo genera VTOL para el punto de venta, en respuesta a cada Solicitud de Autorización y contiene información tanto de resultado de la operación como de control.
- Confirmación (Tercer mensaje), este mensaje lo genera el punto de venta para informar como ha terminado de procesar la respuesta de una operación. No se genera respuesta para este mensaje.
- Solicitud de Control de Pendientes, este mensaje lo genera el punto de venta, para asegurar que ha confirmado el estado de todas las operaciones.
- Respuesta de Control de Pendientes, este mensaje lo genera VTOL para el punto de venta, en respuesta a cada Solicitud de Control de Pendientes e informa si existen operaciones pendientes de confirmación.
Âncora | ||||
---|---|---|---|---|
|
Para referencia sobre la estructura de cada uno de los tipos de mensajes mencionados con antelación, consultar el documento "Mensajería POS – VTOL" ubicado en el repositorio del producto VTOL.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
El tercer mensaje es un mecanismo para asegurar la consistencia y concordancia de las transacciones realizadas que son registradas en VTOL.
...
El tercer mensaje puede enviarse "embebido" en un requerimiento. Así en una misma transacción se enviará un requerimiento y la confirmación o reverso de una transacción pendiente.
Importante: Una operación de venta en el POS podrá tener una o más transacciones de pago electrónico validadas por intermedio de VTOL (trx VTOL).
Para el envío del 3er Msg debe establecerse una condición por la que se da por finalizada la venta en el POS. Esta condición podría ser el registro de la transacción o la impresión del comprobante, pero se deberá tener en cuenta que para confirmar una trx VTOL, se tiene que asegurar que la venta que contiene esa trx sea procesada por el POS, que se emitan los comprobantes correspondientes, etc.
Por otro lado, si la venta en el POS se registra como anulada o directamente no se registra (ya sea por pedido del operador, por un error del Controlador Fiscal, etc) debemos estar seguros de que en el 3er Msg de las trx correspondientes vaya la orden de ROLLBACK para esta trx.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Los mensajes de confirmación no son respondidos por VTOL Server. Además estos mensajes pueden ser embebidos en futuros mensajes de pedido de autorización esto da lugar a que algunas operaciones queden pendientes de confirmación entre dos transacciones distintas. La última transacción antes de el cierre o caída del punto de venta podría ocasionar dicha contingencia ya que no existiría un futuro mensaje de confirmación o pedido de autorización con la confirmación embebida.
Para asegurar que ninguna transacción quedó pendiente de confirmación en VTOL se deberán aplicar los siguientes pasos:
...
- El punto de venta enviara un mensaje de chequeo de pendientes "CheckPending" a VTOL.
- VTOL Server verificará la existencia de transacciones pendientes en su base, en caso de existir responderá el mensaje con el identificador (ID) de la transacción pendiente.
- El punto de venta deberá confirmar dicha transacción (Commit/Rollback) y enviar un nuevo mensaje de chequeo de pendientes. Nótese que esto se podría realizar en un solo paso, enviando un mensaje de chequeo de pendientes con la confirmación embebida.
- Se deberá repetir el proceso hasta tanto existan transacciones pendientes en VTOL. Cuando ya no existan VTOL responderá APROBADA.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
También existe la posibilidad de deshabilitar el chequeo de pendientes. Esto permite realizar un conjunto de transacciones que podrán ser confirmadas o reversadas posteriormente. Por ejemplo:
La implementación del Tercer Mensaje y Mensajes de Control de Pendientes, dependerá del tipo de integración que se realiza en el Punto de Venta, y quedará a elección del cliente utilizar algunos, o todos los Mensajes descriptos.
Los campos que debe contener el tercer mensaje son los siguientes:
...
- TransactionTypeFieldId debe tener el valor UnSyncCompletion
- DateTimeFieldId
- NodeFieldId (debe ser el valor recibido en este mismo campo en el mensaje de respuesta de la transacción original que se intenta completar)
- TrxIdFieldId (debe ser el valor recibido en este mismo campo en el mensaje de respuesta de la transacción original que se intenta completar)
- TrxActionFieldId (este campo define si lo que se quiere hacer es confirmar la transacción (UnSyncCommit), o bien reversarla (Rollback))
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Se pueden adoptar diferentes políticas al momento de implementar la librería cliente.
Una de ellas es implementarla en cada punto de venta, por lo cual se le deberá incorporar la lógica suficiente a cada uno para que puedan manejar la librería y mediante la misma comunicarse con VTOL Server.
...
Un ejemplo de esta modalidad sería el uso de la librería en un sitio WEB donde no necesariamente existen nodos estáticos.
Âncora | ||||
---|---|---|---|---|
|
Como se explicó con anterioridad la librería cuenta con dos modalidades, por lo tanto, en Java existen dos implementaciones:
...
- StaticVTOLClient
- Esta implementación está orientada a ser utilizada por cada punto de venta donde el Originador y el Nodo sean fijos.
- DinamicVTOLClient
- Esta implementación está orientada a concentrar varios puntos de venta donde el Originador sea fijo y el nodo se obtenga de forma dinámica entre la librería y VTOL (Se hace por medio de un mensaje HandShake).
- VirtualVTOLClient
- Esta implementación está orientada a ser utilizada por varios puntos de venta o en un ambiente de e-commerce donde el Originador sea fijo y VTOL gestione la asignación de nodos (Locales virtuales).
Âncora | ||||
---|---|---|---|---|
|
Para utilizar la librería java hay que seguir los siguientes pasos:
...
- crear una instancia de VTOLClient.
- cargarle los parámetros correspondientes.
- inicializar el cliente
- tomar un nodo
- construir una transacción.
- enviar el mensaje.
- devolver el nodo.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Las siguientes constantes deben ser inicializadas para hacer uso de la librería:
...
Nombre constante | Descripción | |||||||||||||||
HOSTIP
| Identifica el parámetro que se usa para determinar la IP de VTOL Server | |||||||||||||||
HOSTPORT
| Identifica el port TCP al cual se tiene que conectar con VTOL Server | |||||||||||||||
RESPONSETIMEOUT | [Opcional] Tiempo máximo en (milisegundos) de espera para un respuesta de VTOL server antes de salir por timeout. Superado este tiempo se lanza la excepción TimeoutClientException.
Valor por defecto 30000. | |||||||||||||||
TIMEOUTCONNECTIONHOST | [Opcional] Tiempo máximo de conexión a VTOL Server expresado en milisegundos. Superado este valor y no lograda la conexión, se arroja la excepción VtolClientException
Un valor de cero significa infinito.
Valor por defecto 20000. | |||||||||||||||
TIMEOUTOBTAINNODE
| Tiempo máximo en milisegundos a esperará antes de arrojar una excepción al tratar de obtener un nodo. | |||||||||||||||
TIMEOUTEXPIRATIONNODE
| Identifica el parámetro utilizado para indicar el tiempo en liberar un nodo. En caso de no liberarse dentro de ese tiempo, será liberado por la aplicación. | |||||||||||||||
USEVTOLCLIENTFINDER
| Establece la utilización o no del VTOLClientFinder. True False (valor por defecto) | |||||||||||||||
CLIENTFINDER | [Opcional] R (siempre determinada realizar un Rollback de la transacción pendiente) C (siempre determinada realizar un Commit de la transacción pendiente, valor por defecto) ar.com.synthesis.vtol.client.VtolClientFinder y configurarla antes de inicializar la librería, por ejemplo: vtolClientLib.setVtolClientFinder(new MyTrxFinder()); vtolClientLib.init(); | |||||||||||||||
USEENCRYPTEDDATA | Establece la utilización de encriptación en los mensajes.
| |||||||||||||||
ENCRYPTER | [Opcional]
| |||||||||||||||
ENCRYPTKEY | [Opcional] | |||||||||||||||
USEPENDINGAUTOMATIC
| [Opcional] True False (valor por defecto) | |||||||||||||||
TOTALNODESNUMBER
| [Opcional] | |||||||||||||||
DEFAULTTRANSACTIONSTATUS
| [Opcional] C (valor por defecto) R | |||||||||||||||
INITIALNODENUMBER
| [Opcional] | |||||||||||||||
VTOLCLIENTLIBCONFIGPATH
| [Opcional] | |||||||||||||||
PRECONFIGUREDFIELDSFILENAME
| [Opcional] | |||||||||||||||
PRECONFIGUREDFIELD
| [Opcional]
| |||||||||||||||
SSLENABLED | Indica cuando la comunicación con VTOL está sobre SSL:
| |||||||||||||||
SSLKEYSTORE | Ruta del archivo que contiene los certificados que se usaran para la validación. OBLIGATORIO cuando el parámetro SSLENABLED es True. | |||||||||||||||
SSLKEYSTOREPASSWORD | Contraseña del archivo que contiene los certificados que se usaran para la validación. OBLIGATORIO cuando el parámetro SSLENABLED es True. Valor por defecto: nosotros. | |||||||||||||||
SSLPROTOCOL | Versión de protocolo SSL/TLS. OBLIGATORIO cuando el parámetro SSLENABLED es True. Valores posibles:
|
Âncora | ||||
---|---|---|---|---|
|
Method Summary | |
| |
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Âncora | ||||
---|---|---|---|---|
|
Method Summary | |
|
|
|
|
| |
| |
| |
|
|
| |
|
|
|
|
|
|
| |
| |
| |
| |
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Âncora | ||||
---|---|---|---|---|
|
Esta interface la debe implementar una clase para poder setearse como el VTOLClientFinder de la librería. Esta clase cumple con la función de determinar qué hacer si existe una transacción para cual VTOL Server no conoce su estado. Cuando VTOL Server contesta un requerimiento indicando que una transacción está pendiente, librería llama al método getTransaction() para determinar qué acción debe tomar con esta transacción. La clase seteada por default para esta función devuelve siempre "Commit". La clase que se setee como tal, deberá buscar en la base de datos de la aplicación cual es el estado de la misma y devolverlo para su correspondiente proceso.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
public class VtolClientException extends java.lang.Exception
...
Method Summary | |
java.lang.String | getCode() |
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
La librería brinda la posibilidad de encriptar los mensajes con el algoritmo DES y Triple DES utilizando la clase DES.
...
(Ejemplo, ver 3.3 Acceso a VTOL/Server desde Java con encriptación de mensajes)
Âncora | ||||
---|---|---|---|---|
|
La librería de Java proporciona la funcionalidad adicional de indicar campos previamente configurados que se enviarán directamente en los mensajes a VTOL. Existen formalmente dos maneras de realizar esta configuración, ya sea a través de los parámetros de inicialización o bien a través de un archivo xml (proporcionado con la aplicación). A continuación se detalla cada uno de estos casos.
Inicialización
La desventaja que tiene esta manera de configurar es que solamente se puede proporcionar un campo pre-configurado. Por este motivo se recomienda que si se requiere tener más de uno de estos campos, se utilice el enfoque de la configuración vía XML.
Los parámetros configurados previamente se pueden agregar al proceso de inicialización del cliente de VTOL que se decida utilizar (estático o dinámico). A continuación se muestra un ejemplo de inicialización de un cliente estático indicando el bloque de inicialización
…
//seteo de parmatros, como ser conexión, timeout, encriptacion, etc.
staticVTOLClient.setParameter("HOSTIP","127.0.0.1");
staticVTOLClient.setParameter("HOSTPORT","3000");
staticVTOLClient.setParameter("TIMEOUTCONNECTIONHOST","3000");
staticVtolClient.setParameter("RESPONSETIMEOUT","30000");
staticVTOLClient.setParameter("TIMEOUTEXPIRATIONNODE","10000");
staticVTOLClient.setParameter("TIMEOUTOBTAINNODE","10000");
staticVTOLClient.setParameter("USEVTOLCLIENTFINDER","");
staticVTOLClient.setParameter("USEENCRYPTEDDATA","False");
staticVTOLClient.setParameter("ENCRYPTKEY","");
staticVTOLClient.setParameter("ENCRYPTER","");
//Inicialización del campo previamente configurado.
staticVtolClient.setParameter("PRECONFIGUREDFIELD","115,2,1,1");
…
El nombre del parámetro necesariamente es PRECONFIGUREDFIELD
El valor del parámetro está compuesto por 4 valores separados por comas, a continuación se detallan los mismos:
...
Como se puede ver esta manera de configurar parámetros da cierta flexibilidad en caso de tener bien identificado un campo que se quiera manejar como constante y que aplique para una de las combinaciones anteriormente descritas. Sin embargo si se desea tener mayor flexibilidad es conveniente utilizar la configuración por XML que se detalla a continuación.
Configuración vía XML
Para las configuraciones a través de archivos XML tenemos más flexibilidad. Además no requiere de modificación alguna en la implementación de la librería por parte del cliente, ya que toda la configuración se hace por fuera.
La parte fundamental de este enfoque es el archivo XML, a continuación se muestra la estructura del mismo:
<?xml version="1.0" encoding="UTF-8"?>
<fields-configuration>
<preconfiguredField> <!-- This field is the originIndicator -->
<fieldNumber>105</fieldNumber>
<fieldValue>2</fieldValue>
<originator>
<originatorId></originatorId>*
<node>
<nodeId>100</nodeId>
</node>
</originator>
</preconfiguredField>
</fields-configuration>
El archivo está compuesto por un tag principal llamado fields-configuration este tag contendrá cada uno de los campos previamente configurados que serán identificados con el tag preconfiguredField. La estructura de cada campo se muestra a continuación:
Nombre del Tag | Definición | Valores disponibles |
fieldNumber | Representa el número del campo que se mandará a VTOL | Se debe incluir un número entero de acuerdo a las especificaciones del manual así como los campos disponibles para su recepción en VTOL. |
fieldValue | Representa el valor del campo que se manda a VTOL | Cualquier valor que coincida con el tipo de dato y tamaño definidos en VTOL. |
Originador | Es un tag que representa al originador junto con los nodos que enviarán este campo. | Este tag representa como tal a un originador, que incluye tanto si ID como uno o más nodos. Los tags válidos son: originatorId, node. |
originatorId | Es el id del originador que enviará este campo. | Se puede indicar alguno de los siguientes valores: |
Node | Representa a un nodo como tal. | Pueden existir uno o más de estos elementos dentro del Nodo. Los tags váidos son: nodeId |
nodeId | Nodo para | Se puede indicar alguno de los siguientes valores: |
...
Nota |
---|
Nota: Es muy importante verificar que en el mismo directorio donde se están depositando tanto estas librerías como la del cliente de VTOL, no exista un JAR con una versión anterior a las provistas aquí. |
Âncora | ||||
---|---|---|---|---|
|
Los parámetros configurados se utilizan para proporcionar a VTOL una inicialización a través de un archivo de configuración que se encuentra en la misma ruta donde se encuentra la librería como tal.
...
Archivo Properties
El archivo de propiedades que se muestra a continuación incluye la un ejemplo de configuración tomando como referencia el ejemplo de inicialización de este documento.
HOSTIP = 127.0.0.1
HOSTPORT = 3000
TIMEOUTCONNECTIONHOST = 3000
RESPONSETIMEOUT = 3000
TIMEOUTEXPIRATIONNODE = 10000
TIMEOUTOBTAINNODE = 10000
USEVTOLCLIENTFINDER =
USEENCRYPTEDDATA = False
ENCRYPTKEY =
ENCRYPTER =
#Parameters for DynamicVtolClient initialization
TOTALNODESNUMBER = 5
DEFAULTTRANSACTIONSTATUS = C
Nota si se utiliza inicialización por archivo y por código, siempre se tomará en cuenta la del código antes que la del archivo externo.
En caso de que dicha configuración esté situada en otro directorio, se puede hacer uso del parámetro de configuración VTOLCLIENTLIBCONFIGPATH para indicar el directorio raíz.
Por ejemplo:
vtolClient.setParameter(VtolClientConstants.VTOLCLIENTLIBCONFIGPATH,"D:/client-lib/config/");
Como se puede observar, solamente se indica el PATH absoluto donde reside tal archivo de configuración.
Âncora | ||||
---|---|---|---|---|
|
La librería Java genera trazas para poder evaluar posibles comportamientos o errores.
...
[PATH_ABSOLUTO_ARCHIVO_CONFIGURACION] corresponde al path y nombre de archivo completos de donde se encuentra el archivo de configuración del logeo.
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
Âncora | ||||
---|---|---|---|---|
|
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMddHHmmss");
//creacion de forma estática del objeto StaticVTOLClient
StaticVTOLClient staticVTOLClient = (StaticVTOLClient)VTOLClient.getStaticVTOLClient();
//seteo de la tienda a utilizar
staticVTOLClient.setOriginator("1");
//seteo de parmatros, como ser conexión, timeout, encriptacion, etc.
staticVTOLClient.setParameter(VtolClientConstants.HOSTIP,"127.0.0.1");
staticVTOLClient.setParameter(VtolClientConstants.HOSTPORT,"3000");
staticVTOLClient.setParameter(VtolClientConstants.TIMEOUTCONNECTIONHOST,"3000");
staticVtolClient.setParameter(VtolClientConstants.RESPONSETIMEOUT,"10000");
staticVTOLClient.setParameter(VtolClientConstants.TIMEOUTEXPIRATIONNODE,"10000");
staticVTOLClient.setParameter(VtolClientConstants.TIMEOUTOBTAINNODE,"10000");
staticVTOLClient.setParameter(VtolClientConstants.USEVTOLCLIENTFINDER,"False");
staticVTOLClient.setParameter(VtolClientConstants.CLIENTFINDER,VtolClient.COMMITSTATUS);
staticVTOLClient.setParameter(VtolClientConstants.USEENCRYPTEDDATA,"False");
staticVTOLClient.setParameter(VtolClientConstants.ENCRYPTKEY,"synthesissynthesissynth");
staticVTOLClient.setParameter(VtolClientConstants.ENCRYPTER,"DESede");
//llamada al metodo que inicializa la librería, es acá donde se conecta a VTOL.
staticVTOLClient.init();
String dateTime = dateFormat.format(new java.util.Date());
//creacion de un nodo de VTOL. Hay que usar un nodo que este definido en VTOL.
VTOLNode _VTOLNode = staticVTOLClient.createNode("1");
//Puesta en uso del nodo.
_VTOLNode.setStatus(NodeStatus.INUSE);
//creación de una nueva transacción (se borraran los datos previamente cargados)
_VTOLNode.createTransaction();
//carga de los valores que se enviaran a VTOL dentro de la transaccion.
_VTOLNode.addField(11, "Sale");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(10, "Manual");
_VTOLNode.addField(6, "5432219380000102");
_VTOLNode.addField(7, "200612");
_VTOLNode.addField(8, "123");
_VTOLNode.addField(12, "1000");
_VTOLNode.addField(13, "$");
_VTOLNode.addField(14, "2");
_VTOLNode.addField(15, "0");
_VTOLNode.addField(63, "False");
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "DATA");
//envío de la transaccion esperando recibir una respuesta. Este método es bloqueante.
_VTOLNode.sendTransaction();
//Obtención de la respuesta al requerimiento enviada por VTOL.
Message responseMessage = _VTOLNode.getCurrentTransaction().getResponseMessage();
//forma de obtener un campo de la respuesta.
String _responseCodeString = responseMessage.getField(26).getValue();
if ( _responseCodeString.equalsIgnoreCase("ISO8583")) {
String _isoResponseCodeString = responseMessage.getField(27).getValue();
if ("00".equals(_isoResponseCodeString)) {//aprobada
String _transactionIdString = responseMessage.getField(24).getValue();
//creación de una nueva transacción (se borraran los datos previamente cargados)
_VTOLNode.createTransaction();
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "Data");
_VTOLNode.addField(11, "UnSyncCompletion");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(24, _transactionIdString);
_VTOLNode.addField(19, "Commit");
System.out.println("Commiting trxId: " + _transactionIdString);
//envío de la transaccion. No se espera respuesta. Este método es NO bloqueante.
_VTOLNode.sendTransactionWithoutResponse();
}
}
//Liberacion del nodo para futuro uso.
_VTOLNode.setStatus(NodeStatus.AVAILABLE);
Âncora | ||||
---|---|---|---|---|
|
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMddHHmmss");
//creacion de forma estática del objeto DinamicVTOLClient
DinamicVTOLClient dinamicVTOLClient = (DinamicVTOLClient)VTOLClient.getUniqueInstanceOfVTOLClient();
//seteo del Originador o Tienda
dinamicVTOLClient.setOriginator("1");//Tienda
//carga de los parametros de inicializacion.
dinamicVTOLClient.setParameter(VtolClientConstants.HOSTIP,"127.0.0.1");
dinamicVTOLClient.setParameter(VtolClientConstants.HOSTPORT,"3000");
dinamicVTOLClient.setParameter(VtolClientConstants.TIMEOUTCONNECTIONHOST,"3000");
dinamicVTOLClient.setParameter(VtolClientConstants.RESPONSETIMEOUT,"10000");
dinamicVTOLClient.setParameter(VtolClientConstants.TIMEOUTEXPIRATIONNODE,"10000");
dinamicVTOLClient.setParameter(VtolClientConstants.TIMEOUTOBTAINNODE,"10000");
dinamicVTOLClient.setParameter(VtolClientConstants.USEVTOLCLIENTFINDER,"False");
dinamicVTOLClient.setParameter(VtolClientConstants.CLIENTFINDER,"");
dinamicVTOLClient.setParameter(VtolClientConstants.USEPENDINGAUTOMATIC,"False");
dinamicVTOLClient.setParameter(VtolClientConstants.USEENCRYPTEDDATA,"False");
dinamicVTOLClient.setParameter(VtolClientConstants.ENCRYPTKEY,"");
dinamicVTOLClient.setParameter(VtolClientConstants.ENCRYPTER,"");
//Valores de inicialización opcionales
dinamicVTOLClient.setParameter(VtolClientConstants.TOTALNODESNUMBER,"10");
dinamicVTOLClient.setParameter(VtolClientConstants.INITIALNODENUMBER,"3");
//Inicializacion de la libreria
dinamicVTOLClient.init();
String dateTime = this.dateFormat.format(new java.util.Date());
//Forma de obtener un node de forma dinámica.
VTOLNode _VTOLNode = dinamicVTOLClient.getNode();//POS
//creacion de una nueva transaccion.
_VTOLNode.createTransaction();
//carga de los valores a enviarse a VTOL de la transaccion.
_VTOLNode.addField(11, "Sale");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(10, "Manual");
_VTOLNode.addField(6, "5432219380000102");
_VTOLNode.addField(7, "200612");
_VTOLNode.addField(8, "123");
_VTOLNode.addField(12, "1000");
_VTOLNode.addField(13, "$");
_VTOLNode.addField(14, "1");
_VTOLNode.addField(15, "0");
_VTOLNode.addField(63, "False");
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "DATA");
//Envio de la transaccion. De esta manera se espera una respuesta por lo que el método será de forma bloqueante.
_VTOLNode.sendTransaction();
//forma de obtener la repuesta dado por VTOL.
Message responseMessage = _VTOLNode.getCurrentTransaction().getResponseMessage();
//forma de obtener un campo de la respuesta entregada por VTOL.
String _responseCodeString = responseMessage.getField(26).getValue();
if ( _responseCodeString.equalsIgnoreCase("ISO8583")) {
String _isoResponseCodeString = responseMessage.getField(27).getValue();
if ("00".equals(_isoResponseCodeString)) {//aprobada
String _transactionIdString = responseMessage.getField(24).getValue();
//creacion de una nueva transaccion. En este caso se va a confirmar la transaccion.
_VTOLNode.createTransaction();
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "Data");
_VTOLNode.addField(11, "UnSyncCompletion");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(24, _transactionIdString);
_VTOLNode.addField(19, "Commit");
//envio de una transaccion de forma NO bloqueante. No se espera respuesta.
_VTOLNode.sendTransactionWithoutResponse();
}
}
//Forma de devolver el nodo obtenido de forma dinamica.
dinamicVTOLClient.freeNode(_VTOLNode);
Âncora | ||||
---|---|---|---|---|
|
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyyMMddHHmmss");
//creacion de singleton del objeto VirtualVtolClientExample
VirtualVtolClientExample virtualVtolClient = (VirtualVtolClientExample) new VirtualVtolClientExample();
//seteo del Originador o Tienda
virtualVtolClient.setOriginator("1");//Tienda
//carga de los parametros de inicializacion.
virtualVtolClient.setParameter(VtolClientConstants.HOSTIP,"127.0.0.1");
virtualVtolClient.setParameter(VtolClientConstants.HOSTPORT,"3000");
virtualVtolClient.setParameter(VtolClientConstants.TIMEOUTCONNECTIONHOST,"3000");
virtualVtolClient.setParameter(VtolClientConstants.RESPONSETIMEOUT,"10000");
virtualVtolClient.setParameter(VtolClientConstants.USEVTOLCLIENTFINDER,"False");
virtualVtolClient.setParameter(VtolClientConstants.CLIENTFINDER,"");
virtualVtolClient.setParameter(VtolClientConstants.USEPENDINGAUTOMATIC,"False");
virtualVtolClient.setParameter(VtolClientConstants.USEENCRYPTEDDATA,"False");
virtualVtolClient.setParameter(VtolClientConstants.ENCRYPTKEY,"");
virtualVtolClient.setParameter(VtolClientConstants.ENCRYPTER,"");
//Valores de inicialización opcionales
virtualVtolClient.setParameter(VtolClientConstants.TOTALNODESNUMBER,"10");
virtualVtolClient.setParameter(VtolClientConstants.INITIALNODENUMBER,"3");
//Inicializacion de la libreria
virtualVtolClient.init();
String dateTime = this.dateFormat.format(new java.util.Date());
//creacion de un nodo de VTOL. Hay que usar un local con nodos definidos en VTOL.
VTOLNode _VTOLNode = virtualVtolClient.getNode();//POS
//creacion de una nueva transaccion.
_VTOLNode.createTransaction();
//carga de los valores a enviarse a VTOL de la transaccion.
_VTOLNode.addField(11, "Sale");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(10, "Manual");
_VTOLNode.addField(6, "5432219380000102");
_VTOLNode.addField(7, "200612");
_VTOLNode.addField(8, "123");
_VTOLNode.addField(12, "1000");
_VTOLNode.addField(13, "$");
_VTOLNode.addField(14, "1");
_VTOLNode.addField(15, "0");
_VTOLNode.addField(63, "False");
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "DATA");
//Envio de la transaccion. De esta manera se espera una respuesta por lo que el método será de forma bloqueante.
_VTOLNode.sendTransaction();
//forma de obtener la repuesta dado por VTOL.
Message responseMessage = _VTOLNode.getCurrentTransaction().getResponseMessage();
//forma de obtener un campo de la respuesta entregada por VTOL.
String _responseCodeString = responseMessage.getField(26).getValue();
if ( _responseCodeString.equalsIgnoreCase("ISO8583")) {
String _isoResponseCodeString = responseMessage.getField(27).getValue();
if ("00".equals(_isoResponseCodeString)) {//aprobada
String _transactionIdString = responseMessage.getField(24).getValue();
//creacion de una nueva transaccion. En este caso se va a confirmar la transaccion.
_VTOLNode.createTransaction();
_VTOLNode.addField(3, "VTOL");
_VTOLNode.addField(4, "Data");
_VTOLNode.addField(11, "UnSyncCompletion");
_VTOLNode.addField(25, dateTime);
_VTOLNode.addField(24, _transactionIdString);
_VTOLNode.addField(19, "Commit");
//envio de una transaccion de forma NO bloqueante. No se espera respuesta.
_VTOLNode.sendTransactionWithoutResponse();
}
}
...