Implementar e instalar complementos de Qlik para Microsoft Office

Implemente e instale complementos de Qlik para Microsoft Office con el fin de permitir a los usuarios de su organización que puedan crear plantillas de informes. Cargue plantillas de informes creadas con los complementos en la app de Qlik Cloud para generar informes a partir de tareas de informes.

Los complementos de Qlik para Microsoft Office se pueden implementar e instalar para versiones web y de escritorio compatibles con Excel, PowerPoint y Word dentro de Microsoft 365.

Los complementos se instalan mediante un archivo de manifiesto. Este archivo de manifiesto es necesario para que el administrador de Microsoft 365 (o posiblemente un usuario, en ciertos métodos de instalación) implemente e instale complementos para sí mismo o para los usuarios de su organización.Un archivo de manifiesto permite la instalación de complementos para un solo espacio empresarial inquilino en Qlik Cloud.

Una vez obtenido el archivo de manifiesto o la URL, existen dos métodos diferentes para implementar e instalar complementos:

• Implementación centralizada: Implementación, instalación y activación centralizadas

• Carga lateral:Instalar complementos mediante descarga local o uso compartido de red

Para más información, vea Diseñar plantillas de informes con complementos de Qlik para Microsoft Office.

Requisitos de software y del sistema

Nota de Qlik Cloud Government

Los complementos de Qlik para Microsoft Office son compatibles para desarrollar plantillas de informe con aplicaciones en espacios empresariales inquilinos de Qlik Cloud Government o Qlik Cloud Government - DoD. Los complementos están disponibles únicamente para Office 365 Commercial.

Para instalar y usar los complementos de Qlik, debe cumplir con los siguientes requisitos.

complemento de Qlik para Microsoft Excel

Para instalaciones de Windows:

• Windows 10 v.1903 o superior

• Microsoft 365 v.16.0.11629 o superior

Para instalaciones de macOS:

• macOS v.14 o superior

• Microsoft 365 v.16.83 o superior

Además, para ejecutar el complemento de Qlik para Microsoft Excel, debe tener una instalación de Microsoft Excel con ExcelAPI 1.9 o posterior. Para comprobar si su instalación cumple con los requisitos de Excel, consulte la documentación oficial de Microsoft en Conjuntos de requisitos de la API de JavaScript de Excel.

Si su ExcelAPI es inferior a la versión mínima requerida, se muestra un error que indica que el complemento de Qlik requiere una versión más reciente de Microsoft Excel.

Es posible que deba hacer clic en el área en blanco a la derecha de Microsoft Excel y pulsar F5 para actualizar la página y ver el error.

Si ve este error, actualice su instalación de Microsoft Excel.

complemento de Qlik para Microsoft PowerPoint

Para instalaciones de Windows:

• Windows 10 v.1903 o superior

• Microsoft 365 versión 2504 (compilación 18730.20030) o superior

Para instalaciones de macOS:

• macOS v.14 o superior

• Microsoft 365 v.16.96 o superior

complemento de Qlik para Microsoft Word

Para instalaciones de Windows:

• Windows 10 v.1903 o superior

• Microsoft 365 versión 2208 (compilación 15601.20148) o superior

Para instalaciones de macOS:

• macOS v.14 o superior

• Microsoft 365 v.16.64 o superior

Preparación y obtención del manifiesto del complemento

Los complementos de Qlik para Microsoft Office se instalan en el entorno de Microsoft mediante un archivo de manifiesto. Este es un archivo XML. Para lograr una implementación centralizada, es probable que el administrador de Microsoft deba proporcionarle una URL al archivo de manifiesto.

Un archivo de manifiesto es específico de un único espacio empresarial inquilino de Qlik Cloud. Utiliza el mismo archivo de manifiesto para instalar los complementos para Excel, PowerPoint y Word.

Se requiere una configuración de cliente OAuth para instalar el complemento. Una vez que haya configurado el cliente OAuth, obtenga el enlace del archivo de manifiesto, así como el propio archivo de manifiesto, en el centro de actividades Administración.

Haga lo siguiente:

1. Cree el cliente de OAuth en el espacio empresarial inquilino de Qlik Cloud utilizando la configuración requerida. Para ver instrucciones detalladas, consulte Creación de clientes de OAuth para complementos de Qlik para Microsoft Office.

