Guide général des automatisations

Les automatisations vous permettent d’exporter et de synchroniser automatiquement vos données Apple Health vers diverses destinations sans intervention manuelle. Ce guide présente la fonctionnalité et renvoie vers des guides détaillés pour chaque type d’automatisation.

Aperçu

Les automatisations sont des flux de travail configurés qui exportent automatiquement vos données de santé vers des services externes, du stockage cloud ou d’autres destinations. Une fois configurées, elles peuvent s’exécuter automatiquement en arrière-plan.

Avantages :

• Sauvegarde et synchronisation automatiques des données
• Aucune intervention manuelle requise
• Fréquence de synchronisation configurable
• Plusieurs types d’automatisation selon les cas d’usage
• Fonctionnement en arrière-plan (l’app n’a pas besoin d’être ouverte)

Cas d’usage :

• Sauvegardes cloud automatiques
• Intégration avec des systèmes domotiques
• Intégrations API pour des applications personnalisées
• Plateformes d’analyse et de visualisation de données
• Partage de données de santé avec des professionnels de santé

Limitations :

• Accès aux données de santé : Les apps ne peuvent pas accéder aux données de santé lorsque l’iPhone est verrouillé. Les automatisations ne s’exécutent que lorsque l’appareil est déverrouillé. C’est une limitation imposée par Apple, impossible à contourner. En savoir plus
• Traitement en arrière-plan : iOS limite le traitement en arrière-plan pour préserver la batterie. Les automatisations dépendent de l’actualisation en arrière-plan de l’app et peuvent ne pas s’exécuter immédiatement si :
  • L’actualisation en arrière-plan est désactivée pour l’app
  • L’appareil est en mode Économie d’énergie
  • L’appareil est resté inactif longtemps
  • Les ressources système sont contraintes
  • Plusieurs apps se disputent le temps d’exécution en arrière-plan
• Planification : Lié au traitement en arrière-plan, iOS n’autorise pas non plus les apps à s’exécuter en arrière-plan à une heure précise. Même avec une cadence de synchronisation définie, les automatisations ne sont pas garanties à l’heure indiquée. L’appareil doit être déverrouillé ; iOS décide quand l’automatisation s’exécute en arrière-plan. Les automatisations peuvent aussi être déclenchées manuellement :
  • Widget Automatisations : touchez l’icône du widget pour déclencher l’automatisation
  • Shortcuts — Exécuter l’automatisation : utilisez l’action Exécuter l’automatisation pour déclencher une automatisation configurée (voir Planifier une automatisation avec Shortcuts)
  • Déclenchement manuel dans l’app : ouvrez l’automatisation dans Health Auto Export, puis effectuez une exportation manuelle
• Synchronisation au premier plan : Tant que Health Auto Export est ouverte au premier plan, les automatisations éligibles peuvent se relancer à intervalle régulier (environ toutes les 60 secondes). L’appareil reste actif pendant l’utilisation au premier plan pour que la synchronisation continue. La boucle au premier plan ne s’interrompt que lorsque l’appareil atteint l’état thermique critique ; dans des conditions plus chaudes (non critiques), la synchronisation au premier plan peut rester possible. Les limitations de planification en arrière-plan ci-dessus s’appliquent toujours lorsque l’app n’est pas au premier plan.

Performances

Gardez à l’esprit qu’iOS est optimisé pour des tâches de courte durée sur un appareil mobile avec des contraintes de performance très strictes. Les tâches en arrière-plan doivent généralement se terminer en 30 secondes et sont limitées en mémoire. Health Auto Export offre une grande flexibilité et personnalisation, ce qui demande de prendre le temps de comprendre comment certaines configurations affectent les performances de l’app et les résultats.

• Configuration : Les automatisations qui produisent de grandes quantités de données peuvent amener le système à arrêter le processus et empêcher les automatisations de s’exécuter en arrière-plan. Les configurations suivantes peuvent produire de grandes quantités de données :
  • Automatisations configurées pour exporter toutes les métriques de santé.
    • Recommandation : ne sélectionnez que les métriques de santé qui ont des données enregistrées dans Apple Health et uniquement les données que vous prévoyez d’utiliser. Même les types de données vides ont un impact sur les performances. Vous pouvez aussi répartir les métriques sélectionnées sur plusieurs automatisations, ce qui facilite le travail du système.
  • Automatisations utilisant un regroupement temporel en secondes ou minutes, ou avec Résumer les données désactivé. De telles requêtes très fines peuvent être longues à exécuter et entrer en conflit avec les limitations du système.
    • Recommandation : même s’il peut sembler idéal d’avoir les données les plus détaillées possible, demandez-vous si ce niveau de détail est nécessaire pour chaque métrique ou type de données. Envisagez plusieurs automatisations avec des paramètres différents.
  • Lors de l’exportation d’entraînements en plein air (vélo, course, randonnée, etc.) avec données d’itinéraire, le GPS et les métriques de santé associées peuvent produire de grandes charges utiles.
