HCL Commerce Version 9.1.7.0 or later

Propriété de configuration des composants

La table suivante recense les types de propriétés de configuration des composants :

Nom de la propriété Objectif de la propriété
Traitement des caractères spéciaux Pour définir des modèles d'échappement, des modèles d'exclusion, des modèles d'arrêt et des valeurs de zone de requête. Vous n'avez pas besoin de modifier ces propriétés.
Gestion des facettes
maximumFacetFieldsToRequest
Nombre maximal de zones de facettes à demander dans FacetHelper. Vous pouvez configurer ce nombre pour éviter les erreurs de limite de longueur d'URI Solr.
La valeur par défaut est 200.
displayLeafCategoriesOnly
Affiche uniquement les facettes de catégorie de feuille de la recherche par mot clé. Les catégories parent ne sont pas affichées.
categoryFacetLimitForKeywordSearch
Cette configuration définit la valeur limite des facettes de catégorie lorsqu'un client effectue des recherches de mots clés.
Pour parcourir les catégories, il utilise la colonne MAX_DISPLAY de la table FACET pour définir la valeur limite.
HCL Commerce Version 9.1.9.0 or laterFacetPageSize
HCL Commerce Version 9.1.9.0 or laterNombre maximal de facettes à retourner dans la réponse. La valeur par défaut est 1000.
TopCategorySortOrder
Vous pouvez définir séparément la façon dont les éléments doivent être triés dans la fenêtre de navigation de gauche et dans le menu déroulant supérieur. Par exemple, un client peut vouloir trier les catégories du menu supérieur par séquence, et configurer séparément et par ordre alphabétique les facettes de la fenêtre de navigation de gauche. Les valeurs prises en charge permettent de
  1. 0 trier par séquence de centre de gestion.
  2. 1 trier de façon alphanumérique, en fonction des noms d'élément.
La valeur par défaut est 0.
Exécution de la recherche
ResponseTemplateDefault
Définit le comportement par défaut de la transformation de réponse REST. A des fins de compatibilité avec une version antérieure, utilisez 0 afin que la structure des données de réponse puisse s'assembler étroitement à la structure de type BOD pour minimiser l'impact de la migration de la vitrine. Les valeurs prises en charge :
  • -1 n'utilisent aucune transformation et renvoient uniquement des données brutes.
  • 0 utilisent la structure de nom comme modèle.
  • 1 utilisent la structure de service REST comme modèle.
La valeur par défaut est 0.
DisplayEntryWithNoName
Cette configuration permet d'afficher les entrées de produit sans nom.
La valeur par défaut est true.
Important: Pour être effectif, ce paramètre doit être mis à jour dans les fichiers de configuration wc-component.xml WC et EAR de recherche.
Note: La désactivation de cette configuration désactive également la prise en charge de la rétromigration dans toutes les langues.
LimitDeepCategoryFacetValuesToImmediateChildrenOnly
Lorsque la navigation de catégorie étendue est utilisée, les facettes de catégorie affichent une liste des valeurs de facettes de toutes les catégories enfant immédiates et non immédiates. Lorsque cette configuration est définie, les valeurs de facettes de catégorie renvoyées sont uniquement limitées aux valeurs immédiates de la catégorie sélectionnée.
La valeur par défaut est false.
HCL Commerce Version 9.1.10.0 or latermaxTimeAllowed
Cela permet de définir globalement le délai d'attente de la requête de recherche Elasticsearch dans le service Query, via un nœud final de configuration. Cela supprime la nécessité de déclarer maxTimeAllowed dans chaque profil. Le paramètre peut toujours être défini via des profils, et lorsqu'il est déclaré dans un profil, il aura une priorité plus élevée sur la déclaration globale via le nœud final de configuration.
La valeur par défaut est 15 secondes.
uriPrefix
Liste de préfixes d'URI à ignorer, afin que le chemin de stockage ne soit pas ajouté aux URL d'image.
Les paramètres suivants prennent en charge les fonctionnalités d'annulation de publication de catégorie et de séquençage de recherche approfondies. Pour plus d'informations, voir Masquer les catégories et les produits à l'aide d'une dépublication de catégories approfondie.
DisplayPublishedOnly
N'autorise l'affichage des produits des catégories publiées dans les résultats de la recherche par mot clé que lorsque l'option d'annulation de publication de catégorie approfondie est activée.
La valeur par défaut est false.
Note:
  • D'autres paramètres liés aux fonctionnalités d'annulation de publication de catégorie et de séquençage de recherche approfondies se trouvent dans le fichier wc-component.xml de l'EAR HCL Commerce. Pour plus d'informations, voir Propriétés de recherche dans le fichier de configuration de composant (wc-component.xml).
  • Les paramètres d'annulation de publication de catégorie approfondis sont ignorés lorsque la fonctionnalité est désactivée (EnableDeepCategoryUnpublish=false sur l'EAR HCL Commerce).
