Guida generale alle automazioni

Le automazioni consentono di esportare e sincronizzare automaticamente i dati di Apple Health verso varie destinazioni senza intervento manuale. Questa guida offre una panoramica della funzione e collegamenti a guide dettagliate per ogni tipo di automazione.

Panoramica

Le automazioni sono flussi di lavoro configurati che esportano automaticamente i dati sanitari verso servizi esterni, archiviazione cloud o altre destinazioni. Una volta configurate, possono essere eseguite automaticamente in background.

Vantaggi:

• Backup e sincronizzazione automatici dei dati
• Nessun intervento manuale richiesto
• Frequenza di sincronizzazione configurabile
• Più tipi di automazione per casi d’uso diversi
• Funzionamento in background (l’app non deve essere aperta)

Casi d’uso:

• Backup automatici nel cloud
• Integrazione con sistemi di domotica
• Integrazioni API per applicazioni personalizzate
• Piattaforme di analisi e visualizzazione dati
• Condivisione dei dati sanitari con operatori sanitari

Limitazioni:

• Accesso ai dati sanitari: Le app non possono accedere ai dati sanitari mentre l’iPhone è bloccato. Le automazioni vengono eseguite solo quando il dispositivo è sbloccato. È una limitazione imposta da Apple che non può essere aggirata. Maggiori informazioni
• Elaborazione in background: iOS limita l’elaborazione in background per preservare la batteria. Le automazioni dipendono dall’aggiornamento in background dell’app e potrebbero non essere eseguite subito se:
  • L’aggiornamento in background è disattivato per l’app
  • Il dispositivo è in modalità Risparmio energetico
  • Il dispositivo è rimasto inattivo per periodi prolungati
  • Le risorse di sistema sono limitate
  • Più app competono per il tempo di esecuzione in background
• Pianificazione: Collegata all’elaborazione in background, iOS non consente alle app di essere eseguite in background a un’ora specifica. Anche impostando una cadenza di sincronizzazione precisa, non è garantito che le automazioni vengano eseguite esattamente a quell’ora. Il dispositivo deve essere sbloccato e iOS deciderà quando eseguire l’automazione in background. Le automazioni possono anche essere attivate manualmente tramite:
  • Widget Automazioni: tocca l’icona del widget per attivare l’automazione
  • Shortcuts — Esegui automazione: usa l’azione Esegui automazione per attivare un’automazione configurata (vedi Pianificare un’automazione con Shortcuts)
  • Attivazione manuale nell’app: vai all’automazione in Health Auto Export ed esegui un’esportazione manuale
• Sincronizzazione in primo piano: Mentre Health Auto Export è aperta in primo piano, le automazioni idonee possono essere eseguite di nuovo a cadenza regolare (circa ogni 60 secondi). Il dispositivo resta attivo durante l’uso in primo piano così la sincronizzazione può continuare. Il ciclo in primo piano si interrompe solo quando il dispositivo raggiunge lo stato termico critico; in condizioni più calde (non critiche) la sincronizzazione in primo piano può restare consentita. Le limitazioni di pianificazione in background sopra si applicano ancora quando l’app non è in primo piano.

Prestazioni

Tieni presente che iOS è ottimizzato per attività di breve durazione su un dispositivo mobile con vincoli di prestazioni molto rigidi. Le attività in background devono in genere completarsi entro 30 secondi e sono limitate nella memoria utilizzabile. Health Auto Export offre un alto grado di flessibilità e personalizzazione, il che richiede tempo per capire come alcune configurazioni influenzano le prestazioni dell’app e i risultati.

• Configurazione: Le automazioni che producono grandi quantità di dati possono far terminare il processo da parte del sistema e impedire l’esecuzione in background. Le seguenti configurazioni possono produrre grandi quantità di dati:
  • Automazioni configurate per esportare tutte le metriche sanitarie.
    • Raccomandazione: seleziona solo le metriche sanitarie che hanno dati salvati in Apple Health e solo i dati che prevedi di usare. Anche i tipi di dati vuoti hanno un impatto sulle prestazioni. Puoi anche dividere le metriche selezionate in più automazioni, rendendo più facile il lavoro per il sistema.
  • Automazioni che usano raggruppamento temporale in secondi o minuti, o con Riepiloga dati disattivato. Query così dettagliate possono richiedere molto tempo e scontrarsi con i limiti del sistema.
    • Raccomandazione: anche se può sembrare ideale avere i dati più dettagliati possibile, valuta se quel livello di dettaglio è necessario per ogni metrica o tipo di dato. Considera più automazioni con impostazioni diverse.
  • Esportando allenamenti all’aperto, come ciclismo, corsa, escursionismo, ecc. con dati di percorso, GPS e metriche sanitarie associate possono produrre payload di grandi dimensioni.
