Configurazione di Amazon S3, DropBox, Google Drive e OneDrive CSV

È possibile generare un file separato da virgole (CSV) e importarlo da Amazon S3, DropBox, Google Drive e OneDrive. Si tratta di un modo semplice per importare dati da altri servizi o per esportare file a scopo di backup o condivisione con altre applicazioni. Per garantire la massima flessibilità e la compatibilità con tutti i servizi, la configurazione è piuttosto articolata. Ecco come configurarla:

• Imposta il percorso del file che desideri che leggiamo o modifichiamo. Puoi includere {tasktype} in qualsiasi punto del percorso e noi lo sostituiremo con il tipo di dati sincronizzati dall'attività: quindi /exports/{tasktype}.csv diventa /exports/Activity.csv in un'attività "Attività" e /exports/Sleep.csv in un'attività "Sospensione". Ciò consente a una cartella di contenere diverse attività senza che queste si sovrascrivano a vicenda.
• Se ci fornite una cartella anziché un file, utilizzeremo il token FitnessSyncer-{tasktype}.csv al suo interno, ad esempio FitnessSyncer-Activity.csv.
• Indica il separatore da utilizzare per il file. Se non trovi quello che ti serve, contattaci.
• Se il file contiene blocchi di commento, seleziona il carattere di prefisso del commento. Se non trovi quello che ti serve, contattaci.
• Se il file contiene un blocco di testo nella parte superiore, è possibile impostare la riga iniziale in modo che corrisponda al numero della riga in cui si trovano le intestazioni.
• Per ogni colonna dei dati, selezionare la casella di controllo a sinistra del "Numero colonna" e quindi inserire l'indice numerico della colonna. Ad esempio, in Excel, se la colonna è B1, questo valore sarebbe 2.
• Per qualsiasi dato che non è presente nel proprio set di dati, è possibile inserire un valore di sostituzione nella colonna "Predefinito".
• Alcuni file CSV contengono riepiloghi giornalieri dei dati di attività e, in questi casi, potrebbe essere opportuno raggrupparli per data, in modo da non avere un numero eccessivo di record al giorno (ad esempio uno al minuto). Per farlo, selezionare la casella di controllo “Raggruppa i dati per data?” (questa opzione è attualmente disponibile solo per le attività).
• Alcuni file CSV contengono dati dettagliati per ogni pasto e, in questi casi, potrebbe essere opportuno raggrupparli per data, in modo da evitare di avere molti record di piccole dimensioni. Per farlo, selezionare la casella di controllo “Raggruppa i dati per pasto?” (questa opzione è attualmente disponibile solo per le informazioni nutrizionali).
• Alcuni file CSV contengono un fuso orario non specificato e, in tali casi, viene utilizzato per impostazione predefinita il fuso orario del tuo profilo. Se la data e l'ora non specificate sono in realtà espresse in UTC, puoi sovrascrivere questa impostazione selezionando la casella di controllo “Forza il fuso orario UTC per le date non specificate?”.

Quando esporti i tuoi dati, l’opzione “Riepilogo giornaliero con conteggi totali” ti offre maggiore flessibilità nella riga di riepilogo. Se non è selezionata, verranno visualizzati i dati esatti riportati nella cella Stream. Se invece questa opzione è selezionata, la riga di riepilogo giornaliero conterrà il totale dei passi effettuati in quella giornata. Se per quella data non è presente una riga di riepilogo per impostazione predefinita, ne verrà aggiunta una al set di dati.

Per facilitare la mappatura delle colonne, è possibile selezionare il pulsante “Scegli colonne caricando un campione”, che consente di caricare una parte del file come campione, quindi di mappare le colonne in modo interattivo e salvare tale configurazione. Questo è un ottimo modo per assicurarsi di avere tutti i campi obbligatori, come ad esempio la data di inizio.

Tutte le altre impostazioni sono identiche a quelle delle “Fonti” o delle “Destinazioni”.

Alcuni servizi potrebbero generare file CSV che rappresentano un'attività. Tali file sono supportati, ma per configurarli è necessario utilizzare l'opzione Cloud Files.

Per configurare Amazon S3, inserisci la tua chiave di accesso nel campo "Nome utente", la tua chiave segreta nel campo "Password" e, come percorso, utilizza bucket/directory/file.

Se ricevi un messaggio di errore che indica che una riga non contiene una data, un'attività o una descrizione, oppure che le informazioni presenti nella riga non sono sufficienti, molto probabilmente manca un campo obbligatorio oppure non è stato possibile analizzare il dato. Ti consigliamo di utilizzare il nostro "Sample Uploader", che elenca i campi obbligatori per quel tipo di dati.

Nota: per le attività di destinazione, non riscriviamo il file, ma aggiungiamo in coda le informazioni che riteniamo siano quelle nuove. Se elimini il file e desideri ripopolarlo, oppure se hai modificato la struttura dei dati esportati, dovrai reimpostare l'attività.

CSV nelle app Android e iOS

Un'attività CSV viene configurata qui sul sito web anziché nelle app. Il motivo è la mappatura delle colonne: ci sono centinaia di campi tra cui scegliere e scorrerli non è un'operazione che si presta bene allo schermo di un telefono; pertanto, anziché mostrarne solo la metà, le app reindirizzano l'utente a questo sito.

