Administrar las extensiones
Las extensiones amplían la funcionalidad de la plataforma de analítica de Qlik Cloud habilitando visualizaciones personalizadas para apps de Qlik Sense. Puede cargar y editar las extensiones desde el centro de actividades Administración.
Directrices para crear y cargar extensiones
Siga estas directrices para crear y cargar extensiones de visualización en Qlik Cloud.
Para acceder a una demostración visual sobre cómo agregar y usar extensiones, vea Uso de extensiones de visualización de terceros en Qlik Cloud y Extensiones y claves de API.
Límites de las extensiones de archivos ZIP
-
Tamaño máximo de archivo ZIP: 30 MB
-
Tamaño máximo de archivos en un ZIP: 30 MB
-
Número máximo de archivos en un ZIP: 500
-
Tamaño máximo total de archivos sin comprimir en un ZIP: 100 MB
Mejores prácticas
-
Minimice sus archivos de código.
-
Incluya solo los archivos necesarios. Asegúrese de que el archivo ZIP contiene únicamente los archivos necesarios para que su extensión funcione correctamente.
-
Vea las extensiones y su código antes de cargarlas. Vea más información en Extensiones de visualización (solo en inglés).
Archivos de base obligatorios para una extensión
Asegúrese de que su archivo ZIP de extensión incluye los siguientes archivos esenciales:
-
.qext: archivo de metadatos de la extensión
-
.js: código JavaScript de la extensión
-
.html: código HTML para representar la extensión.
-
.css: CSS personalizado para dar estilo a la extensión.
Alojamiento externo de archivos de imagen
No cargue archivos de imagen (por ejemplo, GIF, PNG, JPG) dentro del archivo zip de la extensión. En su lugar, alójelos externamente en un servidor de aplicaciones personal, un depósito S3 o un sistema público de gestión de contenidos. Haga referencia a estas Imágenes externas en el código de su extensión.
Referencia a archivos de código y contenidos externos
Puede hacer referencia a archivos de código y contenido en su código de extensión principal, pero esto requiere implementar una Política de seguridad de contenidos (CSP) en el espacio empresarial inquilino. Para más información, vea Administrar Content Security Policy.
Si su extensión hace solicitudes a recursos externos, esos orígenes de recursos deben estar permitidos en la CSP o la extensión se bloqueará y no se podrá mostrar.
Características no compatibles
No se admiten las siguientes características:
Extensiones en paquetes
Qlik Cloud no contiene archivos ZIP que contienen otras extensiones.
Archivos QVF y QVD
No incluya archivos QVF o QVD de Qlik Sense en el archivo ZIP de la extensión, ya que no es posible acceder a ellos desde el servicio de extensiones. Elimine estos archivos antes de cargar la extensión.
Para cargar un archivo QVF o QVD al espacio empresarial inquilino de Qlik Cloud, utilice uno de los siguientes métodos:
-
Suba una app en la página Crear del centro de actividades Analítica.
-
Cargar una app usando qlik-cli.
-
Cargue un QVD en la página Crear del centro de actividades Analítica.
-
Cargue un QVD usando Qlik DataTransfer.
Formatos de archivo no compatibles
Por razones de seguridad, las extensiones no pueden contener archivos con tipos MIME no permitidos. Los tipos MIME (Multipurpose Internet Mail Extensiones) son una forma estándar de indicar la naturaleza y el formato de un archivo. La carga fallará si su extensión contiene, por ejemplo, un archivo ejecutable o un archivo ZIP.
Los siguientes tipos MIME no están permitidos:
- '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'
Todos los archivos de una extensión deben tener un nombre de archivo y una extensión de archivo. Los archivos que no cumplan esta normativa se ignorarán. Ejemplos de archivos XML ignorados incluyen .gitignore y README.
Añadir y administrar extensiones
Las extensiones se administran en la página Extensiones del centro de actividades Administración.
En la tabla Extensiones:
-
Nombre se refiere al nombre de los metadatos en el archivo QEXT.
-
Versión QEXT indica la versión de los metadatos en el archivo QEXT.
-
Nombre de archivo QEXT es el identificador único y el nombre del archivo de definición de la extensión.
Puede filtrar las extensiones por etiquetas.
Añadir una nueva extensión
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 una extensión
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.El panel de edición se muestra con opciones para reemplazar la extensión existente y agregar o quitar etiquetas.
-
Guarde los cambios.
Eliminar una extensión
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.