Dokumentation

Widgets, Kurzbefehle und Automatisierungen

Messwerte mit Widgets, Kurzbefehlen und App Intents hinzufügen, anzeigen oder löschen.

Aktualisiert am 6. September 2026

Mit Widgets und Kurzbefehlen können Sie eine Serie verwenden, ohne DataJot zu öffnen. Erstellen Sie zuerst die Serie für die Messwerte.

Messwert mit Kurzbefehlen hinzufügen

  1. Erstellen Sie in der App Kurzbefehle einen Kurzbefehl und fügen Sie die DataJot Aktion zum Hinzufügen eines Messwerts hinzu.
  2. Wählen Sie eine Serie oder geben Sie ihren Schlüssel ein.
  3. Übergeben Sie einen numerischen Wert und bei Bedarf ein Datum.
  4. Führen Sie den Kurzbefehl aus und prüfen Sie den Messwert in DataJot.

Ein fester Wert wie 1 eignet sich für einen Zähler. Fügen Sie für einen variablen Wert eine Kurzbefehle-Aktion hinzu, die den Wert abfragt oder ermittelt, bevor sie ihn an DataJot übergibt.

Eine Aktion mit Schlüssel verwendet die erste passende Serie. Schlüssel sind nicht zwangsläufig eindeutig; prüfen Sie deshalb das Ziel, bevor Sie den Kurzbefehl automatisieren.

Verfügbare Kurzbefehle-Aktionen

Einige Aktionen verwenden eine ausgewählte Serie, andere ihren Schlüssel. Der folgende Katalog zeigt Parameter und Ergebnis jeder Aktion.

Werte hinzufuegen

AddMeasureIntent

Anzeigename: Wert hinzufuegen

Beschreibung

Fuegt einer ausgewaehlten Serie einen neuen Wert hinzu. Dient auch zur Konfiguration des Hinzufuegen-Widgets.

Parameter

series erforderlich, newValue standardmaessig 1.0, date optional.

Rueckgabe / Effekt

Erstellt einen Messwert. Wenn date leer ist, verwendet DataJot das aktuelle Datum. Laedt WidgetKit-Timelines neu.

AddMeasureByKeyIntent

Anzeigename: Wert per Serienschluessel hinzufuegen

Beschreibung

Fuegt der ersten Serie, deren Schluessel passt, einen Wert hinzu.

Parameter

seriesKey erforderlich, newValue standardmaessig 1.0, date optional.

Rueckgabe / Effekt

Erstellt einen Messwert in der ersten per key gefundenen Serie. Laedt Widgets neu.

Kategorien und Serien erstellen

CreateCategoryIntent

Anzeigename: Kategorie erstellen

Beschreibung

Erstellt eine DataJot-Kategorie.

Parameter

name erforderlich, key, descriptionText, color optional.

Rueckgabe / Effekt

Gibt eine CategoryEntity zurueck. Name und Schluessel werden bereinigt; ein leerer Name wird abgelehnt.

CreateSeriesIntent

Anzeigename: Serie erstellen

Beschreibung

Erstellt eine vollstaendige DataJot-Serie.

Parameter

name erforderlich, danach key, category, descriptionText, unitLabel, iconName, color, precision, aggregationMethod, chartType, defaultView optional.

Rueckgabe / Effekt

Gibt eine SeriesEntity zurueck. Wenn unitLabel angegeben ist, erstellt DataJot eine benutzerdefinierte 1:1-Einheit.

CreateSeriesFromTemplateIntent

Anzeigename: Serie aus Vorlage erstellen

Beschreibung

Erstellt eine DataJot-Serie aus einer Vorlage.

Parameter

template erforderlich, category, nameOverride optional.

Rueckgabe / Effekt

Gibt eine SeriesEntity zurueck. DataJot laedt Vorlagen anhand der aktuellen Locale (fr, en, de oder es), verwendet vorhandene Einheiten und Konfigurationen nach Moeglichkeit wieder und entfernt anschliessend den Vorlagenschluessel aus der neuen Serie.

Serien und Aggregate lesen

FetchSeriesListIntent

Anzeigename: Serien abrufen

Beschreibung

Ruft Serien ab, optional nach Kategorie gefiltert.

Parameter

category optional.

Rueckgabe / Effekt

Gibt [SeriesEntity] zurueck, nach Name sortiert.

FetchSeriesAggregateIntent

Anzeigename: Serienaggregat abrufen

Beschreibung

Ruft das letzte nicht leere Aggregat einer Serie ab.

Parameter

series erforderlich, from, to optional, granularity standardmaessig day, aggregationMethod optional.

Rueckgabe / Effekt

