Serviços DeCS
De Wiki REDDES
| español | english |
Tabla de contenidos |
Formas de acesso
O serviço DeCS permite a recuperação remota, via chamada http, de seus conceitos através de três tipos de busca: a busca hierárquica, a busca por palavras e a busca por palavras com operadores booleanos.
Busca hierárquica
Permite a recuperação de termos no DeCS através do seus códigos hierárquicos. O código hierárquico é passado através do parâmetro “tree_id”.
Quando tal parâmetro é vazio, como na url:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=
o serviço produz as categorias hierárquicas de primeiro nível do DeCS.
Quando, por exemplo, o código hierárquico "B01.050.150.900.649.801.400.112.199.120.510.550" é utilizado:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=B01.050.150.900.649.801.400.112.199.120.510.550
recupera-se o conceito “Macaca mulatta”.
O idioma do conteúdo do resultado da pesquisa pode ser especificado, acrescentando-se na url o parâmetro “lang” com o valor “pt” para português (&lang=pt), “es” para espanhol (&lang=es) ou "en" para inglês (&lang=en). Quando não especificado, o idioma escolhido como padrão é o português (&lang=pt).
A pesquisa anterior com o conteúdo em espanhol teria a seguinte url:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=B01.050.150.900.649.801.400.112.199.120.510.550&lang=es
Busca por palavras
Permite através do parâmetro “words”, a pesquisa de “palavra a palavra”, as quais são internamente conectadas com o operador AND.
Na url abaixo:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?words=Macaca mulatta
a expressão "Macaca mulatta" é internamente convertida para "Macaca AND mulatta".
A busca por palavras é realizada no índice contendo os termos autorizados, os termos sinônimos e os termos históricos do DeCS, todos indexados com a técnica de indexação palavra a palavra.
Assim como na busca hierárquica, o parâmetro "lang" pode ser utilizado para se especificar o idioma do conteúdo do resultado da pesquisa, sendo o português o idioma padrão utilizado caso o parâmetro não tenha sido especificado.
Busca por palavras com operadores booleanos
Permite o uso de uma expressão booleana, através do parâmetro de busca “bool”, onde os termos são conectados por operadores booleanos AND, OR e AND NOT tal como no exemplo abaixo:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=macaca AND mulatta
Pode-se especificar qual o índice em que será feita a pesquisa, colocando-se o código do mesmo (veja “Prefixos dos índices de pesquisa” abaixo) como prefixo da expressão de busca:
<prefixo do índice> <expressão de busca>
Exemplos com operadores e índices
A pesquisa:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=101 Macaca OR 101 mulatta
procura os termos “macaca” ou “mulatta” no índice criado por campo inteiro tendo somente termos autorizados.
Se ao invés do prefixo 101 se usasse o prefixo 407 (palavra a palavra, termo autorizado, termos sinônimos e termos históricos) seriam recuperados também, além de “Macaca”, os termos “Macaca mulatta”, “Macaca nemestrina” e “Macaca radiata”.
Se não for especificado o código do índice a ser pesquisado, o índice utilizado como padrão será o de palavra a palavra, termo autorizado, termos sinônimos e termos históricos (valor 407).
Se a expressão de busca não contiver operadores booleanos, então a mesma será considerada como sendo campo inteiro.
Portanto, a url:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=Macaca mulatta
não retornará nada, pois considera a expressão “Macaca mulatta” como sendo campo inteiro e pesquisa como um termo do índice que foi indexado palavra a palavra.
Já a url:
http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=107 Macaca mulatta
recupera “Macaca mulatta”, pois o termo aparece no índice indexado com campo inteiro.
Prefixos dos índices de pesquisa:
101 - campo inteiro, termo autorizado
102 - campo inteiro, termos sinônimos
104 - campo inteiro, termos históricos
103 - campo inteiro, termo autorizado e termos sinônimos
105 - campo inteiro, termo autorizado e termos históricos
106 - campo inteiro, termos sinônimos e termos históricos
107 - campo inteiro, termo autorizado, termos sinônimos e termos históricos
401 - palavra a palavra, termo autorizado
402 - palavra a palavra, termos sinônimos
404 - palavra a palavra, termos históricos
403 - palavra a palavra, termo autorizado e termos sinônimos
405 - palavra a palavra, termo autorizado e termos históricos
406 - palavra a palavra, termos sinônimos e termos históricos
407 - palavra a palavra, termo autorizado, termos sinônimos e termos históricos
Nota: um prefixo de índice de pesquisa se aplica ao termo de pesquisa que o segue.
Descrição do resultado em XML
O resultado de uma chamada dos serviços DeCS é um arquivo XML. Para o melhor entendimento do significado das tags que constituem o mesmo, criou-se um exemplo comentado do resultado de busca "107 macaca mulatta".
Aplicação gráfica para visualização dos Serviços DeCS
Criou-se uma aplicação gráfica que roda no desktop visando facilitar o uso e o entendimento dos parâmetros de chamada dos Serviços DeCS.
Requisito: máquina virtual Java versão 1.5 ou superior.
Download: DeCSClient.jar
Chamada: Em máquinas 32 bits - bastam dois cliques no arquivo jar. Em máquinas 64 bits usar o comando: java -jar DeCSClient.jar
Linguagem de Descrição de Serviços Web (WSDL)
Para acessar os serviços DeCS via protocolo SOAP, deve ser utilizada a seguinte WSDL.
Chamada dos Serviços DeCS a partir de uma linguagem de programação
Pode-se fazer a chamada dos serviços DeCS a partir de uma linguagem de programação sem o uso do protocolo SOAP. Possíveis funções que chamam os serviços diretamente são exemplificadas abaixo para as linguagens PHP, Python e Java.
