El portal de la administración vasca Euskadi.eus tiene un buscador como tantos otros webs, de modo que puedes rastrear términos entre las múltiples secciones del web. Pero, además de eso, existe toda una serie de parámetros moldeables para afinar busquedas, y se pueden obtener los resultados en formato XML. Utilizando esas capacidades, se pueden crear aplicaciones externas que presentan datos de búsquedas estructuradas.

La presente aplicación de ejemplo la hemos hecho para ilustrar este punto. Se trata de un sistema que hace búsquedas sobre los programas de ayudas y subvenciones de la administración pública vasca, y ofrece los resultados en una vista muestra las convocatorias ahora abiertas, mostrando primero las que antes vayan a caducar.

El resultado no parece un buscador, ya que consiste en un listado de ayudas, pero es, precisamente, una de las múltiples opciones de desarrollo que permite un buscador con funciones de API.

Lo que hacemos en esta aplicación es una consulta al API de todas las ayudas y subvenciones (es uno de las tipologías con las que se etiqueta el contenido), y mediante un script, generamos un fichero temporal que:

• filtra las que están abiertas
• las ordena en orden ascendete por fecha de cierre de convocatoria

Para este caso la query que hemos por url es la siguiente:

“http://opendata.euskadi.eus/r01hSearchResultWar/r01hPresentationXML.jsp?r01kQry=tC:euskadi;tF:procedimientos_administrativos;tT:ayuda_subvencion;m:documentLanguage.EQ.es,procedureStartDate.BETWEEN.01/01/2011,31/12/2011;p:Inter_portal,Inter;pp:r01PageSize.50”

Donde especificamos los siguientes parámetros:

• r01hPresentationXML >  Puesto que queremos los datos en XML en este caso.
• tF:procedimientos_administrativos;tT:ayuda_subvencion > Consultamos las ayudas y subvenciones
• m:documentLanguage.EQ.es > especificamos el lenguaje en el que queremos nosotros el resultado, “es” para castellano o “eu” para Euskara.
• procedureStartDate.BETWEEN.<fecha_inicio>,<fecha_fin> > Donde <fecha_ini> y <fecha_fin> son las fechas comprendidas entre las que queremos buscar resultados. Para el ejemplo utilizaremos las vigentes del 2011.
• pp:r01PageSize.50 > Cuantos resultados queremos que nos muestre por página.

Esta consulta nos devuelve un XML con los resultados.

Podemos ver como dentro del XML nos devuelve los parametros que le hemos pasado a la busqueda

<searchedMetaData>

<metaData oid=”documentLanguage”>

<value>eu</value>

<operationSelected>EQ</operationSelected>

</metaData>

<metaData oid=”procedureStartDate”>

<value>01/01/2011,31/12/2011</value>

<operationSelected>BETWEEN</operationSelected>

</metaData>

</searchedMetaData>

Nuestro fichero temporal tendrá los siguientes datos:

<items>

<item>

<documentDescription> ORDEN de 15 de diciembre de 2010, de la Consejera de Cultura, por la que se establece el régimen de concesión de subvenciones para el desarrollo de programas y actividades en el ámbito de Juventud y Acción Comunitaria. </documentDescription>

<documentURL> http://opendata.euskadi.net/contenidos/ayuda_subvencion/11gazter/es_11gazter/11gazter.html </documentURL>

<contentAuthor> RROCHERU </contentAuthor>

<procedureEndDate> Mon Jan 31 00:00:00 CET 2011 </procedureEndDate>

<procedureStartDate> Mon Jan 03 00:00:00 CET 2011 </procedureStartDate>

<filetitle> Subvenciones para el desarrollo de programas y actividades en el ámbito de Juventud y Acción Comunitaria 2011. </filetitle>

<fileresume> Consolidación,País Vasco,Agentes de juventud,Cultura,Carnés jóvenes,Actividades de tiempo libre,Sector Terciario (servicios …),Fomentar la Igualdad de mujeres y hombres,Gobierno Vasco,Ocio nocturno,Juventud,Administraciones,Administración </fileresume>

</item>

<item>

<documentDescription> ORDEN de 15 de diciembre de 2010, de la Consejera de Cultura, por la que se regula la concesión de subvenciones destinadas a la promoción museística y al desarrollo de actividades museísticas relacionadas con el patrimonio y la difusión cultural. </documentDescription>

<documentURL> http://opendata.euskadi.net/contenidos/ayuda_subvencion/11museos/es_11museos/11museos.html </documentURL>

<contentAuthor> RROCHERU </contentAuthor>

<procedureEndDate> Mon Jan 31 00:00:00 CET 2011 </procedureEndDate>

<procedureStartDate> Fri Dec 31 00:00:00 CET 2010 </procedureStartDate>

<filetitle> Subvenciones destinadas a la promoción museística y al desarrollo de actividades museísticas relacionadas con el patrimonio y la difusión cultural 2011. </filetitle>

<fileresume> Cultura,País Vasco,Cultura,Administración Foral,Formación y estudios,Patrimonio Histórico Artístico y Cultural,Programas y proyectos,Sector Terciario (servicios …),Aportación financiera,Obtener subvenciones,Crecimiento y desarrollo,Gobierno </fileresume>

</item>

[…]

</items>

Ahora podemos manejar esa información de la manera que queramos.

Para este ejemplo mediante un script hemos filtrado las ayudas y subvenciones que estan abiertas y hemos generado un fichero temporal solo con los datos que nos interesan ordenados por fecha de finalización, para saber cuales son las ayudas que van a vencer proximamente.

En Open Data Euskadi hay documentación (en varios PDF), sobre cómo configurar estos parámetros del API del buscador. Los resultados, por supuesto, se pueden reutilizar haciendo uso de la licencia de uso libre de Open Data Euskadi.