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)을 참조하십시오.