Engadir unha aplicación de lenzo incorporada nun formulario xerado por modelos

Este artigo explica como inserir un aplicación de lenzo nunha forma guiada por modelos. As aplicacións Canvas pódense conectar a unha gran variedade de fontes de datos e ofrecen aos deseñadores un maior control sobre a experiencia global do usuario.

Neste artigo descríbense dous métodos de integración. Primeiro, usando a experiencia moderna Interface unificada e, segundo, usando a experiencia clásica.

Hai un terceiro método máis recente para incorporar aplicacións de lenzo nunha aplicación moderna que é unha integración máis estreita da aplicación de lenzo e do formulario. Obtén máis información sobre a experiencia de creación de aplicacións moderna.

Inserir unha aplicación de lenzo usando a experiencia moderna

Para inserir unha aplicación de lenzo nun formulario principal de aplicación baseado en modelos, como o formulario principal da táboa Contas, siga estes pasos:

1. Inicie sesión en Power Apps.

2. Escolle o ambiente que ten a solución.

3. Seleccione o Táboa, que inclúe o formulario onde se debe mostrar a aplicación de lenzo.

4. Seleccione Formularios.

5. Escolle o Principal forma.

6. No deseñador de formularios, seleccione a sección do formulario onde debe aparecer a aplicación de lenzo inserida.

7. Engade un campo de formulario á sección, como Nome da conta.

   Suxestión

   É posible que queira cambiar o nome da columna da táboa que engada a algo máis significativo, como o nome ou unha breve descrición da aplicación de lenzo que está a inserir no formulario.

8. Ou selecciona + Compoñente no menú superior ou seleccione a icona do compoñente no menú da esquerda. Isto abre o panel de compoñentes.

9. Seleccione Aplicación Canvas dende Datos Relacionados sección. Hai unha serie de elementos adicionais que se deben engadir para configurar o control.

• A área Nome da entidade especifica a táboa que fornecerá os datos á súa aplicación de lenzo incorporada.

  • Vincular á columna da táboa : Cando Vincular á columna da táboa está seleccionada, a lista cambia para permitirche seleccionar a que columna da táboa quer vincular. Cando elixe ligar a unha columna de táboa, a columna será definida polo valor da columna de táboa. Por exemplo, cando Vincular á columna da táboa está seleccionado para o Nome da aplicación, no tempo de execución da aplicación o valor do nome da aplicación toma o valor da columna, como o valor dunha columna de texto personalizada.

    Importante

    Na maioría das situacións, non recomendamos usar a opción Vincular á columna da táboa co control da aplicación de lenzo.

  • Valor estático: Use isto para engadir un nome para que poida referirse á aplicación de lenzo. Teña en conta que este valor non ten efecto na aplicación de lenzo incrustada. Preténdese só servir como punto de referencia.

• A área Nome da aplicación especifica o nome da aplicación de lenzo.

  • Vincular á columna da táboa: Cando selecciona Vincular á columna da táboa, a lista cambia para permitirlle seleccionar a que columna de táboa ligar. Cando elixe ligar a unha columna de táboa, a columna será definida polo valor da columna de táboa. Por exemplo, cando selecciona Vincular á columna da táboa para o Nome da aplicación, no tempo de execución da aplicación, o valor do nome da aplicación toma o valor da columna, como o valor dunha columna de texto personalizada.

    Importante

    Na maioría das situacións, non recomendamos usar a opción Vincular á columna da táboa co control da aplicación de lenzo.

  • Valor estático: Especifica o nome da aplicación de lenzo que se vai inserir. O formulario baseado en modelos busca a aplicación de lenzo co nome especificado no contorno actual. Se unha aplicación de lenzo con ese nome non se pode atopar no ambiente, o control da aplicación de lenzo empregará o ID da aplicación para cargar a aplicación de lenzo. Introduza o nome da aplicación para unha aplicación de lenzo existente.

• A área ID da aplicación especifica o ID da aplicación de lenzo.

  • Vincular á columna da táboa: Cando selecciona Vincular á columna da táboa, a lista cambia para permitirlle seleccionar a que columna de táboa ligar. Cando elixe ligar a unha columna de táboa, a columna será definida polo valor da columna de táboa. Por exemplo, cando selecciona Vincular á columna da táboa para o Nome da aplicación, no tempo de execución da aplicación, o valor do nome da aplicación toma o valor da columna, como o valor dunha columna de texto personalizada.

    Importante

    Para a maioría das situacións, non recomendamos usar o Vincular á columna da táboa opción co control da aplicación de lenzo xa que isto requiriría que se mostrase o ID da aplicación correcto nun campo do rexistro.

  • Valor estático: Insira o ID da aplicación para unha aplicación de lenzo existente. O ID da aplicación de lenzo pódese atopar en Power Apps, Ir a Aplicacións, seleccione a aplicación de lenzo e, a continuación, seleccione Detalles na barra de comandos.

