Texto

Guia de Orientação para Implementação de Web Services
Este documento apresenta alguns direcionamentos referentes à implementação de web services. É uma versão preliminar da construção do Guia de Orientação para Implementação de Web Services, resultante da discussão que está sendo realizada no âmbito da e-PING, com a participação do DSI/SLTI, SERPRO, COOPE, participantes e colaboradores do Grupo de Web services (http://i3gov.softwarepublico.gov.br/wikiws/wikka.php?wakka=ListaGrupo). Além das orientações para implementação de web services, o documento contém, nos anexos, alguns questionamentos acerca do conteúdo do guia, conceitos e exemplos concernentes a web services e um mapa de orquestração de serviços da AR.

Orientações para o a Implementação de Serviços Web
Para promover a interoperabilidade entre os diversos sistemas estruturadores de Governo indicase o uso de uma abordagem única para implementação de serviços Web. Com este objetivo, propõem-se algumas orientações: 1. Seguir os padrões preconizados pela e-PING (vide Tabela 1); 2. Gerar um arquivo XSD e referenciá-lo no WSDL, fazendo com que seja possível catalogar o XML Schema no catálogo de XML Schemas da e-PING; 3. No arquivo XSD gerado os elementos de dados de saída (output) do serviço não devem conter o atributo minOccur=0, ou seja, deve retornar sempre o mesmo conteúdo (o mesmo vocabulário), mesmo que para algumas tags, não existam dados (tag vazia); 4. Disponibilizar duas interfaces para a visualização do XML Schema: Web e através de SOAP UI; a) A interface web tem um objetivo didático para que os Gestores possam entender o que o serviço Web está provendo; b) Nessas interfaces as operações devem ser documentadas. c) Exemplos de interfaces web: http://www.siorg.redegoverno.gov.br/gestao/webservice/wssiorg.asmx http://www.consultacpf.com/webservices/consultacpf.asmx https://homsigplan.serpro.gov.br/xml/CargaAcompanhamento.asmx

1

5. No XML Schema devem-se criar comentários com breves descrições