Directrices e solución de problemas para aplicacións de lenzo incrustadas

Orientación sobre a incorporación de aplicacións de lenzo

Este artigo fornece directrices sobre como traballar con aplicacións de lenzo incorporadas, así como suxestións útiles para resolver os problemas que poidan xurdir.

• As aplicacións de lenzo incorporadas só son compatibles con aplicacións controladas por modelos de Interface unificada.
• Só pode activar tres aplicacións de lenzo incrustadas para cada formulario con web e unha para os tipos de clientes de tabletas e teléfonos.
• Pode engadir varias aplicacións de lenzo incrustadas ao formulario, pero só pode activar tres á vez para web e unha á vez para os tipos de clientes de tabletas e teléfonos.
• Se se habilitan máis de tres aplicacións de lona incrustadas co tipo de cliente web nunha aplicación impulsada por modelo a partir da mensaxe de erro mostra como segue "Tes máis de tres aplicacións de lona con Web factor de forma, o máximo é de tres para este factor de forma. O número de aplicacións de lenzo está limitado a tres para a web e unha para os factores de formulario de tableta e teléfono".
• Para activar ou desactivar unha aplicación de lenzo incorporada, consulte Activar unha aplicación de lenzo incorporada e Desactivar unha aplicación de lenzo incorporada.
• Recomendámoslle que teña unha única aplicación de lenzo incrustada para cada pestana de formulario.
• Ao engadir unha aplicación de lenzo incorporada a un formulario xerado por modelos, use sempre unha columna obrigatoria que teña un valor garantido. Se a túa columna non ten un valor, a túa aplicación de lona incrustada non se actualizará en resposta a calquera cambio de datos no formulario impulsado polo modelo de host.
• Publicar un formulario impulsado por modelos tampouco publica a aplicación de lenzo incrustado.
  • As aplicacións de lenzo incorporadas deben publicarse independentemente do formulario controlado por modelos de aloxamento. Máis información: Publicar unha aplicación.
• Se Power Apps Studio non se pode abrir para crear ou editar unha aplicación de lenzo incorporada mediante o botón Personalizar nas propiedades de control da aplicación de lenzo porque está bloqueado debido a un bloqueador de ventás emerxentes en exploradores web, debe activar o sitio make.powerapps.com ou desactivar temporalmente o bloqueador de ventás emerxentes e despois seleccionar Personalizar outra vez.
• As aplicacións de lona incrustadas non se mostran ao crear unha nova fila xa que necesitan un contexto de fila para ser pasadas a elas.
• O obxecto ModelDrivenFormIntegration.Item é só de lectura.
  • Para escribir datos de volta, debes usar o Dataverse conector. Máis información: Microsoft Dataverse
• Só é posible crear aplicacións de lenzo incorporadas mediante o formulario xerado por modelos de aloxamento.
• Cando ve un formulario baseado en modelos cunha aplicación de lenzo incrustada, se ve unha mensaxe de erro que di "Parece que non ten acceso a esta aplicación" pida ao seu propietario que a comparta con vostede" asegúrese de que o autor compartiu a aplicación de lenzo incrustada con vostede. Máis información: Compartir unha aplicación de lenzo incorporada.
• Engadir unha aplicación de lenzo no control de grade xa non está dispoñible.
  • Na versión preliminar, os creadores puideron engadir unha aplicación de lenzo nun control de subgrade. Coa incorporación da aplicación de lenzo en formularios controlados por modelos agora dispoñible, engadir unha aplicación de lenzo incorporada a un formulario controlada por modelos simplifícase nunha columna.
  • Aos creadores resúltalles máis fácil xa que non teñen que decidir con antelación se pasar a fila actual (formulario principal) como contexto de datos ou unha lista de filas relacionadas coa fila actual (formulario principal).
  • Os creadores comezan sempre cunha columna e poden acceder tanto á fila actual (formulario principal) como a unha lista de fila relacionadas coa fila actual (formulario principal).
  • Para acceder á lista de filas relacionadas na aplicación de lona, os fabricantes poden usar o Dataverse conector e a función Filter coa experiencia Mellorar as fontes de datos e Dataverse ver a capacidade habilitada na aplicación de lona.
    Por exemplo, para acceder á visualización de Contactos activos da táboa Contactos, os creadores poden usar: Filtrar (Contactos, 'Contactos (visualizacións)'.'Contactos activos').
  • As aplicacións de lenzo existentes que usan o control da subgrade continuarán funcionando. Non obstante, recomendámoslle migrar estas aplicacións para usar unha columna no seu lugar. Máis información: Migración de aplicacións de lenzo incorporadas en formularios xerados por modelos que usan unha lista de filas relacionadas coa fila actual (formulario principal) para obter detalles.

Activar unha aplicación de lenzo incorporada

