制御された編集でロードスクリプトを更新する

最終更新日時: 2026-11-03

Qlik Code の制御された編集機能を使用すると、ローカルで編集するためにアプリケーションのロードスクリプトの作業コピーをご使用のマシンにダウンロードできます。これらのローカルコピーは、バインディングを介してソースアプリケーションに接続されています。受信変更と送信変更をプルおよびプッシュすることで、ローカルスクリプトをリモートの Qlik Cloud バージョンと同期できます。ローカル QVS ファイルを編集して Qlik Code の Qlik Cloud アプリケーションにバインドすることもできるため、最初にアプリケーションを作成することなくローカルスクリプトを構築できます。

このワークフローにより、スクリプトのローカルコピーを Qlik Cloud アプリケーションに対して保存、更新、同期することができます。簡単な検査や迅速な編集のワークフローについては、「Qlik Cloud に対して直接ロードスクリプトを更新する」を参照してください。

バインディングとは何ですか？

Qlik Code では、バインディングとは、ロードスクリプトのローカル作業コピー（または別のローカル QVS ファイル）と Qlik Cloud 内の分析アプリケーションとの間の接続です。

バインディングは、次の場合に作成されます：

ローカルで編集するために、スクリプトの作業コピーをダウンロードします（「 スクリプトの作業コピーのダウンロード」を参照）。
別の QVS ファイルを既存のアプリケーションに手動でバインドします（「既存のローカルファイルのバインド」を参照）。

バインディングが作成されると、拡張はローカルファイルと Qlik Cloud アプリケーションの関係をワークスペースのルートにある resource-map.json ファイルに保存します。

スクリプトの作業コピーのダウンロード

アプリケーションのロードスクリプトの作業用コピーをローカルマシンにダウンロードできます。この操作を行うと、ロードスクリプトのコピーが QVS 形式でワークスペースにダウンロードされ、ローカルに作成されたファイルとソースアプリケーションの間にバインディングが自動的に作成されます。

ローカル作業コピーは、デフォルト作業コピーフォルダー設定（「設定の参照」を参照）で指定されたフォルダー、またはその設定が空の場合はワークスペースのルートに保存されます。

次の手順を実行します。

VS Code Explorer で、Qlik Cloud を展開します。
アプリケーションを見つけて右クリックします。
作業コピーをダウンロードするをクリックします。

ワークスペースにスクリプトのローカルコピーが既に 1 つ以上存在する場合、別のオプションが表示されます：ダウンロード済みリソース...。このオプションを使用すると、既存のローカルファイルに移動できます。

ローカルコピーをダウンロードしてバインドした後は、編集したり、リモートの Qlik Cloud バージョンからの変更を取り込んで更新したり、自身のローカルの変更をリモートの Qlik Cloud バージョンにプッシュしたりできます。「ローカルバージョンとリモートバージョン間の変更同期」を参照してください。

既存のローカルファイルのバインド

また、ローカルコンテンツを上書きすることなく、既存のローカル QVS ファイル（現在アプリケーションに接続されていないファイル）を Qlik Cloud アプリケーションにバインドすることもできます。バインディングは、ファイルをアプリとその現在のスクリプトバージョンにリンクします。

次の手順を実行します。

VS Code Explorerで、バインドするローカルファイルを右クリックします。
Qlik Cloud スクリプトにバインドするをクリックします。
バインド先の Qlik Cloud アプリケーションを選択します。

ファイルを手動でバインドした後は、ファイルを編集したり、リモートの Qlik Cloud バージョンから受信した変更で更新したり、独自のローカル変更をリモートの Qlik Cloud バージョンにプッシュしたりすることができます。「ローカルバージョンとリモートバージョン間の変更同期」を参照してください。

スクリプトのバインド解除

どちらのコピーも削除せずにローカルファイルとリモートバージョン間のリンクを解除するには、Qlik: Unbind from QCS Resource コマンド（コマンドパレットから利用可能）を使用します。

ローカルバージョンとリモートバージョン間の変更同期

アプリケーションのロードスクリプトを編集する権限が必要です。表示権限のみがある場合、スクリプトを読み取り専用モードで開くことはできますが、編集することはできません。

スクリプトをダウンロードまたは手動でバインドした後、VS Code テキストエディターを使用して編集できます。

Qlik Code では、次のオプションが提供されます：

リモートの Qlik Cloud バージョンに加えられた変更でローカルスクリプトを更新しています。例えば、別のユーザーが Qlik Cloud 内で、または各自でインストールした Qlik Code を使用してロードスクリプトを編集します。
自身の変更をリモートQlik Cloudバージョンにプッシュする。

個別スクリプトの同期

スクリプトを個別に同期できます。

次の手順を実行します。

VS Code Explorer で、スクリプトのローカル作業コピーを見つけます。
ファイルを右クリックし、次のいずれかを選択します：
- Qlik Cloud からプルする：前回のダウンロードまたは更新以降にスクリプトに加えられた変更で、ローカルコピーを更新します。
- Qlik Cloud に変更をプッシュする：ローカルの変更をリモートの Qlik Cloud バージョンにプッシュします。既存のスクリプトの置き換えを確認するよう求められます。

スクリプトの一括同期

スクリプトを一括で同期することもできます。これらのアクションを実行すると、アクセス権を持つすべてのアプリケーションおよび作業コピーに対して変更がプッシュ/プルされます。

次の手順を実行します。

VS Code Explorer で、Qlik Cloud を展開します。
パネルツールバーで、次のいずれかを選択します：
- （Qlik Cloud からすべて更新する）：前回のダウンロードまたは更新以降にスクリプトに加えられた変更で、すべてのローカルコピーを更新します。
- （すべての変更を Qlik Cloud にプッシュする）：すべてのローカルの変更を、リモートの Qlik Cloud バージョンにプッシュします。