N'affecter qu'un seul wrapper à un format d'entrée

[parmentf]

Constat

Le 9 mars 2026, nous avons introduit un inputFormat nommé query-istex.tar.gz dans la configuration.
Voir ddd777d.

La raison: il fallait utiliser un wrapper différent de /v1/istex-tar-gz pour récupérer aussi la requête qui avait fourni les données ISTEX (donc /v1/query-istex-tar-gz pour que similarKeywordsExtract puisse fonctionner.

Mais cela peut conduire à une confusion lors de la sélection du « format » :

Comment savoir s'il faut choisir le premier ou le deuxième « format » (qui maintenant correspond plus à un wrapper) ?
En effet, jusqu'à présent la règle était: un format, un wrapper.

Nous avons essayé de clarifier la différence dans la description du format:

tdm-factory/tdm-be/config/production.json

Lines 54 to 62 in ddd777d

	"query-istex.tar.gz": {
	"summary": "Requête et corpus Istex `.tar.gz`",
	"description": "Un corpus déchargé d'[ISTEX Search](https://search.istex.fr) au format `.tar.gz` (à choisir dans *Format de l'archive*). Il doit contenir **des métadonnées JSON** (par exemple en sélectionnant l'usage LODEX).\n\nLa différence avec le « corpus Istex » est que le traitement exploite la requête (elle est présente dans les métadonnées du corpus).",
	"extensions": [
	"tar.gz",
	"tgz"
	],
	"wrapper": "/v1/query-istex-tar-gz"
	},

La différence avec le « corpus Istex » est que le traitement exploite la requête (elle est présente dans les métadonnées du corpus)

Il a un wrapperParameter qui peut changer:

tdm-factory/tdm-be/config/production.json

Lines 346 to 357 in ddd777d

	{
	"id": "istex-query-similar-keywords-tgz",
	"featured": false,
	"input": "corpus",
	"inputFormat": "query-istex.tar.gz",
	"wrapperParameter": "abstract",
	"enricher": "https://data-kwsimilarity.services.istex.fr/v1/kw",
	"retrieve": "/v1/retrieve-json",
	"retrieveExtension": "json",
	"summary": "**similarKeywordsExtract** - Extraction de termes sémantiquement proches",
	"description": "Extrait des termes sémantiquement proches des mots-clés de la requête dans le corpus"
	},

mais ici, c'est le même que d'habitude (abstract est le champ contenant du texte libre avec la plus grande probabilité d'être présent dans tous les documents Istex).

Idée

Il faudrait avoir des wrappers génériques, dont tous les traitements pourraient se satisfaire (du genre, un wrapper istex-tar-gz capable de fournir à la fois les contenus du champ passé en paramètre, mais aussi la requête du manifest.json).

L'idéal serait de pouvoir ajouter un paramètre supplémentaire (difficile à nommer: version ? usage ? variante ?), qui modifierait le comportement du wrapper en fonction du traitement.