Informes en la app en espacios administrados
Puede configurar informes dentro de la app para las apps que requieran un estricto control de los datos. Con los mismos principios que utiliza para desarrollar modelos de datos de aplicaciones para su uso en espacios administrados, puede preparar su app para las funcionalidades de generación de informes dentro de la app. Para ello se utiliza una sintaxis que tiene en cuenta el espacio en el script de carga.
Cuando desarrolle una app para publicarla en un espacio administrado, tenga en cuenta lo siguiente:
La plantilla puede crearse antes o después de publicar la app. Si crea la plantilla antes de publicarla, utilice el cambie la app conectada después de publicar.
Debe añadirse una lista de distribución a la app antes de publicarla. Durante el desarrollo, esta puede consistir en fuentes de datos simuladas, en lugar de fuentes de datos reales. Las fuentes de la lista de distribución deben referenciarse en el script de carga, por lo que el script debe escribirse como preparación para la publicación, utilizando una sintaxis que tenga en cuenta el espacio. Esta sintaxis se utiliza automáticamente por defecto si carga una lista de distribución como archivo fuente.
Tras la publicación, los activos de elaboración de informes –plantilla, filtros y tareas de informe– pueden volver a crearse como se desee, en función del caso de uso de elaboración de informes para la app publicada. Las fuentes de datos reales utilizadas en la lista de distribución deben añadirse al espacio administrado.
Opciones de configuración de los informes
Si creó una configuración de informes y una lista de distribución antes del 26 de marzo de 2024, debe estar al tanto de los cambios en el proceso de carga de archivos para las listas de distribución.
Para las aplicaciones creadas antes del 26 de marzo de 2024, se cambió automáticamente el nombre de un archivo fuente de lista de distribución cargado en la sección Informes y se agregó al espacio. La referencia a este archivo renombrado se agregó automáticamente al script de carga. El archivo fuente cargado ya no cambia de nombre cuando se agrega al espacio.
Para seguir utilizando las configuraciones de informes existentes al publicar estas aplicaciones, siga la sección correspondiente a continuación, en función de las fuentes de su lista de distribución. También puede volver a crear su configuración de informes desde cero, utilizando las guías que se muestran más adelante en esta página.
Si cargó un archivo fuente
Abra Editor de carga de datos y fíjese en las referencias de los nombres de archivo en la sección de script Lista de distribución. Ajuste la sintaxis para que utilicen una referencia espacial que apunte al espacio actual, en lugar de a cualquier espacio específico.Por ejemplo, una referencia a un archivo podría tener el siguiente aspecto:
FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"
Cambie esto a:
FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"
Puede ver que el ID de la app de origen está contenido en el nombre del archivo. Si desea que se ejecute este script exacto cuando publique la app, agregue su archivo de lista de distribución real al espacio administrado, con este nombre exacto.
Como alternativa, puede cambiar el nombre del archivo fuente en el espacio de desarrollo, actualizar el script de carga y luego publicarlo. Por último, agregue el archivo de la lista de distribución real, con el nombre actualizado.
Si utilizó fuentes de datos remotas manualmente en el script
Si, por el contrario, ha configurado manualmente el script de carga para que dependa de otras fuentes de datos para la lista de distribución, solo tiene que ajustar el script de carga para que contenga referencias relativas y conscientes del espacio a las fuentes de datos (si no lo ha hecho ya).
Para obtener más información y ejemplos concretos, consulte Fuentes de datos para apps en espacios administrados.
Flujo de trabajo
Siga la secuencia siguiente para trabajar con los informes incluidos en la app en un espacio administrado.
Desarrollo de aplicaciones
Desarrolle la app en su espacio de desarrollo (personal o compartido), como lo haría normalmente, en preparación para publicarla en el espacio administrado.
Desarrollar la plantilla y los filtros
Si lo desea, puede crear la plantilla de informe y los filtros antes de publicar la app. Esto puede ser útil como una etapa en el desarrollo de la app, pero las plantillas y los filtros añadidos a la app de origen no se conservan en la copia publicada.
Si crea la plantilla antes de publicarla y desea utilizarla para la app publicada, cambie la app de Qlik Sense conectada para la plantilla. Puede realizar esta acción en el complemento. Alternativamente, realice esta acción en la app Qlik Sense mientras carga la plantilla en la app publicada. Vea Cambiar la app de Qlik Sense conectada.
Preparar la referencia de la lista de distribución
Al añadir una lista de distribución a una app, se modifica el script de carga de la app. El script de carga de una app no es accesible en una app publicada. Por lo tanto, es necesario añadir una lista de distribución a la app antes de publicarla.
En esta etapa, la lista de distribución simplemente necesita ser un marcador de posición para el archivo real u otras fuentes que utilizará para la lista de distribución en el espacio administrado.
El procedimiento es ligeramente diferente, dependiendo de si su lista de distribución es un archivo fuente o una fuente de datos remota añadida manualmente en el script. No obstante, los conceptos subyacentes son los mismos. Para acceder a una guía completa sobre cómo utilizar sintaxis que tenga en cuenta el espacio en un script de carga, consulte Fuentes de datos para apps en espacios administrados.
Opción 1: carga directa del archivo fuente
Siga el procedimiento habitual para cargar un archivo fuente como lista de distribución: Añadir la lista de distribución cargando un archivo fuente.
En lugar de agregar los detalles finales del destinatario, puede insertar los marcadores de posición que desee. Lo importante aquí es que cargue un archivo y que este archivo se agregue automáticamente al espacio de desarrollo y se haga referencia al mismo en el script.
Puede verificar que la sección Distribution List en el script de carga contenga una referencia al archivo que tenga en cuenta el espacio y no haga referencia directa a ningún espacio en particular. Esto se realiza automáticamente cuando carga un archivo fuente como una lista de distribución en la sección Informes de la app. Debería verse así:
FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"
Este ejemplo es una referencia que tiene en cuenta el espacio y que apunta al espacio actual en el que se encuentra la app. Los dos puntos adicionales antes de DataFiles proporcionan la referencia relativa requerida.
Más adelante, cuando publique la app en el espacio administrado, cargue el archivo de la lista de distribución real en el espacio administrado. La lista de distribución real debe tener el mismo nombre de archivo que el archivo al que se hace referencia en el script.
Opción 2: referencia manual a fuentes de datos en el script
Siga el procedimiento habitual para conectarse manualmente a fuentes de listas de distribución remotas en su script: Definir manualmente la lista de distribución en el script de carga.
Al escribir el script para conectarse a las fuentes de datos necesarias para su lista de distribución, puede usar referencias simuladas a los archivos y conexiones, según sea necesario. En su script, las fuentes de datos simplemente necesitan tener los mismos nombres que tendrán en el espacio administrado, y las referencias a esas fuentes necesitan usar una sintaxis relativa, que tenga en cuenta el espacio.
Publicar la app
Una vez que haya preparado el script de carga y la lista de distribución, la app estará lista para publicarse en el espacio administrado. Para obtener más información sobre la publicación de una app, consulte Publicar apps.
Cambiar la app de Qlik Sense conectada
Si ha creado una plantilla de informe antes de publicar la app, deberá actualizar la plantilla para que haga referencia al ID de app correcto. Una copia publicada de una app tendrá un ID de app diferente al de la app de origen.
Este proceso puede completarse en Qlik Sense mientras carga una plantilla. En el caso de una plantilla de informe de Excel también puede hacerse en el complemento de Qlik para Microsoft Excel. Antes de comenzar, puede crear una copia aparte de la plantilla para distinguirla de la plantilla de la app de origen.
Para ver instrucciones detalladas, consulte:
Desde Qlik Sense: Cambiar la app de Qlik Sense conectada
Desde el complemento de Qlik para Microsoft Excel: Cambiar la app de Qlik Sense conectada
Siempre es posible desarrollar y actualizar sus plantillas directamente en el espacio administrado.
Añadir las fuentes reales de la lista de distribución
En el espacio administrado, cree los archivos y conexiones necesarios para cargar su lista de distribución, como se indica en el script de carga. Este paso puede realizarse en cualquier momento.
Las fuentes de datos que proporcionan la lista de distribución deben contener los mismos nombres de parámetros (nombres de conexiones, archivos y campos) que las fuentes de lista de distribución utilizadas en el script de carga de la app de origen.
Cuando las fuentes conectadas se hayan añadido al espacio, debería poder recargar la app.
Crear los nuevos activos de informes
Ya puede añadir activos de informes a la app. Esto consistirá en la plantilla, los filtros y las tareas de informes.
Permisos
Los usuarios con cualquiera de los siguientes roles en el espacio administrado pueden trabajar con informes en la app para la app:
Propietario
Puede administrar
Puede operar (solo Derecho Profesional o Full User)
Para obtener más información, consulte Gestionar permisos en espacios administrados.
Limitaciones
La opción de Informes en la app no está disponible para apps publicadas o distribuidas desde Qlik Sense administrado por el cliente (incluidas las implementaciones en múltiples nubes) a Qlik Cloud. Para utilizar los informes en la app con estas apps, migre la app a Qlik Cloud utilizando las herramientas de migración (consulte Configuración de las herramientas de migración de Qlik Cloud) o exporte manualmente la app y vuelva a cargarla en Qlik Cloud.
Para obtener más información, consulte Informes en la app con apps exportadas o migradas.