トリガスクリプト変数

%action%

null、またはチェンジリストかジョブに対して行われたアクションを反映する文字列です。

例えば、「pending change 123 added」または「submitted change 124 deleted」は、changeフォームに対する%action%の有効な値で、「job000123 created」または「job000123 edited」は、jobフォームに対する%action%の有効な値です。

%argc%

コマンド引数カウントです。

%args%

コマンド引数文字列です。

%argsQuoted%

コマンド引数文字列です。この文字列の内容は、複数のコマンド引数をパーセントエンコーディングし、カンマ区切りのリストとして配列したものです。

%changelist%, %change%

サブミットしようとしているチェンジリストの番号です。短縮形%change%は%changelist%と同様に機能します。

change-submitトリガは作業中チェンジリスト番号を渡します。change-commitトリガはコミットされたチェンジリストの番号を受け取ります。

shelve-commitトリガまたはshelve-deleteトリガは、シェルフのチェンジリスト番号を受け取ります。

%changeroot%

サブミットされたファイルのルートパスです。

%client%

トリガを起動させるユーザのクライアントワークスペース名です。

%clientcwd%

クライアントの現在の作業ディレクトリです。

%clienthost%

ユーザのワークステーションのホスト名(プロキシ、ブローカ、レプリカ、エッジサーバを経由して接続する場合も含む。)

%clientip%

ユーザのワークステーションのIPアドレス(プロキシ、ブローカ、レプリカ、エッジサーバを経由して接続する場合も含む。)

%clientprog%

ユーザのクライアントアプリケーション名です。P4V、P4Winなど。

%clientversion%

ユーザのクライアントアプリケーションのバージョンです。

%command%

コマンド名です。

%file%

ディポのMap:フィールドに基づくアーカイブファイルのパスです。Map:フィールドの値がP4ROOTからの相対パスである場合、%file%はサーバ側のP4ROOTからの相対パスです。Map:フィールドの値が絶対パスである場合、%file%はサーバ側の絶対パスです。

%firstPushedChange%

最初の新しいチェンジリストの番号です。

詳細については、「プッシュコマンドおよびフェッチコマンド用のその他のトリガ」を参照してください。

%formfile%

一時フォーム仕様ファイルのパスです。inトリガまたはoutトリガでフォームを編集するには、このファイルを上書きします。saveタイプのトリガとdeleteタイプのトリガの場合、このファイルは読み取り専用になります。

%formname%

フォーム名です(例えば、ブランチ名やチェンジリスト番号)。

%formtype%

フォームタイプです(例えば、branch、changeなど)。

%groups%

ユーザが所属しているグループのリスト(スペース区切り)です。

%intermediateService%

ブローカやプロキシを示します。

%jobs%

ジョブ番号の文字列です。この変数は、p4 fixコマンドで指定されているジョブ番号1つか、p4 submitまたはp4 changeフォーム中のJobs:フィールドで追加(または削除)されたジョブ番号1つにつき、1つの引数に展開されます。

%lastPushedChange%

最後の新しいチェンジリストの番号です。

詳細については、「プッシュコマンドおよびフェッチコマンド用のその他のトリガ」を参照してください。

%maxErrorSeverity%

empty、error、warningのいずれかです。

%maxErrorText%

エラー番号とエラーメッセージです。

%maxLockTime%

ユーザ指定の値です。許容可能な最長のデータベースロック時間を、ミリ秒単位で指定します。この変数が設定されている場合、ユーザがこの値に関するグループ設定を上書きしたということを意味します。

%maxResults%

ユーザ指定の値です。コマンド実行中にバッファするデータ量を指定します。この変数が設定されている場合、ユーザがこの値に関するグループ設定を上書きしたということを意味します。

%maxScanRows%

ユーザ指定の値です。1度の操作中にスキャンされる最大行数を指定します。この変数が設定されている場合、ユーザがこの値に関するグループ設定を上書きしたということを意味します。

%oldchangelist%

チェンジリストの番号がサブミット時に変更されると、この変数の値は古いチェンジリスト番号になります。

%op%

read、write、deleteのいずれかの操作を示します。

%peerhost%

プロキシ、ブローカ、レプリカ、またはエッジサーバを通じてコマンドが送信された場合、プロキシ、ブローカ、レプリカ、エッジサーバのうちいずれかのホスト名を示します。(コマンドが直接送信された場合、%peerhost%は%clienthost%と一致します。)

