テーマのアップロードと管理
会社の標準的なスタイルに基づく色や背景などのカスタム テーマを追加して、アプリケーションのデザインをカスタマイズできます。テーマのアップロードおよび管理は、管理 アクティビティ センターで実行します。
カスタマイズできる内容
カスタム テーマを使用すると、次の方法でアプリケーションのスタイルを細かく指定できます。
-
色を変更する。
-
画像と背景を追加する。
-
フォント サイズとフォントの色をグローバルまたは詳細なレベルで指定する。
-
カラー パレットを定義する。
-
余白、パディング、間隔をカスタマイズする。
アプリケーション用の独自のテーマを作成する方法については、「Qlik 開発者: カスタム テーマ」を参照してください。アプリケーションのスタイル指定に関する情報については、「アプリケーションのスタイル設定」を参照してください。
必要なロール
テーマをアップロードおよび管理するには、次のいずれかのロールが必要です。
-
テナント管理者
-
Analytics 管理者
-
[テーマを管理] の権限が [許可] に設定されているカスタム ロール。
ファイルの要件と制限
テーマが正しくアップロードされ、正常に動作するように、次のルールに従ってください。
対応ファイル形式
テーマは次のファイル形式のみをサポートします。
-
HTML ファイル
-
CSS ファイル
-
JSONファイル
-
画像 (PNG、JPEG、GIF、SVG)
-
QEXT メタデータ ファイル
-
フォント ファイル
ファイルの命名規則
テーマ内の各ファイルには、ファイル名および拡張が必要です。これらの規則に準拠しないファイルは無視されます。無視されるファイルの例: .gitignore および README。
ファイル サイズとファイル数の制限
テーマの ZIP ファイルには、次の制限があります。
-
最大 ZIP ファイル サイズ: 30MB
-
ZIP 内の単一ファイルの最大サイズ: 30 MB
-
ZIP 内のファイルの最大数: 500
-
解凍後の合計最大サイズ: 100 MB
外部リソースと CSP
テーマに外部リソースへのリンクが含まれる場合、そのリソースのオリジンを Content Security Policy (CSP) の許可リストに登録する必要があります。詳細については、「Content Security Policy (コンテンツ セキュリティ ポリシー) (CSP) の管理」を参照してください。
未対応ファイル形式
セキュリティ上の理由から、テーマには許可されていない MIME タイプのファイルを含めることはできません。MIME タイプ (Multipurpose Internet Mail Extensions) は、ファイルの形式を示します。拡張に許可されていない 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'
テーマの管理
テーマは、管理 アクティビティ センターの [テーマ] ページで管理されます。
テーマ テーブルの情報
-
名前: QEXT ファイルのメタデータ名
-
QEXT バージョン: メタデータ バージョン
-
QEXT ファイル名: テーマ定義ファイルの一意の識別子
-
ステータス: 移行ステータス (一時的)
移行ステータスについて
Qlik は、プラットフォームでのテーマの処理方法の改善を進めています。この移行期間中、既存のテーマは新しいサービスに移動されます。移行ステータス列は一時的なものであり、この作業が進行中にのみ表示されます。
2025-11-17 以降、アップロードまたはアクセスするすべてのテーマは自動的に新しいサービスを使用します。現在そのテーマが通常どおり使用されている場合、アクションは不要です。
ほとんどのテーマは、使用されたときに自動的に移行されます。最近使用していないテーマは、スケジュールされた移行の実行に含めるために、手動でキューに入れる必要がある場合があります。ユーザーが所有するコンテンツを保護するため、Qlik では、テーマにアクセスされるか、ユーザーが移行を承認しない限り、テーマの移行を実施しません。未使用のテーマ (未移行のステータス) を保持しておく場合は、手動で移行を実行できます。
移行ステータスの値:
-
未移行: テーマはまだ移行されていません。
-
移行キューに登録済み: テーマはキューに登録されており、次回のスケジュールされた移行処理の際に移行が実行されます。
-
移行中: テーマは現在移行中です。
-
移行済み: テーマの移行は正常に完了しました。
移行は拡張にも適用されます。詳細については、「ビジュアライゼーション エクステンションのアップロードと管理」を参照してください。
テーマの追加
次の手順を実行します。
- 管理 アクティビティ センターで、 [テーマ] に移動します。
- [追加] をクリックします。
-
[参照] をクリックしてテーマのファイルを選択するか、指定されたエリアにファイルをドロップします。
-
任意でタグを追加します。
-
[公開] をクリックします。
テーマの編集
次の手順を実行します。
- 管理 アクティビティ センターで、 [テーマ] に移動します。
-
編集するテーマで
をクリックし、 [編集] を選択します。 -
編集パネルを使用して、テーマを置き換えるかタグを更新します。
-
変更を保存します。
テーマのダウンロード
テーマを編集する前のバックアップや、別のテナントへの移行の際に実行してください。
次の手順を実行します。
- 管理 アクティビティ センターで、 [テーマ] に移動します。
-
ダウンロードするテーマで、
をクリックし、[ダウンロード] を選択します。 -
ZIPファイルを保存します。
テーマの移行
[未移行] ステータスのテーマを移行するには、次のステップに従ってください。
次の手順を実行します。
- 管理 アクティビティ センターで、 [テーマ] に移動します。
-
移行するテーマで、
をクリックして [移行] を選択します。
移行の進行に伴い、ステータスが更新されます: 移行待ち、移行中、そして最後に移行済み。
テーマの削除
テーマを削除すると、すべてのリソースに影響し、テナント内のすべてのユーザーに影響する可能性があります。
次の手順を実行します。
- 管理 アクティビティ センターで、 [テーマ] に移動します。
- 削除するテーマを選択します。
- [削除] をクリックします。