さまざまな方法を使用してバージョン管理オブジェクトを管理する方法を学習します。
ロック方法でバージョン管理オブジェクトを管理する
これらの手順は、ロック方法でバージョン管理されているオブジェクトに適用されます。
ロック方法が使用されている場合、次のオブジェクトがバージョン管理されます: ジオエクスプローラー、ネットワーク、代替需要オブジェクト、コントロール、ライブ データ コンフィギュレーション、デジタル化テンプレート、ベースライン。
- バージョン管理オブジェクトを変更するには、そのオブジェクトをチェック アウトする必要があります(新しく作成されたオブジェクトは自動的にチェック アウトされます)。
- ユーザーがオブジェクトをチェック アウトしている間は、他のユーザーがそのオブジェクトを変更することはできません。
- オブジェクトでの作業が終了したら、チェック イン(またはチェックアウトを取り消し)する必要があります。
オブジェクトをチェック アウトする
既存のバージョン管理オブジェクトを変更する場合は、チェック アウトする必要があります。
バージョン管理オブジェクトをチェック アウトするには
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、オブジェクトを右クリックします。
- メニューから[チェック アウト]を選択します。
新しいオブジェクトの名前が提案されますが、必要に応じて変更できます。
- オブジェクト をチェック アウトするには、[OK]をクリックします。
新しいバージョンのオブジェクトが作成され、チェック アウトしたオブジェクトの下にネストされます。
チェック アウトされたオブジェクトには、そのアイコンの周囲に太い赤い枠線が表示されます。
これで、チェック アウトしたオブジェクトを開いて変更を加えることができます。変更が完了したら、新しいバージョンをチェック インして、他のユーザーが作業できるようにする必要があります。
オブジェクトを分岐する
バージョン管理オブジェクトの代替バージョンを作成する場合は、分岐を生成する必要があります。
バージョン管理オブジェクトを分岐するには
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、分岐するオブジェクトを右クリックします。
- メニューから[チェック アウト/分岐]を選択します。
新しいオブジェクトの名前が提案されますが、必要に応じて変更できます。
- オブジェクトをチェック アウトして分岐するには、[OK]をクリックします。
これで、バージョン管理オブジェクトを編集し、新しい分岐を作成できるようになりました。変更が完了したら、新しい分岐をチェック インします。
新しい分岐の既定の名前は、分岐元のバージョンの名前の後にアンダースコアと分岐番号を続けて構成されます。たとえば、Wallingford#4 というオブジェクトからの最初の分岐には、既定の名前 Wallingford#4_1 が与えられます。
オブジェクトを比較する
2 つのバージョン管理オブジェクトを比較して、オブジェクトの異なる部分を特定できます。結果は画面に出力したり、CSV ファイルやテキスト ファイルに保存できます。
Oracle データベースを使用している場合は、1 つの資産のチェック イン済みネットワーク バージョン間の違いに関するレポートも作成できます。詳細については、「資産の履歴を表示する」を参照してください。
2 つのオブジェクトを比較する
- [ネットワーク比較選択]ダイアログを表示します。
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウでバージョン管理オブジェクトを右クリックし、ポップアップ メニューから[比較]を選択します。これにより、クリックしたネットワーク オブジェクトが入力された[これらを比較]フィールドを含む[ネットワーク比較選択]ダイアログが表示されます。
- または、モデル グループ ウィンドウまたはエクスプローラ ウィンドウで比較する 2 つのオブジェクトを選択し、ポップアップ メニューから[比較]を選択します。[ネットワーク比較選択]ダイアログが表示され、選択したオブジェクトが入力された [これらを比較] および[使用]フィールドが表示されます。
- [使用]ボックスにまだ入力されていない場合は、比較するバージョン管理オブジェクトを選択するか、[ソース]ボックスをオンにして、[使用]ボックスに比較するオブジェクトの親を自動的に入力します。
- 必要に応じて、選択リストを含めることで、比較対象オブジェクト内の選択したオブジェクトに比較を制限します。このオプションは、ベースラインには適用されません。
- 必要に応じてオプションを選択します。
- フラグの変更を無視: 比較レポートからフラグの差異を省略します。
- 変更されたオブジェクトの選択: 比較するネットワークが開いている場合、変更されたすべてのオブジェクトがジオプラン ウィンドウで強調表示されます。
- デフォルトによる変更を無視: 比較レポートで #D のフラグが設定されたフィールド間の差異を省略します。
- 資産 ID に基づいて比較: 同じ資産 ID を持つオブジェクトまたはオブジェクトのセットを比較することで、ネットワークを比較します。このオプションは、ネットワークを比較する際にのみ使用できます。
- 比較レポートの保存先を選択します。
- スクリーン: レポートは、[一般的なテキスト ファイル]ビューに表示されます。その後、レポートを印刷したり、ファイルに保存したり、データをクリップボードにコピーできます。
- ファイル: レポートがファイルに保存されます。隣接する入力ボックスにファイルの名前と場所を指定します。
- CSV ファイル: 最初のオブジェクトのデータのうち、2 番目のオブジェクトと異なるものをすべて含む CSV ファイルが作成されます。隣接する入力ボックスに CSV ファイルの名前と場所を指定します。
- 操作を完了するには、 [比較] ボタンをクリックします。ダイアログは表示されたままとなり、必要に応じて別の比較を設定できます。
開いているネットワークを他の複数のネットワークと比較する
現在開いているネットワークを、複数のネットワークと比較できます。ネットワークに現在関連付けられている他のバージョン管理オブジェクトがある場合は、これらのオブジェクトも比較対象に含めることができます。
複数のオブジェクトと比較するには、[ネットワーク]メニューから[ネットワーク比較選択]ダイアログを呼び出す必要があります
- [ネットワーク]メニューから[比較]を選択します。これにより、[ネットワーク比較選択]ダイアログが表示されます。
- 1 つまたは複数のネットワークを、[ネットワーク比較選択]ダイアログの[使用]ボックスにドラッグします。
- 関連付けられているバージョン管理オブジェクトを[使用]ボックスにドラッグします。有効なオブジェクト タイプのみを含めることができます。
比較するたびに、個別のレポートが生成されます([ネットワーク]メニューからオブジェクトを比較する場合、レポートを CSV ファイルに出力することはできません)。
CSV ファイルを使用して他のオブジェクトに変更を適用する
比較によって生成された CSV ファイルは正しい形式であるため、他のバージョン管理オブジェクトに同じ変更を適用するために使用できます。
- モデル グループ ウィンドウでチェック アウトされたバージョン管理オブジェクトを右クリックし、[更新]
[CSV から]を選択します。[CSV データからのインポート/更新]ダイアログが表示されます。
- 「CSV データから更新する」で説明されている手順に従って、次のオプションを忘れずに設定してください。
- [更新タイプ]は[混合] (データ フィールドに基づく)にする必要があります。このオプションでは、オブジェクトを削除する場合に必要になる[操作]フィールドを使用します。
- [CSV 内の空白フィールドで既存データを上書き]がオフになっていることを確認します。バージョン間で変更されていないフィールドは、CSV ファイルで空白のままとなります。
- 処理を完了するには、[OK]をクリックします。
ネットワークのデータは CSV ファイルのデータで上書きされます。削除対象としてマークされたすべてのオブジェクトが削除されます。
重複したオブジェクト
データベース内の選択したモデル グループ内に、バージョン管理オブジェクトの複製を作成できます。
複製は、さまざまな分析オプションの開始点を作成するために使用できます。
バージョン管理オブジェクトを複製するには
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、複製するチェック インしたオブジェクトを右クリックします。
- メニューから[複製]を選択します。
- 複製を作成するモデル グループを選択し、[OK]をクリックします。[新しい名前]ダイアログに、新しいオブジェクトの名前が示されます。必要に応じて、ここで名前を変更できます。
- 複製オブジェクトを作成するには、[OK]をクリックします。
選択したモデル グループに複製オブジェクトが作成されます。元のオブジェクトと同様に、複製はバージョン管理のロック方法に従います。
複製オブジェクトの既定の名前は、元のオブジェクトの名前の後に ' - Copy' を付けたものです。元のオブジェクトを再度複製すると、複製の名前の後に ' - Copy (2)' などと付けられます。
新しいオブジェクトのアイコンは青色で表示されます。
オブジェクトを結合する
2 つのバージョン管理オブジェクトを結合して、元の 2 つのオブジェクトのデータをすべて含む新しいバージョン管理オブジェクトを形成することができます。新しいバージョン管理オブジェクトは、最初に選択したオブジェクトの新しいバージョンか、そのオブジェクトからの分岐になります。
2 つのバージョン管理オブジェクトを結合するには
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、新しいバージョンまたは分岐の作成元となるバージョン管理オブジェクトを右クリックします。オブジェクトはチェック インされている必要があります。
- 結合したオブジェクトを最初のオブジェクトの新しいバージョンにする場合は、ポップアップ メニューから[結合]を選択します。または、結合したオブジェクトを新しい分岐にする場合は、[結合して分岐]を選択します。
- 最初のオブジェクトと結合するオブジェクトを探して選択し、[OK]をクリックします。正しいタイプのバージョン管理オブジェクトのみを選択できます。
オブジェクトの名前が提案されますが、変更することができます。
- 結合したオブジェクトを作成するには、[OK]をクリックします。
オブジェクトをチェック インする
バージョン管理オブジェクトがチェック アウトされている間、他のユーザーは変更できません。したがって、オブジェクトの変更や新しい分岐の作成が完了したら、できるだけ早くチェック インする必要があります。
バージョン管理オブジェクトをチェック インするには
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、チェック インするオブジェクトを右クリックします。
- メニューから[チェック イン]を選択します。
オブジェクトが検証可能なタイプであり、検証していない場合は、InfoWorks WS Pro によりプロンプトが表示されます。
- オブジェクトを検証するには[はい]をクリックし、検証せずにオブジェクトをチェック インするには[いいえ]をクリックします。
検証後、エラーが発生した場合は警告が表示されます。
- オブジェクトをチェック インするには[はい]をクリックし、エラーを調査または修正するには[いいえ]をクリックします。
[チェック イン コメント]ダイアログが表示されます。このダイアログには、オブジェクトの[プロパティ]ダイアログの[記述]ページに追加されたすべてのコメントが含まれています。
- [チェック イン コメント]ダイアログで、必要に応じてコメントを編集し、オブジェクトをチェック インするには[OK]をクリックします(または、チェック インを停止して編集を続けるには[キャンセル]をクリックします)。
チェック アウトしたオブジェクト内の中間バージョンがシミュレーションで使用されている場合は、[中間バージョンを保持]ダイアログが表示されます。
- 中間バージョンをチェック インするランを選択し、[OK]をクリックします。
新しいバージョンまたは分岐がチェック インされると、他のユーザーが編集できるようになります。
チェックアウトを取り消す
バージョン管理オブジェクトに変更を加えていない場合、または変更内容を保存しない場合は、チェックアウトを取り消すことができます。
チェックアウトを取り消すには
- チェック アウトしたオブジェクトがワークスペース内で開いている場合は、それを閉じます。
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、チェック アウトしたオブジェクトを右クリックします。
- メニューから[チェック アウトを戻す]を選択します。
警告メッセージが表示されます。
- チェックアウトを取り消すことを確認するには、[はい]をクリックします。
作成していたバージョンまたは分岐はデータベースに保存されません。
チェックインを取り消す
バージョン管理オブジェクトのチェックインは取り消すことができ、これにより、オブジェクトのステータスはチェック アウトに戻ります。
[チェック インを戻す]オプションは、以前にチェック インしたオブジェクトが分岐の最後のオブジェクトであり、他のオブジェクト(ランなど)によって参照されていない場合に使用できます。
チェックインを取り消すには
- チェック インしたオブジェクトがワークスペース内で開いている場合は、それを閉じます。
- エクスプローラ ウィンドウまたはモデル グループ ウィンドウで、チェック インしたオブジェクトを右クリックします。
- メニューから[チェック インを戻す]を選択します。
チェックインを戻すことができない場合は、警告メッセージが表示されます。
合併方法でバージョン管理オブジェクトを管理する
これらの手順は、合併方法でバージョン管理されているオブジェクトに適用されます。
合併方法が使用されている場合、次のオブジェクトがバージョン管理されます: ジオエクスプローラー、ネットワーク、代替需要オブジェクト、コントロール、ライブ データ コンフィギュレーション、ベースライン、DemandWatch コンフィギュレーション、デジタル化テンプレート。
- 自分の変更を行う前に、他のユーザーの変更を取得することが重要です。
- 他のユーザーが表示できるように、変更をデータベースにコミットします。
- 自分のコミット内容と他のユーザーのコミット内容の間の競合を解決します。
他のユーザーによる変更を取得する
他のユーザーによる変更を定期的に取得して、同じデータに対して競合する変更が加えられる可能性を最小限に抑えることが重要です。他のユーザーによる変更を取得すると、解決を必要とする競合が発生する可能性があります。競合が解決されるまで、変更はコミットできません。
バージョン管理アイテムを他のユーザーの変更で更新するには
- モデル グループ ウィンドウでデータベース アイテムを右クリックし、[更新(他のユーザーの変更から)]を選択します。
別のユーザーによる変更と競合する変更が行われた場合、これらの競合を解決する必要があります。競合がある場合は、[更新の矛盾を解決]ダイアログが表示されます。詳細については、「競合の解決」を参照してください。
変更をコミットする
バージョン管理データベース アイテムに変更を加えると、これらの変更はネットワークのユーザー独自のローカル コピー(ローカル作業フォルダ内)に格納されます。これらの変更を他のユーザーが使用できるようにするには、その変更をデータベースにコミットする必要があります。
変更をコミットするには
- モデル グループ ウィンドウでデータベース アイテムを右クリックし、[変更内容をデータベースにコミット]を選択します。
[サーバーへの変更を確定]ダイアログが表示されます。このダイアログで次の操作を行うことができます。
- 加えられた変更、追加、削除の概要を確認する
- 他のユーザーがバージョン管理アイテムの履歴を見るときに確認できるコメントを追加する
- 現在のバージョンのデータベース アイテムを、データベース内の最新バージョン、または同じタイプのまったく別のアイテムと比較する(これを行うには、[差異]ボタンをクリックします)
- 変更内容をコミットするには、[OK]をクリックします(または、コミット操作を中止して[サーバーへの変更を確定]ダイアログを閉じる場合は、[キャンセル]をクリックします)。
データベース アイテムのローカル コピーは他のユーザーによる変更で更新され、他のユーザーによる変更と競合しない限り、自分の変更内容はデータベースにコピーされます。競合がある場合は、[更新の矛盾を解決]ダイアログが表示されます。詳細については、「競合の解決」を参照してください。
自分の変更を元に戻す
データベースに対して最後に変更をコミットしてから、バージョン管理アイテムに対して行ったすべての変更を破棄することができます。
(最近の単一の変更を元に戻すには、[編集]メニューの[元に戻す]オプションを使用します。)
最後にコミットした変更以降に行ったすべての変更を破棄するには
- モデル グループ ウィンドウでデータベース アイテムを右クリックし、[変更を元に戻す]を選択します。
警告のダイアログが表示されます。
- 前回のコミット以降に行ったすべての変更を元に戻すには、[OK]をクリックします。
競合を解決する
他のユーザーの変更を取得するときに矛盾が発生すると、ローカル データベースが更新され、矛盾しているオブジェクトの数を示すメッセージが表示されます。
- [OK]をクリックすると、[更新の矛盾を解決]ダイアログが表示されます。
このダイアログには、1 つのオブジェクトに対する矛盾が表示されます。矛盾するオブジェクトのリストをスクロールして、各オブジェクトの矛盾を順番に解決できます。現在解決中のオブジェクトは、グリッド ウィンドウとジオプランで強調表示されます。
ダイアログの上部にあるボタンを使用すると、すべての矛盾しているオブジェクトを操作できます。
この行の下にあるすべての情報は、現在のオブジェクト内の矛盾を表します。
- 選択した内容で現在のオブジェクトの矛盾をすべて解決できたら、[矛盾を解決]ボタンをクリックしますこれにより、選択した値が適用され、オブジェクトが解決済みとしてマークされ、矛盾のある次のオブジェクトに自動的に移動します。
- 未解決の矛盾をすべて解決したら、[確定]ボタンをクリックします。
これにより、変更をコミットするための[変更をコミット]ダイアログが表示されます。
コミット履歴を表示する
データベースに変更をコミットするたびに、行った変更が永続的に記録されます。これらは、変更の次のバッチが行われるときに上書きされないため、バージョン管理アイテムの履歴全体を確認することができます。
バージョン管理アイテムのコミット履歴を表示するには
- モデル グループ ウィンドウでデータベース オブジェクトを右クリックし、[コミット履歴の表示]を選択します。
[コミット履歴]ダイアログが表示されます。InfoWorks WS Pro がデータベースから履歴をダウンロードするため、ダイアログが表示されるまでに多少の遅延が生じる場合があります。
このダイアログでは次のことができます。- ユーザー ID、変更されたオブジェクトの数、その時点で書き込まれたコメントなど、以前のコミットの詳細を表示する。
- [差異]ボタンを使用して、2 つのバージョン間の差異を表示する。「同じオブジェクトの 2 つのバージョンを比較する」を参照してください。
- 以前のバージョンのデータベース アイテムを(読み取り専用コピーとして)開く。
- 分岐を作成する。「分岐を作成する」を参照してください。
- コンテキスト メニューの[選択アイテムをクリップボードにコピー]オプションを使用して、履歴をクリップボードにコピーする。
- [コピー]ボタンを使用して、データベース内の別の場所にあるオブジェクトのコピーを作成する。
- ダイアログの作業が終了したら、[閉じる]をクリックします。
コミットされていない変更を表示する
バージョン管理アイテムのローカル コピーをデータベース内の最新バージョンと比較すると、コミットされていない変更をリストできます。
- モデル グループ ウィンドウで、バージョン管理オブジェクトを右クリックし、[比較]を選択します。
これにより、[比較]ダイアログが表示されます。
- [確定されていない自身の変更内容]オプションを選択します。
- オプションとして、[オプション]セクションで無視条件を設定します。
- [出力]セクションで、レポートの出力先を選択します。
- [差異を表示]ボタンをクリックします。
同じオブジェクトの 2 つのバージョンを比較する
2 つのバージョンを比較して、バージョンの異なる部分を特定できます。
- モデル グループ ウィンドウで、バージョン管理オブジェクトを右クリックし、 [コミット履歴の表示] を選択します。
これにより、[コミット履歴]ダイアログが表示されます。
- アイテムの 2 つのバージョンを選択し、 [差異] ボタンをクリックします。
これにより、[比較]ダイアログが表示されます。[他のネットワークとの差異] オプションが自動的にオンになります。
- 必要に応じてダイアログのオプションを設定し、 [差異を表示] ボタンをクリックします。
2 つの異なるバージョン管理オブジェクトを比較する
2 つの個別のバージョン管理オブジェクトを比較して、オブジェクトの異なる部分を特定できます。
- モデル グループ ウィンドウで、バージョン管理オブジェクトを右クリックし、[比較]を選択します。
これにより、[オブジェクトを比較]ダイアログが表示されます。
- [他のネットワークとの差異]オプションを選択します。
- 比較するバージョン管理オブジェクトを選択します。ツリーからボックスにドラッグするか、参照機能を使用して比較オブジェクトを選択します。
- 必要に応じてダイアログのオプションを設定し、[差異を表示]ボタンをクリックします。
分岐を作成する
- 資産データに影響を与えることなくなんらかの "what if" 分析を行う必要がある場合
- その後にエラーが明るみに出て、それらを破棄することが最も簡単な修正方法であるため、前のバージョンに戻す必要がある場合
分岐を作成するには
- モデル グループ ウィンドウで、バージョン管理オブジェクトを右クリックし、[コミット履歴の表示]を選択します。
[コミット履歴]ダイアログが表示されます。
- 分岐を作成するデータベース オブジェクトのバージョンのグリッド行を選択します。
新しい分岐は、ハイライト表示したバージョンまで元のデータベース オブジェクトの履歴を共有します。
- [分岐]ボタンをクリックします。
新しい分岐の名前を確認するように求められます。元のデータベース オブジェクトの名前に基づく名前が提案されます。この名前は、必要に応じて変更できます。
- 準備ができたら、[OK]をクリックします。
InfoWorks WS Pro により、データベース ツリーの親データベース アイテムの下に分岐が作成されます。
- [コミット履歴]ダイアログの作業が終了したら、[閉じる]をクリックします。
データベース ツリーで新しいデータベース オブジェクトを使用できるようになります。作成元のネットワーク オブジェクトよりも 1 ステップ下にあります。2 つのデータベース オブジェクトの履歴は分岐点まで同じです。
バージョン管理オブジェクトを保留する
バージョン管理オブジェクトを保留して、他のユーザーが変更をコミットできないようにすることができます。これにより、ユーザーは、変更をコミットするときに競合が発生しないようにしながら、データベース アイテムに複雑な変更を加えることができます。バージョン管理オブジェクトに対する保留は、いつでも削除できます。
バージョン管理されたオブジェクトを保留または保留解除するには
- モデル グループ ウィンドウで、バージョン管理オブジェクトを右クリックし、[高度なオプション]を選択します。
- 次のオプションの 1 つを選択します。
オブジェクトの保留: ローカル データベース オブジェクトが古い場合はサーバーからの最新バージョンで更新され、オブジェクトが保留されます。バージョン管理オブジェクトが保留されている場合、他のユーザーは変更をコミットできなくなります。バージョン管理データベース オブジェクトが既に保留されている場合は、そのアイテムを保留しているユーザーの詳細を含むメッセージが表示されます。
オブジェクトの保留を解除: 保留はデータベース オブジェクトから削除されます。これで、他のユーザーがオブジェクトに変更をコミットできるようになります。この場合、保留を最初に適用したユーザーのみが保留を削除できます。このオプションを使用して別のユーザーが保留を削除しようとすると、保留解除は失敗します。
オブジェクトの保留を強制解除: どのユーザーがデータベース オブジェクトを保留したかに関係なく、オブジェクトから保留が削除されます。これで、すべてのユーザーがデータベース アイテムへの変更をコミットできるようになります。