Integrándonos con Agrega
4 Septiembre 2008
La plataforma Agrega nace con ánimo de integración tanto de ella con otros repositorios y como de que otros repositorios en ella.
Para ello la plataforma expone hacia el exterior muchos de sus interfaces mediante servicios web a través del protocolo de intercambio SOAP, facilitando la interoperabilidad con otros repositorios.
(CC): Amanky
Los principales módulos que se exponen al exterior son los siguientes:
- OAI-PMH (Open Archives Initiative – Protocol for Metadata Harvesting)
Protocolo donde se definen una serie de interfaces que facilitan la disponibilidad de contenidos procedentes de una variedad de proveedores para la difusión de contenidos digitales en Internet.
El protocolo OAI-PMH se asienta sobre tres principios:
• Harvesting a nivel de metadatos.
• Proveedores de datos y de servicios.
• Peticiones HTTP respuestas XML válidos.
Este módulo nos permite dos tipos de integración: una a través de peticiones GET siguiendo el estándar OAI-PMH y otra a través de servicios web.
Algunas de las funcionalidades que se ofrecen en este protocolo son las siguientes:
• Identificación:
http://{nodoAgrega}/oaipmh/OaiPmhRequest/OaiPmhRequest.do?verb=Identify
• Listado de formato de metadatos:
http://{nodoAgrega}/oaipmh/OaiPmhRequest/OaiPmhRequest.do?verb=ListMetadataFormats
• Recuperación de un conjunto de registros:
http://{nodoAgrega}/oaipmh/OaiPmhRequest/OaiPmhRequest.do?verb=ListSets
• Recuperación de un registro completo:
http://{nodoAgrega}/oaipmh/OaiPmhRequest/OaiPmhRequest.do?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:agrega.es:{identificador}
Estandar de interoperación de repositorios Digitales con las siguiente funcionalidades:
• Presentar/Almacenar
• Presentar/Catalogar
• Solicitar/Entregar
• Buscar/Mostrar
Se pueden consultar los servicios que expone Agrega para cubrir este estandar de la siguiente manera:
http://{nodoAgrega}/dri-1/services
http://{nodoAgrega}/buscar-1/services
Y sus wsdl correspondientes que se encuentran en las siguientes direcciones:
http://{nodoAgrega}/buscar-1/services/SrvBuscarService?wsdl
http://{nodoAgrega}/dri-1/services/SrvDRIService?wsdl
- SQI (Simple Query Interfaces)
Es una especificación para garantizar la interoperabilidad entre redes o entornos educativos heterogéneos.
Los métodos del servicio que se ofrecen se pueden consultar en la siguiente dirección:
http://{nodo}/dri-1/services
Y el wsdl es esta otra:
http://{nodoAgrega}/dri-1/services/SrvDRIService?wsdl
Estimados amigos,
Estoy haciendo unas pruebas para realizar búsquedas en el repositorio a través de llamadas al servicio web con .net pero no consigo realizarlo. Donde puedo encontrar un ejemplo de como realizar una llamada al servicio web de búsqueda y como obtener los resultados. El problema que tengo es que los parámetros que le pasao a la función buscarAvanzado no se si lo hago correctamente y siempre me devuelve 0 registros.
Muchas gracias de antemano.
Recibid un cordial saludo.
Comment por Santiago — 30 Abril 2009 @ 1:18 pm
Hola Santiago,
Por lo que nos cuentas el problema lo tienes en el paso de parámetros desde el cliente. Quizá no estás pasando todos los parámetros necesarios y por eso te devuelve “0″ resultados.
En el manual de integración publicado en la sección de documentación para técnicos se explican los parámetros necesarios para una solicitud de búsqueda: te copiamos aquí los parámetros y te enviamos por correo electrónico un ejemplo, no obstante te recomendamos consultar dicho manual para más detalle.
Este método requiere como parámetros un objeto del tipo ParametrosBusquedaAvanzadaVO. Los únicos parámetros requeridos a partir de la versión 1.2 Agrega son idiomaBusqueda, idiomaNavegación y uno de los siguientes: valoracion, titulo, secuencia, recurso, procesoCognitivo, palabrasClave, taxonomia, formato, fechaPublicacion, edad, descripcion, contexto, autor, nivelAgregacion, destinatarios, keyword o ambito.
En versiones anteriores eran obligatorios también: origenPagina, numeroResultados y resultadosPorPagina.
Para lanzar una búsqueda federada se deben cargar: comunidadesSeleccionadas y comunidadPeticion.
Como te comentamos, te enviamos por correo el ejemplo.
Comment por admin — 4 Mayo 2009 @ 7:12 pm
Con el correo que me habéis mandado ya consigo llamar bien a la funcion pero no obtengo resultados, y no se si no estoy apuntando a la url correcta.
¿Cual es la url del servicio web al que hay que apuntar?
Muchas gracias.
Un saludo.
Comment por Santiago — 7 Mayo 2009 @ 12:45 pm
Santiago,
La URL de llamada es : http://IP/buscar-1/services/SrvBuscarService
En caso de estar llamando desde la misma red en la que está instalado el servidor: http://IP:8080/buscar-1/services/SrvBuscarService
Para obtener el WSDL: http://IP/buscar-1/services/SrvBuscarService?wsdl
En caso de estar llamando desde la misma red en la que está instalado el servidor: http://IP:8080/buscar-1/services/SrvBuscarService?wsdl
IP=La IP o dominio del servidor al que llame, por ejemplo en Aragón “agrega.catedu.es”
Comment por admin — 7 Mayo 2009 @ 6:16 pm
Hola de nuevo, muchas gracias por la respuesta.
He probado a hacer una búsqueda en el nodo de Aragón y el objeto que devuelve a la llamada al webservice me devuelve el número de registros que coinciden con la búsqueda (el mismo que si hago la búsqueda desde la web) pero los arrays “resultadoBusqueda”, “sugerencias” y “tesauro” están vacios. ¿A que se debe?
Muchas gracias.
Un saludo.
Comment por Santiago — 11 Mayo 2009 @ 4:59 pm
Santiago:
No todas las búsquedas tienen asociada una sugerencia o un tesauro. Para que devuelva sugerencias se debe rellenar el campo palabrasClave (busca sobre Título, Descipción y Keywords del ODE) una palabra que se aproxime morfologicamente a alguna en la que esté catalogado algún ODE en alguno de los tres campos comentados.
Para la búsqueda por tesauro se debe rellenar el campo palabrasClave con alguna palabra con proximidad sintáctica. Para que se devuelvan sugerencias de tesauro los ODEs deben de estar catalogados en la categoría 9 con la taxonomía Tesauro.
Nos encanta tu interés!!! y nos encantará tener feedback tuyo sobre el uso de Agrega. Todos vuestros comentarios nos ayudan a seguir evolucionando.
saludos
Equipo Agrega
Comment por admin — 13 Mayo 2009 @ 2:13 pm