Saiba como migrar recursos de um ambiente para outro com o empacotamento. Esses ambientes podem estar contidos no mesmo locatário ou em locatários diferentes.

Cenário

Um cenário comum em que você talvez queira migrar recursos é quando você tem ambientes de teste ou desenvolvimento e um ambiente de produção. Os desenvolvedores e testadores possuem amplo acesso a aplicativos em seus ambientes. Mas quando chega o momento de migrar um novo aplicativo para produção, esse ambiente possui um controle rigoroso sobre as permissões para que este seja atualizado ou alterado.

Outro cenário é quando cada cliente possui seu próprio ambiente e dados. Quando um novo cliente é adicionado, um novo ambiente será criado para eles e você deve migrar os aplicativos para o respectivo ambiente.

Quais recursos podem ser migrados por meio do empacotamento?

Quando você exporta um aplicativo, os recursos dependentes do aplicativo também serão exportados para o pacote. Inicialmente, apenas um subconjunto de todos os possíveis tipos de recursos terá suporte, conforme descrito na tabela abaixo.

Tipo de recurso Com suporte Opções de importação
Aplicativo Sim Há duas opções para importar um aplicativo para um ambiente:
  1. Criar novo – o aplicativo será criado como um novo aplicativo no ambiente em que o pacote for importado.
  2. Atualizar – o aplicativo já existe no ambiente e será atualizado quando esse pacote for importado.
Fluxo Sim Há duas opções para importar um fluxo para um ambiente:
  1. Criar novo – o fluxo será criado como um novo fluxo no ambiente em que o pacote for importado.
  2. Atualizar – o fluxo já existe no ambiente e será atualizado quando esse pacote for importado.
OBSERVAÇÃO: todos os recursos dos quais o fluxo depende também serão incluídos no pacote do aplicativo que é exportado e precisarão ser configurados quando o pacote for importado
Listas de seleção e personalizações de entidade CDS Sim Há duas opções para importar Entidades CDS ou Listas de Seleção em um ambiente:
  1. Substituir – se houver um recurso com o mesmo nome, essa importação o substituirá. Se não houver um recurso correspondente, um novo recurso será criado.
  2. Mesclar – se houver uma entidade ou uma lista de seleção com o mesmo nome, novas entradas ou novos campos serão adicionados, mas os campos ou as entradas ausentes não serão removidos.
Conectores personalizados Não Se um aplicativo depende de um conector personalizado, atualmente, não damos suporte à exportação do conector como parte do pacote.

Se você tiver um aplicativo que depende de um conector personalizado, a única opção atual será recriar manualmente ou atualizar o conector no ambiente de destino e selecionar esse conector ao importar o pacote.

Conexões Não Se um aplicativo depende de uma conexão (como uma conexão SQL com credenciais), atualmente, não damos suporte à exportação da conexão ou das credenciais como parte do pacote.

Se você tiver um aplicativo que depende de uma conexão compartilhada (como o SQL), a única opção atual será recriar essa conexão manualmente com as credenciais apropriadas no ambiente de destino e selecionar essa conexão ao importar o pacote.

Funções personalizadas CDS e conjuntos de permissões Não Atualmente, não há suporte para a exportação de funções CDS personalizadas e/ou conjuntos de permissões. Portanto, a única opção é recriar essas entidades manualmente no ambiente de destino.
Gateways Não Há suporte para gateways apenas nos ambientes padrão e ({nome do locatário} [da versão prévia]). Portanto, não há suporte para a exportação/migração.
Linhas de dados CDS Não Atualmente, não há suporte para a exportação de linhas de entidades CDS. Portanto, a única opção hoje será exportar e importar dados manualmente depois que as alterações de esquema CDS forem aplicadas em um novo ambiente.

Como fazer para obter acesso ao empacotamento para meu aplicativo?

A capacidade de exportar um aplicativo está disponível para qualquer usuário com permissão "Pode editar" para o aplicativo.

A capacidade de importar um aplicativo está disponível para qualquer usuário com permissão de "Criador de Ambiente" no ambiente de destino.

Um usuário deve ter um PowerApps plano 2 ou a licença de avaliação do PowerApps plano 2 para exportar ou importar qualquer aplicativo.

Observação: enquanto o pacote está em versão prévia, qualquer usuário com uma licença válida do PowerApps poderá experimentar empacotamento para seus aplicativos e ambientes.

Exportando um aplicativo

  1. Em http://web.powerapps.com, clique ou toque em Aplicativos, selecione as reticências do aplicativo que você deseja migrar e, em seguida, selecione Exportar (versão prévia).

    Selecionar Exportar

  2. Quando a página do pacote de exportação for aberta, insira um Nome e uma Descrição para o pacote.

    Examinar os detalhes do pacote

  3. Na seção “Examinar Conteúdo do Pacote”, opcionalmente, adicione comentários ou observações ou altere a configuração de como cada recurso individual será importado para o ambiente de destino durante a importação do pacote.

    Configurar o conteúdo do pacote

  4. Quando terminar, selecione Exportar e o arquivo de pacote começará a ser baixado em alguns segundos.

Importando um aplicativo

  1. Em http://web.powerapps.com, clique ou toque em Aplicativos e, em seguida, selecione Importar pacote (versão prévia).

    Selecionar Importar

  2. Selecione Carregar e selecione o arquivo de pacote do aplicativo que você deseja importar.

    Selecionar o arquivo de pacote

  3. Depois que o pacote for carregado, você precisará examinar o conteúdo do pacote e fornecer uma entrada adicional para qualquer item marcado com um ícone vermelho, selecionando o ícone de chave inglesa de cada item e inserindo as informações necessárias.

    Examinar o conteúdo do pacote

  4. Depois de fornecer todas as informações necessárias, selecione Importar.

    Conteúdo do pacote atualizado

  5. Quando a importação for concluída, você será automaticamente redirecionado para uma página (semelhante à mostrada abaixo), que descreve se a operação de importação foi bem-sucedida.

    Examinar os resultados da importação

OBSERVAÇÃO Se você estiver importando um aplicativo e decidiu Atualizar um aplicativo existente, as novas alterações serão salvas como um rascunho dos aplicativos. Você precisará publicar as alterações para que fiquem disponíveis para todos os outros usuários dos aplicativos.

Limitações conhecidas

Limitação Status
Houve relatos de que a importação de pacotes de aplicativos que contêm mais de ~3 recursos leva vários minutos para ser concluída. Esse é um problema conhecido e uma correção será distribuída em breve.