Edición de datasets

Una vez se entra en un dataset alrededor de los datos se dispone de diferentes opciones para editar, explorar y personalizar los datos. El editor de dataset se divide en varias secciones:

• Barra de utilidades

• Menú desplegable de herramientas

• Cabeceras de los campos

• Celdas de datos

• Atajos de teclado

Barra de utilidades

Encima de las celdas de datos se encuentra la barra de utilidades del dataset. En ella se accede a las siguientes opciones:

Icono	Utilidad
	Ruta de la app
	Filtrar/Agregar
	Personalizar
/	Estado de la actualización
X/Y	Navegación en el dataset
/	Desplegar herramientas

Ruta del dataset

En la parte izquierda de la barra se muestra la ruta del dataset (en caso de no estar en la carpeta raiz) y su nombre. Los elementos de la ruta son enlaces a las carpetas correspondientes, si por ejemplo se hace clic en "Datasets" se enlazará con la página que muestra el contenido de la carpeta raiz.

Filtrar/Agregar

A partir de los datos originales del dataset se puede crear nuevo contenido. Esta opción da acceso al diálogo de consultas de Tabulae, en el cual se implementa la consulta deseada. Una vez que se tiene la consulta, hay un bloque final en el que se indica donde se sitúan los "nuevos" datos:

• Modificar el dataset: Ésta opción elimina la estructura anterior del dataset y solo deja los datos resultantes de acuerdo con la consulta implementada (número de columnas, tipo de datos y valores).

• Crear un dataset nuevo: A partir de los datos originales y la consulta implementada se crea un nuevo dataset. En este caso se genera una relación o ligadura "padre-hijo", es decir, los campos del "hijo" heredan la estructura de los campos originales del "padre" (identificador, tipo de datos, etc.).

  A parte de fijar el nombre del nuevo dataset (que por defecto se crea en la carpeta raiz "Datasets"), también se puede ligar la actualización de datos entre padre e hijo, esto es, que el hijo se actualice siempre que el padre se actualice (actualización automática).

  

  Info Es importante tener en cuenta que al tener los campos del dataset "hijo" los mismos identificadores que los del dataset "padre" ambos datasets responderán de igual forma a un filtro global.

  Warning Cuando se incluye un campo de naturaleza fórmula en la consulta de creación de un nuevo dataset (hijo) el campo continua siendo una fórmula si se han incluido todos los campos de los que depende. En caso contrario el campo, aunque está presente en el dataset hijo, se persiste, es decir, se cálcula y se guarda con los valores calculados. Pierde por tanto la naturaleza de fórmula ya que está no se puede resolver en el nuevo dataset.

Personalizar

Esta opción permite indicar las opciones de visualización de los datos del dataset que aparecerán por defecto en las aplicaciones. En función de la naturalez del campo son diferentes:

• Campos de tipo fecha

• Campos de tipo texto

• Campos de tipo número

Campos de tipo fecha

• Etiqueta: Permite indicar la etiqueta, que es el texto que se muestra en los widgets que contengan el campo. De no indicar ningún valor se muestra el nombre original del campo.

• Formato: Permite seleccionar el formato con el que se mostrarán las fechas en el gráfico, indicando por ejemplo si se muestra la fecha completa con horas y minutos, sólo el año, etc. El icono da acceso al detalle de las opciones de formato que se pueden usar.

  Warning: En caso de usar formato que incluya cadenas de texto, como el nombre de los días o de los meses, se usará por defecto el idioma predefinido en el navegador.

Campos de tipo texto

• Etiqueta: Permite indicar la etiqueta, que es el texto que se muestra en los widgets que contengan el campo. De no indicar ningún valor se muestra el nombre original del campo.

