tela pac

Operando com arquivos .msapp do Power Apps

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Commands

pac canvas create

Gerar um aplicativo de tela de um conector personalizado

Esse 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 outras personalizações. Importe o aplicativo gerado para o Power Apps Studio navegando até File>Open>Browse no Studio.

Exemplos

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
• Criar um aplicativo de tela com base em uma definição de API Aberta por id

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 de 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

connector-display-name Ou connector-id são necessários.

Parâmetros necessários para 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 do qual gerar o Power App.

--connector-id

A ID do Conector do qual gerar o Power App.

--environment

A ID ou URL do Ambiente de destino. O valor padrão é o ambiente do seu Perfil de Autenticação do Dataverse atualmente ativo.

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 ao conector personalizado. O criador deve adicionar manualmente uma referência ao conector personalizado do qual o aplicativo foi gerado antes que o aplicativo possa ser reproduzido. Consulte Adicionar conexões de dados a aplicativos de tela para obter etapas. Até que isso seja feito, você poderá ver erros de fórmula no aplicativo que serão resolvidos depois que a referência do conector for adicionada. O nome do conector personalizado que você adiciona ao aplicativo deve corresponder ao nome de exibição do conector personalizado referenciado no canvas create comando.
• O aplicativo conterá uma tela para cada POST uma e GET uma ação que o conector define.
  • Não há suporte para outros verbos disponíveis em conectores personalizados.
• 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. Não há suporte canvas createpara determinados tipos de entrada e saída definidos no conector personalizado. O comando gerará avisos no console quando eles forem encontrados. Casos específicos:
  • Matrizes de objetos e matrizes de matrizes não têm suporte como entradas
  • 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 têm suporte para entrada ou saída.

download da tela pac

Baixar o aplicativo de tela 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 Dataverse de destino. O valor pode ser um Guid ou uma URL https absoluta. Quando não for especificado, a organização ativa selecionada para o perfil de autenticação atual será usada.

--extract-to-directory -d

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

--file-name -f

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

--overwrite -o

Permitir substituição de arquivo

Esse parâmetro não requer nenhum valor. É um comutador.

pac canvas list

Listar aplicativos de tela

Parâmetros opcionais para a lista de telas

--environment -env

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

pac canvas pack

(Versão prévia) Empacotar fontes em um arquivo msapp

Example

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

Parâmetros necessários para o pacote de tela

--msapp

Caminho para o arquivo .msapp

--sources

Diretório para fontes a serem empacotadas

Observações

Cria um .msapp arquivo dos arquivos de origem descompactados anteriormente. O resultado pode ser aberto no Power Apps Studio navegando até File>Open>Browse.

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

desempacotar tela pac

(Versão prévia) Extrair um arquivo msapp em fontes

Example

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

pac canvas unpack --msapp HelloWorld.msapp

Desempacotar para o diretório padrão HelloWorld_src .

Parâmetros necessários para desempacotar tela

--msapp

Caminho para o arquivo .msapp

Parâmetros opcionais para desempacotar tela

--sources

Diretório para fontes a serem desempacotadas

Observações

Desempacota o arquivo de origem .msapp .

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

Se o parâmetro de origem não for especificado, um diretório com o mesmo nome e local que o .msapp arquivo será usado com _src sufixo.

Estrutura de pastas

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

• \src – arquivos de controle e componente. Isso contém as fontes.
  • *.fx.yaml - As fórmulas extraídas do control.json arquivo.

    Observação

    Este é o local para editar 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 o Power Apps Studio usar.
• \DataSources - Todas as fontes de dados usadas pelo aplicativo.
• \Conexões - Instâncias de conexão salvas com o aplicativo e usadas ao recarregar no Power Apps Studio.
• \Ativos – Arquivos de mídia inseridos no aplicativo.
• \pkgs – uma cópia baixada de referências externas, como modelos, arquivos de definição de API e bibliotecas de componentes. Elas são semelhantes às referências do NuGet/NPM.
• \other - Todos os arquivos diversos necessários para recriar o .msapp.
  • entropy.json - Elementos voláteis (como carimbos de data/hora) são extraídos para esse 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 arquivo

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: Gramática da Fórmula YAML do Power Fx

Mesclar alterações com o Power Apps Studio

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

• Verifique se 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 você normalmente faz:
  • \src*.fx.yaml
• Se houver conflitos ou erros, você poderá excluir estes arquivos:
  • \src\editorstate*.json – esses arquivos contêm informações opcionais no Power Apps Studio.
  • \other\entropy.jsativado
• Para quaisquer conflitos nesses arquivos, não há problema em aceitar a versão mais recente:
  • \checksum.jsativado
• Se houver conflitos de mesclagem nesses caminhos, não será seguro mesclar. Informe-nos se isso acontece com frequência; trabalharemos na reestruturação do formato de arquivo para evitar conflitos.
  • \Conexões*
  • \DataSources*
  • \Pkgs*
  • CanvasManifest.json

Código aberto

Os comandos de tela na CLI do Microsoft Power Platform são de software livre. Discutir melhorias, levantar problemas e acessar o código do repositório de ferramentas de linguagem do Power Apps.

validar tela pac

(Versão prévia) Validar a origem .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 que contém 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