Home
Documentación
HCL Commerce es una plataforma de comercio electrónico de alta disponibilidad, muy escalable y personalizable. Con capacidad para dar soporte a cientos de miles de transacciones por día, HCL Commerce le permite hacer negocios con consumidores (B2C) o directamente con empresas (B2B). HCL Commerce utiliza tecnología compatible con la nube para que el desarrollo y la operación sean sencillas y eficaces. Proporciona herramientas de fácil uso para que los usuarios de empresa gestionen de forma centralizada una estrategia entre canales. Los usuarios de empresa pueden crear y gestionar campañas de marketing de precisión, promociones, catálogo y comercialización en todos los canales de ventas. Los usuarios de empresa también pueden utilizar funciones de gestión de contenido habilitadas con inteligencia artificial.
Referencia
Los temas de la sección Referencia contienen toda la documentación de referencia HCL Commerce.
Referencia de API de HCL Commerce
HCL Commerce expone dos API de programación principales. La primera y más reciente API es una interfaz de REST, y la mayoría de las clases nuevas se exponen aquí. La API de Java heredada también contiene nuevas clases que no son adecuadas para REST y se pueden examinar en formato Javadoc.
HCL Commerce API REST
La documentación de API REST de HCL Commerce contiene una lista de los recursos que proporciona la API REST de HCL Commerce. Cada recurso REST contiene información como URL, descripciones y datos de entrada y salida de ejemplo.
Anotaciones de servicio REST
HCL Commerce Los servicios REST y los servicios REST de búsqueda se anotan, de forma que pueda ver y probar las API con Swagger, una interfaz de servicio REST interactiva. La API de descubrimiento REST genera una lista de las API y los recursos REST analizando las anotaciones en un manejador de recursos. Al documentar los manejadores de recursos REST personalizados con los mismos estándares de anotación que los servicios REST de HCL Commerce, los servicios REST personalizados se pueden ver y probar con Swagger.
Habilitar e inhabilitar la API de REST Discover
Es posible que desee impedir que Swagger muestre su API RESTful en un navegador web, especialmente en un entorno de producción que esté atendiendo al tráfico en vivo. Al inhabilitar la API de descubrimiento de REST, puede impedir que los servicios de REST se recuperen y muestren en Swagger. De forma alternativa, puede habilitar la API de REST Discovery para ver y probar los servicios de REST con Swagger.

Documentación
HCL Commerce es una plataforma de comercio electrónico de alta disponibilidad, muy escalable y personalizable. Con capacidad para dar soporte a cientos de miles de transacciones por día, HCL Commerce le permite hacer negocios con consumidores (B2C) o directamente con empresas (B2B). HCL Commerce utiliza tecnología compatible con la nube para que el desarrollo y la operación sean sencillas y eficaces. Proporciona herramientas de fácil uso para que los usuarios de empresa gestionen de forma centralizada una estrategia entre canales. Los usuarios de empresa pueden crear y gestionar campañas de marketing de precisión, promociones, catálogo y comercialización en todos los canales de ventas. Los usuarios de empresa también pueden utilizar funciones de gestión de contenido habilitadas con inteligencia artificial.
- Cómo empezar
  HCL Commerce ofrece diferentes ventajas a los usuarios de empresa, a los administradores y a los desarrolladores. HCL Commerce está pensado para cada uno de estos roles con un conjunto adaptado de ofertas para que cada uno de los usuarios pueda obtener el máximo beneficio.
- Instalación y despliegue
  Aprenda a instalar y desplegar HCL Commerce development environment y los entorno de producción de HCL Commerce.
- Migración
  Antes de migrar a HCL Commerce Version 9.1, revise esta información que le ayudará a planificar y ejecutar la migración.
- Operación
  Los temas de la categoría operativa resaltan tareas que normalmente realizan los usuarios de empresa, representantes de soporte al cliente, para completar las tareas diarias en el funcionamiento del sitio HCL Commerce.
- Integración
  Los temas de la categoría Integración resaltan las tareas que se llevan a cabo normalmente para utilizar HCL Commerce en combinación con otros productos.
- Administración
  Los temas de la categoría Administración destacan las tareas que normalmente efectúa el Administrador de sitio para soportar las operaciones diarias del sitio de HCL Commerce.
- Personalización
  Los temas de la sección de Personalización describen las tareas realizadas por un desarrollador de aplicaciones para personalización HCL Commerce.
- Guías de aprendizaje
  HCL Commerce proporciona muchas guías para ayudarle a personalizar y comprender la instancia y las tiendas de HCL Commerce.