• Usar orden personalizado: Permite indicar un criterio de orden distinto al orden original del campo (bien el orden por defecto o el asignado en el dataset). Una vez activada la opción hay dos formas para ordenar este tipo de columnas:

  • Usar orden numérico: Esta opción ordenara los valores de la columna como si se tratasen de números, evitando el problema de que los valores que empiecen por el mismo número aparezcan en orden no desada (por ejemplo, los valores "1, 10, 11, 2, 20", ordenados alfanuméricamente se reordenan como "1, 2, 10, 11, 20").

  • Ordenar los valores: Se pueden ordenar los valores de la columna simplemente arrastrando los valores en la lista y situándolos según nuestras necesidades.

    Dentro de esta opción también se pueden añadir nuevos valores a la serie para ordenar. De este modo es posible incluir valores de la columna que actualmente no están presentes en los datos pero que pueden aparecer al actualizar el dataset o al añadir filas desde fichero.

    • Restaurar: Deshace todos los cambios hechos en para el criterio de orden y recupera los valores originales.

Campos de tipo número

• Etiqueta: Permite indicar la etiqueta, que es el texto que se muestra en los widgets que contengan el campo. De no indicar ningún valor se muestra el nombre original del campo.

• Precisión: Permite indicar el número de decimales que se mostrarán al visualizar los valores numéricos (el separador decimal depende del idioma elegido en Tabulae: en idioma español se usa la ",", y en inglés el ".").

• Separador de miles: Permite indicar si se quiere mostrar el separador de miles, millones, etc, al visualizar valores numéricos (el separador de miles depende del idioma elegido en Tabulae: en idioma español se usa el ".", y en inglés la ",").

• Convertir en porcentaje: Multiplica por 100 la medida, de tal forma que por ejemplo ratios del tipo A/B pasan a ser porcentuales.

Estado de la actualización

Cuando un dataset tiene como origen una BBDD externa (Sql o NoSql) o bien otro dataset de Tabulae puede actualizarse o refrescarse automáticamente. En este caso se muestra el estado ( OK / ERROR) y fecha de la última actualización.

Info En caso de haber un error en el proceso de refresco se puede ver un resumen del error haciendo clic sobre el estado de la actualización.

Navegación en el dataset

Al acceder a un dataset se muestran todos los campos del mismo (con scroll si es necesario), pero no todas las filas, solo las primeras 20. Si se desea navegar a lo largo del contenido del dataset se puede ir a la primera o última fila, o bien ir saltando de 20 en 20 filas hacia adelante o atrás. El contador X/Y indica que se está en la "hoja" número X de un total de Y.

Info El orden original del dataset es aquel en el que se suben los datos, no obstante se puede ordenar por un campo deseado para facilitar la navegación. También es posible hacer un análisis con cierto detalle gracias a la opción de búsqueda. Cualquiera de estas opciones afectan a la exploración del dataset, pero no a la visualización de los datos en las aplicaciones.

Desplegar herramientas

Al hacer clic en se despliega o repliega un menú con más opciones de uso del dataset, que se describen en la siguiente sección.

Menú desplegable de herramientas

Este menú superpuesto a la información del dataset da acceso a las siguientes opciones:

Información del dataset

El menú de información muestra datos básicos sobre el dataset, y además permite varias acciones básicas sobre el mismo. Se subdivide en 4 bloques:

• Información o metadatos

• Descargar datos

• Apps que usan el dataset

• Acciones sobre el dataset

Metadatos

El bloque METADATOS muestra la información básica del dataset:

• Identificador interno del dataset (interesante saber cuál es pues la URL que da acceso al mismo lleva este id)

• Nombre del dataset

• Descripción del dataset

• El carácter público o privado del dataset, que controla el acceso/uso de los usuarios de Tabulae.

• Las fechas de creación y última actualización del dataset

Descargar datos

En el bloque DESCARGAR se pueden descargar todos los datos del dataset en formato CSV o EXCEL.

Apps que usan el dataset

En el bloque APPS QUE USAN EL DATASET se listan las aplicaciones que referencian al dataset, es decir, que contienen algún widget que lo toma como origen de datos. Cada elemento de la lista es un enlace a la aplicación, por lo que haciendo clic se accede directamente a esa aplicación.

Acciones sobre el dataset

En la parte superior del menú hay tres iconos, los cuales permiten modificaciones del dataset. Son las siguientes:

• Editar metadatos

• Añadir filas desde fichero (CSV)

• Reiniciar dataset

Editar metadatos

Al hacer clic en el botón EDITAR se muestran varios bloques de metadatos donde se puede modificar la información.

• Metadatos: Se puede cambiar el nombre y la descripción del dataset.

