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サーバのカスタマイズ: ジョブ仕様」を参照してください。
ジョブが生成または変更されると、Helixサーバはジョブにインデックスを付け、 p4 jobs -eが速やかにそのジョブを見つけられるようにします。インデックスキーは、wordとfieldnameです。 wordは、大文字と小文字の区別がない英数字の単語です。日付フィールドの値は、1970年1月1日0時0分0秒からの経過秒数として保存されます。

例

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