1. Seleccione a columna que está personalizada para mostrarse como unha aplicación de lenzo incorporada.
2. No diálogo Propiedades do columna, seleccione o separador Controis.
3. Na lista de controis, seleccione Aplicación de lenzo e, a seguir, seleccione a opción Web.
4. Seleccione Aceptar.

Desactivar unha aplicación de lenzo incorporada

1. Seleccione a Columna que está personalizada para mostrarse como unha aplicación de lenzo incorporada.
2. No diálogo Propiedades do columna, seleccione o separador Controis.
3. Na lista de controis, selecciona o control predeterminado e, a seguir, selecciona a opción Web .
4. Seleccione Aceptar.

Gardar datos nunha aplicación de lenzo incorporada

• Un evento de gardado feito desde unha aplicación controlada por modelos, como seleccionar o botón Gardar na barra de comandos do formulario principal, non garda os cambios realizados na aplicación de lenzo incorporada.
• Para gardar os cambios feitos nunha aplicación de lenzo incorporada, use o conector de Dataverse.
• A acción OnDataRefresh do control ModelDrivenFormIntegration só se debe empregar para actualizar datos na aplicación de lenzo incorporada. Non recomendamos que use a acción OnDataRefresh para gardar os cambios na aplicación de lenzo incorporada.

Problemas coñecidos e limitacións de aplicacións de lenzo incorporadas

Limitacións

• O control personalizado para aplicacións de lenzo só é compatible para usarse co tipo de cliente Web. Actualmente, os tipos de cliente Teléfono e Tableta non se admiten.
• Non pode utilizar o privilexio Aplicación de lenzo nun rol de seguranza para conceder aos usuarios da aplicación acceso a unha aplicación de lenzo incorporada ou independente. Para obter máis información acerca de como compartir unha aplicación de lenzo incorporada, consulte: Compartir unha aplicación de lenzo incorporada.
• Se escribes de novo os mesmos datos que se están a mostrar no formulario impulsado polo modelo de host, o formulario seguirá amosando datos antigos ata que se refresque. Para facelo facilmente, utilice o método RefreshForm.
• Os controis de capacidade fóra de liña e dispositivo como a exploración de códigos de barras, a captura de fotos do dispositivo ou a adhesión de ficheiros non están soportados en aplicacións de lona incorporada.

O control ModelDrivenFormIntegration non proporciona un valor para as columnas dunha táboa relacionada

Por exemplo, cando o control de ModelDrivenFormIntegration está conectado á táboa de contas, usando ModelDrivenFormIntegration.Item.'Primary Contact'. O nome completo non devolverá un valor.

Para acceder a columnas dunha táboa relacionada, os creadores poden usar calquera das expresións enumeradas aquí: - Busca(Contas, Conta = GUID(First(ModelDrivenFormIntegration.Data).ItemId)).'Contacto primario'.'Nome completo'
- ItemId está baleiro no momento da creación pero terá un valor en tempo de execución. - Busca(Contas, Conta = ModelDrivenFormIntegration.Item.Account).'Contacto primario'.'Nome completo' (Esta expresión é máis fácil de ler, pero a expresión anterior funcionará un pouco mellor.)

A aplicación de lenzo incrustada non se reproduce correctamente

Pode crear a súa aplicación de lenzo para ser de capacidade de resposta, o cal refírese á capacidade dunha aplicación para adaptarse automaticamente a diferentes tamaños de pantalla e factores de forma para usar o espazo dispoñible na pantalla de forma sensata. Dependendo de se a súa aplicación está construída para responder ou non, recomendamos diferentes configuracións para asegurarse de que a aplicación de lona poida renderse correctamente dentro do campo no formulario de aplicación impulsado por modelos. Se estás experimentando un espazo branco adicional ou barras de desprazamento ao redor da aplicación de lona, recomendámosche comprobar o seguinte na túa aplicación.

Para aplicacións con capacidade de resposta:

• Desactive a opción Axustar tamaño. Isto permite que a aplicación escala segundo as dimensións e propiedades que teña configuradas para a súa aplicación. Unha aplicación de lona incrustada pode non renderse correctamente dentro do campo no formulario de aplicacións impulsadas por modelos, como o espazo branco adicional ou as barras de desprazamento ao redor da aplicación de lona.

Para aplicacións non sensibles:

• Recomendamos que active a opción Escala para encaixar. Isto axuda á aplicación a redimensionar para adaptarse ao espazo dispoñible.

Nos dous escenarios, asegúrese de que o valor da propiedade Nome da aplicación estea establecido e definido correctamente no control da aplicación de lenzo incrustada.

A aplicación de lenzo incrustada non respecta a altura

