Overzichtsgids voor automatiseringen

Met automatiseringen kunt u uw Apple Health-gegevens automatisch exporteren en synchroniseren naar verschillende bestemmingen zonder handmatige tussenkomst. Deze gids biedt een overzicht van de functie en links naar gedetailleerde gidsen per automatiseringstype.

Overzicht

Automatiseringen zijn geconfigureerde workflows die uw gezondheidsgegevens automatisch exporteren naar externe diensten, cloudopslag of andere bestemmingen. Na configuratie kunnen ze automatisch op de achtergrond draaien.

Voordelen:

• Automatische gegevensback-up en synchronisatie
• Geen handmatige tussenkomst nodig
• Configureerbare synchronisatiefrequentie
• Meerdere automatiseringstypen voor verschillende use-cases
• Achtergrondwerking (de app hoeft niet open te zijn)

Use-cases:

• Automatische cloudback-ups
• Integratie met domoticasystemen
• API-integraties voor eigen toepassingen
• Platforms voor data-analyse en visualisatie
• Gezondheidsgegevens delen met zorgverleners

Beperkingen:

• Toegang tot gezondheidsgegevens: Apps mogen geen gezondheidsgegevens lezen terwijl de iPhone vergrendeld is. Automatiseringen draaien alleen wanneer uw apparaat ontgrendeld is. Dit is een door Apple opgelegde beperking die niet te omzeilen is. Meer informatie
• Achtergrondverwerking: iOS beperkt achtergrondverwerking om de batterij te sparen. Automatiseringen zijn afhankelijk van Achtergrond-app verversen en draaien mogelijk niet meteen als:
  • Achtergrond-app verversen is uitgeschakeld voor de app
  • Het apparaat in de energiebesparingsmodus staat
  • Het apparaat lang inactief is geweest
  • Systeembronnen beperkt zijn
  • Meerdere apps om achtergronduitvoeringstijd concurreren
• Planning: Gerelateerd aan achtergrondverwerking staat iOS apps ook niet toe op een vast tijdstip op de achtergrond te draaien. Zelfs met een vaste synchronisatiecadans is niet gegarandeerd dat automatiseringen precies op dat moment draaien. Uw apparaat moet ontgrendeld zijn; iOS bepaalt wanneer de automatisering op de achtergrond draait. Automatiseringen kunnen ook handmatig worden geactiveerd via:
  • Automatiseringen-widget: tik op het widgetpictogram om de automatisering te activeren
  • Shortcuts — Automatisering uitvoeren: gebruik de actie Automatisering uitvoeren om een geconfigureerde automatisering te activeren (zie Een automatisering plannen met Shortcuts)
  • Handmatig in de app activeren: ga naar de automatisering in Health Auto Export en voer een handmatige export uit
• Synchronisatie op de voorgrond: Terwijl Health Auto Export op de voorgrond open is, kunnen geschikte automatiseringen opnieuw draaien op een vaste cadans (ongeveer elke 60 seconden). Het apparaat blijft actief tijdens gebruik op de voorgrond zodat synchronisatie kan doorgaan. De voorgrondlus pauzeert alleen wanneer het apparaat de kritieke thermische staat bereikt; bij warmere (niet-kritieke) omstandigheden kan voorgrondsynchronisatie nog mogelijk zijn. De achtergrondplanningsbeperkingen hierboven gelden nog steeds wanneer de app niet op de voorgrond is.

Prestaties

Houd er rekening mee dat iOS is geoptimaliseerd voor kortlopende taken op een mobiel apparaat met zeer strakke prestatiebeperkingen. Achtergrondtaken moeten doorgaans binnen 30 seconden worden voltooid en zijn beperkt in hoeveel geheugen ze kunnen gebruiken. Health Auto Export biedt veel flexibiliteit en aanpasbaarheid, en dat vereist dat u begrijpt hoe bepaalde configuraties de app-prestaties en resultaten beïnvloeden.

