O que
...
é?
...
A atividade de
...
SOAP no TestFlow é
...
uma ferramenta que permite testar e automatizar chamadas a WebServices SOAP, facilitando a integração e validação de processos.
Para que
...
serve?
Serve para planejar, organizar e documentar testes do TestFlow , garantindo que todas as funcionalidades de testes automatizados sejam verificadas de acordo com critérios específicos, como :
- Definir critérios claros de sucesso e falha para cada funcionalidade testada.
- Identificar e detalhar as condições prévias necessárias para a execução dos testes.
- Fornecer uma estrutura clara de passos a serem seguidos durante os testes.
- Estabelecer os resultados esperados para cada teste.
Exemplo de Uso
Através deste cadastro você poderá organizar e planejar seus Projetos de Teste automatizados antes mesmo de criá-los.
Este cadastro está divido da seguinte maneira:automatizar o teste e a execução de WebServices SOAP, incluindo registros, processos e outros serviços oferecidos pelo sistema RM.
Deck of Cards |
---|
|
Card |
---|
label | Como Cadastrar | Exemplo de uso |
---|
| 1.Navegue no menu do TestFlow e clique em Casos de Teste.Image RemovedAtividades → Serviços → Soap. Image Added 2. Na tabela que será mostrada, clique no botão verde em destaque para Criar Atividade de Soap. Image Removed Preencha o cabeçalho ;Informações:Image Added
3. Preencha os campos:
Nome:Adote um padrão nomenclatura que propicie uma rápida e fácil identificação de seu objetivo.Tamanho 256 caracteres.Image Removed Descrição:- Aqui você poderá detalhar mais seu caso de teste.
- Tamanho 512 caracteres.
Image Removed c. Criticidade: Baixa, Média ou Alta de acordo com suas necessidades. Image Removed Permissões:- Aqui você poderá determinar qual ou quais grupos terão acesso ao seu Caso de Teste e ainda se poderá alterá-lo ou não. Este campo será desabilitado ao associar um projeto de teste no registro. Após feita esta associação seu Caso de teste passará a ter as mesmas permissões do Projeto de Testes nele associado.Image RemovedImage Removed
Projeto de Teste: - Após finalizar a criação de seu Caso de Teste e você construir o Projeto de Testes referente a ele faça esta associação. Você pode também associar um Projeto de Teste já existente. A associação é de 1 para 1. Posteriormente se necessitar esta associação poderá ser desfeita.
- Se for associado um Projeto de Teste a um Caso de Teste:
- Se existirem permissões por grupo de usuário elas serão sobrepostas pelas permissões do Projeto de Teste.
- Se não existirem permissões serão gravadas as do Caso de Teste.
- Se for retirada a associação de Projeto de Teste de um Caso de Teste::
- Se já existiu alguma permissão por grupo de usuário elas serão restauradas.
- Se não existirem o usuário será obrigado a informar um outro projeto ou novas permissões por grupo de usuário.
Pré-condições: - Relate aqui tudo que é necessário para uma correta execução de seu Caso de Teste e posterior Projeto de Teste. Ex.: Uma versão específica de um servidor de banco de dados, Algum registro pré-existente, etc.
- Tamanho 1024 caracteres.Image Removed
Passos:- Detalhe cada ação que é necessária ser executada para seu Caso de Teste ou Projeto de Testes seja completado com sucesso. Inclua detalhadamente quantos passos necessitar. Você pode excluir algum se necessitar ou ordená-los.
- Na tabela que será mostrada , clique no botão verde para incluir passo.Image Removed
- Caso queira remover algum passo, clique no botão vermelho em destaque:Image Removed
Resultados:- Informe os resultados esperados no seu Caso de Teste. Se preferir você pode inserir um link para uma planilha por exemplo.
- Tamanho 1024 caracteres.Image Removed
Assim que o cadastro for finalizado e salvo, você poderá : - Filtrar Nome do Caso de Teste.
- Filtrar Projetos de Teste Vinculados.
- Filtrar versões dos projetos de teste vinculados.
- Filtrar Grupos.
Image RemovedImage Removed Observação:Filtros possíveis na visão de Casos de Teste.- Nome do Caso de Teste
- Nome do Projeto de Teste associado ao Caso de Teste
- Versão do Projeto associado ao caso de Teste
- Grupo de usuários. Nesta caso quando o Caso de Teste possuir um Projeto de Teste associado o grupo filtrado será do do Projeto.
- Ainda é possível ordenar a visão pelo nome do Caso de Teste ascendente ou descendentemente
Observação:- O registro de Caso de Teste só poderá ser salvo se todos os campos obrigatórios estiverem preenchidos. Para facilitar a visualização dos campos não preenchidos será acrescentado um sinal de exclamação na seção que contém algum campo obrigatório vazio. Ela só desaparecerá após preencher os campos obrigatórios.
Image Removed | Card |
---|
| Para ajudar na criação dos seus casos de teste seguem abaixo algumas melhores práticas.Imagine que você seja o analista responsável pelo produto de construção, e uma nova ferramenta chamada 'tipo de característica' foi implementada. É crucial certificar-se de que essa ferramenta esteja funcionando corretamente. Image Removed Para isso, é necessário executar um projeto de teste para validar o processo. Dessa forma, contamos com as seguintes condições: Image Removed Para isso, foi desenvolvido um projeto de teste que inclui uma atividade específica para realizar a requisição do cadastro de tipo de característica via SOAP. Antes de iniciar o projeto de teste, é importante preparar a documentação de teste criando o seu caso de teste. Image Removed Permissões
Image Removed Observação: - Assim que o projeto de Teste for vinculado, as permissões serão autenticadas automaticamente.
Projeto de teste Image Removed Pré-Condições Image Removed PassosImage Removed ResultadosImage Removed
|
Filtros possíveis na visão de Casos de Teste.
- Nome do Caso de Teste
- Nome do Projeto de Teste associado ao Caso de Teste
- Versão do Projeto associado ao caso de Teste
- Grupo de usuários. Nesta caso quando o Caso de Teste possuir um Projeto de Teste associado o grupo filtrado será do do Projeto.
- Ainda é possível ordenar a visão pelo nome do Caso de Teste ascendente ou descendentemente
Observação:
- O registro de Caso de Teste só poderá ser salvo se todos os campos obrigatórios estiverem preenchidos. Para facilitar a visualização dos campos não preenchidos será acrescentado um sinal de exclamação na seção que contém algum campo obrigatório vazio. Ela só desaparecerá após preencher os campos obrigatórios.
Saiba mais
Dica |
---|
Utilize um padrão de nomenclatura que facilite a rápida e fácil identificação do objetivo do teste. |
Dica |
---|
Os Casos de Teste não são versionados. |
Dica |
---|
Se o caso de teste estiver associado a um projeto de teste, um botão para edição será exibido. Se o projeto de teste tiver várias versões, será necessário escolher qual versão editar. |
FAQ
Expandir |
---|
title | Propriedades customizáveis |
---|
| d.
|
|
Card |
---|
label | Link para Definir cabeçalho (Nome e nível de acesso) |
---|
|
|
Card |
---|
label | Exemplo de Variáveis |
---|
|
|
Card |
---|
| Expandir |
---|
title | Criando Atividade de Soap |
---|
| - Após estar devidamente configurados conforme os requisitos deste tipo de Atividade carregue o Host do RM e o RM.exe como Administrador e faça o login no último.
- Acesse a URL do webservice do Host (http://localhost:8051/wspageindex/). Se a página abaixo for exibida suas configurações estão corretas.Image Added
- Vamos usar como exemplo o processo de inclusão de uma Unidade de Medida
- O primeiro passo é analisar o cadastro que queremos fazer pelo WebService para coletar algumas informações ao seu respeito:
- Quais dados serão inseridos.
- Qual é o DataServer do cadastro. Quando se tratar de processos precisamos do DataProcess (veremos isto no próximo exemplo). Para descobrir qual é o DataServer do cadastro, vá na aba de edit ou na aba de cadastro de um registro, clique em qualquer um de seus campos da tabela fornecida e pressione a combinação de teclas: CRTL + ALT+ F9.
Image Added - Munido do DataServer e já conhecendo o cadastro vamos descobrir qual o método do WebService utilizaremos para incluir um registro neste cadastro. Para isso precisamos de um XML.
- Baixe em seu computador um aplicativo que se chama SoapUI (Baixe aqui) . Nela podemos inserir a URL do WebService do host para saber qual método utilizar para incluir nosso registro
- Após instalar, abra o aplicativo e no menu File escolha New Soap Project.Image Added
- Escolha um nome como por exemplo Cadastros do RM e na Inicial WSDL cole a seguinte URL: http://localhost:8051/wsDataServer/MEX?wsdl. Lembre-se que neste momento o host deve estar em execução na máquina (localhost).Image Added
- Após confirmar se tudo correr bem serão apresentados na tela os métodos existentes no WebService dos DataServers do RM .Image Added
- Como não conhecemos o XML para inclusão de registros, vamos buscar um que já existe na tabela para que sejam retornados seus dados e seu XML. Desta forma podemos somente substituir os dados do registro que carregamos pelos dados que queremos incluir. Para carregar registros pelo WebService utilizamos o método ReadRecord. Clicando com o botão direito sobre o método escolhemos a opção New Request, dê um nome para ela e clique no botão OK.Image Added
- No XML apresentado preencha a tag DataServerName com o nome conseguido no item 2.a.ii. Digite da mesma maneira que apareceu na tela com "camel case". Preencha a tag Primary Key que, no caso do cadastro de Unidades de Medida, é somente o Código da Unidade. Vamos utilizar M (Metros).Image AddedImage Added
- Preencha a autenticação com usuário que utiliza para acessar o RM. Para isso, vá em Auth → Add New Authorization → Basic. Não se esqueça de marcar a opção Authenticate pre-emptively. Feche a tela de autenticação e clique no botão Play. Image Added
- Será apresentado o XML com o registro desejado. Guarde esse XML que iremos precisar dele para a inclusão do registro.Image Added
- Para a inclusão no SoapUi escolha o método SaveRecord, clique com o botão esquerdo e escolha New Request. Dê um nome para a requisição e clique em OK.Image Added
- Na tela que será apresentada preencha a tag DataServerName com o mesmo dataserver que utilizou no Read Record.
- Na tag XML informe o conteúdo que foi retornado do Read Record copiando da expressão"<![CDATA[ até ]]>. Após isso altere os dados antigos para os dados do novo registro. Sua requisição deve ficar como na figura a seguir.Image Added
- Para a tag Contexto as informações de CODSISTEMA e CODUSUARIO são obrigatórias. O CODSISTEMA você pode conseguir editando um registro do cadastro, clicando com o botão direito do mouse sobre a tela e selecionando a opção "Visualizar nome dos campos". Ao passar o mouse sobre qualquer campo será mostrada uma expressão com duas palavras. A primeira é o nome da TABELA (TUNIDADE) a segunda o nome do campo. A primeira letra da tabela é o CODSISTEMA, no caso T. O restante da informação você consegue acessando o RM e clicando no botão SISTEMA no canto inferior esquerdo da tela.Image AddedImage Added
Neste caso teremos como contexto o CODSISTEM=T; CODUSUARIO=mestre. Preencha o restante do envelope. - Se desejar preencha a autenticação e teste a requisição. Mas da maneira que está já pode ser transferida para a Atividade de Soap no TestFlow. Se houver sucesso na inclusão será retornado o ID o registro incluído.
- Image AddedImage Added
- Criando a Atividade de Soap no TestFlow
- Acesse : Atividades → Serviços → Soap e crie um novo registro.
- Preencha um nome que descreva sua Atividade e preencha o grupo e as permissões de acesso.
- Informe a versão desejada e uma descrição detalhada pela qual qualquer um que editar a Atividade consiga entender seu propósito. Informe também qual será o comportamento no caso de ocorrer erro de execução.
- Clique no botão RECUPERAR OPERAÇÕES, informe o servidor no qual o Agent do TestFlow está sendo executado. Clique aqui para mais informações sobre o agent. Informe a URL do WebService o Host do RM. http://localhost:8051/wsDataServer/MEX?wsdl. Clique em RECUPERAR para que os métodos do WebService sejam apresentados.Image Added
- Clique em RM_IwsDataServer para expandir os métodos. Escolha o método SaveRecord e clique no sinal de +. Do lado direito da tela expanda a requisição criada no lado esquerdo da tela. Dos campos que já são apresentados preenchidos o único a ser editado é o Soap Endpoint. Altere a URL, substituindo o nome de máquina que aparecer por LOCALHOST. Desta forma sua requisição irá executar em qualquer máquina e não somente na que foi apresentada. Informe a descrição de sua requisição. Isto é útil caso sejam criadas mais de uma requisição na mesma Atividade. Escolha o código de retorno. Para operações de inserção, geralmente o código retornado é 201 (Created), porém isto depende muito de quem codificou a chamada. Pelo SoapUi dá para saber qual é ao executar a chamada. No caso da unidade de medida o retorno de sucesso é 200.Image Added
- Na aba MENSAGEM cole o envelope de requisição que foi criado no SoapUI. Copie todo o XML e cole na área de edição.
- Na aba AUTENTICAÇÃO, informe o usuário e senha para execução da chamada. É o mesmo usuário que você utiliza para acessar o RM. O campo domínio não é obrigatório.
- Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.Image Added
- Salve sua Atividade e ela está pronta para para ser executada ou inserida em um Projeto, Agendamento ou Coleção.
Para criar chamadas SOAP para processos do RM. - Acesse o RM e execute o processo desejado manualmente. Vamos escolher um processo simples para sermos mais didáticos: Ajuste a Valor Presente
- Acesse a guia Gestão Financeira e na aba Contas a Pagar/Receber, escolha a opção Ajuste a Valor Presente e informe o dados solicitados e clique no botão executar e aguarde o processo ser executado.Image Added
- Após finalizar o processo com sucesso acesse a aba Ambiente e em seguida o item Gerenciamento de Jobs. Crie um filtro para trazer somente os jobs processados hoje para facilitar a localização do registro desejado.Image Added
- Edit o registro desejado e na guia Processo anote o valor do campo Classe do Processo, que neste caso é FinAVPData.Image Added
- No botão Anexos, abra o item de menu XML de Parâmetros de Job, copie o XML que vai ser apresentado e reserve.Image Added
- No SoapUI no menu Project crie um New SOAP Project
- Insira um nome: Processos RM
- Informa a Initial WSDL http://localhost:8051/wsProcess/MEX?wsdl
- No projeto criado navegue até RM_IwsProcess → ExecuteWithXmlParams. Clique com o botão direito sobre e escolha New Request. Dê um nome a ela e clique em OK
- Será mostrado um envelope. Na tag ProcessServerName informe a classe de processo copiada no item 5.d FinAVPData.
- Na tag strXmlParams informe a seguinte string: <![CDATA[****]]>
- Substitua os asteriscos da string acima pelo XML que salvou no item 5.d
- Preencha a autorização, navegando no menu. Para isso, vá em Auth → Add New Authorization → Basic, insira suas credenciais e clique na opção "Authenticate pre-emptively". Por fim, execute a chama para testar.
- Na janela a direita deve ser retornado o valor 1 se houve sucesso.
- Image AddedImage Added
- Após conseguir êxito na chamada você já tem tudo que necessita para criar sua atividade.
- Acesse o TestFlow → Atvidades → Serviços → Soap e clique no sinal de para incluir um novo registro.
- Preencha um nome que descreva sua Atividade e preencha o grupo e as permissões de acesso.
- Informe a versão desejada e uma descrição detalhada pela qual qualquer um que editar a Atividade consiga entender seu propósito. Informe também qual será o comportamento no caso de ocorrer erro de execução.
- Clique no botão RECUPERAR OPERAÇÕES, informe o servidor no qual o Agent do TestFlow está sendo executado. Informe a URL do WebService o Host do RM. http://localhost:8051/wsProcess/MEX?wsdl. Clique em RECUPERAR para que os métodos do WebService sejam apresentados.Image Added
- Clique em RM_IwsProcess para expandir os métodos. Escolha o método ExecuteWithXmlParams e clique no sinal de e uma requisição será criada do lado direito da tela. Após isso, expanda-a.
- Dos campos que já são apresentados preenchidos o único a ser editado é o Soap Endpoint. Altere a URL, substituindo o nome de máquina que aparecer por LOCALHOST. Desta forma sua requisição irá executar em qualquer máquina e não somente na que foi apresentada. Informe a descrição de sua requisição. Isto é útil caso sejam criadas mais de uma requisição na mesma Atividade. Escolha o código de retorno. Para operações de inserção geralmente o código retornado é 201 (Created), porém isto depende muito de quem codificou a chamada. Pelo SoapUi dá para saber. qual é ao executar a chamada. No caso do nosso exemplo é 200.Image Added
- Na aba MENSAGEM cole o envelope de requisição que foi criado no SoapUI. Copie todo o XML e cole na área de edição.
- Na aba AUTENTICAÇÃO, informe o usuário e senha para execução da chamada. É o mesmo usuário que você utiliza para acessar o RM. O campo domínio não é obrigatório.
- Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.Image Added
|
|
|
Saiba mais
FAQ
Informações |
---|
P: Quais são os códigos de retorno comuns e o que eles significam? R: 201 (Created): Inserção bem-sucedida. 200 (OK): Sucesso na execução da requisição. P: ? R: Deve ser incluído um Ambiente para cada versão do RM que você deseja testar. P: ? R: Sim, você pode se utilizar das propriedades customizáveis para montar, por exemplo, caminhos de diretórios dinamicamente |
Informações |
---|
P: Como defino a Criticidade do Caso de Teste? A criticidade pode ser classificada como Baixa, Média ou Alta, conforme a importância e o impacto do caso de teste nos requisitos do sistema. P: Como posso garantir que meu Caso de Teste seja eficaz? Para garantir a eficácia do caso de teste, certifique-se de que ele cubra todos os cenários possíveis, incluindo casos de uso críticos, exceções e integrações com outros sistemas. P: Por que devo usar um padrão de nomenclatura para o Nome do Caso de Teste? R: Um padrão de nomenclatura facilita a identificação rápida e clara do objetivo do caso de teste, tornando a organização e a busca mais eficientes. P: O que acontece com as Permissões quando um Projeto de Teste é associado? R: Se um projeto de teste for associado, as permissões do projeto sobreporão as do caso de teste. Caso a associação seja desfeita, as permissões originais do caso de teste serão restauradas. P: Quais são os desafios comuns ao criar e manter Casos de Teste? R: Alguns desafios comuns incluem manter os casos de teste atualizados conforme o software evolui, garantir cobertura completa de testes e ajustar casos de teste conforme novos requisitos são adicionados ou alterados.. |