ジョブを管理する

ジョブにより、作業の要求を記録することができます。ジョブをチェンジリストと関連付けて、要求を遂行するために行われた作業を追跡できます。チェンジリストをサブミットすると、ジョブを閉じることができます。ジョブは[ジョブ]タブに表示されます。

ジョブを作成する

1. 以下のいずれかを実行して、[ジョブ]フォームを開きます。

   • [ファイル] > [新規...] > [ジョブ]を選択します。
   • [ジョブ]タブで、ジョブリストペイン内の任意の場所を右クリックします。

2. [ジョブ]フォームを記入します。

   [ジョブ]フォームに表示されるフィールドは、Helixサーバ管理者が設定するカスタマイズの内容によって異なります。Helix Coreサーバ管理者ガイド: 基本の「Perforceのカスタマイズ: ジョブ仕様」を参照してください。

   [説明]フィールドでは、マークアップ用のHTMLタグとハイパーリンク用のテキストを入力することができます。詳しくは、[説明]フィールドでテキストを書式設定するを参照してください。

作業中チェンジリストにジョブを追加する

ジョブを作業中チェンジリストに追加するには、右パネルの[ジョブ]タブからチェンジリストの[ジョブ]フィールドにジョブをドラッグします。また、[サブミット]ダイアログの[ジョブをチェンジリストにリンク]フィールドを使用することもできます。チェンジリストのサブミット時にジョブステータスを指定します。

チェンジリストにジョブを自動的に取り込むようにP4Vを構成するには、P4Vのユーザプリファレンスを設定します。詳細情報については、「ユーザのプリファレンスを編集する」を参照してください。

ジョブを表示する

[ジョブ]タブを表示するには、[表示] > [ジョブ]に移動します。

[ジョブ]リストビューに表示される列を指定するには、列の見出し内で右クリックし、列の有効と無効を切り替えます。表示される列の順序を変更するには、列の見出しを目的の位置へ右または左にドラッグします。

ジョブを日付順に並べ替える: デフォルトの場合、P4Vは、オペレーティングシステムの形式で日付を表示しますが、ジョブが時系列順に表示されることはありません。実際の時系列順にジョブを並べ替えるには、日付をHelixサーバのyyyy/mm/dd形式で表示するようにP4Vを構成します。[編集] > [プリファレンス] (Windowsの場合)または[P4V] > [プリファレンス] (Macの場合)に移動し、[表示]ページで[日付をPerforce標準形式にする]オプションをクリックします。

ジョブを検索する

ジョブを検索するには、[ジョブ]タブを開き、Helixサーバの標準フィルタ式(Unixの正規表現と類似した構文)を使用してフィルタ条件を入力するか、ジョブクエリビルダーを使用してクエリを作成します。検索結果はクエリーフィールド下部のウィンドウに表示され、クエリを変更すると自動で変更されます。

ジョブをクリックすると詳細が表示されます。

Helixサーバのフィルタ式を使用してジョブを検索する

Helixサーバの標準フィルタ式を使用する場合は、検索クエリを[キーワードまたは検索クエリ]フィールドに入力します。ドロップダウン矢印をクリックし、最新のクエリを表示して選択することもできます。

有効な式には、以下が含まれます。

構文	説明	例
word word word	スペースで区切られた単語は、フィルタに含まれるジョブフィールドの文字列のすべての単語がジョブに含まれる必要があることを示します。これは論理演算子"and"と同じです。	filter file mailbox ジョブフィールドに"filter"、"file"、"mailbox"のすべての単語が含まれるジョブを表示します。
pass:[word word word]	指定されたいずれかの単語を含むジョブを表示します。これは論理演算子"or"と同じです。	pass:[filter file mailbox] "filter"、"file"、"mailbox"のいずれかの単語を含むジョブを表示します。
^word	指定された単語を含まないジョブを表示します。'not' (^)演算子は、単独または'or' (|)演算子とともに使用することはできず、'and'演算子(&またはスペース)とのみ使用できます。	filter ^file "filter"を含み、かつ"file"を含まないジョブのみを表示します。
fieldname=value	指定されたフィールドに指定された値を含むジョブを表示します。	status=open owner=edk edkが所有する開いているジョブを表示します。
^fieldname=value	指定されたフィールドに指定された値を含まないジョブを表示します。'not' (^)演算子は、単独または'or' (|)演算子とともに使用することはできず、'and'演算子(&またはスペース)とのみ使用できます。	^status=closed& subsystem=parser パーサーサブシステムの影響を受ける閉じられていないジョブを表示します。
fieldname=value+*	指定されたフィールドに指定された値を含むジョブを表示します。値には、アスタリスクワイルドカードの位置の文字の組み合わせも含まれます。	owner=**ed* "owner"フィールドに部分文字列"ed" ("Ted"、"Edk"、"Fred"などの値)を含むジョブを表示します。
yyyy/mm/dd:hh:mm:ss	指定された日付を含むジョブを表示します。ここで、"yyyy"は4桁の形式で表現された年であり、"mm"、"dd"、"hh"、"mm"、"ss"はそれぞれ2桁の形式で表現された、月、日、時間、分、秒です。	2000/02/12:08:30:00 2000年2月12日午前8時30分の日付を含むジョブを表示します。