2. Navegue hasta el centro de actividades Administración y genere el enlace del manifiesto. También puede descargar el archivo de manifiesto directamente para casos de uso alternativos. Vea Administrar los manifiestos de instalación para los complementos de Qlik para Microsoft Office.

Creación de clientes de OAuth para complementos de Qlik para Microsoft Office

Se requiere una configuración de cliente OAuth para instalar los complementos de Qlik para Microsoft Office. Los complementos los utilizan los desarrolladores de informes para preparar plantillas de informe para la generación de informes en la aplicación con Qlik Cloud.

Para que OAuth funcione en los complementos, el cliente de OAuth debe configurarse con la configuración exacta que se muestra a continuación.

Haga lo siguiente:

1. En el centro de actividades Administración, en Qlik Cloud, vaya a OAuth.

2. Haga clic en Crear nuevo.

3. En el menú desplegable Tipo de cliente, seleccione App de una sola página. Aparecerán más campos.

4. Inserte un Nombre. La Descripción es opcional.

5. Como mínimo, marque la casilla de verificación para incluir el ámbito user_default. Puede incluir otros ámbitos en la configuración, pero sin user_default, la instalación no funcionará.

   Vea Ámbitos de OAuth disponibles para obtener una descripción completa de cada ámbito disponible.

6. En el campo Agregar las URL de redireccionamiento, inserte la URL del espacio empresarial inquilino de Qlik Cloud, seguida de esta cadena de texto fija: /office-add-ins/oAuthLoginSuccess.html

   El resultado debería presentar el siguiente aspecto: https://<tenant or alias hostname>.<region>.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html. Por ejemplo: http://ejemplo-empresa-123.us.qlikcloud.com/office-add-ins/oAuthLoginSuccess.html

7. Haga clic en Añadir.

8. En el campo Agregar orígenes permitidos, inserte la URL de su espacio inquilino y haga clic en Agregar.

9. Haga clic en Crear.

10. Aparecerá la ventana Copie su ID de cliente. Puede optar por copiar el ID del cliente al portapapeles o hacer clic en Hecho para cerrar la ventana.

Tras crear el cliente OAuth, obtenga el enlace XML del manifiesto actualizado en el centro de actividades Administración. Vaya a la página Configuración y seleccione la pestaña Correo electrónico e informes. En la sección Compartir e informes, seleccione los complementos de Qlik para Microsoft Office. Utilice el enlace proporcionado para implementar e instalar el complemento.

Implementación, instalación y activación centralizadas

Se recomienda que los complementos de Qlik para Microsoft Office estén disponibles con implementación e instalación centralizadas. La implementación centralizada requiere la intervención de un administrador de Microsoft 365 de su organización.

Con la implementación centralizada, el manifiesto del complemento se carga en el centro de administración de Microsoft 365 de su organización y se distribuye a los usuarios como una instalación preconfigurada. La distribución puede restringirse a los miembros de determinados grupos de seguridad.

Debe utilizar el despliegue centralizado cuando:

• Desea que el complemento se instale de forma permanente para los miembros de su organización

• Desea gestionar la distribución a los miembros de su organización

Siga las secciones de procedimiento a continuación para conocer el flujo de trabajo completo.

Implementación e instalación centralizadas

La implementación centralizada la completa un administrador del sistema Microsoft 365.

Haga lo siguiente:

1. Obtenga el archivo de manifiesto del complemento o la URL del manifiesto después de crear un cliente OAuth. Consulte Preparación y obtención del manifiesto del complemento.

2. Distribuya el complemento según la documentación oficial de Microsoft: Implementar y publicar complementos de Office. Tenga en cuenta que la distribución mediante implementación centralizada solo es posible mediante el centro de administración de Microsoft 365.

Con el procedimiento anterior, los complementos se instalan para los usuarios a los que se les da acceso a ellos. Los usuarios activan entonces los complementos en su versión de Excel, PowerPoint o Word.

Para instalar complementos en una versión de escritorio de Excel, PowerPoint o Word sin implementación centralizada, puede configurar un recurso compartido de red y cargar el manifiesto en él. Esto sólo se puede hacer en un sistema operativo Windows.

