p4 fix

ジョブを、その修正を行うチェンジリストにリンクします。

構文

p4 [g-opts] fix [-d] [-s status] -c changelistjobName ...

説明

p4 fixコマンドは、ジョブ(実行されるべき作業の記述)を、チェンジリスト(ファイルに対する変更の集合。ジョブに記述された作業を行う)にリンクします。

チェンジリストがまだサブミットされていない場合、ジョブは、リンク先チェンジリストについてp4 submitまたはp4 changeを実行するときに開くフォーム内に表示されます。通常の状況では、チェンジリストがサブミットされた時点で、ジョブの状態がclosedに変わります。 p4 fixを実行する前に既にチェンジリストがサブミット済みである場合も、ジョブの状態がデフォルトの状態(通常はclosed)に設定されます。

チェンジリストをサブミットする際に、ジョブの状態をデフォルトの状態(通常はclosed)以外に変更するには、p4 fix、p4 submit、またはp4 changeで-sオプションを使用します。

記述された作業を、複数のチェンジリストで修正済みとすることもできます。すなわち、1つのジョブを、複数のチェンジリストにリンクすることができます。 また、1つのチェンジリストで10のバグを修正済みにすることも可能です。この場合は、複数のジョブを同一のチェンジリストにリンクします。 これを行うには、p4 fixに複数のジョブを引数として指定して、このコマンドを1回のみ実行します。

オプション

-c changelist	修正済みとしてマークされるチェンジリスト。
-d	指定されたチェンジリストにおける指定されたジョブに関する修正の記録を削除します。 ジョブの状態は変わりません。
-s status	チェンジリストのサブミット時に、ジョブの状態をデフォルト値であるclosedではなくstatus(またはp4 jobspecフォームのフィールド102のPresets:に定義されたその他の値)に変更します。 ジョブのリンク先となるチェンジリストの状態をsubmittedにすると、同じ状態がジョブの状態として即時に反映されます。 チェンジリストがpendingの場合、p4 submitにも-sオプションを指定し、p4 submitフォームのJobs:フィールドのジョブの隣に望ましい状態が表示されていると、ジョブの状態はチェンジリストのサブミット時に変更されます。 ジョブを未変更のままにしておくには、特殊な状態であるsameを使用します。
g-opts	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

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

• ジョブのフォーマットはサイトごとに変更される可能性があるため、使用しているシステム上のジョブにはStatus:フィールドがない場合があります。 その場合には、ジョブはp4 fixでチェンジリストにリンクすることができますが、Helixサーバでは、チェンジリストがサブミットされても、そのジョブのフィールドの値は変更されません。
• 修正済みジョブまたは未修正ジョブの状態は、p4 jobでジョブを編集することにより、いつでも変更することができます。
• ジョブを修正済み(または未修正)にするには、サブミットされていないチェンジリストについてp4 submitまたはp4 changeのフォームを表示させ、その[Jobs:]フィールドに該当のジョブを追加する(あるいは削除する)という方法もあります。
• デフォルトのチェンジリストにp4 fixでジョブをリンクすることはできません。リンクするには、デフォルトのチェンジリストをディポにサブミットする際に、p4 submitフォームのJobs:フィールドにそのジョブを追加してください。

• p4 fix -s statusをジョブに対して使用し、p4 submitまたはp4 changeに対して-sオプションを使用した場合、チェンジリストフォームのJobs:フィールドに、ジョブの状態の値を指定する必要があります。このデフォルト値は、p4 fix -s statusで指定された値です。 チェンジリストのサブミットが成功した場合、statusで指定した値がジョブに割り当てられます。

  Wrong number of words for field 'Jobs'.

  フォームでstatusの値を指定しなかった場合は、上記のエラーメッセージが表示されます。

  p4 fix -s status 、p4 submit -s、およびp4 change -sは、欠陥追跡システムと連携して使用することを目的としたオプションです。

  通常、ユーザがこれらのコマンドを使用することはなく、p4 submitとp4 changeを-sオプションなしで使用します。 この場合は、ジョブ番号のみをJobs:フィールドに指定します。各ジョブの状態は、サブミットの完了時にデフォルト値(通常はclosed)に設定されます。

例

p4 fix -c 201 job000141 job002034	2つのジョブをチェンジリスト201によって修正済みとします。 チェンジリスト201がまだpendingの場合には、ジョブの状態はチェンジリストがサブミットされた段階でclosedに変わります。
p4 fix -c 201 -s suspended job002433	チェンジリスト201がサブミットされたときに、job002433をclosedではなくsuspendedとします。 -sオプションを指定してp4 submitを実行する必要があります。

関連コマンド

作業中チェンジリストに対してジョブを追加または削除する	p4 change
デフォルトのチェンジリストに対してジョブを追加または削除する	p4 submit
ジョブとチェンジリストの関係をリスト表示する	p4 fixes
ジョブを生成または編集する	p4 job
ジョブのすべてまたは一部をリスト表示する	p4 jobs
サイトで使用するジョブのフォーマットを変更する(スーパーユーザ専用)	p4 jobspec
サイトで使用しているジョブのフォーマットに関する情報を読み出す	p4 jobspec -o