• Dimensione del payload: Soprattutto con l’esportazione REST API, tieni conto che payload grandi possono causare errori del server. Assicurati che il backend sia configurato per gestire payload di possibilmente diverse centinaia di megabyte per evitare errori.
• Frequenza di sincronizzazione: Aggiungi il widget Automazioni alla schermata Home per favorire l’esecuzione corretta delle automazioni in background (vedi Guida alla configurazione del widget Automazioni).

Tipi di automazione disponibili

Health Auto Export supporta diversi tipi di automazione, ciascuno pensato per casi d’uso specifici:

REST API

Invia dati sanitari a qualsiasi servizio web che accetti richieste HTTP POST. Ideale per backend personalizzati, webhook e API di terze parti.

Guida: Guida automazione REST API

Home Assistant

Sincronizza le metriche sanitarie con Home Assistant come stati dei sensori. Perfetto per integrare i dati sanitari nelle automazioni della smart home.

Guida: Guida automazione Home Assistant

MQTT

Pubblica dati sanitari su un broker MQTT. Ottimo per piattaforme IoT e sistemi basati su MQTT.

Guida: Guida automazione MQTT

Dropbox

Esegui backup automatici dei dati sanitari su Dropbox. I file sono organizzati in cartelle e accessibili da qualsiasi dispositivo.

Guida: Guida automazione Dropbox

Google Drive

Esegui backup automatici dei dati sanitari su Google Drive. I file CSV possono essere convertiti in Fogli Google per una visualizzazione agevole.

Guida: Guida automazione Google Drive

iCloud Drive

Salva i dati sanitari direttamente su iCloud Drive. Configurazione semplice senza autenticazione aggiuntiva.

Guida: Guida automazione iCloud Drive

Calendario

Crea eventi di calendario basati sui dati sanitari. Visualizza allenamenti, traguardi sanitari e altri eventi nel calendario.

Guida: Guida automazione Calendario

Creare la prima automazione

1. Vai alla schermata Esportazioni automatizzate dalla navigazione principale
2. Tocca «Nuova automazione»
3. Seleziona un tipo di automazione
4. Configura le impostazioni specifiche del tipo (vedi le guide individuali)
5. Configura le impostazioni comuni (tipo di dati, cadenza di sincronizzazione, ecc.)
6. Tocca «Aggiorna» per salvare
7. Attiva l’automazione

Backup e ripristino delle automazioni

Health Auto Export può eseguire il backup delle impostazioni delle automazioni su iCloud Drive per ripristinarle su un nuovo dispositivo o dopo la reinstallazione dell’app. È separato dai dati sanitari esportati dalle automazioni.

• Dove sono i backup: Le impostazioni delle automazioni sono salvate come file JSON su iCloud Drive, nella cartella Auto Export/Automations (visibile nell’app File).
• Quando avviene il backup: Ogni volta che salvi un’automazione (tocca Aggiorna o esci dalla schermata di modifica), quell’automazione viene salvata automaticamente.
• Attivare o disattivare: Apri un elenco automazioni e vai a Impostazioni automazione, poi usa Backup su iCloud Drive. È attivo per impostazione predefinita. Se lo disattivi, ti verrà chiesto se eliminare i file di backup esistenti da iCloud Drive — le automazioni restano sul dispositivo in ogni caso.

Ripristino

Se apri Esportazioni automatizzate senza automazioni ma sono disponibili backup su iCloud Drive, compare il pulsante Ripristina da iCloud Drive. Toccandolo, le automazioni vengono recuperate.

Alcune cose da sapere dopo il ripristino:

• Riconnetti i tuoi account: Per la privacy, i token di accesso per servizi come Dropbox e Google Drive non sono inclusi nei backup. Dopo il ripristino, riconnetti quei servizi in ogni automazione.
• Riattiva le automazioni: Le automazioni ripristinate partono disattivate così nulla viene eseguito inaspettatamente con impostazioni non aggiornate. Rivedi ciascuna e attivala quando sei pronto.
• Ripristini parziali: Se alcune automazioni non possono essere ripristinate (ad esempio un file non ancora scaricato, la chiave di crittografia non ancora disponibile o creata da una versione più recente dell’app), le altre vengono comunque ripristinate e vedrai quali sono state saltate.

Nota: Intestazioni di richiesta e credenziali inserite in un’automazione (come una password MQTT) sono crittografate nei file di backup su iCloud Drive. Il ripristino su un nuovo dispositivo richiede iCloud Keychain così l’app può decrittografarle. I file di condivisione o esportazione manuale restano JSON non crittografato in chiaro.

Registri attività

Ogni automazione ha Registri attività per la cronologia delle esecuzioni.