%peerip%

プロキシ、ブローカ、レプリカ、またはエッジサーバを通じてコマンドが送信された場合、プロキシ、ブローカ、レプリカ、エッジサーバのうちいずれかのIPアドレスを示します。(コマンドが直接送信された場合、%peerip%は%clientip%と一致します。)

%P4PORT%

クライアントが接続するホストのポートです。クライアントが仲介を通じてサーバに接続する場合、この変数は仲介のポート番号を保持します。仲介なしで直接サーバに接続する場合、この変数は%serverAddress%変数と同じ値を保持します。

%quote%

二重引用符として使用する文字です。

拡張子が.gitであるリポジトリです。または%repoName%と同じです。

リポジトリの名前です。詳細については、「タイプグラフのディポのトリガ」を参照してください。

%rev%

アーカイブファイルのリビジョンです。

%serverAddress%

Helix CoreサーバのIPアドレスおよびポート番号です。P4LOGINSSOで指定されているクライアント側スクリプトのコンテキストにおいてのみ渡すことができます。

%serverhost%

Helix Coreサーバのホスト名です。

%serverid%

Helix Coreサーバのserver.idの値です。詳細については、『Helix Core P4コマンドリファレンス』のp4 serveridを参照してください。

%serverip%

サーバのIPアドレスです。

%servername%

Helix CoreサーバのP4NAMEの値です。

%serverport%

Helix Coreサーバのトランスポート、IPアドレス、ポート番号です。形式はprefix:ip_address:portです。

prefix にはssl、tcp6、ssl6のいずれか1つが使用されます。つまり、コマンドp4 -p %serverport%は、サーバ側で使用されている接続タイプにかかわらず、サーバへの接続に使用できます。

%serverroot%

Helix CoreサーバのP4ROOTディレクトリです。

%serverservices%

サーバの役割を指定する文字列です。以下のうちいずれか1つをとります。

• standard
• replica
• broker
• proxy
• commit-server
• edge-server
• forwarding-replica
• build-server
• P4AUTH
• P4CHANGE

%serverVersion%

コマンドが早期に終了した場合、中断したサーバのバージョン文字列を示します。中断の理由は%termReason%の値によって示されます。

%specdef%

該当フォームのスペック行に展開されます。

%submitserverid%

分散インストール環境ではない場合、%submitserverid%の値は常に空白になります。

分散インストールでは、すべての変更トリガにおいて以下のことが挙げられます。

• コミットサーバ上でサブミットが実行された場合、%submitserverid%は%serverid%と等しい。
• エッジサーバ上でサブミットが実行された場合、%submitserverid%は%serverid%と等しくない。この場合、%submitserverid%はエッジサーバのサーバIDを持ちます。

コミットサーバとエッジサーバの間で転送中のレプリカが存在する場合は、%submitserverid%は実際には転送中のレプリカのサーバIDを持ちます。

『Helix Core P4コマンドリファレンス』のp4 serveridを参照してください。

%terminated%

値が0である場合、コマンドが完了したことを示します。値が1である場合、コマンドが完了しなかったことを示します。

%termReason%

早期中断の理由を示します。以下のうちいずれか1つをとる可能性があります。

• 'p4 monitor terminate'
• client disconnect
• maxScanRows
• maxLockTime
• maxResults

%serverVersion%も参照してください。

%triggerMeta_action%

トリガ起動時に実行するコマンドです。トリガ定義の最後のフィールドです。ディポからスクリプトを実行する場合に限って設定してください。

%triggerMeta_depotFile%

トリガ定義の第3のフィールドです。このフィールドの意味はトリガタイプによって異なります。change-submitトリガの場合、トリガと一致すべきパスです。form-outトリガの場合、トリガに適用されるべきフォームタイプです。このフィールドの詳細については、該当するトリガタイプの解説を参照してください。

%triggerMeta_name%

トリガ定義の第1のフィールド、すなわちトリガ名です。ディポからスクリプトを実行する場合に限って設定してください。

%triggerMeta_trigger%

トリガ定義の第2のフィールド、すなわちトリガタイプです。ディポからスクリプトを実行する場合に限って設定してください。