Guía de usuario
Spanish translation of the User Guide
Esta guía de usuario cubre el uso de la interfaz web de CKAN para organizar, publicar y encontrar datos. CKAN también cuenta con una robusta API (del inglés Application Programming Interface), que facilita el desarrollo de extensiones y enlaces con otros sistemas informáticos. Para mayor información revisa la documentación de la API.
Cierta funcionalidad de la interfaz web relacionada con la administración del sitio está disponible solamente para usuarios con rol de administradores del sistema, y se encuentran documentados en una guía por separado.
Contenido
CKAN es una herramienta para publicar portales de datos abiertos. Se puede comparar con sistemas de gestión de contenido (CMS, del inglés Content management system) como WordPress, pero con el enfoque en datos, en lugar de páginas y publicaciones de blog. En pocas palabras, permite administrar y publicar colecciones de datos. CKAN es usado por gobiernos locales y nacionales, institutos de investigación, y otras organizaciones que recopilan datos.
Una vez que los datos son publicados, los usuarios pueden explorar y encontrar los datos que necesitan, e inclusive pre-visualizarlos en mapas, gráficas y tablas, independientemente de si sean desarrolladores, periodistas, investigadores, organizaciones de la sociedad civil, ciudadanos, o tu propio equipo.
En CKAN los datos son publicados en unidades llamadas “datasets” o conjuntos de datos, p. ej. las estadísticas de crimen en una región, los montos de gasto de un departamento o agencia de gobierno, o lecturas de temperatura de diferentes estaciones meteorológicas. Cuando los usuarios busquen datos los resultados serán estos datasets.
Un dataset contiene principalmente dos elementos:
- Metadatos o información acerca de los datos, p. ej. el título, el publicador, la fecha, los formatos disponibles, licencia de uso, etc.
- Recursos que contienen los datos. Un recurso puede ser un archivo de cualquier formato, como CSV, hojas de cálculo de Excel, XML, PDF, imágenes, datos enlazados (Linked Data en inglés) en formato RDF, etc. CKAN puede almacenar el recurso internamente o simplemente como un enlace a otra parte. Un dataset puede contener cualquier número de recursos, p. ej. diversos recursos pueden contener datos para diferentes años, o contener los mismos pero en diferentes formatos.
Los usuarios de CKAN pueden registrar cuentas y entrar al sistema. Comúnmente (dependiendo de la configuración del sitio), el registro no es necesario para buscar y descargar datos, pero sí es requisito para las tareas de publicación, es decir, con los permisos apropiados un usuario puede crear y administrar datasets.
Generalmente, cada dataset es publicado por una Organización, y una instancia de CKAN puede tener cualquier número de organizaciones registradas. Por ejemplo, si CKAN es utilizado como portal de datos de un gobierno nacional, las organizaciones podrían ser las diferentes dependencias, departamentos o agencias de dicho gobierno. Estas organizaciones pueden definir su flujo y mecanismos de autorización para administrar su propio proceso de publicación.
Los administradores de una organización pueden sumar usuarios a su organización con diferentes roles, dependiendo del nivel de autorización requerida, y de esta manera los usuarios pueden crear datasets bajo dicha organización.
Normalmente los datasets no pueden ser creados fuera de una organización, sin embargo, es posible configurar CKAN para autorizar el manejo de datasets fuera de una organización y de esta manera permitir la edición a cualquier usuario registrado en el sistema, creando un portal de datos que sigue la filosofía Wiki.
Esta guía cubre la funcionalidad principal de la interfaz de usuario, pero es posible que en diferentes configuraciones de CKAN algunas de estas funcionalidades no se encuentren disponibles o sean diferentes. Por ejemplo, en una instancia oficial de CKAN, el administrador del sitio podría deshabilitar la creación de organizaciones vía la interfaz de usuario. Todas las funcionalidades descritas se puden probar en http://demo.ckan.org.
El registro es necesario para la mayoría de las funciones de publicación y personalización, como seguir la actividad de datasets, pero no es requisito para buscar o descargar datos.
Para crear un identificador de usuario, utiliza el enlace "Registro" en la parte superior de cualquier página. CKAN pedirá la siguiente información:
- Nombre de usuario: selecciona un nombre utilizando sólo letras, números y caracteres '-' y '_', p. ej. "rodowi" o "rod_1337".
- Nombre completo: que será mostrado en tu perfil de usuario.
- Dirección de correo electrónico: que no será visible a otros usuarios.
- Contraseña: ingresa la misma contraseña en el campo "Confirmar".
Si existe problema con algún campo, CKAN te notificará y permitirá corregirlo. Cuando todos los campos son completados correctamente, CKAN crea una cuenta de usuario y automáticamente ingresa al sistema.
Es perfectamente válido tener más de un usuario ligado a una misma cuenta de correo electrónico. Por esta razón, selecciona un nombre de usuario que puedas recordar, ya que será necesario para ingresar al sistema.