OPLOSSING: catalogus cache wordt niet gebruikt wanneer u de CategoryConfiguration-klasse samen met de eigenschap CategoryConfiguration. ChildProducts. SqlWhereClause gebruikt in Commerce Server 2009

Symptomen

Neem het volgende scenario:

• U schakelt cache in in het catalogus systeem in het bestand Web. config voor een website waarop Microsoft Commerce Server 2009 wordt uitgevoerd.

• U gebruikt de CategoryConfiguration -klasse om de vooraf geladen configuratie van een Category -object op te geven.

• U stelt de eigenschap LoadChildProducts in op True.

• U geeft een filtercomponent op in de eigenschap CategoryConfiguration. ChildProducts. SqlWhereClause .

• U gebruikt de methode GetCategory of de GetProduct om onderliggende categorieën of onderliggende producten van het CategoryConfiguration -object op te halen.

In dit scenario mag catalogus cache niet worden gebruikt voor het ophalen van de onderliggende categorieën en onderliggende producten. Daarom kan de werking van de website worden vertraagd wanneer er sprake is van een hoge belasting. U hebt bijvoorbeeld een website die de AdventureWorks-voorbeeld catalogus gebruikt. Voer het volgende codevoorbeeld uit om de weergavenaam van een categorie object op te halen. In dit voorbeeld worden de gegevens in de programmacode opgevraagd uit de catalogusdatabase, hoewel het in de cache opslaan van catalogus is ingeschakeld.

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);

Opmerking Dit probleem treedt op wanneer u de GetProduct -methode in het codevoorbeeld gebruikt. Microsoft biedt programmeervoorbeelden voor slechts één afbeelding, zonder garanties die geheel of impliciet zijn aangegeven. Dit geldt ook voor maar niet beperkt tot de impliciete garanties van verkoopbaarheid of geschiktheid voor een bepaald doel. In dit artikel wordt ervan uitgegaan dat u bekend bent met de programmeertaal die wordt aangetoond en met de hulpmiddelen voor het maken en gebruiken van debug-procedures. Microsoft ondersteuningstechnici kunnen u helpen de functionaliteit van een bepaalde procedure te uitleggen. Ze wijzigen deze voorbeelden echter niet voor het toevoegen van functies of het maken van procedures voor het maken van aan uw specifieke eisen.

Oplossing

U kunt dit probleem oplossen door deze hotfix toe te passen op de server waarop Commerce Server 2009 wordt uitgevoerd. Wanneer u deze hotfix toepast, worden onderliggende producten en onderliggende categorieën in de catalogus cache toegestaan als u een whereClause-filter gebruikt. Standaard wordt in alle query's met een WHERE-component de catalogus cache overgeslagen. Om de cachefunctie in te schakelen, moet u een sectie ' cacheFilter ' toevoegen en correct configureren in het bestand Web. config voor de Commerce Server-website. De sectie ' cacheFilter ' bevat de volgende kenmerken:

• Het kenmerk ' whereClause '.

• Het kenmerk ' exactMatch '.

U kunt een van de volgende opties gebruiken voor het beheren van de WHERE-component voor de cache:

• Geef in het kenmerk ' whereClause ' de hele WHERE-component op en stel het kenmerk ' exactMatch ' in op True.

• Een WHERE-component opgeven in het kenmerk ' whereClause ' en het kenmerk ' exactMatch ' vervolgens op Falseinstellen. Hiermee kan Commerce Server elke WHERE-component die gedeeltelijk overeenkomt, in de cache opslaan, wat is opgegeven in het configuratiebestand.

Opmerking Het kenmerk ' exactMatch ' is optioneel. Als u het kenmerk ' exactMatch ' weglaat, wordt dit standaard ingesteld op waar. In het volgende voorbeeld ziet u hoe u de sectie Configuration wijzigt. In dit voorbeeld wordt ook het gebruik van het kenmerk ' exactMatch ' weergegeven.

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

Regels voor het definiëren van de waarde ' whereClause ' in de cacheFilter-sectie,Noteer de waarde van het kenmerk ' whereClause ' in het gedeelte ' cacheFilter ', die overeenkomt met de tekenreeks. U moet bijvoorbeeld de volgende regels volgen:

• Er wordt slechts één witruimte toegestaan onder de trefwoorden ' whereClause '. Bijvoorbeeld:

  • whereClause = "product-id like" AW2% "" wordt niet vergeleken

  • whereClause = "product-id like" AW2% "" wordt vergeleken

• Er is geen witruimte (s) aan het begin of einde van de kenmerkwaarde ' whereClause ' toegestaan als er meerdere trefwoord waarden zijn. Bijvoorbeeld:

  • whereClause = "product-id like" AW2% "" wordt niet vergeleken

  • whereClause = "product-id like" AW2% "" wordt niet vergeleken

• De subwaarde van de gemeenschappelijke aanhalingstekens binnen het kenmerk ' whereClause ' moet volledig worden vergeleken. Stel dat de zoekquery ' product-id like ' AW2% ' is. in dit geval

  • whereClause = "product-id zoals ' AW2 ' is geen overeenkomst

  • whereClause = "product-id like" AW2% "is een overeenkomst

Status

Microsoft heeft bevestigd dat dit probleem zich kan voordoen in de Microsoft-producten die worden vermeld in de sectie Van toepassing op.

Meer informatie

Let op de volgende twee punten tijdens en na het verwijderen van de hotfix:

1. Er wordt een dialoogvenster weergegeven. In het dialoogvenster wordt u gewaarschuwd dat sommige toepassingen moeten worden gesloten voordat u verder kunt gaan met het verwijderingsproces. In deze situatie moet u de standaardselectie accepteren en op de knop OK klikken om door te gaan.

2. Nadat u de hotfix voor Commerce Server 2009 hebt verwijderd, wordt de optie Commerce Server 2009 en Commerce Server 2007 weergegeven in het start menu. In dit geval kunt u het menuonderdeel Commerce Server 2007 negeren of verwijderen.

Ga naar de volgende MSDN-websites (Microsoft Developer Network) voor meer informatie:

catalogus element CategoryConfiguration class GetCategory methodeGa naar de volgende Microsoft-website als u Commerce Server 2009-Sjabloonpakket voor SharePoint 2010 wilt downloaden:

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