Publicación manual de Datos
El procedimiento manual para la publicación de datos en el Catálogo Nacional de Datos Abiertos consta de cinco etapas que se detallan a continuación;
Imagen 1: Las 5 etapas del procedimiento de apertura
Requerimientos para la publicación manual:
- Contar con usuario en el Catalogo e iniciar sesión
- Contar con los datos preparados en formato abierto
- Contar con datos descriptivos (metadatos) en formato abierto
- Contar con la información necesaria para construir el conjunto
El requerimiento principal para publicar conjuntos de datos es que se inicie sesión en el Catálogo como editor o administrador del organismo publicador al que se pertenece.
- Ingresar en el Catálogo Nacional de Datos Abiertos e inicie sesión utilizando el Usuario Gub.uy.
A tener en cuenta: Para acceder al Catálogo se debe contar previamente con usuario Gub.uy registrado, si no cuenta con usuario debe creárselo. Luego de contar con usuario gub.uy debe ingresar al Catálogo por primera vez para quedar registrado. A continuación, debe solicitar permisos enviando un correo a catalogodatos@agesic.gub.uy. Luego seguir los siguientes pasos de cada etapa. Puede utilizar la guía de “Creación de usuario Catalogo Datos Abiertos”.
Etapa 1 - Crear conjunto de datos
Se debe seguir los siguientes pasos que se detallan a continuación para crear un nuevo conjunto de datos. Los conjuntos de datos van a contener los archivos con los datos, los metadatos que facilitaran el uso y la información complementaria como pueden ser; su autor, su frecuencia de actualización y su licenciamiento.
Paso 1 - Agregar un nuevo “Conjunto de Datos”
1) Seleccionar la opción “Conjunto de Datos” que aparece en la parte izquierda del menú de navegación, en la parte superior de la pantalla
Imagen 2: Opción de Conjuntos de Datos en barra de navegación.
2) Hacer clic en el botón “Agregar”, aparecerá el formulario que deberá completar para crear el conjunto.
Imagen 3: Botón de Agregar para crear nuevo conjunto.
Paso 2 - Completar formulario de creación de conjunto de datos: Se debe completar el siguiente formulario
Imagen 4: Formulario de creación de conjunto nuevo
Los campos a completar son:
- Título: Es el nombre que se le asigna al conjunto de datos. Debe de ser conciso, concreto e informativo. Campo obligatorio.
- URL: Es la ruta de acceso al conjunto de datos. Se autogenera a partir del título y el nombre del organismo, sin embargo, se puede editar si fuera necesario. Campo obligatorio.
Importante: La URL debe ser única, esto significa que NO pueden existir en el Catálogo dos conjuntos de datos con la misma ruta de acceso, si ocurriera se mostraría el siguiente mensaje de error que no permite crear el conjunto de datos y se debe editar y modificar la URL.
- Descripción: Es la explicación del conjunto de datos. Debe contener detalles que permitan conocer qué datos contiene ese conjunto y la información necesaria para facilitar la comprensión y uso de esos datos. Campo obligatorio.
- Etiquetas: Permiten identificar todos los conjuntos de datos bajo un mismo tema y funcionan como filtros para acceder desde diferentes búsquedas de datos.
En este campo hay algunas etiquetas predeterminadas que se despliegan a medida que se comienza a escribir, seleccione aquellas que identifiquen al conjunto. Si no se encuentra una etiqueta adecuada puede escribir una etiqueta nueva que se ajuste mejor. Campo obligatorio.
Un conjunto de datos puede tener más de una etiqueta asociada. Al ingresarlas deberán estar separadas por una coma (ej.: Economía, Gobierno abierto, Transparencia activa).
- Licencia: Es el documento que expresa las condiciones bajo las cuales podrán ser utilizados los datos que se van a publicar. Todo conjunto de datos abiertos que sea publicado por un organismo del Estado según la normativa nacional debe hacer referencia a la Licencia de Datos Abiertos de Uruguay (Licencia de DAG de Uruguay), mientras que el resto de las organizaciones podrán optar por esta u otras licencias abiertas. Campo obligatorio.
Importante: En caso de que el publicador desee utilizar una licencia abierta que no esté disponible en el Catálogo deberá incluirla como un recurso más del conjunto de datos identificado como Licencia.
- Organismo: Refiere al organismo o institución al que pertenece el conjunto de datos, por defecto estará seleccionado el organismo al que pertenece el usuario logueado. Campo obligatorio.
- Visibilidad: Permite identificar si el conjunto es Privado (visible únicamente para los usuarios de la organización que lo publicó) o Público (visible para todos los usuarios que accedan al Catálogo Nacional de Datos Abiertos). Por defecto, siempre se crearán en estado Privado.
Una vez el conjunto esté terminado el equipo de Datos de Agesic es el encargado de hacer el control final de calidad para así aprobarlo pasándolo al estado Publico. Campo obligatorio.
- Frecuencia de actualización: Es la periodicidad con la cual será actualizado el conjunto en general, y cuenta con una lista de valores extensa, por ejemplo: Publicación Única, Diario, Semanal, Quincenal, Mensual, Bimensual, etc.
En base a este dato, cuando se esté llegando a la fecha de nueva actualización el Catálogo mostrará en el panel inicial que dicho conjunto está por llegar a la fecha de su actualización y marcará con un punto verde los que están dentro del periodo o rojo los que ya pasaron su fecha de actualización. En el caso de utilizar el valor Autogenerado implica que va a mostrar la frecuencia que tenga los recursos del conjunto de datos. La frecuencia de actualización de un conjunto donde los archivos de datos están alojados en otro sitio web, se debe utilizar el valor de: Enlace externo. Campo obligatorio.
- Fuente: Debe indicar el origen de los datos. En caso que los datos hayan sido obtenidos de un sistema informático y estén publicados en internet abierto al público se debe especificar la URL origen. Campo NO obligatorio.
- Versión: Indica la evolución del conjunto de forma de poder identificar qué versión especificada de conjunto es la que se encuentra publicada. Este control de versiones depende del mantenedor de los datos y se debe incrementar cuando existan cambios estructurales del conjunto. Ejemplos; 1.0 o 2.0. Campo obligatorio.
- Autor: Identifica el área o sector del organismo que se encarga de la publicación. Campo obligatorio.
- Email del Autor: Identifica el correo electrónico del área o sector responsable de los datos. Campo obligatorio.
- Mantenedor: Identifica el nombre del equipo, área, sector o persona que se encarga de mantener la publicación de los datos. Campo obligatorio.
- Email del mantenedor: Identifica el correo electrónico del mantenedor agregado en el punto anterior. Campo obligatorio.
En todos los campos se debe cuidar la ortografía y no incluir caracteres especiales.
Paso 3 - Controlar y finalizar la carga del conjunto de datos: El último paso consiste en hacer una revisión sobre los datos cargados en el formulario.
1) Realizar un control del formulario antes completado apoyándose si es necesario con el documento sobre: “Buenas prácticas para la Publicación de Datos Abiertos” para así obtener un conjunto de datos correctamente publicado.
Se debe tener en cuenta que el equipo de soporte del Catálogo hará una revisión de las publicaciones antes de cambiar su estado a Público. En el caso de no cumplir con alguno de los criterios establecidos, se sugerirán las correcciones necesarias previas a hacer pública su publicación.
2) Para finalizar, luego de completar y controlar todos los campos se debe presionar el botón de “Siguiente: Agregar Datos” que se encuentra en la parte inferior del formulario
Imagen 5: Botón: Siguiente: Agregar Datos que se encuentra en la parte inferior
Aparecerá la segunda parte del formulario para poder empezar a subir uno a uno cada uno de los recursos (archivos) al conjunto de datos.
Etapa 2 - Agregar datos al conjunto de datos
Luego de presionar el botón de “Siguiente: Agregar Datos” aparecerá el formulario para agregar recursos (datos y metadatos) al conjunto que se está creando.
Paso 1 – Completar formulario
Imagen 6: Formulario para agregar datos al nuevo conjunto con todos sus campos
Importante: Los datos que elija publicar deben cumplir los 8 principios básicos de los datos abiertos, estos principios dictaminan que los datos deben ser: Completos, Primarios, Oportunos, Accesibles, Procesables, No discriminatorios y Libres de licencias restrictivas. Para profundizar sobre estos temas y los posibles pasos previos a la publicación leer el documento: “Introducción a Datos Abiertos”.
Los campos a completar son:
- Dato: Es el archivo que contiene los datos a publicar, se puede utilizar 2 opciones: “Subir” para adjuntarlo desde sus archivos, o “Enlace” si se quiere enlazar los datos desde un sitio web. Campo obligatorio.
- Nombre: Es el nombre con el cual identificará a los datos que contiene el recurso (archivo) a publicar. El mismo debe ser concreto, es un nombre descriptivo y no necesariamente igual al nombre del archivo. Campo obligatorio.
- Descripción: Realizar una descripción en lenguaje claro sobre los datos que se publican incluyendo que tipo datos contiene. La descripción debe de complementar al título del recurso. Tiene que contener palabras claras y dar una visión concreta sobre los datos que se publican. Campo obligatorio.
- Formato: Se debe escribir la extensión del archivo adjuntado en el primer paso. Ejemplos: XLSX, CSV, XML, JSON y otros. Campo obligatorio.
- Frecuencia de actualización: Elegir una de las opciones de la lista desplegable. Será la periodicidad con la cual se actualizará este recurso en particular. Campo obligatorio.
- Sistema de Referencia: Campo para indicar un sistema de referencia para sistemas geográficos, ejemplo: ROU-USAMS para cartografía nacional o SIRGAS-ROU98 para referencia geocéntrico para las Américas. Campo NO obligatorio.
- Cobertura Espacial: Campo para indicar la región territorial contenida en los datos. Ejemplo: “Uruguay” o “Soriano, Uruguay”. Campo obligatorio.
- Cobertura Temporal: Campo para indicar el período de tiempo que abarcan los datos, el mismo puede ser un mes en particular, un año o un rango de años siempre respetando los estándares de escritura de fechas para la norma ISO 8601 (AAAA-MM-DD, AAAA-MM, AAAA) ejemplos: “2019-05”, “1984”, “2001 – 2019” o “2001-01 – 2019-06”. Campo obligatorio.
Al completar todos los campos del formulario puede seleccionar:
- “Guardar y Agregar otro” para cargar este recurso al conjunto y seguir subiendo otros a continuación.
- “Terminar” si ya terminó de agregar todos los recursos para dar por finalizada la construcción del conjunto.
Nota: Tener en cuenta que además de los datos también se deben agregar metadatos que son los datos descriptivos de los datos publicados, esto se debe realizar antes de presionar el botón de “Terminar” la publicación.
Imagen 7: botones con distintas opciones finales del Formulario
Etapa 3 - Agregar metadatos al conjunto de datos
Los metadatos describen la información acerca de los datos publicados en el conjunto (estructura, nomenclatura, descripción de los atributos, tipo de datos, etc). Tienen el fin ayudar a comprender los datos publicados.
Para agregar un recurso del tipo de metadatos (datos descriptivos), se debe hacer en el mismo procedimiento del punto anterior, antes de presionar el botón “Terminar”, pero subiendo el archivo de metadatos.
El nombre de este archivo (recurso) debe comenzar con la palabra: “Metadatos” y el nombre del recurso al cual describe.
Ejemplo: “Metadatos de horarios de líneas de transporte”.
Ejemplo de archivo de metadatos:
Si se cuenta, con un archivo de datos con 5 columnas de información como se muestra en la siguiente imagen:
Tabla de datos:
Imagen 8: Tabla con ejemplo de estructura de datos, mostrando cinco columnas
Los Metadatos para este recurso deberán contener como mínimo la descripción de cada una de estas columnas con el tipo de dato que contienen como se muestra a continuación.
Metadatos:
Imagen 9: Tabla con estructura de metadatos en base al ejemplo anterior
Al terminar de subir todos los recursos necesarios, se debe hacer clic en el botón “Terminar” que se encuentra al final del formulario explicado en la etapa anterior y así se logrará tener el conjunto creado.
Lo importante es que este tipo de archivos estén también en un formato abierto, aunque también se aceptan en formatos no estructurados y no abiertos como archivos PDF, DOC, txt, etc.
Etapa 4 - Agregar categorías al conjunto de datos
El atributo “Categoría” en el conjunto es el único valor que se debe configurar posterior a la construcción del conjunto. Se debe elegir por lo menos una de las categorías predeterminadas que tiene el Catálogo, lo cual dependerá de la temática de los datos publicados. A diferencia de las etiquetas, las categorías son clasificaciones ya creadas por defecto en el Catálogo.
Para agregar “Categorías” a un conjunto de datos seguir los siguientes pasos:
Paso 1 – Ingresar al conjunto de datos que quiere agregarle alguna Categoría.
Paso 2 – Seleccionar la opción Categoría desde el listado de opciones que se encuentra a la izquierda de la pantalla:
Imagen 10: Imagen del listado de opciones laterales de un conjunto
Paso 3 – Buscar y agregar la categoría deseada de la lista desplegable que se muestra a continuación haciendo clic sobre la misma. Y luego hacer clic en el botón Añadir Categoría.
Imagen 11: Listado de opciones de las distintas Categorías
Figura 12: Botón para agregar la categoría elegida
Realizar el mismo proceso hasta que se hayan agregado todas las categorías necesarias.
Nota: Para agregar categorías se debe contar con el rol de “Administrador”. Se pueden agregar al conjunto todas las categorías que se desee.
En caso de no encontrar una adecuada, se puede solicitar su creación a la siguiente casilla de correo electrónico: catalogodatos@agesic.gub.uy.
Etapa 5 - Finalizar publicación
Cada conjunto de datos subido al Catálogo queda temporalmente en el estado Privado.
Luego de completar todos los pasos descritos anteriormente solo falta la revisión y aprobación por parte del equipo de Datos Abiertos de Agesic, el cual realizará un control de calidad de toda la información y los datos publicados antes de pasarlo a estado Público.
Es recomendable realizar una revisión del nuevo conjunto con el apoyo del documento: “Buenas prácticas para la Publicación de Datos Abiertos”, en el que se describen y dan ejemplos concretos sobre una correcta publicación.
Campos obligatorios que serán controlado:
Imagen 13: Listado de campos obligatorios que hay que completar
Nota: Por cada recurso que se publica, se genera automáticamente una visualización de vista previa por defecto, si es que los datos lo permiten.