Installare il tema Adventure Works
Questo articolo descrive come installare il tema Adventure Works in Microsoft Dynamics 365 Commerce.
Importante
Il tema Adventure Works e i moduli sono disponibili a partire dalla versione 10.0.20 di Dynamics 365 Commerce. Sono disponibili da Microsoft AppSource.
Prerequisiti
Prima di installare il tema Adventure Works, devi avere un ambiente Dynamics 365 Commerce (versione Commerce 10.0.20 o successiva) che include Retail Cloud Scale Unit (RCSU), l'SDK di Commerce online e la libreria dei moduli Commerce. Per informazioni su come installare l'SDK di Commerce e la libreria dei moduli, vedi Impostare un ambiente di sviluppo.
Passaggi di installazione
Installare il tema Adventure Works nell'applicazione
Il pacchetto di temi Adventure Works è disponibile nel feed dynamics365-commerce, come @msdyn365-commerce-theme/adventureworks-theme-kit. Tuttavia, anche se il pacchetto del tema Adventure Works fa parte di quel feed, si trova in uno spazio dei nomi diverso. Pertanto, è necessario seguire questi passaggi per aggiungere le voci del Registro di sistema per lo spazio dei nomi.
Aggiorna il file .npmrc in modo che includa la seguente voce del Registro di sistema (se la voce non è già inclusa):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Aggiorna il file .yarnrc in modo che includa la seguente voce del Registro di sistema (se la voce non è già inclusa):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Per installare il pacchetto nel tuo ambiente locale, esegui il comando yarn add THEME_PACKAGE@VERSION dal prompt dei comandi, dove THEME_PACKAGE è il pacchetto del tema (@msdyn365-commerce-theme/adventureworks-theme-kit) e VERSION è il numero di versione della libreria del modulo in uso. È importante che le versioni del pacchetto del tema e della libreria del modulo corrispondano. Per trovare il numero di versione della libreria del modulo corretto da utilizzare, apri il file package.json e individua il valore starter-pack sotto la sezione dipendenze. Nell'esempio seguente, il file package.json utilizza la versione 9.32 della libreria di moduli che mappa alla versione Dynamics 365 Commerce 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
L'esempio seguente mostra come eseguire il comando yarn add per aggiungere la versione 9.32 del tema Adventure Works. Il comando aggiorna automaticamente il file package.json in modo che includa la dipendenza.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Per altre informazioni su come aggiornare la versione della libreria dei moduli vedi SDK e aggiornamenti della libreria moduli.
Importante
- La versione del tema deve corrispondere alla versione della libreria dei moduli per garantire che tutte le funzionalità funzionino come previsto.
- La versione minima per la libreria dei moduli Commerce e l'SDK è 10.0.20 (9.31).
Aggiungere i file dei caratteri per il tema Adventure Works
Dopo aver installato il tema Adventure Works nella tua app, devi aggiungere i file di caratteri necessari. Per completare questo passaggio, copia tutti i file dei caratteri da \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts al percorso della directory pubblica dell'applicazione partner \public\webfonts.
Impostare le risorse per il tema Adventure Works
Il passaggio successivo consiste nell'aggiornare la risorsa predefinita richiesta per il tema. Per completare questo passaggio, copia il contenuto dal file global.json in \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules nel file global.json dell'applicazione partner in \src\resources\modules. Se la directory di destinazione \src\resources non esiste, può essere copiata nella sua interezza dalla directory di origine \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks nella directory di destinazione \src.
Eseguire il pull degli aggiornamenti e convalidare il tema
Per informazioni su come eseguire il pull dell'SDK più recente, della libreria di moduli e di altri aggiornamenti delle dipendenze, vedi la sezione "Pull degli aggiornamenti" di Aggiornamenti dell'SDK e della libreria dei moduli.
Dopo che le ultime dipendenze sono state sottoposte al pull, puoi eseguire il comando yarn start per avviare il server Nodo nel tuo ambiente di sviluppo e testare il nuovo tema Adventure Works. Sfoglia l'applicazione localmente utilizzando il parametro della stringa di query ?theme=adventureworks (ad esempio, https://localhost:4000/?theme=adventureworks).