• Visibilidad: Se puede variar el carácter privado (solo accesible para el usuario) o público (accesible para todos los usuarios, aunque solo editable para el propietario).

• Plan actualización: Este bloque aparece solo en caso de que el dataset provenga de una BBDD (Sql y No-Sql). Informa los parámetros de la actualización, de la conexión y la consulta Sql/No-Sql que se realiza, aunque unicamente se puede modificar la frecuencia de actualización. La modificación de la conexión en sí es un asunto delicado porque se precisa que se respete la estructura del dataset, y solo es accesible para usuarios administradores desde un menú en el propio dataset.

• Consulta: Este bloque solo aparecer en caso de ser el origen otro dataset de Tabulae. Informa el dataset origen o padre y la consulta propia de Tabulae que se realiza. No se permite modificar la información aquí, tal opción solo es accesible para usuarios administradores desde un menú en el propio dataset.

• Componentes permitidos como filtro de usuario. En este bloque se indican los ids de los campos que serán susceptibles de filtro por usuario. Para introducir la información hay que escribir el id del campo deseado y pulsar la tecla Enter.

  El filtrado por usuario va asociado a un plugin de usuario, que específica los valores accesibles para un usuario, y que hay que implementar en cada caso particular. Contactar con el administrador de Tabulae para obtener más información al respecto.

Añadir filas desde fichero (CSV)

Al hacer clic en el botón AÑADIR se permite, indpendientemente del origen de datos del dataset, hacer una actualización incremental de datos a partir de un fichero. Tabulae espera que el fichero CSV tenga tantos campos como columnas de datos (es decir, columnas que no sean fórmulas) y que el orden de los campos corresponda, al menos, con el tipo de datos esperado para cada campo de Tabulae. Una vez se lee el fichero, el usuario visualiza si la asignación autómatica de los campos del csv con los del dataset es correcta y permite la actualización.

Reiniciar dataset

Al hacer clic en el botón REINICIAR se permite vaciar el dataset y volver a introducir datos. Hay dos opciones para hacerlo:

• Solo datos: Vacía de datos el dataset conservando su estructura (origen, campos, personalización, etc.) intacta.

• Dataset completo: Descarta todos los cambios hechos en el dataset desde su creación, volviendo a comenzar desde el principio. Es decir, es equivalente a borrar el dataset existente y crear uno nuevo, pero con la diferencia de que el identificador del dataset y el resto de metadatos se conservan.

  Warning Si se reinicia de forma completa un dataset que está siendo usado por alguna aplicación, dicha aplicación dejaría de funcionar correctamente. Tabulae muestra un aviso con el listado de las aplicaciones asociadas al dataset que se quiere reiniciar.

Origen de datos

El menú de Origen de datos solo aparece para datasets con origen de datos una BBDD externa u otro dataset de Tabulae. Muestra la información asociada al origen, y además permite alguna acción sobre el mismo. Se subdivide en 3 bloques:

• Últimas actualizaciones

• Conexión

• Refrescar los datos

Últimas actualizaciones

El bloque ÚLTIMAS ACTUALIZACIONES muestra la información sobre las 3 últimas actualizaciones del dataset. En caso de haber algún error en las mismas se muestra el tipo de error que devuelve la BBDD.

Conexión

El bloque CONEXIÓN muestra información acerca de los parámetros de conexión:

• Tipo de BBDD: Indica el tipo de base de datos origen, por ejemplo MySql, MongoDB, Tabulae, etc.

• Host: Muestra el nombre o dirección ip del servidor origen de datos.

• Modo: Indica si la actualización es de tipo completa (vacía y carga de nuevo) o incremental.

• Dataset padre: En caso de proceder de otro dataset de Tabulae se indica el Id del mismo, el cual a su vez es un enlace mediante el cual se puede acceder a ese dataset.

Refresco de los datos

En la parte superior del menú está el botón REFRESCAR, el cual permite lanzar un proceso de actualización de datos, el que corresponda en función de los parámetros de actualización del dataset. Este proceso se ejecuta en cuánto el servidor de Tabulae disponga de suficientes recursos para hacerlo (lo cual generalmente es inmediato).

