Partilhar via

Tela PAC

Operando com arquivos .msapp do Power Apps

[Este artigo inclui documentação pré-versão e está sujeito a alterações.]

Importante

  • Os pack comandos e unpack foram preteridos.
  • Para controlar o código-fonte do seu aplicativo de tela, use a Power Platform Git Integration.
  • O create comando está geralmente disponível.

Commands

Command Description
criação de tela pac Gerar um aplicativo de tela a partir de um conector personalizado
pac canvas baixar Baixar o aplicativo canvas como arquivo .msapp
Lista de telas PAC Listar aplicativos de tela
Pacote PAC Canvas (Pré-visualização) Empacotar fontes em um arquivo msapp
descompactação pac canvas (Pré-visualização) Extrair um arquivo msapp em códigos-fonte
Validação do PAC Canvas (Pré-visualização) Validar a fonte .pa.yaml para um arquivo msapp descompactado

criação de tela pac

Gerar um aplicativo de tela a partir de um conector personalizado

Este comando gerará um .msapp aplicativo de tela com base na definição OpenAPI de um conector personalizado existente. O aplicativo conterá telas, layout de controle e código Power Fx gerado com base em como as ações do conector personalizado são definidas, com uma aparência predefinida. O aplicativo pode ser usado para exercer diretamente as ações definidas no conector personalizado.

Os criadores podem importar o gerado .msapp para o Power Apps Studio para reproduzir o aplicativo ou fazer edições e fazer personalizações adicionais. Importe o aplicativo gerado para o Power Apps Studio navegando atéProcurar em>> no Studio.

Examples

Os exemplos a seguir mostram o uso do pac canvas create comando.

Criar um aplicativo de tela com base em uma definição de API aberta por nome de exibição

Este exemplo cria um aplicativo de tela (como um arquivo *.msapp) com base em uma definição de API aberta usando o nome para exibição do conector.

pac canvas create --msapp HelloWorld.msapp --connector-display-name "My Custom Connector"

Criar um aplicativo de tela com base em uma definição de API aberta por id

Este exemplo cria um aplicativo de tela (como um arquivo *.msapp) com base em uma definição de API aberta usando a ID do conector.

pac canvas create --msapp HelloWorld.msapp --connector-id 00000000-0000-0000-0000-000000000000

Ou connector-display-nameconnector-id são ou são obrigatórios.

Parâmetros necessários para a criação de tela

--msapp

Caminho para o arquivo .msapp a ser gerado

Parâmetros opcionais para criação de tela

--connector-display-name

O nome de exibição do conector a partir do qual gerar o Power App.

--connector-id

O ID do conector a partir do qual gerar o Power App.

--environment

O ID ou URL do ambiente de destino. O valor padrão é o ambiente do seu perfil de autenticação do Dataverse ativo no momento.

Observações

Considerações e limitações:

  • O conector personalizado referenciado com os connector-display-name parâmetros ou connector-id deve fazer parte de uma Solução.
  • Depois de importar o aplicativo para o Studio, não haverá associação com o conector personalizado. O criador deve adicionar manualmente uma referência ao conector personalizado a partir do qual o aplicativo foi gerado antes que o aplicativo possa ser reproduzido. Consulte Adicionar conexões de dados a aplicativos de tela para conhecer as etapas. Até que isso seja feito, você pode ver erros de fórmula no aplicativo que serão resolvidos assim que a referência do conector for adicionada. O nome do conector personalizado que você adiciona ao aplicativo deve corresponder ao nome para exibição do conector personalizado mencionado no canvas create comando.
  • O aplicativo conterá uma tela para cada POST ação que GET o conector define.
    • Outros verbos disponíveis em conectores personalizados não são suportados.
  • Os controles renderizados na tela de cada ação são gerados dinamicamente com base em como os tipos de entrada e saída de cada ação são definidos. Certos tipos de entrada e saída definidos no conector personalizado não são suportados pelo canvas create. O comando gerará avisos no console quando eles forem encontrados. Casos específicos:
    • Matrizes de objetos e matrizes de matrizes não são suportadas como entradas
    • Os controles não são gerados para objetos ou matrizes aninhadas além de uma profundidade de 20
    • Os tipos "arquivo" e "formato binário" não são suportados para entrada ou saída.

pac canvas baixar

Baixar o aplicativo canvas como arquivo .msapp

Parâmetros necessários para download de tela

--name -n

Aplicativo de tela exato, nome parcial ou ID do aplicativo

Parâmetros opcionais para download de tela

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--extract-to-directory -d

Nome do diretório para extrair o aplicativo de tela para

--file-name -f

Nome do arquivo (geralmente com extensão .msapp). Se não fornecido, o arquivo é salvo no diretório atual com 'appname'.msapp

--overwrite -o

Permitir substituição de arquivo

Este parâmetro não requer valor. É uma mudança.

Lista de telas PAC

Listar aplicativos de tela

