시각화 확장 업로드 및 관리
확장 기능은 Qlik Cloud 응용 프로그램에 사용자 지정 시각화 기능을 추가합니다. 관리 활동 센터에서 확장을 업로드하고 관리할 수 있습니다.
확장 사용
Qlik Cloud의 시각화 확장 기능은 표준 시각화 외에 새로운 시각적 구성 요소를 추가합니다. 데이터를 표시하고 탐색하는 방법을 맞춤 설정하는 데 사용합니다.
자세한 내용은 Qlik 개발자: Qlik 확장을 참조하십시오. 시각적 데모는 Qlik Cloud에서 타사 시각화 확장 사용 및 확장 및 API 키를 참조하십시오.
필수 역할
확장을 업로드하고 관리하려면 다음 역할 중 하나가 있어야 합니다.
-
테넌트 관리자
-
Analytics 관리자
-
권한이 확장 관리로 설정된 허용됨 사용자 지정 역할
파일 요구 사항 및 제한
확장이 올바르게 업로드되고 작동하는지 확인하려면 다음 규칙을 따르십시오.
파일 제한
확장 ZIP 파일에는 다음과 같은 제한이 있습니다.
-
최대 ZIP 파일 크기: 30MB
-
ZIP의 단일 파일 최대 크기: 30MB
-
ZIP에 있는 최대 파일 수: 500
-
압축 해제된 총 최대 크기: 100MB
확장에 필요한 기본 파일
확장 ZIP 파일에 다음 파일이 포함되어 있는지 확인합니다.
-
.qext: 메타데이터 파일
-
.js: JavaScript 코드
-
.html: HTML 렌더링 코드
-
.css: 사용자 지정 스타일
파일 이름 지정 규칙
확장의 각 파일에는 파일 이름과 파일 확장명이 있어야 합니다. 규정을 준수하지 않는 파일은 무시됩니다. 무시된 파일의 예로는 .gitignore 및 README가 있습니다.
모범 사례
-
코드 파일을 줄입니다.
-
확장이 실행하는 데 필요한 파일만 포함하세요.
-
업로드하기 전에 확장과 해당 코드를 검토하세요.
외부 리소스 및 CSP
이미지 파일을 외부에서 호스팅하세요.
확장 ZIP 파일에 이미지 파일(예: GIF, PNG, JPG)을 포함하지 마십시오. 대신 이미지를 외부에 호스팅하고(예: 응용 프로그램 서버, S3 버킷 또는 공용 콘텐츠 관리 시스템에서) 확장 코드에서 참조하십시오.
외부 코드 및 콘텐츠 참조
확장에서 외부 코드 또는 콘텐츠를 참조하려면 테넌트 콘텐츠 보안 정책(CSP)을 구성하고 확장이 액세스해야 하는 외부 원본을 허용 목록에 추가하십시오.
원본이 허용 목록에 없으면 확장이 렌더링되지 않습니다.
자세한 내용은 콘텐츠 보안 정책(Content Security Policy) 관리(CSP)을 참조하십시오.
지원되지 않는 파일 형식
보안상의 이유로, 확장에는 허용되지 않는 MIME 유형의 파일을 포함할 수 없습니다. MIME 유형(Multipurpose Internet Mail Extensions)은 파일의 형식을 나타냅니다. 확장에 허용되지 않는 MIME 유형(예: 실행 파일 또는 ZIP 파일)이 포함된 경우 업로드가 실패합니다.
다음 MIME 유형은 허용되지 않습니다.
- 'application/octet-stream'
- 'application/x-coredump'
- '응용 프로그램/x-dosexec'
- '응용 프로그램/x-executable'
- 'application/x-java-애플릿'
- 'application/x-오브젝트'
- 'application/x-공유 라이브러리'
- '애플리케이션/zip'
- 'text/x-셸 스크립트'
- '텍스트/x-awk'
- '텍스트/x-gawk'
- '텍스트/x-msdos-배치'
- '텍스트/x-nawk'
- '텍스트/x-php'
지원되지 않는 기능
다음 기능은 지원되지 않습니다.
-
번들 확장: 다른 확장 ZIP 파일을 포함하는 ZIP 파일은 지원되지 않습니다.
-
QVF 및 QVD 파일: 이러한 파일은 확장 서비스에서 액세스할 수 없습니다.
QVF 또는 QVD 파일을 업로드하려면 다음 방법 중 하나를 사용합니다.
-
분석활동 센터의 만들기 페이지에서 응용 프로그램을 업로드합니다.
-
응용 프로그램을 qlik-cli을(를) 사용하여 업로드합니다.
-
분석 활동 센터의 만들기 페이지에서 QVD를 업로드합니다.
-
Qlik DataTransfer를 사용하여 QVD를 업로드합니다.
확장 관리
확장은 관리 활동 센터의 확장 페이지에서 관리됩니다.
확장 테이블 정보
-
이름: QEXT 파일의 메타데이터 이름
-
QEXT 버전: 메타데이터 버전
-
QEXT 파일 이름: 확장 정의 파일의 고유 식별자
-
상태: 마이그레이션 상태(임시)
마이그레이션 상태 정보
Qlik은(는) 플랫폼이 확장을 처리하는 방식을 개선하고 있습니다. 이 전환 기간 동안 기존 확장이 새로운 서비스로 이동됩니다. 마이그레이션 상태 열은 임시이며 이 작업이 진행 중인 동안에만 나타납니다.
2025-11-17부터 업로드하거나 액세스하는 모든 확장은 새 서비스를 자동으로 사용합니다. 확장을 정기적으로 사용하는 경우 별도의 조치가 필요하지 않습니다.
대부분의 확장은 사용될 때 자동으로 마이그레이션됩니다. 최근에 사용하지 않은 확장은 예약된 마이그레이션 실행에 포함되도록 수동으로 대기열에 추가해야 할 수 있습니다. 고객 소유 콘텐츠를 보호하기 위해, Qlik는 확장이 액세스되거나 마이그레이션을 확인하지 않는 한 확장을 마이그레이션하지 않습니다. 사용하지 않는 확장(상태 마이그레이션되지 않음)을 계속 사용하려면 수동으로 마이그레이션할 수 있습니다.
마이그레이션 상태 값:
-
마이그레이션되지 않음: 확장이 마이그레이션되지 않았습니다.
-
마이그레이션 대기 중: 확장이 대기열에 추가되었으며 다음 예약된 마이그레이션 실행 중에 마이그레이션됩니다.
-
마이그레이션 진행 중: 확장이 현재 마이그레이션되고 있습니다.
-
마이그레이션됨: 확장이 성공적으로 마이그레이션되었습니다.
마이그레이션은 테마에도 적용됩니다. 자세한 내용은 테마 업로드 및 관리을 참조하십시오.
확장 추가
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
추가를 클릭합니다.
-
찾아보기를 클릭하여 확장자 파일을 선택하거나 지정된 영역에 파일을 놓습니다.
-
필요한 경우 태그를 추가합니다.
-
게시를 클릭합니다.
확장 편집
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
편집하려는 확장에서
을 클릭하고 편집을 선택합니다. -
편집 패널을 사용하여 확장을 바꾸거나 태그를 업데이트합니다.
-
변경 내용을 저장합니다.
확장 다운로드
이 기능을 사용하여 확장을 편집하기 전에 백업하거나 다른 테넌트로 이동합니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
다운로드하려는 확장 프로그램에서
을 클릭하고 다운로드를 선택합니다. -
ZIP 파일을 저장합니다.
확장 마이그레이션
다음 단계를 사용하여 마이그레이션되지 않음 상태의 확장을 마이그레이션합니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
-
마이그레이션하려는 확장 프로그램에서
을(를) 클릭하고 마이그레이션을(를) 선택합니다.
마이그레이션이 진행됨에 따라 상태가 업데이트됩니다. 마이그레이션 대기 중, 마이그레이션 진행 중, 마지막으로 마이그레이션됨.
확장 삭제
확장을 삭제하면 모든 리소스에 영향을 미쳐 테넌트 내의 모든 사용자에게 영향을 미칩니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 확장으로 이동합니다.
- 삭제하려는 확장을 선택합니다.
- 삭제를 클릭합니다.