GESREST

Instalação
Sage

Agosto 2016
O pacote GesRest II ....................................................................................................................... 3
Conteúdo..................................................................................................................................... 3
Acordo de licenciamento ............................................................................................................. 3
Instalação ....................................................................................................................................... 4
Cuidados iniciais ......................................................................................................................... 4
Instalação no servidor ................................................................................................................. 4
Instalação em rede ...................................................................................................................... 9
Configurações do backend – CONFIG.INI ................................................................................. 10
Log para ficheiro em backend/log .......................................................................................... 10
Configurações de acesso ao servidor de base de dados ....................................................... 10
Parametros de funcionamento das janelas ........................................................................... 10
Outros .................................................................................................................................... 11
Configurações do frontend – SDL.INI ........................................................................................ 12
Servidor MySQL ........................................................................................................................ 13
MySQL Workbench ................................................................................................................... 14
Analisador SAF-t ........................................................................................................................... 15
Licenciamento............................................................................................................................... 17

Pág. 2 / 17
O pacote GesRest II
PARABÉNS PELA SUA ESCOLHA!

Adquiriu o produto Sage GesRest II, uma ferramenta de gestão de alta qualidade e poderosa, que,
ao mesmo tempo, é de uso fácil e intuitiva. Desenvolvemos os nossos aplicativos com qualidade e
excelência e iremos fazer o melhor para continuarmos a oferecer software que satisfaça as suas
necessidades.

Os seus comentários e sugestões são bem-vindos.

Conteúdo
O pacote GesRest II contém um DVD com o setup de instalação e diversos manuais, incluindo
este manual de instalação, permitindo assim a instalação completa de todos os componentes
necessários ao correto funcionamento da aplicação.

Acordo de licenciamento
1. Os produtos Sage GesRest II estão licenciados para um ou vários postos, dependendo da
licença, podendo, desta forma, serem utilizados em sistemas de rede. Para instalar mais postos
que o permitido pela licença inicial é necessário adquirir uma licença de "Node Extra".

Para adquirir a referida licença, por favor contacte o seu fornecedor de software.

2. Copyright e outros direitos de autor: o software e a documentação são propriedade da Sage

Portugal - Software S.A., protegidos pelas Leis Portuguesas de Direitos de Autor. Deverá realizar
uma cópia do software unicamente para efeitos de cópia de segurança ou arquivo, podendo
transferir o software para um disco duro ou outro dispositivo de armazenamento desde que
mantenha na sua posse o dispositivo original com o software. A Sage Portugal - Software S.A.
retém todos os direitos, interesses e posse sobre o software, cópias do software e documentação
deste, reservando-se ainda no direito de alterar e/ou realizar o upgrade do software sem a
obrigação de notificar sobre estas modificações.

Está proibida a instalação do Software Sage GesRest II num disco rígido e utilizá-lo sem um
comprovante de autorização, utilização esta que só pode ser feita em estrita conformidade com as
instruções da Sage Portugal - Software S.A.

3. Restrições adicionais: não deve alugar, vender ou distribuir o software e/ou documentação. Não
pode transferir esta licença sem obter uma permissão por escrito da Sage Portugal - Software
S.A.. Não deve descompilar ou desassemblar este software, bem como modificar, traduzir ou criar
trabalhos derivados dele ou da sua documentação. Deve proteger este software e documentação
de publicações não autorizadas, uso, reproduções e/ou distribuição.

Pág. 3 / 17
Instalação

Cuidados iniciais
A instalação do GesRest II deverá ser feita no Windows 2000 SP4, ou posterior. Antes de iniciar a
instalação deverá desativar qualquer aplicação antivírus.

Em SO Windows XP, sugerimos a instalação do Microsoft Visual C++ 2008 Redistributable Package (X86)
http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=29

Instalação no servidor
Para proceder à instalação da aplicação Sage GesRest II execute o setup de instalação. Um
wizard irá ajudar neste processo…

A rotina de instalação sugere a diretoria C:\Sage\GesRest II como sendo a localização onde será
instalada a aplicação. Caso pretenda instalar noutra localização, clique em Procurar.

No ecrã seguinte escolha o tipo de configuração que pretende:

 Completa: para instalação da aplicação e MySQL

 Apenas GesrestII: para instalação da aplicação Gesrest II apenas

 Instalação customizada: para selecionar as funcionalidades que pretende instalar

Pág. 4 / 17
Clique Seguinte, poderá então ativar a criação de ícone de atalho no ambiente de trabalho..

Avançando será apresentado um resumo das configurações definidas…

Pág. 5 / 17
Dê início ao processo de instalação propriamente dito clicando Instalar… Assim que concluído o
processo será informado.

Pág. 6 / 17
Optando pela instalação completa a aplicação está “pronta” para arrancar, sendo o utilizador e
password MySQL root e rest, respetivamente; e a base de dados snatch. Por default estará
configurado o frontend SDLFE.EXE.

