Adventure Works-Design installieren
In diesem Artikel wird beschrieben, wie Sie das Adventure Works-Design in Microsoft Dynamics 365 Commerce installieren.
Wichtig
Das Adventure Works-Design und die neuen Module stehen ab der Dynamics 365 Commerce-Version 10.0.20 zur Verfügung. Sie sind erhältlich ab Microsoft AppSource.
Voraussetzungen
Bevor Sie das Adventure Works-Design installieren, müssen Sie über eine Dynamics 365 Commerce Umgebung (Commerce Version 10.0.20 oder höher) verfügen, die Retail Cloud Scale Unit (RCSU), das Commerce Online Software Development Kit (SDK) und die Commerce-Modulbibliothek enthält. Informationen zur Installation des Commerce SDK und der Modulbibliothek finden Sie unter Entwicklungsumgebung einrichten.
Installationsschritte
Installieren Sie das Adventure Works-Design in Ihrer Anwendung
Das Adventure Works-Themenpaket steht im dynamics365-Commerce Feed als @msdyn365-commerce-theme/adventureworks-theme-Kit zur Verfügung. Obwohl das Adventure Works-Designpaket Teil dieses Feeds ist, befindet es sich jedoch unter einem anderen Namespace. Daher müssen Sie diese Schritte ausführen, um Registrierungseinträge für den Namespace hinzuzufügen.
Aktualisieren Sie die .npmrc Datei so, dass sie den folgenden Registrierungseintrag enthält (falls der Eintrag nicht bereits enthalten ist):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Aktualisieren Sie die .yarnrc Datei so, dass sie den folgenden Registrierungseintrag enthält (falls der Eintrag nicht bereits 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 Befehl yarn add THEME_PACKAGE@VERSION von der Eingabeaufforderung aus, wobei THEME_PACKAGE das Themenpaket (@msdyn365-commerce-theme/adventureworks-theme-kit) und VERSION die Versionsnummer der verwendeten Modulbibliothek ist. Es ist wichtig, dass die Versionen des Themenpakets und der Modulbibliothek übereinstimmen. Um die richtige Versionsnummer der Modulbibliothek zu finden, öffnen Sie die Datei „package.json“ und suchen Sie den Wert starter-pack im 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 das Adventure Works-Design in Ihrer App installiert wurde, müssen Sie die dafür erforderlichen Schriftartdateien hinzufügen. Um diesen Schritt abzuschließen, kopieren Sie alle Schriftartdateien von \node_modules@msdyn365-commerce-theme\adventureworks-theme-Kit\src\modules\adventureworks\public\webfonts zum öffentlichen Verzeichnispfad der Partneranwendung \öffentlich\webfonts.
Legen Sie die Ressourcen für das AdventureWorks-Design fest
Der nächste Schritt besteht darin, die erforderliche Standardressource für das Design zu aktualisieren. Um diesen Schritt abzuschließen, kopieren Sie den Inhalt aus der Datei global.json unter \node_modules@msdyn365-commerce-theme\adventureworks-theme-Kit\src\modules\adventureworks\resources\modules zur Partneranwendung global.json Datei unter \src\resources\modules. Wenn das \src\resources Zielverzeichnis nicht vorhanden ist, kann es vollständig aus dem \node_modules@msdyn365-commerce-theme\adventureworks-theme-Kit\src\modules\adventureworks Quellverzeichnis zum \src Zielverzeichnis kopiert werden.
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 die neuesten Abhängigkeiten heruntergezogen wurden, können Sie den yarn start Befehl ausfühen, um den Knoten-Server 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).