Configurations de l'index de recherche de stock
FilterInventoryByStoreAndFulfillmentCenter
Formule permettant d'extraire le comptage de stock par magasin physique à l'aide de la conception d'indexation à valeur unique.
1 : Identificateur interne du magasin en ligne.
2 : Identificateur interne du magasin physique.
3 : Filtre de plage [%s TO %s].
La valeur par défaut est inv_strlocqty_%s_%s:%s.
Note: Cette fonction ne peut être utilisée que pour les options à valeur unique de l'index de stock.
Correction orthographique Paramètres configurables dans wc-component.json :
SpellCheckAccuracy
Similarité des termes suggérés. Comment les termes suggérés doivent au moins être comparés aux jetons de texte de suggestion d'origine. Une valeur entre 0 et 1 peut être spécifiée. La valeur par défaut est 0.3.
SpellCheckPrefixLength
Reportez-vous à la description de l'option prefix_length dans la documentation Elasticsearch. La valeur par défaut est 2.
SpellCheckSuggestionMode
Reportez-vous à la description de l'option suggest_mode dans la documentation Elasticsearch. La valeur par défaut est MISSING.
SpellCheckSortBy
Reportez-vous à la description de l'option sort dans la documentation Elasticsearch. La valeur par défaut est SCORE.
SpellCheckStringDistance
Reportez-vous à la description de l'option string_distance dans la documentation Elasticsearch. La valeur par défaut est INTERNAL.
SpellCheckMaxEdits
Reportez-vous à la description de l'option max_edits dans la documentation Elasticsearch. La valeur par défaut est 2.
SpellCheckMaxInspections
Reportez-vous à la description de l'option max_inspections dans la documentation Elasticsearch. La valeur par défaut est 5.
SpellCheckMaxTermFrequency
Reportez-vous à la description de l'option max_term_freq dans la documentation Elasticsearch. La valeur par défaut est 0.01.
SpellCheckMinWordLength
Reportez-vous à la description de l'option min_word_length dans la documentation Elasticsearch. La valeur par défaut est 4.
SpellCheckMinDocFrequency
Reportez-vous à la description de l'option min_doc_freq dans la documentation Elasticsearch. La valeur par défaut est 0.0.
Paramètres configurables dans le profil de recherche :
limit
Indique le nombre de suggestions de correction de vérification orthographique à retourner dans la vitrine.
Note: Pour en savoir plus sur le profil de recherche, voir Configuration de votre profil de recherche personnalisé
Service de mappage de valeur Service de mappage de valeur permettant de résoudre la configuration de relation entre les clés externes et internes des objets métier. L'objectif de ce service est d'extraire le mappage de valeur entre les valeurs externes et internes des objets métier.
SearchControlParameterMapping
Définit la relation entre les paramètres URL REST et le nom interne correspondant utilisé dans l'objet SearchCriteria. Ces paramètres de contrôle dans l'objet SearchCriteria sont ensuite utilisés dans les fournisseurs d'expression pour le traitement.
SearchIndexReturnFieldMapping
Définit la relation entre le nom de la zone de retour utilisé dans les paramètres URL REST, returnFields et le nom de la zone d'index interne correspondant dans l'index de recherche.
XPathToCatalogEntryFieldNameMapping
Définit le mappage d'un XPath à son nom de zone d'index interne correspondant utilisé dans l'index de recherche CatalogEntry.
XPathToCatalogEntryViewBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes utilisées dans la recherche CatalogEntry.
XPathToCatalogEntryViewResponseFieldNameMapping
Définit le mappage du nom de la zone d'index de recherche à son nom de zone de réponse de recherche correspondant.
XPathToPriceBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section de tarification utilisée dans la recherche CatalogEntry.
XPathToPriceResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section de tarification utilisée dans la recherche CatalogEntry.
XPathToAttachmentsBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des pièces jointes utilisée dans la recherche CatalogEntry.
XPathToAttachmentsResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des pièces jointes utilisée dans la recherche CatalogEntry.
XPathToAttributesBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des attributs utilisée dans la recherche CatalogEntry.
XPathToAttributesResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des attributs utilisée dans la recherche CatalogEntry.
XPathToAttributesValuesBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des attributs utilisée dans la recherche CatalogEntry.
XPathToAttributesValuesResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des attributs utilisée dans la recherche CatalogEntry.
XPathToComponentsBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des composants utilisée dans la recherche CatalogEntry.
XPathToComponentsResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section des composants utilisée dans la recherche CatalogEntry.
XPathToMerchandisingAssociationsBODResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section Associations de marchandisage utilisée.
XPathToMerchandisingAssociationsResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes pour la section Associations de marchandisage utilisée.
XPathToBreadCrumbTrailResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes trouvées dans la section BreadCrumbTrailEntryView.
XPathToFacetResponseFieldNameMapping
Définit le mappage des zones d'index internes aux zones de réponse externes correspondantes trouvées dans la section FacetView.
XPathToCatalogGroupFieldNameMapping
Définit le mappage d'un XPath à son nom de zone d'index interne correspondant utilisé dans l'index de recherche CatalogGroup. Ces mappages sont utilisés par les fournisseurs d'expressions.
XPathToCategoryViewResponseFieldNameMapping
Définit le mappage du nom de la zone d'index de recherche à son nom de zone de réponse de recherche correspondant.
XPathToCategoryViewBODResponseFieldNameMapping
Définit le mappage du nom de la zone d'index de recherche à son nom de zone de réponse de recherche correspondant.
XPathToWebContentViewBODResponseFieldNameMapping
Définit le mappage du nom de la zone d'index de recherche à son nom de zone de réponse de recherche correspondant.
WebContentTypeMapping
Définit les métadonnées internes de contenu Web.
STAAssociationType
Définit les métadonnées internes d'association du terme de recherche.
CatalogEntryUserDataFieldNameMapping
Définit le mappage d'un nom de zone d'index personnalisé utilisé dans l'index de recherche CatalogEntry au nom de zone utilisé dans la zone UserData de la réponse REST.
CatalogGroupUserDataFieldNameMapping
Définit le mappage d'un nom de zone d'index personnalisé utilisé dans l'index de recherche CatalogGroup au nom de zone utilisé dans la zone UserData de la réponse REST.
Suggestions
SearchBasedKeywordSuggestions
Lorsque cette valeur est définie, les suggestions de mot clé renvoyées par l'API REST keywordSuggestionsByTerm siteContent sont basées sur les recherches par mot clé à l'aide du composant de requête de recherche. Le profil de recherche IBM_findNavigationSuggestion_Keywords est utilisé pour construire la requête. Sinon, la valeur par défaut TermsComponent est utilisée. Les suggestions basées sur les requêtes de recherche peuvent prendre en compte des filtres différents, tels que le magasin, le catalogue, l'autorisation et le type d'entrée de catalogue. En revanche, les suggestions de TermsComponent sont générées à partir de tous les documents indexés.
Les autres propriétés évaluées lorsqu'elles sont définies sur true sont SearchBasedKeywordSuggestionsMaxShingleSize et SearchBasedKeywordSuggestionsSortByFrequency.
La valeur par défaut est false.
SearchBasedKeywordSuggestionsMaxShingleSize
Détermine le nombre de jetons utilisés pour construire une seule suggestion. L'évaluation a lieu uniquement lorsque la propriété SearchBasedKeywordSuggestions est définie sur true. La valeur par défaut est 3.
SearchBasedKeywordSuggestionsSortByFrequency
Détermine l'ordre de tri des suggestions de mots clés basés sur la recherche. L'évaluation a lieu uniquement lorsque la propriété SearchBasedKeywordSuggestions est définie sur true. La valeur par défaut est true.
Contrats interentreprise
MultipleContracts
Définit l'opération entre plusieurs contrats.
Si l'opération est AND, l'expression entre plusieurs contrats est encapsulée dans +.
Sinon, plusieurs expressions sont encapsulées avec une espace.
La valeur par défaut est une opération OR.
Règles de recherche
CombineFilterRuleWithProductSequencing
Cette configuration définit s'il faut autoriser les règles de recherche avec des conditions de filtre pour utiliser le séquencement de produits lors de la navigation dans les catégories.
Lorsque la valeur est définie sur true, les règles de recherche de tous les mots clés peuvent être utilisées pour la navigation dans les catégories et les produits renvoyés sont triés en fonction de leur séquence définie dans cette catégorie.
La valeur par défaut est false.
LocalTransactionCache Le cache des transactions locales contient les entrées de cache en mémoire pendant une transaction de base de données unique.
enabled
Active la mise en cache des transactions locales. Indiquez false pour désactiver la fonctionnalité.
Ne désactivez pas la mise en cache de transaction locale, sauf pour déterminer les problèmes.
Note: Ne désactivez jamais la mise en cache des transactions locales sans également désactiver la mise en cache inter-transactions.
maxSize
Le nombre maximal d'entrées de cache pouvant être gardées en mémoire pendant une transaction.
Chaque entrée de cache reste en mémoire jusqu'à ce que la transaction en cours soit terminée. Une transaction de longue durée qui crée un nombre trop important d'entrées de cache peut se trouver à court de mémoire.
Lorsque la limite indiquée est atteinte, le cache de transactions arrête de créer de nouvelles entrées de cache pendant la durée restante de la transaction en cours, afin d'empêcher une condition de mémoire insuffisante.
maxInvalidationldsPerTransaction
Le nombre maximal d'opérations d'invalidation du cache pouvant être exécutées lors d'une seule transaction.
La connaissance de chaque exécution d'opération d'invalidation doit être conservée au cours de la transaction en cours. Une transaction de longue durée qui exécute un nombre trop important d'opérations d'invalidation peut se trouver à court de mémoire.
Lorsque la limite indiquée est atteinte, l'intégralité du cache de transactions est effacée et toute trace des opérations d'invalidation individuelles est supprimée de la mémoire afin d'empêcher une condition de mémoire insuffisante. L'utilisation du cache inter-transactions est suspendue pendant le reste de la transaction. Toutes les entrées de cache sont considérées comme étant invalidées pendant le reste de la transaction.
Cache inter-transactions
enabled
Active la mise en cache inter-transactions. Indiquez false pour désactiver la fonctionnalité.
commandCaching
La valeur On oblige le cache inter-transactions à utiliser la mise en cache d'instructions dans le cache de base par défaut DistributedMap.
La valeur off empêche le cache inter-transactions d'utiliser la mise en cache d'instructions.
Le paramètre par défaut utilise la mise en cache DistributedMap lorsque le cache DistributedMap correspondant est trouvé à l'aide de son nom JNDI ; dans le cas contraire, il utilise la mise en cache d'instructions dans le cache DistributedMap par défaut.
maxInactivityTime
Le délai en secondes après lequel une entrée de cache inactive est supprimée du cache pour raison d'inactivité.
maxTimeToLive
Le délai en secondes après lequel une entrée de cache arrive à expiration et est supprimée du cache.
defaultResultSizeThreshold
Lorsque la taille de la collecte d'objets à mettre en cache dans une entrée de cache dépasse la valeur de seuil spécifiée, des identificateurs de dépendance sont générés à l'aide des noms de table uniquement.
Pour réduire le nombre d'identificateurs de dépendance générés pour l'entrée de cache, les noms de colonne et les valeurs ne sont pas utilisés.
clearUserOnLogoff
Indiquez la valeur false si les ID d'invalidation DC_userid:nnnn ne doivent pas être envoyés au cache de base lorsque l'utilisateur avec l'IDnnnn se déconnecte.
clearUserDataCacheOnLogoff
Indiquez la valeur true si les entrées du cache de données spécifiques à un utilisateur doivent être supprimées du cache lorsque cet utilisateur se déconnecte.
maxInvalidationldsPerTransaction
Le nombre maximal d'opérations d'invalidation du cache inter-transactions pouvant être exécutées en une seule transaction.
La connaissance de chaque exécution d'opération d'invalidation doit être conservée au cours de la transaction en cours. Une transaction de longue durée qui exécute un nombre trop important d'opérations d'invalidation peut se trouver à court de mémoire.
Lorsque la limite indiquée est atteinte, aucun autre ID d'invalidation n'est gardé en mémoire pour le cache inter-transactions pendant la durée restante de la transaction en cours.
Lorsque la transaction est terminée, l'action définie par la configuration clearCacheOnMaxInvalidationIdsPerTransaction est réalisée.
clearCacheOnMaxInvalidationIdsPerTransaction
L'action à exécuter lorsque le nombre maximal d'opérations d'invalidation des données du cache inter-transactions, spécifié par l'élément maxInvalidationIdsPerTransaction, est dépassé.
Spécifiez la valeur true pour effacer l'intégralité du cache inter-transactions une fois la transaction en cours terminée.
Lorsque cet élément a la valeur false, les invalidations sont émises immédiatement et ne sont pas conservées jusqu'à la fin de la transaction en cours.
Ce paramètre laisse une petite fenêtre de temps pendant laquelle les données périmées peuvent être placées dans le cache.
reduceMemory
Spécifiez la valeur true pour réduire l'encombrement du cache inter-transactions.
reduceInvalidationIds
Spécifiez la valeur true pour réduire le nombre de messages d'invalidation émis lors de modifications, dans la base de données, des données mises en cache.
Les systèmes avec un grand nombre de machines virtuelles Java de serveur d'applications HCL Commerce peuvent bénéficier de ce paramètre. Une invalidation excessive peut cependant se produire. Vous devez donc mesurer l'impact global sur les performances avant de choisir ce paramètre pour un système de production.
sizeable
Spécifiez la valeur true afin d'implémenter l'interface com.ibm.websphere.cache.Sizeable pour la plupart des entrées de cache utilisées par les caches d'objet HCL Commerce suivants :
  • services/cache/DM_Cache (cache marketing)
  • services/cache/DM_UserCache (cache du comportement utilisateur marketing)
  • dmap/IVCache (cache de disponibilité de stock externe)
  • dmap/PriceCache (cache de tarification externe)
  • services/cache/WC*DistributedMapCache (toutes les instances de cache d'objet de cache de données)
Le fait de spécifier la valeur true permet également d'implémenter l'interface com.ibm.websphere.cache.Sizeable pour la plupart des instructions pouvant être mises en cache utilisées par défaut par HCL Commerce.
Cette valeur n'implémente pas l'interface com.ibm.websphere.cache.Sizeable pour le cache de règle de tarification.
searchRulesCacheMode
Spécifie le mode de mise en cache pour les données de règle de recherche. Le mode est une image bitmap. Vous pouvez utiliser les valeurs suivantes pour cette propriété :
  • 0 : La mise en cache des règles de recherche est désactivée.
  • 1 : Mettre en cache les termes avec les règles de recherche.
  • 2 : Mettre en cache le résultat des règles de recherche.
  • 3 : Mettre en cache les deux termes avec les règles de recherche et le résultat des règles de recherche.
maxTimeToLiveForAutoCacheEntries
Renvoie le nombre maximal de secondes pendant lesquelles une entrée automatiquement mise en cache expire depuis le cache. Une valeur nulle indique qu'aucune entrée de cache automatique n'est créée. Une valeur négative indique qu'il n'y a pas de limite spéciale pour les entrées de cache automatique.
Note: Utilisez uniquement une valeur négative à des fins de débogage.
autoCacheableTableNames
Définit une liste de noms de table pour la mise en cache automatique.
Les ensembles de résultats de ces tables de base de données sont mis en cache à l'aide de JDBCQueryService. Essayez de limiter l'utilisation de cette configuration pour éviter une mise en cache excessive.
notAutoCacheableTableNames
Définit une liste de noms de table à ne pas utiliser pour la mise en cache automatique.
invalidationJobInterval
Indique la fréquence (en secondes) à laquelle l'infrastructure d'invalidation du cache interroge régulièrement la table de base de données CACHEIVL pour les événements d'invalidation en attente.
Lorsqu'il est combiné avec le paramètre maxSeconds dans invalidationJobParameters, ce paramètre peut être utilisé pour déterminer la vitesse à laquelle les événements d'invalidation de cache sont traités sur le serveur de recherche.
La technique d'invalidation par défaut utilisée sur le serveur de recherche requiert parfois une demande de recherche entrante afin de consacrer une partie configurable de son temps de traitement pour exécuter l'invalidation du cache. C'est-à-dire, lorsque des événements d'invalidation en attente restent dans la table CACHEIVL. Ainsi, chaque serveur de recherche est responsable de l'invalidation de ses propres instances de cache local.
Pour synchroniser les dernières données indexées mises en cache sur le serveur de recherche, le délai d'invalidation en secondes prévu pour le cache peut durer plus de 3 fois la valeur du paramètre invalidationJobInterval une fois la tâche de réindexation de la recherche terminée. Ce délai peut être plus long lorsque le nombre d'événements d'invalidation en attente dans la table CACHEIVL dépasse le nombre qui peut être traité dans le temps autorisé par le paramètre maxSeconds.
Lorsque vous travaillez avec des fragments JSP en cache sur le serveur HCL Commerce, le délai attendu pour que le contenu mis en cache associé soit invalidé peut être aussi long que la durée de l'intervalle de travail du planificateur DynaCacheInvalidation, plus la valeur du délai d'invalidation du cache du serveur de recherche.
Note: Lorsque invalidationJobInterval présente la valeur -1, le serveur de recherche n'interroge pas la table CACHEIVL. En revanche, une autre méthode permettant de recevoir des événements d'invalidation de cache, telle que les services de réplication de domaine, est utilisée.
invalidationJobParameters
Spécifie les paramètres lorsque vous exécutez le travail d'invalidation.
Par exemple, localJVMOnly=true&maxSeconds=1&maxSecondsPerTransaction=0&enableRefreshRegistry=false.
RestParameterSetting
addResourceId
Spécifiez false pour supprimer resourceId de l'appel REST. La valeur par défaut est true.