Visión general del programa de utilidad de Carga de datos

Diagrama de interacción del programa de utilidad de carga de datos con los usuarios

El diagrama siguiente describe cómo interactúan los roles de usuario con el programa de utilidad de carga de datos:

1. El usuario de empresa proporciona al desarrollador los datos de negocio.
2. El desarrollador crea una plantilla de origen de datos, que define cómo se deben formatear los datos de origen antes de cargarlos.
3. El desarrollador también crea el archivo de configuración de objeto de negocio. El archivo de configuración del objeto de negocio define cómo correlaciona el programa de utilidad de carga de datos los datos de entrada con el objeto de negocio y cómo transformar el objeto de negocio con datos físicos.
4. El administrador del sitio utiliza el archivo de configuración de objeto de negocio para definir y crear el archivo de configuración de orden de carga.
5. El administrador del sitio establece los valores de tienda y de base de datos en el archivo de configuración de entorno.
6. Los datos de negocio se formatean según las reglas de la plantilla de origen de datos antes de cargarlos en la base de datos.
7. Los datos de origen con formato se proporcionan al administrador del sitio.
8. El administrador del sitio ejecuta el programa de utilidad de carga de datos junto con los tres archivos de configuración (los archivos de configuración de entorno, orden de carga y objeto de negocio) para cargar los datos de origen con formato en la base de datos de HCL Commerce. Después de ejecutar el programa de utilidad, el administrador del sitio también verifica el resultado de la carga.
9. Los datos de negocio están disponibles en HCL Commerce para que el usuario de negocio los gestione.

Para obtener más información sobre cómo está estructurado el proceso de carga de datos, consulte Visión general de la arquitectura del programa de utilidad de carga de datos. Para obtener más información sobre cómo utilizar el programa de utilidad de carga de datos y qué componentes están incluidos en el proceso, consulte Proceso y componentes de la infraestructura de carga de datos.

Ejecutar el programa de utilidad de carga de datos

Para utilizar el programa de utilidad de carga de datos para cargar datos en la base de datos de HCL Commerce, configure o cree primero los archivos necesarios. Para ejecutar el programa de utilidad de carga de datos, son necesarios un archivo de configuración de objeto de negocio, Para obtener más información, consulte Configuración y ejecución del programa de utilidad de carga de datos.

Mejores prácticas

Limitaciones del programa de utilidad de carga de datos

• No puede utilizar buscadores JPA de datos de Spring en componentes de carga de datos. En su lugar, la infraestructura de carga de datos proporciona una clase, DBPreparedStatement, con la que puede emitir comandos SQL para captar datos directamente de la base de datos.
• Si ejecuta el programa de utilidad de carga de datos en la modalidad paralela/multiproceso, es decir, estableciendo multipleThreadsEnabled="true", los archivos CSV de entrada deberán tener información en la cabecera. Además, asegúrese de que el archivo correspondiente wc-loader-object.xml contiene la propiedad firstLineIsHeader="true". Si en la cabecera no hay información, el programa de utilidad de carga de datos puede dar un error al volver a procesar los archivos CSV que contienen registros de error. Para obtener más información sobre esta configuración, consulte Paralelización de carga de datos.
• Es posible que los objetos de negocio recién creados no se visualicen inmediatamente en el escaparate debido al almacenamiento en memoria caché. Para resolver este problema, invalide manualmente la memoria caché dinámica. Para obtener más información sobre la invalidación de la memoria caché, consulte Eliminar entradas de memoria caché mediante el Supervisor de memoria caché.
• Cuando actualiza los objetos de negocio, puede que los cambios no se visualicen en el Management Center. Esto puede producirse debido al almacenamiento en memoria caché. Para resolver este problema, invalide la memoria caché de datos.
• Puede cargar datos únicamente en archivos con formato CSV y XML. De forma predeterminada, la mayoría de los archivos de configuración de ejemplo que se proporcionan con HCL Commerce se configuran para cargar archivos CSV. Para cargar archivos XML, debe configurar el programa de utilidad para que utilice el lector de datos XML. Los archivos de entrada XML también deben utilizar una estructura parecida a CSV. Para obtener más información, consulte Formato de archivo para archivos de entrada de carga de datos.

  Si desea cargar datos en otros formatos o en una estructura XML a la que no dé soporte el lector de datos XML, debe crear su propio lector de datos personalizado.

• Debe configurar el programa de utilidad de carga de datos para que utilice un mediador de objetos de negocio para correlacionar los datos de archivo de entrada con los objetos de negocio de HCL Commerce adecuados. De forma predeterminada se facilitan mediadores de objetos de negocio para cargar datos para objetos de negocio en los siguientes componentes:
  • Catálogo
  • Inventario
  • Filtro de precio y catálogo
  • Member
  • Ubicación
  • Commerce Composer
  • Promociones
  • Marketing
  Para cargar otros datos, puede utilizar com.ibm.commerce.foundation.dataload.businessobjectmediator.TableObjectMediator, o puede crear sus propios mediadores de objetos de negocio personalizados.
• El TableObjectMediator no da soporte al bloqueo en espacios de trabajo.
• Si el sitio utiliza la búsqueda de HCL Commerce, el índice de búsqueda delta puede no volver a crearse correctamente cuando se suprimen algunos objetos de catálogo con el programa de utilidad de carga de datos en modalidad de supresión. Cuando se suprime un objeto hijo de una entrada de catálogo o categoría con el programa de utilidad en modalidad de supresión, tanto el hijo como el objeto padre se eliminan de la reconstrucción de índice de búsqueda delta. Esta eliminación puede provocar que la categoría o la entrada de catálogo padre ya no se indexen ni visualicen correctamente en el escaparate.

  Utilice el programa de utilidad en modalidad de sustitución para eliminar objetos de catálogo cuando el sitio utiliza la búsqueda de HCL Commerce . Para eliminar objetos con el programa de utilidad en modalidad de sustitución, incluya el valor 1 para la columna Delete de un objeto en el archivo de entrada. Si decide eliminar objetos de catálogo con el programa de utilidad en modalidad de supresión, ejecute una reconstrucción de índice completa una vez que se haya completado la operación de carga.

• Los mediadores de objetos de negocio de componente de miembro no dan soporte a las siguientes acciones con el programa de utilidad de carga de datos:
  • Supresión de usuarios u organizaciones
  • Carga de contraseñas de usuario
  • Modificación de la organización padre de un miembro
  • Modificación del nombre distinguido (DN) de una organización
  • Modificación del tipo de entidad de una organización
• Cuando carga userData en tablas de datos de extensión personalizada, no puede cargar datos en columnas que tienen un tipo de datos que no está soportado por el programa de utilidad.
• Ejecute una carga de datos aparte para cada tipo de datos. Si realiza una sola carga de datos para dos tipos de datos diferentes (por ejemplo, producto, categoría), esto afecta al índice de búsqueda, ya que produce resultados imprevisibles al realizar determinadas tareas de negocio (actualización de NRT) mediante el Centro de gestión. Para resolverlo, debe volver a indexar los datos después de la finalizar satisfactoriamente la carga de datos en la base de datos.

Procedimientos y ejemplos