Helixサーバジョブのクエリ構文の詳細情報については、Helix Coreサーバユーザーガイドの「欠陥追跡」を参照してください。

ファイルパスを使用してジョブを検索する

特定のファイルに関連付けられたジョブを表示するには、[以下のファイルパスのどれかと一致するファイル]にファイルパスを入力するか、[ファイルパスビルダー]を使用します。入力したファイルパスにより、そのパスにあるいずれかのファイルを含むチェンジリストに関連付けられたジョブを取得します。自分またはジョブクエリービルダーが[キーワードまたは検索クエリ]フィールドに入力したフィルタ基準により、検索結果をさらに検索することができます。ディポまたはワークスペースのどちらかのファイルパスを入力できます。

ファイルパスを[以下のファイルパスのどれかと一致するファイル]フィールドに直接入力するには、以下のいずれかを実行します。

• Helixサーバの標準ファイルパス構文(「//depot/folder/folder/filename」または「//depot/folder/...)を使用する。Helixサーバの標準ワイルドカード(「*」と「…​」)とリビジョン指定子(「@」と「#」)を使用することができます。

  ワイルドカードとリビジョン指定子の詳細情報については、Helix Coreサーバユーザーガイドの「P4コマンドを実行する」を参照してください。

• ディポツリーまたはワークスペースツリーからフィールドにファイルパスをドラッグアンドドロップする。
• ドロップダウン矢印をクリックし、最新のファイルパスを表示して選択する。

ファイルパスを構築するには、ファイルパスビルダーを使用します。

ジョブクエリービルダーを使用してジョブを検索する

ジョブクエリービルダーにより、フィルタ式を対話式で構築することができます。

1. [検索クエリを構築]アイコン()をクリックしてジョブクエリービルダーを開きます。

2. フィルタ式の構築

   • [一致]基準を選択します。

     • Allは入力した条件すべてに一致する結果を表示します。これは論理演算子"and"と同じです。絞り込んで検索する場合はAllを使用します。例えば、"installation"と"administration"の両方の語句が含まれているジョブのみを検索する場合は、Allを使用します。

     • Anyは入力した条件のいずれかに一致する結果を表示します。これは論理演算子"or"と同じです。あまり絞り込まずに検索する場合はAnyを使用します。例えば、"installation"と"administration"のどちらかの語句が少なくとも1つ含まれているジョブを検索する場合は、Anyを使用します。

   • フィールド、演算子(contains、is、does not contain、is emptyなど)、および値を選択します。

     

     編集可能な値もあれば、あらかじめ設定されドロップダウンリストから選択可能な値もあります。

     
   • 条件を追加するには、プラスボタン をクリックします。
   • 条件を削除するには、マイナスボタン をクリックします。

   • 条件を入れ子にするには(例えば、brunoというユーザが所有するopenなジョブのうちinstallationまたはadministrationという単語が含まれているジョブを選択する場合など)、 ボタンをクリックします。

     

     入れ子にした行は、AnyまたはAll一致条件のオプションとともに表示されます。

     • Allは入力した条件すべてに一致する結果を表示します。これは論理演算子"and"と同じです。絞り込んで検索する場合はAllを使用します。例えば、"installation"と"administration"の両方の語句が含まれているジョブのみを検索する場合は、Allを使用します。
     • Anyは入力した条件のいずれかに一致する結果を表示します。これは論理演算子"or"と同じです。あまり絞り込まずに検索する場合はAnyを使用します。例えば、"installation"と"administration"のどちらかの語句が少なくとも1つ含まれているジョブを検索する場合は、Anyを使用します。
     

     値を入力または選択すると、[クエリのプレビュー]の次のフィールドに結果のファイルパスが表示されます。

     

3. [OK]をクリックします。

   作成したクエリは、[キーワードまたは検索クエリ]フィールドの[ジョブ]タブに表示されます。