Tutorial: Copiar um ambiente Lifecycle Services para um ambiente unificado

Artigo
10/16/2024

As aplicações de finanças e operações foram reinventadas como uma aplicação hospedada pelo Microsoft Dataverse. Uma função comum para administradores de aplicações de finanças e operações é copiar ambientes. Historicamente, isso era feito no Microsoft Dynamics Lifecycle Services, mas agora tudo pode ser gerenciado no Power Platform centro de administração.

Neste tutorial, saiba como:

Preparar o ambiente de origem
Copiar o ambiente para o destino

Como exemplo deste cenário, um cliente que opere atualmente os ambientes de aplicações de finanças e operações através do site do Lifecycle Services gostaria de copiar os dados do ambiente de produção para o novo ambiente de programação unificado no centro de administração do Power Platform.

Antes de começar

O ambiente de destino neste tutorial é sempre um ambiente unificado que contém aplicações de finanças e operações hospedadas pelo Microsoft Dataverse. Para saber como implementar um destes ambientes, consulte Tutorial: Aprovisionar um novo ambiente com um modelo baseado em ERP.

O ambiente de origem neste tutorial é sempre um ambiente de aplicações de finanças e operações no Lifecycle Services que foi configurado através da integração do Power Platform.

Certifique-se de que os ambientes de origem e de destino estão aprovisionados na mesma região. Para obter informações gerais sobre a cópia de ambientes, consulte Copiar um ambiente.

Preparar o ambiente de origem

Antes que o ambiente de origem possa ser copiado, você deve executar várias etapas para garantir que os dados e o código sejam copiados corretamente para o ambiente de destino. Se você não executar essas etapas, pode ocorrer perda de código ou de dados.

Instalar ou atualizar a mais recente aplicação Ferramentas da Plataforma do Dynamics 365 Finance and Operations

Nota

Esta aplicação é necessária no ambiente de origem, porque ajuda a armazenar o código X++ no Microsoft Dataverse. Isto permite que o código seja copiado para o ambiente de destino juntamente com os dados. Sem isto, poderá ocorrer a perda de dados.

No centro de administração do Power Platform, selecione Ambientes.
Selecione o ambiente de origem a partir do qual pretende começar a copiar. A partir do menu Recursos, selecione Aplicações Dynamics 365.

Veja aplicações Dynamics 365 a partir do menu Recursos.

Deverá ver as Ferramentas da Plataforma do Dynamics 365 Finance and Operations na lista de aplicações disponíveis.

Se vir Atualização Disponível no Estado para as Ferramentas da Plataforma do Dynamics 365 Finance and Operations, selecione a ligação, aceite os termos e selecione Atualizar.

As ferramentas da plataforma do Dynamics 365 Finance and Operations mostram o estado Atualização disponível.

Se Dynamics 365 Ferramentas da Plataforma do Finance and Operations não estiver listado, selecione Instalar aplicativo para adicionar este aplicativo à sua organização.

Na lista do lado direito, encontre e selecione a aplicação Ferramentas da Plataforma do Dynamics 365 Finance and Operations, selecione Instalar e siga as instruções para instalar.

Menu Instalar aplicações do Dynamics 365.

Converter pacotes de aplicações de finanças e operações para o novo formato de pacote unificado

Este passo é utilizado para converter o Pacote implementável de software existente, normalmente utilizado pelo Lifecycle Services, num novo formato de pacote de implementação unificado. O formato do pacote é alterado para se alinhar com outras aplicações Dynamics 365 hospedadas pelo Microsoft Dataverse.

Execute o seguinte comando utilizando ModelUtil.exe a partir do Windows PowerShell. Pode encontrar o .exe em PackagesLocalDirectoryDev/bin.

.\ModelUtil.exe -convertToUnifiedPackage -file=<PathToYourPackage>.zip -outputpath=<OutputPath>

Carregar o pacote implementável unificado para o ambiente de origem

Este comando de implementação não efetua quaisquer alterações ao ambiente de finanças e operações hospedado no Lifecycle Services, nem requer tempo de inatividade a aplicar a este pacote no ambiente de operações ou no ambiente do Dataverse. Isto é feito para carregar e guardar as personalizações no armazenamento do Dataverse, para que possam ser copiadas.

Instale o PAC CLI.
Autentique-se e conecte-se à fonte Dataverse.

Execute o seguinte comando:

pac auth list
pac auth select --index 1
pac package deploy --logConsole --package <OutputPath>\<Package>.dll

Power Platform Centro de administração
PowerShell

Iniciar a operação de cópia

No centro de administração do Power Platform, aceda ao ambiente de origem que pretende copiar. A partir daí, selecione o botão Copiar no painel de ação superior. Na janela deslizante exibida, escolha copiar Tudo, que incorpora o Dataverse código-fonte X++ e os dados da fonte. Selecione o ambiente de Destino para ser o ambiente de programação unificado.

Copiar através do PowerShell

Carregue a consola do PowerShell e execute os seguintes comandos para copiar o ambiente. Para obter mais informações sobre como instalar e utilizar o módulo do PowerShell, consulte Introdução ao PowerShell para Administradores do Power Platform.

#Install the module
Install-Module -Name Microsoft.PowerApps.Administration.PowerShell

# Set variables for your session
$TenantId = "YOUR_TENANT_GUID_FROM_Microsoft Entra ID"
$SPNId = "YOUR_AZURE_APPLICATION_REGISTRATION_CLIENT_ID"
$ClientSecret = "YOUR_AZURE_APPLICATION_CLIENT_SECRET"
$SourceEnvironmentID = "YOUR_SOURCE_ENVIRONMENT_ID_HERE"
$TargetEnvironmentID = "YOUR_TARGET_ENVIRONMENT_ID_HERE"

Write-Host "Creating a session against the Power Platform API"

Add-PowerAppsAccount -Endpoint prod -TenantID $TenantId -ApplicationId $SPNId -ClientSecret $ClientSecret

    $copyToRequest = \[pscustomobject\]@{
        SourceEnvironmentId = $SourceEnvironmentID
        TargetEnvironmentName = "Copied from source"
        CopyType = "FullCopy"
        SkipAuditData: true
    }

Copy-PowerAppEnvironment -EnvironmentName $TargetEnvironmentID -CopyToRequestDefinition $copyToRequest

Partilhar via