Exports et imports de fichiers

Description

Sauvegarder ou transférer ses données hors de l'application : export et import JSON de la bibliothèque d'aliments et des plats, export CSV du journal, des symptômes et des aliments, import CSV du journal. Les imports de journal au format JSON ont leur propre fiche (Import de journal JSON) et le rapport HTML pour un soignant est décrit dans le Profil santé.

Objectif

Conserver une copie de ses données, les ouvrir dans un tableur, ou les déplacer vers un autre appareil — puisque Nutritor n'a ni compte ni synchronisation (voir Hors connexion & synchronisation).

Prérequis

Permissions : aucune permission dédiée ; le sélecteur de fichiers et la feuille de partage du système sont utilisés.
Connexion : aucune.
Configuration : aucune.
Mobile : le partage (e-mail, cloud, enregistrement…) dépend des applications installées sur l'appareil.

Comment l'utiliser

Ouvrir Paramètres (menu ☰ → Paramètres).
Exporter : toucher la ligne souhaitée dans « Base de données », « Bibliothèque de plats » ou « Export / Import CSV ». Sur mobile, la feuille de partage du système s'ouvre ; sur web, le fichier est téléchargé directement.
Importer : toucher la ligne d'import, puis choisir le fichier. Pour le CSV, le message indique le nombre d'aliments ajoutés, déjà présents et de lignes ignorées. En cas de fichier invalide, une alerte (JSON) ou un message bref (CSV) l'indique.

Options

Fichier	Export	Import
Bibliothèque d'aliments (JSON)	`nutritor_aliments.json` — toute la bibliothèque, y compris les aliments issus de CIQUAL, Open Food Facts, de l'IA ou de la photo	Tableau d'aliments (ou un seul aliment). Chaque entrée doit avoir `id`, `name` et `per100`. Les identifiants déjà présents sont ignorés
Plats sauvegardés (JSON)	`nutritor_plats.json`	Chaque plat doit avoir `id`, `name` et `kcal` (nombre). Les identifiants déjà présents sont ignorés
Journal (CSV)	`journal_nutritor.csv` — colonnes : date, repas, aliment, quantite_g, kcal, proteines_g, glucides_g, lipides_g, fibres_g	Colonnes obligatoires : date (AAAA-MM-JJ), repas, aliment ; facultatives : quantite_g, kcal, proteines_g, glucides_g, lipides_g
Symptômes (CSV)	`symptomes_nutritor.csv` — date, douleurs_abdominales, ballonnements, energie, transit, sommeil_qualite, inflammation, sommeil_duree_h (scores 0 à 4 ; vide si non renseigné)	Pas d'import
Aliments (CSV)	`aliments_nutritor.csv` — nom, kcal_100g, proteines_g, glucides_g, lipides_g, fibres_g, fodmap_niveau, allergenes, source	Pas d'import

Format CSV : séparateur point-virgule, encodage UTF-8 avec marque BOM, fins de ligne Windows, guillemets doublés pour les champs contenant un séparateur ou un saut de ligne.

Paramètres associés

Aucun.

Données utilisées

Fichier	Données concernées
Aliments JSON / CSV	`nutritor:foods`
Plats JSON	`nutritor:saved_plates`
Journal CSV	`nutritor:journal` (historique)
Symptômes CSV	`nutritor:symptoms`

Les fichiers sont créés sur l'appareil ; Nutritor ne les envoie nulle part. Leur partage ultérieur relève de l'application choisie dans la feuille de partage.

Résultat

Un fichier récupérable ou ouvrable dans un tableur, et — pour les imports — des données ajoutées à l'application avec un message de confirmation.

Fonctionnement hors connexion

Complet. Voir Hors connexion.

Fonctionnement en ligne

Identique au mode hors connexion.

Limites

Le journal CSV n'exporte que l'historique : la journée en cours n'y figure qu'après son archivage au changement de jour. À l'inverse, l'import CSV accepte toutes les dates, y compris celle du jour (les repas sont alors ajoutés au Journal du jour).
L'import CSV fusionne par date : les aliments du fichier sont ajoutés aux repas existants de la même date, sans rien supprimer. Un aliment identique (même nom, même quantité, même kcal) déjà présent dans le même repas est ignoré, donc ré-importer le même fichier ne crée pas de doublons. Les repas sont reconnus d'après leur nom (Petit-déjeuner, Encas matin, Déjeuner, Encas après-midi, Dîner ; variantes « collation », « goûter », « souper »…) et replacés dans les cinq repas de l'application.
Les aliments du CSV sont importés avec les valeurs du fichier ; aucune fiche n'est créée dans la bibliothèque. Un nom absent de la bibliothèque n'empêche pas l'import mais l'aliment n'est alors rattaché à aucune fiche.
Dans le CSV du journal, la colonne quantite_g reprend la quantité saisie quelle que soit son unité (ml, pièces…) et la colonne fibres_g est toujours vide.
Dans le CSV des aliments, la colonne « source » vaut CIQUAL, OpenFoodFacts, IA ou Manuel d'après l'identifiant : les aliments issus de la Photo IA ou d'un import JSON de journal sont étiquetés « Manuel ».
Les lignes CSV invalides (date non conforme, champ obligatoire vide, nom de repas non reconnu) sont ignorées et comptées dans le message de résultat (« N lignes ignorées »).
Il n'existe pas d'export du profil, des réglages, du protocole FODMAP, du Défi ou de l'historique des scans : ces données ne sont pas sauvegardables par fichier.
Pas de sauvegarde globale en un clic : transférer toutes ses données vers un autre appareil nécessite plusieurs exports.

Erreurs possibles

Alerte « format » à l'import JSON — une entrée n'a pas les champs obligatoires.
Alerte « erreur d'import » — fichier illisible ou JSON invalide ; le message technique est affiché.
Alerte « partage non disponible » (mobile, exports JSON et CSV) — aucune application de partage disponible.
Message « Format invalide » bref à l'import CSV — fichier illisible.
Alerte « erreur export » — l'écriture du fichier a échoué (exports JSON et CSV) ; le message technique est affiché.

Dépannage

Repas importés invisibles

FAQ

Comment transférer mes données sur un autre téléphone ?

Exportez la bibliothèque d'aliments et les plats en JSON, le journal en CSV, puis importez-les sur l'autre appareil. Le profil, les réglages et les protocoles ne sont pas transférables par fichier.

Pourquoi mon export de journal ne contient-il pas aujourd'hui ?

Seul l'historique est exporté ; la journée en cours est archivée au changement de jour.

Puis-je ouvrir les CSV dans Excel ?

Oui : le séparateur est le point-virgule et le fichier est en UTF-8 avec BOM, ce qui permet à la plupart des tableurs de lire correctement les accents.