Comandi Rapidi e App Intent

Intent disponibili

Esporta i dati sanitari di ieri

Comando rapido senza parametri. Il modo più veloce per «esportare semplicemente i dati di ieri senza ulteriori interazioni». Usa lo stesso motore dell'esportazione manuale. Parametro opzionale Profilo (vedi Profili di esportazione).

Esporta i dati sanitari per una data

Un solo parametro Data. L'ora viene ignorata. Utile nelle automazioni basate sul calendario. Parametro opzionale Profilo.

Esporta i dati sanitari per un intervallo di date

Parametri Data di inizio e Data di fine, entrambe incluse. Utile per recuperare dati pregressi. Parametro opzionale Profilo.

Esporta i dati sanitari degli ultimi N giorni

Parametro Numero di giorni (1–366). L'intervallo termina ieri. Il valore predefinito è 7. Ideale per automazioni come «ogni domenica, esporta gli ultimi 7 giorni». Parametro opzionale Profilo.

Ottieni il riepilogo sanitario per una data

Restituisce un'istantanea strutturata — passi, calorie attive, sonno, frequenza cardiaca — senza scrivere nulla nella cartella. Puoi usarla in Comandi Rapidi per passare i valori ad altre app.

Ottieni lo stato dell'ultima esportazione

Restituisce la data e l'ora, lo stato di riuscita, il numero di giorni e l'eventuale motivo dell'errore dell'esportazione registrata più recente. Una richiesta effettuata con il dispositivo bloccato rimane in sospeso fino a un nuovo tentativo e, finché è in sospeso, non viene restituita come stato corrente.

Attiva o disattiva l'esportazione programmata

Parametro booleano. Consente di sospendere la programmazione, ad esempio durante la modalità Full immersion Vacanza, e di riattivarla in seguito.

Profili di esportazione

Crea e gestisci profili di esportazione salvati in Health.md su iPhone o Android. Sulle piattaforme Apple, la gestione dei profili è attualmente documentata solo per iPhone; non viene dichiarata la disponibilità su iPad o macOS.

I quattro intent di esportazione accettano un parametro opzionale Profilo. Quando esistono profili, lasciarlo vuoto usa il profilo attivo; nella modalità legacy senza profili, usa le impostazioni di esportazione attuali dell'app. Indica il nome di un profilo salvato per eseguire la configurazione congelata di quel profilo — selezione delle metriche, formati e destinazione — indipendentemente da ciò che l'app mostra al momento.

Attenzione per i collegamenti esistenti senza parametri.

Dopo aver creato il primo profilo di esportazione nell'app, un collegamento senza Profilo impostato esporta usando le impostazioni salvate del profilo attivo anziché le impostazioni attive dell'app. Se ti affidi al comportamento precedente, fissa il collegamento a un profilo specifico (oppure mantieni zero profili) per restare esplicito. Un nome profilo inesistente fallisce con un errore chiaro invece di esportare la cosa sbagliata.

## Dove trovarli

Apri l'app Comandi Rapidi su iOS o macOS. Tocca il pulsante + per creare un nuovo comando rapido, quindi cerca "Health.md" o uno dei titoli degli intent riportati sopra. Sono disponibili nella categoria Salute.

La maggior parte degli intent usa openAppWhenRun = false, quindi viene eseguita senza interfaccia: l'app non si apre e non compare alcuna schermata. Funzionano con le automazioni, i filtri delle modalità Full immersion, le richieste a “Ehi Siri” e il tasto Azione.

L'esecuzione con il dispositivo bloccato non sblocca HealthKit.

Apple protegge i dati di HealthKit mentre iPhone è bloccato e revoca l'accesso alle app circa dieci minuti dopo il blocco. Consenti esecuzione quando bloccato permette a Comandi Rapidi di avviare l'azione, ma non aggira la protezione dei dati di HealthKit. Neppure l'autorizzazione ai contenuti dell'app Health.md in Comandi Rapidi consente di aggirarla.

Se HealthKit non è disponibile, Health.md conserva le date richieste come operazione in sospeso e invia una notifica L'esportazione dei dati sanitari richiede attenzione. Sblocca iPhone, quindi tocca la notifica oppure apri Health.md per riprovare. Non è possibile garantire un'esportazione completamente automatica mentre il telefono rimane bloccato.

Procedura: esportazione giornaliera con conferma

1. Automazione personale → Ora del giorno → scegli un orario in cui normalmente usi iPhone sbloccato, ad esempio le 8:00.
2. Intent Esporta i dati sanitari di ieri.
3. Intent Ottieni lo stato dell'ultima esportazione.
4. Mostra notifica con il risultato.

Nota sullo stato in sospeso: Ottieni lo stato dell'ultima esportazione legge la voce più recente registrata nella cronologia delle esportazioni. Se durante questa esecuzione i dati di HealthKit non erano disponibili perché il dispositivo era bloccato, potrebbe continuare a mostrare l'esportazione precedente finché non riprovi la richiesta in sospeso. La notifica di ripristino di Health.md è il segnale autorevole della presenza di operazioni in sospeso.

Procedura: recupero occasionale dei dati pregressi

1. Crea un comando rapido.
2. Esporta i dati sanitari per un intervallo di date con inizio = 2024-01-01 e fine = 2024-12-31.
3. Eseguilo da Comandi Rapidi. Scorre l'intero anno e scrive un file per ogni giorno. Per anni completi potrebbero essere necessari alcuni minuti.

Procedura: sospendere la programmazione durante le vacanze

1. Filtro Full immersion: quando attivi la modalità Full immersion Vacanza, esegui Attiva o disattiva l'esportazione programmata con Attiva = false.
2. Quando disattivi la modalità Full immersion, eseguilo di nuovo con Attiva = true.

Autorizzazione necessaria.

Gli intent ereditano l'autorizzazione a HealthKit e la cartella selezionata nell'app. Restituiscono un errore chiaro se l'app non è stata aperta e configurata almeno una volta su questo dispositivo.

Argomenti correlati

FonteProgrammazione — l'equivalente nell'app dell'intent di attivazione o disattivazione. FonteEsportazione — l'equivalente nell'app degli intent per intervallo di date.