테마 업로드 및 관리
회사 표준에 따라 색과 배경을 포함한 사용자 지정 테마를 추가하여 응용 프로그램 스타일을 지정합니다. 관리 활동 센터에서 테마를 업로드하고 관리할 수 있습니다.
사용자 지정할 수 있는 항목
사용자 지정 테마를 사용하면 다음과 같이 응용 프로그램의 스타일을 정확하게 지정할 수 있습니다.
-
색 변경
-
이미지와 배경 추가
-
글꼴 크기와 글꼴 색을 전역적 또는 세부적으로 지정합니다.
-
색상표 정의.
-
여백, 패딩, 간격 사용자 지정.
응용 프로그램에 대한 자신만의 테마를 만드는 방법에 대한 자세한 내용은 Qlik 개발자: 사용자 지정 테마를 참조하십시오. 응용 프로그램 스타일 지정에 대한 자세한 내용은 응용 프로그램 스타일 지정을 참조하십시오.
필수 역할
테마를 업로드하고 관리하려면 다음 역할 중 하나가 있어야 합니다.
-
테넌트 관리자
-
Analytics 관리자
-
권한 테마 관리가 허용됨으로 설정된 사용자 지정 역할.
파일 요구 사항 및 제한
테마가 올바르게 업로드되고 작동하도록 다음 규칙을 따르십시오.
지원되는 파일 형식
테마는 다음 파일 형식만 지원합니다.
-
HTML 파일
-
CSS 파일
-
JSON 파일
-
이미지(PNG, JPEG, GIF 및 SVG)
-
QEXT 메타데이터 파일
-
글꼴 파일
파일 이름 지정 규칙
테마의 각 파일에는 파일 이름과 파일 확장명이 있어야 합니다. 규정을 준수하지 않는 파일은 무시됩니다. 무시된 파일의 예로는 .gitignore 및 README가 있습니다.
파일 크기 및 개수 제한
테마 ZIP 파일에는 다음과 같은 제한이 있습니다:
-
최대 ZIP 파일 크기: 30MB
-
ZIP 내 단일 파일의 최대 크기: 30MB
-
ZIP에 있는 최대 파일 수: 500
-
최대 총 압축 해제 크기: 100MB
외부 리소스 및 CSP
테마에 외부 리소스에 대한 링크가 포함된 경우, 해당 리소스 원본은 콘텐츠 보안 정책(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'
테마 관리
테마는 관리 활동 센터의 테마 페이지에서 관리됩니다.
테마 테이블 정보
-
이름: QEXT 파일의 메타데이터 이름
-
QEXT 버전: 메타데이터 버전
-
QEXT 파일 이름: 테마 정의 파일의 고유 식별자
-
상태: 마이그레이션 상태(임시)
마이그레이션 상태 정보
Qlik은(는) 플랫폼에서 테마를 처리하는 방식을 개선하고 있습니다. 이 전환 기간 동안 기존 테마는 새 서비스로 이동됩니다. 마이그레이션 상태 열은 임시이며 이 작업이 진행되는 동안에만 나타납니다.
2025-11-17부터 업로드하거나 액세스하는 모든 테마는 자동으로 새 서비스를 사용합니다. 테마가 정기적으로 사용되는 경우, 별도의 조치가 필요하지 않습니다.
대부분의 테마는 사용될 때 자동으로 마이그레이션됩니다. 최근에 사용하지 않은 테마는 예약된 마이그레이션 실행에 포함되도록 수동으로 대기열에 추가해야 할 수 있습니다. 고객 소유 콘텐츠를 보호하기 위해, Qlik는 테마가 액세스되거나 마이그레이션을 확인하지 않는 한 테마를 마이그레이션하지 않습니다. 사용하지 않는 테마(상태: 마이그레이션되지 않음)를 계속 사용하려면 수동으로 마이그레이션할 수 있습니다.
마이그레이션 상태 값:
-
마이그레이션되지 않음: 테마가 마이그레이션되지 않았습니다.
-
마이그레이션 대기 중: 테마가 대기열에 추가되었으며 다음 예약된 마이그레이션 실행 중에 마이그레이션됩니다.
-
마이그레이션 진행 중: 테마가 현재 마이그레이션되고 있습니다.
-
마이그레이션됨: 테마가 성공적으로 마이그레이션되었습니다.
마이그레이션은 확장에도 적용됩니다. 자세한 내용은 시각화 확장 업로드 및 관리을 참조하십시오.
테마 추가
다음과 같이 하십시오.
- 관리 활동 센터에서 테마로 이동합니다.
- 추가를 클릭합니다.
-
찾아보기를 클릭하여 테마 파일을 선택하거나 지정된 영역에 파일을 놓습니다.
-
필요한 경우 태그를 추가합니다.
-
게시를 클릭합니다.
테마 편집
다음과 같이 하십시오.
- 관리 활동 센터에서 테마로 이동합니다.
-
편집하려는 테마에서
을 클릭하고 편집을 선택합니다.
-
편집 패널을 사용하여 테마를 바꾸거나 태그를 업데이트합니다.
-
변경 내용을 저장합니다.
테마 다운로드
테마를 편집하기 전에 백업하거나 다른 테넌트로 이동하는 데 사용합니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 테마로 이동합니다.
-
다운로드하려는 테마에서
을 클릭하고 다운로드를 선택합니다.
-
ZIP 파일을 저장합니다.
테마 마이그레이션
마이그레이션되지 않음 상태의 테마를 마이그레이션하려면 다음 단계를 사용합니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 테마로 이동합니다.
-
마이그레이션하려는 테마에서
을 클릭하고 마이그레이션을 선택합니다.
마이그레이션이 진행됨에 따라 상태가 업데이트됩니다. 마이그레이션 대기 중, 마이그레이션 진행 중, 마지막으로 마이그레이션됨.
테마 삭제
테마를 삭제하면 모든 리소스에 영향을 미쳐 테넌트 내의 모든 사용자에게 영향을 미칩니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 테마로 이동합니다.
- 삭제하려는 테마를 선택합니다.
- 삭제를 클릭합니다.