Oharra
Orrialde honetara sartzeak baimena behar du. Saioa hasteko edo direktorioak aldatzen saia zaitezke.
Orrialde honetara sartzeak baimena behar du. Direktorioak aldatzen saia zaitezke.
Nota:
El grupo de interés comercial de Dynamics 365 Commerce ha pasado de Yammer a Viva Engage. Si no tiene acceso a la nueva comunidad de Viva Engage, rellene este formulario (https://aka.ms/JoinD365commerceVivaEngageCommunity) para agregar y mantenerse involucrado en las últimas discusiones.
Este artículo describe cómo instalar el tema Adventure Works en Microsoft Dynamics 365 Commerce.
Importante
El tema y los módulos adventure Works están disponibles a partir de la versión 10.0.20 de Dynamics 365 Commerce. Puede obtenerlos de Microsoft Marketplace.
Requisitos previos
Antes de instalar el tema Adventure Works, asegúrese de que tiene un entorno de 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 de módulos commerce. Para obtener información sobre cómo instalar el SDK de Commerce y la biblioteca de módulos, consulte Configuración de un entorno de desarrollo.
Pasos de instalación
Instale el tema Adventure Works en su aplicación
La fuente dynamics365-commerce ofrece el paquete de temas Adventure Works como @msdyn365-commerce-theme/adventureworks-theme-kit. Sin embargo, el paquete usa un espacio de nombres diferente. Por lo tanto, debe agregar entradas del registro para el espacio de nombres.
Actualice el archivo .npmrc para incluir la siguiente entrada del 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 incluir la siguiente entrada del 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 el entorno local, ejecute el comando yarn add THEME_PACKAGE@VERSION desde el símbolo del sistema. Reemplace THEME_PACKAGE por el nombre del paquete de temas (@msdyn365-commerce-theme/adventureworks-theme-kit) y VERSION por el número de versión de la biblioteca de módulos que está usando. Asegúrese de que las versiones del paquete de temas y de la biblioteca de módulos coincidan. Para buscar el número de versión de la biblioteca de módulos correcto, abra el archivo package.json y busque el valor starter-pack en la sección dependencias . En el ejemplo siguiente, 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
Después de instalar el tema Adventure Works en la aplicación, agregue los archivos de fuente necesarios. 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
Actualice el recurso predeterminado para el tema. Para completar este paso, copie el contenido del global.json archivo en \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules en el archivo de aplicación global.json asociado en \src\resources\modules. Si el directorio de destino \src\resources no existe, puede copiarlo en su totalidad desde el directorio de origen \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks al directorio de destino \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.
Después de extraer las dependencias más recientes, ejecute el comando yarn start para iniciar el servidor node en el entorno de desarrollo y probar el nuevo tema adventure Works. Examine la aplicación localmente mediante el parámetro de cadena de consulta ?theme=adventureworks (por ejemplo, https://localhost:4000/?theme=adventureworks).