Oracle® Hospitality Simphony FIP – Peurto Rico Guia de Instalacion Release 2.7

July 2016

Copyright © 2016, Oracle and/or its affiliates. All rights reserved. This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited. The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing. If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable: U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government. This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.

Micros Simphony FIP - Puerto Rico Guía de Instalación Aplica a Micros Simphony 2.7 Impresoras compatibles con Micros

Importante: La información remarcada en amarillo

nueva

o

actualizada

será

Tabla de Contenido Extension Application ........................... 2 Variables IVU Loto – Headers y Trailers ......... 4 CAL Packages .................................... 5 Configuración del FIP ........................... 7 Micros IVU Loto Service ........................ 11 Configuración del Servicio ..................... 11

Pg.

1

Extension Application 1) Copiar el package completo a una carpeta dentro del Application Server. 2) Abrir EMC. 3) Seleccionar el Scope deseado para la configuración de los Extension Applications (puede ser a nivel Enterprise, Property o RVC). 4) Ir a la solapa Setup y luego en el grupo Custom Content elegir la opción Extension Application. 5) Crear un nuevo registro. Ingresar “FI” (sin comillas) en el campo Name y en el campo Description. 6) Ir al modo visual Form View haciendo doble click sobre el botón a la izquierda del número de registro (campo #) 7) Insertar los Application Content como se muestra en la imagen, a partir de los archivos copiados en el paso 1)

- Figura 1 -

Hay dos tipos de archivos que se deben agregar como Application Content: el SIM (Content Type 19 - SimScript) y las DLL (Content Type 3 - DLL). El registro 5 de la Figura 1 muestra el registro correspondiente a la carga del archivo FIPPuertoRico.isl, donde en el campo Option Bits se puede ver que hay un bit seleccionado (al presionar el botón de los puntos suspensivos se muestra el diálogo Extension Application Content Options donde para el caso del archivo FIPPuertoRico.isl se deberá seleccionar el bit Main SIM Content. Al generar un nuevo Application Content de tipo SIM Script, se deberá luego insertar el código, para lo cual se procede a hacer doble click sobre el registro recientemente Pg. 2

agregado (el 4 de la Figura 1) desplegando así la solapa Designer. Primero debemos elegir el Content Type de tipo SimScript, luego a la derecha encontraremos el link Import from file, que una vez clickeado sobre él, se abrirá el cuadro de diálogo para ubicar el archivo .isl correspondiente. En la Figura 2 se puede apreciar la solapa Designer del Application Content del código SIM.

- Figura 2 -

Pg.

3

Se debe especificar además el nombre de cada archivo en el campo Disk File Name. Al agregar todas las dll y el SIM a nivel BD, esto debería generar en los clientes activos (luego de un refresh / update de la BD cliente) una carpeta: x:\Micros\Simphony\WebServer\wwwroot\EGateway\Handlers\ ExtensionApplications\FI\, donde finalmente aparecerán copiados todos los archivos correspondientes a los Application Content Agregados (exceptuando el .isl).

Variables IVU Loto – Headers y Trailers Para que los datos obtenidos de Nº de IVU Loto y Fecha de Transacción puedan ser impresos en el header / trailer, éstos deben ser configurados para aceptar los datos e incluirlos en la impresión. Para ello se deben utilizar dos variables predefinidas que serán incluidas en las líneas de header/trailer de los tipos de cupones deseados (Guest Check, Customer Recipt, etc.). Las variables son: @@ivu_loto y @@ivu_loto_date, que serán reemplazadas al momento de la impresión por los datos Nº de IVU Loto y Fecha de Transacción, respectivamente.

Pg.

4

CAL Packages Para el caso del archivo de configuración FIPPuertoRico.dll.config se debe generar un CAL Package. Desde la solapa Home y a nivel Enterprise, acceder a la solapa Setup y luego seleccionar la opción CAL Packages. Una vez allí, crear un nuevo registro al que se podrá llamar FIP Puerto Rico. El campo Platform Type debe indicar la plataforma del cliente (tipo de terminal), por ejemplo Win32 Client si la terminal tiene un sistema operativo Windows Embedded POSReady 2009. Finalmente indicar el nombre de la carpeta desde donde se copiarán los archivos hacia el cliente, en nuestro caso puede ser FIPPuertoRico (ver Figura 3). Una vez generado procedemos a la pantalla en formato Form View.

- Figura 3 -

Pasar a la vista de tipo Form View para poder agregar en el área de Deployments los paquetes a copiar. Desde el link Add se permite el agregado de nuevos paquetes. Se debe agregar uno nuevo cuyo Deployment Type indique el Scope de la instalación: si es a nivel Property / Enterprise o bien para un Host Específico, a indicar luego, en el campo Service Host. El campo Action to Take debe decir Install.

Pg.

5

Una vez configurado, generar FIPPuertoRico2.0 dentro de la ruta:

una

carpeta

llamada

x:\MICROS\Simphony\EgatewayService\CAL\Win32\Packages, donde deberán ser copiados los archivos de configuración y de comandos CAL: FIPPuertoRico.dll.config y setup.dat respectivamente. El archivo de configuración se encuentra dentro de la carpeta: FIP\Application Content\Wxx, donde xx indica la plataforma (W32 o Wce); mientras que el archivo de comandos CAL se ubica dentro de la carpeta: FIP\CAL\ Finalmente se debe correr la instalación CAL del lado del cliente para que también se copie el archivo de configuración.

Pg.

6

Configuración del FIP El archivo de configuración de los parámetros del FIP es el FIPPuertoRico.dll.config. Se detallan a continuación los campos que lo componen. Sección “Options”  IN_DEBUG_MODE: Si se activa, el FIP escribirá información extra de depuración en el log de errores del FIP. Ingrese “true” para activar, “false” para desactivar. Nota: esta soporte.

opción

solo

debe

ser

activada

por

personal

de

 SHOW_VERSION: Si se activa, el FIP mostrará por pantalla la versión del assembly cada vez que se inicialice la terminal. Ingrese “true” para activar, “false” para desactivar.  TAX_IS_INCLUSIVE: Especifica si los impuestos configurados en la BD de Micros son de tipo “Inclusive” o no. Ingrese “true” para activar, “false” para desactivar. (Esta opción debería estar desactivada si se están utilizando impuestos de tipo “Add On”).  PRINT_MERCHANT_COPY_RECEIPT: Determina si debe ser impresa o no una copia del recibo de IVU Loto para la tienda. Ingrese “true” para activar, “false” para desactivar. Sección “IVU LOTO”  REQSERVER_SERVER_IP: Dirección IP del servidor donde está corriendo Micros IVU Loto Service.  REQSERVER_SERVER_PORT: Puerto de escucha del servicio Micros IVU Loto Service. Por default 7511.  REQSERVER_RESPONSE_TIMEOUT: Tiempo máximo de espera de respuesta con el Nro. de IVU Loto proveniente desde el servicio Micros IVU Loto Service.

Pg.

7

 IVU_LOTO_OFF: Activa o desactiva la solicitud de generación de Nro. de IVU Loto. Ingrese “true” para desactiva IVU Loto, “false” para dejarlo activo.  DATE_FORMAT: Formato de fecha utilizado para impresión de la fecha de transacción de un Nro. Loto. El formato puede ser definido siguiendo standards de formato aceptado en el lenguaje C#. default el valor es MMM dd yyyy hh:mm:ss Ej.: Jan 13 2014 10:07:51 PM.

la IVU los Por tt.

 USE_CHECKOPENTIME_AS_TRANSACTION_DATE: Si se active, se utiliza la fecha de creación del cheque de micros como fecha de transacción del Nro. IVU Loto, caso contrario se utiliza le fecha del sistema al momento de imprimir el cheque. Ingrese “true” para activar, “false” para desactivar.  MERCHANT_ID / END_MERCHANT_ID: Identificado de Tienda por RVC. Se pueden definir distintos MerchantIDs para diferentes RVC. El formato de configuración es el siguiente: MERCHANT_ID =; ;…; … =; ;…; END_MERCHANT_ID  TERMINAL_PASSWORD / END_TERMINAL_PASSWORD: Identificador de las claves y sus correspondientes terminales. Se puede tener una clave para una sola terminal, o bien una clave para múltiples terminales. Formato: TERMINAL_PASSWORD = ;…; … = ;…; END_TERMINAL_PASSWORD  IVU_SHOW_FAILURE_MESSAGE: Si se activa, serán mostrados por pantalla todos los mensajes de error ante cualquier falla en la generación de un Nro. IVU Loto. Ingrese “true” para activar, “false” para desactivar. Pg.

8

 FIRST_TENDER_ALWAYS: Si se activa, será enviado siempre el primer tender encontrado en la solicitud de generación de un Nro. de IVU Loto. Caso contrario se enviará siempre el tender IVU Loto con valor UNKNOWN (6). Ingrese “true” para activar, “false” para desactivar.  IVU_TENDER_CASH_OBJ_NUM_LIST: Listado de todos los tenders de Micros que se corresponderán con el tender de IVU LOTO de tipo CASH. Formato: ; … ;  IVU_TENDER_DEBIT_OBJ_NUM_LIST: Listado de tenders de Micros que se corresponderán con de IVU LOTO de tipo DEBIT. Formato: ; … ;  IVU_TENDER_CREDIT_OBJ_NUM_LIST: Listado de tenders de Micros que se corresponderán con de IVU LOTO de tipo CREDIT. Formato: ; … ;

todos los el tender

todos los el tender

 IVU_TENDER_ATH_OBJ_NUM_LIST: Listado de todos los tenders de Micros que se corresponderán con el tender de IVU LOTO de tipo ATH. Formato: ; … ;  IVU_TENDER_EBT_OBJ_NUM_LIST: Listado de todos los tenders de Micros que se corresponderán con el tender de IVU LOTO de tipo EBT. Formato: ; … ;  IVU_TENDER_UNSPECIFIED_CARD_OBJ_NUM_LIST: Listado de todos los tenders de Micros que se corresponderán con el tender de IVU LOTO de tipo UNSPECIFIED. Formato: ; … ;  IVU_TENDER_UNKNOWN_CARD_OBJ_NUM_LIST: Listado de todos los tenders de Micros que se corresponderán con el tender de IVU LOTO de tipo UNKNOWN. Pg.

9

Formato: ; … ;  TIME_ZONE_OFFSET: Valor de offset en horas para adicionar a la fecha de transacción y convertirla de UTC/GMT a Local Time. Un monto cero significará que la conversión a Local Time será automática por sistema.

Pg.

10

Micros IVU Loto Service Se debe instalar al servicio Micros IVU Loto Service en algún servidor con conexión a Internet y accesible desde todas las terminales. Este será el encargado de recibir desde las terminales las solicitudes de generación del Nro. de IVU LOTO, conectarse al Web Service para su obtención y luego devolver el resultado a la terminal de origen. Para instalarlo basta con ejecutar el archivo Setup.exe que se encuentra dentro de la carpeta IVULotoService, en el package de distribución. Una vez instalado el servicio, el puerto por default de escucha será el 7511. Si se requiere, este puede ser modificado en el archivo de configuración IVULotoService.exe.config, ubicado en la carpeta de la unidad donde está instalado el sistema operativo (por lo general c:\>). Basta con cambiar el valor del campo SERVER_TCP_PORT y luego reiniciar el servicio Micros IVU Loto Service. Luego deberá hacerse lo propio con la configuración del cliente. NOTA: Es muy importante que todas las terminales tengan acceso irrestricto al servidor donde se instale Micros IVU Loto Service, por lo que en caso de existir un Firewall, éste debe permitir el acceso de entrada y salida hacia el puerto de escucha del servicio (por default el 7511, pero puede ser modificado tanto en el cliente como en el servicio). En caso de no poder establecerse la conexión entre un terminal y el servicio, se recomienda probar primero desactivando el firewall para ver si el problema está en las restricciones del acceso al servidor.

Configuración del Servicio El archivo de configuración (formato XML) del servicio Micros IVU Loto Service se ubica en la carpeta de instalación del mismo, que será en el disco root del sistema operativo Windows; por lo tanto si el S.O está instalado en el disco c:\, entonces la ruta completa del archivo será: c:\FIP\IVULoto\IVULotoService\IVULotoService.exe.config Pg.

11

El archivo permite configurar los siguientes parámetros:  IN_DEBUG_MODE: Si se activa, habilita un mayor nivel de mensajes registrados en el log provenientes desde el módulo cliente del web service TxPort. “True” para activar, “False” para desactivar.  SERVER_TCP_PORT: Puerto de escucha para la recepción de solicitudes de generación de Nro. de IVU Loto proveniente desde las terminales. Por default 7511. Si se modifica este valor, deberá hacerse lo propio desde el lado cliente.  TXPORT_SERVER_URL: URL de acceso al web service TXPORT de generación de Nro. IVU Loto. Su valor por default es: https://txportwst.txhubpr.com:8443/txserver/1.  VERBOSITY_LEVEL: Especifica el nivel de registro de eventos en el archivo LOG. Posibles valores aceptados: “0” o “5”. Cuando el nivel es el menor, sólo se registran mensajes de error. Cuando se sube el nivel al valor máximo, se registran eventos de tipo informativos. NOTA: Cualquier modificación a estos parámetros requerirá que el servicio Micros IVU Loto Service sea reiniciado.

Pg.

12