• Configuratie: Automatiseringen die grote hoeveelheden gegevens produceren, kunnen ervoor zorgen dat het systeem het proces beëindigt en automatiseringen niet meer op de achtergrond draaien. De volgende configuraties kunnen grote hoeveelheden gegevens produceren:
  • Automatiseringen die zijn geconfigureerd om alle gezondheidsmetrieken te exporteren.
    • Aanbeveling: selecteer alleen gezondheidsmetrieken waarvoor gegevens in Apple Health zijn opgeslagen en alleen gegevens die u daadwerkelijk wilt gebruiken. Zelfs lege gegevenstypen hebben invloed op de prestaties. U kunt geselecteerde gezondheidsmetrieken ook over meerdere automatiseringen verdelen, wat het voor het systeem makkelijker maakt om ze te verwerken.
  • Automatiseringen met tijdgroepering in seconden of minuten, of met Gegevens samenvatten uitgeschakeld. Zulke gedetailleerde queries kunnen lang duren en botsen met systeembeperkingen.
    • Aanbeveling: hoewel het ideaal lijkt om de meest gedetailleerde gegevens te hebben, overweeg of dat detailniveau nodig is voor elke metriek of elk gegevenstype. Overweeg meerdere automatiseringen met verschillende instellingen.
  • Bij het exporteren van outdoor-workouts, zoals fietsen, hardlopen, wandelen enz. met routedata, kunnen GPS en bijbehorende gezondheidsmetriekgegevens grote payloads opleveren.
• Payloadgrootte: Vooral bij REST API-export: grote payloads kunnen serverfouten veroorzaken. Zorg dat uw backend is geconfigureerd om payloads van mogelijk enkele honderden megabytes aan te kunnen om fouten te voorkomen.
• Synchronisatiefrequentie: Voeg de Automatiseringen-widget toe aan uw startscherm om te helpen ervoor te zorgen dat automatiseringen succesvol op de achtergrond draaien (zie Gids voor het instellen van de automatiseringen-widget).

Beschikbare automatiseringstypen

Health Auto Export ondersteunt verschillende automatiseringstypen, elk voor specifieke use-cases:

REST API

Stuur gezondheidsgegevens naar elke webservice die HTTP POST-verzoeken accepteert. Ideaal voor eigen backends, webhooks en API’s van derden.

Gids: REST API-automatiseringgids

Home Assistant

Synchroniseer gezondheidsmetrieken naar Home Assistant als sensorstatussen. Perfect om gezondheidsgegevens in uw slimme-huisautomatiseringen te integreren.

Gids: Home Assistant-automatiseringgids

MQTT

Publiceer gezondheidsgegevens naar een MQTT-broker. Geschikt voor IoT-platforms en MQTT-gebaseerde systemen.

Gids: MQTT-automatiseringgids

Dropbox

Maak automatisch back-ups van gezondheidsgegevens naar Dropbox. Bestanden worden in mappen georganiseerd en zijn vanaf elk apparaat toegankelijk.

Gids: Dropbox-automatiseringgids

Google Drive

Maak automatisch back-ups van gezondheidsgegevens naar Google Drive. CSV-bestanden kunnen worden omgezet naar Google Spreadsheets voor eenvoudig bekijken.

Gids: Google Drive-automatiseringgids

iCloud Drive

Sla gezondheidsgegevens direct op in iCloud Drive. Eenvoudige installatie zonder extra authenticatie.

Gids: iCloud Drive-automatiseringgids

Agenda

Maak agenda-afspraken op basis van uw gezondheidsgegevens. Visualiseer workouts, gezondheidsmijlpalen en andere gebeurtenissen in uw agenda.

Gids: Agenda-automatiseringgids

Uw eerste automatisering maken

1. Ga naar het scherm Geautomatiseerde exports via de hoofdnavigatie
2. Tik op «Nieuwe automatisering»
3. Selecteer een automatiseringstype
4. Configureer de type-specifieke instellingen (zie de afzonderlijke gidsen)
5. Configureer gemeenschappelijke instellingen (gegevenstype, synchronisatiecadans, enz.)
6. Tik op «Bijwerken» om op te slaan
7. Schakel de automatisering in