- Ejemplos
  Los temas de la categoría de ejemplos resaltan las muestras de ejemplo que se proporcionan con HCL Commerce.
- Conformidad
  En la sección siguiente se describe cómo puede sacar provecho de las características y las funciones de HCL Commerce para ayudar al sitio a cumplir con diferentes estándares de privacidad y seguridad.
- Seguridad
  Estos temas describen las características de seguridad de HCL Commerce y cómo configurar dichas características.
- Rendimiento
  Los temas de la sección Rendimiento describen los medios para planificar, implementar, probar y volver a visitar la optimización del rendimiento del sitio de HCL Commerce.
- Solución de problemas
  Los temas de la sección Resolución de problemas señalan cuáles son los problemas comunes que se enfrentan con HCL Commerce y cómo pueden resolverse o mitigarse.
- Referencia
  Los temas de la sección Referencia contienen toda la documentación de referencia HCL Commerce.
  - Referencia de API de HCL Commerce
    HCL Commerce expone dos API de programación principales. La primera y más reciente API es una interfaz de REST, y la mayoría de las clases nuevas se exponen aquí. La API de Java heredada también contiene nuevas clases que no son adecuadas para REST y se pueden examinar en formato Javadoc.
    - HCL Commerce API REST
      La documentación de API REST de HCL Commerce contiene una lista de los recursos que proporciona la API REST de HCL Commerce. Cada recurso REST contiene información como URL, descripciones y datos de entrada y salida de ejemplo.
      - UI de Swagger
        Hay disponible una versión en vivo de la API de REST HCL Commerce en un navegador web del servidor de prueba HCL Commerce utilizando la interfaz de usuario de Swagger. Se compone de un conjunto de HTML estático, CSS y JavaScript que documenta dinámicamente la API REST disponible en el servidor de prueba de HCL Commerce.
      - Visualización de la API REST mediante Swagger en versiones anteriores a la 9.1.6
        Si está usando una versión anterior a 9.1.6, puede acceder a la interfaz de usuario de Swagger para ver y probar todas las API de RESTful que se anotan con las anotaciones compatibles.
      - Configuración de una instancia de Swagger local
        Puede utilizar una instancia de Swagger local para revisar y probar nuevas API REST.
      - Pruebas de API de REST
        A partir de la versión 9.1.6, HCL Commerce es compatible con la especificación OpenAPI3.0. Puede usar la especificación Swagger para probar cualquier API de RESTful que esté documentada en los archivos OAS.
      - API de REST administrativa
        Puede utilizar la API administrativa de HCL Commerce para completar tareas administrativas para gestionar el sitio. La API administrativa de contiene una lista de recursos que se proporcionan para crear, recuperar, cambiar y eliminar datos para administrar las funciones de globalización del sitio, las organizaciones, etc.
      - API de REST de administración de precios
        Estas API se pueden utilizar para crear y administrar funciones de fijación de precios para una tienda como, por ejemplo, para crear y administrar ofertas, listas de precios, reglas de precios, etc.
      - API de REST de administración de búsqueda
        Estas API se pueden utilizar para crear y administrar funciones y funciones de búsqueda, como para crear facetas, definir campos de búsqueda, propiedades de campo, etc.
      - API de REST de administración de Marketplace
        Estas API se pueden utilizar para crear y administrar recursos de Marketplace, incluidos pedidos de Marketplace y artículos de pedido.
      - API de REST de administración de tienda
        Estas API se pueden utilizar para crear y administrar tiendas, incluyendo la definición de idiomas y monedas de tienda admitidos, la definición de configuraciones de tienda, la habilitación de funciones de tienda, etc.
      - API de REST administrativa del sistema
        Estas API se pueden utilizar para crear y administrar funciones de sistemas como, por ejemplo, para administrar trabajos planificados, transportes, tipos de mensajes, registros, formatos de dispositivo, auditorías de negocio, etc.
      - API de REST de administración de usuario y organización
        Estas API se pueden utilizar para crear y administrar usuarios y organizaciones para el sitio, grupos de miembros, roles, asignaciones de roles, políticas de contraseñas, políticas de control de acceso, etc.
      - API REST del escaparate de
        La documentación de la API HCL Commerce del escaparate REST contiene una lista de recursos proporcionados por la API de REST HCL Commerce para recuperar, cambiar y eliminar datos relacionados con una tienda. Cada recurso REST contiene información como URL, descripciones y datos de entrada y salida de ejemplo.
      - Puntos de extensión xC
        Puede utilizar la API de REST para ayudarle a crear la lógica de negocio personalizada para ampliar los procesos existentes HCL Commerce o para llamar a sus propios procesos personalizados.
      - Correlacionar los servicios de REST con los servicios de BOD.
        Las secciones siguientes detallan cómo se relacionan los nombres de métodos de recursos REST con servicios BOD específicos.
      - Correlación de servicios REST con acciones de pasar por caja
        La tienda de inicio Aurora utiliza los servicios REST durante todo el proceso de pasar por caja. Las acciones para cada correlación de página a un servicio REST.
      - Anotaciones de servicio REST
        HCL Commerce Los servicios REST y los servicios REST de búsqueda se anotan, de forma que pueda ver y probar las API con Swagger, una interfaz de servicio REST interactiva. La API de descubrimiento REST genera una lista de las API y los recursos REST analizando las anotaciones en un manejador de recursos. Al documentar los manejadores de recursos REST personalizados con los mismos estándares de anotación que los servicios REST de HCL Commerce, los servicios REST personalizados se pueden ver y probar con Swagger.
        Habilitar e inhabilitar la API de REST Discover
        Es posible que desee impedir que Swagger muestre su API RESTful en un navegador web, especialmente en un entorno de producción que esté atendiendo al tráfico en vivo. Al inhabilitar la API de descubrimiento de REST, puede impedir que los servicios de REST se recuperen y muestren en Swagger. De forma alternativa, puede habilitar la API de REST Discovery para ver y probar los servicios de REST con Swagger.
    - HCL Commerce GraphQL API
      GraphQL facilita la construcción de API. El lenguaje de marcación GraphQL está disponible para cualquier API. Es un intérprete del lado del servidor para procesar consultas utilizando un sistema de tipo de datos que diseñe. Con GraphQL, los datos y el código son independientes de cualquier base de datos o sistema de almacenamiento.
    - Java API classes
      You can browse the HCL Commerce Java APIs in Javadoc format.
  - Referencia cruzada de beans de datos y tablas
    Los beans de datos se agrupan en varios grupos de componentes.
  - Referencia cruzada de mandatos, tareas y tablas
    Los mandatos de URL, mandatos de controlador, mandatos de tarea, mandatos de vista y las tablas están relacionados entre sí.
  - Referencia cruzada: Mandatos a beans a tablas de base de datos
    Utilice esta información cuando personalice un mandato y desee saber las tablas que se ven afectadas. También debería utilizar este tema si modifica una tabla y desea saber los mandatos y beans que se ven afectados.
  - Mandatos Run Engine
    Los siguientes mandatos del motor Run están disponibles de forma predeterminada para poder configurar las aplicaciones que se ejecutan dentro de los contenedores.
  - Introducción de los contenedores Docker.
    Para entrar un contenedor de Docker, puede completar los pasos siguientes.
  - Lógica de inicio del contenedor Docker para la Versión 9.0.0.2 HCL Commerce Version 9.1
    Cuando se despliega un contenedor desde una imagen proporcionada por HCL, un script de ayuda Entrypoint.shdetermina las configuraciones que se utilizarán al iniciar el contenedor. Revise la siguiente información para obtener más detalles sobre qué hace el script de ayuda y cómo puede personalizar las configuraciones.
  - Esquema de base de datos de HCL Commerce
    El modelo de base de datos de HCL Commerce se ha diseñado para la integridad de los datos y para un rendimiento óptimo. HCL Commerce proporciona varios cientos de tablas que almacena datos de instancia HCL Commerce. Para mantener la integridad de los datos y facilitar el mantenimiento de la integridad referencial, se utilizan comúnmente restricciones en el modelo de base de datos. En las tablas, los índices se utilizan con precaución para evitar el sobreindexado y para proporcionar un equilibrio correcto entre las actividades de recuperación de datos y las de manipulación de datos (insertar y actualizar). Las reglas de negocio se implementan a nivel de aplicación, en vez de utilizar un desencadenante de base de datos. No obstante, los desencadenantes se utilizan para facilitar la transición de los datos y el bloqueo optimista. Un número limitado de procedimientos almacenados de base de datos basados en SQL se utilizan para las actividades de uso intensivo de datos.
  - Subsistema de pago
    En HCL Commerce, el proceso de pago utiliza el subsistema de pagos.
  - Almacenamiento en memoria caché dinámica
    En general, el almacenamiento en memoria caché mejora el tiempo de respuesta y reduce la carga del sistema. Las técnicas de almacenamiento en memoria caché se utilizan para mejorar el rendimiento de aplicaciones de World Wide Web de Internet. La mayoría de las técnicas almacenan en memoria caché contenido estático (contenido que raramente cambia), por ejemplo archivos de gráficos y texto. Sin embargo, muchos sitios web sirven contenido dinámico, que contiene información personalizada o datos que cambian más frecuentemente. El contenido dinámico de memoria caché necesita técnicas de almacenamiento en memoria caché más sofisticadas, por ejemplos las proporcionadas por la memoria caché dinámica de WebSphere Application Server, un servicio incorporado para almacenar en memoria caché y servir contenido dinámico.
  - Propiedades de páginas de tienda de HCL Commerce
  - Elementos de entrada de memoria caché (cache-entry)
    El elemento raíz del archivo cachespec.xml, <cache>, contiene elementos <cache-entry>. El servicio de memoria caché dinámica de WebSphere analiza el archivo cachespec.xml durante el arranque del sistema y extrae un conjunto de parámetros de configuración para cada elemento cache-entry.
  - Esquema del archivo de configuración del programa de utilidad de carga de datos
    El programa de utilidad de carga de datos contiene varios archivos de configuración. Puede utilizar el esquema del archivo de configuración para entender y personalizar los archivos de configuración de carga de datos.
  - Servicios web de HCL Commerce
    HCL Commerce proporciona muchos servicios web.
  - Programas de utilidad
    En HCL Commerce los programas de utilidad son scripts que realizan operaciones tales como la carga de políticas de control de acceso, la carga de datos de tienda y la limpieza de la base de datos de objetos obsoletos. En entornos de ejecución, ejecute los programas de utilidad desde Utility server Docker container. En el entorno de desarrollo, ejecute los programas de utilidad desde el directorio bin.
  - URL de flujo de compras
    Los URL del flujo de compra de HCL Commerce están organizados por subsistemas.
  - URL de sistema de mensajería
    Los URL siguientes se relacionan con el sistema de mensajería.
  - URL de planificador
    El subsistema del servidor consta de funciones que están asociadas a los URL que ejecuta el planificador.
  - APi de mejoras jQuery
    La tienda de inicio Aurora en HCL Commerce se escribe completamente en jQuery, que es una de las bibliotecas JavaScript que se utilizan más habitualmente en sitios web dinámicos. La API de sucesos y jQuery AJAX proporciona una infraestructura fácil de utilizar que satisface la mayoría de los requisitos para el desarrollo de escaparates.
  - HCL Commerce biblioteca de códigos de base
    La biblioteca de etiquetas JSTL Foundation HCL Commerce es una colección de etiquetas personalizadas que se proporcionan para dar soporte a la creación de archivos JSP de HCL Commerce. Las tiendas de HCL Commerce utilizan la biblioteca de etiquetas estándar de JavaServer Pages (JSTL) para realizar la lógica, en lugar del código Java. Al mismo tiempo, la lógica de negocio se traslada a los beans de datos. La combinación de estos pasos le permite utilizar menos código Java en una página JSP.

