Prima esportazione da iPhone

Segui questa procedura per produrre un’esportazione piccola e verificabile prima di modificare metriche, formattazione o automazione. Health.md legge esclusivamente le categorie di Apple Health autorizzate da iOS e scrive i file generati nella cartella scelta.

Disponibile ora · Health.md per iPhone

La prima esportazione rientra nella disponibilità gratuita. L’esportazione programmata e le altre funzionalità a pagamento possono essere configurate in seguito.

Prima di iniziare

Occorrono:

• Health.md installato su un iPhone che contiene dati di Apple Health;
• l’autorizzazione a leggere almeno una categoria di Apple Health;
• una destinazione scrivibile in File, come iCloud Drive, Su iPhone o un vault di Obsidian.

Per una prima esecuzione più rapida, mantieni le metriche predefinite e l’output Markdown. Inizia con Ieri o con un altro intervallo di un giorno, anziché con tutta la cronologia disponibile.

1. Completa la configurazione su iPhone

Al primo avvio, tocca Avvia configurazione e completa i sette passaggi iniziali. Autorizza le categorie di dati sanitari desiderate, esamina l’output di esempio, scegli una cartella in File e prosegui fino a Pronto. Quando compare il passaggio per lo sblocco, puoi continuare con la disponibilità gratuita.

Se hai già completato la configurazione iniziale, apri il pannello Esportazione e verifica che Apple Health e la cartella locale siano pronti. Usa il controllo della cartella per sostituire una destinazione mancante o non accessibile.

Start Setup presenta l’archivio locale, le note programmate e il modello basato sulle cartelle prima di richiedere l’accesso. Il contenuto in primo piano della configurazione iniziale rimane in inglese.

Gli indicatori di stato rendono esplicita la configurazione mancante di Health e della cartella. Questa acquisizione di riferimento del simulatore rimane in inglese e mostra intenzionalmente entrambi i requisiti incompleti.

2. Scegli una piccola esportazione

Nel pannello Esportazione:

1. Seleziona Cartella locale su iPhone come destinazione.
2. Scegli Ieri o un intervallo personalizzato di un giorno.
3. Mantieni la selezione predefinita delle metriche per la prima esecuzione.
4. Mantieni selezionato Markdown. Potrai aggiungere CSV, JSON o Obsidian Bases dopo aver verificato il corretto funzionamento del percorso di base.

Un intervallo breve rende più semplici da comprendere i problemi relativi alle autorizzazioni, alle categorie vuote e alla destinazione. Evita inoltre di scambiare una prima richiesta di lunga durata per un’esportazione non riuscita.

Il totale delle metriche dipende dalla versione dell’app installata e dalle autorizzazioni. Questa acquisizione localizzata mostra 217 metriche abilitate su 219 e le metriche standard attive; non è necessario raggiungere questo totale per la prima esportazione.

3. Visualizza l’anteprima prima della scrittura

Tocca Anteprima. L’anteprima richiede l’accesso ad Apple Health, ma non necessita di una cartella locale scrivibile; è quindi utile per distinguere un problema di autorizzazione alla lettura da un problema relativo a File.

Verifica che l’anteprima mostri:

• la data richiesta;
• i nomi e le unità previsti per le metriche;
• valori mancanti o non disponibili indicati esplicitamente, anziché zeri inventati;
• il formato selezionato e la struttura del nome file.

Torna al pannello Esportazione se devi modificare date, metriche o formattazione.

L’anteprima separa l’esame dell’output dalla scrittura. Questa acquisizione deterministica per la documentazione usa dati sanitari di esempio e indica esplicitamente che non è selezionato alcun vault.

4. Esporta e verifica

Tocca Esporta dati. Se la configurazione è incompleta, Health.md indica il requisito mancante relativo a Health o alla cartella, anziché avviare silenziosamente una scrittura parziale.

Al termine:

1. Esamina il risultato nell’app per controllare i file scritti, ignorati o non riusciti.
2. Apri l’app File e raggiungi la cartella selezionata.
3. Apri uno dei file generati e verificane la data, le unità e il frontmatter.
4. Conserva i dettagli del risultato per la risoluzione dei problemi; non presumere che l’operazione sia riuscita solo perché il pulsante è tornato allo stato inattivo.

Nessun dato per il giorno selezionato?

Prova un giorno in cui sai che sono presenti dati relativi all’attività o al sonno, quindi verifica l’autorizzazione di Health e la selezione delle metriche. Un intervallo autorizzato ma vuoto è diverso da un errore di trasferimento o scrittura.

Passaggi successivi

Scegli i datiCerca le metriche di Apple Health e modifica le categorie o le autorizzazioni speciali. Definisci l’outputConfigura formati, date, unità, frontmatter, modelli e nomi file. AutomatizzaConfigura esportazioni programmate ricorrenti dopo aver verificato un’esecuzione manuale. Correggi una destinazioneComprendi i provider di File, l’accesso alle cartelle e il ripristino.