Carregar configurações de ER e Funcionalidades de globalização como uma solução de Dataverse

Artigo
04/03/2024

Importante

O Regulatory Configuration Service (RCS) será preterido. Todo o novo aprovisionamento do RCS é interrompido a partir da Disponibilidade Geral 10.0.39. Se o aprovisionamento for necessário, registe um pedido de suporte. Forneceremos as ferramentas e o suporte necessários para a migração do RCS para a área de trabalho do Globalization Studio. Planeamos encerrar totalmente o RCS até 1 de agosto de 2024. Para mais informações sobre a migração para a área de trabalho do Globalization Studio, consulte União do Regulatory Configuration Service para a área de trabalho do Globalization Studio

Pode utilizar as soluções do Microsoft Dataverse para cenários da Gestão do Ciclo de Vida das Aplicações (ALM). Por exemplo, pode mover configurações de Relatórios eletrónicos (ER) para outros ambientes ou partilhá-las com outros inquilinos através da AppSource.

Também pode exportar e importar versões específicas, como um ficheiro, utilizando os botões Exportar e Importar na página (funcionalidade existente).

Pré-requisitos

Instale o PowerShell 7. Para mais informações, consulte Instalar o PowerShell no Windows.
Instale o Microsoft Power Platform CLI. Para mais informações, consulte O que é o Microsoft Power Platform CLI?
Obtenha o script Generate-GlobalizationDataverseSolution.ps1 da Biblioteca de ativos partilhados no Microsoft Dynamics Lifecycle Services (<<Tipo de ativo:, Nome do ativo:>>).

Passo 1: Exportar os seus artefactos

Para exportar os seus artefactos, siga estes passos.

Crie uma pasta, como C:\DvArtifactsSrc.
Exporte os ficheiros .xml de quaisquer configurações de ER e os ficheiros .json de caraterísticas do Globalization para a nova pasta.

Importante

Não inclua configurações da Microsoft.

Passo 2: Criar uma solução do Dataverse

Para criar uma solução do Dataverse, siga estes passos.

Crie uma solução no Dataverse e exporte-a. Para mais informações, consulte Criar uma solução e Exportar soluções.
Extraia a nova solução utilizando o comando pac solution unpack. Veja aqui um exemplo.
```
pac solution unpack --zipfile C:\SampleEmptySolution.zip --folder C:\SampleSolutionUnpacked
```
Para mais informações, consulte pac solution unpack.

Passo 3: Executar o script

Execute o script Generate-GlobalizationDataverseSolution.ps1 no PowerShell 7. Especifique os seguintes parâmetros:
- DvArtifactsSrcFolder — Especifica a pasta de trabalho.
- SolutionFolder — Especifique a pasta da solução.
- ConfigurationsIndexRowName — Especifique o nome do registo da tabela do Dataverse que tem o ficheiro de índice para as configurações. Utilize apenas carateres alfanuméricos e espaços. Tenha em atenção que se alterar o nome mais tarde, a linha correspondente na tabela do Dataverse terá um identificador exclusivo global (GUID) diferente e os ficheiros de índice serão duplicados. Se não tiver quaisquer configurações de ER, pode omitir este parâmetro. Veja aqui um exemplo.
```
Contoso Electronic Reporting Configurations Index
```
- FeaturesIndexRowName — Especifique o nome do registo da tabela do Dataverse que tem o ficheiro de índice para as caraterísticas. Utilize apenas carateres alfanuméricos e espaços. Tenha em atenção que se alterar o nome mais tarde, a linha correspondente na tabela do Dataverse terá um GUID diferente e os ficheiros de índice serão duplicados. Se não tiver quaisquer caraterísticas do Globalization, pode omitir este parâmetro. Veja aqui um exemplo.
```
Contoso Globalization Features Index
```
Eis um exemplo da linha de comandos completa do PowerShell 7.
```
pwsh -ExecutionPolicy RemoteSigned -File C:\Generate-GlobalizationDataverseSolution.ps1 -DvArtifactsSrcFolder C:\DvArtifactsSrc -SolutionFolder C:\SampleSolutionUnpacked -configurationsIndexRowName "Contoso Electronic Reporting Configurations Index" -featuresIndexRowName "Contoso Globalization Features Index"
```

Passo 4: Empacotar a solução

Empacote a nova solução utilizando o comando pac solution unpack. Veja aqui um exemplo.
```
pac solution pack --zipfile C:\SampleSolutionWithContents.zip --folder C:\SampleSolutionUnpacked --packagetype Both
```
Para mais informações, consulte pac solution unpack.

Nota

Verifique o tamanho do ficheiro .zip que é gerado. Se exceder 90 megabytes (MB), tem de dividir os seus ficheiros de origem em várias soluções do Dataverse.

Passo 5: Importar a solução para o Dataverse

Importar a solução de volta para o Dataverse. Para mais informações, consulte Importar soluções.

Também pode utilizar o comando pac solution import.

Nota

Depois de importar a solução para o Dataverse, não há forma de a remover juntamente com o conteúdo. Embora possa remover a solução, todos os registos de tabela inseridos permanecem e têm de ser limpos manualmente.
Publique a sua aplicação na AppSource. Para mais informações, consulte Publicar a sua aplicação na AppSource.

Partilhar via