Kurzbefehle & App Intents

Verfügbare Intents

Gesundheitsdaten von gestern exportieren

Kurzbefehl ohne Parameter. Der schnellste Weg, um einfach die gestrigen Daten zu exportieren. Verwendet dieselbe Engine wie der manuelle Export. Optionaler Parameter Profil (siehe Export-Profile).

Gesundheitsdaten für ein Datum exportieren

Ein einzelner Parameter Datum. Die Uhrzeit wird ignoriert. Nützlich für kalendergesteuerte Automationen. Optionaler Parameter Profil.

Gesundheitsdaten für einen Datumsbereich exportieren

Die Parameter Startdatum und Enddatum, beide einschließlich. Für rückwirkende Exporte. Optionaler Parameter Profil.

Gesundheitsdaten der letzten N Tage exportieren

Parameter Anzahl der Tage (1–366). Endet gestern. Standardwert 7. Geeignet für Automationen wie „jeden Sonntag die letzten 7 Tage exportieren“. Optionaler Parameter Profil.

Gesundheitszusammenfassung für ein Datum abrufen

Gibt eine strukturierte Momentaufnahme mit Schritten, aktiven Kalorien, Schlaf und Herzfrequenz zurück, ohne etwas in den Vault zu schreiben. Verwenden Sie die Werte in Kurzbefehlen für andere Apps.

Status des letzten Exports abrufen

Gibt Zeitstempel, Erfolgsstatus, Zahl der Tage und mögliche Fehlerursache des zuletzt aufgezeichneten Exports zurück. Eine Anfrage bei gesperrtem Gerät bleibt bis zum erneuten Versuch ausstehend und wird daher nicht als aktueller Status zurückgegeben.

Geplanten Export ein- oder ausschalten

Boolescher Parameter. Unterbrechen Sie damit den Zeitplan, etwa während eines Urlaubsfokus, und setzen Sie ihn später fort.

Export-Profile

Gespeicherte Export-Profile können in Health.md auf dem iPhone oder unter Android erstellt und verwaltet werden. Auf Apple-Plattformen ist die Profilverwaltung derzeit nur für das iPhone dokumentiert; eine Verfügbarkeit auf iPad oder macOS wird nicht behauptet.

Alle vier Export-Intents akzeptieren einen optionalen Profil-Parameter. Sobald Profile vorhanden sind, verwendet ein leerer Parameter das aktive Profil; im Legacy-Modus ohne Profile werden die aktuellen In-App-Exporteinstellungen verwendet. Übergeben Sie den Namen eines gespeicherten Profils, um die eingefrorene Konfiguration dieses Profils — Metrikauswahl, Formate und Ziel — auszuführen, unabhängig davon, was die App gerade anzeigt.

Hinweis für bestehende Shortcuts ohne Parameter.

Sobald Sie Ihr erstes Export-Profil in der App anlegen, exportiert ein Shortcut ohne gesetztes Profil mit den gespeicherten Einstellungen des aktiven Profils statt mit den Live-Einstellungen der App. Wenn Sie auf das alte Verhalten angewiesen sind, fixieren Sie den Shortcut auf ein konkretes Profil (oder behalten Sie null Profile), um explizit zu bleiben. Ein nicht mehr existierender Profilname schlägt mit einer klaren Fehlermeldung fehl, statt das Falsche zu exportieren.

## So finden Sie die Intents

Öffnen Sie Kurzbefehle unter iOS oder macOS. Tippen Sie zum Erstellen eines Kurzbefehls auf + und suchen Sie nach „Health.md“ oder einem der obigen Intent-Namen. Sie befinden sich in der Kategorie Health.

Die meisten Intents verwenden openAppWhenRun = false und werden daher ohne App-Start oder sichtbare Oberfläche ausgeführt. Sie funktionieren in Automationen, Fokusfiltern, bei Aufrufen über Hey Siri und über die Aktionstaste.

Die Ausführung im gesperrten Zustand entsperrt HealthKit nicht.

Apple schützt HealthKit-Daten bei gesperrtem iPhone und entzieht Apps den Zugriff ungefähr zehn Minuten nach dem Sperren. Ausführung im gesperrten Zustand erlauben lässt Kurzbefehle die Aktion starten, setzt den HealthKit-Datenschutz aber nicht außer Kraft. Auch die Berechtigung für App-Inhalte von Health.md in Kurzbefehle ändert daran nichts.

Ist HealthKit nicht verfügbar, merkt sich Health.md die angefragten Daten als ausstehend und sendet die Mitteilung Gesundheitsexport erfordert Aufmerksamkeit. Entsperren Sie das iPhone und tippen Sie anschließend auf die Mitteilung oder öffnen Sie Health.md, um es erneut zu versuchen. Solange das Telefon gesperrt bleibt, kann ein vollständig unbeaufsichtigter Export nicht garantiert werden.

Rezept: täglicher Export mit Bestätigung

1. Persönliche Automation → Tageszeit → wählen Sie eine Uhrzeit, zu der Sie Ihr entsperrtes iPhone gewöhnlich verwenden, etwa 8:00 AM.
2. Intent Gesundheitsdaten von gestern exportieren.
3. Intent Status des letzten Exports abrufen.
4. Mitteilung anzeigen mit dem Ergebnis.

Hinweis zu ausstehenden Statuswerten: Status des letzten Exports abrufen liest den jüngsten aufgezeichneten Eintrag im Exportverlauf. Wenn HealthKit bei diesem Durchlauf wegen der Gerätesperre nicht verfügbar war, kann bis zum erneuten Versuch weiterhin der vorherige Export angezeigt werden. Für ausstehende Aufgaben ist die Wiederherstellungsmitteilung von Health.md maßgeblich.

Rezept: einmaliger rückwirkender Export

1. Erstellen Sie einen Kurzbefehl.
2. Gesundheitsdaten für einen Datumsbereich exportieren mit Start = 2024-01-01 und Ende = 2024-12-31.
3. Führen Sie ihn in Kurzbefehle aus. Das Jahr wird durchlaufen und pro Tag eine Datei geschrieben. Bei vollständigen Jahren kann dies einige Minuten dauern.

Rezept: Zeitplan im Urlaub pausieren

1. Fokusfilter: Wenn der Fokus Urlaub aktiviert wird, führen Sie Geplanten Export ein- oder ausschalten mit Aktiviert = false aus.
2. Führen Sie den Intent beim Deaktivieren des Fokus erneut mit Aktiviert = true aus.

Autorisierung erforderlich.

Intents übernehmen die HealthKit-Berechtigung und Vault-Auswahl der App. Sie schlagen mit einer eindeutigen Fehlermeldung fehl, wenn die App auf diesem Gerät nicht mindestens einmal geöffnet und eingerichtet wurde.

Verwandte Themen

QuelleZeitplanung – die entsprechende Schaltfunktion in der App. QuelleExport – die entsprechenden Datumsbereichsfunktionen in der App.