On this page | |
Since | 17.5 |
このノードは、Perforce機能のラッパーとして動作します。 このノードには、p4コマンドを実行するためのインターフェースが備わっています。
Installation ¶
このノードを使用するには、そのノードがジョブを実行するシステム上にPerforceがインストールされている必要があります。
さらに、Perforceノードがそのp4実行ファイルを見つけることができなければなりません。 このノードは、まず最初にPDG_PERFORCEという環境変数を探します。 この変数が定義されていれば、その値をPerforceの実行ファイルのパスとして使用します。 PDG_PERFORCE環境変数が未定義であれば、このノードはp4実行ファイルがシステムのPath環境変数から利用可能なものだと想定します。
TOP Attributes ¶
|
int |
オペレーションが実行されるタイミングを示します:
|
|
string |
実行されるPerforceオペレーション(update, sync, edit, submit, add, change, version)。 |
|
integer |
P4実行ファイルの位置を決定するデフォルトの挙動をユーザが上書きするかどうかを指定します。 これを1に設定すると、ワークスクリプトは、ユーザが指定した独自のバイナリパスを使用するようになります。 |
|
string |
ここには、ユーザが設定した独自のP4実行パスを設定します。
このパスは、 |
|
integer |
ユーザーが Source Files パラメータから選択したメニューアイテムを示します。 |
|
string |
Perforceオペレーションで使用されるファイルパターン。 |
|
string |
Perforceオペレーションに含まれる入力結果のファイルタグ。 |
|
integer |
|
|
string |
デフォルトのchangelistまたは番号付きのchangelistのどちらを使用するかどうかを指定します。 |
|
string |
|
|
string |
P4コンフィグファイルの場所を指定します。 |
|
integer |
|
|
integer |
Change オペレーションのみ: 新しいchangelistを空っぽにするか、すべての保留ファイルを含めるのかを指定します。 |
|
integer |
Update と Sync のオペレーションのみ: ワークスペース全体を更新するかどうかを示します。 |
|
integer |
Change オペレーションのみ: Changeオペレーションでchangelistの作成に成功すると、このアトリビュートを介してその番号が指定されます。 |
|
string |
p4 コマンドで使用されるファイルパスのリストまたはファイルパターン。 |
パラメータ ¶
Node ¶
Generate When
このノードがワークアイテムを生成するタイミングを決めます。 このノードがどの生成モードを必須にしているのか、もしくは、ワークアイテムを動的に生成させる必要があるのかどうか分からないのであれば、通常では、これを“Automatic”のままに設定してください。
All Upstream Items are Generated
このノードは、すべての入力ノードが自身のワークアイテムを生成した時にワークアイテムを生成します。
All Upstream Items are Cooked
このノードは、すべての入力ノードが自身のワークアイテムをクックした時にワークアイテムを生成します。
Each Upstream Item is Cooked
このノードは、入力ノード内のワークアイテムがクックされる度にワークアイテムを生成します。
Automatic
入力ノードの生成モードに基づいて生成モードが選択されます。 入力ノードのどれかがその入力のクック時にワークアイテムが生成されている場合、このノードには Each Upstream Item is Cooked が設定されます。 そうでない場合、 All Upstream Items are Generated が設定されます。
Perform Op During
このパラメータには、Perforceオペレーションを実行するタイミングを指定します。 Perforceコマンドは、ワークアイテム生成フェーズ、または、クックフェーズ(In-ProcessまたはOut-Of-Processのどちらか)で実行することができます。
Perforce Operation
このメニューから、実行するPerforceコマンドを選択します。
Run on Service Block
このノード内のワークアイテムを、親のサービスブロックが存在すれば、そのサービスブロック上で実行させるかどうかを決めます。
Always
このノード上の他のサービス設定に関係なく、常にワークアイテムをブロックのサービス上で実行します。
Match
Service Name がブロックで使用されているサービス名にマッチした場合にのみ、ワークアイテムをそのブロックのサービス上で実行します。
Never
ワークアイテムをブロックのサービス上で実行しません。
Service Name
Cook Type を Service に設定した場合、このパラメータを使用して、そのサービスの名前を指定します。 サービスの使用方法の詳細は、PDG Service Managerのドキュメントを参照してください。
File Source ¶
このフォルダには、Perforceコマンドに含めるファイルを選択するためのオプションが用意されています。
All Files in Workspace
Update と Sync のコマンドのみ: このオプションを有効にすると、ワークスペース全体が更新または同期されます。
Empty Changelist
Change コマンドのみ: このオプションを有効にすると、新しく作成されるchangelistには、現在保留しているファイルが 含まれなくなります 。
Source Files
Perforceオペレーションに含まれるファイルのソースを選択します。 そこに含まれるファイルは、上流のワークアイテムの結果、または、Perforceファイルパターンのどちらかで指定することができます。
File Tag
入力ファイルのフィルタリングに使用するファイルタグ。 このタグを持った入力結果のみがワークアイテムのオペレーションに含まれます。
File Pattern
オペレーションで使用するPerforceファイルパターン。
Operation ¶
Force Sync
syncコマンドを実行する場合、ここではforce syncを有効または無効にします。
Changelist
Perforceコマンドにchangelistが必要な場合、ここでは、デフォルトのchangelistを使用するか、番号付きのchangelistを使用するのか選択することができます。
Changelist Number
Perforceコマンドにchangelistが必要で、 Changelist オプションをNumbered
に設定した場合、ここではchangelist番号を指定することができます。
Description
このパラメータは、changelist説明を必要とするPerforceコマンド用の説明を作成することができます。
Common ¶
P4 Config File
P4コンフィグファイルの場所を指定します。 これは、ジョブの環境内でP4CONFIG環境変数を設定します。
Override Perforce Path
これは、p4実行ファイルのパスを独自のパスで完全に上書きすることを許可します。
Schedulers ¶
TOP Scheduler Override
このパラメータは、このノードのTOPスケジューラを上書きします。
Schedule When
有効にすると、このパラメータを使用して、このノードのどのワークアイテムをスケジュールに組むのかを決めるエクスプレッションを指定することができます。 そのエクスプレッションが指定されたワークアイテムに対して0を返すと、そのワークアイテムはスケジューラに組まれずに、即座にクック済みとしてマークされます。 そのエクスプレッションが0以外の値を返すと、そのワークアイテムは従来どおりにスケジュールに組まれます。
Work Item Label
このノードがワークアイテムにどのようにラベルを付けるのかを決めます。 このパラメータによって、固有でないラベル文字列をワークアイテムに割り当てることができ、そのラベルを使用してアトリビュートパネル、タスクバー、スケジューラジョブ名のワークアイテムを区別することができます。
Use Default Label
このノード内のワークアイテムは、TOPネットワークからデフォルトのラベルを使用します。 デフォルトが設定されていない場合は、それらのワークアイテムにはラベルは付きません。
Inherit From Upstream Item
ワークアイテムは親ワークアイテムのラベルを継承します。
Custom Expression
ワークアイテム毎に評価される Label Expression カスタムエクスプレッションをワークアイテムのラベルに設定します。
Node Defines Label
ワークアイテムのラベルをこのノードの内部ロジックで定義します。
Label Expression
有効にすると、このパラメータを使用して、このノードで作成されたワークアイテムに独自のラベルを指定することができます。
このパラメータには、ワークアイテムアトリビュートの参照またはビルトインのプロパティを含めたエクスプレッションを使用することができます。
例えば、$OS: @pdg_frame
は、フレーム値に基づいて各ワークアイテムのラベルを設定します。
Work Item Priority
このパラメータは、現行スケジューラがこのノード内のワークアイテムの優先度を設定する方法を決めます。
Inherit From Upstream Item
ワークアイテムは、親ワークアイテムの優先度を継承します。ワークアイテムに親ワークアイテムがなければ、その優先度は0に設定されます。
Custom Expression
ワークアイテムの優先度は、 Priority Expression の値に設定されます。
Node Defines Priority
ワークアイテムの優先度は、このノード自身の内部優先度計算に基づいて設定されます。
このオプションは、 Python Processor TOP, ROP Fetch TOP, ROP Output TOPのノードでのみ利用可能です。 これらのノードは、各自のノードロジックで実装された優先度設定スキームを定義しています。
Priority Expression
このパラメータには、ワークアイテムの優先度を設定するためのエクスプレッションを指定します。 このエクスプレッションは、ノード内のワークアイム毎に評価されます。
このパラメータは、 Work Item Priority が Custom Expression に設定されている場合にのみ利用可能です。