Habilitar e inhabilitar la API de REST Discover

Es posible que desee impedir que Swagger muestre su API RESTful en un navegador web, especialmente en un entorno de producción que esté atendiendo al tráfico en vivo. Al inhabilitar la API de descubrimiento de REST, puede impedir que los servicios de REST se recuperen y muestren en Swagger. De forma alternativa, puede habilitar la API de REST Discovery para ver y probar los servicios de REST con Swagger.

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

La disponibilidad de la API de descubrimiento de REST está controlada por la propiedad ApiDiscoveryEnabled. Puede cambiar esta propiedad dentro del archivo wc-component.xml para el componente foundation. Para obtener más información sobre cómo actualizar los archivos wc-component.xml, consulte Cambiar propiedades de configuración de REST en el archivo de configuración de componente (wc-component.xml).

Notes:

El elemento ApiDiscoveryEnabled se establece en true (habilitado) en entornos HCL Commerce Developer de forma predeterminada.
En los entornos de ejecución, el elemento ApiDiscoveryEnabled está establecido en false (inhabilitado) de forma predeterminada.

Cuando actualice la versión del archivo wc-component.xml, asegúrese de que incluya la propiedad ApiDiscoveryEnabled y establezca el valor en true o false. Por ejemplo, el fragmento de código siguiente establece el valor para la propiedad en false, lo que inhabilita la API de REST Discovery:

<!-- Determines if the REST API Discovery should be enabled. -->
    <_config:property name="ApiDiscoveryEnabled" value="false"/>

Cuando la API Discovery se establece en false, un usuario todavía puede acceder a Swagger en un navegador web, pero no se visualiza ninguna API de REST.

Qué hacer a continuación

Visualización de la API REST mediante Swagger en versiones anteriores a la 9.1.6.