Importa ed esporta (CSV)

← Torna alla Guida  ·  🇬🇧 English

Métra può esportare tutte le tue registrazioni giornaliere in un file CSV semplice e reimportarle. È utile per:

  • Tenere un backup locale apribile in qualsiasi foglio di calcolo.
  • Migrare i dati da un’altra app (se riesci a produrre il formato corretto).
  • Modificare in blocco registrazioni passate fuori dall’app.
  • Archiviazione a lungo termine in un formato aperto e non proprietario.

Esportare i tuoi dati

  1. Vai in Impostazioni (icona ingranaggio).
  2. Tocca Esporta CSV.
  3. Si apre il pannello di condivisione standard del dispositivo. Puoi salvare il file localmente, inviarlo al computer, o aprirlo direttamente in un’app foglio di calcolo.

L’export include ogni giorno che hai mai registrato, in ordine cronologico inverso (il più recente prima). I giorni in cui non hai mai aperto l’app non sono inclusi.

Importare i dati

  1. Vai in Impostazioni.
  2. Tocca Importa CSV.
  3. Seleziona il file .csv dalla memoria del dispositivo.
  4. Métra analizza il file. Se alcune righe contengono errori, viene mostrato un riepilogo prima di confermare — puoi annullare in questa fase.
  5. Conferma per applicare. Le righe importate sovrascrivono qualsiasi registrazione esistente per la stessa data.

L’import è additivo e indicizzato per data. Se importi un file con una riga per il 2025-03-15 e quella data esiste già, la riga importata la sostituisce. Le date non presenti nel file non vengono modificate.

Riferimento al formato CSV

Il file usa codifica UTF-8, virgola come separatore e terminazioni di riga \n. La prima riga è sempre l’intestazione. I valori che contengono virgole o doppi apici vengono racchiusi in doppi apici secondo lo standard RFC 4180.

Riferimento alle colonne

Colonna Tipo Obbligatoria Descrizione
date Stringa Sì Data in formato YYYY-MM-DD (es. 2025-04-15). Deve essere una data di calendario valida.
flow_type Intero Sì Tipo di flusso categoriale. Vedi Valori di flow_type.
flow Intero No Intensità del flusso mestruale. Vedi Valori di flow. Significativo solo quando flow_type è 1. Se flow_type è 1 e questa colonna è vuota, l’intensità assume il valore predefinito 1 (Moderato).
pain_intensity Intero No Livello di dolore: 1 = Lieve, 2 = Moderata, 3 = Intensa. Vuoto = nessun dolore registrato.
symptoms Stringa No Lista di token sintomi separata da punto e virgola. Vuota o omessa se nessuno. Vedi Token sintomi.
notes Stringa No Nota in testo libero. Vuota o omessa se assente. Racchiusa in doppi apici se contiene virgole o ritorni a capo.
cycle_start Intero No 1 se questo giorno è l’inizio di un nuovo ciclo, 0 altrimenti. Solo export — questa colonna viene ignorata in import. Métra ricalcola i confini del ciclo automaticamente.

Valori di flow_type

La colonna flow_type codifica uno di tre stati mutuamente esclusivi:

Valore Significato
0 Assente — l’utente ha confermato esplicitamente nessun sanguinamento.
1 Mestruazioni — flusso mestruale attivo. L’intensità flow è significativa.
2 Spotting — perdite leggere e irregolari. L’intensità flow viene ignorata.

flow_type è obbligatorio in ogni riga. Usa 0 (Assente) per registrare esplicitamente un giorno senza sanguinamento.

Valori di flow

La colonna flow è significativa solo quando flow_type è 1 (Mestruazioni). Se omessa o vuota con flow_type=1, l’intensità viene registrata come Moderato (1).

Valore Significato
0 Leggero
1 Moderato — valore predefinito quando flow_type=1 e flow è vuoto
2 Abbondante

Nota su file precedenti: gli export più vecchi possono contenere una colonna spotting (0/1) al posto di flow_type, e valori flow da 0 a 4 dove 0 significa nessun flusso. Métra importa entrambi i formati automaticamente — non è necessario convertire i file vecchi.

Token sintomi

La colonna symptoms è una lista di token separata da punto e virgola. I token distinguono maiuscole e minuscole.

Token predefiniti:

Token Significato
backPain Mal di schiena
headache Mal di testa
migraine Emicrania
bloating Gonfiore
fatigue Stanchezza
nausea Nausea
breastTenderness Tensione al seno

Sintomi personalizzati usano il prefisso custom: seguito dal testo dell’etichetta, es. custom:Dolore pelvico. L’etichetta viene riprodotta esattamente come digitata.

Compatibilità con esportazioni precedenti. Le esportazioni di Métra precedenti alla v0.2 usavano il token predefinito cramps. All’importazione, quel token viene convertito automaticamente in una voce con etichetta personalizzata (custom:Crampi); il dato è preservato.

Esempio — una riga con due sintomi, uno predefinito e uno personalizzato:

symptoms
headache;custom:Dolore alla schiena

. Più sintomi nella stessa cella:

headache;backPain;bloating

File di esempio

date,flow_type,flow,pain_intensity,symptoms,notes,cycle_start
2025-05-01,1,0,2,headache;bloating,Primo giorno,1
2025-05-02,1,1,1,headache,,0
2025-05-03,1,1,,,, 0
2025-05-04,1,0,,,Mi sento meglio,0
2025-05-05,0,,,,, 0
2025-05-06,0,,,,,0

Risoluzione degli errori di importazione

Se Métra rifiuta alcune righe, viene mostrata una lista di errori prima di confermare l’importazione. Ogni errore specifica:

  • Numero di riga nel file (l’intestazione è la riga 1, quindi i dati iniziano dalla riga 2).
  • Colonna in cui è stato trovato il problema.
  • Valore grezzo rifiutato.
  • Motivo — una spiegazione in linguaggio semplice.

Cause comuni:

Problema Soluzione
date non in formato YYYY-MM-DD Cambia 15/04/2025 → 2025-04-15.
date mancante Ogni riga deve avere una data. Le righe senza data vengono saltate.
flow_type mancante o fuori intervallo flow_type è obbligatorio. Usa 0, 1 o 2.
flow fuori intervallo Usa 0, 1, 2, o lascia vuoto (predefinito 1 quando flow_type=1).
pain_intensity fuori intervallo Usa 1, 2, 3, o lascia vuoto.

Le righe con errori vengono saltate; le righe valide vengono comunque importate.

← Torna alla Guida