Nota
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare ad accedere o a cambiare directory.
L'accesso a questa pagina richiede l'autorizzazione. Puoi provare a cambiare directory.
Annotazioni
Il gruppo retail interest di Dynamics 365 Commerce è passato da Yammer a Viva Engage. Se non si ha accesso alla nuova community viva engage, compilare questo modulo (https://aka.ms/JoinD365commerceVivaEngageCommunity) per essere aggiunto e rimanere impegnati nelle discussioni più recenti.
Questo articolo descrive come installare il tema Adventure Works in Microsoft Dynamics 365 Commerce.
Importante
Il tema e i moduli di Adventure Works sono disponibili a partire dalla versione 10.0.20 di Dynamics 365 Commerce. È possibile ottenerli da Microsoft Marketplace.
Prerequisiti
Prima di installare il tema Adventure Works, assicurarsi di avere un ambiente Dynamics 365 Commerce (Commerce versione 10.0.20 o successiva) che include Retail Cloud Scale Unit (RCSU), commerce online software development kit (SDK) e la libreria di moduli Commerce. Per informazioni su come installare Commerce SDK e la libreria di moduli, vedere Configurare un ambiente di sviluppo.
Passaggi di installazione
Installare il tema Adventure Works nell'applicazione
Il feed dynamics365-commerce offre il pacchetto del tema Adventure Works come @msdyn365-commerce-theme/adventureworks-theme-kit. Tuttavia, il pacchetto usa uno spazio dei nomi diverso. Pertanto, è necessario aggiungere voci del Registro di sistema per lo spazio dei nomi.
Aggiornare il file con estensione npmrc in modo da includere la voce del Registro di sistema seguente (se la voce non è già inclusa):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Aggiornare il file yarnrc in modo da includere la voce del Registro di sistema seguente (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 nell'ambiente locale, eseguire il yarn add THEME_PACKAGE@VERSION comando dal prompt dei comandi. Sostituire THEME_PACKAGE con il nome del pacchetto del tema (@msdyn365-commerce-theme/adventureworks-theme-kit) e VERSION con il numero di versione della libreria di moduli in uso. Assicurarsi che le versioni del pacchetto del tema e della libreria di moduli corrispondano. Per trovare il numero di versione corretto della libreria dei moduli, aprire il file package.json e individuare il valore starter-pack nella sezione dependencies . Nell'esempio seguente il file package.json usa la versione 9.32 della libreria di moduli, che esegue il mapping alla versione 10.0.22 di Dynamics 365 Commerce.
"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 nell'app, aggiungere i file di tipo di carattere 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
Aggiornare la risorsa predefinita per il tema. Per completare questo passaggio, copiare il contenuto del file global.json dal percorso \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules nel file global.json dell'applicazione partner nel percorso \src\resources\modules. Se la directory di destinazione \src\resources non esiste, è possibile copiarla interamente dalla directory di origine \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks alla 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 aver eseguito il pull delle dipendenze più recenti, eseguire il comando yarn start per avviare il server Node nell'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).