Nota
L-aċċess għal din il-paġna jeħtieġ l-awtorizzazzjoni. Tista’ tipprova tidħol jew tibdel id-direttorji.
L-aċċess għal din il-paġna jeħtieġ l-awtorizzazzjoni. Tista’ tipprova tibdel id-direttorji.
Note
The Retail Interest Group by Dynamics 365 Commerce has moved from Yammer to Viva Engage. If you don't have access to the new Viva Engage community, fill out this form (https://aka.ms/JoinD365commerceVivaEngageCommunity) to be added and stay engaged in the latest discussions.
This article describes how to install the Adventure Works theme in Microsoft Dynamics 365 Commerce.
Important
The Adventure Works theme and modules are available starting with the Dynamics 365 Commerce version 10.0.20 release. You can get them from Microsoft Marketplace.
Prerequisites
Before you install the Adventure Works theme, make sure you have a Dynamics 365 Commerce environment (Commerce version 10.0.20 or later) that includes Retail Cloud Scale Unit (RCSU), the Commerce online software development kit (SDK), and the Commerce module library. For information about how to install the Commerce SDK and module library, see Set up a development environment.
Installation steps
Install the Adventure Works theme in your application
The dynamics365-commerce feed offers the Adventure Works theme package as @msdyn365-commerce-theme/adventureworks-theme-kit. However, the package uses a different namespace. Therefore, you must add registry entries for the namespace.
Update the .npmrc file to include the following registry entry (if the entry isn't already included):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Update the .yarnrc file to include the following registry entry (if the entry isn't already included):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
To install the package in your local environment, run the yarn add THEME_PACKAGE@VERSION command from the command prompt. Replace THEME_PACKAGE with the theme package name (@msdyn365-commerce-theme/adventureworks-theme-kit) and VERSION with the version number of the module library you're using. Make sure the versions of the theme package and the module library match. To find the correct module library version number, open the package.json file and locate the starter-pack value under the dependencies section. In the following example, the package.json file uses version 9.32 of the module library, which maps to the Dynamics 365 Commerce version 10.0.22 release.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
The following example shows how to run the yarn add command to add version 9.32 of the Adventure Works theme. The command automatically updates the package.json file so that it includes the dependency.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
For more information about updating the module library version, see SDK and module library updates.
Important
- The theme version should match the module library version to ensure that all features work as expected.
- The minimum version for the Commerce module library and SDK should be 10.0.20 (9.31).
Add the font files for the Adventure Works theme
After you install the Adventure Works theme in your app, add the required font files. To complete this step, copy all the font files from \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts to the partner application public directory path \public\webfonts.
Set up the resources for the Adventure Works theme
Update the default resource for the theme. To complete this step, copy the content from the global.json file under \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules to the partner application global.json file under \src\resources\modules. If the \src\resources target directory doesn't exist, you can copy it in its entirety from the \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks source directory to the \src target directory.
Pull updates and validate the theme
For information about how to pull the latest SDK, module library, and other dependency updates, see the "Pull updates" section of SDK and module library updates.
After you pull the latest dependencies, run the yarn start command to start the Node server in your development environment and test the new Adventure Works theme. Browse the application locally by using the query string parameter ?theme=adventureworks (for example, https://localhost:4000/?theme=adventureworks).