Servicios DeCS

De Wiki REDDES

português english

Tabla de contenidos

Formas de acceso

El servicio DeCS permite la recuperación remota, vía llamada http, de sus conceptos, a través de tres tipos de búsqueda: la búsqueda jerárquica, la búsqueda por palabras y la búsqueda por palabras con operadores booleanos.


Búsqueda jerárquica

Permite la recuperación de términos en el DeCS a través de sus códigos jerárquicos. El código jerárquico es pasado a través del parámetro "tree_id".

Cuando tal parámetro está vacío, como en la url:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=

el servicio produce las categorías jerárquicas de primer nivel del DeCS.

Cuando, por ejemplo, se utiliza el código jerárquico "B01.050.150.900.649.801.400.112.199.120.510.550":

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?tree_id=B01.050.150.900.649.801.400.112.199.120.510.550

se recupera el concepto “Macaca mulatta”.

El idioma del contenido del resultado de la búsqueda puede ser especificado, acrecentándose en la url el parámento “lang” con el valor "pt" para portugués (&lang=pt), "es" para español (&lang=es) o "en" para inglés (&lang=en). Cuando no especificado, el idioma elegido como estándar es el portugués (&lang=pt).

La búsqueda anterior con el contenido en español tendría la siguiente 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

Búsqueda por palabras

Permite a través del parámetro “words”, la búsqueda de palabra a palabra, las cuales son internamente conectadas con el operador AND.

En la url abajo:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?words=Macaca mulatta

la expresión “Macaca mulatta” es internamente convertida para “Macaca AND mulatta”.

La búsqueda por palabras es realizada en el índice conteniendo los términos autorizados, los términos sinónimos y los términos históricos del DeCS, todos indizados con la técnica palabra a palabra.

Así como en la búsqueda jerárquica, el parámetro “lang” puede ser utilizado para se especificar el idioma del contenido del resultado de la búsqueda, siendo el portugués el idioma estándar utilizado caso el parámetro no tenga sido especificado.

Búsqueda por palabras con operadores booleanos

Permite el uso de una expresión booleana, a través del parámetro de búsqueda “bool”, donde los términos son conectados por operadores booleanos AND, OR y AND NOT como en el ejemplo abajo:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=macaca AND mulatta

Es posible especificar en cual índice se hará la búsqueda, poniendose el código del mismo (vea “Prefijos de los índices de búsqueda abajo) como prefijo de expresión de búsqueda:

< prefijo del índice> <expresión de búsqueda>

Ejemplos con operadores e índices

La búsqueda:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=101 Macaca OR 101 mulatta

busca los términos “macaca” o “mulatta” en el índice creado por campo entero teniendo solamente términos autorizados.

Si en vez del prefijo 101 se utilizase el prefijo 407 (palabra a palabra, término autorizado, términos sinónimos y términos históricos) serian recuperados también, además de “Macaca”, los términos “Macaca mulatta”, “Macaca nemestrina” y “Macaca radiata”.

Si no se especifica el código del índice a ser buscado, el índice utilizado como estándar será el de palabra a palabra, término autorizado, términos sinónimos y términos históricos (prefijo 407).

Si la expresión de búsqueda no contiene operadores booleanos, la misma será considerada como siendo campo entero.

Por lo tanto, la url:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=Macaca mulatta

no devuelve nada, porque considera la expresión “Macaca mulatta” como siendo campo entero y busca como un término del índice que fue indizado palabra a palabra.

Ya la url:

http://decs.bvsalud.org/cgi-bin/mx/cgi=@vmx/decs/?bool=107 Macaca mulatta

recupera “Macaca mulatta”, pues el término aparece en el índice indizado con campo entero.

Prefijos de los índices de búsqueda:

101 - campo entero, término autorizado

102 - campo entero, términos sinónimos

104 - campo entero, términos históricos

103 - campo entero, término autorizado y términos sinónimos

105 - campo entero, término autorizado y términos históricos

106 - campo entero, términos sinónimos y términos históricos

107 - campo entero, término autorizado, términos sinónimos y términos históricos

401 - palabra a palabra, término autorizado

402 - palabra a palabra, términos sinónimos

404 - palabra a palabra, términos históricos

403 - palabra a palabra, término autorizado y términos sinónimos

405 - palabra a palabra, término autorizado y términos históricos

406 - palabra a palabra, términos sinónimos y términos históricos

407 - palabra a palabra, término autorizado, términos sinónimos y términos históricos


Nota: un prefijo de índice de búsqueda se aplica al término de búsqueda que lo sigue.


Descripción del resultado en XML

El resultado de una llamada de los servicios DeCS es un archivo XML. Para el mejor entendimiento del significado de las tags que constituyen el mismo, fue creado un ejemplo comentado del resultado de búsqueda "107 macaca mulatta".


Interfaz gráfica para visualización de los servicios DeCS

Fue creado un aplicativo gráfico que se ejecuta en el desktop y que facilita el uso y el entendimiento de los parámetros de llamada de los Servicios DeCS.


Requisito: motor virtual Java versión 1.5 o superior.
Bajar: DeCSClient.jar
Llamada: En equipos 32 bits - hacer dos clics en el archivo jar. En equipos 64 bits usar el comando: java -jar DeCSClient.jar

Llamada de los Servicios DeCS desde un lenguaje de programación

Puedese hacer la llamada de los servicios DeCS a partir de un lenguaje de programación sin el uso del protocolo SOAP. Posibles funciones que llaman los servicios directamente son ejemplificadas abajo para los lenguajes PHP, Python y Java.


Vea también

Servicios CIE-10

Documentación del DeCS

Herramientas personales