Warning Para verificar si el dataset se ha actualizado el usuario tiene que recargar la página asociada. Como el refresco se ejecuta cuando hay recursos suficientes no hay certeza de cuando se produce la actualización, y por tanto este proceso no se automatiza.

Jerarquías

El menú de Jerarquías permite crear y modificar las jerarquías entre columnas del dataset.

Una jerarquía es una relación de orden entre varios campos de tipo dimensión, que se puede ver en forma de esquema de árbol:

• El primer campo o nivel genera tantos nodos como valores tiene.

• De cada nodo de primer nivel salen varias ramas con los valores del segundo campo o nivel. Un valor de segundo nivel puede pertenecer a varios nodos de primer nivel.

• Si hay más niveles la estructura se replica. La última dimensión en el orden jerárquico es el último nivel de la jerarquía, siendo sus nodos "terminales".

Dentro del diálogo de creación de jerarquías se hace clic en el botón para crear una nueva jerarquía, o bien se hace clic sobre una de las ya disponibles para poder editarla.

A parte de fijar el nombre de la jerarquía, en la parte derecha del diálogo se seleccionan los campos que van a formar parte de ella. En la columna de dimensiones disponibles están todas las dimensiones del dataset, se hace clic sobre una de ellas y se arrastra a la columna de "seleccionadas". Este proceso se repite con todos los campos que se desee, aunque a la hora de usar una jerarquía en los diferentes widgets no es preciso incluir todos los campos que la conforman.

Para concluir hay que definir el orden de la jerarquía, para lo cual hay que hacer clic sobre los campos de la columna "seleccionadas" y arrastrar a la posición deseada.

Finalmente se puede eliminar una jerarquía haciendo clic sobre el botón "Eliminar".

Georreferenciar

El menú de Georreferenciación permite indicar que campos del dataset están georeferenciados, lo cual es necesario para poder usar widgets de tipo Mapa.

Al hacer clic en el botón i class="fa fa-plus" style="color:teal;"> </i> GEORREFERENCIAR Tabulae permite enlazar los valores del campo seleccionado con georreferencias, en función del tipo de dato:

1. Columnas con coordenadas geográficas (Latitud y Longitud en el sistema WGS84). En este caso se permite elegir una pareja de columnas de naturaleza numérica.

2. Columna con nombres de entidades geográficas (países, comunidades aútonomas, provincias, etc.). La librería de georeferenciación por defecto de Tabulae es limitada, actualmente se dispone del completo de paises y de las provincias y CCAA de España. Para disponer de una cartografía particular ponerse en contacto con el administrador de Tabulae.

3. Códigos ISO 3166-1 alpha-2 y alpha-3 de entidades geográficas (campo de tipo texto).

Cuando se georreferencia un campo de un dataset con valores que sean nombres de entidades geográficas (país, región, etc.) es posible que el sistema no sea capaz de relacionar correctamente el nombre almacenado en algunos registros con las entidades geográficas disponibles en Tabulae. En estos casos se muestra al usuario un icono de "aviso", y si se desea se puede acceder a la opción "Errores de georreferencias" para corregir o desambiguar las entidades que el sistema no haya sido capaz de reconocer correctamente.

En la parte derecha se muestran las opciones que el sistema considera que pueden estar relacionadas con el nombre de la entidad geográfica, indicando para cada una de ellas el nombre oficial, la jerarquía hasta el nivel de continente y el tipo de entidad a la que se refiere (país, comunidad autónoma, provincia, estado, etc.).

Además, la columna con el nombre de la entidad es editable pudiendo el usuario modificar ese nombre para refinar la búsqueda sin que sea necesario cambiar el nombre original en los datos.

Búsqueda

El menú de Búsqueda permite realizar una exploración del dataset usando filtros selectores para cada campo.

En el menú aparece un bloque para cada campo del dataset, que al desplegar muestra las opciones de filtrado:

• Campos de textos o fecha: Muestra todos los valores (únicos) de la dimensión. Se puede elegir el tipo de selección múltiple (varios valores a elección del usuario) o sencilla (un único valor permitido). También para facilitar la selección se dispone de una barra de búsqueda, donde escribiendo la cadena de texto deseada se muestran los valores compatibles con ella, reduciendo el número de valores accesibles para el filtrado.

