Á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

...

  1. Serviços

...

Instalação | Configuração

...

Exemplo de Utilização

  1. Teste de funcionamento da API
  2. 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, 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ços

...

...

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

Image Added

...

2.1. Serviços

...

Baixe o pacote do serviço na Central de Downloads da TOTVS

Nome do pacote: INSTALAR_TOTVSHOTEIS_SERVICOS.exe

de Aplicação - APIs

...

Para que o APP Minha Governança 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. Ex: Lista de Quartos, ações de liberação de quarto, bloqueio, dentre outras.

Instale o pacote e configure o serviço. 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:9000/hotal/auth/v1/ping

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

Image Removed

Para realizar teste de Conectividade, basta acessar a URL:http://127.0.0.1:9002/hotal/staff/v1/ping 🌐

Image Removed

...

titleLINKS DE ACESSO 🌐:


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.

Image Added


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 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. 
  • Garanta que o APP esteja instalado no equipamento, acesse-o e execute a configuração.
  • Tenha em mãos o IP + Porta validados no item 3.
  • Acesse as configurações que estão na tela inicial do APP e informe o IP:PORTA - Ex: 192.168.0.158:9000


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 no APP.
  • Retorno positivo - Serviço do Windows em execução.
    • Mensagem - Tempo de retorno rápido.
    • Mensagem de sucesso.
  • Retorno negativo - Serviço do Windows parado.
    • Mensagem - Tempo de retorno de até 20 segundos. 
    • Crítica informando falha na autenticação.
  • Retorno negativo - IP informado incorretamente.
    • Mensagem - Tempo de retorno de até 40 segundos. 
    • Crítica informando falha na autenticação.

Image Added

     

...

...