Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Conteúdo

  1. Habilitar o plug-in
  2. Serviços
  3. Teste de funcionamento da API
  4. Configurando de acesso no aplicativo

1. Habilitar o plug-in


  • Instalar o Plug-in do “Staff 4.0 Mobile”, pelo módulo “Global”.
  • Não é preciso realizar a autorização o plug-in STAFF 4.0 Mobile, somente instalar. 
  • Como realizar a instalação. → Mais informações ← O passo 04. AUTORIZAÇÃO DE EXECUÇÃO DE PLUG-INS. Não precisa ser executado.

2. Serviço


  • A aplicação está disponível no pacote de Serviços disponível na Central de Downloads da TOTVS.


2.1. Serviços de Aplicação - APIs


Para que o APP STAFF 4.0 Mobile funcione nos smartphones ou tablets, será necessária à instalação dos serviços abaixo:

  • HotalAuth_api.exe - Serviço responsável pela regra de autenticação da TOTVS. Ex: Validação do usuário e senha digitado, listar hoteis e empresas disponíveis para uso do APP.
  • Staff_api.exe - Serviço responsável por toda a regra de negócio do APP STAFF 4.0. Ex: Lista de Quartos, ações de liberação de quarto, bloqueio, dentre outras.

Mais informações de como configurar


3. Teste de funcionamento da API


Com a instalação e configuração das APIs mencionadas no item 2 e 2.1, o próximo passo será a realização dos testes de conexão com a API.

Existem dois comandos que devem ser executados, em um navegador de internet, para garantir que outros ambientes consigam consumir a API.

São eles:

URL:http://ip:porta/hotal/auth/v1/ping - Ex: 192.168.0.99:900/hotal/auth/v1/ping

URL:http://ip:porta/hotal/staff/v1/ping - Ex: 192.168.0.99:900/hotal/staff/v1/ping


Será exibido no vídeo, a seguir, como realizar os testes com os dois comandos disponibilizados acima:

O que será exibido?

  • Execução das URLs pelo navegador Google Chrome.
  • Um ambiente em que as executáveis das APIs foram instaladas como serviço do Windows. Logo, durante o vídeo, as APIs não estarão abertas em tela.
  • Evidência de que ambos os serviços estão sendo executados em segundo plano.
  • Explicação de onde buscar o IP do servidor de aplicação.
  • Execução das URLs no navegador.
    • Teste em um IP correto e porta incorreta. 
    • Teste em um IP + Porta corretos, tentando acessar o serviço incorreto.
    • Teste em um IP + Porta corretos, com o serviço parado no serviço do Windows.
    • Retorno positivo e um negativo.


Informações
  • Caso o retorno do teste seja negativo, faz-se necessário validar com o time de TI do hotel, as regras de segurança do firewall, liberação das portas, liberações de MAC, dentre outras regras. 
  • Enquanto o retorno no navegador não for positivo, o APP do STAFF não funcionará.
  • Após o retorno for positivo, o APP pode ser configurado. 

4. Configuração de acesso no aplicativo


  • Com a execução dos itens 2, 2.1 e 3 o próximo passo será o apontamento das configurações dentro do APP STAFF 4.0. 
  • Garanta que o APP esteja instalado no equipamento, acesse-o e execute a configuração.


Será exibido no vídeo, a seguir, como realizar o apontamento do IP e Porta no APP:

O que será exibido?

  • APP aberto no emulador.
  • Acesso a opção de configuração.
  • Apontamento do IP e Porta liberados no APP.
  • Retorno positivo - Serviço do Windows em execução.
    • Tempo de retorno rápido.
    • Mensagem de sucesso.
  • Retorno negativo - Serviço do Windows parado.
    • Tempo de retorno de até 20 segundos. 
    • Crítica informando falha na autenticação.
  • Retorno negativo - IP informado incorretamente.
    • Tempo de retorno de até 40 segundos. 
    • Crítica informando falha na autenticação.