Adventure Works-Design installieren

Hinweis

Die Retail-Interessengruppe von Dynamics 365 Commerce wurde von Yammer zu Viva Engage verschoben. Wenn Sie keinen Zugriff auf die neue Viva Engage-Community haben, füllen Sie dieses Formular (https://aka.ms/JoinD365commerceVivaEngageCommunity) aus, um hinzugefügt zu werden und sich weiterhin in die neuesten Diskussionen einbringen zu können.

In diesem Artikel wird beschrieben, wie Sie das AdventureWorks-Design in Microsoft Dynamics 365 Commerce installieren.

Wichtig

Das Adventure Works-Theme und die Module sind ab Version 10.0.20 von Dynamics 365 Commerce verfügbar. Sie können sie aus dem Microsoft Marketplace beziehen.

Voraussetzungen

Stellen Sie vor der Installation des Adventure Works-Designs sicher, dass Sie über eine Dynamics 365 Commerce-Umgebung (Commerce Version 10.0.20 oder höher) verfügen, die Einzelhandels-Cloud Scale Unit (RCSU), das Commerce Online Software Development Kit (SDK) und die Commerce-Modulbibliothek enthält. Informationen zum Installieren des Commerce SDK und der Modulbibliothek finden Sie unter Einrichten einer Entwicklungsumgebung.

Installationsschritte

Installieren Sie das Adventure Works-Design in Ihrer Anwendung

Der Dynamics365-Commerce-Feed bietet das Adventure Works-Designpaket als @msdyn365-commerce-theme/adventureworks-theme-kit an. Das Paket verwendet jedoch einen anderen Namespace. Daher müssen Sie Registrierungseinträge für den Namespace hinzufügen.

  1. Aktualisieren Sie die NPMRC-Datei so, dass sie den folgenden Registrierungseintrag enthält (wenn der Eintrag noch nicht enthalten ist):

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

  2. Aktualisieren Sie die YARNRC-Datei so, dass sie den folgenden Registrierungseintrag enthält (wenn der Eintrag noch nicht enthalten ist):

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

Um das Paket in Ihrer lokalen Umgebung zu installieren, führen Sie den yarn add THEME_PACKAGE@VERSION Befehl über die Eingabeaufforderung aus. Ersetzen Sie THEME_PACKAGE durch den Namen des Designpakets (@msdyn365-commerce-theme/adventureworks-theme-kit) und VERSION durch die Versionsnummer der verwendeten Modulbibliothek. Stellen Sie sicher, dass die Versionen des Designpakets und der Modulbibliothek übereinstimmen. Um die richtige Versionsnummer der Modulbibliothek zu finden, öffnen Sie die package.json Datei, und suchen Sie den Startpaketwert unter dem Abschnitt "Abhängigkeiten" . Im folgenden Beispiel verwendet die Datei „package.json“ Version 9.32 der Modulbibliothek, die Dynamics 365 Commerce-Version 10.0.22 zugeordnet ist.

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

Das folgende Beispiel zeigt, wie Sie den Befehl yarn add zum Hinzufügen von Version 9.32 des Adventure Works-Themas ausführen. Der Befehl aktualisiert automatisch die Datei package.json, sodass sie die Abhängigkeit enthält.

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

Weitere Informationen zum Aktualisieren der Version der Modulbibliothek finden Sie unter SDK- und Modulbibliothekupdates.

Wichtig

  • Die Designversion sollte mit der Version der Modulbibliothek übereinstimmen, um sicherzustellen, dass alle Funktionen wie erwartet funktionieren.
  • Die Mindestversion für die Commerce-Modulbibliothek und das SDK sollte 10.0.20 (9.31) sein.

Fügen Sie die Schriftartdateien für das Adventure Works-Design hinzu

Nachdem Sie das Adventure Works-Design in Ihrer App installiert haben, fügen Sie die erforderlichen Schriftartdateien hinzu. Um diesen Schritt abzuschließen, kopieren Sie alle Schriftartdateien von \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts in den öffentlichen Verzeichnispfad der Partneranwendung \public\webfonts.

Legen Sie die Ressourcen für das AdventureWorks-Design fest

Aktualisieren Sie die Standardressource für das Design. Um diesen Schritt abzuschließen, kopieren Sie den Inhalt aus der global.json Datei unter \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules in die Partneranwendungsdateiglobal.json unter \src\resources\modules. Wenn das Zielverzeichnis "\src\resources " nicht vorhanden ist, können Sie es vollständig aus dem Verzeichnis "\node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks " in das Zielverzeichnis \src kopieren.

Ziehen Sie Updates und validieren Sie das Thema

Informationen zum Abrufen des neuesten SDKs, der Modulbibliothek und anderer Abhängigkeitsupdates finden Sie im Abschnitt Updates abrufen unter SDK- und Modulbibliothek-Updates.

Nachdem Sie die neuesten Abhängigkeiten abgerufen haben, führen Sie den Yarn-Startbefehl aus, um den Knotenserver in Ihrer Entwicklungsumgebung zu starten und das neue Adventure Works-Design zu testen. Durchsuchen Sie die Anwendung lokal mithilfe des Abfragezeichenfolgenparameters ?theme=adventureworks (zum Beispiel,https://localhost:4000/?theme=adventureworks).

Zusätzliche Ressourcen

AdventureWorks-Design

Informationen zur Modulbibliothek

SDK- und Modulbibliotheksupdates