Helix Swarmガイド (2020.1)

チェンジリスト

チェンジリストは、Helix Coreサーバにおけるバージョン管理の基本単位です。 チェンジリストには、ファイルリストとそのリビジョン番号、およびそれらのファイルに対して行われた変更が含まれます。 コミットとは、Swarm全体で使用される短い同義語です。

詳細については、以下を参照してください。

チェンジリストの表示

特定のチェンジリストファイル、バージョン番号、ファイルに行われた変更、および行われた変更についての説明のリストです。 チェンジリストは、Helixサーバにおけるバージョン化作業の基本単位です。 チェンジリストで指定された変更は、チェンジリストがディポにサブミットされるまでディポには保存されません。 「アトミックチェンジトランザクション」と「チェンジリスト番号」も参照してください。 を表示するには、チェンジリスト番号のリンクをクリックするか、次のURLにアクセスします: https://myswarm.url/changes/changelist number

Swarmで変更を表示すると、以下のような表示内容になります。

変更ページの画像

ストリームのプライベート編集機能を使用してワークスペース内で編集されたストリーム仕様をSwarmで使用することができます。 チェンジリストやレビューにストリーム仕様が含まれている場合、[ファイル]タブの先頭にそのストリーム仕様が表示されます。このストリーム仕様には、「stream: //」というプレフィックスが付加されます。例えば、「stream://MyStreamDepotName/MyStreamSpecLocationName」などのように表示されます。 レビューとチェンジリストに含めることができるストリーム仕様はそれぞれ1つだけです。

チェンジリストの表示内容は次のとおりです。

  • 変更を行ったユーザのアバターとユーザID
  • 変更が行われた時刻
  • 変更対象のすべてのファイルが含まれている共通ディポの場所
  • チェンジリスト内のすべてのファイルが格納されるZIP形式のアーカイブファイルをダウンロードするには、[.zipをダウンロード]ボタンを使用します。

    注意

    zipコマンドラインツールがSwarmサーバにインストールされていない場合、[.zipをダウンロード]ボタンは表示されません。 zipコマンドラインツールのインストール方法と構成方法については、「Zip形式のアーカイブファイル」を参照してください。

    [.zipをダウンロード]ボタンをクリックすると、Swarmによって以下の手順が実行されます。

    1. ファイル/フォルダのスキャン:
      • Helix Coreサーバの保護設定に従い、操作を実行するユーザが、ファイルやフォルダ内のコンテンツに対する権限を持っているかどうかを確認します。
      • ファイル全体のサイズがSwarmで処理可能なサイズであるかどうかを確認します。
    2. Helix Coreサーバで、ファイルのコンテンツをSwarmサーバに対して同期します。
    3. ファイルのコンテンツを圧縮してZIP形式のアーカイブファイルを作成します。
    4. 生成されたZIPアーカイブファイルのダウンロードを開始します。
    注意
    • Swarmは、生成されたZIPアーカイブをキャッシュに格納することにより、同じファイルやフォルダに対する要求が繰り返し発行された場合に、同期処理や圧縮処理を可能な限りスキップするため、上記の手順の一部が実行されない場合があります。
    • スキャン、同期、または圧縮の実行中にエラーが発生した場合は、Swarmによってそのエラーが表示されます。
  • コードレビュー内に変更が含まれている場合は、[レビューを表示]ボタンとともにレビューのリンクが表示されます。
  • 変更内容の詳細
  • この変更によって修正されるジョブのリスト(ある場合) ここで、ジョブの追加およびジョブのリンクを解除することができます。
  • 共通ディポの場所およびファイル間のすべてのフォルダ、ファイルのバージョン番号など、変更に含まれるファイルのリスト。
  • 変更または変更ファイルに関するコメントを確認するタブ。

各ファイルは差分表示で表示され、ファイルの追加、変更、削除が示されます。 テキストベールファイルまたは画像ファイルの場合、そのファイル内で行われた変更をSwarmで表示することができます。 1つのファイルのみの変更の場合は、デフォルトで差分表示されます。ファイルが複数ある場合は、各ファイルが一覧で表示されます。 差分表示で見るには、ファイル名をクリックしてください。 詳細については、「差分」を参照してください。

[レビューを要求]ボタンは、この変更に対してレビューレコードがまだ作成されていないという状態を示しています。 [レビューを要求]ボタンをクリックすると、この変更のコードレビューが開始されます。 詳細情報については、「レビューの開始」を参照してください。

重要

使用しているHelixサーバがコミットエッジ展開として構成されていて、通常の接続先がエッジサーバである場合、Swarmは、コミットサーバに昇格されていない保留状態の変更のレビューの開始を拒否します。

この状態の場合、Swarm内では、昇格されていない保留状態の変更に対して[レビューを要求]ボタンは表示されません。 また、Swarmの外部では、昇格されていない保留状態のチェンジリストのレビューを開始しようとしても、何も実行されません。 レビューを開始できない場合は、Helixサーバの管理者に問い合わせてください。

Helixサーバの管理者は、構成可能変数dm.shelve.promoteを「1」に設定することにより、保留中の変更をコミットサーバに自動的に昇格させることができます。

チェンジリスト内のファイルに1つ以上のコメントが関連付けられている場合、ファイルエントリの右端近くに コメントアイコンの画像 アイコンが表示されます。