Histórico da Página

Especifica a versão da atividade em questão. O objetivo de versionar uma atividade é para quando necessitamos ter mais de uma atividade em versões diferentes. Isso irá nos auxiliar a ter um histórico de atualizações e assegurar que as mudanças feitas sejam rastreáveis e reversíveis, se necessário.

Fornece uma descrição detalhada da atividade, explicando seu propósito e operações, facilitando a compreensão e manutenção futura.

Se ocorrer um erro durante a execução de alguma das requisições, o TOTVS Automação de Testes deve tomar medidas específicas para lidar com esse erro. As ações variam conforme o tipo e a gravidade do erro.

Logar o Erro: Caso ocorra um erro em alguma das requisições SOAP, o TOTVS Automação de Testes deverá registrar todas as informações relevantes sobre o erro no log de execuções.

• • • Exemplo: Se uma requisição SOAP falhar com um erro 500, o TOTVS Automação de Testes deverá registrar essas informações nos logs para análise posterior. A execução do processo não será finalizada

Gerar Erro de Execução: Caso ocorra um erro em alguma das requisições SOAP, o TOTVS Automação de Testes deverá lançar uma exceção que interrompa a execução do processo atual.

• • • Exemplo:  Se uma requisição SOAP falhar com um erro 500, o TOTVS Automação de Testes deverá registrar essas informações nos logs para análise posterior e a execução do processo será finalizada.  

Gerar Alerta e Continuar: Caso ocorra um erro alguma das requisições SOAP, o TOTVS Automação de Testes deverá registrar um alerta e continuar a execução das operações subsequentes. Isso permite que outros processos continuem sendo executados.

• • • Exemplo: Se uma requisição SOAP falhar com um erro 500, o TOTVS Automação de Testes deverá registrar um alerta sobre a execução da atividade e continuar processando outras operações relacionadas sem interrupção.

