ファイルセットを反映元から反映先にマッピングするには、ブランチマッピングを作成し、p4 integrateコマンドを発行する際に引数として使用することができます。ブランチマッピングを作成するには、p4 branch branchnameコマンドを発行し、対象とするマッピングView:フィールドで指定します。このとき、反映元ファイルを左側、反映先ファイルを右側に示します。反映先ファイルとディレクトリがクライアントビューにあることを確認してください。ブランチマッピングを作成または変更しても、ディポ内またはクライアントワークスペース内のファイルには一切影響しません。ブランチマッピングは反映元ファイルを反映先ファイルにマッピングするだけです。

ブランチマッピングを使用してブランチを作成するには、p4 integrate -b branchnameコマンドを発行します。その後、p4 submitを使用して反映先のファイルをディポにサブミットします。

クライアントビューと同様、ブランチ仕様には、複数のマッピングと除外マッピングを含めることができます。例えば、次のブランチマッピングは、テストスクリプトを除いて、メインのコードラインからJam 1.0ソースコードをブランチします。

Branch:   jamgraph-1.0-dev2release

View:
    //depot/dev/main/jamgraph/...       //depot/release/jamgraph/1.0/...
    -//depot/dev/main/jamgraph/test/... //depot/release/jamgraph/1.0/test/...
    //depot/dev/main/bin/glut32.dll     //depot/release/jamgraph/1.0/bin/glut32.dll

上記のブランチマッピングを使用してブランチを作成するには、次のコマンドを発行し、

p4 integrate -b jamgraph-1.0-dev2release

p4 submitを使用して変更をサブミットします。

ブランチマッピングを削除するには、p4 branch -d branchnameコマンドを発行します。ブランチマッピングを削除しても、既存のファイルやブランチには一切影響しません。

ワークスペースビューと同様、ブランチビューにあるファイル名またはパスに空白が含まれる場合、必ずパスを引用符で囲んでください。

//depot/dev/main/jamgraph/... "//depot/release/Jamgraph 1.0/..."

ファイル仕様を使用してブランチするには、反映元ファイルと反映先ファイルを指定してp4 integrateコマンドを発行します。反映先ファイルはクライアントビューになければなりません。反映元ファイルがクライアントビューにない場合、ディポシンタックスを使用して指定します。

ファイル仕様を使用してブランチを作成するには、以下の手順を実行します。

ストリームで作業するには、ストリームに関連付けられたワークスペースを作成しなければなりません。ワークスペースをストリームに関連付けると、Perforceはストリームの構造に基づいてワークスペースビューを生成します。ユーザがワークスペース・ビューを編集する必要はありません(実際、手動で変更することはできません)。ストリームの構造が変化すると、PERFORCEは必要に応じて、ストリームに関連付けられたワークスペースのビューを更新します。

(推奨事項: ストリームに関連付けられたワークスペースに名前を割り当てる場合には、user_depot_streamname名などの命名規則を採用してください。例えば、bruno_projectXなどとします。また、異なるタイプのストリームに関連付けられたクライアントワークスペースへの切り替えをたびたび行うユーザは、ストリームタイプをワークスペース名に追加し、bruno_projectX_mainやbruno_projectX_devなどとすると有用であるかもしれません)。

ストリーム用のワークスペースを作成する手順は以下のとおりです。

これで、メインラインにファイルを取り込む準備ができました。

反映元ファイルと新しいメインライン・ストリーム内のファイルとの間で履歴の関係を維持する必要がない場合は、単にファイルを追加します。ファイルをメインライン・ストリームに追加する手順は以下のとおりです。

ファイルが正しく追加されるように設定されていることを確認するには、p4 openedコマンドを実行します。ストリームにデータを取り込むには、ファイルが作業状態にされているチェンジリストをサブミットします。

他のストリーム・ディポ、従来のディポ、またはリモート・ディポからファイルをブランチすることが可能です。ブランチ操作によってメインラインにデータを取り込むと、Perforceは反映元ファイルと反映先ファイルのリビジョン履歴の関係を維持します。ワークスペースには、反映先ストリームに関連付けられたものを設定しなければなりません(例: p4 set P4CLIENT=bruno_projectX_main)。

ブランチ操作によってメインラインにデータを取り込むには、反映元と反映先を指定してp4 copyコマンドを実行します。例:

p4 copy -v //mysourcedepot/mainline/... //ProjectX/main/...