• Mostre a área de compoñentes. Especifica o tipo de cliente para amosar a aplicación de lenzo incrustada. Escolla entre Web, Móbil e Tableta.

10. Seleccione Gardar. A continuación, seleccione Publicar para publicar súa aplicación para que estea dispoñible para os usuarios.

Unha vez publicada unha aplicación de lenzo incorporada ao seu formulario controlado por modelos, comparta a súa aplicación de lenzo incorporada con outros usuarios. Máis información: Compartir unha aplicación de lenzo incorporada.

Cando os usuarios abran unha aplicación controlada por modelos que inclúa o formulario que se modificou, verán a aplicación de lenzo incorporada no formulario. Cambiar o rexistro mostrado no formulario principal, cambia o contexto de datos que se transmite ao formulario e a aplicación incorporada actualízase para mostrar os datos relevantes.

Este artigo explicou como comezar a utilizar a incorporación dunha aplicación de lenzo nun formulario controlado por modelos. Pode personalizar aínda máis a aplicación de lenzo incorporada para conectarse e traer datos de varias orixes de datos. Utilice as funcións de Filtro, Busca e Buscar e o contexto transmitido desde o formulario controlado por modelos de aloxamento para filtrar ou localizar rexistros específicos nesas orixes de datos. Utilice o editor de aplicacións de lenzo WYSIWYG para deseñar facilmente a interface para que coincida cos seus requisitos.

Inserir unha aplicación de lenzo coa experiencia clásica

1. Inicie sesión en Power Apps.

2. Crear ou editar o formulario principal dunha táboa, táboa de Contas no noso exemplo.

3. Na barra de comandos, seleccione Mudar a clásico para abrir o formulario no deseñador de formularios clásico

4. No deseñador de formularios clásico, seleccione a sección no formulario desde onde desexa que se mostre a aplicación de lenzo incorporada.

5. Utilizando o panel de columnas, engada unha columna obrigatoria, como por exemplo Nome de conta.

   Importante

   Utilice sempre unha columna obrigatoria que teña un valor. Se a columna non ten un valor, a aplicación de lenzo incorporada non se actualizará en resposta a calquera modificación nos datos no formulario controlado por modelos de aloxamento.

6. Coa columna seleccionada, no separador Inicio, no grupo Editar, seleccione Modificar propiedades.

7. Na caixa de diálogo Propiedades da columna, seleccione o separador Controis.

8. No separador Controis, seleccione Engadir control

9. Na caixa de diálogo Engadir Control, na lista de controis dispoñible, seleccione Aplicación de lenzo e, a seguir, seleccione Engadir.

10. Na caixa de diálogo Propiedades de columna, na lista de controis dispoñible, seleccione Aplicación de lenzo e, a seguir, seleccione a opción Web.

11. Na sección debaixo da lista de controis, móstrase a lista de propiedades dispoñibles para o control da aplicación de lenzo.

    • A propiedade Nome da táboa especifica a táboa que fornecerá os datos á súa aplicación de lenzo incorporada. Definirase na táboa que contén a columna que se engadiu nun paso anterior.
      • Teña en conta que, aínda que pareza que se pode cambiar esta propiedade, non afecta a aplicación de lenzo incorporada. Só se usa como referencia.
    • A propiedade Nome de aplicación especifica o nome da aplicación de lenzo que se vai incorporar. O formulario baseado en modelos busca a aplicación de lenzo co nome especificado no contorno actual. Se unha aplicación de lenzo con ese nome non se pode atopar no ambiente, o control da aplicación de lenzo empregará o ID da aplicación para cargar a aplicación de lenzo. Introduza o nome da aplicación para unha aplicación de lenzo existente.
    • A propiedade ID de aplicación especifica o ID da aplicación de lenzo incorporada. Pode introducir un ID de aplicación para unha aplicación de lenzo existente ou xerarase e encherase automaticamente un ID de aplicación cando cree ou edite unha aplicación de lenzo seleccionando Personalizar. O ID da aplicación de lenzo pódese atopar en Power Apps. Vaia a Aplicacións, seleccione a aplicación de lenzo e, a continuación, seleccione Detalles na barra de comandos.

    Nota

    Teña en conta que calquera modificación no valor do ID da aplicación quebra a ligazón do formulario controlado por modelos á aplicación de lenzo incorporada.

    Se nin o nome da aplicación nin o ID da aplicación coinciden cunha aplicación de lenzo existente, o formulario amosará a mensaxe "Sentímolo, non atopamos esa aplicación".