• Taille de la charge utile : Surtout avec l’exportation REST API, gardez à l’esprit que de grandes charges peuvent provoquer des erreurs serveur. Assurez-vous que votre backend peut gérer des charges pouvant atteindre plusieurs centaines de mégaoctets pour éviter les erreurs.
• Fréquence de synchronisation : Ajoutez le widget Automatisations à l’écran d’accueil pour favoriser l’exécution réussie des automatisations en arrière-plan (voir Guide de configuration du widget Automatisations).

Types d’automatisation disponibles

Health Auto Export prend en charge plusieurs types d’automatisation, chacun adapté à des cas d’usage précis :

REST API

Envoyez des données de santé vers tout service web acceptant des requêtes HTTP POST. Idéal pour des backends personnalisés, des webhooks et des API tierces.

Guide : Guide d’automatisation REST API

Home Assistant

Synchronisez les métriques de santé vers Home Assistant en tant qu’états de capteurs. Parfait pour intégrer les données de santé à vos automatisations domotiques.

Guide : Guide d’automatisation Home Assistant

MQTT

Publiez des données de santé sur un broker MQTT. Idéal pour les plateformes IoT et les systèmes basés sur MQTT.

Guide : Guide d’automatisation MQTT

Dropbox

Sauvegardez automatiquement les données de santé sur Dropbox. Les fichiers sont organisés en dossiers et accessibles depuis tout appareil.

Guide : Guide d’automatisation Dropbox

Google Drive

Sauvegardez automatiquement les données de santé sur Google Drive. Les fichiers CSV peuvent être convertis en Google Sheets pour une consultation facile.

Guide : Guide d’automatisation Google Drive

iCloud Drive

Enregistrez les données de santé directement sur iCloud Drive. Configuration simple sans authentification supplémentaire.

Guide : Guide d’automatisation iCloud Drive

Calendrier

Créez des événements de calendrier à partir de vos données de santé. Visualisez entraînements, jalons de santé et autres événements dans votre calendrier.

Guide : Guide d’automatisation Calendrier

Créer votre première automatisation

1. Accédez à l’écran Exportations automatisées depuis la navigation principale
2. Touchez « Nouvelle automatisation »
3. Sélectionnez un type d’automatisation
4. Configurez les paramètres spécifiques au type (voir les guides individuels)
5. Configurez les paramètres communs (type de données, cadence de synchronisation, etc.)
6. Touchez « Mettre à jour » pour enregistrer
7. Activez l’automatisation

Sauvegarde et restauration de vos automatisations

Health Auto Export peut sauvegarder les paramètres de vos automatisations sur iCloud Drive pour les restaurer sur un nouvel appareil ou après réinstallation de l’app. C’est distinct des données de santé exportées par vos automatisations.

• Où sont les sauvegardes : Les paramètres d’automatisation sont enregistrés en fichiers JSON sur iCloud Drive, dans le dossier Auto Export/Automations (visible dans l’app Fichiers).
• Quand les sauvegardes sont faites : Chaque fois que vous enregistrez une automatisation (en touchant Mettre à jour ou en quittant l’écran d’édition), cette automatisation est sauvegardée automatiquement.
• Activer ou désactiver : Ouvrez une liste d’automatisations et allez dans Paramètres d’automatisation, puis utilisez Sauvegarder sur iCloud Drive. C’est activé par défaut. Si vous le désactivez, il vous sera demandé si vous voulez supprimer les fichiers de sauvegarde existants sur iCloud Drive — vos automatisations restent sur l’appareil dans tous les cas.

Restauration

Si vous ouvrez Exportations automatisées sans automatisations mais que des sauvegardes sont disponibles sur iCloud Drive, un bouton Restaurer depuis iCloud Drive apparaît. En le touchant, vos automatisations sont récupérées.

Quelques points à savoir après la restauration :

• Reconnectez vos comptes : Pour votre confidentialité, les jetons de connexion pour des services comme Dropbox et Google Drive ne sont pas inclus dans les sauvegardes. Après la restauration, reconnectez ces services dans chaque automatisation.
• Réactivez les automatisations : Les automatisations restaurées démarrent désactivées pour qu’aucune ne s’exécute de façon inattendue avec des paramètres obsolètes. Vérifiez chacune et activez-la quand vous êtes prêt.
• Restaurations partielles : Si certaines automatisations ne peuvent pas être restaurées (par exemple un fichier pas encore téléchargé, la clé de chiffrement pas encore disponible ou une automatisation créée par une version plus récente de l’app), les autres sont quand même restaurées et vous verrez lesquelles ont été ignorées.

Note : Les en-têtes de requête et identifiants saisis dans une automatisation (comme un mot de passe MQTT) sont chiffrés dans les fichiers de sauvegarde iCloud Drive. La restauration sur un nouvel appareil nécessite iCloud Keychain pour que l’app puisse les déchiffrer. Les fichiers de partage ou d’exportation manuelle restent du JSON non chiffré.