Estas parametrizações estão definidas no ficheiro CONFIG.INI da diretoria backend existente na

pasta de instalação.

Os componentes da aplicação (sagedm.exe e snatch.exe) “falam” através das placas de

rede, caso não haja placa de rede ativa não haverá meio de comunicação.

Em Sistemas Operativos Windows XP a placa de rede Microsoft Loopback Adapter não se

encontra instalada por default, assim sendo, caso não tenha placa de rede ativa deverá
proceder à sua instalação.

Para proceder à instalação da placa de rede Microsoft Loopback Adapter aceda à opção de
adição de novo hardware e selecione a instalação manual…

Selecione Network adapters e de seguida defina a instalação da placa de rede Microsoft Loopback
Adapter…

Pág. 7 / 17
Conclua o processo e reinicie a máquina…

Pág. 8 / 17
Instalação em rede
O processo de instalação num posto da rede é semelhante ao do servidor. No entanto, deverá ter
em atenção duas configurações - nº de posto e parametrização da conexão à base de dados.

No ficheiro CONFIG.INI do backend (diretoria backend da pasta de instalação) defina os

parâmetros para conexão à base de dados:

 host: IP da máquina servidor

 user: utilizador para acesso ao MySQL

 password: password de acesso ao MySQL

 database name: nome da base de dados

Quanto ao nº de posto, deverá ser criado um atalho para o backend – snatch.exe – indicando o
nº de posto e rede onde vai operar.

<pasta de instalação> snatch.exe <posto> <rede>

Se pretende usar o frontend em flash, além do atalho para o backend, no ficheiro CONFIG.INI do
frontend (diretoria frontend da pasta de instalação) defina:

 posid: nº do posto

 ip: IP da máquina servidor

Pág. 9 / 17
Configurações do backend – CONFIG.INI
No ficheiro de configurações do backend – ficheiro config.ini da diretoria backend da pasta de
instalação – podem ser definidas as seguintes parametrizações:

Os parâmetros precedidos do carater # serão considerados como comentários, sendo descartados pela aplicação.

Log para ficheiro em backend/log

"log_1": log genérico

"log_2": log licenças

"log_3": log assinaturas

"log_4": log assinaturas no hide message

"log_radio": log do radio

"log_call_stack": log das chamadas das funções - muito pesado

"log_db": log de base de dados

"log_critical": log de eventos críticos

"log_pedidos": log dos pedidos

"log_devices": impressoras e dispositivos

"jsontrace": mostra no ecran (com internalfe a zero) as mensagens trocadas com o frontend

"verbose_reports": mostra na linha de comandos os resultados das queries dos relatórios

"print_to_console": mostra mais informação na consola

Configurações de acesso ao servidor de base de dados

"host": IP do servidor de base de dados

"port": porta para ligação ao MySQL (0: por defeito, 3306 para mysql e 3307 para MariaDB)

"user": username da base de dados por defeito root

"password": password de acesso a base de dados por defeito rest

"databasename": nome da base de dados

Parametros de funcionamento das janelas

"jsoncompress": se comprime json a enviar para o FrontEnd (este parâmetro está já em

automático)

"broadcast": porta por onde é efetuado o broadcast

"broadcastip": IP por onde sai o broadcast (se não for configurado é 8080)

Pág. 10 / 17
"internalfe": se utiliza o frontend interno (por defeito é 1. Se for zero tenta lançar o que esta
configurado em frontend)

"frontend": caminho do exe do frontend ( SDLFE.exe ou caminho para chrome)

Outros

"initalldm": todos os potos inicializam os sagedm mesmo que sejam de postos diferentes

"pre_lock": as mesas são lockadas antes de se acederem

"day_close_screen": mostra Fecho Financeiro

"check_future_records": sempre que se fecha uma venda a aplicação verifica se existem vendas
posteriores (pode ser desativado para postos com relógio diferente)

"multiplica_peso": para balanças com problemas nas decimais como a Ruby 50 que coloca . às
vezes no final (ativo por defeito)

"add_remove_extras": nos Menus, retenta todos os artigos já encaixados

"buttons_use_description": os botões dos artigos mostram descrição completa em vez da

descrição curta

"no_update": se ativo não corre os scripts de upgrade de dados

"plu_search": se ativo ao clicar num espaço vazio na venda, apresenta ecran para pesquisar
artigos (ativo por defeito)

"lparam": muda identificação da máquina para leitura do MAC da placa de rede (usado em
maquinas com SSD ou SO que não retornem numero de serie dos discos)

"cliente_imprime_nome_curto”: imprime nome de cliente curto ou completo

"consumo_menus_usam_pvp_dos_niveis": se estiver ativo usa o preço definido no nível do menu

"grava_antes_de_pedir": grava a mesa antes de imprimir o pedido (ativo por defeito)

"mostra_valor": mostra valor dos extras na lista

"idc_mesa”: caracter de início que identifica cartão como cartão "Mesa"

