DWSG
O presente documento apresenta um modelo para a representação de dados de serviços disponibilizados por Órgãos do Poder Público Brasileiro por Web Services. A apresentação deste padrão justifica-se pelas peculiaridades das informações mantidas em atividades das demandas de
Governo para Governo e pelas necessidades de interoperabilidade identificadas no Brasil. A especificação para a descoberta de serviços é uma demanda urgente e que proporcionará um significativo avanço na construção de porta de entrada única para localização de serviços.
A seguir são apresentadas as orientações e recomendações definidas pela especificação DWSG.
1. Informações gerais sobre os Web Services deverão ser disponibilizadas em uma ferramenta que possibilite a descoberta de serviços, sem restrição de acesso.
2. Os serviços devem ser catalogados por Órgão e por Sistema.
3. Os serviços devem ser agrupados por Descritor, que pode ser do tipo WSDL ou REST.
4. Para cada descritor deve ser informado o Nome, o Endereço Eletrônico, a Descrição e
Marcações que facilitem a identificação do serviço.
5. Para cada Descritor, também devem ser informados os Serviços nele disponibilizados, sendo que para cada Serviço deve ser informado o Nome, o Tipo de Retorno, a Descrição, os
Parâmetros de Entrada (Nome, Tipo e Descrição), as Exceções que podem ser lançadas
(Identificador e Descrição).
6. Os serviços poderão ser localizados através do Descritor, do Sumário ou por suas
Marcações.
7. Os Serviços devem ser disponibilizados num único local, que disponibilize as instruções de uso, sendo que para cada serviço devem ser disponibilizadas as seguintes informações: o
Nome do Sistema que ele está vinculado, o Nome do Serviço, o Órgão Responsável, a
Descrição do Serviço, o Descritor, a Identificação se o serviço é Público ou não, o tipo de
Descritor, o Endereço para acesso, os Parâmetros de Entrada, as Exceções e o Tipo de
Retorno.
8. Cada entidade será responsável