Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Observação
O Grupo de Interesse de Varejo do Dynamics 365 Commerce mudou do Yammer para o Viva Engage. Se você não tiver acesso à nova comunidade Viva Engage, preencha este formulário (https://aka.ms/JoinD365commerceVivaEngageCommunity) para ser adicionado e mantenha-se envolvido nas últimas discussões.
Este artigo descreve como instalar o tema Adventure Works no Microsoft Dynamics 365 Commerce.
Importante
O tema Adventure Works e os módulos estão disponíveis no Dynamics 365 Commerce a partir da versão 10.0.20. Estão disponíveis a partir do Microsoft AppSource.
Pré-requisitos
Antes de instalar o tema Adventure Works, deve-se ter um ambiente Dynamics 365 Commerce (Commerce versão 10.0.20 ou posterior) que inclua Retail Cloud Scale Unit (RCSU), o kit de desenvolvimento de software (SDK) online do Commerce e a biblioteca de módulos do Commerce. Para obter informações sobre como instalar o Commerce SDK e a biblioteca de módulos, consulte Configurar um ambiente de desenvolvimento.
Passos de instalação
Instale o tema Adventure Works na sua aplicação
O pacote de temas 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, está sob um espaço de nomes diferente. Portanto, deve seguir estes passos para adicionar entradas do registo para o espaço de nomes.
Atualize o ficheiro .npmrc para que inclua a seguinte entrada do registo (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 inclua a seguinte entrada do registo (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 instalar o pacote no seu ambiente local, execute o comando yarn add THEME_PACKAGE@VERSION na linha de comandos, em que THEME_PACKAGE é o pacote de temas (@msdyn365-commerce-theme/adventureworks-theme-kit) e VERSION é o número de versão da biblioteca de módulos que está a ser usada. É importante que as versões do pacote de temas e da biblioteca de módulos correspondam. Para encontrar o número de versão correto da biblioteca de módulos a ser utilizado, abra o ficheiro package.json e localize o valor do starter-pack em dependências. No exemplo a seguir, o ficheiro package.json usa a versão 9.32 da biblioteca de módulos que mapeia para o 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 yarn add para adicionar a versão 9.32 do tema Adventure Works. O comando atualiza automaticamente o ficheiro package.json para que 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 da biblioteca de módulos, consulte Atualizações da biblioteca de SDK e módulos.
Importante
- A versão do tema deve corresponder à versão da biblioteca de módulos para garantir que todas as funcionalidades funcionem conforme o esperado.
- A versão mínima para a biblioteca de módulos do Commerce e SDK deve ser 10.0.20 (9.31).
Adicionar os ficheiros de tipo de letra para o tema Adventure Works
Depois de o tema Adventure Works ser instalado na sua aplicação, deverá adicionar os ficheiros de tipo de letra necessários para este. Para concluir esse passo, copie todos os ficheiros de tipo de letra de \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks\public\webfonts para o diretório público da aplicação parceira \public\webfonts.
Configurar os recursos para o tema Adventure Works
O próximo passo é atualizar o recurso predefinido necessário para o tema. Para concluir este 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 global.json da aplicação parceira em \src\resources\modules. Se o diretório de destino \src\resources não existir, pode ser copiado na sua totalidade do diretório de origem \node_modules@msdyn365-commerce-theme\adventureworks-theme-kit\src\modules\adventureworks para o diretório de destino \src.
Obter atualizações e validar o tema
Para obter informações sobre como obter o SDK mais recente, a biblioteca de módulos e outras atualizações de dependência, consulte a secção "Obter atualizações" de Atualizações da biblioteca de SDK e módulos.
Depois de as dependências mais recentes serem obtidas, poderá executar o comando yarn start para iniciar o servidor Node no seu ambiente de desenvolvimento e testar o novo tema do Adventure Works. Navegue pela aplicação localmente usando o parâmetro da cadeia de consulta ?theme=adventureworks (por exemplo, https://localhost:4000/?theme=adventureworks).