Structure des fichiers - Archive ZIP

[TuThoThai]

Questions à résoudre :

• Le nom de l’archive
• La présence ou pas de sous archives
• Le nom des fichiers
• Et un focus sur le nom des fichiers lignes en cas d’export « bulk »

[albanpeignier]

Le nom de l’archive

Imposer un nom de l'archive globale est une très mauvaise idée.

C'est seulement nécessaire quand on imagine gérer un répertoire avec des fichiers.

Cette approche n'est plus très en vogue dans les architectures modernes. La plupart des usages passent par des APIs pour qui le nom du fichier n'a aucune importance.

Si quelqu'un en a besoin… il trouvera surement les ressources pour le spécifier selon son usage.

[thbar]

J'éviterais d'autoriser des zips de zips. Ca complique l'ingestion des données (il est relativement aisé de "streamer" c'est à dire lire sans décompresser, une archive, mais plus compliqué de gérer le cas où on doit faire cela recursivement).

À l'inverse je serais assez tenté de ne pas autoriser/ recommander les fichiers NeTEx non compressés (vu qu'ils sont quand même souvent volumineux, et que la compression est très efficace sur ce format).

Je n'imposerais pas non plus de nom précis sur les fichiers eux mêmes, car ça va être parfois difficile à implémenter dans certains systèmes de génération.

[prhod]

+1 pour éviter les ZIP de ZIPs
je propose de demander à ce que ça soit dans un ZIP, même s'il n'est pas compressé (même si ce serait mieux). ça permet d'harmoniser les méthodes de lectures

[prhod]

Précision évoquée en atelier GT7 :

• Pas de zip dans les zips, pas de dossiers dans le fichier zip
• un sujet sur la sécurité est abordé (fichier BAT renommé, binaire encodé en base64 dans le fichier XML, ZIPBombing, etc.). Le consensus semble être qu'il ne s'agit pas du travail du GT de lister toutes les contraintes de sécurité associées
• il est interdit d'inclure des fichiers binaires ou des executables dans l'archive, les fichiers autres que XML sont ignorés à la lecture.
• Il est évoqué la possibilité de mettre un sous-dossier extra pour contenir les fichiers qui ne sont pas du netex. Mais ce sujet ne fait pas consensus étant donné que ça crée une exception à la règle des sous-dossiers

[TuThoThai]

CR des discussions et décisions actés le 31 octobre 2024 :

Discussions

Nom de l’archive

• sujet non évoqué directement mais “héritant” des recommandations formulées.
• position évoquée par un participant mais non statué : ne pas imposer le nom

Nom des fichiers

• Les noms de fichiers doivent être uniques sans sémantique obligatoire au delà de “ligne_”
• Le producteur est libre de compléter et de générer un nom par regroupement pour assurer l’unicité
• Les autres recommandations sont :
  -- pas de majuscule
  -- le séparateur est “_”
  -- pas d’accent
  -- pas d'espace

Sous archives

• Pas de sous-archive autorisée

Relevé de décision

Suite aux échanges le groupe formule les propositions suivante

• les fichiers binaires, exécutables et sous archives sont interdites
• les autres fichiers type texte, json peuvent figurer dans l’archive mais seront ignorés à l’import
• des mesures de sécurités “propres à chaque consommateur” pourront conduire à des exigences complémentaires : il n’est pas du ressort du groupe de spécifier les contraintes afférentes.
  Ces règles pourront évoluer en fonction des contraintes et des situations rencontrées.

[TuThoThai]

CR des discussions et décisions actés le 31 octobre 2024 :

Discussions

Nom de l’archive

* sujet non évoqué directement mais “héritant” des recommandations formulées.

* position évoquée par un participant mais non statué : ne pas imposer le nom

Nom des fichiers

* Les noms de fichiers doivent être uniques sans sémantique obligatoire au delà de “ligne_”

* Le producteur est libre de compléter et de générer un nom par regroupement pour assurer l’unicité

* Les autres recommandations sont :
  -- pas de majuscule
  -- le séparateur est “_”
  -- pas d’accent
  -- pas d'espace

Sous archives

* Pas de sous-archive autorisée

Relevé de décision

Suite aux échanges le groupe formule les propositions suivante

* les fichiers binaires, exécutables et sous archives sont interdites

* les autres fichiers type texte, json peuvent figurer dans l’archive mais seront ignorés à l’import

* des mesures de sécurités “propres à chaque consommateur” pourront conduire à des exigences complémentaires : il n’est pas du ressort du groupe de spécifier les contraintes afférentes.
  Ces règles pourront évoluer en fonction des contraintes et des situations rencontrées.

Lors de la réunion du 14 novembre 2024 : pas d'objection ➡️ à faire confirmer en plénière du GT7 du 21 novembre 2024

[TuThoThai]

validé en plénière en date du 21 novembre 2024
documentation à préparer