Rapport des cas d'emploi d'un article

Le cas d'emploi montre où un article entre dans une structure de produit, et quelles fiches le citent comme produit, variante ou alternative.

3 min de lectureMis à jour le 5 octobre 2026Source : docs.frappe.io

À quoi sert le rapport

Le rapport des cas d'emploi (Item Where Used) montre les références de données de base et de structure de produit d'un article. Il répond à des questions du type « quelles nomenclatures ou quels ensembles de produits utilisent cet article ? ». Il ne mélange pas les documents de transaction : commandes, factures d'achat, écritures de stock ou grand livre des stocks.

Filtres

Filtre	Obligatoire	Rôle
Article	Oui	Article recherché.
Société	Non	Filtre les lignes issues d'une nomenclature par société.
Section	Non	`Where Used` ou `References`. Vide : les deux.

Cas d'emploi

Cette section montre où l'article choisi entre dans un autre produit ou dans une structure de fabrication.

Type de référence	Source
Composant de nomenclature	`BOM Item.item_code`
Composant d'ensemble de produits	`Product Bundle Item.item_code`
Article secondaire de nomenclature	`BOM Secondary Item.item_code`
Article de service de sous-traitance	`Subcontracting BOM.service_item`
Produit fini de sous-traitance	`Subcontracting BOM.finished_good`

Références

Cette section montre les fiches liées où l'article est le produit, le parent, le modèle ou l'article de remplacement.

Type de référence	Source
Produit de la nomenclature	`BOM.item`
Parent de l'ensemble	`Product Bundle.new_item_code`
Variante d'article	`Item.variant_of`
Article alternatif	`Item Alternative.item_code`
Alternative pour l'article	`Item Alternative.alternative_item_code`

Colonnes

Colonne	Rôle
Section	Cas d'emploi ou références.
Type de référence	Type d'usage ou de lien trouvé.
Type de document	DocType lié, par exemple nomenclature ou ensemble de produits.
Document	Document lié où l'article est cité.
Article lié	Parent, produit, alternative ou article associé.
Champ trouvé	Champ exact qui correspond à l'article choisi.
Ligne	Index de la ligne de table enfant, s'il y en a un.
Quantité / unité	Quantité et unité de la ligne source, si elles existent.
Quantité de stock / unité de stock	Depuis les lignes de nomenclature, si elles existent.
Société	Société de la nomenclature, le cas échéant.
Défaut / actif / désactivé	Métadonnées d'état du document source, le cas échéant.
Détails	Contexte supplémentaire, par exemple le type d'article secondaire ou le numéro de nomenclature liée.

Le rapport est volontairement limité aux données de base : il exclut l'usage transactionnel. Le filtre Société s'applique aux lignes issues d'une nomenclature. La section cas d'emploi sert à la traçabilité de la structure produit. La section références retrouve les définitions liées : nomenclatures par défaut ou de sortie, ensembles parents, variantes et alternatives.