기본 콘텐츠로 건너뛰기

확장 관리

확장은 관리 콘솔확장 페이지에서 관리됩니다.

Qlik Sense Enterprise SaaS Government 메모Qlik Sense Enterprise SaaS - Government (US)에서는 타사 확장이 지원됩니다. 그러나 타사 확장 사용은 조직이 따르는 보안 및 규정 준수 요구 사항에 따라 ATO(Agency Authority to Operate)의 일부로 정의 및 승인되어야 할 수 있습니다.

외부 리소스에 대한 리소스 요청이 포함된 확장은 Content Security Policy에서 해당 원본을 허용 목록에 추가해야 합니다. 그러지 않으면 확장이 렌더링에서 차단됩니다.

팁 메모업로드하기 전에 확장 및 해당 코드를 검토하는 것이 좋습니다. 자세한 내용은 시각화 확장 (영어로만 제공)을 참조하십시오.

확장 추가 및 사용에 대한 시각적 데모는 Qlik Cloud에서 타사 시각화 확장 사용확장 및 API 키를 참조하십시오.

확장 개요

관리 콘솔확장 페이지에 다음 속성이 표시됩니다.

확장 속성
속성 설명

Name

이 속성은 QEXT 파일에 포함된 메타데이터 이름으로, QEXT 파일 이름과는 다릅니다.

Description

확장의 짧은 설명입니다.

Tags

필터링하기 위한 태그입니다.

Author

확장의 작성자입니다.

QEXT 파일 이름

고유한 식별자입니다. 확장 정의 파일의 파일 이름입니다. 확장의 이름과는 다릅니다.

QEXT 버전

QEXT 파일에 포함된 메타데이터 버전입니다.

Published

게시 날짜입니다.

테이블에서 속성 헤더의 화살표를 사용하여 정렬합니다. 태그 드롭다운 메뉴를 사용하거나 테이블에서 태그를 선택하여 필터링합니다.

외부 리소스가 포함된 확장

외부 리소스에 대한 리소스 요청이 포함된 확장은 Content Security Policy에서 해당 원본을 허용 목록에 추가해야 합니다. 그러지 않으면 확장이 렌더링에서 차단됩니다.

관련 항목:Content Security Policy 관리

지원되지 않는 파일 형식

확장 폴더 내의 최대 파일 크기는 15MB입니다.

보안으로 인해 확장에는 허용되지 않는 MIME 유형을 가진 파일이 포함될 수 없습니다. 예를 들어 확장에 실행 파일 또는 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'
정보 메모확장의 모든 파일에는 파일 이름과 파일 확장명이 있어야 합니다. 그렇지 않은 파일은 무시됩니다. 무시되는 파일의 예: .gitignoreREADME.

확장 생성 및 업로드 지침

Qlik Sense SaaSQlik Sense Enterprise Client-Managed는 다른 확장 서비스를 사용하므로 결과적으로 다른 기능이 있습니다. 시각화 확장을 만들어 Qlik Sense SaaS에 업로드할 때 다음 지침을 따라야 합니다.

  • 확장 ZIP 파일의 크기는 15MB 미만이어야 합니다. 그래야 시간 제한이나 문제 없이 확장을 업로드할 수 있습니다.

  • 코드 파일을 줄입니다.

  • 확장이 제대로 작동하는 데 필요한 파일만 확장 ZIP 파일에 포함합니다. 이 표는 시각화 확장에 필요한 기본 파일을 보여줍니다.

    파일 확장명 설명
    .qext 확장 메타데이터 파일
    .js 확장을 위한 JavaScript 코드

    .html

    확장 렌더링을 위한 HTML 코드
    .css

    확장 스타일링을 위한 사용자 지정 CSS

  • 이미지 파일을 업로드하지 마십시오. GIF, PNG, JPG 및 기타 이미지 파일은 개인 응용 프로그램 서버, S3 버킷 또는 공용 콘텐츠 관리 시스템에서 외부적으로 호스팅되어야 합니다. 확장 코드에서 참조할 수 있습니다.

    정보 메모기본 확장 코드에서 일부 코드 파일 및 콘텐츠를 참조할 수 있습니다. 확장에서 외부 콘텐츠를 참조하려면 테넌트에서 콘텐츠 보안 정책을 구현해야 합니다. 자세한 내용은 Content Security Policy 관리을 참조하십시오.
  • Qlik Sense SaaS 확장 서비스는 번들 확장을 지원하지 않습니다(다른 확장 ZIP 파일을 포함하는 ZIP 파일).

  • Qlik Sense QVF 또는 QVD 파일은 확장 서비스에서 액세스되지 않기 때문에 이러한 파일을 포함하는 확장을 업로드하지 마십시오. 확장을 업로드하기 전에 이러한 파일을 제거합니다.

  • QVF 또는 QVD 파일을 Qlik Sense SaaS 테넌트에 업로드하려면 다음 중 하나를 수행합니다.

    • 클라우드 허브에서 앱을 업로드합니다.

    • qlik-cli를 사용하여 앱을 업로드합니다.

    • 클라우드 허브에서 QVD를 업로드합니다.

    • Qlik DataTransfer를 사용하여 QVD를 업로드합니다.

새 확장 추가

다음과 같이 하십시오.

  1. 관리 콘솔에서 확장 섹션으로 이동하고 오른쪽 상단 모서리에서 추가를 클릭합니다.
  2. 팝업에서 찾아보기를 클릭하여 확장 파일을 선택하거나 지정된 영역에 파일을 끌어서 놓습니다.

    정보 메모기존 파일 이름과 동일한 QEXT 파일 이름을 가진 확장은 업로드할 수 없습니다.
  3. 필요한 경우 태그를 추가합니다.

  4. 게시를 클릭합니다.

  5. 업로드한 확장에 외부 리소스가 포함된 경우 Content Security Policy에서 원본을 허용 리스트에 추가해야 합니다. Content Security Policy 관리을 참조하십시오.

확장 편집

한 번에 하나의 확장을 편집할 수 있습니다.

다음과 같이 하십시오.

  1. 관리 콘솔에서 확장 섹션으로 이동하고 편집할 확장에 대한 확인란을 선택합니다.
  2. 오른쪽 위 모서리에서 편집을 클릭합니다.

    편집 패널에 기존 확장 교체 및 태그 추가 또는 제거 옵션이 표시됩니다.

  3. 편집하고 저장합니다.

확장 삭제

다음과 같이 하십시오.

  1. 관리 콘솔에서 확장 섹션으로 이동하고 삭제할 확장에 대한 확인란을 선택합니다.
  2. 오른쪽 위 모서리에서 삭제를 클릭합니다.
정보 메모확장을 삭제하면 모든 리소스에 영향을 미칠 수 있습니다. 테넌트 내의 모든 사용자가 삭제의 영향을 받습니다.