Comienzo rápido

Indice

Primeros pasos

¡Un aplauso, ya estás abriendo tus datos!

Esta guía te ayudará a:

¡Arranquemos!


Entrar y salir de tu portal

Cada vez que quieras entrar al portal, podrás hacerlo desde http://tu-url.com/ingresar.

alt text


Permisos de usuario

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.

alt text


Elementos de tu portal

Organizaciones

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.

¿Dónde lo veo en el portal?

alt text

Buenas prácticas al crear Organizaciones con datos

Tené en cuenta que siempre que borres una organización, todos los conjuntos de datos (y también los recursos), se borrarán definitivamente.

¿Cómo los creo?

Andá a Página principal > Crear Organizaciones.

alt text

En caso de que hayas elegido que tu portal tenga una sección de Organizaciones con datos, también se mostrarán allí.

alt text


Sección Organizaciones con datos

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.

¿Dónde lo veo en el portal?

En Página principal > Organizaciones con datos.

Buenas prácticas al crear la sección 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.

¿Cómo las creo?

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.

alt text


Sección Acerca

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.

Tipos de Acerca

Existen tres tipos diferentes que vas a poder elegir:

¿Cómo elijo el tipo de Acerca?

Andá a Página Principal > Usuario > Configuración > Otras secciones del portal > Acerca (opcional)

alt text

alt text

¿Cómo puedo escribir y mostrar información básica?

Habiendo elegido la segunda opción, podés modificar el título y la descripción.

alt text

¿Cómo puedo crear y mostrar mis secciones personalizadas?

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.

alt text

¿Dónde añado los archivos requeridos para las secciones?

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.

¿Dónde y cómo puedo guardar imágenes para mostrarlas en mis secciones? ¿Cómo las muestro en mis templates?

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">

Temas

Son las categorías en las que se pueden clasificar todos los datasets de tu portal. Hay dos taxonomías de temas:

¿Dónde lo veo en el portal?

alt text

Buenas prácticas al crear Temas específicos
¿Cómo los creo?

Andá a Página principal > Crear tema.

alt text

¿Cómo los asigno?

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.

alt text


Datasets

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.

¿Dónde los veo en el portal?

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.

alt text

Buenas prácticas al crear datasets
¿Cómo los creo?

Ingresá a tu cuenta y andá a Página principal > Crear dataset.

alt text

Siempre podrás editar los dataset que hayas creado. Para eso, ingresá a tu cuenta > Página principal > Datasets > Editar dataset.


Recursos

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.

¿Dónde los veo en el portal?

Página principal > Datasets > Clic en el recurso específico.

Buenas prácticas al crear recursos

Seguí los mismos criterios de escritura que con los datasets.

¿Cómo los creo?

Ingresá a tu cuenta y andá a Página principal > Crear dataset. Una vez que completes el dataset, podrás agregar recursos.

alt text

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.


Campos de un recurso

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.

¿Dónde los veo en el portal?

Los recursos que tengan información sobre sus campos se visualizarán en la vista de un recurso.

alt text

Buenas prácticas al cargar campos de un recurso

Puede ser de mucha ayuda para los usuarios que siempre cargues al menos los siguientes campos: - Título de la columna - Tipo de dato - Descripción

También podés usar estos campos para documentar aspectos más avanzados de las columnas de un recurso: - Unidad de medida - Identificador - Tipo de dato especial - Detalle de tipo especial


Series de tiempo

Andino permite documentar recursos que publican series de tiempo.

¿Cómo documento una serie de tiempo?

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.

alt text

Los campos Unidad de medida e Identificador te permiten documentar cada una de las columnas que son series de tiempo.

alt text

Para conocer más sobre series de tiempo mirá la documentación completa en el perfil de metadatos.


Etiquetas

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.

¿Dónde las veo en el portal?

En cada dataset específico.

alt text

Buenas prácticas al crear etiquetas

Éstas son algunas preguntas útiles a la hora de pensar las etiquetas:

¿Cómo las creo?

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.

alt text


Personalizar el portal

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.

alt text


Integrar Andino con Google Analytics

Por favor, escribinos y contanos con qué casilla de e-mail querés tener permisos para ver las métricas de tu Andino.


Consultas sobre 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 datos@modernizacion.gob.ar


Otros contenidos útiles