Activar un complemento después de la implementación centralizada

Después de que un administrador de Microsoft haya instalado un complemento de Qlik para su organización, podrá activarlo y usarlo si se le ha dado acceso.

Dependiendo de la versión de su aplicación de Microsoft Office, estos pasos podrían variar ligeramente. Consulte la documentación oficial de Microsoft para ver todos los detalles.

Haga lo siguiente:

1. Abra una versión de escritorio o web de Excel, PowerPoint o Word.

2. Vaya a Inicio > Complementos > Obtener complementos.

3. En la pestaña ADMIN MANAGED del cuadro de diálogo, seleccione el complemento Qlik.

El icono del complemento de Qlik se agrega a la barra de su cinta de opciones.

Ver, administrar e instalar complementos para Excel, PowerPoint y Word

Retirar un complemento

Si su instalación utiliza una implementación centralizada, es posible que no pueda desinstalar el complemento. Esto depende de la política utilizada por su administrador de Microsoft 365.

Instalar complementos mediante descarga local o uso compartido de red

La descarga local y la instalación de recursos compartidos de red son formas adecuadas de obtener acceso rápidamente a los complementos con fines de prueba o ensayo. No son métodos adecuados para implantar complementos en casos de producción y uso a escala empresarial.

Dependiendo de su versión de Excel, PowerPoint o Word, así como de otros factores, es posible que los complementos cargados con estos métodos se eliminen de la barra de opciones en última instancia. Cuando esto suceda, vuelva a cargar el manifiesto en la aplicación de Microsoft Office.

Opción 2: instale un complemento en aplicaciones de escritorio de Microsoft Office usando un recurso compartido en red de Windows

Para instalar complementos en una versión de escritorio de Excel, PowerPoint o Word sin implementación centralizada, puede configurar un recurso compartido de red y cargar el manifiesto en él. Esto sólo se puede hacer en un sistema operativo Windows.

Siga las instrucciones a continuación para cargar complementos a través de una red compartida. Las instrucciones están adaptadas de la documentación oficial de Microsoft. Vea Carga local de complementos de Office para realizar pruebas desde un recurso compartido de red u otros recursos de Microsoft para obtener más información.

Paso 1: Crear y compartir una carpeta

Haga lo siguiente:

1. Cree una carpeta para alojar el complemento de Qlik. Por ejemplo: C:\Qlik Office add-ins

2. En el Explorador de archivos de Windows, vaya a la carpeta principal, o letra de unidad, de la carpeta que desea utilizar como catálogo de carpetas compartidas. Por ejemplo: C:\

3. Haga clic con el botón derecho en la carpeta y seleccione Propiedades.

4. Abra la pestaña Compartir y luego haga clic en el botón Compartir....

   

5. En la ventana de diálogo, añádase a sí mismo y a cualquier otro usuario y/o grupo con el que desee compartir su complemento. Necesitará al menos permiso de Lectura/Escritura en la carpeta. Cuando haya terminado de elegir a las personas con las que compartir, haga clic en Compartir.

6. Cuando vea la confirmación de que su carpeta ha sido compartida, tome nota de la ruta de red completa que aparece inmediatamente después del nombre de la carpeta. Haga clic en Hecho para cerrar la ventana del cuadro de diálogo.

   

7. Haga clic en Cerrar para cerrar la ventana de diálogo Propiedades.

Configure manualmente la carpeta compartida como un catálogo fiable

Haga lo siguiente:

1. Abra un nuevo libro en blanco en la versión de escritorio de Excel, PowerPoint o Word.

2. Haga clic en la pestaña Archivo y luego haga clic en Opciones en la esquina inferior izquierda.

3. Haga clic en Centro de confianza y luego haga clic en el botón Configuración del centro de confianza....

   

4. Haga clic en Catálogos de complementos de confianza.

   

5. En el recuadro Catalog URL, indique la ruta completa de red a la carpeta que compartió anteriormente.

6. Haga clic en Añadir catálogo.

7. Marque la casilla de verificación Mostrar en el menú para el elemento recién agregado y luego haga clic en Aceptar para cerrar la ventana de diálogo del Centro de confianza.

   

8. Haga clic en Aceptar para cerrar la ventana del diálogo.

