Configuración del sistema de aplicaciones de código de Power Apps

En este artículo se explica cómo Power Apps aplicaciones de código hospedan recursos de aplicaciones compiladas, cómo controlar la visibilidad del encabezado y cómo personalizar el texto que se muestra cuando un usuario no tiene acceso a una aplicación.

Recursos de la aplicación de código alojado públicamente

Al publicar una aplicación de código en Power Platform mediante pa app push, se hospedan los recursos de la aplicación compilados en un punto de conexión accesible públicamente. Este punto de conexión no admite actualmente restricciones de acceso basadas en IP. Dado que las aplicaciones de código se autentican con Microsoft Entra ID, use el acceso condicional para controlar el acceso por ubicación o IP. No almacene datos confidenciales de usuario u organización en la aplicación. Almacene este tipo de datos en un origen de datos para que el contenido se recupere después de que los usuarios finales que reproducen la aplicación pasen por las comprobaciones de autenticación y autorización.

Ocultar el encabezado Power Apps al reproducir una aplicación

Hay dos maneras de ocultar el encabezado para todos los usuarios de la aplicación o para una dirección URL de aplicación específica.

Method Description
Configure la configuración de la aplicación para ocultar el encabezado Use la CLI de Power Apps para ocultar el encabezado para todos los usuarios de la aplicación.
Agregue un parámetro de cadena de consulta para ocultar el encabezado Agregue un parámetro para ocultar el encabezado de una dirección URL de aplicación específica.

Configuración de la configuración de la aplicación para ocultar el encabezado

Use pa app set-setting para ocultar el encabezado de forma predeterminada. Ejecute el comando desde el proyecto de aplicación de código inicializado:

pa app set-setting --show-header false

El comando agrega la configuración a power.config.json. Para revisar la configuración actual de la aplicación, ejecute:

pa app get-settings

Publique la aplicación para aplicar la configuración:

pa app push

Para volver a mostrar el encabezado, establezca --show-header en true y, a continuación, publique la aplicación.

Para configurar el encabezado de forma interactiva, ejecute pa app set-setting sin establecer marcas y seleccione show-header. En Mostrar la barra de encabezado de la aplicación, seleccione Sí para mostrar el encabezado o No para ocultarlo.

Adición de un parámetro de cadena de consulta para ocultar el encabezado

Para ocultar el encabezado de una dirección URL de aplicación específica sin cambiar la configuración de la aplicación, anexe el hideNavBar=true parámetro de cadena de consulta al compartir la dirección URL.

El encabezado es visible:

https://apps.powerapps.com/play/e/{environment-id}/a/{app-id}

El encabezado está oculto:

https://apps.powerapps.com/play/e/{environment-id}/a/{app-id}?hideNavBar=true

Si la dirección URL ya contiene un parámetro de cadena de consulta, anexe &hideNavBar=true en su lugar.

Personaliza el texto de solicitud de acceso

Personalice el título y el mensaje que aparecen cuando un usuario no tiene acceso a su aplicación de código. Usa el mensaje para explicar cómo solicitar acceso, como ponerse en contacto con un administrador.

Important

El texto personalizado no concede acceso ni cambia los permisos de la aplicación. Para conceder acceso, comparta la aplicación con el usuario mediante pa app share.

Ejecute el siguiente comando desde un proyecto de aplicación de código inicializado que contenga un power.config.json archivo:

pa app set-setting --customize-request-access true --request-access-title "Request access" --request-access-message "Contact your administrator to request access."

Para configurar el texto de forma interactiva, ejecute pa app set-setting sin establecer marcas y seleccione customize-request-access. Elija si quiere habilitar la personalización. Al habilitarlo, escriba el título y el mensaje en las indicaciones. Al deshabilitarlo, el comando omite las indicaciones de contenido y conserva el título y el mensaje guardados.

Revise la configuración local y, a continuación, publique la aplicación para aplicar los cambios:

pa app get-settings
pa app push

Use pa app get-settings --json para leer la configuración como JSON.

Para deshabilitar la personalización, ejecute los siguientes comandos. Deshabilitar la personalización conserva el título y el mensaje guardados para su uso posterior.

pa app set-setting --customize-request-access false
pa app push

Configuración de la aplicación en power.config.json

La CLI almacena la visibilidad del encabezado y la personalización de acceso a solicitudes en el appSettings objeto de power.config.json. Por ejemplo, la siguiente configuración oculta el encabezado y habilita el texto de acceso a solicitudes personalizado:

{
  "appSettings": {
    "showHeader": false,
    "customizeRequestAccess": {
      "enabled": true,
      "title": "Request access",
      "messageBody": "Contact your administrator to request access."
    }
  }
}

Ambas opciones son opcionales. Usa pa app set-setting para actualizarlos.

Property Requisitos y comportamiento predeterminado
showHeader Valor booleano. Si se omite, se muestra el encabezado .
customizeRequestAccess.enabled Valor booleano. Si se omite, la personalización está deshabilitada.
customizeRequestAccess.title Obligatorio cuando la personalización está habilitada. No debe estar en blanco ni tener más de 100 caracteres. Opcional cuando está deshabilitado, pero cualquier valor proporcionado debe cumplir los mismos requisitos.
customizeRequestAccess.messageBody Obligatorio cuando la personalización está habilitada. No debe estar en blanco y no debe tener más de 1000 caracteres. Opcional cuando está deshabilitado, pero cualquier valor proporcionado debe cumplir los mismos requisitos.

pa app set-setting actualiza solo los campos especificados y conserva los campos omitidos y la configuración no relacionada. Valida la configuración combinada antes de guardarla. Puede reemplazar los valores de campo guardados no válidos proporcionando valores válidos, pero se rechazan los contenedores de configuración con formato incorrecto o un resultado que todavía contiene valores no válidos. pa app push valida también la configuración antes de publicarla.

  • Darrera actualització el