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 synchronisatiefrequentie 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
  • Snelle handelingen — Automatisering uitvoeren: gebruik de actie Automatisering uitvoeren om een geconfigureerde automatisering te activeren (zie Een automatisering plannen met Snelle handelingen)
  • Handmatig in de app activeren: ga naar de automatisering in Health Auto Export en voer een handmatige export uit
• Herinneringen plannen: Elke automatisering kan u optioneel herinneren om uw apparaat te ontgrendelen en Health Auto Export te openen. Schakel Herinneringen inschakelen in en stel Herinneringsfrequentie in op Elk uur, Elke dag of Geselecteerde dagen. Uurherinneringen gebruiken Minuut van het uur; dagelijkse en geselecteerde-dagenherinneringen gebruiken Herinneringstijd. Een herinnering betekent niet dat de automatisering is uitgevoerd en kan nog verschijnen na een geslaagde achtergrondsynchronisatie.
  • Wijzigingen in herinneringen gaan in nadat de automatisering is opgeslagen. De editor toont Volgende herinnering na opslaan.
  • Tikken op de herinnering opent de automatisering.
  • Openen en synchroniseren is een actie op de melding. Deze opent de app en voert die automatisering meteen uit. De automatisering moet ingeschakeld zijn.
  • Als de automatisering is verwijderd, uitgeschakeld, al wordt uitgevoerd of niet kan worden uitgevoerd met uw huidige toegang, keert de app terug naar het scherm Automatiseringen.
  • Meldingsmachtiging is vereist om herinneringen te gebruiken. Toegang tot meldingen toont de huidige status. Als meldingen zijn geweigerd, gebruikt u Meldingsinstellingen openen.
• Synchronisatiefrequentie: De synchronisatiefrequentie van een automatisering bepaalt hoe vaak u wilt dat deze op de achtergrond draait. Het is geen exact schema en garandeert niet dat de app in dat interval opent of op de achtergrond draait. De mogelijkheid om op de achtergrond te draaien wordt door het systeem beheerd.
• De app openen: Automatiseringen en Synchroniseren met Mac draaien terwijl Health Auto Export open blijft. U kunt ook een uitvoering starten vanuit de automatiseringen-widget, Snelle handelingen of een handmatige export.

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).
• Herinneringsfrequentie: Gebruik uurherinneringen alleen wanneer u echt frequente prompts wilt. Dagelijkse of geselecteerde-dagenherinneringen verstoren de meeste routines minder.
• Lijststatus tijdens uitvoering: Terwijl een automatisering gegevens voorbereidt, toont de rij in de lijst Automatiseringen een voortgangsring. Tijdens het uploaden toont deze een activiteitsindicator.

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

E-mail

Stuur gezondheidsexports als e-mailbijlagen naar een adres naar keuze. Ideaal voor lichte, geplande leveringen in je inbox.

Gids: E-mailautomatiseringsgids

Uw eerste automatisering maken

1. Open de zijbalk en tik op Automatiseringen
2. Tik op «Nieuwe automatisering»
3. Selecteer een automatiseringstype
4. Configureer de type-specifieke instellingen (zie de afzonderlijke gidsen)
5. Configureer gemeenschappelijke instellingen (gegevenstype, synchronisatiefrequentie, 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 Automatiseringen 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, lezen van gezondheidsgegevens, authenticatie, enz.). Als er niets is geüpload, legt de fout uit of er geen gezondheidsgegevens in het datumbereik zijn gevonden of dat de gegevens niet volledig konden worden gelezen (bijvoorbeeld omdat het apparaat tijdens de export is vergrendeld):

• “Er zijn geen gezondheidsgegevens gevonden in dit datumbereik, dus er is niets geüpload.”
• “Gezondheidsgegevens konden niet volledig worden gelezen. Het apparaat is mogelijk vergrendeld tijdens de export. Er is niets geüpload.”

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. Er draait slechts één automatisering tegelijk; splitsen helpt nog steeds om elke payload kleiner te houden.

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
• Gebruik Melden bij uitvoering of Melden bij cache-update om te weten dat een uitvoering heeft plaatsgevonden. Gebruik Herinneringen plannen wanneer u een prompt wilt om te ontgrendelen en de app te openen.
• 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