9. Cierre y vuelva a abrir la aplicación para que los cambios surtan efecto.

Paso 3: carga lateral del complemento

Haga lo siguiente:

1. Agregue el archivo XML de manifiesto del complemento a la carpeta compartida.

2. En ExcelPowerPoint o Word, haga clic en Complementos en la pestaña Inicio de la cinta de opciones.

3. Haga clic en Más complementos.

4. Haga clic en SHARED FOLDER en la parte superior del cuadro de diálogo Complementos de Office.

5. Seleccione Qlik para insertar el complemento.

6. Es posible que vea una ventana de diálogo que diga algo como lo siguiente: Qlik desea mostrar una nueva ventana. Haga clic en Permitir.

Eliminar un complemento instalado a través del recurso compartido de red

Haga lo siguiente:

1. Si tiene Excel, PowerPoint o Word abierto, ciérrelo.

2. Elimine el contenido de esta carpeta: %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\

Opción 3: cargar un complemento de forma lateral en aplicaciones de escritorio de macOS

Para macOS, los complementos se pueden instalar en versiones de escritorio de Excel, PowerPoint o Word en Microsoft 365. Para los requisitos del sistema y del software, consulte Requisitos de software y del sistema.

Siga las directrices siguientes. Las instrucciones están adaptadas de la documentación oficial de Microsoft. Para obtener instrucciones completas, consulte la documentación oficial de Microsoft: Descargar un complemento en Office en Mac

Haga lo siguiente:

1. Abra la aplicación Finder en su computadora.

2. Escriba la siguiente combinación de teclado: Comando+Mayús+G

   Se abre el menú Ir a la carpeta.

3. Inserte una de las siguientes rutas dependiendo de la aplicación de Microsoft Office:

   • Excel: /Users/<username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

   • PowerPoint: /Users/<username>/Library/Containers/com.microsoft.Powerpoint/Data/Documents/wef

   • Word: /Users/<username>/Library/Containers/com.microsoft.Word/Data/Documents/wef

   Podría suceder que la carpeta wef aún no exista en su computadora. Si es así, créela en esta ubicación.

4. En la carpeta wef, agregue una copia del archivo de manifiesto XML.

5. Abra Excel, PowerPoint o Word. Si ya lo tiene abierto, tendrá que reiniciarlo.

6. En la barra de opciones, navegue hasta Inicio > Complementos.

7. Seleccione el complemento Qlik.

El complemento Qlik ahora debería estar disponible en la barra de opciones.

Eliminar un complemento descargado de las aplicaciones de escritorio de macOS

Para eliminar el complemento de Qlik, debe borrar el caché de Office de su computadora. Para más información, vea:

• Eliminar un complemento descargado

• Borrar la caché de Office

Resolución de problemas

Esta sección ofrece sugerencias para resolver problemas habituales de implementación e instalación.

Para obtener consejos adicionales en la resolución de problemas, consulte Resolución de problemas: informes en la app.

Se muestra un cuadro de diálogo en blanco durante la autenticación después de la implementación de un complemento de Qlik para Microsoft Office

Cuando un usuario trata de autenticarse en un complemento de informes para Microsoft Excel, Microsoft PowerPoint o Microsoft Word, su cuadro de diálogo emergente de autenticación puede estar en blanco. En ese caso, el usuario podría ver un error en el cuadro de diálogo (en particular, 12006).

Para que un usuario trabaje con un complemento de Qlik para Microsoft Office, el flujo de autenticación requiere una redirección entre su espacio empresarial inquilino y el proveedor de identidad alojado en un dominio diferente. Su proveedor de identidad está configurando Cross-Origin-Opener-Policy con una configuración restrictiva. Como resultado, la parte de comunicación entre dominios del flujo de autenticación se bloquea, lo que impide que la información de inicio de sesión se devuelva correctamente al complemento.

Acción propuesta  

La solución siguiente debe ser aplicada por un administrador de red responsable de configurar los proveedores de identidad.

Haga lo siguiente:

• Configure el encabezado de respuesta de su IDP a su cuadro de diálogo en:

  Cross-Origin-Opener-Policy: unsafe-none

Para más información, consulte la documentación oficial de Microsoft: Prácticas recomendadas y reglas para la API de diálogo de Office