Include/Must_Include 변수는 스크립트에 포함되어 스크립트 코드로 평가되어야 하는 텍스트를 포함한 파일을 지정합니다. 데이터를 추가하는 데 사용되지 않습니다. 스크립트 코드의 일부를 별도의 텍스트 파일에 저장한 후 여러 앱에서 재사용할 수 있습니다. 이 변수는 사용자 정의 변수입니다.
구문:
$(Include=filename)
$(Must_Include=filename)
두 가지 버전의 변수가 있습니다.
- Include는 파일을 찾을 수 없는 경우 오류를 생성하지 않고 아무런 메시지 없이 실패합니다.
- Must_Include는 파일을 찾을 수 없으면 오류를 생성합니다.
경로를 지정하지 않으면 Qlik Sense 앱 작업 디렉터리에 상대적인 파일 이름이 사용됩니다. 절대 파일 경로나 lib:// 폴더 연결 경로를 지정할 수도 있습니다. 등호 앞이나 뒤에 공백 문자를 넣지 마십시오.
$(Include=abc.txt);
$(Must_Include=lib://DataFiles/abc.txt);
제한 사항은
Windows와 Linux에서 UTF-8로 인코딩된 파일 간에 제한된 교차 호환성.
BOM(Byte Order Mark)과 함께 UTF-8을 사용하는 것은 선택 사항입니다. BOM은 비 ASCII 바이트가 파일 시작 부분에 있을 것이라고 예상하지 않은 소프트웨어에서 UTF-8 사용을 방해할 수 있지만, 그렇지 않으면 텍스트 스트림이 처리될 수 있습니다.
Windows 시스템은 UTF-8의 BOM을 사용하여 바이트 저장소에 모호성이 없음에도 불구하고 파일이 UTF-8로 인코딩되어 있음을 식별합니다.
Unix/Linux는 유니코드에 UTF-8을 사용하지만, BOM은 명령 파일의 구문을 방해하므로 사용하지 않습니다.
Qlik Sense에 대한 몇 가지 결과가 있습니다.
Windows에서 UTF-8 BOM으로 시작하는 모든 파일은 UTF-8 스크립트 파일로 간주됩니다. 그렇지 않으면 ANSI 인코딩이 가정됩니다.
Linux에서 시스템 기본 8비트 코드 페이지는 UTF-8입니다. 따라서 UTF-8은 작동하지만 BOM을 포함하지 않습니다.
결과적으로 이식성을 보장할 수 없습니다. Linux에서 해석할 수 있는 Windows의 파일을 항상 만들 수 있는 것은 아닙니다. 그 반대의 경우도 마찬가지입니다. BOM 처리가 다르기 때문에 UTF-8 인코딩 파일에 대한 두 시스템 간의 교차 호환성이 없습니다.
자세한 내용은 BOM(Byte Order Mark)을 참조하십시오.
Qlik Cloud 분석의 공간에서 QVS 코드 삽입
Qlik Cloud 분석에서 로드 스크립트 내의 데이터 파일에서 데이터를 로드할 때 LOAD 문을 사용하거나 QVS 코드를 삽입할 수 있습니다. 두 경우 모두, 스크립트 문에서 계층 구조적 공간 폴더 구조를 참조할 수 있습니다. 유효한 공간 폴더 경로에 대한 규칙을 따르십시오. 또한, 파일과 참조된 모든 폴더는 지정된 위치에 이미 존재해야 합니다. 그렇지 않으면 다시 로드하는 데 실패합니다.
공간의 최상위 경로에서 QVS 파일 참조
이 예에서 파일 test.qvs는 로드 스크립트에서 참조됩니다. 해당 파일은 TeamSharedSpace 공간에 있습니다. 해당 파일은 특정 폴더 내에 위치하지 않고, 대신 공간의 최상위 경로에 위치합니다.
$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)특정 폴더 경로 내의 공백에 있는 QVS 파일 참조
이 예에서 파일 test.qvs는 로드 스크립트에서 참조됩니다. 해당 파일은 공간 TeamSharedSpace 내의 폴더 SalesData에 있습니다.
$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)로드 스크립트에서 공간 폴더 구조를 참조하는 방법에 대한 자세한 내용은 앱 및 스크립트 개발에서 공간 폴더 구조 참조를 참조하십시오.