Delen via


Het Adventure Works-thema installeren

In dit artikel wordt beschreven hoe u het Adventure Works-thema installeert in Microsoft Dynamics 365 Commerce.

Belangrijk

Het Adventure Works-thema en modules zijn beschikbaar vanaf Dynamics 365 Commerce versie 10.0.20. Zij zijn beschikbaar vanuit Microsoft AppSource.

Vereisten

Voordat u het Adventure Works-thema installeert, moet u een Dynamics 365 Commerce-omgeving (Commerce versie 10.0.20 of hoger) hebben waarin Retail Cloud Scale Unit (RCSU), de Commerce online Software Development Kit (SDK) en de Commerce-modulebibliotheek zijn. Zie Een ontwikkelomgeving instellen voor informatie over het installeren van de Commerce SDK en de modulebibliotheek.

Installatiestappen

Het Adventure Works-thema in uw toepassing installeren

Het pakket van het Adventure Works-thema is beschikbaar in de feed dynamics365-commerce als @msdyn365-commerce-thema/adventuredynamic-thema-kit. Hoewel het pakket van het Adventure Works-thema deel uitmaakt van die feed, valt het onder een andere naamruimte. Daarom moet u deze stappen volgen om registervermeldingen voor de naamruimte toe te voegen.

  1. Werk het .npmrc-bestand bij zodat het de volgende registervermelding bevat (als de vermelding nog niet is opgenomen):

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

  2. Werk het .yarnrc-bestand bij zodat het de volgende registervermelding bevat (als de vermelding nog niet is opgenomen):

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

Als u het pakket in uw lokale omgeving wilt installeren, moet u de opdracht yarn add THEME_PACKAGE@VERSION uitvoeren via de opdrachtprompt, waarbij THEME_PACKAGE het themapakket (@msdyn365-commerce-theme/adventureworks-theme-kit) is en VERSION het versienummer van de modulebibliotheek die wordt gebruikt. Het is belangrijk dat de versies van het themapakket en de modulebibliotheek overeenkomen. U vindt het juiste versienummer van de modulebibliotheek die u wilt gebruiken door het package.json-bestand te openen en te zoeken naar de waarde van starter-pack onder de sectie dependencies. In het volgende voorbeeld gebruikt het package.json-bestand versie 9.32 van de modulebibliotheek die wordt toegewezen aan Dynamics 365 Commerce-versie 10.0.22.

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

In het volgende voorbeeld ziet u hoe u de opdracht yarn add kunt uitvoeren om versie 9.32 van het Adventure Works-thema toe te voegen. Met deze opdracht wordt het bestand package.json automatisch bijgewerkt zodat het de afhankelijkheid bevat.

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

Zie Updates voor SDK's en modulebibliotheken voor meer informatie over het bijwerken van de modulebibliotheekversie.

Belangrijk

  • De themaversie moet overeenkomen met de versie van de modulebibliotheek om ervoor te zorgen dat alle functies werken zoals verwacht.
  • De minimumversie voor de Commerce-modulebibliotheek en SDK moet beschikbaar zijn 10.0.20 (9.31).

De lettertypetekenbestanden voor het Adventure Works-thema toevoegen

Nadat het Adventure Works-thema in uw app is geïnstalleerd, moet u de vereiste lettertypebestanden voor de app toevoegen. Om deze stap te voltooien, kopieert u alle lettertypebestanden van \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts naar het pad van de openbare directory van de partnertoepassing \public\webfonts.

De resources voor het Adventure Works-thema instellen

De volgende stap is het bijwerken van de vereiste standaardresource voor het thema. Om deze stap te voltooien, kopieert u de inhoud van het bestand global.json onder \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules naar het bestand global.json van de partnertoepassing onder \src\resources\modules. Als de doeldirectory \src\resources niet bestaat, kan deze in zijn geheel worden gekopieerd van de brondirectory \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks naar de doeldirectory \src.

Updates ophalen en het thema valideren

Zie de sectie 'Updates ophalen' van Updates voor SDK's en modulebibliotheken voor informatie over het ontvangen van de nieuwste updates van SDK, modulebibliotheek en andere afhankelijkheden.

Nadat de laatste afhankelijkheden zijn gedefinieerd, kunt u de opdracht yarn start uitvoeren om de knooppuntserver te starten in uw ontwikkelomgeving en het nieuwe Adventure Works-thema te testen. Blader lokaal door de toepassing met behulp van de queryreeksparameter ?theme=adventureworks (bijvoorbeeld https://localhost:4000/?theme=adventureworks).

Aanvullende bronnen

Adventure Works-thema

Overzicht van modulebibliotheek

Updates voor SDK's en modulebibliotheken