¡Un aplauso, ya estás abriendo tus datos!
Esta guía te ayudará a:
¡Arranquemos!
Cada vez que quieras entrar al portal, podrás hacerlo desde http://tu-url.com/ingresar.
Las versiones compatibles con Andino son las siguientes:
Desde agosto de 2017, en Andino hay dos tipos de usuarios: los administradores y los colaboradores. El primer usuario administrador siempre es creado por el técnico en sistemas que instaló Andino.
Los administradores de Andino pueden invitar a más personas a colaborar en la apertura de datos, eligiendo el tipo que quieren asignar:
Asigná permisos desde Mi cuenta > Crear usuarios.
Son los organismos que abren o mantienen cada dataset. Es muy importante que crees las organizaciones antes de que generes un dataset que esté asociado a ella.
Tené en cuenta que siempre que borres una organización, todos los conjuntos de datos (y también los recursos), se borrarán definitivamente.
Andá a Página principal > Crear Organizaciones.
En caso de que hayas elegido que tu portal tenga una sección de Organizaciones con datos, también se mostrarán allí.
Esta sección es opcional. Te permite armar un árbol de jerarquías con las organizaciones que abrieron datos en tu portal. Los organismos que se muestran en esta parte de tu portal son los mismos que asignás a los datasets y que creás antes de generar estos últimos.
En Página principal > Organizaciones con datos.
Es importante que tengas bien en claro qué organizaciones dependenden de otras, para que el árbol de jerarquías represente bien las correspondencias.
Como la sección Organizaciones con datos es opcional, podés elegir que se vea en tu portal. Para eso, andá a Configuraciones > Organizaciones con datos y tildá la habilitación.
Esta sección es opcional. Te permite darle la oportunidad a los usuarios que naveguen tu portal de leer información del mismo para un mejor entendimiento.
Existen tres tipos diferentes que vas a poder elegir:
Andá a Página Principal > Usuario > Configuración > Otras secciones del portal > Acerca (opcional)
Habiendo elegido la segunda opción, podés modificar el título y la descripción.
Habiendo elegido la tercera opción, podrás ir creando tus secciones escribiendo un título y un nombre de archivo. Recordá que, para cada sección, será necesario guardar un archivo (de formato .html) para que el portal pueda mostrar su contenido.
Dentro del container, dichos archivos deben ser guardados en el directorio /var/lib/ckan/theme_config/templates/ .
De no existir la carpeta /templates, se deberá crearla utilizando dos comandos:
(www-data es el usuario con el que se corre el proceso apache en el sistema operativo Ubuntu)
Dentro de cada archivo deberá estar el contenido de su sección correspondiente. Por favor, no te olvides de que el nombre del archivo debe coincidir con lo escrito en el campo ‘Nombre del archivo’ de la sección.
Dentro del container, las imágenes deben ser guardadas en una carpeta llamada “user_images”.
Para poder copiar y pegar una imagen en dicha carpeta existe un comando que podés usar, pero primero tenés que hacer tres cosas:
chown www-data:www-data /usr/lib/ckan/default/src/ckanext-gobar-theme/ckanext/gobar_theme/public/user_images/
El nombre del contenedor se consigue escribiendo en una terminal dentro del host:
sudo docker-compose -f latest.yml ps |grep <puerto del container>
Sólo nos queda guardar la imagen:
docker cp <nombre de la imagen> <nombre del contendor portal>:/usr/lib/ckan/default/src/ckanext-gobar-theme/ckanext/gobar_theme/public/user_images/
Supongamos que guardaste una imagen llamada ‘mi_imagen.png’; para poder utilizarla, podés escribir dentro de tu template esta línea (completa):
<img src="/user_images/mi_imagen.png">
Son las categorías en las que se pueden clasificar todos los datasets de tu portal. Hay dos taxonomías de temas:
Andá a Página principal > Crear tema.
Cada vez que generes un nuevo dataset, el formulario te pedirá que asignes temas. Recordá siempre reutilizar los que ya hayas creado y no repetirlos.
También los llamamos “conjuntos de datos”. Son la pieza principal de tu portal o catálogo de datos. Cada dataset está formado por uno o más recursos.
Todos los datasets que subas al portal se verán en la sección Datasets. Además, podrás destacar los que creas más importantes en la Página principal.
Ingresá a tu cuenta y andá a Página principal > Crear dataset.
Siempre podrás editar los dataset que hayas creado. Para eso, ingresá a tu cuenta > Página principal > Datasets > Editar dataset.
Cada dataset está formado por, al menos, un recurso. Por eso decimos que los recursos son la pieza de información más pequeña del catálogo y los verdaderos activos de datos del portal.
Página principal > Datasets > Clic en el recurso específico.
Seguí los mismos criterios de escritura que con los datasets.
Ingresá a tu cuenta y andá a Página principal > Crear dataset. Una vez que completes el dataset, podrás agregar recursos.
Al igual que con los datasets, siempre podrás editar los recursos que hayas creado. Para eso, ingresá a tu cuenta > Página principal > Datasets > Editar dataset > Editar recursos.
Significa poder utilizar el preview de un recurso perteneciente a otro portal. Para hacerlo, se debe hacer click en el botón “Embeber”, lo cual mostrará una ventana con el código HTML de un iframe que podés usar en alguna parte de tu portal, junto con los valores configurables del ancho y la altura que querés que tenga el preview.
Tené en cuenta que, para que se puedan embeber los recursos de tu portal, necesitás agregar la URL de tu portal al whitelist para CORS en el archivo de configuración.
Los recursos pueden tener mucha información y ser difíciles de comprender. Para ayudar a los usuarios que ven nuestros recursos, Andino permite documentar qué contiene cada campo.
Los recursos que tengan información sobre sus campos se visualizarán en la vista de un recurso.
Puede ser de mucha ayuda para los usuarios que siempre cargues al menos los siguientes campos:
También podés usar estos campos para documentar aspectos más avanzados de las columnas de un recurso:
Andino permite documentar recursos que publican series de tiempo. Un recurso con series de tiempo es un archivo CSV de determinada estructura.
En el formulario de carga de un recurso vas a encontrar campos avanzados y especiales que necesitás usar para documentar las columnas de una tabla que contiene series de tiempo.
Los campos Tipo de dato especial y Detalle de tipo especial te permiten marcar la columna del índice de tiempo y qué frecuencia tiene.
Los campos Unidad de medida e Identificador te permiten documentar cada una de las columnas, que son tus series de tiempo.
Para conocer más sobre series de tiempo mirá la documentación completa en el perfil de metadatos.
Son las palabras que ayudan a los usuarios a filtrar y encontrar los datasets. Cuanto más amplia y uniforme sea la lista de Etiquetas, mayor es su poder de ayuda.
En cada dataset específico.
Éstas son algunas preguntas útiles a la hora de pensar las etiquetas:
Al igual que con los Temas, cada vez que generes un nuevo dataset, el formulario te pedirá que asignes un etiqueta. Recordá siempre reutilizar las que ya hayas creado y no repetirlas.
Hacer que tu portal represente tu organización es muy fácil. Por favor, andá a la Página principal > Configuración. Llegarás a la sección que te permite cambiar cómo luce la portada de tu catálogo de datos y cada sección en particular.
Por favor, escribinos y contanos con qué casilla de e-mail querés tener permisos para ver las métricas de tu Andino.
Andino es un portal abierto en constante desarrollo para ser usado por toda la comunidad de datos. Por eso, cuando incorporamos una nueva mejora, cuidamos mucho su compatibilidad con la versión anterior.
Como la comunidad de datos es grande, por ahora no podemos dar soporte técnico frente a modificaciones particulares del código. Sin embargo, podés contactarnos para despejar dudas.
Te invitamos a crear issues o enviarnos sugerencias en caso de que encuentren algún bug o tengas feedback. También podés mandarnos tu comentario o consulta a datosargentina@jefatura.gob.ar