Widgets, Kurzbefehle und Automatisierungen

Eine Staerke von DataJot ist, dass Sie Werte nicht immer manuell in der App eingeben muessen. Sobald die Serie existiert, koennen Sie Messwerte aus einem Widget, einem manuellen Kurzbefehl oder einer Kurzbefehle-Automatisierung hinzufuegen.

Erstellen Sie zuerst die Serie, die die Messwerte erhalten soll. Die Seite Serien erklaert diesen Schritt.

Messwert ohne Oeffnen der App hinzufuegen

Die wichtigste Aktion ist das Hinzufuegen eines Messwerts. Sie erhaelt eine Zielserie und einen numerischen Wert. DataJot fuegt diesen Wert anschliessend der Serienhistorie hinzu.

Fuer einen Zaehler kann der Wert fest sein. Ein Kurzbefehl "Kaffee hinzufuegen" kann zum Beispiel 1 zur Serie "Kaffee" hinzufuegen.

Bei variablen Werten kann der Kurzbefehl den Wert vor dem Senden an DataJot abfragen. Das passt besser fuer Temperatur, Gewicht, Zaehlerstaende oder Messwerte, die Sie manuell ablesen.

Verfuegbare Kurzbefehle-Aktionen

DataJot stellt mehrere App Intents in der Kurzbefehle-App bereit. Einige Aktionen zielen direkt auf eine ausgewaehlte Serie, andere auf die erste Serie, deren Schluessel passt. Aktionen per Schluessel sind fuer stabile Automatisierungen praktisch, weil sie nicht vom angezeigten Seriennamen abhaengen.

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 oder en), 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.

Widgets

Widgets eignen sich fuer Werte, die Sie haeufig eintragen.

Beispiele:

einen Kaffee zaehlen;
einen Trainingssatz hinzufuegen;
einen aktuellen Wert schnell erfassen;
einen Verlauf direkt auf dem Home-Bildschirm sehen.

Apple Kurzbefehle

Kurzbefehle sind sinnvoll, wenn ein Wert aus einer anderen Quelle kommt oder Teil einer Routine ist.

Sie koennen zum Beispiel einen HomeKit-Sensor lesen und den Wert anschliessend in DataJot speichern.

Automatisierungen

Automatisierungen fuehren Kurzbefehle zu bestimmten Zeiten oder nach Ausloesern aus. Damit koennen Sensorwerte regelmaessig gespeichert werden, ohne dass Sie selbst daran denken muessen.

Pruefen Sie nach dem Einrichten, ob der Kurzbefehl wirklich den richtigen Sensor, die richtige Serie und die richtige Einheit verwendet.