12. Vaia ao paso 20 se está a engadir unha aplicación de lenzo completada. Se está creando unha nova ou editando unha aplicación de lenzo existente, siga estes pasos. Seleccione Personalizar para crear ou editar unha aplicación de lenzo. Ábrese Power Apps Studio nun novo separador.

    Nota

    Se a apertura de Power Apps Studio está bloqueada debido a un bloqueador de elementos emerxentes de exploradores web, debe activar o sitio make.powerapps.com ou desactivar temporalmente o bloqueador e, a seguir, seleccionar Personalizar outra vez.

13. Observe o seguinte:

    • En Power Apps Studio, verá un control especial de ModelDrivenFormIntegration situado no panel da esquerda. Este control é responsable de traer datos contextuais do formulario controlado por modelos de aloxamento á aplicación de lenzo incorporada.
    • Observe que un control de formulario de aplicación de lenzo se engadiu automaticamente á súa aplicación de lenzo incorporada e mostra os datos que se lle pasan desde o formulario xerado por modelos de aloxamento a través do control ModelDrivenFormIntegration.
    • Seleccione o separador Ver e, a seguir, seleccione Orixes de datos. Teña en conta que unha orixe de datos para a táboa primaria do formulario xerado por modelos de aloxamento, Contas neste caso, engadiuse automaticamente a súa aplicación de lenzo incorporada. - Seleccione o control Formulario 1 e observe que a propiedade Orixe de datos estea axustada en Contas.
    • Co control Formulario 1 aínda seleccionado, observe que a propiedade Elemento estea axustada en ModelDrivenFormIntegration.Item.

    Nota

    A aplicación de lenzo incorporada ten acceso completo para ler desde o formulario xerado por modelos de aloxamento a través de ModelDrivenFormIntegration.Item. Como exemplo, para obter o valor dunha columna co nome accountnumber e nome para mostrar Número de conta, pode usar ModelDrivenFormIntegration.Item.accountnumber ou ModelDrivenFormIntegration.Item.'Account Number'.

14. No panel de propiedades da dereita, xunto a Columnas, seleccione Editar columnas.

15. Seleccione + Engadir columna para engadir outra columna ao formulario de aplicación de lenzo ou reordenar as columnas existentes utilizando arrastrar e soltar. Peche o panel de datos cando termine de engadir e reordenar columnas.

16. Seleccione o separador Ficheiro e despois seleccione Gardar.

17. Seleccione o separador A nube. Forneza un nome único para a aplicación e, a seguir, seleccione Gardar, na parte inferior dereita. Teña en conta o seguinte comportamento:

    • Gardar unha aplicación por primeira vez publica automaticamente a aplicación.
    • Despois, cada vez que garde, debe seleccionar Publicar e logo seleccionar Publicar esta versión para que os cambios estean dispoñibles.

18. No menú , seleccione Atrás.

19. Seleccione o separador do explorador que teña o deseñador de formularios clásico aberto. Observe que as propiedades ID da aplicación e Nome da aplicación da aplicación de lenzo agora teñen un valor que se enche automaticamente.

    Importante

    • O deseñador de formularios ten unha ligazón directa con Power Apps Studio que se abriu noutro separador do explorador nun paso anterior.
    • Asegúrese de que o nome da aplicación ten un valor similar á captura de pantalla que aparece a continuación. A propiedade do nome da aplicación especifica o nome único que se empregará para facer referencia á aplicación de lenzo no tempo de execución. Se non se define este nome, a propiedade de ID da aplicación usarase para facer referencia á aplicación de lenzo, que pode causar problemas ao importar a aplicación de lenzo como parte dunha solución. Recomendamos que estableza este nome para garantir a referencia correcta á aplicación de lenzo entre ambientes. Para configuralo, volva ao paso 12 e siga os pasos para crear a aplicación de lenzo que se vai incrustar.
    

20. Na caixa de diálogo Propiedades da columna, seleccione o separador Pantalla.

21. Limpe Mostrar etiqueta no formulario e, a seguir, seleccione Aceptar.

    • Se xa ten unha aplicación de lenzo incorporada neste formulario, mostrarase esta mensaxe: "Só se pode activar unha aplicación de lenzo nun formulario." Para engadir a nova aplicación de lenzo, debe primeiro desactivar a aplicación de lenzo incorporada actual. A seguir, active a nova aplicación de lenzo incorporada.

22. No separador Inicio, seleccione Gardar e, a seguir, seleccione Publicar.

Consulte tamén

Editar unha aplicación de lenzo incorporada nun formulario xerado por modelos
Realizar accións predefinidas no formulario de aloxamento desde unha aplicación de lenzo incorporada
Propiedades e accións do control ModelDrivenFormIntegration
Directrices para traballar con aplicacións de lenzo incorporadas