Le app mostrano effettivamente un’attività CSV per quello che è. Apritene una e il formato del file risulterà CSV, proprio come qui, e il percorso, il nome e la pianificazione sono tutti modificabili come al solito. Ciò che le app non fanno è creare una nuova attività CSV, poiché una fonte CSV senza mappatura delle colonne non può importare nulla.

Quando hai bisogno della mappatura — ovvero delle impostazioni relative al dialetto, alle virgolette, al separatore e alla riga iniziale — l'app apre questo sito sulla attività che stavi visualizzando, effettua l'accesso e ti riporta all'app una volta terminato. L'attività viene riletta durante il ritorno, quindi l'app mostra esattamente le modifiche che hai apportato sul web.

Se hai già effettuato l'accesso a FitnessSyncer nel browser di quel dispositivo, il trasferimento utilizza semplicemente quella sessione.

CSV e le date

Richiediamo le date relative a tutti gli articoli importati.

• Scegli "Data (USA)" se la data è una di queste:
  • 07/27/2019 16:13:37
  • 07/27/2019 16:13
  • 07/27/2019
  • Jul 27, 2019
  • July 27, 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • July 27, 2019 04:13:37 PM
  • July 27, 2019 04:13 PM
  • July 27, 2019 - 04:13:37 PM
  • July 27, 2019 16:13:37
  • July 27, 2019 16:13
  • July 27 2019 04:13:37 PM
  • July 27 2019 04:13 PM
  • July 27 2019 - 04:13:37 PM
  • July 27 2019 16:13:37
  • July 27 2019 16:13
  • Jul 27, 2019 04:13:37 PM
  • Jul 27, 2019 04:13 PM
  • Jul 27, 2019 16:13:37
  • Jul 27, 2019 16:13
  • 2019-07-27 16:13Z
  • 2019-07-27 16:13
  • 27-Jul-2019 16:13
  • 07-27-2019 16:13
  • 07-27-2019
  • 16:13:37 PM Jul 27 2019
  • 2019-07-27
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
• Scegli "Data (al di fuori degli Stati Uniti)" se la data è una di queste:
  • 27/07/2019 16:13:37
  • 27/07/2019 16:13
  • 27/07/2019
  • 27 Jul 2019
  • 27 July 2019
  • 2019-07-27 16:13:37
  • 2019-07-27 16:13:37 Z
  • 2019-07-27T16:13:37Z
  • 2019-07-27T16:13:37
  • 2019-07-27 16:13
  • 27 July 2019 04:13:37 PM
  • 27 July 2019 04:13 PM
  • 27 July 2019 16:13:37
  • 27 July 2019 16:13
  • 27 Jul 2019 04:13:37 PM
  • 27 Jul 2019 04:13 PM
  • 27 Jul 2019 16:13:37
  • 27 Jul 2019 16:13
  • 27-Jul-2019 16:13
  • 2019-07-27
  • 27-Jul-19
  • 27.07.2019 16:13:37
  • 2019/07/27 16:13:37
  • 2019/07/27 16:13
  • 27.07.2019 16:13Z
  • 27.Jul.2019 16:13
  • 27.07.2019
  • 2019.07.27 16:13Z
  • 27.Jul.2019 16:13
  • 2019.07.27
  • 27/Jul/2019
  • 20190727
• Scegli "Tempo in secondi" se i tuoi dati hanno il formato "1564244017".
• Scegli "Tempo in millisecondi" se i tuoi dati hanno il formato "1564244017000".
• Se il tuo file di dati contiene colonne dedicate a Anno, Mese e Giorno, seleziona queste tre colonne.
• Se l'ora non è specificata in uno dei formati sopra indicati, è possibile inserirla utilizzando il formato ora, che deve essere uno dei seguenti:
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

Per l'esportazione dei dati, utilizzeremo il primo formato tra quelli indicati nelle configurazioni sopra riportate.

Se il formato della data non corrisponde a uno di quelli sopra indicati, ti preghiamo di contattarci.

CSV e i valori enumerati

Alcuni campi accettano solo uno dei valori di un insieme prestabilito. Questi devono corrispondere esattamente a quanto indicato di seguito — tutte maiuscole, con i trattini bassi dove indicato — e non al nome descrittivo che visualizziamo altrove in FitnessSyncer. Un valore che non corrisponde esattamente viene ignorato silenziosamente per quella riga, anziché rifiutare l'intera importazione; pertanto, vale la pena ricontrollare questi valori se un campo non viene importato come previsto.

• Monitoraggio del ciclo mestruale, Livello di flusso:
  • NONE (Nessuno)
  • SPOTTING (Piccole perdite)
  • LIGHT (Leggero)
  • MEDIUM (Medio)
  • HEAVY (Abbondante)
• Monitoraggio del ciclo mestruale, Muco cervicale:
  • DRY (Asciutto)
  • STICKY (In evidenza)
  • CREAMY (Cremoso)
  • WATERY (Acquoso)
  • EGG_WHITE (Albume)
• Monitoraggio del ciclo mestruale, Test di ovulazione:
  • NEGATIVE (Negativo)
  • HIGH (Alto)
  • PEAK (Picco)
• Unità di misura della dose del farmaco:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (Microgrammo)
  • TABLET (Tablet)