p4 job

欠陥、改善要求、またはその他のジョブ仕様の生成または編集を行います。

構文

p4 [g-opts] job [-f] [jobName]
p4 [g-opts] job -d jobName
p4 [g-opts] job -o [jobName]
p4 [g-opts] job -i [-f]

説明

ジョブとは、ディポのファイルに対して実行する必要のある作業を記述したものです。 場合によっては、バグの記述(例えば、「スクロール機構が正常に動作していない」)、または改善要求(例えば、「ある動作を発生させるオプションを追加してください」)、あるいはHelixサーバの管理下にあるファイルに変更が必要なことになる場合もあります。

ジョブは、システムに対する変更を任意のテキストとして記述するという点でチェンジリストの記述と似ていますが、チェンジリストは完了した作業を記述するのに対し、ジョブは行う必要のある作業を開発者に伝えるものです。

ジョブは、p4 jobによって表示されるフォームで生成・編集します。 ユーザはそのフォームに、ジョブを記述するテキストを、バグの重要度やバグ修正を担当する開発者といった情報とともに入力します。 Helixサーバスーパーユーザは、p4 jobspecでジョブフォームのフィールドを変更できるので、1つのジョブを構成するフィールドは個々のHelixサーバインストールによって異なります。

p4 jobが引数なしで実行されると、jobNNNNNNという新しいジョブが生成されます。NNNNNNは6桁の連番です。 このジョブの名前は、エディタを終了する前にフォーム上で変更することができます。 p4 jobをjobnameの引数付きで実行すると、その名前のジョブが生成され、既に同じ名前のジョブが存在している場合には、そのジョブの編集を行うことができます。

ジョブが生成されたら、そのジョブをp4 fix、p4 change、またはp4 submitで修正するチェンジリストにリンクさせることができます。 ジョブがチェンジリストにリンクされている場合には、通常、ジョブの状態はclosedになります。 (詳しくは下記「使用上の留意点」を参照してください)。

フォームフィールド

次に紹介するのは、デフォルトのジョブフォームに表示されるフィールドです。 ジョブを記述するフィールドは、Helixサーバスーパーユーザによって変更されることがあるので、実際に表示されるフォームのフィールドは、これとは異なる可能性があります。

フィールド名	タイプ	説明
Job:	書き込み可能	ジョブの名前です。 新しいジョブの場合、このフィールドの値はnewです。 フォームを閉じると、newがjobNNNNNNという名前に置き換えられます。ここで、NNNNNNはジョブの連番の次の6桁の番号です。 このフィールドの文字を変更できます。 ファイル名およびエンティティに関する文字の制限に注意してください。
Status:	書き込み可能、既定値	このフィールドの値はopen、closed、またはsuspendedでなければなりません。 ジョブがチェンジリストにリンクされていれば、このフィールドの値は、チェンジリストがサブミットされたときにclosedに設定されます。
User:	書き込み可能	ジョブを生成したユーザの名前です。
Date:	書き込み可能	ジョブが変更された日付です。
Description:	書き込み可能	ジョブに関するコメントを記述することができます。

オプション

-d jobname	関連する作業中またはサブミット済みの修正がない場合に限り、ジョブjobnameを削除します。
-f	強制オプションです。 Helixサーバ管理者に読み取り専用フィールドの編集を認めます。
-i	エディタを立ち上げずに標準入力からジョブフォームを読み込みます。
-o	エディタを立ち上げずに標準出力へジョブフォームを書き出します。
g-opts	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？	ファイル引数にリビジョン範囲を使えるか？	最低限必要なアクセスレベル
適用外	適用外	open

• Helixサーバスーパーユーザが102でフィールドID#Status:(p4 jobspecフィールド)を削除した場合、Helixサーバは、ジョブがリンクされているチェンジリストがサブミットされてもそのジョブを完了できなくなります。 詳細については、p4 jobspecコマンドと『Helix Coreサーバ管理者ガイド: 基本』を参照してください。
• ジョブが生成または変更されると、Helixサーバはジョブにインデックスを付け、p4 jobs -eが速やかにそのジョブを見つけられるようにします。 インデックスキーはword、fieldnameです。wordは、大文字と小文字を区別しない英数字の単語です。 日付のフィールドの値は1970年1月1日00:00:00からの秒数として保存されます。

例

p4 job	新しいジョブを生成します。デフォルトでは、そのジョブの名前はjobNNNNNNになります。
p4 job job000135	ジョブjob000135を編集します。