Instalar el tema de Adventure Works
Este artículo describe cómo instalar el tema Adventure Works en Microsoft Dynamics 365 Commerce.
Importante
El tema de Adventure Works y los módulos están disponibles a partir del lanzamiento de la versión 10.0.20 de Dynamics 365 Commerce. Están disponibles en Microsoft AppSource.
Requisitos previos
Antes de instalar el tema Adventure Works, debe tener un entorno Dynamics 365 Commerce (Commerce versión 10.0.20 o posterior) que incluya Retail Cloud Scale Unit (RCSU), el kit de desarrollo de software en línea (SDK) de Commerce y la biblioteca del módulo de Commerce. Para obtener información sobre cómo instalar el SDK de Commerce y la biblioteca de módulos, consulte Configurar un entorno de desarrollo.
Pasos de instalación
Instale el tema Adventure Works en su aplicación
El paquete de temas Adventure Works está disponible en la fuente dynamics365-commerce, como @msdyn365-commerce-theme / adventureworks-theme-kit. Sin embargo, aunque el paquete de temas de Adventure Works es parte de esa fuente, está en un espacio de nombres diferente. Por lo tanto, debe seguir estos pasos para agregar entradas de registro para el espacio de nombres.
Actualice el archivo .npmrc para que incluya la siguiente entrada de registro (si la entrada aún no está incluida):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Actualice el archivo .yarnrc para que incluya la siguiente entrada de registro (si la entrada aún no está incluida):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Para instalar el paquete en su entorno local, ejecute el comando yarn add THEME_PACKAGE@VERSION desde el símbolo del sistema, donde THEME_PACKAGE es el paquete de temas (@msdyn365-commerce-theme/adventureworks-theme-kit) y VERSION es el número de versión de la biblioteca de módulos que se está utilizando. Es importante que las versiones del paquete de temas y la biblioteca de módulos coincidan. Para encontrar el número de versión de la biblioteca del módulo correcto para usar, abra el archivo package.json y localice el valor starter-pack en la sección dependencies. En el siguiente ejemplo, el archivo package.json usa la versión 9.32 de la biblioteca de módulos que se asigna a la versión 10.0.22 de Dynamics 365 Commerce.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
El siguiente ejemplo muestra cómo ejecutar el comando yarn add para agregar la versión 9.32 del tema Adventure Works. El comando actualiza automáticamente el archivo package.json para que incluya la dependencia.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Para obtener información sobre cómo actualizar la versión de la biblioteca del módulo, consulte Actualizaciones de SDK y biblioteca de módulos.
Importante
- La versión del tema debe coincidir con la versión de la biblioteca del módulo para garantizar que todas las funciones funcionen como se espera.
- La versión mínima para la biblioteca del módulo de Comercio y el SDK debe ser 10.0.20 (9.31).
Agregue los archivos de fuentes para el tema Adventure Works
Una vez que el tema Adventure Works está instalado en su aplicación, debe agregar los archivos de fuentes necesarios para ello. Para completar este paso, copie todos los archivos de fuentes de \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts a la ruta del directorio público de la aplicación asociada \public\webfonts.
Configure los recursos para el tema Adventure Works
El siguiente paso es actualizar el recurso predeterminado requerido para el tema. Para completar este paso, copie el contenido del archivo global.json en \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules al archivo global.json de la aplicación de partner en \src\resources\modules. Si el directorio de destino \src\rresources no existe, se puede copiar en su totalidad desde el directorio de origen \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks al directorio \src.
Extraiga actualizaciones y valide el tema
Para obtener información sobre cómo extraer el SDK más reciente, la biblioteca de módulos y otras actualizaciones de dependencia, consulte la sección "Extraer actualizaciones" de Actualizaciones de biblioteca de módulos y SDK.
Una vez que se eliminan las dependencias más recientes, puede ejecutar el comando comenzar hilo para iniciar el servidor Node en su entorno de desarrollo y probar el nuevo tema de Adventure Works. Examine la aplicación localmente mediante el parámetro de cadena de consulta ?theme=adventureworks (por ejemplo, https://localhost:4000/?theme=adventureworks).