Jagamisviis:


Adventure Worksi kujunduse installimine

See teema kirjeldab, kuidas installida Adventure Worksi kujundust rakenduses Microsoft Dynamics 365 Commerce.

Oluline

Adventure Works teema ja moodulid on saadaval alates Dynamics 365 Commerce väljalaske versioonist 10.0.20. Need on saadaval rakendusest Microsoft AppSource.

Eeltingimused

Enne Adventure Worksi kujunduse installimist peab teil olema Dynamics 365 Commerce keskkond (Commerce version 10.0.20 või uuem), mis sisaldab Retail Cloud Scale Unit (RCSU), Commerce online tarkvara arenduskomplekti (SDK) ja Commerce mooduli teeki. Lisateavet Commerce SDK ja moodulteegi installimise kohta vt SDK- ja mooduliteegi uuendused.

Installimisetapid

Installi oma rakendusse Adventure Worksi teema

Adventure Worksi teemapakett on saadaval feedis dynamics365-commerce kui @msdyn365-commerce-theme/adventureworks-theme-kit. Kuigi teemapakett Adventure Works on selle voo osa, on see erineva nimeruumi all. Seetõttu peate nimeruumi registrikirjete lisamiseks järgima neid samme.

  1. Värskendage .npmrc faili, et see sisaldaks järgmist registrikirjet (kui kirjet juba ei kaasata):

    @msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/

  2. Värskendage .yarnrc faili, et see sisaldaks järgmist registrikirjet (kui kirjet juba ei kaasata):

    "@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"

Paketi installimiseks kohalikku keskkonda käivitage käsurealt käsk yarn add THEME_PACKAGE@VERSION, kus THEME_PACKAGE on teemapakett (@msdyn365-commerce- theme/adventureworks-theme-kit) ja VERSION on kasutatava mooduliteegi versiooninumber. On oluline, et teemapaketi ja mooduliteegi versioonid ühtiksid. Kasutatava õige mooduliteegi versiooninumbri leidmiseks avage fail package.json ja leidke jaotise stardipakett väärtuste alt Sõltuvusedjagu. Järgmises näites kasutab fail package.json mooduliteegi versiooni 9.32, mis vastab versioonile Dynamics 365 Commerce 10.0.22.

"dependencies": {
    "@msdyn365-commerce-modules/starter-pack": "9.32",
}

Järgmine näide näitab, kuidas käivitada käsk yarn add Adventure Worksi teema versiooni 9.32 lisamiseks. See käsk uuendab faili package.json automaatselt nii, et see sisaldaks sõltuvust.

yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32

Faili appsettings.json värskendamise juhised leiate teemast SDK ja mooduliteegi värskendused.

Oluline

  • Kujunduse versioon peab vastama moodulteegi versioonile, et tagada kõigi funktsioonide eeldatav töö.
  • Commerce mooduli teek ja SDK minimaalse versiooni peab olema 10.0.20 (9.31).

Fondifailide lisamine Adventure Worksi kujundusele

Kui Adventure Worksi teema on teie rakendusse installitud, peate lisama sellele vajalikud fondifailid. Selle sammu lõpuleviimiseks kopeerige kõik fondifailid asukohast \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts partnerrakenduse avalikku asukohta \public\webfonts.

Seadistage Adventure Works teema ressursid

Järgmiseks sammuks on kujunduse jaoks nõutava vaikeressursi värskendamine. Selle sammu lõpuleviimiseks kopeerige sisu failist global.json asukohas \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules partnerrakenduse global.json faili asukohas \src\resources\modules. Kui \src\resources sihtkataloogi ei ole olemas, saab selle kopeerida tervikuna lähtekaustast \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks sihtkataloogi \src.

Tõmba värskendused ja kinnita kujundus

Lisateavet viimase SDK, mooduliteegi ja muude sõltuvuste värskenduste tõmbamise kohta vt SDK ja moodulteegi värskendused jaotisest "Tõmba värskendused".

Kui viimased sõltuvused on alla tõmmatud, saate käivitada käivituskäsku yarn start, et käivitada Node serveri oma arenduskeskkonnas ja katsetada uut Adventure Worksi kujundust. Sirvige rakendust kohalikult, kasutades päringustringi ?theme=adventureworks parameetrit (nt https://localhost:4000/?theme=adventureworks).

Lisaressursid

Adventure Works teema

Mooduliteegi ülevaade

SDK ja mooduliteegi uuendused