(この例では-vオプションを指定して、ワークスペースにファイルをコピーせずにサーバを更新することによってパフォーマンスを向上させています。)Perforceは一連の「...からインポートします」というメッセージを表示して反映元と反映先のファイルを列挙し、作業中チェンジリストでファイルを作業状態にします。ファイルを作業状態にせずに操作結果をプレビューするには、-nオプションを指定します。誤ったコピー操作を元に戻すには、p4 revert コマンドを実行します。(例: p4 revert //ProjectX/main/...)

ファイルが正しく追加されるように設定されていることを確認するには、p4 openedコマンドを実行します。ストリームにデータを取り込むには、ファイルが作業状態にされているチェンジリストをp4 submit(サブミット)します。

空のストリームにデータを読み込む場合は、p4 populateを使用することでこの処理を簡略化できます。例:

p4 populate //mysourcedepot/mainline/... //ProjectX/main/...

は、p4 copy -vの後にp4 submitを実行した場合と同様に動作します。p4 populateの実行結果を事前に知りたい場合は、p4 populate -nを使用して、コマンドの結果をプレビューします。

安定性のより高いストリームからの変更によってストリームを更新するには、p4 merge -S source-streamコマンドを実行し、必要に応じて衝突解決を行った後、得られたチェンジリストをサブミットします。デフォルトでは、意図した反映先から入って来るあらゆる変更をマージするまで、安定性の高いストリームに変更をコピーすることはできません。これによって、安定性の高いストリームの内容を誤って上書きしてしまうことが避けられます。

開発ストリームで作業を始めた後に、変更がメインラインにチェックインされたと仮定すると（また、ワークスペースが開発ストリームに設定されていると仮定）、以下のコマンドを実行することにより、開発ストリームに変更を組み込むことができます。

p4 merge -S //projectX/dev -r
p4 resolve
p4 submit -d "Merged latest changes"

マージ実行後、ストリームにはより安定した親または子の最新状態が反映されています。開発ストリームに加えたい変更を完成させたと仮定すると、反映先ストリームでの作業を上書きしてしまう危険を伴わずに新しい内容に昇格できます。「コピー」操作では反映元の複製が単に反映先に伝播され、衝突解決は必要とされません。例えば、(ワークスペースが親のメインライン・ストリームに設定されていると仮定して)開発ストリームから親のメインラインに変更を昇格させるには、以下のコマンドを実行します。

p4 copy -S //projectX/dev
p4 submit -d "Check my new feature in"

同格の開発ストリームから作成中の機能やバグ修正を取得したい場合など、生来の親子関係を持たない2つのストリーム間で特定の変更を伝播する必要があるかもしれません。そのようなストリームからのマージまたはそのようなストリームへのコピーを行うには、仕様を編集して、Parentフィールドを目的の反映元または反映先に設定することにより、ストリームの親を変更することができます。これは最適な方法とはみなされませんが、必要な場合があるかもしれません。

通常は、作業を行うストリームごとにワークスペースを定義します。しかしこの方法では、ストリームに非常に多くのファイルが含まれている場合(例えば数万件から数十万件)、前回作業を行ってから大幅に変更されたストリームに切り替える際に、長時間の同期処理が必要となる可能性があります。ストリームの構造に一貫性があり、ほとんどのファイルが同内容である場合、両方のストリームに異なるワークスペースを使用する代わりにワークスペースを切り替え後のストリームに関連付け直すことによって、この問題を回避することができます。ワークスペースとストリームの関連付けを変更したら、同期を実行し、違いのあるファイルをすべて取得します。

ワークスペースに関連付けられたストリームを変更するには、次のコマンドを実行します。

p4 client -s -S //streamdepot/ streamname

大規模なプロジェクトでは、ストリームを整然と編成してもワークスペースビューを十分に制限できないことがあります。大規模な組織では、プロジェクトのファイルのほんの一部にしか関心のないグループが多数存在することがよくあります。旧バージョンのPerforceでは、こういったユーザは必要な部分のみを含めるように手動でクライアントワークスペースのビューを制限していました。ストリームを利用する別の方法として、virtualストリームをフィルタとして使用することができます。

例えば、次のように進行中の開発作業が//Ace/devストリームで行われているとします。

Stream:  //Ace/dev
Parent: //Ace/main
Type:   development
Paths:
    share ...

(プロジェクトに関するすべての資産ではなく)製品のドキュメントに関する作業にのみ従事しているユーザであれば、以下のように//Ace/dev/docs/...下にあるファイルのみを含む仮想ストリームを作成できます。

Stream:  //Ace/devdocs
Parent: //Ace/dev
Type:   virtual
Paths:
    share docs/...

すると、ユーザは次のコマンドを使用して自分のクライアントワークスペースをdevdocs仮想ストリームに切り替えることができます。

p4 client -s -S //Ace/devdocs

devdocsワークスペースを使用すると、ユーザのクライアントワークスペースのビューが//Ace/dev/docs/...にある要素のみを含むように自動的に更新されます。そして、そのユーザが//Ace/devdocsに加えた変更は自動的に元の//Ace/devコードラインに伝播され、p4 copyまたはp4 integrateを手動で実行する必要はありません。

ワークスペース仕様にあるStreamAtChangeオプションを使用すると、ストリームのビューを特定のチェンジリストから使用して、ストリームワークスペースを設定してストリームを同期できます。これにより、自分のストリームの"振り返り"のビューを表示できるようになります。特にストリーム定義が頻繁に変更される場合、ある特定の時点におけるストリームビューが何であったかを確認する際に役に立ちます。StreamAtChangeオプションを使用する場合は、ストリーム内のファイルに変更をサブミットできません。ワークスペースファイルが最新リビジョンではないためです。

特定のチェンジリストからストリームワークスペースを同期するように設定するには、以下の手順を実行します。

詳細については、『P4コマンドリファレンス』のp4 clientを参照してください。