Linha RM

Atalhos

Páginas filhas
  • 7 - Soap - Cópia

Versões comparadas

Versão antiga 21

changes.mady.by.user David Lucena Mariz

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user David Lucena Mariz

Gravado em

Chave

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

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
idComo cadastrar

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.

Informações

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

Passos

Image Removed

Resultados

Image Removed

Card
labelComo Cadastrar Exemplo de uso

1.Navegue no menu do TestFlow e clique em

Casos de Teste.Image Removed

Atividades → 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:


    Expandir
    titleNome de exibição

    a.

    Nome:

     

  • Adote um padrão nomenclatura que propicie uma rápida e fácil identificação de seu objetivo.

    • Expandir
    titlePermissões de Gupos
    Tamanho 256 caracteres.Image Removed

    b.

    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:

        • Se seu Caso de Teste possuir um Projeto de Teste a ele associado na visão será apresentado um botão para edição do mesmo. Se este Projeto de Teste possuir mais de uma versão você terá de escolher qual versão irá editar

    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
    labelExemplo prático

    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
    titleDiretório

    c. 


    Expandir
    titlePropriedades customizáveis

    d.


    Card
    labelLink para Definir cabeçalho (Nome e nível de acesso)






    Card
    labelExemplo de Variáveis


    Card
    labelExemplo prático
    Expandir
    titleCriando Atividade de Soap
    1. 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.
    2. 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
    3. Vamos usar como exemplo o processo de inclusão de uma Unidade de Medida
      1. O primeiro passo é analisar o cadastro que queremos fazer pelo WebService para coletar algumas informações ao seu respeito:
      2. Quais dados serão inseridos.
      3. 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

      1. 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. 
      2. 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
      3. Após instalar, abra o aplicativo e no menu File escolha New Soap Project.Image Added
      4. 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
      5. Após confirmar se tudo correr bem serão apresentados na tela os métodos existentes no WebService dos DataServers do RM .Image Added
      6. 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
      7. 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
      8. 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
      9. Será apresentado o XML com o registro desejado. Guarde esse XML que iremos precisar dele para a inclusão do registro.Image Added
      10. 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
      11. Na tela que será apresentada preencha a tag DataServerName com o mesmo dataserver que utilizou no Read Record.
      12. 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
      13. 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.
      14. 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.                                                                                 
        1.     Image AddedImage Added
    2. Criando a Atividade de Soap no TestFlow
      1. Acesse : Atividades → Serviços → Soap e crie um novo registro.
      2. Preencha um nome que descreva sua Atividade e preencha o grupo e as permissões de acesso.
      3. 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.
      4. 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
      5. 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
      6. 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.
      7. 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.
      8. Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.Image Added
      9. 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.

    1. Acesse o RM e execute o processo desejado manualmente. Vamos escolher um processo simples para sermos mais didáticos: Ajuste a Valor Presente
    2. 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
      1. 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
      2. Edit o registro desejado e na guia Processo anote o valor do campo Classe do Processo, que neste caso é FinAVPData.Image Added
      3. 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
      4. No SoapUI no menu Project crie um New SOAP Project
        1. Insira um nome: Processos RM
        2. Informa a Initial WSDL http://localhost:8051/wsProcess/MEX?wsdl
        3. 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
        4. Será mostrado um envelope. Na tag ProcessServerName informe a classe de processo copiada no item 5.d FinAVPData.
        5. Na tag strXmlParams informe a seguinte string: <![CDATA[****]]>
        6. Substitua os asteriscos da string acima pelo XML que salvou no item 5.d
        7. 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.
        8. Na janela a direita deve ser retornado o valor 1 se houve sucesso.                                                                                                                                                                                                                                                         
        9.    Image AddedImage Added
        10. Após conseguir êxito na chamada você já tem tudo que necessita para criar sua atividade.
        11. Acesse o TestFlow → Atvidades → Serviços → Soap e clique no sinal de  (mais) para incluir um novo registro.
        12. Preencha um nome que descreva sua Atividade e preencha o grupo e as permissões de acesso.
        13. 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.
        14. 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
        15. Clique em RM_IwsProcess para expandir os métodos. Escolha o método ExecuteWithXmlParams e clique no sinal de (mais) e uma requisição será criada do lado direito da tela. Após isso, expanda-a.
        16. 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
        17. 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.
        18. 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.
        19. Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.Image Added

    Saiba mais

    Dica


    Dica


    Dica

    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..