Automatización de la instalación de aplicaciones de plantilla con Azure

Automatice la instalación de aplicaciones de plantilla para simplificar el proceso de implementación de Power BI para los clientes. Las aplicaciones de plantilla proporcionan informes creados previamente que se conectan a los datos del cliente, pero la configuración manual puede ser difícil para los usuarios que no están familiarizados con los detalles de conexión.

En este tutorial se muestra a los proveedores de servicios de datos cómo automatizar la configuración de parámetros de la aplicación de plantilla mediante Azure Functions. Cuando los clientes hacen clic en un vínculo preconfigurado, la automatización recopila información necesaria, establece parámetros y los redirige para instalar la aplicación, lo que requiere solo la autenticación para completar la configuración.

Cuando el cliente inicia sesión en el portal, selecciona un vínculo especial que ha preparado. Este vínculo:

• Inicia la automatización, que recopila la información que necesita.
• Preconfigura los parámetros de la aplicación de plantilla.
• Redirige al cliente a su cuenta de Power BI, donde puede instalar la aplicación.

Lo único que tienen que hacer es seleccionar Instalar y autenticarse con su origen de datos, ¡y estarán listos para comenzar!

Aquí se muestra la experiencia del cliente.

En este tutorial, usará un ejemplo de instalación automatizada con Azure Functions que hemos creado para preconfigurar e instalar su aplicación plantilla. Este ejemplo se ha mantenido deliberadamente sencillo con fines de demostración. Encapsula la configuración de una función de Azure para usar las API de Power BI para instalar una aplicación de plantilla y configurarla automáticamente para los usuarios.

Para obtener más información sobre el flujo de automatización general y las API que usa la aplicación, consulte Automatización de la configuración de una instalación de aplicaciones de plantilla.

Nuestra aplicación sencilla usa una función de Azure. Para más información sobre Azure Functions, consulte la documentación de Azure Functions.

Flujo básico

En el siguiente flujo básico se muestra lo que hace la aplicación cuando el cliente lo inicia seleccionando el vínculo en el portal.

1. El usuario inicia sesión en el portal del ISV y selecciona el vínculo proporcionado. Esta acción inicia el flujo. El portal del ISV prepara la configuración específica del usuario en esta fase.
2. El ISV adquiere un token de aplicación únicamente basado en un principal de servicio (token de aplicación únicamente) registrado en el arrendatario del ISV.
3. Usando las API REST de Power BI, el ISV crea un ticket de instalación, que contiene la configuración de parámetros específicos del usuario según lo preparado por el ISV.
4. El ISV redirige al usuario a Power BI mediante un POST método de redireccionamiento, que contiene el vale de instalación.
5. El usuario se redirige a su cuenta de Power BI con el vale de instalación y se le pide que instale la aplicación de plantilla. Cuando el usuario selecciona Instalar, la aplicación de plantilla se instala para ellos.

Prerrequisitos

• Configuración de tu propia entidad de Microsoft Entra. Para obtener instrucciones sobre cómo configurar una, consulte Creación de un inquilino de Microsoft Entra.
• Una entidad de servicio (token de solo aplicación) registrada en el inquilino anterior.
• Una aplicación de plantilla parametrizada que está lista para la instalación. La aplicación de plantilla debe crearse en el mismo entorno en el que registre la aplicación en Microsoft Entra ID. Para más información, consulte Sugerencias para crear aplicaciones de plantilla o Crear una aplicación de plantilla en Power BI.
• Para poder probar el flujo de trabajo de automatización, agregue el principal de servicio al área de trabajo de la aplicación de modelo como Admin.
• Una licencia de Power BI Pro. Si no está registrado en Power BI Pro, regístrese para obtener una evaluación gratuita antes de comenzar.

Configuración del entorno de desarrollo de automatización

Antes de continuar con la configuración de la aplicación, siga las instrucciones de Inicio rápido: Creación de una aplicación de Azure Functions con Azure App Configuration para desarrollar una función de Azure junto con una configuración de aplicaciones de Azure. Cree la configuración de la aplicación como se describe en el artículo.

Registro de una aplicación en Microsoft Entra ID

Cree un principal de servicio como se describe en Incrustar contenido de Power BI con un principal de servicio y un secreto de aplicación.

Asegúrese de registrar la aplicación como una aplicación web del lado servidor. Registre una aplicación web del lado servidor para crear un secreto de aplicación.

Guarde el identificador de aplicación (ClientID) y el secreto de aplicación (ClientSecret) para los pasos posteriores.

Agregue el principal de servicio al área de trabajo de la aplicación de plantilla como administrador para poder probar el flujo de trabajo de automatización.

Preparación de la aplicación de plantilla

Después de crear la aplicación de plantilla y de que esté lista para la instalación, guarde la siguiente información para los pasos siguientes:

• Id. de aplicación, clave de paquete e identificador de propietario tal como aparecen en la dirección URL de instalación al final de define las propiedades del proceso de aplicación de plantilla cuando se creó la aplicación.

  También puede obtener el mismo vínculo seleccionando Obtener vínculo en el panel de Administración de versiones de la aplicación de plantilla.

• Nombres de parámetro a medida que se definen en el modelo semántico de la aplicación de plantilla. Los nombres de parámetros son cadenas de caracteres que distinguen entre mayúsculas y minúsculas. También se pueden recuperar desde la pestaña Configuración de parámetros al definir las propiedades de la aplicación de plantilla o desde la configuración del modelo semántico en Power BI.

