Shortcuts et App Intents
App Intents disponibles
Section intitulée « App Intents disponibles »Profils d’export
Section intitulée « Profils d’export »Créez et gérez des profils d'export enregistrés dans Health.md sur iPhone ou Android. Sur les plateformes Apple, la gestion des profils est actuellement documentée uniquement pour l'iPhone ; aucune disponibilité sur iPad ou macOS n'est revendiquée.
Les quatre intents d'export acceptent un paramètre facultatif Profil. Dès que des profils existent, laisser le paramètre vide utilise le profil actif ; en mode historique sans profil, les réglages d'export actuels de l'app sont utilisés. Indiquez le nom d'un profil enregistré pour exécuter la configuration figée de ce profil — sélection de métriques, formats et destination — quel que soit l'état actuel de l'app.
Dès que vous créez votre premier profil d'export dans l'app, un raccourci sans Profil défini exporte avec les réglages enregistrés du profil actif plutôt qu'avec les réglages actifs de l'app. Si vous comptez sur l'ancien comportement, épinglez le raccourci sur un profil précis (ou n'utilisez aucun profil) pour rester explicite. Un nom de profil qui n'existe plus échoue avec une erreur claire au lieu d'exporter la mauvaise chose.
Ouvrez l’app Shortcuts sur iOS ou macOS. Touchez + pour créer un raccourci, puis recherchez « Health.md » ou l’un des titres ci-dessus. Ils figurent dans la catégorie Health.
La plupart des intentions définissent openAppWhenRun = false et s’exécutent donc sans interface : aucun lancement d’app ni clignotement. Elles fonctionnent depuis les automatisations, les filtres de concentration, la commande « Dis Siri » et le bouton Action.
Apple protège les données HealthKit lorsque l’iPhone est verrouillé et retire l’accès aux apps environ dix minutes après le verrouillage. Allow Running When Locked autorise Shortcuts à lancer l’action, mais ne contourne pas la protection des données HealthKit. L’autorisation d’accès au contenu Health.md dans Shortcuts ne la contourne pas non plus.
Si HealthKit est indisponible, Health.md conserve les dates demandées en attente et publie une notification Health Export Needs Attention. Déverrouillez l’iPhone, puis touchez la notification ou ouvrez Health.md pour réessayer. Un export entièrement autonome ne peut être garanti tant que le téléphone reste verrouillé.
Recette : export quotidien avec confirmation
Section intitulée « Recette : export quotidien avec confirmation »- Automatisation personnelle → Heure de la journée → choisissez une heure à laquelle votre iPhone est généralement déverrouillé, par exemple 8:00 AM.
- Intention Export Yesterday's Health Data.
- Intention Get Last Export Status.
- Afficher une notification avec le résultat.
Remarque sur l’état en attente : Get Last Export Status lit la dernière entrée enregistrée dans l’historique. Si HealthKit était verrouillé, il peut encore afficher l’export précédent jusqu’à la nouvelle tentative. La notification de reprise de Health.md est l’indicateur de référence pour les tâches en attente.
Recette : récupération ponctuelle d’un historique
Section intitulée « Recette : récupération ponctuelle d’un historique »- Créez un raccourci.
- Export Health Data for Date Range avec start = 2024-01-01, end = 2024-12-31.
- Lancez-le depuis Shortcuts. Il parcourt l’année et écrit un fichier par jour. Une année complète peut demander quelques minutes.
Recette : suspendre la planification pendant les vacances
Section intitulée « Recette : suspendre la planification pendant les vacances »- Filtre de concentration : lorsque le mode Vacances s’active, exécutez Turn Scheduled Export On or Off avec Enabled = false.
- Lorsqu’il se désactive, relancez l’intention avec Enabled = true.
Les App Intents héritent de l’autorisation HealthKit et du coffre sélectionné dans l’app. Elles échouent avec un message clair si l’app n’a pas été ouverte et configurée au moins une fois sur cet appareil.