Installera Adventure Works-tema
I denna artikel beskrivs hur du installerar Adventure Works-tema i Microsoft Dynamics 365 Commerce.
Viktigt
Adventure Works-temat och modulerna finns tillgängliga från och med Dynamics 365 Commerce-version 10.0.20. De är tillgängliga från Microsoft AppSource.
Förutsättningar
Innan du installerar Adventure Works-temat måste du ha en Dynamics 365 Commerce-miljö (Commerce version 10.0.20 eller senare) som inkluderar Retail Cloud Scale Unit (RCSU), Commerce online Software Development Kit (SDK) och Commerce modulbiblioteket. Information om hur du installerar Commerce SDK och modulbiblioteket finns i Ställ in en utvecklingsmiljö.
Installationssteg
Installera Adventure Works-tema i programmet
Paketet Adventure Works-tema finns i flödet dynamics365-commerce som @msdyn365-commerce-theme/adventureworks-theme-kit. Även om temapaketet Adventure Works är en del av flödet, finns det dock under ett annat namnområde. Därför måste du följa dessa steg för att lägga till registerposter för namnområdet.
Uppdatera filen .npmrc så att den innehåller följande registerpost (om posten inte redan ingår):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Uppdatera filen .yarnrc så att den innehåller följande registerpost (om posten inte redan ingår):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Om du vill installera paketet i din lokala miljö kör du kommandot yarn add THEME_PACKAGE@VERSION från kommandotolken där THEME_PACKAGE är temapaketet (@msdyn365-commerce-theme/adventureworks-theme-kit) och VERSION är versionsnumret för det modulbibliotek som används. Det är viktigt att versionerna av temapaketet och modulbiblioteket stämmer överens. För att hitta rätt versionsnummer för modulbiblioteket att använda öppnar du filen package.json och letar reda på värdet för startpaket under avsnittet beroendet. I följande exempel använder filen package.json version 9.32 av modulbiblioteket som mappar till Dynamics 365 Commerce versionen 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
I följande exempel visas hur du kör kommandot yarn add för att lägga till version 9.32 av tema Adventure Works. Det här kommandot uppdaterar paket.json-filen automatiskt så att den inkluderar beroendet.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Information om hur du uppdaterar modulbiblioteksversionen finns i SDK- och modulens biblioteksuppdateringar.
Viktigt
- Temaversionen ska matcha modulbiblioteksversionen för att säkerställa att alla funktioner fungerar som förväntat.
- Minimiversionen för modulbiblioteket för Commerce och SDK bör vara 10.0.20 (9.31).
Lägga till teckensnittsfiler för Adventure Works-tema
När Adventure Works-ämnet har installerats i programmet måste du lägga till de teckensnittsfiler som krävs för det. Du slutför det här steget genom att kopiera alla teckensnittsfiler från \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts till partnerappen offentliga katalogsökväg \public\webfonts.
Ange resurser för Adventure Works-tema
Nästa steg är då att uppdatera den standardresurs som behövs för ämnet. För att slutföra detta steg kopierar du innehållet från den globala.json-filen under \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules till partnerappen global.json file under \src\resources\modules. Om målkatalogen \src\resources målkatalogen finns inte, den kan kopieras i sin helhet från \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks källkatalog till målkatalogen \src.
Hämta uppdateringar och validera ämnet
För information om hur du hämtar de senaste SDK, modulbiblioteket och andra beroendeuppdateringar, se avsnittet "Dra uppdateringar" iSDK och uppdatering av modulbibliotek.
När de senaste beroendena har dragits av kan du köra kommandot yarn start för att starta nodservern i din utvecklingsmiljö och testa det nya Adventure Works-temat. Bläddra lokalt i programmet genom att använda frågesträngsparametern ?theme=adventureworks (till exempel https://localhost:4000/?theme=adventureworks).