Automatiseringen back-uppen en herstellen

Health Auto Export kan een back-up maken van uw automatiseringinstellingen in iCloud Drive, zodat u ze op een nieuw apparaat of na het opnieuw installeren van de app kunt herstellen. Dit staat los van de gezondheidsgegevens die uw automatiseringen exporteren.

• Waar back-ups staan: Uw automatiseringinstellingen worden opgeslagen als JSON-bestanden in iCloud Drive, in de map Auto Export/Automations (zichtbaar in de Bestanden-app).
• Wanneer back-ups worden gemaakt: Elke keer dat u een automatisering opslaat (tik op Bijwerken of verlaat het bewerkingsscherm), wordt die automatisering automatisch geback-upt.
• In- of uitschakelen: Open een automatiseringenlijst en ga naar Automatiseringsinstellingen, gebruik vervolgens Back-uppen naar iCloud Drive. Dit staat standaard aan. Als u het uitschakelt, wordt gevraagd of u de bestaande back-upbestanden uit iCloud Drive wilt verwijderen — uw automatiseringen blijven hoe dan ook op uw apparaat.

Herstellen

Als u Geautomatiseerde exports opent en nog geen automatiseringen heeft, maar er wel back-ups beschikbaar zijn in iCloud Drive, verschijnt de knop Herstellen uit iCloud Drive. Tik erop om uw automatiseringen terug te zetten.

Enkele dingen om te weten na het herstellen:

• Verbind uw accounts opnieuw: Voor uw privacy zijn aanmeldtokens voor diensten zoals Dropbox en Google Drive niet opgenomen in back-ups. Verbind die diensten na het herstellen opnieuw in elke automatisering.
• Schakel automatiseringen weer in: Herstelde automatiseringen starten uitgeschakeld, zodat er niets onverwacht draait met verouderde instellingen. Controleer elke automatisering en schakel deze in wanneer u klaar bent.
• Gedeeltelijke herstellingen: Als sommige automatiseringen niet kunnen worden hersteld (bijvoorbeeld een bestand is nog niet gedownload, de versleutelingssleutel is nog niet beschikbaar of het is gemaakt door een nieuwere app-versie), worden de overige wel hersteld en ziet u welke zijn overgeslagen.

Opmerking: aanvraagheaders en inloggegevens die u in een automatisering hebt ingevoerd (zoals een MQTT-wachtwoord) zijn versleuteld in iCloud Drive-back-upbestanden. Herstellen op een nieuw apparaat vereist iCloud-sleutelhanger, zodat de app ze kan ontsleutelen. Handmatig gedeelde/geëxporteerde bestanden blijven onversleutelde platte JSON.

Activiteitenlogboeken

Elke automatisering heeft Activiteitenlogboeken voor de uitvoeringsgeschiedenis.

1. Open de automatisering en tik op Activiteitenlogboeken bekijken.
2. Gebeurtenissen zijn gegroepeerd per uitvoering (nieuwste eerst). Vouw een uitvoering uit om individuele gebeurtenissen te zien.
3. Waarschuwingen (bijv. trage gezondheidsgegevensquery) betekenen dat de uitvoering is voltooid maar een stap langer duurde dan verwacht. Fouten betekenen dat een stap is mislukt (upload, HealthKit-lezen, authenticatie, enz.).
4. Wissen (werkbalk) verwijdert alleen de activiteitengeschiedenis van die automatisering, niet app-brede diagnostische logboeken.
5. Delen (werkbalk) exporteert het volledige diagnostische ZIP van App-gebeurtenislogboeken — hetzelfde pakket als Instellingen → Geavanceerd → Gebeurtenislogboeken exporteren. Zie de Gids voor app-gebeurtenislogboeken.

Trage queries in activiteitenlogboeken

