Configuration Amazon S3, DropBox, Google Drive et OneDrive CSV

Nous pouvons générer un fichier séparé par des virgules (CSV) et lire ces fichiers à partir de Amazon S3, DropBox, Google Drive et OneDrive. Il s'agit d'un moyen simple d'importer des données depuis d'autres services ou d'exporter des fichiers à des fins de sauvegarde ou de partage avec d'autres applications. Afin d'offrir une flexibilité maximale et une prise en charge optimale de tous les services, la configuration est très complète. Voici comment la configurer :

• Définissez le chemin d'accès au fichier que vous souhaitez que nous lisions ou modifiions. Vous pouvez inclure «{tasktype}» n'importe où dans le chemin d'accès ; nous le remplacerons alors par le type de données synchronisées par la tâche. Ainsi, «/exports/{tasktype}.csv» devient «/exports/Activity.csv» pour une tâche « Activité » et «/exports/Sleep.csv» pour une tâche « Veille ». Cela permet de regrouper plusieurs tâches dans un même dossier sans qu'elles ne s'écrasent les unes les autres.
• Si vous nous fournissez un dossier plutôt qu'un fichier, nous utiliserons le paramètre «FitnessSyncer-{tasktype}.csv» qui s'y trouve, par exemple «FitnessSyncer-Activity.csv».
• Indiquez le séparateur à utiliser pour le fichier. Si vous ne trouvez pas celui dont vous avez besoin, contactez-nous.
• Si votre fichier contient des blocs de commentaires, sélectionnez le caractère de préfixe des commentaires. Si vous ne trouvez pas celui dont vous avez besoin, contactez-nous.
• Si votre fichier comporte un bloc de texte en haut, vous pouvez définir la ligne de départ comme étant la ligne où se trouvent les en-têtes.
• Pour chaque colonne de vos données, cochez la case située à gauche du « Numéro de colonne », puis saisissez l'index numérique de la colonne. Par exemple, dans Excel, si la colonne est B1, cette valeur serait 2.
• Pour toute donnée qui ne figure pas dans votre base de données, vous pouvez saisir une valeur de remplacement dans la colonne « Par défaut ».
• Certains fichiers CSV contiennent des résumés quotidiens des données d'activité ; dans ce cas, vous pouvez souhaiter les regrouper par date afin d'éviter d'avoir un grand nombre d'enregistrements par jour (par exemple, un par minute). Pour ce faire, cochez la case « Regrouper les données par date ? » (cette option n'est actuellement disponible que pour les activités).
• Certains fichiers CSV contiennent des données détaillées par repas ; dans ce cas, vous pouvez choisir de les regrouper par date afin d'éviter d'avoir un grand nombre de petits enregistrements. Pour ce faire, cochez la case « Regrouper les données par repas ? » (cette option n'est actuellement disponible que pour les informations nutritionnelles).
• Certains fichiers CSV contiennent un fuseau horaire non spécifié ; dans ce cas, nous utilisons par défaut le fuseau horaire de votre profil. Si la date et l'heure non spécifiées sont en réalité exprimées en UTC, vous pouvez les remplacer en cochant la case « Forcer le fuseau horaire UTC pour les dates non spécifiées ? ».

Lors de l'exportation de vos données, l'option « Résumé quotidien avec totaux » vous offre une certaine flexibilité concernant la ligne de résumé. Si cette option n'est pas cochée, les données s'afficheront exactement telles qu'elles apparaissent dans votre Stream. Si cette option est cochée, la ligne de résumé quotidien indiquera le nombre total de pas pour la journée. S'il n'y a pas de ligne de synthèse par défaut pour cette date, une ligne sera ajoutée à votre ensemble de données.

Pour faciliter le mappage des colonnes, vous pouvez cliquer sur le bouton « Choisir les colonnes en téléchargeant un extrait », ce qui vous permettra de télécharger un extrait du fichier, puis de mapper les colonnes de manière interactive et d'enregistrer cette configuration. C'est un excellent moyen de vous assurer que vous disposez de tous les champs obligatoires, tels que la date de début.

Tous les autres paramètres sont identiques à ceux des sources ou des destinations.

Certains services peuvent générer des fichiers CSV correspondant à une activité. Ces fichiers sont pris en charge, mais vous devez utiliser l'option « Cloud Files » pour configurer cette fonctionnalité.

Pour configurer Amazon S3, saisissez votre clé d'accès dans le champ « Nom d'utilisateur », votre clé secrète dans le champ « Mot de passe » et, pour le chemin d'accès, indiquez « bucket/répertoire/fichier ».

Si vous recevez un message d'erreur indiquant qu'une ligne ne comporte pas de date, d'activité ou de description, ou qu'elle ne contient pas suffisamment d'informations, cela signifie très probablement qu'un champ obligatoire est manquant ou que la ligne n'a pas pu être analysée. Nous vous recommandons d'utiliser notre outil de téléchargement d'exemples, qui répertorie les champs obligatoires pour ce type de données.

Remarque : pour les tâches de destination, nous ne réécrivons pas le fichier, mais y ajoutons simplement ce que nous considérons comme les nouvelles informations. Si vous supprimez le fichier et souhaitez le remplir à nouveau, ou si vous avez modifié la structure de vos données exportées, vous devrez réinitialiser la tâche.

CSV dans les applications Android et iOS

Une tâche CSV est configurée ici sur le site Web plutôt que dans les applications. Cela s'explique par le mappage des colonnes : il existe des centaines de champs parmi lesquels choisir, et il n'est pas pratique de les parcourir sur l'écran d'un téléphone ; c'est pourquoi, plutôt que de n'en proposer que la moitié, les applications vous redirigent vers ce site.

Les applications affichent bien une tâche CSV telle qu'elle est. Ouvrez-en une : le format de fichier indiqué est CSV, comme ici, et le chemin d'accès, le nom et le calendrier sont tous modifiables comme d'habitude. Ce que les applications ne font pas, c'est créer une nouvelle tâche CSV, car une source CSV sans mappage de colonnes ne peut rien importer.

Lorsque vous avez besoin de la correspondance — ou des paramètres de dialecte, des guillemets, du séparateur et de la ligne de départ —, l'application ouvre ce site à la tâche que vous consultiez, en vous connectant automatiquement, puis vous ramène à l'application une fois que vous avez terminé. La tâche est relue lors du retour ; ainsi, tout ce que vous avez modifié sur le Web s'affiche dans l'application.

Si vous êtes déjà connecté à FitnessSyncer dans le navigateur de cet appareil, le transfert utilise simplement cette session.

CSV et dates

Nous avons besoin des dates pour tous les articles importés.

• Sélectionnez «Date (États-Unis)» si votre date correspond à l'un des formats suivants:
  • 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
• Sélectionnez «Date (hors États-Unis)» si votre date correspond à l'un des formats suivants:
  • 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
• Sélectionnez «Durée en secondes» si vos données se présentent sous la forme «1564244017».
• Sélectionnez «Durée en millisecondes» si vos données se présentent sous la forme «1564244017000».
• Si votre fichier de données comporte des colonnes distinctes pour Année, Mois et Jour, sélectionnez ces trois colonnes.
• Si l'heure n'est pas indiquée dans l'un des formats ci-dessus, vous pouvez l'ajouter en utilisant le format d'heure, qui doit être l'un des suivants:
  • 04:13:37 Z PM
  • 04:13:37 PM
  • 04:13 PM
  • 16:13:37 Z
  • 16:13:37
  • 16:13

Pour l'exportation des données, nous utiliserons le premier format parmi ceux indiqués ci-dessus.

Si votre format de date ne correspond à aucun de ceux indiqués ci-dessus, veuillez nous contacter.

CSV et les valeurs énumérées

Certains champs n'acceptent qu'une seule valeur parmi un ensemble fixe. Ces valeurs doivent correspondre exactement à celles indiquées ci-dessous — en majuscules, avec des traits de soulignement là où ils sont indiqués — et non au nom descriptif affiché ailleurs dans FitnessSyncer. Une valeur qui ne correspond pas exactement est ignorée sans message d'erreur pour cette ligne, plutôt que de rejeter l'importation dans son ensemble ; il est donc utile de les vérifier attentivement si un champ ne s'affiche pas comme prévu.

• Suivi du cycle menstruel, Niveau de flux:
  • NONE (Aucun)
  • SPOTTING (Saignotements)
  • LIGHT (Léger)
  • MEDIUM (Moyen)
  • HEAVY (Abondant)
• Suivi du cycle menstruel, Mucus cervical:
  • DRY (Sec)
  • STICKY (En haut de la page)
  • CREAMY (Crémeux)
  • WATERY (Aqueux)
  • EGG_WHITE (Blanc d'œuf)
• Suivi du cycle menstruel, Test d'ovulation:
  • NEGATIVE (Négatif)
  • HIGH (Élevé)
  • PEAK (Pic)
• Unité de mesure de la posologie:
  • ML (ML)
  • MG (MG)
  • MGML (MG/ML)
  • MCG (microgramme)
  • TABLET (Tablette)