Publication, révision, annulation, retrait et activation des produits (cycle de vie du produit)
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Par défaut, un enregistrement de produit se trouve dans l'état Brouillon au moment de sa création, et est indisponible pour vos agents de vente. L'enregistrement devient disponible à vos agents de vente uniquement au moment de sa publication, qui modifie l'état de l'enregistrement à Actif. Pour les produits qui ne sont pas associés à une famille de produits, c'est-à-dire les produits qui n'ont pas d'enregistrement de famille de produits parent, vous pouvez les créer directement dans un état Actif en définissant l'attribut Organization.CreateProductsWithoutParentInActiveState à 1 (vrai). Par défaut, cet attribut est défini sur 0 (faux) pour une installation récente de Microsoft Dynamics 365 et sur 1 (vrai) si vous effectuez une mise à niveau depuis une version précédente de Dynamics 365, afin de garantir la compatibilité pour vos applications s'exécutant avec la version précédente de Dynamics 365 où les enregistrements de produit ont été créés dans un état Actif.
Vous pouvez également utiliser l'onglet Sales dans la zone des paramètres système de Microsoft Dynamics 365 ou Microsoft Dynamics 365 pour Outlook pour spécifier si les produits sont créés dans un état actif.Pour plus d'informations :TechNet : Gérer la configuration du catalogue de produits.
De plus, vous pouvez réviser, rétablir, retirer et activer vos enregistrements de produits pour gérer votre catalogue de produits selon les besoins de votre entreprise. L'illustration suivante indique les transitions d'état d'un produit lorsque vous effectuez diverses opérations sur un enregistrement de produit dans Dynamics 365.
Activer* : L'opération d'activation s'applique à un certain type d'enregistrements produit uniquement.Pour plus d'informations :Activation d'un enregistrement de produit ou de kit
Contenu de la rubrique
Publication d'une famille de produits, d'un produit ou d'une offre groupée
Révision d'une famille de produits, d'un produit ou d'une offre groupée
Rétablissement d'une famille de produits, d'un produit ou d'une offre groupée
Retrait d'une famille de produits, d'un produit ou d'une offre groupée
Activation d'un enregistrement de produit ou de kit
Publication d'une famille de produits, d'un produit ou d'une offre groupée
Utilisez le message SetStateRequest pour publier l'enregistrement individuel d'une famille de produits, d'un produit ou d'une offre groupée. Dans ce cas, l'état de l'enregistrement cible passe de Brouillon à Actif. Un enregistrement de produit ou d'offre groupée enfant sous un enregistrement de famille de produits peut être publié uniquement si l'enregistrement de la famille de produits parent est publié (dans l'état Actif). Vous ne pouvez pas publier plusieurs enregistrements de familles de produit, de produits ou d'offres groupées en même temps.
Utilisez le message PublishProductHierarchyRequest pour publier une hiérarchie de famille de produits incluant les produits et les offres groupées enfants. Vous pouvez utiliser ce message uniquement avec un enregistrement de famille de produits. L'état de l'enregistrement de famille de produits cible et de tous les enregistrements du produit ou de l'offre groupée enfants passe de Brouillon à Actif.
L'exemple de code suivant illustre comment publier un enregistrement individuel de famille de produits, de produit ou d'offre groupée individuel.
SetStateRequest publishRequest = new SetStateRequest
{
EntityMoniker = new EntityReference(Product.EntityLogicalName, _productId),
State = new OptionSetValue((int)ProductState.Active),
Status = new OptionSetValue(1)
};
_serviceProxy.Execute(publishRequest);
L'exemple de code suivant illustre comment publier une famille de produits, notamment ses enregistrements enfants.
PublishProductHierarchyRequest publishRequest = new PublishProductHierarchyRequest
{
Target = new EntityReference(Product.EntityLogicalName, _productFamilyId)
};
_serviceProxy.Execute(publishRequest);
Pour obtenir l’exemple de code complet, voir Exemple : créer et publier des produits.
Important
Pour les enregistrements de produits ou d'offres groupées qui ne sont pas associés à une famille de produits, vous devez les publier individuellement après leur création ou leur modification, pour les mettre à disposition de vos agents de vente. Pour les enregistrements de produits ou d'offres groupées associés à une famille de produits, utilisez le message PublishProductHierarchyRequest sur l'enregistrement de famille de produits parent pour publier plusieurs enregistrements de produits ou d'offres groupées enfant, en même temps que l'enregistrement de famille de produits parent, en une fois.
De même, pour les produits qui ne sont pas associés à une famille de produits, vous pouvez les créer directement avec l'état Actif en définissant l'attribut Organization.CreateProductsWithoutParentInActiveState sur 1 (vrai). Vous pouvez également utiliser l'onglet Sales dans la zone des paramètres système de Microsoft Dynamics 365 ou Microsoft Dynamics 365 pour Outlook pour spécifier si les produits non associés à des familles de produits sont créés avec l'état actif.Pour plus d'informations :Configuration des informations du catalogue de produits
Révision d'une famille de produits, d'un produit ou d'une offre groupée
Utilisez le message SetStateRequest pour réviser l'enregistrement d'une famille de produits, d'un produit ou d'une offre groupée.
Une fois appelé pour un enregistrement de famille de produits, il révise la famille de produits et ses enregistrements enfants.
Une fois appelé pour un enregistrement de produit ou d'une offre groupée, il révise l'enregistrement individuel uniquement.
L'état de l'enregistrement cible passe de Actif à En cours de révision.
Une fois les propriétés du produit (attributs) mises à jour, l'enregistrement cible doit être publié pour que les modifications se reflètent. Lors de la publication, l'état de l'enregistrement cible passe de En cours de révision à Actif.
Notes
Lorsque vous révisez un produit et modifier les propriétés, Dynamics 365 crée en interne une nouvelle version du produit et copie les détails de produit du produit existant sur la version plus récente. La nouvelle version du produit contient tous les détails, notamment les tarifs, les relations de produit et les propriétés. Les opportunités créées avec la version antérieure du produit peuvent continuer à faire référence à la version antérieure du produit. Les opportunités qui sont créées une fois le produit révisé ou retiré se rapportent à la version actuelle du produit (plus récente).
Rétablissement d'une famille de produits, d'un produit ou d'une offre groupée
Utilisez le message RevertProductRequest pour rétablir l'état Actif d'un enregistrement de famille de produits, de produit ou d'offre groupée. Toutes les modifications de propriété de produit (attribut) apportées à l'enregistrement depuis qu'il a été publié pour la dernière fois (état Actif) seront perdues.
Une fois appelé pour un enregistrement de famille de produits, il rétablir le dernier état Actif de la famille de produits et de ses enregistrements enfants et toutes les modifications apportées aux propriétés de produit des enregistrements depuis qu'ils ont été publiés pour la dernière fois seront perdues.
Lorsqu'il est appelé pour un enregistrement de produit ou d'offre groupée, il rétablir le dernier état Actif de l'enregistrement individuel de produit ou d'offre groupée et toutes les modifications apportées aux propriétés de produit de l'enregistrement depuis sa dernière publication seront perdues.
L'état de l'enregistrement cible passe de En cours de révision à Actif.
L'exemple de code suivant illustre le rétablissement d'un enregistrement de produit.
RevertProductRequest revertReq = new RevertProductRequest
{
Target = new EntityReference(Product.EntityLogicalName, _productId)
};
RevertProductResponse reverted = (RevertProductResponse)_serviceProxy.Execute(revertReq);
Retrait d'une famille de produits, d'un produit ou d'une offre groupée
Utilisez le message SetStateRequest pour retirer l'enregistrement d'une famille de produits, d'un produit ou d'une offre groupée.
Une fois appelé pour un enregistrement de famille de produits, il retire toute la hiérarchie de la famille de produits.
Une fois appelé pour un enregistrement de produit ou d'offre groupée, il retire l'enregistrement individuel uniquement.
L'état de l'enregistrement cible passe à Retiré.
Notes
Vous ne pouvez pas retirer un produit qui appartient à une offre groupée publiée (Active). En outre, vous ne pouvez pas ajouter un produit retiré à une offre groupée ou un produit à une offre groupée retirée.
Activation d'un enregistrement de produit ou de kit
Utilisez le message SetStateRequest pour activer uniquement les types d'enregistrements suivants :
Un enregistrement de produit retiré ne comportant pas d'enregistrement parent.
Un enregistrement de kit retiré.
L'état de l'enregistrement cible passe de Retiré à Actif.
Notes
Vous ne pouvez pas activer un enregistrement de famille de produits ou d'offre groupée retirée.
Voir aussi
Modes de tarification des produits
Créer et gérer des familles de produits, des produits, des offres groupées et des propriétés de produit
Entités de catalogue de produits
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright