A variável Include/Must_Include especifica um arquivo que contém texto, o qual deve ser incluído no script e avaliado como código de script. Ela não é usada para adicionar dados. Você pode armazenar partes do seu código de script em um arquivo de texto separado e reutilizá-lo em vários aplicativos. Essa é uma variável definida pelo usuário.
Sintaxe:
$(Include=filename)
$(Must_Include=filename)
Existem duas versões da variável:
- Include não gera um erro se o arquivo não puder ser encontrado, ele falhará silenciosamente.
- Must_Include gera um erro se o arquivo não puder ser encontrado.
Se você não especificar um caminho, o nome do arquivo será relativo ao diretório de trabalho do aplicativo Qlik Sense. Você também pode especificar um caminho de arquivo absoluto ou um caminho para uma conexão de pasta lib://. Não coloque um caractere de espaço antes ou depois do sinal de igual.
Exemplos:
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
Limitações
Compatibilidade cruzada limitada entre arquivos codificados em UTF-8 no Windows e no Linux.
O uso do UTF-8 com a BOM (Byte Order Mark, ou Marca de ordem de bytes) é opcional. A BOM pode interferir com o uso do UTF-8 em softwares que não esperam bytes não ASCII no início de um arquivo, mas que, de outra forma, poderiam lidar com o fluxo de texto.
Os sistemas Windows usam a BOM em UTF-8 para identificar que um arquivo está codificado em UTF-8, mesmo não havendo ambiguidade no armazenamento de bytes.
O Unix/Linux usa UTF-8 para Unicode, mas não usa a BOM, pois ela interfere na sintaxe de arquivos de comando.
Isso tem algumas implicações para o Qlik Sense.
No Windows, qualquer arquivo que comece com uma BOM UTF-8 é considerado um arquivo de script UTF-8. Caso contrário, é assumida a codificação ANSI.
No Linux, a página de código de 8 bits padrão do sistema é UTF-8. É por isso que o UTF-8 funciona, embora não contenha uma BOM.
Como resultado, a portabilidade não pode ser garantida. Nem sempre é possível criar um arquivo no Windows que possa ser interpretado pelo Linux, e vice-versa. Não há compatibilidade cruzada entre os dois sistemas em relação a arquivos codificados em UTF-8 devido ao tratamento diferente da BOM.
Para obter mais informações, consulte Marca de ordem de bytes
Inserindo o código QVS de espaços no Qlik Cloud Analytics
No Qlik Cloud Analytics, ao carregar dados de um arquivo de dados em um script de carregamento, você pode usar uma instrução LOAD ou inserir o código QVS. Em ambos os casos, as estruturas hierárquicas de pastas de espaço podem ser referenciadas em sua instrução de script. Siga as regras para caminhos válidos de pastas de espaço. Além disso, o arquivo e todas as pastas referenciadas precisam já existir na localização especificada. Caso contrário, a recarga falhará.
Exemplo: Fazendo referência ao arquivo QVSno caminho de nível superior de um espaço
Nesse exemplo, o arquivo test.qvs é referenciado no script de carregamento. O arquivo está localizado no espaço TeamSharedSpace. O arquivo não está localizado em nenhuma pasta específica, mas sim no caminho de nível superior no espaço.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)Exemplo: Fazendo referência ao arquivo QVSem um caminho de pasta específico em um espaço
Nesse exemplo, o arquivo test.qvs é referenciado no script de carregamento. O arquivo está localizado na pasta SalesData no espaço TeamSharedSpace.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)Para obter mais informações sobre como referenciar a estrutura da pasta de espaço em scripts de carregamento, consulte Fazendo referência da estrutura de pastas do espaço no desenvolvimento de aplicativos e scripts.