Instalar o tema Adventure Works
Isto artigo descreve como implementar o tema Adventure Works em Microsoft Dynamics 365 Commerce.
Importante
O tema e os módulos da Adventure Works estão disponíveis a Dynamics 365 Commerce partir da versão 10.0.20. Estão disponíveis em Microsoft AppSource.
Pré-requisitos
Antes de implementar o tema Adventure Works, você deve ter um Dynamics 365 Commerce ambiente (Commerce versão 10.0.20 ou posterior) que inclua Retail Cloud Scale Unit (RCSU), o Commerce online software development kit (SDK) e o Commerce biblioteca de módulos. Para obter informações sobre como implementar o Commerce SDK e o biblioteca de módulos, consulte Configurar um ambiente de desenvolvimento .
Etapas de instalação
Instale o tema Adventure Works em seu aplicativo
O pacote temático Adventure Works está disponível no feed dynamics365-commerce , como @msdyn365-commerce-theme/adventureworks-theme-kit. No entanto, embora o pacote de temas da Adventure Works faça parte desse feed, ele está sob um namespace diferente. Portanto, você deve seguir estas etapas para adicionar entradas do Registro para o namespace.
Atualize o ficheiro .npmrc para que ele inclua a seguinte entrada do Registro (se a entrada ainda não estiver incluída):
@msdyn365-commerce-theme:registry=https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/Atualize o ficheiro .yarnrc para que ele inclua a seguinte entrada do Registro (se a entrada ainda não estiver incluída):
"@msdyn365-commerce-theme:registry" "https://pkgs.dev.azure.com/commerce-partner/Registry/_packaging/dynamics365-commerce/npm/registry/"
Para implementar o pacote em seu ambiente local, execute o yarn add THEME_PACKAGE@VERSION comando no prompt de comando, onde THEME_PACKAGE é o pacote de tema (@msdyn365-commerce-theme/adventureworks-theme-kit) e VERSION é o número de versão do biblioteca de módulos que está a ser utilizado. É importante que as versões do pacote temático e do biblioteca de módulos combinem. Para encontrar o número de versão biblioteca de módulos correto a ser utilizado, abra o ficheiro package.json e localize o valor do pacote inicial na secção dependências . No exemplo a seguir, o ficheiro package.json usa a versão 9.32 do biblioteca de módulos que mapeia para a Dynamics 365 Commerce versão 10.0.22.
"dependencies": {
"@msdyn365-commerce-modules/starter-pack": "9.32",
}
O exemplo a seguir mostra como executar o comando para adicionar a yarn add versão 9.32 do tema Adventure Works. O comando atualiza automaticamente o ficheiro package.json para que ele inclua a dependência.
yarn add @msdyn365-commerce-theme/adventureworks-theme-kit@9.32
Para obter mais informações sobre como atualizar a versão biblioteca de módulos, consulte SDK e atualizações biblioteca de módulos.
Importante
- A versão do tema deve corresponder à versão biblioteca de módulos para garantir que todos os recursos funcionem conforme o esperado.
- A versão mínima para o Commerce biblioteca de módulos e SDK deve ser 10.0.20 (9.31).
Adicionar os ficheiros de fonte para o tema Adventure Works
Depois que o tema Adventure Works for instalado em seu aplicativo, você deverá adicionar os ficheiros de fonte necessários para ele. Para concluir esse passo, copie todos os ficheiros de fonte do ode_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts \npara o caminho do diretório público do aplicativo parceiro\public\webfonts.
Configurar os recursos para o tema Adventure Works
A próxima passo é atualizar o recurso padrão necessário para o tema. Para concluir esta passo, copie o conteúdo do ficheiro global.json em \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\resources\modules para o ficheiro de global.json do aplicativo parceiro em \src\resources\modules. Se o \src\rdiretório de destino esources não existir, ele pode ser copiado em sua totalidade do \ndiretório de origem ode_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks para o \src diretório de destino.
Pull atualizações e validar o tema
Para obter informações sobre como obter o SDK mais recente, biblioteca de módulos e outras atualizações de dependência, consulte a secção "Pull updates" de SDK e atualizações biblioteca de módulos.
Depois que as dependências mais recentes forem removidas, você poderá executar o comando yarn start para iniciar o servidor Node em seu ambiente de desenvolvimento e testar o novo tema do Adventure Works. Navegue pelo aplicativo localmente usando o parâmetro ?theme=adventureworks query string(por exemplo, https://localhost:4000/?theme=adventureworks).