Deprecated feature

Ampliar el archivo get-data-config.xml

Ampliar el archivo get-data-config.xml cuando se le haya proporcionado el archivo de configuración. Mediante la ampliación de la configuración, puede alterar las propiedades del generador de expresiones.

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

Complete esta tarea cuando amplíe un módulo de servicio, donde se le haya facilitado automáticamente el archivo de configuración. Si crea un nuevo módulo de servicio y no se le ha facilitado automáticamente el archivo de configuración, en su lugar, deberá crear un nuevo archivo de configuración.

Procedimiento

  1. Cree el archivo get-data-config.xml para el proyecto.
    • Abra HCL Commerce Developer y cambie a la vista Enterprise Explorer.
    • En vista Enterprise Explorer, expanda YourProject > WebContent > WEB_INF > config.

      Donde YourProject es el proyecto que ejecuta el código utilizando el código getData.

    • Pulse el botón derecho del ratón en la carpeta config y seleccione Nuevo > Archivo.
    • En el campo Nombre de carpeta, escriba com.mycompany.commerce.project-ext y pulse Finalizar.
      Nota: Cuando se crean carpetas de ampliaciones, el nombre de la carpeta termina automáticamente con -ext. Esto garantiza que el get-data-config.xml archivo original ubicado en la carpeta que lo precede inmediatamente permanece sin cambios.En su lugar, si amplía la configuración, puede alterar las propiedades del generador de expresiones.
    • Si no se puede ver la carpeta com.mycompany.commerce.project-ext, pulse el botón derecho del ratón en el directorio config en el vista Enterprise Explorer y pulse Renovar.
    • Pulse el botón derecho del ratón en la carpeta com.mycompany.commerce.project-ext y seleccione Nuevo > Archivo.
    • En el campo Nombre de archivo, escriba get-data-config.xml y pulse Finalizar. El archivo get-data-config.xml recién creado se abre automáticamente.
  2. Determine qué generadores de expresiones deben ampliarse a partir del archivo get-data-config.xml base y cópielos en el archivo de ampliaciones.
    1. Vaya a la carpeta inmediatamente anterior a la carpeta de ampliaciones y efectúe una doble pulsación en el archivo get-data-config.xml original proporcionado para abrirlo en el editor predeterminado.
    2. Localice las definiciones de generador de expresiones que desee ampliar y copie la sección que aparece entre cada una de las etiquetas <expression-builder> y </expression-builder>.
    3. Pegue el contenido copiado del archivo base get-data-config.xml en el archivo ampliado get-data-config.xml, antes de la línea </wcf:get-data-config> al final de este archivo.
  3. Actualice el generador de expresiones nuevo en el archivo ampliado get-data-config.xml.
    Cada generador de expresiones tiene las propiedades siguientes:
    • El nodo name identifica de forma exclusiva el generador de expresiones y lo utilizan los etiquetas getData en los archivos JSP del proyecto cuando se hace referencia a un generador de expresiones.
    • El nodo data-type-name contiene el tipo de nombre que devuelve el generador de expresiones.
    • El nodo expression template hace referencia a una consulta XPath definida en el archivo de plantilla de consulta, que se utiliza para recuperar información específica de la base de datos. Se pueden pasar parámetros como $projectID$ al generador de expresiones mediante un código getData.
    • Cada nodo param contiene un par de nodos secundarios name y value que definen un parámetro que debe pasarse al archivo de plantilla de consulta. Cada generador de expresiones está asociado a un perfil de acceso específico. Este perfil de acceso, junto con la consulta XPath definida, identifica de forma exclusiva una consulta en el archivo de plantilla de consulta.
    Nota: Solo debe cambiar los elementos que desee alterar temporalmente en cada generador de expresiones.
    Cada generador de expresiones debería ser similar a la estructura de ejemplo siguiente, sustituyendo los nodos vacíos por los propios generadores de expresiones relacionados con el propio proyecto. En función de qué elementos desee alterar temporalmente, es posible que los nodos que aparecen a continuación no reflejen los cambios efectuados:
    
<!-- Project related expression builder extension 1. Note: every node may not apply to your specific scenario. -->	
<expression-builder>
		<name> </name>
		<data-type-name> </data-type-name>
		<expression-template> </expression-template>
		<param>
			<name> </name>
			<value> </value>
		</param>
	</expression-builder>

<!-- Project related expression builder extension 2. Note: every node may not apply to your specific scenario. -->
<expression-builder>
		<name> </name>
		<data-type-name> </data-type-name>
		<expression-template> </expression-template>
		<param>
			<name> </name>
			<value> </value>
		</param>
	</expression-builder>

	<!-- Project related expression builder extension 3. Note: every node may not apply to your specific scenario. -->
<expression-builder>
		<name> </name>
		<data-type-name> </data-type-name>
		<expression-template> </expression-template>
		<param>
			<name> </name>
			<value> </value>
		</param>
	</expression-builder>
</wcf:get-data-config>
    Nota: Aunque hay tres generadores de expresiones en la estructura del generador de expresiones de ejemplo, los generadores de expresiones relacionados con el propio proyecto pueden contener todos los generadores de expresiones que sean necesarios.

Resultados

Tras completar estos pasos, habrá ampliado satisfactoriamente un módulo de servicio, cuando se le haya proporcionado el archivo de configuración.