CORREÇÃO: o cache do catálogo não é usado quando você usa a classe CategoryConfiguration em conjunto com a propriedade CategoryConfiguration. ChildProducts. SqlWhereClause no Commerce Server 2009

Sintomas

Considere o seguinte cenário:

• Você habilita o armazenamento em cache no sistema de catálogo no arquivo Web. config para um site que está executando o Microsoft Commerce Server 2009.

• Use a classe CategoryConfiguration para especificar a configuração pré-carregadas de um objeto de categoria .

• Você define a propriedade LoadChildProducts como true.

• Você especifica uma cláusula de filtragem na propriedade CategoryConfiguration. ChildProducts. SqlWhereClause .

• Você usa o método getcategory ou o método getproduct para recuperar categorias filho ou produtos filho do objeto CategoryConfiguration .

Nesse cenário, o cache do catálogo pode não ser usado para recuperar as categorias filho e os produtos filho. Portanto, o site pode ter o desempenho reduzido quando houver alta carga. Por exemplo, você tem um site que usa o catálogo de exemplo AdventureWorks. Você executa o exemplo de código a seguir para recuperar o nome de exibição de um objeto de categoria . Neste exemplo, o código consulta dados do banco de dados de catálogo a cada vez, embora o cache do catálogo esteja habilitado.

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

Observação Esse mesmo problema ocorre quando você usa o método getproduct no exemplo de código. A Microsoft fornece exemplos de programação somente para ilustração, sem garantia expressa ou implícita. Isso inclui, entre outros, as garantias implícitas de comercialização ou adequação a uma finalidade específica. Este artigo pressupõe que você esteja familiarizado com a linguagem de programação que está sendo demonstrada e com as ferramentas usadas para criar e depurar procedimentos. Os engenheiros de suporte da Microsoft podem ajudar a explicar a funcionalidade de um procedimento específico. No entanto, eles não modificarão esses exemplos para fornecer funcionalidade adicional ou construir procedimentos para atender a seus requisitos específicos.

Resolução

Para solucionar esse problema, aplique esse hotfix ao servidor que está executando o Commerce Server 2009. depois de aplicar esse hotfix, o armazenamento em cache de produtos filho e de categorias filho no cache do catálogo é permitido quando você usa um filtro "whereClause". Por padrão, qualquer consulta que contenha uma cláusula WHERE ignora o cache do catálogo. Para habilitar o armazenamento em cache, você deve adicionar uma seção "cacheFilter" e configurá-la corretamente no arquivo Web. config do site do Commerce Server. A seção "cacheFilter" fornece os seguintes atributos:

• O atributo "whereClause".

• O atributo "exactMatch".

Você pode usar uma das seguintes opções para gerenciar qual cláusula WHERE armazenar em cache:

• Especifique a cláusula WHERE inteira no atributo "whereClause" e, em seguida, defina o atributo "exactMatch" como true.

• Especifique uma cláusula WHERE no atributo "whereClause" e, em seguida, defina o atributo "exactMatch" como false. Isso permite que o Commerce Server armazene em cache qualquer cláusula WHERE que tenha uma correspondência parcial com o que foi especificado no arquivo de configuração.

Observação O atributo "exactMatch" é opcional. Por padrão, se você omitir o atributo "exactMatch", ele será definido como true. O exemplo a seguir mostra como modificar a seção de configuração. Este exemplo também mostra o uso do atributo "exactMatch".

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

Regras para definir o valor de atributo "whereClause" na seção cacheFilter,Observe que o valor do atributo "whereClause" na seção "cacheFilter" é correspondente à cadeia de caracteres. Por exemplo, as seguintes regras devem ser seguidas:

• Somente um espaço em branco é permitido entre as palavras-chave do valor de atributo "whereClause". Por exemplo:

  • whereClause = "ProductID like ' AW2% '" não corresponde

  • whereClause = "ProductID like ' AW2% '" foi correspondido

• Nenhum espaço em branco é permitido no início ou no final do valor do atributo "whereClause" se houver um valor de palavras-chave com várias palavras-chave. Por exemplo:

  • whereClause = "ProductID like ' AW2% '" não corresponde

  • whereClause = "ProductID like ' AW2% '" não corresponde

• O subvalor entre aspas única dentro do atributo "whereClause" deve ser totalmente correspondido à cadeia de caracteres. Por exemplo, suponha que a consulta de pesquisa seja "ProductID like ' AW2% '"; Nesse caso,

  • whereClause = "ProductID like ' AW2 ' não é uma coincidência

  • whereClause = "ProductID like ' AW2% ' é uma correspondência

Status

A Microsoft confirmou que este é um problema nos produtos Microsoft listados na seção "Aplicável a".

Informações adicionais

Lembre-se dos dois pontos a seguir durante e depois da desinstalação do hotfix:

1. Uma janela de diálogo pode ser exibida. A janela de diálogo avisa que alguns aplicativos precisam ser fechados para que você possa continuar com o processo de desinstalação. Nessa situação, aceite a seleção padrão e clique no botão OK para continuar.

2. Depois de desinstalar o hotfix para o Commerce Server 2009, o Commerce Server 2009 e o Commerce Server 2007 poderão aparecer no menu iniciar. Nessa situação, você pode ignorar ou excluir o item de menu do Commerce Server 2007.

Para obter mais informações, consulte os seguintes websites do Microsoft Developer Network (MSDN):

método Getcategory daclasse CategoryConfigurationdo elemento CatalogPara baixar o pacote de modelos do Commerce Server 2009 para SharePoint 2010, acesse o seguinte site da Microsoft:

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