Gibt SeriesAggregateEntity mit Serie, Zeitraum, Granularitaet, Methode, Datum, Wert und Anzahl der Messwerte zurueck. Standardfenster: die letzten 30 Tage, wenn kein Datum angegeben ist.

FetchSeriesAggregateByKeyIntent

Anzeigename: Aggregat per Serienschluessel abrufen

Beschreibung

Gleiche Logik wie FetchSeriesAggregateIntent, zielt aber auf die erste Serie mit passendem Schluessel.

Parameter

seriesKey erforderlich, from, to, granularity, aggregationMethod.

Rueckgabe / Effekt

Gibt SeriesAggregateEntity zurueck.

Messwerte exportieren und loeschen

ExportSeriesCSVIntent

Anzeigename: Serie als CSV exportieren

Beschreibung

Exportiert eine Serie als CSV.

Parameter

series erforderlich, scope standardmaessig all, from, to optional.

Rueckgabe / Effekt

Gibt eine CSV-IntentFile zurueck. Der Scope all ignoriert Datumswerte; der Scope period erfordert mindestens from oder to. Einseitige Grenzen sind erlaubt.

ExportSeriesCSVByKeyIntent

Anzeigename: Serie per Serienschluessel als CSV exportieren

Beschreibung

Gleicher Export wie ExportSeriesCSVIntent, aber per Serienschluessel.

Parameter

seriesKey erforderlich, scope, from, to.

Rueckgabe / Effekt

Gibt eine CSV-Datei fuer die erste Serie zurueck, deren Schluessel passt.

DeleteSeriesMeasuresIntent

Anzeigename: Werte einer Serie loeschen

Beschreibung

Loescht alle Werte einer Serie oder die Werte eines Zeitraums.

Parameter

series erforderlich, scope standardmaessig all, from, to.

Rueckgabe / Effekt

Gibt SeriesMeasureDeletionResultEntity mit Serie und Anzahl der geloeschten Messwerte zurueck. Der Scope period erfordert from und to. Laedt Widgets neu.

DeleteSeriesMeasuresByKeyIntent

Anzeigename: Werte per Serienschluessel loeschen

Beschreibung

Gleiche Loeschung wie DeleteSeriesMeasuresIntent, aber per Serienschluessel.

Parameter

seriesKey erforderlich, scope, from, to.

Rueckgabe / Effekt

Loescht Messwerte der ersten Serie, deren Schluessel passt, und gibt die Anzahl der geloeschten Messwerte zurueck.

Messwert automatisieren

  1. Erstellen und testen Sie den Kurzbefehl zunächst manuell.
  2. Erstellen Sie in Kurzbefehle eine Automatisierung mit dem gewünschten Auslöser.
  3. Fügen Sie den Kurzbefehl oder die konfigurierte DataJot Aktion hinzu.
  4. Testen Sie die Automatisierung und prüfen Sie die Zielserie.

Die App Kurzbefehle bestimmt verfügbare Auslöser und mögliche Bestätigungsabfragen. DataJot erhält nur die an seine Aktion übergebenen Parameter.

Widget zum schnellen Hinzufügen

Das Hinzufügen-Widget speichert einen voreingestellten Wert in einer Serie. Es ist in kleiner und mittlerer Größe verfügbar und zeigt das Aggregat des aktuellen Tages.

Fügen Sie das Widget über die Systemoberfläche hinzu und wählen Sie anschließend Serie und numerischen Wert. Jedes Antippen erzeugt einen neuen Messwert.

Der angezeigte Inhalt wird regelmäßig, ungefähr alle fünfzehn Minuten, aktualisiert. Er ist keine Echtzeitanzeige.

Diagramm-Widget

Das Diagramm-Widget zeigt eine Serie für einen Tag, eine Woche, einen Monat, sechs Monate oder ein Jahr sowie ihren letzten verfügbaren Wert.

Fügen Sie das Widget über die Systemoberfläche hinzu und wählen Sie Serie und Zeitraum. Mittlere und große Widgets können außerdem Statistiken anzeigen, die in der Serienkonfiguration aktiviert sind.

Auch dieses Widget wird regelmäßig und nicht in Echtzeit aktualisiert.

Messwerte mit Kurzbefehlen löschen

Diese Aktion ist destruktiv und DataJot fordert in Kurzbefehle keine Bestätigung an.

  1. Fügen Sie die Löschaktion nach Serie oder Schlüssel hinzu.
  2. Wählen Sie Alle Messwerte oder geben Sie einen gültigen Zeitraum an.
  3. Prüfen Sie Serie und Zeitraum, bevor Sie die Aktion ausführen.

Die betroffenen Messwerte werden dauerhaft gelöscht. Testen Sie einen solchen Kurzbefehl nur mit Daten, die verloren gehen dürfen.