複数のバージョンでの作業 | Qlik Cloud ヘルプ
メイン コンテンツをスキップする 補完的コンテンツへスキップ

複数のバージョンでの作業

最終更新日時: 2026/10/20

API Contracts を使用すると、同じ API コントラクトの複数のバージョンを管理できるため、新しいバージョンで変更を準備している間も、公開済みのバージョンを安定した状態に保つことができます。

  • 既存の AP Iバージョンを本番環境で維持しつつ、画期的な変更を新しいバージョンに導入できます。
  • 1 つの場所から公開されたバージョンを追跡および管理します。
  • 既存のバージョンに影響を与えることなく、API の変更作業を実行します。

新しいバージョンを作成すると、すべてのコンテンツが新しいバージョンにコピーされます。これにより、以前のバージョンに影響を与えることなく、最新バージョンを個別に更新できます。

最新バージョンのみ編集可能であり、新しいバージョンは最新バージョンからのみ作成できます。以前のバージョンは読み取り専用です。

API Contracts ホームページには、所有するすべての API と共有する API の全バージョンが表示されます。
API Contracts のホームページ。

新しいAPIバージョンの作成

既存のAPI定義の新しいバージョンを作成

情報メモ

注意:

新しいバージョンは、最新バージョンからのみ作成できます。以前のバージョンは読み取り専用であり、編集または新しいバージョンの作成に使用することはできません。

APIの所有者か、少なくとも1つのAPIバージョンのエディターであること。
  1. ホームページで、新しいバージョンを作成するAPIに移動します。
    必要であればリストを名前でフィルタリングします。
  2. 最新バージョンを開いて [プレビュー] を表示し、次に [新しいバージョンを作成] をクリックします。
    Contacts API と [新しいバージョンを作成] ボタンの表示。
  3. 新しいバージョンを入力します。
  4. [Create] (作成)をクリックします。
新しいバージョンの API が最新バージョンと同じコンテンツで作成されます。 デフォルトではモックとドキュメンテーションが無効になっています。

Qlik Catalog への API バージョンの公開

コラボレーターが Qlik Catalog で見つけられるように、API コントラクトのバージョンを Qlik スペースに公開します。

APIの所有者またはAPIバージョンの編集者である必要があります。

バージョンを公開すると、コントラクト バージョンは API Contracts で不変かつ読み取り専用になります。変更を加えるには、最新バージョンから新しいバージョンを作成し、その新しいバージョンで作業を続行してください。

  1. ホームページで、公開するバージョンをクリックして [プレビュー] を開き、次に [公開] をクリックします。
    Contacts API と [公開] ボタンの表示。
  2. 公開ダイアログ ボックスで、バージョンを公開する Qlik スペースを選択します。
  3. バージョン プレビューを確認し、公開メモを入力します。
  4. [公開] をクリックします。

選択したバージョンは、選択した Qlik スペースに公開され、API Contracts で読み取り専用になります。コントラクトを再度編集する必要がある場合は、まず新しいバージョンを作成してください。

APIバージョンの削除

APIの所有者か編集者であること。
  1. ホームページで、削除したいバージョンの横にあるメニューボタンをクリックし、[Delete] (削除)をクリックします。
  2. [Delete] (削除)をクリックして確定します。
選択されたバージョンで削除されます。API全体を削除する場合は、それぞれのバージョンを削除する必要があります。

バージョンコンテンツのインポート

既存のコントラクトからコンテンツを API バージョンにインポートし、現在のコンテンツを置き換えるか、統合します。

APIの所有者またはAPIバージョンの編集者である必要があります。

この機能を使用すると、新しいバージョンを作成せずに外部のコントラクトファイルからバージョンを更新できます。インポート中もバージョン識別子は保持されます。

これは次とは異なりますAPI Contracts で新しい API を作成する定義のインポート。

  1. 更新対象となるバージョンの[Import version content] (バージョンコンテンツのインポート)を開きます。

    この操作は読み取り専用バージョンでは利用できません。

    この操作には、次の場所からアクセスできます。

    • ホームページで、バージョンの横にある メニュー をクリックし、 [バージョン コンテンツのインポート] をクリックします。
      メニューボタンの[Import version content] (バージョンコンテンツのインポート)オプション。
    • バージョンの [プレビュー] で、メニュー > [バージョン コンテンツのインポート] をクリックします。
      バージョン詳細ビュー
    • バージョンエディターで、[Edit] (編集) > [Import version content] (バージョンコンテンツのインポート)をクリックします。
      バージョンエディターの[Import version content] (バージョンコンテンツのインポート)オプション。
  2. インポートするコントラクトの形式とソースを選択します。
    コントラクトは、ローカルファイル、URL、またはダイアログボックスに直接貼り付けたテキストからインポートできます。
  3. [Behavior] (動作)で、インポートしたコンテンツの適用方法を選択します。
    • 置換: 現在のすべてのコンテンツをインポートしたコントラクトで上書きします。API名、バージョン識別子、仕様バージョンは保持されます。
    • マージ: インポートしたコンテンツを既存のバージョンコンテンツと統合します。API名とバージョン識別子は保持されます。インポートしたエレメントが既存のエレメントと同じ名前を持つ場合、そのエレメントは_mergeサフィックスを付けて名前が変更されます(例: User_merge)。重複するベースURLおよびメディアタイプはスキップされます。
    [Import version content] (バージョンコンテンツをインポート)ダイアログボックス。
  4. [Import] (インポート)をクリックします。

更新されたコンテンツが適用された状態で、バージョンエディターが開きます。

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。