• Duurt een automatisering lang om gezondheidsgegevens op te halen, dan kunnen activiteitenlogboeken trage gezondheidsgegevensquery-waarschuwingen tonen, geen fouten.
• Voor snellere runs: selecteer minder gezondheidsmetrieken, gebruik een korter datumbereik, schakel Gegevens samenvatten in en kies grovere Tijdgroepering (uren, dagen of weken).
• Realtime-automatiseringen gebruiken bewust fijnere groepering en loggen vaker trage-querywaarschuwingen.

Waarschuwing exportinstellingen

Bij het configureren van een gezondheidsmetrieken-automatisering (niet Home Assistant) kan onder Exportinstellingen een voettekst verschijnen als de configuratie traag kan zijn:

• Gegevens samenvatten staat uit, of tijdgroepering is minuten of seconden, en
• Meer dan 10 gezondheidsmetrieken zijn geselecteerd

De voettekst suggereert minder metrieken, korter datumbereik, Gegevens samenvatten of grovere tijdgroepering. Deze verwijst naar deze gids. Trage-query-waarschuwingen in activiteitenlogboeken zijn apart en verschijnen na een run wanneer queries drempels overschrijden.

Best practices

1. Automatische synchronisatie:

• Laad uw apparaat op en gebruik iPhone-spiegeling
  • Tijdens het opladen legt iOS minder prestatiebeperkingen op, zodat gegevens vaker kunnen synchroniseren
  • Met iPhone-spiegeling gedraagt uw apparaat zich alsof het ontgrendeld is. Zo kan Health Auto Export gezondheidsgegevens lezen om geautomatiseerde acties uit te voeren

2. Synchronisatiefrequentie:

• Balanceer tussen actuele gegevens en resourcegebruik
• Dagelijkse synchronisatie werkt goed voor de meeste use-cases
• Vaker synchroniseren voor realtimebehoeften
• Minder vaak synchroniseren voor samenvattingsgegevens

3. Gegevensselectie:

• Selecteer alleen de metrieken die u nodig heeft
• Vermindert verwerkingstijd en gegevensgrootte
• Overweeg aparte automatiseringen voor verschillende metriekgroepen

4. Testen:

• Voer een handmatige export uit
• Controleer of gegevens op de bestemming verschijnen
• Bekijk activiteitenlogboeken op fouten
• Volg eerste synchronisaties nauwlettend

5. Monitoring:

• Bekijk activiteitenlogboeken regelmatig
• Controleer statusindicatoren van automatiseringen
• Stel meldingen in voor belangrijke automatiseringen
• Monitor de bestemming op ontvangen gegevens

6. Beveiliging:

• Gebruik veilige authenticatiemethoden
• Houd inloggegevens bij
• Gebruik HTTPS/TLS wanneer beschikbaar
• Bekijk privacy-instellingen

7. Prestaties:

• Gebruik passende tijdgroepering
• Overweeg datumbereik voor cloudopslag
• Monitor batterij- en datagebruik
• Bekijk activiteitenlogboeken op trage-querywaarschuwingen

8. Back-upstrategie:

• Gebruik meerdere automatiseringstypen voor redundantie
• Combineer cloudopslag met API-integraties
• Bewaar lokale back-ups wanneer mogelijk
• Test herstelprocedures

9. Probleemoplossing:

• Bekijk eerst activiteitenlogboeken
• Controleer netwerkverbinding
• Controleer authenticatiegegevens
• Raadpleeg de gidsen per automatisering voor specifieke problemen

Automatiseringen-widget

Voeg de widget «Automatiseringen» toe aan het startscherm om:

• de status van automatiseringen in één oogopslag te zien
• automatiseringen handmatig te activeren
• achtergrond-uploads te optimaliseren

Hulp krijgen

Als u hulp nodig heeft bij een specifiek automatiseringstype:

1. Raadpleeg de gids voor dat type
2. Bekijk activiteitenlogboeken op foutmeldingen
3. Lees de secties over probleemoplossing
4. Neem contact op met support als problemen aanhouden