1. Apri l’automazione e tocca Visualizza registri attività.
2. Gli eventi sono raggruppati per esecuzione (le più recenti per prime). Espandi un’esecuzione per vedere gli eventi singoli.
3. Gli avvisi (ad es. query lenta dei dati sanitari) indicano che l’esecuzione è completata ma un passaggio ha richiesto più tempo del previsto. Gli errori indicano che un passaggio è fallito (caricamento, lettura HealthKit, autenticazione, ecc.).
4. Cancella (barra degli strumenti) rimuove solo la cronologia attività di quell’automazione, non i registri diagnostici dell’intera app.
5. Condividi (barra degli strumenti) esporta lo ZIP diagnostico completo dei Registri eventi app — lo stesso bundle di Impostazioni → Avanzate → Esporta registri eventi. Vedi la Guida ai registri eventi app.

Query lente nei registri attività

• Se un’automazione impiega molto a recuperare i dati sanitari, i registri attività possono mostrare avvisi query lenta dati sanitari, non errori.
• Per accelerare le esecuzioni: seleziona meno metriche sanitarie, usa un intervallo di date più breve, attiva Riepiloga dati e scegli un Raggruppamento temporale più ampio (ore, giorni o settimane).
• Le automazioni in tempo reale usano un raggruppamento più fine per progettazione e possono registrare più spesso avvisi di query lenta.

Avviso impostazioni di esportazione

Configurando un’automazione di metriche sanitarie (non Home Assistant), può comparire un piè di pagina sotto Impostazioni di esportazione se la configurazione potrebbe essere lenta:

• Riepiloga dati è disattivato, oppure il raggruppamento temporale è in minuti o secondi, e
• Sono selezionate più di 10 metriche sanitarie

Il piè di pagina suggerisce meno metriche, un intervallo di date più breve, Riepiloga dati o un raggruppamento temporale più grossolano. Collega a questa guida. Gli avvisi di query lenta nei registri attività sono separati e compaiono dopo un’esecuzione quando le query superano le soglie.

Buone pratiche

1. Sincronizzazione automatica:

• Carica il dispositivo e usa Duplicazione iPhone
  • Durante la ricarica, iOS impone meno restrizioni sulle prestazioni, così i dati possono sincronizzarsi più spesso
  • Con Duplicazione iPhone, il dispositivo si comporta come se fosse sbloccato. Health Auto Export può così accedere ai dati sanitari per eseguire azioni automatizzate

2. Frequenza di sincronizzazione:

• Bilancia tra dati aggiornati e uso delle risorse
• La sincronizzazione giornaliera va bene per la maggior parte dei casi
• Sincronizzazioni più frequenti per esigenze in tempo reale
• Sincronizzazioni meno frequenti per dati riepilogativi

3. Selezione dati:

• Seleziona solo le metriche necessarie
• Riduce tempi di elaborazione e dimensione dei dati
• Valuta automazioni separate per gruppi di metriche diversi

4. Test:

• Esegui un’esportazione manuale
• Verifica che i dati compaiano nella destinazione
• Controlla i registri attività per errori
• Monitora da vicino le prime sincronizzazioni

5. Monitoraggio:

• Rivedi regolarmente i registri attività
• Controlla gli indicatori di stato delle automazioni
• Imposta notifiche per automazioni importanti
• Monitora la destinazione per i dati ricevuti

6. Sicurezza:

• Usa metodi di autenticazione sicuri
• Mantieni le credenziali aggiornate
• Usa HTTPS/TLS quando disponibile
• Rivedi le impostazioni sulla privacy

7. Prestazioni:

• Usa un raggruppamento temporale appropriato
• Considera l’intervallo di date per l’archiviazione cloud
• Monitora uso di batteria e dati
• Rivedi i registri attività per avvisi di query lenta

8. Strategia di backup:

• Usa più tipi di automazione per ridondanza
• Combina archiviazione cloud e integrazioni API
• Mantieni backup locali quando possibile
• Testa le procedure di ripristino

9. Risoluzione problemi:

• Controlla prima i registri attività
• Verifica la connettività di rete
• Controlla le credenziali di autenticazione
• Consulta le guide delle singole automazioni per problemi specifici

Widget Automazioni

Aggiungi il widget «Automazioni» alla schermata Home per:

• monitorare lo stato delle automazioni a colpo d’occhio
• attivare manualmente le automazioni
• ottimizzare i caricamenti in background

Ottenere aiuto

Se serve aiuto per un tipo di automazione specifico:

1. Consulta la guida di quell’automazione
2. Controlla i registri attività per messaggi di errore
3. Consulta le sezioni di risoluzione problemi
4. Contatta l’assistenza se i problemi persistono