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
Web Services Description Language (WSDL)
Para acceder a los servicios DeCS a través del protocolo SOAP, use la siguiente WSDL.
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.
