Cambiar propiedades en el archivo de configuración de búsqueda (wc-search.xml) (EAR WC)

Para cambiar el valor de una propiedad existente en un archivo de configuración de componente (wc-search.xml), debe crear una versión personalizada del archivo en una nueva carpeta. La versión personalizada del archivo debe contener únicamente las propiedades modificadas.

Antes de empezar

Para conocer las propiedades que contiene este archivo, consulte HCL Commerce Search archivo de configuración (wc-search.xml).

Por qué y cuándo se efectúa esta tarea

En el archivo personalizado wc-search.xml, cambie solo los tipos de nodo <_config:profile> y <_config:queryMapping>.

Consejo: Para añadir elementos nuevos a alguno de los perfiles existentes en el archivo wc-search.xml, puede añadir un perfil al archivo wc-search.xml personalizado que amplíe el perfil existente.

Procedimiento

Abra HCL Commerce Developer y cambie a la vista Explorador de empresa.
Cree un archivo de configuración de personalizado (wc-search.xml), si no existe ninguno:
1. Navegue hasta la vía de acceso siguiente:
  
  workspace_dir\WC\xml\config\
2. En la carpeta config, cree una nueva carpeta com.ibm.commerce.catalog-ext de modo que la vía de acceso sea parecida a la siguiente:
  
  workspace_dir\WC\xml\config\com.ibm.commerce.catalog-ext\
  
  Si esta carpeta existe y contiene una versión personalizada del archivo wc-search.xml, abra el archivo y salte al paso 4.
3. Cree un archivo vacío wc-search.xml en la carpeta com.ibm.commerce.catalog-ext. Este archivo es el archivo wc-search.xml personalizado.

Añada los elementos XML básicos que son necesarios para el archivo wc-search.xml personalizado:

Abra el archivo wc-search.xml vacío personalizado en un editor XML.

Copie el siguiente código en el archivo:

<?xml version="1.0" encoding="UTF-8"?>

<_config:search-config
	xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../xsd/wc-search.xsd ">


</_config:search-config>

Añada XML para cualquiera de las propiedades que desee cambiar en el archivo wc-search.xml personalizado:
1. Vaya al archivo de configuración de predeterminado en la vía de acceso siguiente:
  
  workspace_dir\WC\xml\config\com.ibm.commerce.catalog-fep\wc-search.xml
  
  No cambie nunca las propiedades directamente en este archivo porque los cambios se sobrescribirán con futuras actualizaciones de software de IBM.
2. Copie los elementos XML para las propiedades que desea cambiar del archivo de configuración de búsqueda de a su archivo de wc-search.xml personalizado. Inserte los elementos XML copiados antes del elemento </_config:search-config>.
  
  Aunque esté copiando únicamente determinados elementos, debe mantener la jerarquía XML para aquellos elementos del archivo. Por ejemplo, si desea cambiar la propiedad definida en un elemento <_config:param> específico, debe conservar los elementos padre y predecesor del elemento <_config:param>, pero puede eliminar todos los iguales si no los cambia. También debe mantener el orden de los hermanos, ya que se espera que estén en el mismo orden en que aparecen en el archivo de configuración predeterminado.
3. Cambie los valores de las propiedades copiadas que sean necesarios.
4. Encima del elemento </_config:search-config> añada una lista de los perfiles que se heredan directa o indirectamente del perfil cuyos valores de propiedad ha cambiado.
  
  Los perfiles de búsqueda tienen una estructura jerárquica. El archivo wc-search.xml predeterminado contiene un número de perfiles que heredan elementos directa e indirectamente de otros perfiles. Por ejemplo, el perfil IBM_Global contiene un número de perfiles hereditarios. Para asegurarse de que los valores que cambie son recogidos por los perfiles ampliados, debe incluir una lista de estos perfiles en el archivo wc_search.xml personalizado. Al incluir esta lista, los valores de propiedad que cambie se fusionarán correctamente entre los dos archivos. Puede ver un ejemplo de esta lista de perfiles (vea el fragmento de código entre las letras B y C).
Guarde y cierre el archivo wc-search.xml personalizado.
Pruebe los cambios de configuración.

Ejemplo

El ejemplo siguiente muestra el contenido de un archivo wc-search.xml personalizado que cambia tres propiedades que están definidas dentro del perfil IBM_Global:

<?xml version="1.0" encoding="UTF-8"?>
<_config:search-config
	xmlns:_config="http://www.ibm.com/xmlns/prod/commerce/foundation/config"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.ibm.com/xmlns/prod/commerce/foundation/config ../xsd/wc-search.xsd ">
A
    <_config:profile indexName="CatalogEntry" name="IBM_Global">
        <_config:query>
            <_config:param name="price" value="0" />
            <_config:param name="statistics" value="true"/>
        </_config:query>
        	<_config:spellcheck>
        		<_config:param name="limit" value="3"/>
        	</_config:spellcheck>
    </_config:profile>
B
	<_config:profile extends="IBM_Global" name="IBM_findCatalogEntryByName"/>
	<_config:profile extends="IBM_findCatalogEntryByName" name="IBM_findCatalogEntryByNameAndShortDescription"/>
	<_config:profile extends="IBM_findCatalogEntryByNameAndShortDescription" name="IBM_findCatalogEntryByNameAndShortDescriptionInDetail"/>
	<_config:profile extends="IBM_Global" name="IBM_findCatalogEntryByUnstructureField"/>
C
</_config:search-config>

En el ejemplo anterior, el fragmento de código que empieza por A y finaliza por B es el código insertado que cambia tres propiedades:

price: El valor de la propiedad se cambia de 1 a 0.
statistics: El valor de la propiedad se cambia de false a true.
limit: El valor de la propiedad se cambia de 5 a 3.

Tenga en cuenta que los elementos padre y predecesor de cada elemento <_config:param> se mantienen en el archivo wc-search.xml personalizado.

El fragmento de código que empieza por B y termina por C es la lista de los perfiles que se extienden directa e indirectamente del perfil IBM_Global. Este fragmento de código se ha incluido para garantizar que estos perfiles recogen los valores de propiedad cambiados.