Histórico da Página
Criando uma Atividade de Http - Chamada de API.
Utilize as Atividades Soap para testar suas API´s.
Interface de Programação de Aplicação cuja sigla API provém do Inglês Application Programming Interface, é um conjunto de rotinas e padrões estabelecidos por um software para a utilização das suas funcionalidades por aplicativos que não pretendem envolver-se em detalhes da do software, mas apenas usar seus serviços. No RM são exemplos: Consulta, inserções, deleções e alterações em alguns de seus cadastros ou até mesmo extração de informações.
...
- Após estar devidamente configurados conforme os requisitos deste tipo de Atividade carregue o Host do RM como Administrador.
- Vamos utilizar como exemplo a inclusão de uma nova moeda.
- O primeiro item que precisamos é a informação da chamada para o método POST da API de inclusão de moedas.
- As APIS´s do Host podem ser consultadas pelo swagger inserindo a URL a seguir em seu navegador
...
- e se essa página carregar, seu Host está corretamente configurado para o uso.
- Vamos utilizar em nosso exemplo o cadastro de Moedas do RM.
- Na página do swagger procure pelo item Currency. Clique sobre ele para que seja expandido. Note que existem vários métodos disponíveis. Iremos utilizar o POST, método que fará a inclusão da moeda.
- Selecione o método POST para que ele seja expandido. Role a tela até chegar na área PARAMETERS no campo em branco de nome RECORD. Vá ao campo imediatamente a direita que tem o nome BODY e clique sobre o schema para que ele seja transferido para o campo RECORD.
- Preencha todos os campos do cadastro ou somente os obrigatórios conforme imagem abaixo e clique no botão TRY IT OUT.
- Se tudo correr bem você receberá a resposta abaixo da imagem a seguir.
- Para criar sua Atividade acesso o TestFlow → Atividades → Serviços → Http. Preencha os dados de identificação (nome, permissões de acesso, versão e descrição e comportamento ao ocorrer erro).
- Em requisições clique no sinal de
- Na tela Método - URL informe o Verbo, a URL (conseguida na tela do swagger no navegador), Timeout, o status esperado no teste e uma descrição para a chamada como na imagem a seguir.
- Os itens: Autorização, Headers, Body, Queries e Cookies só devem ser preenchidos se sua chamada exigir. No caso do nosso exemplo a única exigida é a Autorização na qual devem ser informados os dados do usuário para acesso ao RM.
- Na guia BODY, escolha o Media Type application/json cole o o json criado na página do swagger.
- Navegue até a aba TESTE A REQUISIÇÃO. Selecione um servidor para execução. Lembrando que neste servidor o Agent do TestFlow deve estar em execução como Administrador. Clique aqui para mais informações sobre o agent.
- Clique no botão play e aguarde o resultado. Devem ser mostrados os dados que foram incluídos. Este é sinal de que sua requisição está correta e pronta para ser inserida em um Projeto ou Agendamento.
- Salve seu registro
<add key="WebServiceCulture" value="Invariant" />
<add key="DefaultDB" value="CorporeRM" />
<add key="HTTPPORT" value="8051" />
Através do swagger você poderá inclusive gerar o json do body da chamada.
Assim como toda Atividade no TestFlow 30 o Http também deve em seu header estar associado a um ou mais grupos e ter pelo menos um como administrador.
Logar o erro: O erro capturado na execução será apresentado no log do projeto e não impedirá a execução do restante do teste. O resultado final do seu teste será "Executado com erro".
Gerar erro de execução: O erro capturado na execução será apresentado no log do projeto e o restante do teste não será executado. O resultado final do seu teste será "Executado com erro".
Gerar alerta e continuar: O erro capturado na execução será apresentado no log do projeto, o restante do teste será executado normalmente. O resultado final do seu teste será "Executado com alertas".
Para incluir uma requisição clique no sinal mais (+) e preencha corretamente os parâmetros da sua chamada
Verbo HTTP: Informe a operação (POST, GET, PUT, PATCH, DELETE, HEAD)
Timeout (segundos): Informe o tempo de espera da requisição.
Status e retorno http esperado: Escolha na lista o código de retorno que a chamada deverá retornar para que seu teste tenha sucesso.
AUTORIZAÇÃO : Esta informação geralmente é obrigatório no RM. Então escolha o tipo Base e informe o usuário mestre e a senha totvs.
Os campos HEADERS, BODY, QUERIES E COOKIES não são obrigatórios e devem ser preenchidos de acordo com a necessidade da API.
Sua requisição pode ser testada clicando no botão TESTE A REQUISIÇÃO sem que a mesma tenha de ser incluída em um projeto de teste. Você também testá-la utilizando o Gerenciador de Execuções.
...
- .