Script do Postman para validar ambientes Protheus com Meu RH - Ionic 5

01. VISÃO GERAL

Com intuito de validar o ambiente dos clientes para o funcionamento correto com a nova versão do aplicativo Meu RH utilizando o Ionic 5, foi desenvolvido um script do Postman que simula o comportamento do app.

02. POSTMAN

Para utilizar a ferramenta, é necessário:

1- Realizar o download do Postman através do link:
https://www.postman.com/downloads/

2- Após a instalação do software, fazer o download do script de execução. Existem dois tipos de scripts. Um deles simula o comportamento do app realizando as chamadas para as API’s (Meu RH - Ionic 5):

Meu_RH_-_Ionic_5_-_Protheus.postman_collection.json

03. UTILIZANDO O POSTMAN

1- Ao abrir o Postman e clicar no menu File >> Import

2- No lado esquerdo, será exibido o script com o nome “Meu RH - Ionic 5 - Outside”. Ao clicar com o mouse em cima do script, será aberto as configurações:

3- Selecionar a aba “Variables”, onde serão exibidos os parâmetros para o script de execução:

base_url: A url REST responsável por realizar a requisição. Para conseguir esse valor basta:
-Abrir o Meu RH via portal,
-Abrir a opção de inspecionar os elementos (F12),
-Realizar um refresh da página (F5)
-Selecionar a aba “Network” ou “Rede”
-Filtrar por “isLogged”
-Nesse caso a url completa seria http://localhost:8103/restT1/auth/isLogged
1 - Explicando os itens de montagem da URL.

1.1 - base_url → http://localhost

1.2 - rest_Port → Porta do REST conforme o AppServer.ini do cliente. Buscar essa informação da tag HTTPREST. No exemplo acima, a porta é a 8103.

1.3 - rest_URL → URL do rest conforme AppServer.ini do cliente. Buscar essa informação da tag HTTPENV ou HTTPURI do ambiente do cliente. No exemplo acima, é restT1.

1.4 - full_url → será montada automaticamente conforme os dados postados nos itens 1.1, 1.2 e 1.3.

user: Usuário utilizado para realizar o login
password: Senha utilizada para realizar o login
host: Domínio de acesso.

OBS: Preencher os valores nas colunas “INTIAL VALUE” e “CURRENT VALUE”

4- Depois de preencher os parâmetros, salve o arquivo (CTRL + S) e execute o script:

5 - Para executar o script, clique nos 3 pontinhos ( ... ) e realize o processo conforme o print abaixo.

6- Caso tudo esteja OK, todos os testes irão passar corretamente:

7 - Caso haja algum erro, o script irá apontar em qual requisição está dando problema. No exemplo abaixo, a senha do usuário foi digitada incorretamente. Com isso, impactou na geração do Token.

8- Para auxiliar na verificação dos erros, acessar o console:

Os itens analisados pelo script são:

- Se a comunicação entre o Client e o Server está funcionando corretamente.

- Se o login está sendo feito da maneira correta (Retornando o token de autenticação);

- Se existe algum problema de CORS (Repete a mesma requisição que o app realiza), além de verificar se os cabeçalhos estão corretos;

- Possível tela branca (Verifica se a API que checa se o usuário está logado, responde corretamente pois é a primeira API que impede o carregamento das outras no dashboard);

- Consumo de um serviço que exige autenticação (Serviço que retorna o contexto do usuário).