Serviços DeCS

De Wiki REDDES

español english

Tabla de contenidos

Direito de acesso

Para proteção dos direitos de autor, os serviços web do DeCS são oferecidos gratuitamente por meio de uma licença de uso. Assim, pedimos que primeiramente preencha o nosso Formulário padrão pré-Licença de uso do DeCS.

Depois que recebermos esta informação, lhe enviaremos uma licença para cada idioma solicitado.


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.313.988.400.112.199.120.510.550" é utilizado:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=B01.050.150.900.649.313.988.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.313.988.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 fascicularis”, “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


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.

Veja também

Serviços CID-10

Documentação do DeCS

Herramientas personales