Compartir por

Lenzo de pac

Operar con ficheiros .msapp de Power Apps

[Este artigo é a documentación de prelanzamento e está suxeito a cambios.]

Importante

  • Os pack comandos e unpack os comandos están desaparecidos.
  • Para controlar a fonte da túa aplicación de lenzo, usa a integración de Git de Power Platform.
  • O create comando está dispoñible con carácter xeral.

Comandos

Comando Descripción
Creación do lenzo de pac Xerar unha aplicación de lenzo a partir dun conector personalizado
Descarga de Pac Canvas Descargar a aplicación Canvas como ficheiro .msapp
Lista de lenzos de pac Listar as aplicacións do lenzo
Paquete de lenzo PAC (Vista previa) Empaquetar as fontes nun ficheiro msapp
Desempaquetado do lenzo PAC (Vista previa) Extraer un ficheiro msapp en fontes
Validación do lienzo PAC (Vista previa) Validar a fonte .pa.yaml dun ficheiro msapp descomprimido

Creación do lenzo de pac

Xerar unha aplicación de lenzo a partir dun conector personalizado

Este comando xerará unha .msapp aplicación de lenzo baseada na definición OpenAPI dun conector personalizado existente. A aplicación conterá pantallas, disposición de control e código Power Fx xerado en función de como se definen as accións do conector personalizado, cun aspecto predefinido. A aplicación pódese usar para exercer directamente as accións definidas no conector personalizado.

Os creadores poden importar o xerado .msapp en Power Apps Studio para reproducir a aplicación ou para facer edicións e facer máis personalizacións. Importa a aplicación xerada a Power Apps Studio navegando a Ficheiro>Abrir>Navegar dentro de Studio.

Exemplos

Os seguintes exemplos mostran o uso do pac canvas create comando.

Crear unha aplicación de lenzo baseada nunha definición de API aberta por nome de visualización

Este exemplo crea unha aplicación de lenzo (como un ficheiro *.msapp) baseada nunha definición de API aberta usando o nome de visualización do conector.

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

Crear unha aplicación de lenzo baseada nunha definición de API aberta por id

Este exemplo crea unha aplicación de lenzo (como un ficheiro *.msapp) baseada nunha definición de API aberta usando o ID do conector.

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

Ou connector-display-name sexa, ou sexan connector-id necesarios.

Parámetros necesarios para a creación do lenzo

--msapp

Rota do ficheiro .msapp a xerar

Parámetros opcionais para a creación do lenzo

--connector-display-name

O nome de visualización do conector desde o que se xera a Power App.

--connector-id

O identificador do conector a partir do que xerar a Power App.

--environment

O ID ou URL do entorno de destino. O valor predeterminado é o ambiente do perfil de autenticación de Dataverse activo actualmente.

Comentarios

Consideracións e limitacións:

  • O conector personalizado referenciado cos connector-display-name parámetros or connector-id debe formar parte dunha solución.
  • Despois de importar a aplicación a Studio, non haberá ningunha asociación co conector personalizado. O creador debe engadir manualmente unha referencia ao conector personalizado desde o que se xerou a aplicación antes de que a aplicación poida ser reproducida. Vexa Engadir conexións de datos a aplicacións de lenzo para os pasos. Ata que isto non se faga, pode ver erros de fórmula na aplicación que se resolverán unha vez que se engada a referencia do conector. O nome do conector personalizado que engades á aplicación debe coincidir co nome de visualización do conector personalizado ao que se fai referencia no canvas create comando.
  • A aplicación conterá unha pantalla para cada POST unha e GET a acción que defina o conector.
    • Non se admiten outros verbos dispoñibles en conectores personalizados.
  • Os controis renderizados na pantalla de cada acción xéranse dinámicamente en función de como se definen os tipos de entrada e saída de cada acción. Certos tipos de entrada e saída definidos no conector personalizado non están soportados por canvas create. O comando xerará avisos na consola cando se atope. Casos específicos:
    • As matrices de obxectos e as matrices de matrices non están soportadas como entradas
    • Non se xeran controis para obxectos ou matrices aniñadas máis aló dunha profundidade de 20
    • Os tipos "ficheiro" e "formato binario" non están soportados para a entrada ou saída.

Descarga de Pac Canvas

Descargar a aplicación Canvas como ficheiro .msapp

Parámetros necesarios para a descarga do lenzo

--name -n

Nome exacto da aplicación Canvas, nome parcial ou ID da aplicación

Parámetros opcionais para a descarga do lenzo

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

--extract-to-directory -d

Nome do cartafol para extraer a aplicación canvas

--file-name -f

Nome do ficheiro (normalmente con extensión .msapp). Se non se proporciona, o ficheiro gárdase no directorio actual con 'appname'.msapp

--overwrite -o

Permitir a sobrescritura do ficheiro

Este parámetro non precisa de valor. É un cambio.

Lista de lenzos de pac

Listar as aplicacións do lenzo

Parámetros opcionais para a lista de lenzos

--environment -env