"idc_cliente": carater de início que identifica cartão como cartão "Cliente"

"idc_artigo": carater de início que identifica cartão como cartão "Artigo"

"idc_empregado": carater de início que identifica cartão como cartão de "Empregado"

"todas_permissoes": como as permissões são diferentes com este setting ativo vê-se todas as
permissões

"limpa_mesas_vazias": limpa mesas vazias no arranque da aplicação

Pág. 11 / 17
"assina_desconto": desconto a aplicar quando se assina um cartão discoteca (se não definido é
100%)

"saft_path": caminho onde o saft vai ser gravado (se estiver definido dentro da configuração geral,
sobrepõe-se a este)

"art53": se o cliente estiver isento de iva ao abrigo do artigo 53, os motivos de isenções aparecem
apenas no final da conta e não em todas as linhas

"merge_terminal_empregado": se ativo, os artigos ficam agrupados mesmo se foram pedidos

noutro terminal o por outro empregado

"saft_use_netvalue": por defeito a exportação do saft calcula o net value a partir do valor da
venda. Se ativado, o saft vai buscar este valor à coluna net_value

"direct_table_close": não passa pelo ecran de seleção de método de pagamento e fecha logo

"discount_by_value": no fecho com desconto, se estiver ativo pede valor de desconto em vez de
percentagem

Configurações do frontend – SDL.INI

No ficheiro de configurações do frontend – ficheiro SDL.ini da diretoria frontend da pasta de
instalação – poderão ser definidas as seguintes parametrizações:

[X]: secção de configurações para o posto X

As restantes configurações deverão constar na secção do posto a que dizem respeito.

timeout "20": tempo ao fim do qual, caso não haja registos, o ecrã de registo é fechado

title_fontsize: títulos das janelas

label_fontsize: nomes das caixas de texto

def_fontsize: fonte default

mono_fontsize: previsualização de relatórios

text_fontsize: texto inserido nas caixas de texto

plu_fontsize: botões de artigos

alert_fontsize: mensagens de aviso

sdl_env "SDL_VIDEO_WINDOW_POS=0,15": posição onde “corre” a aplicação

Se pretender definir um 2º ecrã parametrize “1024,0” por exemplo, caso a resolução seja 1024.
noframe “1”: janela sem título e border

Conjugando com a parametrização sdl_env "SDL_VIDEO_WINDOW_POS=0,0" obterá fullscreen

em modo janela.

fullscreen: ecrã inteiro

Pág. 12 / 17
vncserver: posto é servidor VNC

yellowtable "0xFFFFFF": cor da mesa onde já foi emitido subtotal

greentable "0x0000FF": cor da mesa livre

table_fontsize: botões das mesas

O ficheiro SDL.INI poderá ser configurado executando o ficheiro SDLFE.EXE sem que seja
iniciado o backend.

Servidor MySQL
Caso tenha optado pela não instalação do MySQL pelo setup da aplicação, poderá proceder à sua
instalação manualmente…

http://www.mysql.com/downloads/mysql/5.1.html#downloads

Assim que concluída a instalação poderá proceder à configuração da instância MySQL…

Por default, a aplicação usa a password rest. Caso opte por uma outra terá que alterar posteriormente essa
parametrização no ficheiro backend\config.ini da pasta de instalação da aplicação GesRest II.

Ative a opção Include Bin Directory in Windows PATH

Pág. 13 / 17
MySQL Workbench
Para eventuais operações de manutenção da base de dados, deverá ser instalado o MySQL
Workbench.

http://www.mysql.com/downloads/workbench

Pág. 14 / 17
Analisador SAF-t
Para que possa analisar os ficheiros SAF-t gerados pela aplicação terá que instalar o Analisador
SAF-t.

O pacote de instalação está disponível no Portal MySage (Suporte Técnico – Outros Produtos – Downloads), bem como
no DVD do produto.
Deverá instalar o Analisador versão 3.0.0.4 ou posterior.

A 1ª vez que executar o Analisador SAF-t através da aplicação terá que efetuar as
respetivas configurações.

Por default será sugerida a pasta de dados C:\Sage Data, poderá no entanto indicar outra
localização.

Caso opte pela configuração default – C:\Sage Data – e a pasta não exista bastará confirmar a criação da mesma.

De seguida deverá selecionar o tipo de base de dados que pretende utilizador para o Analisador
SAF-t e confirmar a criação da base de dados…

Pág. 15 / 17
Assim que concluída a configuração será então aberto o analisador.

Pág. 16 / 17
Licenciamento
Ao aceder à aplicação será despoletado o wizard de licenciamento…

Clique Registar para avançar no wizard…O processo de licenciamento poderá ser efetuado por
ficheiro ou através da digitação de código e senha.

Optando pelo registo código/senha, para uma correta validação da licença, terá que ter ligação à
Internet ativa.

Para licenciar por ficheiro bastará indicar o nome do ficheiro que deverá constar na pasta backend
da pasta de instalação.

Pág. 17 / 17