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 RM.
   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. Será apresentado o XML com o registro desejado. Guarde esse XML que iremos precisar dele para a inclusão do registro.
   10. 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. 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 inclúidoincluído.Image AddedImage Modified
       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 caso teremos como contexto o CODSISTEM=T; CODUSUARIO=mestre.
       5. No SoapUi escolha o método Save