Histórico da Página

...

1. Prepare seu ambiente
   1. Atualize o RM.
   2. Edit o arquivo de  config do Host, insira as keys para uso do WebService e salve o arquivo.
      1. 
   3. Carregue o Host do RM como Administrador.
   4. Crie um Alias para a base de dados com o mesmo nome informado no config do Host.
      1. 
   5. Acesse a URL do webservice do Host (http://localhost:8051/wspageindex/)
      1. Você deverá ver a seguinte página
2. 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:
      1. Quais dados serão inseridos
      2. 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, edit ou inclua um registro, clique em qualquer um de seus campos e pressione a combinação de teclas: CRTL + ALT+ F9
   2. 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. 
   3. Baixe em seu computador um aplicativo que se chama SoapUI. Nela podemos inserir a url do WebService do host para saber qual método utilizar para incluir nosso registro
   4. Após instalar, abra o aplicativo e no menu File escolha New Soap Project
   5. Escolha um nome como por exemplo Cadastros do RM e na Initial 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).
   6. Após confirmar se tudo correr bem serão apresentados na tela os métodos existentes no WebService dos DataServers do RMRM  .
   7. 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.
   8. 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)
   9. Preencha a autenticação com usuário que utiliza para acessar o RM. 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.                                                                                                                                                                   
   10. Será apresentado o XML com o registro desejado. Image Removed Guarde esse XML que iremos precisar dele para a inclusão do registro.Image Added 
   11. Para a inclusão
       1. 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  
       2. Na tela que será apresentada preencha a tag DataServerName com o mesmo dataserver que utilizou no Read Record.
       3. 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 Removed 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 RemovedImage Removed
       4. 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 pedindo que seja mostrado o 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. Neste                                                Neste caso teremos como contexto o CODSISTEM=T; CODUSUARIO=mestre. Preencha o restante do envelope.Image Added
       5. 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 AddedNo SoapUi escolha o método Save