Journaux d’activité

Chaque automatisation dispose de Journaux d’activité pour son historique d’exécution.

1. Ouvrez l’automatisation et touchez Afficher les journaux d’activité.
2. Les événements sont regroupés par exécution (les plus récentes en premier). Développez une exécution pour voir les événements individuels.
3. Les avertissements (par ex. requête lente de données de santé) signifient que l’exécution s’est terminée mais qu’une étape a pris plus de temps que prévu. Les erreurs signifient qu’une étape a échoué (envoi, lecture HealthKit, authentification, etc.).
4. Effacer (barre d’outils) supprime uniquement l’historique d’activité de cette automatisation, pas les journaux de diagnostic de toute l’app.
5. Partager (barre d’outils) exporte le ZIP de diagnostic complet des Journaux d’événements de l’app — le même bundle que Réglages → Avancé → Exporter les journaux d’événements. Voir le Guide des journaux d’événements de l’app.

Requêtes lentes dans les journaux d’activité

• Si une automatisation met longtemps à récupérer les données de santé, les journaux d’activité peuvent afficher des avertissements requête lente de données de santé, pas des erreurs.
• Pour accélérer les exécutions : sélectionnez moins de métriques de santé, utilisez une plage de dates plus courte, activez Résumer les données et choisissez un Regroupement temporel plus large (heures, jours ou semaines).
• Les automatisations en temps réel utilisent un regroupement plus fin par conception et peuvent enregistrer plus souvent des avertissements de requête lente.

Avertissement sur les paramètres d’exportation

Lors de la configuration d’une automatisation de métriques de santé (pas Home Assistant), un pied de page peut apparaître sous Paramètres d’exportation si la configuration risque d’être lente :

• Résumer les données est désactivé, ou le regroupement temporel est en minutes ou secondes, et
• Plus de 10 métriques de santé sont sélectionnées

Le pied de page suggère moins de métriques, une plage de dates plus courte, Résumer les données ou un regroupement temporel plus grossier. Il renvoie vers ce guide. Les avertissements de requête lente dans les journaux d’activité sont distincts et apparaissent après une exécution lorsque les requêtes dépassent les seuils.

Bonnes pratiques

1. Synchronisation automatique :

• Chargez l’appareil et utilisez la duplication iPhone
  • Pendant la charge, iOS impose moins de restrictions de performance, ce qui permet une synchronisation plus fréquente
  • Avec la duplication iPhone, l’appareil se comporte comme s’il était déverrouillé. Health Auto Export peut ainsi accéder aux données de santé pour exécuter des actions automatisées

2. Fréquence de synchronisation :

• Trouvez un équilibre entre fraîcheur des données et utilisation des ressources
• Une synchronisation quotidienne convient à la plupart des cas
• Synchronisation plus fréquente pour les besoins en temps réel
• Synchronisation moins fréquente pour les données résumées

3. Sélection des données :

• Ne sélectionnez que les métriques nécessaires
• Réduit le temps de traitement et la taille des données
• Envisagez des automatisations séparées pour différents groupes de métriques

4. Tests :

• Lancez une exportation manuelle
• Vérifiez que les données apparaissent à la destination
• Consultez les journaux d’activité pour les erreurs
• Surveillez de près les premières synchronisations

5. Surveillance :

• Consultez régulièrement les journaux d’activité
• Vérifiez les indicateurs d’état des automatisations
• Configurez des notifications pour les automatisations importantes
• Surveillez la destination pour confirmer la réception des données

6. Sécurité :

• Utilisez des méthodes d’authentification sécurisées
• Maintenez les identifiants à jour
• Utilisez HTTPS/TLS lorsque disponible
• Vérifiez les paramètres de confidentialité

7. Performances :

• Utilisez un regroupement temporel adapté
• Tenez compte de la plage de dates pour le stockage cloud
• Surveillez l’utilisation de la batterie et des données
• Consultez les journaux d’activité pour les avertissements de requête lente

8. Stratégie de sauvegarde :

• Utilisez plusieurs types d’automatisation pour la redondance
• Combinez stockage cloud et intégrations API
• Conservez des sauvegardes locales lorsque possible
• Testez les procédures de restauration

9. Dépannage :

• Consultez d’abord les journaux d’activité
• Vérifiez la connectivité réseau
• Vérifiez les identifiants d’authentification
• Consultez les guides de chaque automatisation pour les problèmes spécifiques

Widget Automatisations

Ajoutez le widget « Automatisations » à l’écran d’accueil pour :

• voir l’état des automatisations d’un coup d’œil
• déclencher manuellement des automatisations
• optimiser les envois en arrière-plan

Obtenir de l’aide

Si vous avez besoin d’aide pour un type d’automatisation précis :

1. Consultez le guide de cette automatisation
2. Vérifiez les journaux d’activité pour les messages d’erreur
3. Consultez les sections de dépannage
4. Contactez le support si les problèmes persistent