Documentación

Widgets, Atajos y automatizaciones

Añade, consulta o elimina medidas con widgets, Atajos y App Intents.

Actualizado el 7 de septiembre de 2026

Los widgets y Atajos permiten utilizar una serie sin abrir DataJot. Primero crea la serie que recibirá las medidas.

Añadir una medida con Atajos

  1. En la app Atajos, crea un atajo y añade la acción de DataJot para añadir una medida.
  2. Selecciona una serie o introduce su clave.
  3. Proporciona un valor numérico y, si es necesario, una fecha.
  4. Ejecuta el atajo y comprueba la medida en DataJot.

Un valor fijo como 1 sirve para un contador. Para un valor variable, añade una acción de Atajos que solicite o recupere el valor antes de pasarlo a DataJot.

Una acción que utiliza una clave se dirige a la primera serie que coincida. Las claves no son necesariamente únicas: comprueba el destino antes de usar el atajo en una automatización.

Acciones de Atajos disponibles

Algunas acciones se dirigen a una serie seleccionada y otras utilizan su clave. El catálogo siguiente enumera los parámetros y el resultado de cada acción.

Añadir valores

AddMeasureIntent

Nombre mostrado: Añadir un valor

Descripción

Añade un valor nuevo a una serie seleccionada. También configura el widget de adición.

Parámetros

series obligatorio, newValue usa 1.0 de forma predeterminada y date es opcional.

Resultado / efecto

Crea una medida. Si date está vacío, DataJot utiliza la fecha actual. Recarga las líneas de tiempo de WidgetKit.

AddMeasureByKeyIntent

Nombre mostrado: Añadir un valor por clave de serie

Descripción

Añade un valor a la primera serie cuya clave coincida.

Parámetros

seriesKey obligatorio, newValue usa 1.0 de forma predeterminada y date es opcional.

Resultado / efecto

Crea una medida en la primera serie encontrada por su clave. Recarga los widgets.

Crear categorías y series

CreateCategoryIntent

Nombre mostrado: Crear una categoría

Descripción

Crea una categoría de DataJot.

Parámetros

name obligatorio; key, descriptionText y color opcionales.

Resultado / efecto

Devuelve una CategoryEntity. El nombre y la clave se recortan; no se admite un nombre vacío.

CreateSeriesIntent

Nombre mostrado: Crear una serie

Descripción

Crea una serie completa de DataJot.

Parámetros

name obligatorio; key, category, descriptionText, unitLabel, iconName, color, precision, aggregationMethod, chartType y defaultView opcionales.

Resultado / efecto

Devuelve una SeriesEntity. Si se proporciona unitLabel, DataJot crea una unidad personalizada 1:1.

CreateSeriesFromTemplateIntent

Nombre mostrado: Crear una serie a partir de una plantilla

Descripción

Crea una serie de DataJot a partir de una plantilla.

Parámetros

template obligatorio; category y nameOverride opcionales.

Resultado / efecto

Devuelve una SeriesEntity. DataJot carga las plantillas según la locale actual (fr, en, de o es), reutiliza las unidades y configuraciones existentes cuando es posible y elimina la clave de la plantilla de la serie nueva.

Consultar series y agregados

FetchSeriesListIntent

Nombre mostrado: Consultar series

Descripción

Consulta las series, con un filtro opcional por categoría.

Parámetros

category opcional.

Resultado / efecto

Devuelve [SeriesEntity], ordenadas por nombre.

FetchSeriesAggregateIntent

Nombre mostrado: Consultar el agregado de una serie

Descripción

Consulta el último agregado no vacío de una serie.

Parámetros

series obligatorio; from, to y aggregationMethod opcionales; granularity usa day de forma predeterminada.

Resultado / efecto

Devuelve una SeriesAggregateEntity con la serie, el periodo, la granularidad, el método, la fecha, el valor y el número de medidas. Si no se indica ninguna fecha, el intervalo predeterminado son los últimos 30 días.

FetchSeriesAggregateByKeyIntent

Nombre mostrado: Consultar el agregado por clave de serie

Descripción

Aplica la misma lógica que FetchSeriesAggregateIntent a la primera serie cuya clave coincida.

Parámetros

seriesKey obligatorio, from, to, granularity y aggregationMethod.

Resultado / efecto

Devuelve una SeriesAggregateEntity.

Exportar y eliminar medidas

ExportSeriesCSVIntent

Nombre mostrado: Exportar una serie como CSV

Descripción

Exporta una serie como CSV.

Parámetros

series obligatorio; scope usa all de forma predeterminada; from y to opcionales.

Resultado / efecto

Devuelve un IntentFile CSV. El ámbito all ignora las fechas; el ámbito period requiere al menos from o to. Se admiten límites abiertos por un lado.

ExportSeriesCSVByKeyIntent

Nombre mostrado: Exportar una serie como CSV por su clave

Descripción

Realiza la misma exportación que ExportSeriesCSVIntent, pero utiliza la clave de la serie.

Parámetros

seriesKey obligatorio, scope, from y to.

Resultado / efecto

Devuelve un archivo CSV para la primera serie cuya clave coincida.

DeleteSeriesMeasuresIntent

Nombre mostrado: Eliminar valores de una serie

Descripción

Elimina todos los valores de una serie o los incluidos en un periodo.

Parámetros

series obligatorio; scope usa all de forma predeterminada; from y to.

Resultado / efecto

Devuelve una SeriesMeasureDeletionResultEntity con la serie y el número de medidas eliminadas. El ámbito period requiere from y to. Recarga los widgets.

DeleteSeriesMeasuresByKeyIntent

Nombre mostrado: Eliminar valores por clave de serie

Descripción

Realiza la misma eliminación que DeleteSeriesMeasuresIntent, pero utiliza la clave de la serie.

Parámetros

seriesKey obligatorio, scope, from y to.

Resultado / efecto

Elimina las medidas de la primera serie cuya clave coincida y devuelve el número eliminado.

Automatizar una medida

  1. Crea el atajo y pruébalo primero de forma manual.
  2. En Atajos, crea una automatización con el activador necesario.
  3. Añade el atajo o la acción configurada de DataJot.
  4. Prueba la automatización y comprueba la serie de destino.

La app Atajos determina los activadores disponibles y las posibles solicitudes de confirmación. DataJot solo recibe los parámetros enviados a su acción.

Widget de adición rápida

El widget de adición registra un valor predefinido en una serie. Está disponible en tamaño pequeño y mediano y muestra el agregado del día actual.

Añade el widget desde la interfaz del sistema y edítalo para seleccionar la serie y el valor numérico. Cada toque añade una nueva medida.

El contenido mostrado se actualiza de forma periódica, aproximadamente cada quince minutos. No se actualiza en tiempo real.

Widget de gráfico

El widget de gráfico muestra una serie durante un día, una semana, un mes, seis meses o un año, junto con su último valor disponible.

Añade el widget desde la interfaz del sistema y edítalo para seleccionar la serie y el rango. Los tamaños mediano y grande también pueden mostrar las estadísticas activadas en la configuración de la serie.

Al igual que el widget de adición, su contenido se actualiza de forma periódica y no en tiempo real.

Eliminar medidas con Atajos

Esta acción es destructiva y DataJot no solicita confirmación en Atajos.

  1. Añade la acción para eliminar por serie o por clave.
  2. Elige Todas las medidas o indica un periodo válido.
  3. Comprueba la serie y el periodo antes de ejecutar la acción.

Las medidas seleccionadas se eliminan de forma permanente. Prueba este tipo de atajo únicamente con datos que puedas permitirte perder.