p4 jobspec
このコマンドを使用してジョブテンプレートを編集し、ジョブフォームに対する仕様フィールドの追加、変更、削除を行うことができます。
構文
p4 [g-opts] jobspec
p4 [g-opts] jobspec [-i]
p4 [g-opts] jobspec -o
説明
p4 jobspec
コマンドによりフォームが表示され、Helixサーバ管理者はジョブフィールドの編集、生成、削除、改良を実行できます。
フォームフィールド
フィールド名 | 説明 |
---|---|
|
サイトのジョブにおける各フィールドの定義のリストで、1行に1フィールドずつ定義が表示されます。 各行は、code、name、datatype、length、fieldtypeのいずれかの形式で表示されます。 重要
バージョン2019.2以降で新しいフィールドを追加する場合、管理者は、オプションのプレースホルダー値である「NNN」を使用してフィールドコードを入力することができます。 管理者がこの方法でフィールドコードを入力すると、サーバによって適切な値がそのフィールドに設定されます。 ジョブ仕様を保存すると、101~119 までの範囲内で、次のコード値が自動的に生成されて保存されます。 101~105までの数値はHelix Core用として予約されているため、実際の範囲は106~119になります。 フィールドの数がこの範囲を超えた場合は、10000以上の一意の値が新しいコードに割り当てられます。 または、管理者が任意の数値を指定することもできます。 管理者が仕様を保存すると、指定された値が正しくないことを示すメッセージが表示される場合があります。
|
|
フィールド名および データタイプが
|
|
フィールド名および 各行には、例えば下記のように、フィールド名とデフォルト値がスペースで区切られて表示されていなければなりません。 以下に例を示します。
任意の1行の文字列または次の3つの組込変数のいずれかを使用することができます。
フィールド102に関して特に考慮すべき点については、「使用上の留意点」を参照してください。 |
|
ユーザがP4VHelix Visual Clientでジョブを入力する必要がある場合には、このコメントに関して特に考慮すべき点があります。「使用上の留意点」を参照してください。 |
オプション
|
ジョブ仕様のフォームを標準入力から読み取ります。 |
|
ジョブ仕様のフォームを標準出力へ書き出します。 |
|
詳細については、「グローバルオプション」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? | ファイル引数にリビジョン範囲を使えるか? | 最低限必要なアクセスレベル |
---|---|---|
適用外 |
適用外 |
admin、または |
-
101~105のフィールドを、変更、リネーム、再定義しないでください。 これらのフィールドはHelixサーバが使用するため、削除または変更をしないでください。 ジョブに新しいフィールドを追加する場合にのみ、
p4 jobspec
を使用してください。フィールド101はHelixサーバに必要です。リネームすることも削除することもできません。
フィールド102~105は、Helixサーバアプリケーション専用です。 これらのフィールド名を変更または削除することは可能ですが、望ましくありません。 Helixサーバアプリケーションは、チェンジリストがサブミットされるたびに、必ずフィールド102(
Status:
フィールド)の値をclosed
(またはフィールド102のPresets:
に定義されたその他の値)に設定します。これは、管理者がフィールド102を、closed
を許容値として含まないフィールドとして使用するように再定義しても変わりません。このような再定義は予測不可能な混乱を生じる危険性があります。 Comments:
フィールド内の情報は、ジョブフォームの入力方法をユーザに伝えることのみを目的とした情報です。この情報は、ツールチップを表示するために、P4VとHelix Visual Clientでも使用されます。-
ジョブ状態のフィールド(field 102)の
Presets:
エントリには、p4 fix
、p4 change
-s、およびp4 submit
-sの各コマンドに対してデフォルトの修正ステータスを示すための特殊なシンタックスがあります。デフォルトでは、
p4 fix
、p4 change
、またはp4 submit
を使用すると、ジョブのステータスはclosedに設定されます。 デフォルトの修正ステータスをclosed
から他のfixStatus
に変更するには(fixStatus
フィールドに有効な設定値としてselect
をValues:
フィールドに定義済みであると想定して)、フィールド102(ジョブの状態)のPresets:
フィールドで
というシンタックスを使用します。jobStatus
,fix/fixStatus
p4 fix
、p4 change
、p4 submit
の動作を変更し、ジョブの状態を未変更のままにするには、特殊なfixStatus
であるsame
を使用します。 - 『Helix Coreサーバ管理者ガイド』の「Perforceのカスタマイズ: ジョブ仕様」の章でジョブ仕様のカスタマイズの例を参照してください。
関連コマンド
ジョブの生成、編集、またはビューを行う |
|
ジョブをチェンジリストに添付する |
|
ジョブをリスト表示する |
|
特定のチェンジリストに添付されたジョブ、または特定のジョブに添付されたチェンジリストをリスト表示する |