Parâmetros opcionais para a lista de telas

--environment -env

Especifica o Dataverso de destino. O valor pode ser um URL Guid ou https absoluto. Quando não especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

Pacote PAC Canvas

(Pré-visualização) Empacotar fontes em um arquivo msapp

Example

pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp

Parâmetros necessários para o canvas pack

--msapp

Caminho para o arquivo .msapp

--sources

Diretório para fontes a serem compactadas

Observações

Cria um .msapp arquivo a partir dos arquivos de origem descompactados anteriormente. O resultado pode ser aberto no Power Apps Studio navegando até Procurar Abertura> de Arquivo>.

Depois de descompactados, os arquivos de origem podem ser editados e gerenciados com ferramentas externas, como Visual Studio Code e GitHub.

descompactação pac canvas

(Pré-visualização) Extrair um arquivo msapp em códigos-fonte

Example

pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFiles

pac canvas unpack --msapp HelloWorld.msapp

Descompacta para o diretório padrão HelloWorld_src .

Parâmetros necessários para descompactar canvas

--msapp

Caminho para o arquivo .msapp

Parâmetros opcionais para descompactar canvas

--sources

Diretório para fontes a serem descompactadas

Observações

Descompacta o .msapp arquivo de origem.

Baixe o .msapp arquivo do Power Apps Studio navegando até Salvar arquivo>como>este computador.

Se o parâmetro sources não for especificado, um diretório com o mesmo nome e local do arquivo será usado com .msapp sufixo_src.

Estrutura de pastas

As propriedades de descompactar e empacotar usam a seguinte estrutura de pastas:

  • \src - Arquivos de controle e componentes. Este contém as fontes.
    • *.fx.yaml - As fórmulas extraídas do control.json arquivo.

      Observação

      Este é o local para editar as suas fórmulas.

    • CanvasManifest.json - Um arquivo de manifesto que contém as informações normalmente presentes no cabeçalho, propriedades e publishInfo.
    • *.json - O arquivo bruto control.json .
    • \EditorState*.editorstate.json - Informações armazenadas em cache para uso do Power Apps Studio.
  • \DataSources - Todas as fontes de dados usadas pelo aplicativo.
  • \Connections - Instâncias de conexão salvas com o aplicativo e usadas ao recarregar no Power Apps Studio.
  • \Assets - Arquivos de mídia incorporados no aplicativo.
  • \pkgs - Uma cópia baixada de referências externas, como modelos, arquivos de definição de API e bibliotecas de componentes. Estas são semelhantes às referências NuGet/NPM.
  • \other - Todos os arquivos diversos necessários para recriar o .msapparquivo .
    • entropy.json - Elementos voláteis (como carimbos de data/hora) são extraídos para este arquivo. Isso ajuda a reduzir as diferenças barulhentas em outros arquivos, garantindo que ainda possamos fazer uma viagem de ida e volta.
    • Contém outros arquivos do msapp, como o que está em \referências.

Formato de ficheiro

Os .fx.yaml arquivos usam um subconjunto de YAML. Semelhante ao Excel, todas as expressões devem começar com um sinal =de igual . Mais informações: Power Fx YAML Formula Grammar

Mesclando alterações com o Power Apps Studio

Ao mesclar alterações feitas em duas sessões diferentes do Power Apps Studio:

  • Certifique-se de que todos os nomes de controle são exclusivos. Por exemplo, inserir um botão em duas sessões diferentes pode resultar em dois Button1 controles. Recomendamos que você nomeie os controles logo após criá-los. A ferramenta não aceita dois controles com o mesmo nome.
  • Para esses arquivos, mescle-os como faz normalmente:
    • \src*.fx.yaml
  • Se houver conflitos ou erros, você pode excluir estes arquivos:
    • \src\editorstate*.json - Esses arquivos contêm informações opcionais no Power Apps Studio.
    • \other\entropy.jsem
  • Para quaisquer conflitos nesses arquivos, não há problema em aceitar a versão mais recente:
    • \checksum.jsem
  • Se houver conflitos de mesclagem nesses caminhos, não é seguro mesclar. Deixe-nos saber se isso acontece com frequência; Vamos trabalhar na reestruturação do formato de arquivo para evitar conflitos.
    • \Conexões*
    • \Fontesde dados*
    • \pkgs*
    • CanvasManifest.json

Código aberto

Os comandos canvas na CLI do Microsoft Power Platform são de código aberto. Discuta melhorias, levante problemas e acesse o código do repositório de ferramentas de linguagem do Power Apps.

Validação do PAC Canvas

(Pré-visualização) Validar a fonte .pa.yaml para um arquivo msapp descompactado

Parâmetros necessários para validação de tela

--directory -d

Caminho para o diretório msapp extraído contendo arquivos .pa.yaml para validar

Consulte também

Grupos de comandos da CLI do Microsoft Power Platform
Visão geral da CLI do Microsoft Power Platform

  • Last updated on