Automazioni
Esporta dati di Apple Health alle destinazioni che configuri, con limiti in background, promemoria e impostazioni condivise.
Ultimo aggiornamento: 31 ottobre 2026
In questa pagina
Impostazioni di esportazione comuni
Impostazioni di esportazione comuni Selezione dei datiFormato e versione di esportazioneIntervallo di dateRiepiloga dati e raggruppamento temporaleNotifiche di esecuzioneLe automazioni esportano dati di Apple Health alle destinazioni che configuri. Le esecuzioni automatiche dipendono dall’accesso ai dati di salute di Apple e dai limiti in background.
Creare o modificare un’automazione
- Su iPhone, apri Esporta → Automatico. Su iPad, apri Automazioni nella barra laterale.
- Seleziona Nuova automazione, oppure apri un’automazione esistente.
- Inserisci un nome, scegli una destinazione e completa la relativa configurazione con la guida corrispondente.
- Scegli i dati e le impostazioni di esportazione di cui hai bisogno, attiva Attivato e seleziona Aggiorna per salvare.
Puoi tornare a un’automazione incompleta per continuare a configurarla.
Tipi di automazione disponibili
| Destinazione | Cosa fa |
|---|---|
| API REST | Invia esportazioni a un endpoint HTTP |
| Home Assistant | Pubblica metriche di salute come stati di entità |
| MQTT | Pubblica JSON su un topic del broker |
| Dropbox | Salva file di esportazione su Dropbox |
| Google Drive | Salva file, con conversione facoltativa di CSV in Fogli |
| iCloud Drive | Salva file di esportazione su iCloud Drive |
| Calendario | Crea o aggiorna eventi del calendario |
| Invia esportazioni come allegati |
Limitazioni
- Accesso ai dati di salute: Le app non possono accedere ai dati di salute mentre l’iPhone è bloccato. Le automazioni vengono eseguite solo quando il dispositivo è sbloccato. È una limitazione imposta da Apple che non può essere aggirata. Ulteriori informazioni
- Elaborazione in background: iOS limita l’elaborazione in background per preservare la batteria. Le automazioni dipendono da Aggiornamento in background e potrebbero non essere eseguite immediatamente se:
- 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
iOS non garantisce esecuzioni in background a un’ora precisa. Per attivare un’automazione all’ora che scegli, consulta Programmare un’automazione con Comandi Rapidi. Il dispositivo deve essere sbloccato quando l’azione legge i dati di salute.
Frequenza di sincronizzazione
Scegli un numero e un’unità di tempo, ad esempio Ogni 15 minuti, per indicare la cadenza desiderata in background. Questo non garantisce che l’app si apra né venga eseguita in quell’intervallo. iOS decide quando l’esecuzione in background è disponibile.
Aprire l’app
Le automazioni e Sincronizza con Mac vengono eseguite mentre Health Auto Export resta aperta.
Attivatori manuali
Puoi avviare un’esecuzione con:
- Widget automazioni: Tocca il pulsante cloud sul widget della schermata Home. Consulta Widget automazioni.
- Comandi Rapidi: Usa Esegui Automazione per attivare un’automazione configurata. Consulta Configurazione Comandi Rapidi.
- Nell’app: In Esporta dati esistenti, seleziona Caricamento manuale, imposta le date di Inizio e Fine e seleziona Avvia esportazione. Usalo per esportare dati storici quando crei un’automazione, coprire date che la sincronizzazione automatica non ha raggiunto o verificare la configurazione.
Programma promemoria
Ciascuna automazione può ricordarti facoltativamente di sbloccare il dispositivo e aprire Health Auto Export. Attiva Attiva promemoria e poi imposta Frequenza del promemoria su Ogni ora, Tutti i giorni o Giorni selezionati. I promemoria orari usano Minuto dell’ora; quelli giornalieri e dei giorni selezionati usano Ora del promemoria. Un promemoria non significa che l’automazione sia stata eseguita, e può comparire anche dopo una sincronizzazione in background corretta.
- Le modifiche ai promemoria si applicano dopo aver salvato l’automazione. L’editor mostra Prossimo promemoria dopo il salvataggio.
- Toccare il promemoria apre l’automazione.
- Apri e sincronizza è un’azione della notifica. Apre l’app ed esegue subito quell’automazione. L’automazione deve essere abilitata.
- Se l’automazione è stata eliminata, è disattivata, è già in esecuzione o non può essere eseguita con il tuo accesso attuale, l’app torna alla schermata Automazioni.
- È necessario il permesso delle notifiche per usare i promemoria. Accesso alle notifiche mostra lo stato attuale. Se le notifiche sono rifiutate, usa Apri le impostazioni delle notifiche.
Impostazioni di esportazione comuni
Selezione dei dati
Seleziona un Tipo di dati e poi le metriche di salute, i tipi di allenamento o i sintomi che vuoi includere. I tipi di dati e i formati disponibili dipendono dalla destinazione. Consulta Dati supportati per la copertura.
Per le metriche di salute, ciascuna automazione ha le proprie preferenze origine.
Per gli allenamenti, Includi metriche dell’allenamento aggiunge letture selezionate come frequenza cardiaca o passi. Includi dati del percorso include i percorsi disponibili nei dati dell’allenamento. Consulta il riferimento del formato allenamenti per i campi disponibili e il raggruppamento temporale degli allenamenti.
Formato e versione di esportazione
- JSON conserva dati strutturati per integrazioni.
- CSV conviene per fogli di calcolo.
- Markdown crea note e tabelle leggibili.
Home Assistant e MQTT usano JSON; Calendario crea eventi invece di file. La conversione in Fogli Google si applica solo alle esportazioni CSV di Google Drive.
Usa Versione 2 per la struttura di esportazione attuale, oppure Versione 1 quando un flusso esistente lo richiede. Consulta JSON e Markdown per i dettagli del formato.
Intervallo di date
Dropbox, Google Drive, iCloud Drive e Calendario organizzano i dati per Giorno, Settimana, Mese o Anno. Ciascun periodo selezionato include le letture fino alla sua fine, incluso l’ultimo secondo.
API REST, MQTT e Email offrono:
| Selezione | Periodo incluso |
|---|---|
| Predefinito | Il giorno precedente e oggi fino all’ora dell’esecuzione |
| Dall’ultima sincronizzazione | Dalla sincronizzazione precedente fino all’ora dell’esecuzione |
| Oggi | Oggi fino all’ora dell’esecuzione |
| Ieri | Il giorno precedente |
| Ultimi 7 giorni | I sette giorni interi precedenti |
Home Assistant offre Predefinito, Oggi e Ieri.
Riepiloga dati e raggruppamento temporale
Nelle esportazioni JSON delle metriche di salute, Riepiloga dati combina le letture nel Raggruppamento temporale selezionato. Disattivalo per letture individuali quando disponibile. Le esportazioni CSV delle automazioni usano dati riepilogati. I gruppi temporali disponibili dipendono dalla destinazione e dall’intervallo di date.
Per medie, totali e riepiloghi giornalieri per metrica, consulta Metriche di salute.
Notifiche di esecuzione
Notifica all’aggiornamento della cache indica che i dati sono stati preparati; Notifica all’esecuzione indica un’azione corretta sulla destinazione. Sono diverse da Programma promemoria, che ti chiedono di aprire l’app.
Controllare lo stato dell’automazione
Apri Visualizza registri attività sull’automazione per rivedere le esecuzioni. Mentre le automazioni sono in esecuzione, seleziona Interrompi nella schermata Esporta o Automazioni e conferma se vuoi annullare l’esecuzione.
Prestazioni
Intervalli di date ampi, molte metriche selezionate, percorsi di allenamento dettagliati e letture a livello di minuto o secondo possono richiedere più tempo e superare il tempo o le risorse disponibili per un’esecuzione in background.
- Seleziona solo i dati di cui hai bisogno.
- Usa un intervallo di date più breve o un raggruppamento temporale più grossolano per esportazioni più piccole.
- Dividi le esportazioni grandi tra più automazioni quando appropriato.
- Per payload REST grandi, considera Richieste batch.
Backup e ripristino delle tue automazioni
Health Auto Export può eseguire un backup delle impostazioni delle tue automazioni su iCloud Drive per ripristinarle su un nuovo dispositivo o dopo aver reinstallato l’app. Questo è indipendente dai dati di salute che le tue automazioni esportano.
- Dove sono i backup: Le impostazioni vengono salvate come file JSON su iCloud Drive, nella cartella Auto Export/Automations (visibile nell’app File).
- Quando vengono creati: Ogni volta che salvi un’automazione (toccando Aggiorna o uscendo dalla schermata di modifica), quell’automazione viene salvata automaticamente.
- Attivare o disattivare: Apri un elenco di automazioni, vai a Impostazioni automazione e usa Backup su iCloud Drive. È attivato per impostazione predefinita. Se lo disattivi, ti verrà chiesto se vuoi eliminare i file di backup esistenti da iCloud Drive; le automazioni restano sul tuo dispositivo in ogni caso.
Ripristinare
Se apri Automazioni e non ne hai ancora nessuna, ma ci sono backup disponibili su iCloud Drive, compare il pulsante Ripristina da iCloud Drive. Toccandolo recuperi le tue automazioni.
Alcuni punti dopo il ripristino:
- Ricollega i tuoi account: Per la tua privacy, i token di accesso di servizi come Dropbox e Google Drive non sono inclusi nei backup. Dopo il ripristino, ricollega quei servizi in ciascuna automazione.
- Riabilita le automazioni: Le automazioni ripristinate iniziano disattivate così che nulla venga eseguito con impostazioni obsolete. Rivedile e attivalle quando sei pronto.
- Ripristini parziali: Se alcune automazioni non possono essere ripristinate (ad esempio, un file non è ancora scaricato, la chiave di crittografia non è disponibile o è stata creata da una versione più recente dell’app), il resto viene comunque ripristinato e vedrai quali sono state omesse.
Nota: Le intestazioni di richiesta e le credenziali che hai scritto in un’automazione (come una password MQTT) sono crittografate nei file di backup di iCloud Drive. Il ripristino su un nuovo dispositivo richiede Portachiavi iCloud affinché l’app possa decifrarle.
Registri attività
Apri un’automazione e seleziona Visualizza registri attività. Espandi un’esecuzione per rivederne gli eventi.
- Le avvertenze segnalano un possibile problema, come un recupero dati lento; non confermano che l’intera esecuzione sia stata corretta.
- Gli errori identificano passaggi non riusciti, come lettura dei dati, autenticazione o caricamento.
- Cancella elimina la cronologia attività di quell’automazione.
- Condividi esporta diagnostica a livello di app per il supporto. Consulta Registri eventi dell’app.
Query lente nei registri attività
Se un’esecuzione segnala query lente ai dati di salute, seleziona meno metriche, accorcia l’intervallo di date oppure attiva Riepiloga dati e usa un Raggruppamento temporale più grossolano.
Widget automazioni
Aggiungi un Widget automazioni per controllare lo stato o attivare un’automazione abilitata dalla schermata Home. iOS controlla le opportunità di aggiornamento in background.
Ottenere aiuto
Consulta prima i registri attività e la sezione di risoluzione dei problemi della destinazione. Se ti serve ancora aiuto, consulta Ottenere aiuto.