Especifica o Dataverse de destino. O valor pode ser un Guid ou un URL https absoluto. Cando non se especifique, utilizarase a organización activa seleccionada para o perfil de autenticación actual.

Paquete de lenzo PAC

(Vista previa) Empaquetar as fontes nun ficheiro msapp

Exemplo

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

Parámetros necesarios para o paquete de lenzo

--msapp

Rota ao ficheiro .msapp

--sources

Directorio para as fontes a empaquetar

Comentarios

Crea un .msapp ficheiro a partir dos ficheiros fonte desempaquetados previamente. O resultado pódese abrir en Power Apps Studio navegando aBuscar>>.

Despois de ser desempaquetados, os ficheiros fonte poden ser editados e xestionados con ferramentas externas como Visual Studio Code e GitHub.

Desempaquetado do lenzo PAC

(Vista previa) Extraer un ficheiro msapp en fontes

Exemplo

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

pac canvas unpack --msapp HelloWorld.msapp

Desempaqueta ao cartafol predeterminado HelloWorld_src .

Parámetros necesarios para o desempaquetado do lenzo

--msapp

Rota ao ficheiro .msapp

Parámetros opcionais para o desempaquetado do lenzo

--sources

Directorio para as fontes a desempaquetar

Comentarios

Desempaqueta o .msapp ficheiro fonte.

Descarga o .msapp ficheiro de Power Apps Studio navegando a Ficheiro>Gardar como>este ordenador.

Se non se especifica o parámetro sources , utilízase un cartafol co mesmo nome e localización que o .msapp ficheiro co _src sufixo.

Estrutura de cartafoles

As propiedades de desempaquetado e empaquetado usan a seguinte estrutura de cartafoles:

  • \src - Ficheiros de control e compoñentes. Isto contén as fontes.
    • *.fx.yaml - As fórmulas extraídas do control.json ficheiro.

      Nota

      Este é o lugar onde editar as túas fórmulas.

    • CanvasManifest.json - Ficheiro manifesto que contén a información normalmente presente na cabeceira, propiedades e publishInfo.
    • *.json - O arquivo bruto control.json .
    • \EditorState*.editorstate.json - Información almacenada en caché para que Power Apps Studio poida usar.
  • DataSources - Todas as fontes de datos utilizadas pola aplicación.
  • \Conexións : instancias de conexión gardadas coa aplicación e usadas ao recargar en Power Apps Studio.
  • \Assets - Ficheiros multimedia incrustados na aplicación.
  • \pkgs - Unha copia descargada de referencias externas, como modelos, ficheiros de definición de API e bibliotecas de compoñentes. Son similares ás referencias de NuGet / NPM.
  • \ other - Todos os ficheiros varios necesarios para recrear o .msapparquivo .
    • entropy.json - Os elementos volátiles (como os selos de tempo) son extraídos a este ficheiro. Isto axuda a reducir as diferenzas ruidosas noutros ficheiros, asegurando que aínda podemos viaxar de ida e volta.
    • Contén outros ficheiros da msapp, como o que está en \referencias.

Formato de ficheiro

Os .fx.yaml ficheiros usan un subconxunto de YAML. Do mesmo xeito que en Excel, todas as expresións deben comezar cun signo =igual. Máis información: Power Fx YAML Formula Grammar

Fusión de cambios con Power Apps Studio

Ao fusionar cambios que se realizan en dúas sesións diferentes de Power Apps Studio:

  • Asegúrese de que todos os nomes de control sexan únicos. Por exemplo, inserir un botón en dúas sesións diferentes pode resultar en dous Button1 controis. Recoméndase que nomee os controis pouco despois de crealos. A ferramenta non acepta dous controis co mesmo nome.
  • Para estes ficheiros, fusionalos como se fai normalmente:
    • \src*.fx.yaml
  • Se hai conflitos ou erros, pode eliminar estes ficheiros:
    • \src\editorstate*.json - Estes ficheiros conteñen información opcional en Power Apps Studio.
    • \other\entropy.jsen
  • Para calquera conflito nestes ficheiros, está ben aceptar a última versión:
    • \checksum.jsen
  • Se hai conflitos de fusión baixo estas rutas, non é seguro fusionalo. Déixanos saber se isto ocorre con frecuencia; Traballaremos na reestruturación do formato de ficheiro para evitar conflitos.
    • \Conexións*
    • \DataSources*
    • \ pkgs*
    • CanvasManifest.json

Código aberto

Os comandos de canvas na CLI de Microsoft Power Platform son de código aberto. Discutir melloras, levantar problemas e acceder ao código desde o repositorio de ferramentas de linguaxe de Power Apps.

Validación do lienzo PAC

(Vista previa) Validar a fonte .pa.yaml dun ficheiro msapp descomprimido

Parámetros necesarios para a validación do lenzo

--directory -d

Ruta ao cartafol msapp extraído que contén ficheiros .pa.yaml para validar

Consulte tamén

Grupos de comandos da CLI de Microsoft Power Platform
Visión xeral da CLI de Microsoft Power Platform

  • Last updated on