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

Este artigo explica como incorporar unha aplicación de lenzo nun formulario xerado por modelos. As aplicacións de lenzo ofrecen ao deseñador un control significativo sobre a experiencia do usuario e pódense conectar a unha gran variedade de orixes de datos e servizos de datos.

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

Inserir unha aplicación de lenzo usando a experiencia moderna

Para inserir unha aplicación de lenzo nun formulario principal de aplicación baseada en modelos, como o formulario principal para a táboa de contas, siga os pasos seguintes:

1. Inicie sesión en Power Apps.

2. Escolla o entorno e, a continuación, seleccione Solucións no panel de navegación esquerdo. Se o elemento non está no panel lateral, seleccione …Máis e, a seguir, seleccione o elemento que desexe.

3. Abre a solución que ten a táboa na que queres engadir unha aplicación de lenzo a un formulario principal.

4. Abra a táboa, seleccione Formularios e, a continuación, abra o formulario principal que desexe.

   Suxestión

   De forma predeterminada, a etiqueta do compoñente da aplicación de lenzo é Nova aplicación de lenzo. Quizais queiras cambiar o nome da etiqueta da aplicación de lenzo por algo máis significativo, como o nome da aplicación de lenzo ou unha breve descrición da aplicación de lenzo que estás incorporando no formulario.

5. Selecciona a área do formulario onde queres que se mostre a aplicación de lenzo ou crea unha nova pestana para mostrar a aplicación de lenzo.

6. No panel de navegación esquerdo, seleccione Compoñentes, expanda Pantalla e, a continuación, seleccione Compoñente da aplicación Canvas .

7. Pódense configurar as seguintes propiedades para o control.

   • A área Nome da entidade permíteche especificar as seguintes propiedades:

     • Bind to table column: When the Bind to table column is selected, the Static value property changes to allow you to select what table column to bind to. Cando elixe ligar a unha columna de táboa, a columna será definida polo valor da columna de táboa. Por exemplo, cando se selecciona Enlazar á columna da táboa para o Nome da entidade, no tempo de execución da aplicación o valor do o nome da táboa toma o valor da columna da táboa especificada.

     • 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 único da aplicación de lenzo.

     • Bind to table column: When you select the Bind to table column, the Static value property changes to allow you to select what table column to bind to. Cando elixe ligar a unha columna de táboa, a columna será definida polo valor da columna de táboa. Por exemplo, cando selecciona Enlazar á columna da táboa para o Nome da aplicación, no momento de execución da aplicación o valor do o nome da aplicación toma o valor da columna Táboa, como o valor dunha columna de texto personalizada.

     • Valor estático: especifica o nome único da aplicación de lenzo que se quere inserir. Introduza o nome único da aplicación de lenzo para unha aplicación de lenzo existente. Máis información: Como atopar o nome único e o ID de aplicación para unha aplicación de lenzo

   • A área necesaria ID da aplicación especifica o ID da aplicación para a 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 utilizar a opción Enlazar á columna da táboa para o ID da aplicación, xa que isto requirirá que se mostre o ID da aplicación correcto nun campo dentro do rexistro.

     • Valor estático: Insira o ID da aplicación para unha aplicación de lenzo existente. Máis información: Como atopar o nome único e o ID de aplicación para unha aplicación de lenzo

   • Mostrar compoñente en. Especifica o tipo de cliente para amosar a aplicación de lenzo incrustada. Escolla entre Web, Móbil e Tableta.

8. Seleccione Feito. A continuación, para publicar a túa aplicación e poñela a disposición dos usuarios, selecciona Publicar.

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.

Como atopar o nome único e o ID de aplicación para unha aplicación de lenzo

O control da aplicación de lenzo busca primeiro a aplicación de lenzo mediante o nome único que se atopa no campo Nome da aplicación . Se non se pode atopar unha aplicación de lenzo con ese nome único no contorno, o control da aplicación de lenzo utiliza a continuación o valor especificado no campo ID da aplicación para cargar a aplicación de lenzo. Aínda que debes introducir valores nos campos Nome da aplicación e ID da aplicación, só un dos valores debe ser preciso para que a aplicación de lenzo incorporada se cargue no control. Teña en conta que a aplicación de lenzo debe estar no entorno actual.

• O campo Nome da aplicación é o nome único da aplicación de lenzo. Para atopar o nome único, engade a aplicación de lenzo a unha solución. O nome único da aplicación de lenzo móstrase na columna Nome e aparece no formulario solutionpublisherprefix_appnamenospaces_appendix. Por exemplo, contoso_canvasappwithsharepointlist_5ee16.
• A propiedade ID de aplicación especifica o ID da aplicación de lenzo incorporada. Introduce 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. Vaia a Aplicacións, seleccione a aplicación de lenzo e, a continuación, seleccione Detalles na barra de comandos.

Inserir unha aplicación de lenzo usando a 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. Está pensado só para servirche 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ás creando unha aplicación de lenzo nova ou editando unha existente, continúa seguindo 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 observe que hai un control especial ModelDrivenFormIntegration no panel esquerdo. 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. Pecha o panel de datos cando remates 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