Instalación y configuración de la aplicación de plantilla

En esta sección, usarás una muestra de instalación automatizada de Azure Functions que hemos creado para preconfigurar e instalar tu aplicación de plantilla. Este ejemplo se ha mantenido deliberadamente sencillo con fines de demostración. Permite usar una función de Azure y Azure App Configuration para implementar y usar fácilmente la API de instalación automatizada para las aplicaciones de plantilla.

Descargar Visual Studio

Descargue Visual Studio (versión 2017 o posterior). Asegúrese de descargar el paquete NuGet más reciente.

Descarga del ejemplo de instalación automatizada de Azure Functions

Descargue el ejemplo de Instalación automatizada de Azure Functions de GitHub para empezar a trabajar.

Configuración de la configuración de la aplicación de Azure

Para ejecutar este ejemplo, debe configurar la configuración de la aplicación de Azure con los valores y claves, tal como se describe aquí. Las claves son el identificador de aplicación, el secreto de aplicación y los valores appId, packageKey y ownerId de la aplicación de plantilla. Consulte las secciones siguientes para obtener información sobre cómo obtener estos valores.

Las claves también se definen en el archivo Constants.cs .

El archivo Constants.cs se muestra aquí.

Obtener las propiedades de la aplicación de plantilla

Rellene todas las propiedades de la aplicación de plantilla pertinentes a medida que se definen cuando se crea la aplicación. Estas propiedades son los valores appId, packageKey y ownerId de la aplicación de plantilla.

Para obtener los valores anteriores, siga estos pasos:

1. Inicie sesión en Power BI.

2. Vaya al área de trabajo original de la aplicación.

3. Abra el panel Administración de versiones .

   

4. Seleccione la versión de la aplicación y obtenga su vínculo de instalación.

   

5. Copie el vínculo en el Portapapeles.

   

6. Esta dirección URL de instalación contiene los tres parámetros de dirección URL cuyos valores necesita. Use los valores appId, packageKey y ownerId de la aplicación. Una dirección URL de ejemplo será similar a la que se muestra aquí.

   https://app.powerbi.com/Redirect?action=InstallApp&appId=66667...9cccc0000&packageKey=b2df4b...dLpHIUnum2pr6k&ownerId=aaaa...22222&buildVersion=5
   

Obtención del identificador de aplicación

Rellene la información de applicationId con el identificador de aplicación de Azure. La aplicación usa el valor applicationId para identificarse a los usuarios desde los que solicita permisos.

Para obtener el identificador de aplicación, siga estos pasos:

1. Inicie sesión en Azure Portal.

2. En el menú del portal, seleccione Todos los servicios.

3. En la página Todos los servicios, en la sección Identidad , seleccione >Registros de aplicaciones.

4. Seleccione la aplicación que necesita el identificador de la aplicación.

   

5. Hay un identificador de aplicación que aparece como GUID. Use este identificador de aplicación como valor applicationId para la aplicación.

   

Obtén el secreto de la aplicación

Rellene la información de ApplicationSecret de la sección Claves de la sección Registros de aplicaciones en Azure. Este atributo funciona cuando se usa el principal de servicio.

Para obtener el secreto de aplicación, siga estos pasos:

1. Inicie sesión en Azure Portal.

2. En el menú del portal, seleccione Todos los servicios.

3. En la página Todos los servicios, en la sección Identidad , seleccione >Registros de aplicaciones.

   

4. Seleccione Certificados y secretos en Administrar.

5. Seleccione Nuevo secreto de cliente.

6. Escriba un nombre en el cuadro Descripción y seleccione una duración. A continuación, seleccione Agregar para obtener el valor de la aplicación, que verá en el encabezado Valor del secreto de cliente.

Prueba local de la función

Siga los pasos descritos en Ejecución de la función localmente para ejecutar la función.

Configura tu portal para emitir una POST solicitud a la dirección URL de la función. Un ejemplo es POST http://localhost:7071/api/install. El cuerpo de la solicitud debe ser un objeto JSON que describe los pares clave-valor. Las claves son nombres de parámetro tal como se definen en Power BI Desktop. Los valores son los valores deseados que se van a establecer para cada parámetro de la aplicación de plantilla.

El flujo deseado debe ser:

1. El portal prepara la solicitud, por usuario o sesión.
2. La POST /api/install solicitud se envía a la función de Azure. El cuerpo de la solicitud consta de pares clave-valor. La clave es el nombre del parámetro. El valor es el valor deseado que se va a establecer.
3. Si todo está configurado correctamente, el explorador debería redirigir automáticamente a la cuenta de Power BI del cliente y mostrar el flujo de instalación automatizado.
4. Tras la instalación, los valores de parámetro se establecen como configurados en los pasos 1 y 2.

Publicación del proyecto en Azure

Para publicar el proyecto en Azure, siga las instrucciones de la documentación de Azure Functions. A continuación, puede integrar las API de instalación automatizada de aplicaciones de plantilla en el producto y empezar a probarlas en entornos de producción.

Contenido relacionado

• Automatización de la configuración de una instalación de aplicaciones de plantilla
• Creación de una aplicación de plantilla en Power BI
• Sugerencias para crear aplicaciones de plantilla
• Incrustar contenido de Power BI con un principal de servicio y un secreto de aplicación