1. Após estar devidamente configurados conforme os requisitos deste tipo de Atividade carregue o Host do RMcomo Administrador.
2. Acesse a URL do webservice do Host (http://localhost:8051/wspageindex/).
   1. Se a página abaixo for exibida suas configurações estão corretas.
3. 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 relevantes:

1. 1. Quais dados serão inseridos.
   2. Qual é o DataServer do cadastro.
      1. Para descobrir qual é o DataServer do cadastro, vá até a aba de edição ou cadastro de um registro, clique em qualquer campo da tabela fornecida e pressione a combinação de teclas: CTRL + ALT + F9.

Resgate do XML:

1. De posse do DataServer e das informações do cadastro, vamos identificar o método do WebService que utilizaremos para incluir um registro. 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

Após instalar, abra o aplicativo e no menu File escolha New Soap Project.

4. Escolha um nome como, por exemplo Cadastros do RM, e na Inicial WSDL cole a seguinte URL: http://localhost:8051/wsDataServer/MEX?wsdl.

5. Após confirmar se tudo correr bem serão apresentados na tela os métodos existentes no WebService dos DataServers do RM .

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.

1. 1. 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.
   2. No XML apresentado, preencha a tag DataServerName com o nome obtido no item 3.b, exatamente como exibido na tela, em camel case.
   3. Para buscar a Primary Key do registro, entre no seguinte link: https://apitotvslegado.z15.web.core.windows.net/ e procure pelo Data Server resgatado anteriormente
   4. Logo em seguida, clique em EstUndData. Pode-se verificar que logo no cabeçalho da página contém as informações da Primary Key desse cadastro, no caso será CODUND.
   5. Na tag PrimaryKey, insira apenas o Código da Unidade para o cadastro de Unidades de Medida. Vamos utilizar "M" (Metros).
      
      
   6. Para a Tag Contexto, podemos resgatar essa informação na aba Sistema do RM, localizada no canto inferior esquerdo da tela.
      
      
      
      Defina o contexto com CODCOLIGADA=1
      
      
      
      

7. Preencha a autenticação com o usuário utilizado para acessar o RM. Para isso, siga os passos abaixo:

1. 1. Vá em Auth → Add New Authorization → Basic.
   2. Marque a opção Authenticate pre-emptively.
   3. Feche a tela de autenticação.
   4. Clique no botão Play.

1. 1. Será apresentado o XML com o registro desejado. Guarde esse XML que iremos precisar dele para a inclusão do registro.

      Inclusão do Novo Registro:

   2. 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.
   3. Na tela apresentada, preencha a tag DataServerName com o mesmo dataserver utilizado no Read Record.
   4. Na tag XML, informe o conteúdo retornado do Read Record, copiando da expressão <![CDATA[ até ]]>.
      Image Added
      
      
   5. Em seguida, altere os dados antigos para os novos. Sua requisição deve ficar conforme a figura a seguir:
      Image Removed
      

1. 1. . Insira os dados do registro que você quer criar, substituindo os dados do registro que foi lido no Read Record.
   2. Para a Tag Contexto, sera da mesma forma utilizada no Read Record.
      Defina o contexto com CODCOLIGADA=1. 

108. Preencha a autenticação e teste a requisição se desejar. Assim, a solicitação pode ser transferida para a Atividade de Soap no TOTVS Automação de Testes. Se a inclusão for bem-sucedida, o ID do registro será retornado.

1. Informe o servidor no qual o Agent do TOTVS Automação de Testes está sendo executado. (Clique aqui para mais informações sobre o Agent). Informe a URL do WebService: http://localhost:8051/wsDataServer/MEX?wsdl.
2. Clique em RECUPERAR para que os métodos do WebService sejam apresentados.
3. Clique em RM_IwsDataServer para expandir os métodos.
4. Selecione o método SaveRecord e clique no sinal de "".

1. No lado direito da tela, expanda a requisição criada.
2. Dos campos já preenchidos, o único que precisa ser editado é o Soap Endpoint.
3. Altere a URL, substituindo o nome da máquina que aparece por LOCALHOST. Dessa forma, sua requisição será executada em qualquer máquina, e não apenas na especificada.
4. Informe a descrição da sua requisição, o que é útil caso sejam criadas várias requisições na mesma atividade.
5. Escolha o código de retorno adequado. Para operações de inserção, geralmente o código retornado é 201 (Created), mas isso pode variar dependendo de quem codificou a chamada. No SoapUI, você pode verificar o código correto ao executar a chamada. No caso da unidade de medida, o retorno de sucesso é 200 (OK).
   
   1. 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.
   2. Na aba AUTENTICAÇÃO, insira o usuário e a senha utilizados para executar a chamada. Utilize as mesmas credenciais que você usa para acessar o RM. O campo de domínio não é obrigatório.

   3. Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.

   4. Salve sua Atividade e ela está pronta para para ser executada ou inserida em um Projeto, Agendamento ou Coleção.

1. 1. Acesse o RM e execute o processo desejado manualmente. Vamos escolher um processo simples para sermos mais didáticos:  Ajuste a Valor Presente
      1. Observação: Se o processo que você escolheu automatizar for necessário alguma intervenção manual para preenchimento de dados fora do passo a passo (Wizard) não será possível automatizar pelo método RM_IwsProcess.
   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.
2. Após finalizar o processo com sucesso, acesse a aba Ambiente e, em seguida, o item Gerenciamento de Jobs. Crie um filtro para exibir apenas os jobs processados hoje, facilitando a localização do registro desejado..
3. Edit o registro desejado e na guia Processo anote o valor do campo Classe do Processo, que neste caso é FinAVPData.
4. No botão Anexos, abra o item de menu XML de Parâmetros de Job, copie o XML que vai ser apresentado e reserve.

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

h. Na janela a direita deve ser retornado o valor 1 se houve sucesso. 

7. Após conseguir êxito na chamada você já tem tudo que necessita para criar sua atividade.

1. 1. Acesse o TOTVS Automação de Testes em Atvidades → Serviços → Soap e clique no sinal de   para incluir 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.

8. Clique no botão RECUPERAR OPERAÇÕES, informe o servidor no qual o Agent do TOTVS Automação de Testes está sendo executado. Informe a URL do WebService o Host do RM. http://localhost:8051/wsProcess/MEX?wsdl.

Clique em RECUPERAR OPERAÇÔES para que os métodos do WebService sejam apresentados.9. Clique em RM_IwsProcess para expandir os métodos.

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

1. 1. Dos campos que já são apresentados preenchidos o único a ser editado é o Soap Endpoint.
   2. 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.
   3. Informe a descrição de sua requisição. Isto é útil caso sejam criadas mais de uma requisição na mesma Atividade.
   4. 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.
   5. 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.
   6. 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.
   7. Na aba AÇÕES, você pode testar sua requisição ou deletar se for necessário.