• Campos numéricos: Permite filtrar valores por intervalo, introduciendo el valor numérico mínimo (Desde) y máximo (Hasta) en las cajas correspondientes (no es necesario fijar ambos valores, si hay uno desinformado no se aplica ese límite). Al escribir más de 3 cifras se le da automáticamente formato con separación de miles.

  Info En caso de querer añadir decimales se ha de usar el símbolo de puntuación que corresponde al idioma usado en Tabulae. Por ejemplo en español los decimales van separados por "," y los millares por ".", mientras que en inglés los decimales van separados por "." y los millares por ",".

Al hacer una selección sobre un campo se "ejecuta" el filtrado o selección elegido, de forma que cambia la vista del dataset, mostrando solo los registros compatibles con la selección. En ese caso aparece un icono tanto en la barra de utilidades como en el propio bloque del campo en el menú de búsqueda, para recordar al usuario que no está viendo una "sección" del dataset.

Parámetros de conexión

El menú da acceso a las funcionalidades de administración, entre las que está la de modificación de los parámetros de conexión (origen de datos) .

Esta opción es muy delicada, ya que una incorrecta modificación puede fácilmente corromper el dataset y éste quedaría inhabilitado para su uso desde las apps. Para asegurar su uso correcto solo es accesible por usuarios administradores de Tabulae.

El menú de edición de los parámetros de conexión es igual al de creación del propio dataset (donde se definieron por primera vez), conforme al tipo de origen del dataset. Unicamente se retiran del menú los parámetros que controlan la actualización del dataset, los cuales se modifican de forma normal al editar los metadatos del dataset.

Lista de componentes

El menú da acceso a las funcionalidades de administración, entre las que está la funcionalidad de modificación del orden o ubicación de los campos (columnas) dentro del dataset.

Esta opción es delicada, ya que en caso de tener el dataset un gran volumen de datos (millones de registros) consume gran parte de los recursos de la BBDD de Tabulae, lo que penaliza el uso de la herramienta. Para asegurar su uso correcto solo es accesible por usuarios administradores de Tabulae.

Sobre la lista de campos, donde se indica su tipo, nombre e id interno de Tabulae, no hay más que hacer clic sobre uno de ellos y arrastrar hasta la posición deseada. Al hacer clic en el botón OK se lanza la operación internamente en Tabulae, refrescándose el contenido del dataset cuando ésta termina.

Cabeceras de los campos

Esta sección permite hacer modificaciones sobre los datos y tipo de datos de cada una de las columnas (campos). Hay dos menús desplegables:

• Operaciones de columna

• Tipo de dato

• Operaciones de fila

Opciones de columna

Las operaciones de columna aparecen al hacer clic sobre el nombre de una columna. Permiten realizar ciertas las siguientes acciones:

• Col ID: Esta información es inmutable, y representa el identificador con el que Tabulae tratará internamente al campo en cuestión.

• Contador de columna: El contador indica la posición de la columna en el dataset, respecto del total de columnas del mismo (por ejemplo 4/6 indica la columna situada en cuarta posición de un total de 6).

• Ordenar : Permite ordenar (alfanuméricamente) los datos del dataset por una columna. Un clic ordena de forma ascendente, y un segundo clic de forma descendente.

• Renombrar : Permite renombrar una columna. Aunque posteriormente se puede asignar la etiqueta a cada campo que aparece en un widget en una aplicación, el nombre del campo es la etiqueta por defecto, y por tanto la que aparecerá en una app sino se indica lo contrario.

• Reemplazar : Permite reemplazar los valor de una columna. Para esta tarea se abrirá un diálogo con los diferentes valores que incluye la columna seleccionada. Editando cada una de las líneas se puede cambiar todas las apariciones de ese contenido en el dataset, es decir, se modificaran todas las celdas que contengan el texto original por el valor a reemplazar. Para facilitar la tarea, en caso de tener muchos valores, en la parte superior del menú hay una caja donde se puede escribir texto, lo cual mostrará los valores compatibles con la cadena indicada.

  

  Según se van modificando valores estos van siendo marcados en amarillo, indicando que tras hacer clic en el botón "Ok" estos serán modificados.

