SOLUTION : la mise en cache du catalogue n’est pas utilisée lorsque vous utilisez la classe CategoryConfiguration conjointement avec la propriété CategoryConfiguration. ChildProducts. SqlWhereClause dans Commerce Server 2009

Symptômes

Prenons l’exemple du scénario suivant :

• Vous pouvez activer la mise en cache dans le système de catalogue du fichier Web. config pour un site Web qui exécute Microsoft Commerce Server 2009.

• Vous utilisez la classe CategoryConfiguration pour spécifier la configuration préchargée d’un objet Category .

• Vous définissez la propriété LoadChildProducts sur true.

• Vous spécifiez une clause de filtrage dans la propriété CategoryConfiguration. ChildProducts. SqlWhereClause .

• Vous utilisez la méthode GetCategory ou la méthode GetProduct pour récupérer des catégories filles ou des produits enfants de l’objet CategoryConfiguration .

Dans ce scénario, la mise en cache du catalogue ne doit pas être utilisée pour récupérer les catégories et produits enfants. Par conséquent, il est possible que le site Web subisse une diminution des performances en cas de charge élevée. Par exemple, vous disposez d’un site Web qui utilise le catalogue d’exemples AdventureWorks. L’exemple de code suivant permet de récupérer le nom d’affichage d’un objet Category . Dans cet exemple, le code interroge les données de la base de données de catalogue chaque fois que la mise en cache du catalogue est activée.

CategoryConfiguration categoryConfiguration = new CategoryConfiguration();  categoryConfiguration.LoadChildProducts = true;  categoryConfiguration.ChildProducts.SqlWhereClause = "[IsVisible] = 1";  var catalogContext = CommerceContext.Current.CatalogSystem.CatalogContext;  Category category = catalogContext.GetCategory("AdventureWorks Catalog", "SleepingBags");  Response.Write(category.DisplayName);

Remarque Ce même problème se produit lorsque vous utilisez la méthode GetProduct dans l’exemple de code. Microsoft fournit des exemples de programmation uniquement à des fins d’illustration, sans garantie, expresse ou implicite. Cela comprend, sans s’y limiter, les garanties implicites en matière de qualité marchande ou d’adéquation à un but particulier. Cet article part du principe que vous êtes familiarisé avec le langage de programmation présenté et avec les outils utilisés pour créer et déboguer des procédures. Les ingénieurs du support Microsoft peuvent vous permettre d’expliquer les fonctionnalités d’une procédure particulière. Toutefois, ils ne pourront pas modifier ces exemples pour fournir des fonctionnalités ajoutées ou des procédures de construction qui répondent à vos exigences spécifiques.

Résolution

Pour résoudre ce problème, appliquez ce correctif au serveur qui exécute Commerce Server 2009. après avoir appliqué ce correctif, il est possible de mettre en cache des produits et des catégories enfants dans le cache du catalogue lorsque vous utilisez un filtre « whereClause ». Par défaut, toute requête qui contient une clause WHERE ignore le cache du catalogue. Pour activer la mise en cache, vous devez ajouter une section « cacheFilter » et la configurer correctement dans le fichier Web. config pour le site Web de Commerce Server. La section « cacheFilter » fournit les attributs suivants :

• Attribut « whereClause ».

• Attribut « exactMatch ».

Vous pouvez utiliser l’une des options suivantes pour gérer la clause WHERE à mettre en cache :

• Spécifiez la clause WHERE entière dans l’attribut « whereClause », puis définissez l’attribut « exactMatch » sur true.

• Spécifiez une clause WHERE dans l’attribut « whereClause », puis affectez à l’attribut « exactMatch » la valeur false. Cela permet à Commerce Server de mettre en cache n’importe quelle clause WHERE ayant une correspondance partielle avec ce qui a été spécifié dans le fichier de configuration.

Remarque L’attribut « exactMatch » est facultatif. Par défaut, si vous ne spécifiez pas l’attribut « exactMatch », il est défini sur true. L’exemple suivant montre comment modifier la section Configuration. Cet exemple montre également comment utiliser l’attribut « exactMatch ».

<catalog><catalogSets .../>      <cache enable="true">        <cacheFilter>          <add whereClause="WHERE [ListPrice] between 0 AND 1000'" />          <add whereClause="isActive" exactMatch="False" />          ...         </cacheFilter>       </cache> </catalog>

Les règles de définition de la valeur de l’attribut « WhereClause » dans la section cacheFilterindiquent que la valeur de l’attribut « WhereClause » dans la section « cacheFilter » est une correspondance de chaîne. Par exemple, les règles suivantes doivent être suivies :

• Un seul espace blanc est autorisé entre les mots clés de la valeur d’attribut « whereClause ». Par exemple :

  • whereClause = "ProductID like’AW2% '" ne correspond pas

  • whereClause = "IDProduit comme’AW2% '" est associé

• Aucun espace blanc n’est autorisé au début ou à la fin de la valeur d’attribut « whereClause » s’il existe une valeur de mots clés multiples. Par exemple :

  • whereClause = "ProductID like’AW2% '" ne correspond pas

  • whereClause = "ProductID like’AW2% '" ne correspond pas

• La sous-valeur sous-cotée dans l’attribut « whereClause » doit être entièrement associée à une chaîne. Par exemple, supposons que la requête de recherche soit « ProductID like » AW2%»; dans le cas présent,

  • whereClause = "IDProduit comme’AW2 'ne correspond pas à une correspondance

  • whereClause = "IDProduit comme’AW2% 'est une correspondance

Statut

Microsoft a confirmé l’existence de ce problème dans les produits Microsoft répertoriés dans la section « S’applique à ».

Informations supplémentaires

Prenez en considération les deux points suivants pendant et après la désinstallation du correctif :

1. Une fenêtre de boîte de dialogue s’affiche. La fenêtre de la boîte de dialogue vous avertit que certaines applications doivent être fermées pour pouvoir continuer le processus de désinstallation. Dans ce cas, acceptez la sélection par défaut et cliquez sur le bouton OK pour continuer.

2. Après avoir désinstallé le correctif pour Commerce Server 2009, Commerce Server 2009 et Commerce Server 2007 risquent de s’afficher dans le menu Démarrer. Dans ce cas, vous pouvez ignorer ou supprimer l’élément de menu Commerce Server 2007.

Pour plus d’informations, reportez-vous aux sites Web Microsoft Developer Network (MSDN) suivants :

élément de catalogue CategoryConfiguration méthode GetCategoryPour télécharger le Pack de modèles Commerce Server 2009 pour SharePoint 2010, visitez le site Web de Microsoft suivant :

http://www.microsoft.com/download/en/details.aspx?FamilyID=CFD0C459-5A11-4DE6-9085-52D59E8D38E6&displaylang=en