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

Artigo
08/02/2022
11 minutos de lectura

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

Este artigo ofrece orientación sobre como traballar con aplicacións de lenzo incorporadas, así como consellos útiles para solucionar os problemas que se enfrontan.

As aplicacións de lenzo incorporadas só son compatibles con aplicacións controladas por modelos de Interface unificada.
Só se poden habilitar tres aplicacións de lenzo incorporadas para cada formulario con Web e unha para os tipos de clientes de tabletas e teléfonos.
Pódense engadir varias aplicacións de lenzo incorporadas ao formulario, pero só se poden activar tres á vez para a web e unha á vez para os tipos de clientes de tabletas e teléfonos.
Se hai máis de tres aplicacións de lenzo incrustadas habilitadas co tipo de cliente web nunha aplicación baseada en modelos, a mensaxe de erro mostrará a seguinte: "Tes máis de tres aplicacións de lenzo con Web factor de forma, o máximo son 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 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.
A publicación dun formulario controlado por modelos non significa que se publicará a aplicación de lenzo incorporada.
- As aplicacións de lenzo incorporadas deben publicarse independentemente do formulario baseado no modelo de host. 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 lenzo incorporadas non se mostran ao crear unha nova fila xa que precisan que se lles pase un contexto de fila.
O obxecto ModelDrivenFormIntegration.Item é só de lectura.
- Para devolver datos, debes usar o Common Data Service conector. Máis información: Microsoft Dataverse
Só é posible crear aplicacións de lenzo incorporadas mediante o formulario xerado por modelos de aloxamento.
Ao ver un formulario baseado en modelos cunha aplicación de lenzo incrustada, se aparece unha mensaxe de erro "Parece que non tes acceso a esta aplicación" pídelle ao seu propietario que o comparta contigo, asegúrate de que o autor compartiu a aplicación incrustada. aplicación canvas contigo. Máis información: Compartir unha aplicación de lenzo incorporada.
Engadir unha aplicación de lenzo no control da subreixa xa non está dispoñible.
- Na versión de vista previa, os creadores puideron engadir unha aplicación de lenzo nun control de subredes. 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 lenzo, os creadores poden usar o conector de Common Data Service e a función de Filtrar coa capacidade Mellorar a experiencia da orixe de datos e as vistas de Dataverse activada na aplicación de lenzo.
  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 de subredes seguirá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

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

Desactivar unha aplicación de lenzo incorporada

Seleccione a Columna que está personalizada para mostrarse como unha aplicación de lenzo incorporada.
No diálogo Propiedades do columna, seleccione o separador Controis.
Na lista de controis, seleccione o control predefinido e, a seguir, seleccione a opción Web.
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 se 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.
O Aplicación Canvas o privilexio nun rol de seguranza non se pode usar para conceder aos usuarios de aplicacións acceso a unha aplicación de lenzo integrada ou independente. Para obter máis información sobre como compartir unha aplicación de lenzo incorporada, vai a: Comparte unha aplicación de lenzo incorporada.
Se volve escribir os mesmos datos que están a mostrarse no formulario controlado por modelos de aloxamento, o formulario seguirá a mostrar datos antigos até que se actualice. Para facelo facilmente, utilice o método RefreshForm.

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

Para acceder ás columnas dunha táboa relacionada, os creadores poden usar calquera das expresións listadas 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

Podes crear a túa aplicación de lenzo para que sexa sensible, que fai referencia á capacidade dunha aplicación para aliñarse automaticamente a diferentes tamaños de pantalla e factores de forma para utilizar o espazo dispoñible na pantalla de forma sensata. Dependendo de se a túa aplicación está creada para ser receptiva ou non, recomendámosche diferentes opcións de configuración para garantir que a túa aplicación de lenzo poida renderizarse correctamente no campo do formulario da aplicación baseada en modelos. Se tes espazos en branco ou barras de desprazamento adicionais na túa aplicación de lenzo, recomendámosche que comprobes o seguinte na túa aplicación.

Para aplicacións sensibles:

Desactivar o Escala para encaixar opción. Isto permitirá que a túa aplicación escalase segundo as dimensións e propiedades que definiches para a túa aplicación. É posible que unha aplicación de lenzo incrustada non se mostre correctamente no campo do formulario de aplicación baseada en modelos, como espazos en branco ou barras de desprazamento adicionais arredor da aplicación de lenzo.

Para aplicacións que non responden:

Recomendamos que active o Escala para encaixar opción. Isto axudará a cambiar o tamaño da aplicación para adaptarse ao espazo dispoñible.

En ambos os escenarios, asegúrese de que o Nome da aplicación o valor da propiedade establécese e defínese correctamente no control da aplicación de lenzo incrustado.

A aplicación de lenzo incorporada non respecta a altura

O Altura do campo de formulario O compoñente da aplicación canvas non respecta a propiedade. 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 queres facer axustes na altura do compoñente da aplicación de lenzo, recomendámosche personalizar a relación de aspecto na tú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.

Abra a aplicación de lenzo que está a inserir nun formulario de aplicación baseada en modelos para editala.
En Power Apps Studio, seleccione Ficheiro > Configuración > Tamaño da pantalla + orientación.
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 se importou a un contorno como solución non xestionada, edite a aplicación baseada en modelos, que ten o control da aplicación de lenzo incrustada e siga os pasos similares que se describen para que un solución administrada configure a propiedade Nome da aplicación 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

En Power Apps, seleccione o ambiente e, a seguir, no panel de navegación esquerdo, seleccione Aplicacións.
Seleccione a aplicación que desexa, seleccione ... e, a continuación, seleccione Compartir.
No panel esquerdo, seleccione a aplicación e logo seleccione Xestionar funcións de seguridade.
Abra o rol de seguranza asignado á aplicación, como o rol de seguranza de usuario básico.
Seleccione o separador Entidades personalizadas e estableza privilexios de lectura do alcance da organización para a táboa Metadatos ampliados de CanvasApp.
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

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).