• Eliminar datos : Permite reducir el dataset dejando solamente las filas del dataset que cumplan el criterio seleccionado.

• Fijar unidad : Permite fijar la unidad en la que están representados los datos de la columna (solo para columnas numéricas).

  Info: En ocasiones las unidades pueden ser carácteres especiales (símbolos, superíndices, etc.). Si se precisa de alguno en especial no hay más que copiar el carácter y pegar en el diálogo de unidad de Tabulae. Se pueden consultar algunos de los disponibles en las referencias de charsets html utf-8 (ver por ejemplo estas referencias de símbolos y super/subíndices).

• Añadir una nueva columna : Permite añadir una nueva columna al dataset. La nueva columna se añadirá a la izquierda de la columna seleccionada.

  De igual forma, al pasar el puntero del ratón sobre el icono en la parte inferior derecha de la pantalla, si se selecciona la opción se añade una nueva columna a la derecha del dataset.

• Añadir una fórmula : Permite añadir una columna calculada al dataset (a la izquierda del campo seleccionado). En el diálogo de creación de fórmulas se introduce la fórmula que se desee (ver sección Fórmulas).

  De igual forma, al pasar el puntero del ratón sobre el icono en la parte inferior derecha de la pantalla, si se selecciona la opción se añade una nueva columna fórmula a la derecha del dataset.

• Discretizar : Dado un campo numérico permite crear un nuevo campo de tipo "Fórmula - Texto" (es por tanto una dimensión) definiendo tramos o intervalos para el campo original. Al hacer clic en esta opción aparece un nuevo menú donde se definen los intervalos y el valor (textual) asociado a cada uno de ellos.

  

  Los intervalos se pueden mover de posición, haciendo clic en el icono y arrastrando al lugar deseado, y también se pueden eliminar haciendo clic en el icono a la derecha del intervalo.

• Verificar georreferencias : Como se comentó anteriormente, esta opción existe solo para campos georeferenciados, y permite verificar y modificar las asociaciones hechas en el proceso de georreferenciación del dataset.

• Eliminar columna : Permite eliminar (permanentemente) la columna seleccionada.

Cambiar el tipo de datos

La parte izquierda de la cabecera muestra un icono diferente en función del tipo de dato al que corresponda el campo.

En caso de ser campos de tipo fórmula el icono se vuelve de color violeta .

Haciendo clic sobre él se puede cambiar (siempre que el cambio sea posible) a cualquiera de los tipos de dato disponibles.

Info Para modificar una columna a tipo fecha será necesario seleccionar el formato de fecha usado en los valores de dicha columna. Por ejemplo se selecciona "YYYY" cuando solo se disponga de 4 dígitos.

Opciones de fila

Las operaciones de fila aparecen al hacer clic sobre el icono a la izquierda de cada fila. Permiten realizar ciertas las siguientes acciones:

• Editar fila : Permite editar el contenido de una fila, y modificarlo campo por campo. En los campos de tipo fecha se indica el formato esperado (para no tener que escribir todo el formato UTC hasta el milisegundo).

  

• Eliminar fila : Permite eliminar (permanentemente) la fila seleccionada.

• Añadir fila: Al pasar el puntero del ratón sobre el icono en la parte inferior derecha de la pantalla, si se selecciona la opción Añadir fila se accede a un menú de edición de los campos de fila. Al introducir los valores y pulsar OK se añade una nueva fila al (final del) dataset.

Editar el contenido de las celdas

Para modificar una celda directamente solo hay que hacer clic en dicha celda sobre el valor ya existente e introducir el nuevo valor. Es necesario pulsar "Enter" para que los cambios tengan efecto.

En función del tipo del campo hay alguna particularidad:

• Campos numéricos: Los decimales se separan por el símbolo ".", y no hay formato de millares.

• Campos de tipo fecha: Siempre van en formato UTC, e informadas hasta el milisegundo (por ejemplo 2003-01-01T00:00:00.000Z).

Atajos de teclado

Hay ciertas acciones que se pueden agilizar mediante una cierta combinación de teclas, esto es, un atajo de teclado o shorcut. Siempre se puede consultar la lista de atajos de teclado disponibles mediante la combinación "shift + ?" (mayúsculas y cierre de interrogante).