확장 관리
확장은 Qlik Sense 앱에 대한 사용자 지정 시각화를 활성화하여 Qlik Cloud 분석 플랫폼의 기능을 확장합니다. 관리 활동 센터에서 확장을 업로드하고 편집할 수 있습니다.
확장 생성 및 업로드 지침
Qlik Cloud에 시각화 확장을 만들고 업로드할 때 다음 지침을 따르십시오.
확장 추가 및 사용에 대한 시각적 데모는 Qlik Cloud에서 타사 시각화 확장 사용 및 확장 및 API 키를 참조하십시오.
확장에 대한 ZIP 파일 제한
-
최대 ZIP 파일 크기: 30MB
-
ZIP에 있는 최대 파일 크기: 30MB
-
ZIP에 있는 최대 파일 수: 500
-
ZIP에 있는 압축되지 않은 총 파일의 최대 크기: 100MB
모범 사례
-
코드 파일을 줄입니다.
-
필요한 파일만 포함시킵니다. 확장이 제대로 작동하는 데 필요한 파일만 ZIP 파일에 포함되어 있는지 확인합니다.
-
업로드하기 전에 확장과 해당 코드를 검토합니다. 자세한 내용은 시각화 확장 (영어로만 제공)을 참조하십시오.
확장에 필요한 기본 파일
확장 ZIP 파일에 다음과 같은 필수 파일이 포함되어 있는지 확인합니다.
-
.qext: 확장 메타데이터 파일
-
.js: 확장을 위한 JavaScript 코드
-
.html: 확장을 렌더링하기 위한 HTML 코드
-
.css: 확장 스타일링을 위한 사용자 지정 CSS
이미지 파일의 외부 호스팅
확장 ZIP 파일 내에 이미지 파일(예: GIF, PNG, JPG)을 업로드하지 마십시오. 대신 개인 응용 프로그램 서버, S3 버킷 또는 공개 콘텐츠 관리 시스템 등 외부에서 호스팅합니다. 확장 코드에서 이러한 외부 이미지를 참조하십시오.
외부 코드 파일 및 콘텐츠 참조
기본 확장 코드에서 코드 파일과 콘텐츠를 참조할 수 있지만, 이를 위해서는 테넌트에서 CSP(콘텐츠 보안 정책)를 구현해야 합니다. 자세한 내용은 관리Content Security Policy을 참조하십시오.
확장이 외부 리소스에 요청을 하는 경우 해당 리소스 원본을 CSP에서 허용 목록에 추가해야 합니다. 그렇지 않으면 확장의 렌더링이 차단됩니다.
지원되지 않는 기능
다음 기능은 지원되지 않습니다.
번들 확장
Qlik Cloud는 다른 확장 ZIP 파일을 포함하는 ZIP 파일을 지원하지 않습니다.
QVF 및 QVD 파일
Qlik Sense QVF 또는 QVD 파일은 확장 서비스에서 액세스할 수 없으므로 확장 ZIP 파일에 포함하지 마십시오. 확장을 업로드하기 전에 이러한 파일을 제거합니다.
Qlik Cloud 테넌트에 QVF 또는 QVD 파일을 업로드하려면 다음 방법 중 하나를 사용합니다.
-
분석 활동 센터의 만들기 페이지에서 앱을 업로드합니다.
-
qlik-cli를 사용하여 앱을 업로드합니다.
-
분석 활동 센터의 만들기 페이지에서 QVD를 업로드합니다.
-
Qlik DataTransfer를 사용하여 QVD를 업로드합니다.
지원되지 않는 파일 형식
보안상의 이유로, 확장에는 허용되지 않는 MIME 유형의 파일을 포함할 수 없습니다. MIME 유형(Multipurpose Internet Mail Extensions)은 파일의 특성과 형식을 나타내는 표준적인 방법입니다. 예를 들어, 확장에 실행 파일이나 ZIP 파일이 포함되어 있는 경우 업로드가 실패합니다.
다음 MIME 유형은 허용되지 않습니다.
- 'application/octet-stream'
- 'application/x-coredump'
- 'application/x-dosexec'
- 'application/x-executable'
- 'application/x-java-applet'
- 'application/x-object'
- 'application/x-sharedlib'
- 'application/zip'
- 'text/x-shellscript'
- 'text/x-awk'
- 'text/x-gawk'
- 'text/x-msdos-batch'
- 'text/x-nawk'
- 'text/x-php'
확장의 모든 파일에는 파일 이름과 파일 확장명이 있어야 합니다. 규정을 준수하지 않는 파일은 무시됩니다. 무시된 파일의 예로는 .gitignore 및 README가 있습니다.
확장 추가 및 관리
확장은 관리 활동 센터의 확장 페이지에서 관리됩니다.
확장 표에서:
-
이름은 QEXT 파일의 메타데이터 이름을 나타냅니다.
-
QEXT 버전은 QEXT 파일의 메타데이터 버전을 나타냅니다.
-
QEXT 파일 이름은 고유 식별자이자 확장 정의 파일의 이름입니다.
태그로 확장을 필터링할 수 있습니다.
새 확장 추가
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
추가를 클릭합니다.
-
찾아보기를 클릭하여 확장자 파일을 선택하거나 지정된 영역에 파일을 놓습니다.
-
필요한 경우 태그를 추가합니다.
-
게시를 클릭합니다.
확장 편집
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
편집하려는 확장에서 을 클릭하고 편집을 선택합니다.
편집 패널에 기존 확장 교체 및 태그 추가 또는 제거 옵션이 표시됩니다.
-
변경 내용을 저장합니다.
확장 삭제
확장을 삭제하면 모든 리소스에 영향을 미쳐 테넌트 내의 모든 사용자에게 영향을 미칩니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
- 삭제하려는 확장을 선택합니다.
- 삭제를 클릭합니다.