Creación de un archivo JSP de controlador para recuperar información para vista previa contextual

Para que la vista previa contextual funcione correctamente para el objeto de negocio, asegúrese de que la información de URL se devuelva como parte del objeto. Un modo de recuperar la información del URL es crear un archivo JSP de controlador personalizado para que funcione con un archivo JSP de serialización para transformar nombres de servicios de HCL Commerce en XML para que se visualice en el Management Center. La JSP del controlador envía los nombres de respuestas BOD a un archivo JSP de serialización para el formato XML.

Nota: La creación de un archivo JSP de serialización sólo es uno de los diversos modos de transformar la información de URL en XML. Es posible que tenga servicios o métodos personalizados para transformar información de URL. Por ejemplo, si tiene un código wcf url personalizado que devuelve información de URL en el formato esperado, no se requiere un archivo JSP de serialización. Puede implementar el código url en el archivo JSP de controlador.

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

Cuando un usuario de empresa trabaja en un objeto e inicia la vista previa de la tienda, se realiza una llamada para recuperar la información del URL del objeto. Para recuperar la información de URL de la vista previa contextual, la información del URL debe estar en el formato XML que requiere el Management Center. Para transformar esta información de URL en formato XML, son necesarios una JSP de controlador y un archivo JSP de serialización. La JSP de controlador determina cómo manejar la petición de transformación y envía el contenido al archivo JSP de serialización correcto. El archivo JSP de serialización se utiliza para recibir propiedades de objeto desde nombres y transformar esta información de URL para utilizarla en la vista previa de la tienda del Management Center.

Cuando se produce la llamada para recuperar información del URL, la JSP del controlador invoca la biblioteca de códigos wcf:getData para recuperar el nombre que se ha utilizado para el objeto del Management Center. En el código wcf:getData, el parámetro expressionBuilder define la plantilla de consulta que se ejecutará. La plantilla de consulta se correlaciona con la sentencia de SQL que recupera los datos. Para obtener más información, consulte Aplicación web del Centro de gestión.

Procedimiento

Cree un archivo JSP de controlador.
1. En la vista Explorador de empresa, expanda LOBTools > WebContent > jsp > your_company_name > component_name. Cree la estructura de directorio si no existe.
2. Pulse con el botón derecho del ratón en el directorio component_name; a continuación, seleccione Nuevo > Archivo.
1. En el campo Nombre de archivo, entre un nombre para el nuevo archivo JSP que tenga este formato: GetObjectNamePageSeoUrl.jsp.
  Por ejemplo, para un objeto de recopilación de recetas, denomine al archivo JSP GetRecipeCollectionPageSeoUrl.jsp.
2. Pulse Finalizar.
3. Desarrolle el código para el archivo JSP de controlador.
  Asegúrese de que en el archivo JSP del controlador, defina el código wcf:getData para recuperar el nombre para el nuevo objeto del Management Center de los servicios de HCL Commerce. En el código wcf:getData, defina el tipo correcto de datos que se va a recuperar y el creador de expresiones correcto. El creador de expresiones se define en el archivo get-data-config.xml para el componente y define la plantilla de consulta que se ejecutará para recuperar la información de URL. Los siguientes fragmentos de código son ejemplos de creadores de expresiones que están predefinidos para los objetos de negocio existentes que la vista previa de contexto admite.
  - Para objetos relacionados con páginas del catálogo:
    <wcf:getData type="com.ibm.commerce.catalog.facade.datatypes.CatalogGroupType[]" var="category" expressionBuilder="getCatalogGroupSEOByID">
  - Para objetos relacionados con páginas de entrada de catálogo:
    <wcf:getData type="com.ibm.commerce.catalog.facade.datatypes.CatalogEntryType[]" var="catalogEntry" expressionBuilder="getCatalogEntrySEOByID">
  - Para objetos relacionados con páginas estáticas:
    <wcf:getData type="com.ibm.commerce.infrastructure.facade.datatypes.OnlineStoreType[]" var="staticPagesSEO" expressionBuilder="findAllSEOStaticPageURLKeywordSummaryByStoreID">
4. Guarde y cierre el archivo.
Registre el archivo JSP en el archivo de configuración struts-extension.xml:
1. En la vista Explorador de empresa, expanda LOBTools > WebContent > WEB-INF.
2. Realice uno de los dos conjuntos de pasos siguientes, en función de si la versión de HCL Commerce es 9.0.0. x o 9.0.1.x.
  Si utiliza HCL Commerce versión 9.0.0.x:
  1. Abra el archivo struts-extension.xml en un editor de texto.
  2. En la sección <action-mappings>, añada una correlación de acción para registrar el archivo JSP de controlador.
    <action path="pathName" forward="pathToJSP" />
    
    pathName
    
    Nombre que se utiliza para correlacionar con el archivo JSP.
    
    pathToJSP
    
    Vía de acceso al archivo JSP, desde LOBTools > WebContent.
  3. Guarde y cierre el archivo struts-extension.xml.
  Por ejemplo, para crear una correlación con un archivo JSP que recupera el URL para una página de la colección de recetas, añada el código siguiente al archivo:
```
<action path="/GetRecipeCollectionPageSeoUrl" forward="/jsp/your_company_name/component_name/GetRecipeCollectionPageSeoUrl.jsp" />
```
  Si utiliza HCL Commerce versión 9.0.1.x:
  1. Abra el archivo spring-extension.xml en un editor de texto.
  2. En la sección <beans>, añada una correlación de acción para registrar el archivo JSP de controlador.
    <bean id="beanName" class="org.springframework.web.servlet.mvc.ParameterizableViewController"> <property name="viewName" value="pathToJSP"/> </bean>
    
    nombreBean
    
    Nombre que se utiliza para correlacionar con el archivo JSP.
    
    pathToJSP
    
    Vía de acceso al archivo JSP, desde LOBTools > WebContent.
    
    Por ejemplo, para crear una correlación con un archivo JSP que recupera el URL para una página de la colección de recetas, añada el código siguiente al archivo:
    <bean id="/GetRecipeCollectionPageSeoUrl" class="org.springframework.web.servlet.mvc.ParameterizableViewController"> <property name="viewName" value="/jsp/your_company_name/component_name/GetRecipeCollectionPageSeoUrl.jsp"/> </bean>
  3. Guarde y cierre el archivo spring-extension.xml.
  Por ejemplo, para crear una correlación con un archivo JSP que recupera el URL para una página de la colección de recetas, añada el código siguiente al archivo:
```
<bean id="/GetRecipeCollectionPageSeoUrl" class="org.springframework.web.servlet.mvc.ParameterizableViewController"> 
<property name="viewName" value="/jsp/your_company_name/component_name/GetRecipeCollectionPageSeoUrl.jsp"/> 
</bean>
```