Serviços DeCS

De Wiki REDDES

Revisión a fecha de 20:29 19 dic 2014; Renato.murasaki (Discutir | contribuciones)
(dif) ← Revisión anterior | Ver revisión actual (dif) | Revisión siguiente → (dif)
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


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