La variable Include/Must_Include especifica un archivo que contiene texto que debe incluirse en el script y evaluarse como código de script. No se utiliza para añadir datos. Puede almacenar partes de su código de script en un archivo de texto aparte y reutilizarlo en diversas apps. Esta es una variable definida por el usuario.
Sintaxis:
$(Include=filename)
$(Must_Include=filename)
Hay dos versiones de la variable:
- Include no genera un error si no encuentra el archivo, fallará en silencio.
- Must_Include genera un error si no encuentra el archivo.
Si no se especifica ninguna ruta, el nombre del archivo estará relacionado con el directorio de trabajo de la app Qlik Sense. También puede especificar una ruta de archivo absoluta o una ruta a una conexión de carpeta lib://. No ponga un carácter de espacio antes o después del signo igual.
Ejemplos:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Limitaciones
Compatibilidad cruzada limitada entre archivos codificados en UTF-8 en Windows frente a Linux.
Es opcional utilizar UTF-8 con BOM (marca de orden de bytes). BOM puede interferir con el uso de UTF-8 en software que no espera bytes que no sean ASCII al comienzo de un archivo, pero que de otra manera podría manejar el flujo de texto.
Los sistemas Windows usan BOM en UTF-8 para identificar que un archivo está codificado en UTF-8, a pesar de que no hay ambigüedad en el almacenamiento de bytes.
Unix/Linux usa UTF-8 para Unicode, pero no usa la lista de materiales, ya que esto interfiere con la sintaxis de los archivos de comando.
Esto tiene algunas implicaciones para Qlik Sense.
En Windows, cualquier archivo que comience con una lista de materiales UTF-8 se considera un archivo de secuencia de comandos UTF-8. De lo contrario, se asume la codificación ANSI.
De lo contrario, se asume la codificación ANSI. Es por eso que el UTF-8 funciona aunque no contiene una lista de materiales.
Como resultado, no se puede garantizar la portabilidad. No siempre es posible crear un archivo en Windows que pueda ser interpretado por Linux y viceversa. No hay compatibilidad cruzada entre los dos sistemas con respecto a los archivos codificados en UTF-8 debido al manejo diferente de la lista de materiales.
Para más información, vea Marca de orden de bytes
Insertar código QVS de espacios en Analítica de Qlik Cloud
En Analítica de Qlik Cloud, al cargar datos desde un archivo de datos dentro de un script de carga, puede utilizar una sentencia LOAD o insertar código QVS. En ambos casos, se puede hacer referencia a estructuras de carpetas de espacios jerárquicos en su sentencia de script. Siga las reglas especificadas para unas Rutas válidas de carpetas de espacio. Además, el archivo y todas las carpetas a las que se hace referencia deben existir ya en la ubicación especificada. De lo contrario, la recarga fallará.
Ejemplo: Referencia al archivo QVS en la ruta de nivel superior de un espacio
En este ejemplo, se hace referencia al archivo test.qvs en el script de carga. El archivo está ubicado en el espacio TeamSharedSpace. El archivo no se encuentra dentro de ninguna carpeta específica, sino que se encuentra en la ruta de nivel superior del espacio.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Ejemplo: Referencia al archivo QVS en una ruta de carpeta específica dentro de un espacio
En este ejemplo, se hace referencia al archivo test.qvs en el script de carga. El archivo se encuentra en la carpeta SalesData dentro del espacio TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Para obtener más información sobre cómo hacer referencia a la estructura de carpetas de espacios en los scripts de carga, consulte Hacer referencia a la estructura de carpetas del espacio en el desarrollo de apps y scripts.