Installere Adventure Works-temaet
Denne artikel beskriver, hvordan du installerer Adventure Works-temaet i Microsoft Dynamics 365 Commerce.
Vigtig
Adventure Works-temaet og -modulerne er tilgængelige fra og med Dynamics 365 Commerce version 10.0.20. De er tilgængelige fra Microsoft AppSource.
Forudsætninger
Før du installerer Adventure Works-temaet, skal du have et Dynamics 365 Commerce-miljø (Commerce version 10.0.20 eller senere), der omfatter Retail Cloud Scale Unit (RCSU), online Commerce-softwareudviklingssæt (SDK) og Commerce-modulbiblioteket. Du kan finde oplysninger om installation af Commerce SDK og modulbiblioteket i Konfigurere et udviklingsmiljø.
Installationstrin
Installere Adventure Works-temaet i programmet
Adventure Works-temapakken er tilgængelig i feedet for dynamics365-commerce som @msdyn365-commerce-theme/adventureworks-theme-kit. Selvom Adventure Works-temapakken er en del af dette feed, er den placeret under et andet navneområde. Derfor skal du følge disse trin for at tilføje registreringsdatabaseposter for navneområdet.
Opdater filen .npmrc, så den indeholder følgende registreringsdatabasepost (hvis posten ikke allerede er inkluderet):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Opdater filen .yarnrc, så den indeholder følgende registreringsdatabasepost (hvis posten ikke allerede er inkluderet):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Hvis du vil installere pakken i dit lokale miljø, skal du køre kommandoen yarn add THEME_PACKAGE@VERSION fra kommandoprompten, hvor THEME_PACKAGE er temapakken (@msdyn365-commerce-theme/adventureworks-theme-kit) og VERSION er versionsnummeret på det modulbibliotek, der bruges. Det er vigtigt, at versionerne af temapakken og modulbiblioteket stemmer overens. Du kan finde det korrekte versionsnummer på det modulbibliotek, der skal bruges, ved at åbne filen package.json og finde værdien starter-pack under sektionen dependencies. I følgende eksempel bruger package.json-filen version 9.32 af modulbiblioteket, som er knyttet til Dynamics 365 Commerce version 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
I følgende eksempel vises, hvordan du kører kommandoen yarn add for at tilføje version 9.32 af Adventure Works-temaet. Kommandoen opdaterer automatisk filen package.json, så den omfatter afhængigheden.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Du kan finde flere oplysninger om opdatering versionen af modulbiblioteket under Opdateringer til SDK og modulbibliotek.
Vigtig
- Temaversionen skal passe til versionen af modulbiblioteket for at sikre, at alle funktioner fungerer som forventet.
- Minimumsversionen for Commerce-modulbiblioteket og SDK skal være 10.0.20 (9.31).
Tilføje skrifttypefiler til Adventure Works-temaet
Når Adventure Works-temaet er installeret i appen, skal du tilføje de skriftfiler, der kræves til den. For at fuldføre dette trin skal du kopiere alle skrifttypefiler fra \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts til stien for partnerprogrammets offentlige mappe \public\webfonts.
Konfigurere ressourcerne for Adventure Works-temaet
Næste trin er at opdatere den krævede standardressource for temaet. For at fuldføre dette trin skal du kopiere indholdet fra filen globale.json under \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules til partnerprogrammets fil global.json under \src\resources\modules. Hvis målmappen \src\resources ikke findes, kan den kopieres i sin helhed fra kildemappen \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks til målmappen \src.
Trække opdateringer og validere temaet
Yderligere oplysninger om, hvordan du trækker det seneste SDK, modulbiblioteket og andre opdateringer af afhængighed, finder du i afsnittet "Trække opdateringer" i Opdateringer af SDK og modulbibliotek.
Når de seneste afhængigheder er trukket ned, kan du køre kommandoen yarn start for at starte Node-serveren i udviklingsmiljøet, og teste det nye Adventure Works-tema. Gennemse programmet lokalt ved hjælp af parameteren for forespørgselsstrengen ?theme=adventureworks (f.eks. https://localhost:4000/?theme=adventureworks).