A propiedade da altura do campo de forma non é respectada polo compoñente da aplicación de lona. Cando se incrusta, as dimensións do compoñente da aplicación de lenzo respectan a relación de aspecto definida na aplicación de lenzo. Dado que a relación de aspecto é fixa, a altura do compoñente da aplicación de lenzo calcúlase en relación co ancho da aplicación. O ancho da aplicación determínase en función do espazo horizontal dispoñible na aplicación baseada no modelo. Se quere facer axustes na altura do compoñente da aplicación de lenzo, recomendámoslle personalizar a relación de aspecto na súa aplicación de lenzo. Teña en conta que para personalizar a relación de aspecto, a aplicación debe estar no deseño da tableta.

Activar escalar para axustar

De xeito predeterminado, as aplicacións de lenzo teñen a opción de escalar para axustar habilitada.

1. Abra a aplicación de lenzo que está a inserir nun formulario de aplicación baseada en modelos para editala.
2. En Power Apps Studio, seleccione Ficheiro > Configuración > Tamaño da pantalla + orientación.
3. En Configuración avanzada, configure Escalar para encaixar en Encendido.

Falta o valor da propiedade Nome da aplicación ou está mal definido

Para resolver este problema, elixa a opción correcta:

• Solucións xestionadas: se a solución se importou a un ambiente como solución administrada, siga estes pasos:

  1. Inicie sesión en Power Apps e diríxase ao contorno de desenvolvemento onde creou orixinalmente a súa aplicación de lenzo incrustada. Este é tamén o ambiente onde se exportou a solución.

  2. Abra a solución non xestionada que inclúe a aplicación de lenzo e, a continuación, busque a aplicación de lenzo na lista de compoñentes da solución. Copie o Nome da aplicación de lenzo exactamente como aparece na lista de compoñentes. Por exemplo, contoso_flooringestimatesapp_624d7.

  3. Na mesma solución, edite a aplicación baseada en modelos que ten o control da aplicación de lenzo incrustada e logo configure o Nome da aplicación de lenzo no control da aplicación de lenzo incrustada usando o valor do paso anterior. Máis información: Engadir unha aplicación de lenzo incorporada nun formulario xerado por modelos

  4. Exporte a solución desde o contorno de desenvolvemento e logo importe a solución no seu contorno de destino.

• Solucións non xestionadas: Se a solución foi importada a un ambiente como solución non xestionada, edita a aplicación impulsada por modelos que ten o control da aplicación de lona incrustada e, a continuación, siga pasos similares como se describe para un solución administrada para configurar a propiedade de App Name de lenzo .

O control da aplicación de lenzo incrustada carga a aplicación de lenzo desde un ambiente diferente

Cando unha solución que contén unha aplicación baseada en modelos cunha aplicación de lenzo incrustada se importa nun ambiente de destino, o control carga a aplicación de lenzo desde o contorno de orixe (onde se exportou a solución). O control debería cargar a aplicación de lenzo desde o ambiente de destino (actual).

Este problema prodúcese porque o usuario da aplicación non ten acceso de lectura á táboa de metadatos estendidos de CanvasApp no contorno de destino (actual). Para resolver este problema, engada o usuario a un rol de seguranza usado para a aplicación que ten acceso de lectura á táboa de metadatos estendidos de CanvasApp. Máis información: Conceder privilexios de lectura para a táboa de metadatos estendidos de CanvasApp

Mensaxe de erro: "Non ten privilexios de lectura para a entidade de aplicación de lenzo. Póñase en contacto co administrador"

A mensaxe de erro móstrase no formulario de aplicación baseado en modelo onde debería aparecer a aplicación de lenzo incrustada.

Este problema prodúcese porque o usuario da aplicación non ten acceso de lectura á táboa de metadatos estendidos de CanvasApp. Para resolver este problema, engada o usuario a un rol de seguranza usado para a aplicación que ten acceso de lectura á táboa de metadatos estendidos de CanvasApp.

Conceder privilexios de lectura para a táboa de metadatos estendidos de CanvasApp

1. En Power Apps, seleccione o ambiente e, a seguir, no panel de navegación esquerdo, seleccione Aplicacións.
2. Seleccione a aplicación que desexa, seleccione ... e, a continuación, seleccione Compartir.
3. No panel esquerdo, seleccione a aplicación e logo seleccione Xestionar funcións de seguridade.
4. Abra o rol de seguranza asignado á aplicación, como o rol de seguranza de usuario básico.
5. Seleccione o separador Entidades personalizadas e estableza privilexios de lectura do alcance da organización para a táboa Metadatos ampliados de CanvasApp.
6. Seleccione Gardar e pechar para pechar a ventá do rol de seguranza.

Consulte tamén

Incorporar unha aplicación de lenzo nun formulario xerado por modelos
Engadir unha aplicación de lenzo incorporada nun formulario xerado por modelos
Editar unha aplicación de lenzo incorporada nun formulario xerado por modelos
Personalizar o tamaño e a orientación da pantalla dunha 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
Compartir unha aplicación de lenzo incorporada
Migración de aplicacións de lenzo incorporadas en formularios xerados por modelos creados utilizando a última versión de previsualización pública