Scribd
Upload
7 views13 pages

XML Integration Guide for Henry Service

This document provides instructions for integrating the Henry XML service with a bakery system using XML files. It describes how to install and configure the service, defining parameters such as IP, port, and directory paths. The XML files must have attributes that identify orders and their status. By generating the files, the bakery system will allow the Henry XML service to control customer access.

Translated by

ScribdTranslations
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
7 views13 pages

XML Integration Guide for Henry Service

This document provides instructions for integrating the Henry XML service with a bakery system using XML files. It describes how to install and configure the service, defining parameters such as IP, port, and directory paths. The XML files must have attributes that identify orders and their status. By generating the files, the bakery system will allow the Henry XML service to control customer access.

Translated by

ScribdTranslations
Copyright
© All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd

XML Integration Henry

Henry Integration Department


Introduction

This manual contains information about the integration of


Xml application Service Henry through XML with bakery system
using the configurations that will be presented in this
document.
Installation of the XML Service Henry
*** Note: the configuration files must be in /format type: ITF - 8 encoding (without BOM) ****

First we need to download the xml application, here is the link to


download:

[Link]
%20service%[Link]?dl=0
after downloading the application, unzip it, copy the folder
unpacked and paste the pastaxml service on disk C, as per
image:

Make sure there are no subfolders named xml service inside the folder.
main xml service in order not to change the default directory path of the
application.

After that, we will carry out the configuration to perform the


communication like the equipment, but first we must carry out
the configuration [Link] which is located in the conf folder

Open with text editor


we recommend using the Notepad++ software to edit files
configuration to avoid file format problems:

Localize the following parameter:

Insert the path of java in this command


[Link]=<caminho do java>, conforme
image below, pointing to the location where Java is installed on
your computer:

* to see the path go to the JAVA control panel *


Save this file.
Note that the path should use \\ for defining the path of
application and java.

it should not contain the # before the start of the command, otherwise the parameter will be
considered a comment, disregarding the configuration made.
The name of the service is Xml Service Henry and the application
together with the configuration file is in the folder of
application inside the 'xml app' folder.

Configuration for XML application communication


Service Henry with the command collector Henry

Access the folder where the Henry application for integration is.
via Xml, the file is located inside the xml service folder >
xml app, open the file with notepad++
Open the file with Notepad++:

Note: IP without leading zeros e.g. [Link]

Legends of the parameters:


IP: IP configured on the collector that will perform the communication of
equipment with the application Xml Service Henry;

port: Port configured on the equipment to perform the


communication.

open_time:Tempo em que o acesso fica liberado

Command to turn the relay on / off, example:


REON means 'relay on' or 'turn on'

These are the relays that will be activated.

event_ok_access:Identificador de evento para acesso liberado

msg1_ok:Mensagem 1 (que aparece na tela) para acesso


released

msg2_ok:Mensagem 2 (que aparece na tela) para acesso


released

msg1_exp_ok:Mensagem de complementação da mensagem 1


msg2_exp_ok=Mensagem de complementação da mensagem
2

"msg1_nok","msg2_nok":",
"msg1_exp_nok":"msg2_exp_nok"= São as mensagens para
access denied, that's why it has 'nok' in the field name instead of
ok

I will point out the main configurations that must be


changed to enable communication between the application and the
order collector.

"sem_xml_comanda": "liberar"= Se houve a consulta pela Xml


service henry and not find the requested command, it will be
release the exit, if found, will check the status of the order
to release or deny the turn / exit at the turnstile.

"delete_xml": "false" ou "true"=Se encontrar um xml


blocked, delete all blocked xmls.

“limpar_xmls”:"false" ou "true":Se encontrar um xml liberado,


exclude all xmls from the order

"xmls_dir":”xmls”= Caminho da pasta dos xmls”. Não pode ter


accentuation, examples of places (use /) to indicate the way
from folder, example: C:/xml service

After making the changes to the file, click to save


Installing the XML Service Henry

Configured to communicate with the collector of


Command, let's install the service that will run on startup
the computer's operating system.

Locate the pastaxml service > bat

Inside the pastabat, locate the installService file

Run the same as administrator to install the service.

Wait for the conclusion.


After that, click to run as administrator on the option
startService

Wait for the service to start.

After this procedure, the operating system will execute


pressing the Windows key + R

type the command: [Link]

Localize the Xml Service Henry and open it.


Each line of the XML will have an attribute ID_COMANDA and a
EVENT attribute.

Change the service startup type to automatic (delayed)


at startup) and click on the apply option.

Go to the recovery tab, change the setting to restart the service.


in the first, second, and third failure:

Após realizar clique na opçãoaplicar.


We completed the configuration and installation of the Xml service.
Service Henry
Integration Via XML

The files generated / manipulated by the bakery software


should contain the following format:

The attribute ID_COMANDA is the number of the card that will be


used by the equipment.

The EVENT attribute can have two conditions of


valores:CouL. O valorCrepresenta a criação de uma comanda
of consumption and the value represents that the bill has been paid and the
the consumer will be able to deposit their voucher in the box
collector chest.

It is possible to use more than one XML file or even


even with more than one command registered in the same file, if
to prefer.
Whenever one of these events occurs, the system that
you will need to generate this information in a file
XML in a specific directory, which can be modified within.
in the file [Link], in the field specified as xmls_dir
as per the image below: Note: leave the path of the xml free
C:\xml service\xml app\xmls not to put folder/folder/folder...etc

When specifying the file path, it must not contain


accentuation.

Examples of file paths:

After reading the information, the XML file may be


off.

important: whenever you make any changes to the


configuration of configuration files, stop the serviceXml
Service Henrye restart.
In the command collector, you will be able to check if there was the
connection to the application successful accessing the webserver
in the Configuration > Info: this option will show the IP of
server/pc that is connected to the collection turnstile:

see if the connector really works after debug


run console.
Revision___________________________________08/08/2019

Inclusion of new system features________10/01/2020

You might also like