Integrar Power BI

Integre con Power BI para hacer seguimiento de informes y paneles importantes en Citrix Workspace.

Utilice el siguiente proceso para habilitar la integración de Power BI. Compruebe que cumple los requisitos previos y proporcione los detalles de conexión. Después de completar este proceso, el nivel existente de registros de auditoría persiste, incluidas las acciones llevadas a cabo por el uso de microaplicaciones de Citrix.

Para obtener una lista completa de las microaplicaciones de Power BI de uso inmediato, consulte Usar microaplicaciones de Power BI.

Revisar requisitos previos

Debe tener una cuenta de servicio de Power BI. Para obtener más información, vaya a https://powerbi.microsoft.com/en-us/landing/signin/. Para que cualquier informe pueda compartirse a través de las microaplicaciones de Citrix, el informe debe compartirse con la cuenta de servicio de Power BI.

Dependiendo de la configuración, posiblemente se necesiten dos cuentas:

• Una cuenta con permisos para crear un registro de aplicaciones en Azure AD. Esta cuenta puede ser problemática, dependiendo de con qué suscripción/arrendatario se asocie primero.
• Una cuenta de servicio que sirve para autenticar la integración.

En estos requisitos previos, se presupone que usted administra la instancia de Power BI de su organización para configurar la integración. La cuenta de servicio debe tener los siguientes permisos API asignados con tipo Delegado:

Tras configurar esta integración en Power BI, necesitará estos artefactos para agregar la integración en las microaplicaciones de Citrix Workspace:

• ID de cliente
• Secreto del cliente
• Autorización de OAuth

Registre su aplicación

Vaya a https://dev.powerbi.com/apps y registre su aplicación en Azure AD para permitir a esta acceder a las API de REST de Power BI y establecer permisos de recursos para la aplicación. A través de este proceso de registro, crea su ID de cliente y el secreto de cliente.

La primera respuesta que aparece en la lista no cambia. La segunda respuesta depende de la aplicación de destino, y se puede encontrar en la barra de direcciones URL al crear la integración. La sección {yourmicroappserverurl} se compone de una parte de arrendatario, una parte de región y una parte de entorno: https://{tenantID}.{region(us/eu/ap-s)}.iws.cloud.com.

Solo puede registrar una URL en el primer campo. Introduzca una dirección URL en la página de registro de Server-side web application. A continuación, vaya a Registro de aplicaciones de Azure AD para agregar la segunda dirección URL.

1. Introduzca un nombre para su aplicación.
2. Seleccione Server-side web application.
3. Introduzca la URL de la página de inicio de su aplicación en Home Page URL. Este valor debe ser la URL del arrendatario de Citrix Cloud (la URL del servidor de microaplicaciones). Por ejemplo, https://<customer_id>.us.iws.cloud.com. Puede encontrar esta URL del servidor de microaplicaciones en la barra de URL al iniciar sesión en Microaplicaciones de Citrix.

4. Introduzca una de las siguientes URL de redirección: https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback https://{yourmicroappserverurl}/admin/api/gwsc/auth/serverContext

   Nota:

   No se admiten dos URL en este campo. Vaya a Registro de aplicaciones de Azure AD para agregar la segunda dirección URL.

5. Marque todas las casillas de verificación de las API de solo lectura.
6. Seleccione Register.

7. Vaya a Azure App Registrations > Authentication e introduzca la segunda URL de respuesta.

   

Agregar la integración a las microaplicaciones de Citrix Workspace

Agregue la integración de Power BI a las microaplicaciones de Citrix Workspace para conectarse a la aplicación. Esto proporciona microaplicaciones de uso inmediato con notificaciones y acciones preconfiguradas que se pueden usar desde ya en su espacio de trabajo.

Siga estos pasos:

1. En la página Integraciones de microaplicaciones, seleccione Agregar nueva integración y Agregar una nueva integración a partir de plantillas proporcionadas por Citrix.
2. Seleccione el mosaico de Power BI.
3. En el campo Nombre de la integración, introduzca un nombre para la misma.
4. Introduzca los parámetros del conector.
   • Introduzca la URL base de la instancia: https://api.powerbi.com/v1.0/myorg
   • Seleccione un icono para la integración en la Biblioteca de iconos, o deje el icono predeterminado del directorio de ServiceNow.
   • Si está creando una conexión local, habilite la opción Instancia local. Para obtener más información, consulte Instancia local.

