Cargar y administrar las extensiones de visualización
Las extensiones añaden capacidades de visualización personalizadas a las aplicaciones de Qlik Cloud. Puede cargar y administrar las extensiones dede el centro de actividades Administración.
Uso de extensiones
Las extensiones de visualización en Qlik Cloud añaden nuevos componentes visuales más allá de las visualizaciones estándar. Utilícelas para personalizar cómo presentar y explorar los datos.
Para obtener más información, consulte Desarrollador de Qlik: Ampliación de Qlik. Para una demostración visual, vea Uso de extensiones de visualización de terceros en Qlik Cloud y Extensiones y claves de API.
Roles requeridos
Para cargar y administrar extensiones, debe tener uno de los siguientes roles:
-
Administrador de espacio empresarial inquilino
-
Administrador de análisis
-
Rol personalizado con el permiso Administrar extensiones configurado en Permitido
Requisitos y límites de los archivos
Siga estas reglas para asegurarse de que su extensión se cargue y funcione correctamente.
Límites de archivo
Los archivos ZIP de extensión tienen los siguientes límites:
-
Tamaño máximo de archivo ZIP: 30 MB
-
Tamaño máximo para cualquier archivo individual en el ZIP: 30 MB
-
Número máximo de archivos en el ZIP: 500
-
Tamaño total máximo sin comprimir: 100 MB
Archivos de base obligatorios para una extensión
Asegúrese de que su archivo ZIP de extensión incluye los siguientes archivos:
-
.qext: Archivo de metadatos
-
.js: Código JavaScript
-
.html: Código de representación HTML
-
.css: Estilo personalizado
Reglas de denominación de archivos
Cada archivo de la extensión debe tener un nombre de archivo y una extensión de archivo. Los archivos que no cumplan estos requisitos se ignorarán. Ejemplos de archivos XML ignorados incluyen .gitignore y README.
Mejores prácticas
-
Minimice sus archivos de código.
-
Incluya solo los archivos que su extensión necesita para ejecutarse.
-
Revise la extensión y su código antes de cargarla.
Recursos externos y CSP
Aloje los archivos de imagen externamente
No incluya archivos de imagen (como GIF, PNG, JPG) en el archivo ZIP de la extensión. En su lugar, aloje las imágenes externamente (por ejemplo, en un servidor de aplicaciones, un depósito S3 o un sistema público de gestión de contenido), y haga referencia a ellas desde el código de su extensión.
Referencia a código y contenido externos
Para hacer referencia a código o contenido externos en su extensión, configure una Política de seguridad de contenidos de espacio empresarial inquilino (CSP) y añada a la lista de permitidos los orígenes externos a los que su extensión necesita acceder.
Si un origen no está en la lista de permitidos, su extensión no se generará.
Para más información, vea Administrar la política de seguridad de contenidos (Content Security Policy, CSP).
Formatos de archivo no admitidos
Por razones de seguridad, las extensiones no pueden incluir archivos con tipos MIME no permitidos. Los tipos MIME (Multipurpose Internet Mail Extensions) indican el formato de un archivo. Si su extensión contiene un tipo MIME no permitido (por ejemplo, un archivo ejecutable o un archivo ZIP), la carga fallará.
Los siguientes tipos MIME no se permiten:
- "application/octet-stream"
- "application/x-coredump"
- "application/x-dosexec"
- "application/x-executable"
- "application/x-java-applet"
- "'application/x-object"
- "application/x-sharedlib"
- "application/zip"
- "text/x-shellscript"
- "'text/x-awk"
- "text/x-gawk"
- "'text/x-msdos-batch"
- "'text/x-nawk"
- "text/x-php"
Características no compatibles
No se admiten las siguientes características:
-
Extensiones agrupadas: los archivos ZIP que contienen otros archivos ZIP de extensión no son compatibles.
-
Archivos QVF y QVD: estos archivos no están accesibles desde el servicio de extensión.
Para cargar archivos QVF o QVD, utilice uno de los siguientes métodos:
-
Suba una aplicación desde la página Crear en el centro de actividades Analítica.
-
Suba una aplicación mediante qlik-cli.
-
Cargue un QVD desde la página Crear en el centro de actividades Analítica.
-
Cargue un QVD usando Qlik DataTransfer.
Administrar las extensiones
Las extensiones se administran en la página Extensiones del centro de actividades Administración.
Información de la tabla de extensiones
-
Nombre: nombre de los metadatos en el archivo QEXT
-
Versión de QEXT: versión de los metadatos
-
Nombre de archivo QEXT: identificador único para el archivo de definición de la extensión
-
Estado: estado de la migración (temporal)
Acerca del estado de la migración
Qlik está mejorando la forma en que la plataforma gestiona las extensiones. Durante esta transición, las extensiones existentes se trasladan a un nuevo servicio. La columna de estado de la migración es temporal y solo aparece mientras este trabajo está en curso.
A partir del 17-11-2025, cualquier extensión que cargue o a la que acceda utilizará el nuevo servicio automáticamente. Si su extensión está en uso habitual, no se requiere ninguna acción.
La mayoría de las extensiones se migran automáticamente cuando se utilizan. Las extensiones que no haya utilizado recientemente pueden necesitar ser puestas en cola manualmente para ser incluidas en una ejecución de migración programada. Para proteger el contenido propiedad del cliente, Qlik no migra las extensiones a menos que se acceda a ellas o que usted confirme la migración. Si desea mantener una extensión no utilizada (estado No migrada) disponible, puede migrarla manualmente.
Valores de estado de la migración:
-
No migrada: la extensión no se ha migrado.
-
En cola para migración: la extensión se ha puesto en cola y se migrará durante la próxima ejecución de migración programada.
-
Migración en curso: la extensión se está migrando actualmente.
-
Migrado: la extensión se ha migrado correctamente.
La migración también se aplica a las plantillas de estilo. Para más detalles, vea Cargar y administrar las plantillas de estilo.
Añadir extensiones
Haga lo siguiente:
- En el centro de actividades Administración, vaya a Extensiones.
-
Haga clic en Añadir.
-
Haga clic en Explorar para seleccionar un archivo de extensión o soltar un archivo en el área designada.
-
Añada etiquetas si lo desea.
-
Haga clic en Publicar.
Editar extensiones
Haga lo siguiente:
- En el centro de actividades Administración, vaya a Extensiones.
-
En la extensión que desea editar, haga clic en
y seleccione Editar.
-
Utilice el panel de edición para reemplazar la extensión o actualizar las etiquetas.
-
Guarde los cambios.
Descargar extensiones
Utilice esta opción para hacer una copia de seguridad de una extensión antes de editarla o para moverla a otro espacio empresarial inquilino.
Haga lo siguiente:
- En el centro de actividades Administración, vaya a Extensiones.
-
En la extensión que desee descargar, haga clic en
y seleccione Descargar.
-
Guarde el archivo ZIP.
Migrar extensiones
Siga los pasos siguientes para migrar extensiones con el estado No migrado.
Haga lo siguiente:
- En el centro de actividades Administración, vaya a Extensiones.
-
En la extensión que desee migrar, haga clic en
y seleccione Migrar.
El estado se actualiza a medida que avanza la migración: En cola para migración, Migración en curso y finalmente Migrado.
Eliminar extensiones
La eliminación de extensiones puede impactar en todos los recursos, afectando a todos los usuarios del espacio empresarial inquilino.
Haga lo siguiente:
- En el centro de actividades Administración, vaya a Extensiones.
- Seleccione las extensiones que desee eliminar.
- Haga clic en Eliminar.