5. En Autenticación de servicio, seleccione OAuth 2.0 en el menú Método de autenticación y complete los detalles correspondientes. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso. Utilice el protocolo de seguridad de OAuth 2.0 para generar tokens de solicitud/autorización para el acceso delegado. Se recomienda utilizar OAuth 2.0 como método de autenticación del servicio siempre que esté disponible. OAuth 2.0 garantiza que la integración es conforme a los requisitos de seguridad más estrictos con la microaplicación configurada.

   1. Seleccione Código de autorización en el menú Tipo de concesión. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se muestra la URL de respuesta, que utiliza al registrar su aplicación
   2. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
   3. La URL de autorización se rellena automáticamente: https://login.microsoftonline.com/{tenantID}/oauth2/authorize
   4. La URL del token se rellena automáticamente: https://login.microsoftonline.com/{tenantID}/oauth2/token
   5. Compruebe que se ha introducido lo siguiente para el Ámbito: Tenant.Read.All
   6. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el servidor de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
   7. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
   8. En Parámetros del token de Access, compruebe que se ha especificado lo siguiente para Nombre: resource, y para Valor: https://analysis.windows.net/powerbi/api.

6. En Autenticación de acciones de servicio, habilite la opción Usar autenticación de usuario independiente en Acciones. La autenticación de acciones de servicio autentica en el nivel de acción de servicio. Las opciones de autenticación están preseleccionadas. Compruebe que estas opciones estén seleccionadas a medida que complete el proceso.

   1. En el menú Método de autenticación, seleccione OAuth 2.0 y complete los detalles de autenticación.
   2. Seleccione Código de autorización en el menú Tipo de concesión. De esta manera, se concede un código temporal que el cliente intercambia por un token de acceso. El código se obtiene del servidor de autorización, donde se puede ver la información que solicita el cliente. Solo este tipo de concesión permite la suplantación segura de usuarios. Se mostrará la URL de respuesta, que utiliza al registrar su aplicación.
   3. Seleccione Cuerpo de la solicitud en el menú Autorización de token.
   4. La URL de autorización se rellena automáticamente: https://login.microsoftonline.com/{tenantID}/oauth2/authorize
   5. La URL del token se rellena automáticamente: https://login.microsoftonline.com/{tenantID}/oauth2/token
   6. Compruebe que se ha introducido lo siguiente para el Ámbito: Tenant.Read.All
   7. Introduzca su ID de cliente. El ID de cliente es la cadena que representa la información de registro del cliente exclusiva del servidor de autorización. Obtendrá este y el secreto al configurar el cliente de OAuth. Deberá agregar la URL de respuesta que aparece en la página de configuración de la integración.
   8. Introduzca su Secreto del cliente. El secreto del cliente es la cadena única emitida al configurar la integración de la aplicación de destino.
   9. En Parámetros del token de Access, compruebe que se ha especificado lo siguiente para Nombre: resource, y para Valor: https://analysis.windows.net/powerbi/api.
7. (Optativo) Si quiere activar la limitación de solicitudes para esta integración, habilite la opción Limitación del índice de solicitudes y establezca la Cantidad de solicitudes por Intervalo de tiempo.

8. (Optativo) Habilite la opción Registro para conservar un registro de 24 horas con fines de asistencia.

   

9. Seleccione Guardar para continuar.
10. En Autorización de OAuth, seleccione Autorizar para iniciar sesión con su cuenta de servicio. Aparecerá una ventana emergente con una pantalla de inicio de sesión de Power BI.
    1. Introduzca el nombre de usuario y la contraseña de su cuenta de servicio y seleccione Iniciar sesión.
    2. Seleccione Aceptar.

Se abrirá la página Integraciones de microaplicaciones con la integración agregada y sus microaplicaciones. Desde aquí, puede agregar otra integración, seguir configurando sus microaplicaciones de uso inmediato o crear una nueva microaplicación para esta integración.

Ya tiene todo listo para configurar y llevar a cabo su primera sincronización de datos. Para obtener información completa acerca de las reglas de sincronización, la sincronización que no cumple con sus reglas de programación y las reglas de veto, consulte Sincronizar datos.

Para obtener más información sobre los dispositivos de punto final de las API y las entidades de tabla, consulte Especificaciones del conector de Power BI.

Usar microaplicaciones de Power BI

Las integraciones de las aplicaciones web o SaaS existentes vienen con microaplicaciones de uso inmediato. Comience con estas microaplicaciones y personalícelas conforme a sus exigencias.

Nuestra plantilla de integración de Power BI incluye las siguientes microaplicaciones preconfiguradas de uso inmediato:

Paneles: Sirve para ver los detalles de los paneles de Power BI. La lista de paneles es personalizada, por lo que solo puede ver los paneles que forman parte de Citrix Workspace en Power BI.

Informes: Permite ver detalles de los informes de Power BI. Las listas de informes son personalizadas, por lo que solo puede ver los informes que forman parte de Citrix Workspace en Power BI.