MediaWiki

Phabricator/ヘルプ

< Phabricator
This page is a translated version of the page Phabricator/Help and the translation is 73% complete.
Languages:
Phabricator は、ソフトウェアのバグ報告、機能リクエスト、企画作業のためのものです。
  • ウィキメディアのプロジェクト群についての技術的な質問は、m:Tech を参照してください
  • WMF (ウィキメディア財団) 以外のインストレーションの MediaWiki についての技術的な質問は、Project:サポートデスク を参照してください。

Phabricator (ファブリケーター) 利用者の皆さん、なにか質問があれば、議論ページで質問してください。私たちは受け取ったフィードバックに基づいて文書を改善していきます。 Phabricator を試してみたい場合は、クラウド サービスのインスタンスを使ってください。 (テストインスタンスは常にオンラインであるとは限りません。)

Phabricator とは何であり何ができるのか基本的な概要については、ウィキメディア・コモンズ上のチュートリアル動画をご覧ください：

  • 基礎と環境
  • タスク
  • プロジェクトとワークボード
  • タスクの検索とリスト化
  • 個別の生産性

通信帯が低い場合はスライド集をご利用ください。 もしくはこのページを読み続けて、思い切ってPhabricator を使い始めましょう。

アカウントの作成

新しい Phabricator アカウントを、ウィキメディアのグローバルアカウントまたは開発者アカウントに紐付けできます。どちらの場合にも、パスワードは共通でかまいません。

ウィキメディアのグローバルアカウントを使う

  • まず、ウィキメディアにログイン していることを確認してください。 ウィキメディアのアカウントをまだ持っていない場合は、アカウントを作成してください。
  • Phabricator のログインページに行ってください。
  • "Login or Register - MediaWiki"（ログインまたは登録 - MediaWiki）というボタンをクリックしてください。
  • MediaWiki.org サイトが Phabricator にアカウントを接続するために承認を求めます。
  • Phabricator から利用者名を尋ねられます。 迷ったときは、ウィキメディアの利用者名を使うことができますが、Phabricatorの利用者名には العَرَبِيةُ、中华民族、Xï のような非ASCII文字、あるいは空白（半角スペース）を含めることができない点に注意してください。空白（半角スペース）の代わりに、アンダースコア (半角アンダーバー) "_" を使用してください。 認証には有効なメールアドレスも求められますが、公開はされません。[1]
  • 左のナビゲーション欄もしくはご自分のプロフィール写真欄直下のポップダウン式メニュー (画面上部の検索欄の左側でメニューバー内) にあるManageボタンを押します。
  • 続いてEdit Profileを押し、他の人が探しやすいように Also Known As 欄（別名としてたとえば姓名）を記入します。

ウィキメディアの開発者アカウントを使う

もしウィキメディア開発者アカウント — 別名 LDAP アカウントとも呼ぶ — を持っているなら、それでもログインできます。Phabricator の単一の利用者名に対して、MediaWiki.org と LDAP の両方を連携できます。これは万一、ウィキメディアのSUL (グローバル ウィキ アカウント) がうまく使えない場合のバックアップとして機能できます。 もしあなたがWMFのスタッフか契約者なら、WMF ITSによって作成されたあなたのウィキメディアのSULアカウント（グローバルアカウント）も連携してください。
Phabricatorの単一の利用者名にのみ、ウィキメディアの統一アカウントと開発者アカウントを接続してください！ そうしないと、Phabricator のアカウントをふたつ作ることになってしまいます。


多要素認証

セキュリティタスクにアクセス権のある利用者、秘密保持契約(NDA)を必要とするタスク、および管理者を除き、ウィキメディアのファブリケータでは多要素認証の使用は推奨しません。それでもなお多要素認証を使おうとするならば、まず多要素認証のガイドラインと要件を読んでから、ご希望ならば設定してください。

トラブルシューティング

Phabricator にアクセスする

  • 度重なる不正行為が原因で、(たとえばエジプトなど) 特定の国にある IP アドレスから Phabricator へのアクセスを遮断しています。プロキシ、VPN、Tor のエグジット ノードも一部ブロックしています。これら該当する IP から Phabricator にアクセスしようとすると、利用者には HTTP エラー (500 または 501) が表示されます。もしご利用の IP がブロックされていて、なおかつ Phabricator にアクセスできるプロキシが見つからなかった場合、IP のホワイトリスト化の要請は security wikimedia.org 宛にご連絡ください。
  • Phabricator のアカウントが無効になった場合は、Talk:Phabricator/Help にその旨を投稿してください。

メール アドレス

  • 入力したメールアドレスの間違いが原因で Phabricator のアカウントが無効になった場合は、Talk:Phabricator/Help にその旨を投稿してください。 (それが不可能な場合は、Bugwranglerに連絡してください。) メールアドレスの修正はできませんが、再登録できるようにするためにアカウントを削除することはできます。
  • If you see the error "Email address already taken" when trying to create a Phabricator account on the page "Login or Register - MediaWiki", you have likely already registered a Phabricator account with such email address. このリンクを使ってアカウントを復元することができます。

アカウントの変更

  • Phabricator アカウントのユーザー名を変更する場合は、Talk:Phabricator/Help ページにそのことを投稿し、その際はご利用の Phabricator プロフィールへのリンクを含めてください。
  • Phabricator アカウントに紐づけたグローバルなウィキアカウントもしくは開発者アカウントの変更は「refresh account」リンクから実行します。

その他の問題点

かつて使った Bugzilla および／または RT アカウントの取得は、このリンクをクリック。

更新と通知を受け取る

利用者に関係のある活動について、自分自身の操作を含めてPhabricatorから通知が届きます。

Phabricatorには通知を受け取る方法がいくつかあります。

  • 単一のオブジェクト（タスクやモックアップなど）に興味があるなら、そのページのSubscribe（登録する） をクリックしてください。コメントをつければ、自動的に登録されます。
  • あるプロジェクトの事象すべてに興味がある場合は、プロジェクトの説明ページにあるWatch Project（プロジェクトをウォッチする）をクリックしてください。 詳しい情報はProjectsの利用者ガイド「Watching Projects」の項目を参照してください。 メンバーになってもプロジェクトの更新が通知される訳では無いことに留意してください。

メール通知の受信件数の制限とフィルタ設定は、Phabricator/Help/Managing mail を利用します。

トラブルシューティング

タスクに関連して想定外のメール通知を受信した場合：

  • タスクのメーリングリストを購読した記憶はありませんか。
  • そのタスク関連のプロジェクト、サブプロジェクトに参加しませんでしたか。自分が参加しているプロジェクトの一覧で確認できます。
  • そのタスクに関連のあるプロジェクトをウォッチリストに入れていませんか。ウォッチリストに登録した全記事の一覧で確認できます。
  • 「Maniphestタスク」欄にあるご利用のメールの個人設定で「特定のタスクの下位タスクにステータス変更を許可」を可能にしてありませんか
  • 自分専用にヘラルド規則を設定していませんか。「X-Herald-Rules」メッセージヘッダー欄で、適用されたヘラルド規則の総覧を確認できます。
  • これらを全部試してもダメだった場合は、メッセージヘッダ欄の「X-Phabricator-Stamps」にその他の情報へのリンクがあります。 Phabricator/Help/Managing mail を参照してください。

もっと複雑な通知のルールを設定（Herald 利用）

Wikimedia Phabricator's Heraldでカスタム（個人用）通知ルールを作成することができます。これはより高度なオプションであり、パフォーマンスの観点から使うべきではありません。

タスクの作成

 
タスク作成フォームの1つ。これは「シンプルフォーム」です。

タスク作成の方法はいくつかあり、伝えたい情報の種類によって使い分けます:

  • 新規タスク：上部のナビゲーションバーの右側にあるブックマークのボタンを押すとドロップダウンメニューが開きます。Create Taskを選ぶと、記入用のフォームが開きます。
  • セキュリティの問題：上部のナビゲーションバー右側のブックマーク ボタンを押します。 ドロップダウンメニューが開くので、Report Security Issueを選んで押します。 するとすでにSecurityタグがついた記入用のフォームが開き、セキュリティ上のバグを報告する方法について、特別な指示を受けるページへのリンクが添えてあります。
  • 既存のタスクの下位タスク：既存のタスクの右欄にある、Edit Related Tasks… > Create Subtaskの順に押します。2件のあいだの依存関係が設定され、親タスクと同じ指数が既定で付きます（Assigned To、Subscribers、Priority、Projects）。作成した下位タスクは親タスクの「Task Graph」に置き、タスク2件の関連を示します。 下位タスクを作成する前に、必ずプロジェクトタグをよく検討し購読者を調整してください！

フォームに記入するとき、よくわからない欄は変更しないでそのままにしてください。

Phabricatorは、テキストエリアのいくつかの書式をサポートしています。#Formatting and markup を参照してください。

投稿前にページ下部のプレビューボタンを押して書いた内容を確認。

プロジェクトを選ぶ

Phabricatorを利用するプロジェクト（タグ）にタスクを関連付けるには、Tags欄にプロジェクト名を記入し、自動補完で表示されるリストから該当するものを選びます（リストにはヒットした5件だけ表示）。プロジェクトを検索して短い説明を読むには、Tags欄の虫眼鏡アイコンを押します。Tags欄には2件以上プロジェクトを記入できます。もしわからなければ空欄のままでかまいません — プロジェクトを指定していないタスクは triagers が対処してくれます。（長い）プロジェクトの一覧もあります。プロジェクトを検索するにはEdit Queryを押します。（この一覧はPhabricator/Projectsでも閲覧できます。）

タスクの優先度を設定する

通常、優先度を設定するのは、製品管理者、メンテナー、もしくはそのタスクを担当する予定の開発者、あるいは bugwrangler かコミュニティ内の経験豊かなメンバーであり、バグ報告者や外部のオブザーバーではありません。詳細はPhabricator project management（プロジェクト管理）を参照してください。

メールを使う

タスクの作成はtask@phabricator.wikimedia.org宛てにメールを送って処理することもできます。 メールの題名がタスクのタイトルになり、メール本文をそのまま読み込んでタスクの説明に、添付ファイルはトークページに読み込まれます。 プロジェクトを指定するには、メール本文の冒頭に !projects コマンドに続けてハッシュタグを、例えば!projects #mediawiki-generalと記述します。 その他のコマンドを使い、メール経由でタスクの担当者、優先度、状態を設定できます。

注記: もしメールの署名の書式が慣行上の標準（本文と署名を識別する 「 -- 」半角ハイフン2個を含む）に従っていないと、それも同様に投稿されます。初回の利用時に、メール署名から個人を特定できる情報を削除するよう推奨しています。

タスク作成URLで特定の値を渡す

「Phabricatorでバグを報告」リンクは、汎用タスク作成リンクに追加されたURLパラメータを使い、多数の値をわたすことができます。

これは非常に高度な機能です。詳細はこちらを参照してください。

Another option is to request a custom form for task creation which also supports setting a task subtype (e.g. "bug report" or "feature request"). See custom forms.

タスクの状態とライフサイクル

See Bug report life cycle for the meaning of the Status field values.

他のタスクと重複するタスクを閉じるには、サイドバーから「Edit Related tasks... > Close As Duplicate」を選択。

自分自身をタスクに割り当てる

自分自身をタスクに割り当てるには：

  1. Go to the task
  2. Click "Edit Task" in the Actions sidebar on the right.
  3. Add your username to the "Assigned To" field
  4. Click "Save Changes" at the bottom

タスクの編集とコメント投稿

返信するにも、やはりアカウントが必要です。 Phabricatorではコメントや説明文の投稿や編集ができ、書式を付けたり、「添付ファイルをアップロードする」に説明したように、画像その他のファイルを添付したりできます。入力欄の上にツールバーがあるので、Phabricator独自の書式設定機能が使えます。

投稿前にページ下部のプレビューボタンを押して書いた内容を確認。

タスクの説明を修正するには、サイドバーの「Edit Task」ボタンを押します。

タスクのサブタイプを変更

The subtype can be edited via the comment area's "actions" section:

 
Example of changing Phabricator ticket subtype

書式設定とマークアップ

Phabricator では説明文の箇所で特定の書式設定が使えます。

Phabricator自体のマークアップ言語はMediaWikiのマークアップとは異なる点にご注意ください。

よく使うマークアップの例を挙げます:

  • ユーザー名を @ユーザー名 の形で書くと、相手のプロフィールにリンクして、相手を購読者にします。
  • タスク番号を例えば T123 のように追加すると、タスクとのリンクで結ばれ、またホバーカードが付きます。 {T123} と入力すると、文中にタスク名が挿入されます。
  • プロジェクト名を #プロジェクト名 の表記のとおりに追加すると、プロジェクトのメインページへのリンクを生成します。
  • テキストを引用したい場合には、先頭に > を追加してください。 コメントを引用して返答したい場合は、返答したいコメントの右端にあるドロップダウン矢印をクリックします。
  • モックアップの画像ファイルで既にアップロードされたもの、たとえばM123を自分のコメントに埋めこんで使うには、{M123}と入力。
  • 外部リンクを作成するには、たとえばウィキマークアップで[https://www.mediawiki.org example]を使いたいなら、PhabricatorでMarkdown 構文を使用。例＝[example](https://www.mediawiki.org)
  • 例えばテスト事例を示すためにウェブ アドレス(URL リンク) をコメント内に追加したい場合、ウェブ ブラウザのアドレスバーからウェブ アドレス全体を、例えば https://www.mediawiki.org/wiki/Project:Support_desk のようにコピー & ペーストします。 mw:Project:Support desk を使用しないでください。 ウィキ間リンクの接頭辞、たとえば mw: はPhabricatorでは使えません。
  • コード行をペーストする場合は、コードの前後をバッククォート3個ずつ```で挟みます。 2つのスペースでインデントしてもかまいません。 もしくはペーストを作成、タスクからペーストにリンクします。
  • Use [ ] item to define list items with checkboxes in the task description.

Change it to [X] item to resolve a list item.

添付ファイルをアップロードする

  警告: セキュリティ・パッチでない限りは、レビューのためにパッチを Gerrit にアップロードすべきです。
  警告: Phabricator file uploads inherit permissions from the tasks to which they are posted, which often makes them publicly-viewable. See below for more details.

ファイルのアップロード方法はいくつかあります。ファイル（たとえばスクリーンショット）をコメントやタスク説明文書に入れるには、マウスを使ってドラッグ・アンド・ドロップできます。利用するシステムのクリップボード機能を使い、画像をコピー・アンド・ペーストすることもできます。 You can also click the "cloud" icon while editing / creating / commenting on a task and use the dialog.

If this is not available on your system you can use https://phabricator.wikimedia.org/file/upload/ and refer to the file number (like 123) that is shown after a successful upload by writing F123 in a comment. これは当該のファイルにリンクを生成する方法です。 ファイルをコメント内にインクルードするには、IDを右記のとおり括弧にくくります: {F123}。 すると画像は既定でサムネイル表示されます。 書式設定のその他の選択肢は、書式およびマークアップを参照してください。 ファイルのアップロード回数が多く、既定の手続きが不便だと感じる場合は、ホームページにテキストパネルを追加して直接リンクを設定することができます。

The size of the uploaded files is limited to ~4 MB.[2]

File visibility

Files uploaded through https://phabricator.wikimedia.org/file/upload/ always become public, visible to everyone. (Keep this in mind in case e.g. the file is related to a restricted security ticket.)

Files uploaded while editing/creating/commenting on a task are private, and visible to no one except the file's uploader, until they are attached to the task (at which point those who can see the task can also see the file).

Phabricator で追跡中
タスク T310833

Attaching the file to the task usually happens automatically when you save your changes, but it is possible to bypass this by accident – for example, by uploading the files on one task, then cutting-and-pasting the resulting {F...} markup into another task. When this happens, you (the uploader) will still be able to see the file, but no one else will see it. To resolve this problem, find the "Referenced Files" section in the task's sidebar, then click "File Not Attached" on the files marked in red and follow the scary prompts to attach it.

  • <span lang=
  •  
    Others can't view the file
  •  
    You can view the file
  •  
    Attaching dialog
  •  
    Grant permission dialog
  •  
    Confirmation on the task
  •  
    Others can view the file now!

File management

If you ever need to delete a file that you uploaded, open the list of files you authored, select the file and click "Delete File" in the sidebar.

You can also change the visibility of a file by viewing its page (such as https://phabricator.wikimedia.org/F35287447), then clicking "Edit File" in the sidebar and changing the "Visible To" field.

ファイル アクセス セキュリティ

ファイルの完全な URL ( https://phabricator.wikimedia.org/F35287447 ではなく https://phab.wmfusercontent.org/file/data/svlzontonhy6xxdjxwga/PHID-FILE-zbgqfq7jqirt2s24y5e3/red.png のような) があれば、誰でもそのファイルをダウンロードしたり、リンクを他の人にシェアしたりできることにご注意ください。 ファイル URL をアクセスから保護する認証はありません。 Phabricator のファイルは、不明瞭さによるセキュリティに完全に依存しています。任意のファイルの (疑似ランダムな) URL を推測することは、不可能ではないにしても、非常に困難です。 機密性が特に高いファイルに対して保護レベルを高めるには、より安全な方法を検討する必要があります。

プロジェクトの保守

Read Phabricator/Project management for essential information on maintaining and managing projects, e.g. on using project workboards, common practices, and agile workflows.

Phabricatorではプロジェクトはタグであり、タグはプロジェクトです。プロジェクトはワークボードを持つことができます。下位プロジェクトおよびマイルストーン経由の階層が利用可能です[3]。タスクは複数のプロジェクトに割り当て可能です。　　　

新しいプロジェクトを要請する

Phabricator/新規プロジェクトを要請するを参照してください。

どんなときにプロジェクトが必要か？

一般的にプロジェクトが必要になるのは…

  • 1つまたは複数のプロジェクトを運営するチームを確立し運営者である場合 (開始はここで手がけ必要に応じてプロジェクトを申請)
  • ワークボードが必要なとき (すなわち、スプリント)
  • タグやキーワードを入手し、どのプロジェクトにも含めることができる種類のタスクを整理する場合 (「アクセシビリティ」など)

親タスクと下位タスク

タスクと言っても、親タスクもあればその他のタスクを複数個まとめた下位タスクを指す場合もあります。A というタスクの解決には B というタスクの解決が前提である場合、タスク A は親タスク、タスク B は下位タスクです。このような関係性は「関連タスクの編集...」機能で設定します。タスクの「タスクグラフ」には、親タスクと下位タスクを表示します。この機能はいくつかの作業実行に利用できます。

  • ブロッカーと下位タスク。タスク A（親タスク）が他の（下位）タスクにブロックされる場合には、依存関係が存在します（下位タスクの追加方法を参照してください）。
  • トラッキング（追跡）。 「作業を発生しない（workless）」（親）タスクが複数の（サブ）タスクにブロックされる場合は、単一リリースもしくはその他の期間に発生した一連の（サブ）タスクに引きずられていることがあります。 ここで言う「トラッキング」とはPhabricatorの廃止された#Trackingタグとは異なる点にご注意ください。
  • 承認。（親）タスク（チームゴールの草案など）が単一の（サブ）タスクにブロックされる場合は、草案タスクが承認されており、草案ゴールが現実ゴールに変わった状況を示します。

注記: 「関連タスクを編集... > 下位タスクを作成」機能があります。タスクの親／サブ関係を正しく設定するほか、新しい下位タスクにCC（購読）リストを作成します。ただし、希望しない購読者にも不用なメールを送る可能性があり、結果として手動で購読解除を強制することになりかねません。そのため、場合によってはそのような新規タスクは機能を使わずに手で書くべきで、その後、手動で下位タスクに指定し、購読するかどうかは利用者が選べるようにすることができます。

優先順位付け

Phabricator/Project management#Setting task priorities を参照してください

割り当て

Phabricator/Project management#Assigning tasks を参照してください

タスクの「追跡」

「tracking task」（タスクの追跡）という用語はBugzillaから持ちこまれ、特別な意味がありました。他のタスクでブロックされたタスクでそれ自体は何も作業を行わないもののうち、リリースあるいは日付と紐付けされていないタスクを指します。一例として「説明文書をクリーンナップ」というタスクを仮定し、さまざまな関連下位タスクがあり、それぞれ目指す作業が設定してあるとします。これらの「追跡」タスクは、下位タスクが解決しても新規に下位タスクが作成されるため、一般に長期的に（あるいは永続的に）付随する傾向があります。Phabricatorでは依存関係のある「追跡タスク」よりもプロジェクトのほうが好まれています。

しかしながら、作業を伴わない傘下型タスクが他にもあり、いずれもPhabricatorでは意味がある存在です。特筆すべきは「リリース」タスクです。今後のリリースはタスクで表すことができ、当該のリリースの対象となる実際の作業タスクすべてを下位タスクとして一覧表示します。リリース終了時には解除できます。同様の使用法なら、四半期のチームの全体目標を表すタスクを作成しておき、個々の目標は下位タスクとしてブロックする（またはしない）ように設定できます。

アイテムの検索

検索の文脈（グローバル検索と高度な検索）

Phabricatorはいくつかのアプリケーション（一例としてタスク管理「Maniphest」またはコード検索のDiffusionなど）で構成されています。 検索方法は2種類あります。

  • https://phabricator.wikimedia.org/search/query/advanced/はグローバル検索で、「高度な検索」と紛らわしいラベルが付いています。 たいへんわかりやすい方法です。 画面の上部右側にあります。 既定では、あらゆるアプリケーションを横断検索し、あらゆる種類の解説文書を返します (検索結果にはタスクの解決・未解決、コードコミットの種別他が混在)。 既定のコンテクストを変更するには、検索バーの左側にある三角矢印を押して指定します。 一例として、「Open Tasks」を選択するとManiphestの追跡機能から未解決のタスクのみ表示します。 あるいは「Current Application」を選択すると、検索対象をManiphestをとしてManiphestを、DiffusionとしてDiffusionを検索します。 特定したタグを統合 (OR化)。
  • Advanced, application specific search, for example at https://phabricator.wikimedia.org/maniphest/query/advanced/ for Maniphest. This one has more fields, and auto-completion that includes "Not in:..." (equivalent to NOT) and "In any:..." (equivalent to OR) (for example, type "echo" in the "Tags" field). There is also an advanced search for most other applications (e.g. phab:file/query/advanced for Files). To only search for tasks / bug reports, use the Maniphest advanced search. 指定されたタグは交差しています（ANDしています）。

Inside Maniphest, custom, saved searches and advanced search options are listed in the navigation bar on the left.

検索語

Special care needs to be put in choosing correct search terms.

Some locally-valid properties for the "Query" field:

  • Case insensitive: Edit is the same as eDIt
  • phrase search works: "fatal error"
  • basic tokenization is performed, e.g. to strip punctuation
  • Stemming is performed: "edited" is also found when searching for edit. However, "edited" does not match edit as quoted text does not stem.
  • Substring search is supported: ~amp matches example, but amp does not.
  • ~"an examp" matches an example as quoted and substring-operator text uses substring search.
  • Boolean queries to exclude certain terms are possible by using the - symbol before the unwanted term. E.g. use -non fatal error to exclude "non-fatal" errors from results.
  • To only search in a task title but not in the task description or comments, use title:quick ferret which is the same as title:quick title:ferret. To search for one term in the task title and other terms anywhere in a task, use ferret title:quick or title:quick all:ferret. 詳細情報は https://secure.phabricator.com/book/phabricator/article/search/ を参照してください。

The advanced search forms are not explicit about the logic but in general use AND between different fields.

You can exclude specific projects from the results by entering not(projectname) (equivalent to NOT) and combine several projects via any(projectname) (equivalent to OR) via the auto-completion suggestions.

There's a limit of 5 items in the maniphest autocomplete.

To increase this limit, see these userscripts for Chrome and for Firefox.

You can search for specific task IDs by leveraging a hidden "IDs" field, revealed when a search URL takes the following format:

https://phabricator.wikimedia.org/maniphest/?ids=1,2,3,4#R

フィールド公開後も、URLを直接操作することで結果が返りますが、フィールドに直接入力することも可能です。 The format is the number of the task only (removing the typical T prefix), comma-separated. This can be useful if you are pasting tasks from another place, such as a spreadsheet or database.

Another way to reveal the "IDs" field on various search forms is by enabling the "Expert Mode" checkbox in your Phabricator user settings. To enable expert mode, first visit https://phabricator.wikimedia.org/settings/ and then click the "Developer Settings" menu on the left sidebar.

特定の何かを探す別の方法

If you don't remember the exact words used in an item you are looking for you can follow one of these paths:

  • use the activity feed and edit the query to be restricted to certain projects or timeframes
  • use the activity feed to list all actions that you performed in a certain timeframe at phab:feed/query/EW2FwdAi.Kfz/
  • use an external search engine;
  • remove all search terms, refine the search only by project etc. and then scan all the possible results manually or use Ctrl+F to search specific strings (this might require setting "Page Size" to a high value to display more than only 100 results);
  • file a new task, mentioning that a past report exists as well, and wait for someone to merge the new report to the old.

日付、期間を選択

高度な検索Advanced Search限定で利用できます。

その日以前「Created After」やその日以降「Created Before」の日付欄には絶対日付と相対日付を入力できます。ManiphestではUTCを使用するのでご注意ください。

To get a list of tasks which were created in the last 24 hours, set the "Created After" field to "-24 hours" or "-1 day". Note that "Updated Before" actually means "Last updated before" and that absolute date values like "2014-11-26" refer to UTC time while your time zone setting might be different.

The "Updated After" and "Updated Before" fields return any and all changes to a task.

For example, when a task is moved to another column in a board it registers as "updated". This may add noise to your search results.

Examples of how Maniphest interprets searches:

  • "02/25/2015" - interpreted as "00:01 on February 25th, 2015" (UTC)
  • "5 days ago" - interpreted as "00:01 on the fourth calendar day before today" (UTC)
  • "2:45 AM 5 days ago" - interpreted as "02:45 on the fourth calendar day before today" (UTC)

The "X days ago" range can be confusing. Phabricator interprets today as part of any data set. Even if it is 12:30 UTC, Phabricator will interpret that as a potential day in the range.

検索/クエリの保存と管理

クエリの保存と管理はManiphest上で行います。

Maniphestでは左側のナビゲーションバーにあるボタンから、あらかじめ設定した検索クエリへのリンクを提供します。一例としてauthoredリンクを押すと、ご自分が作成したタスクの一覧を表示します。

検索クエリのアドレス (URL) は固定であり、保存と再利用の対象です。他の人と共有するには、ご利用のWebブラウザのURLアドレス欄からコピーペーストすればよく、たとえばリンクをウィキページ上に投稿します。

特定の検索を保存するには、高度な検索のUIであるAdvanced Searchの最下部で「Save Query」ボタンを押します。

Maniphestの画面左のナビゲーションバーを見て、「Edit Queries…」リンクを押します。するとご自分がこれまでに保存したクエリの一覧が表示されます。利用者各人に既定の一式があり、このUIから削除できます。

このUIにある選択肢は次の通りです。

  • 一覧にあるクエリの表示位置を変更するには、左にある行エレメントを使用。
  • x を押すとそのクエリを完全に削除。
  • 鉛筆アイコンでクエリ名を編集
  • クエリ名をクリックすると、検索オプションとそのクエリ結果を表示

一度、クエリを保存すると、後からそのパラメータを変更することはできませんが、クエリ名は変更できます。クエリを編集するにはクエリ名をクリック、パラメータを変更して新規クエリとして保存します。その点、Phabricatorでは利用者が同一の名称で複数のクエリを保存できます。

他の人と共有する検索で使うためなど、利用者名を動的に変えたい (例：「Tasks assigned to the person running this query」このクエリを実行する利用者にタスクを割り当てで使用) 場合は、現在の閲覧者をAuthors > Magnify glass icon > Browse Users > "Current viewer"で選択します。

ここで留意したいのは、一般的なクエリには保存されたものがあり、Phabricatorのフロントページの「Activity」タブからアクセスします。

Bugzillaバグ番号と対応するManiphestタスクを検索

高度な検索Advanced Searchでのみ有効です。

2014年以降、Bugzillaから移入したPhabricator タスクはすべてReference欄を表示し、値 bz に続けてBugzillaのバグ番号を付与してあります。 特定のBugzillaレポートに対応するタスク群を検索するには、高度な検索advanced searchのReference欄を使うか、単に2000と書き加えます。

スパムや不正利用を報告する

In case of spam or vandalism on Phabricator, the best place to report it is on the #wikimedia-releng 接続 IRC channel. (Wikimedia Foundation staff not on IRC can post in a relevant Slack channel like #engineering-all.)

In case of harassment or offensive behavior, follow the instructions at Code of Conduct#Report a problem .

高度な機能

ダッシュボードを使う

ダッシュボードとは特殊な構造のホームページで、特化した情報を幅広く表示します。利用者が作成や管理、他の利用者との交換ができます。

ダッシュボードの使い方ガイドはこちら。

一括編集

Phabricatorを使うと大量に／一括してタスク編集が処理できます。 どのManiphest検索クエリも最終段階で「編集バッチ処理を選択」としてShift＋クリックで選択したタスクをすべてまとめて編集する機能があるのに気づくと思います。 この機能を使用したい利用者は、必ず acl*Batch-Editors グループに参加をお願いしています。 Note: to see more than 100 tasks at a time, you can update Page Size in the query.

編集の一括処理は一括編集の開始時に生成される「一括ジョブ」IDをメモしておき、これを使って巻き戻しが可能です。一括編集実行の前か後に、「詳細」ボタンを押すと表示できます。その後のページでは「つづき」のメニュー項目が画面右に表示され、関連タスクすべてに影響するManiphestクエリを生成します。

If you have to perform the very same 'uninteresting' action on a lot of tasks (cleanup or reorganizing project structures) and you do not want tasks to send typical notifications, ask someone with CLI server access (people listed under phabricator-admin or phabricator-roots) to silence that specific batch edit before running it, so no notifications will be sent for tasks in that batch edit. Silent batch-moves of tasks from one column to another column (via "Move tasks to column…" in the column header dropdown) on the same workboard are not supported as of July 2020.

Please be mindful about silencing a batch edit. For example, silencing is usually not appropriate for closing tasks as task subscribers would expect to get a notification.


お気に入り

上部のナビゲーションバー右側にある本型メニューはカスタマイズ可能で、よく使うフォームや処理をリンクできます。 詳細な情報を参照するにはプロファイルメニューを開いてください。

アイテムの個人的リスト

「フラグを付ける」機能は「後で思い出して読みたい」オブジェクト（タスクや更新）にマークを付けることができます。色は8色使えます。フラグは個人情報でありプライバシーに属するため、他の人と共有できません。フラグをつけたオブジェクトはフラグにまとめます。トークンとは対照的に、色もしくはオブジェクトの種類で検索します。

Phabricator のバッジ

特定の利用者あるいは特定のグループ内の個人を顕彰する目的で、バッジを贈ることができます。

現在、実用されているバッジを贈呈する手続きは管理者のみ認められます。

タスクへのアクセス制限

新規タスク

作成予定のタスクへのアクセス権を特定のリスト内の利用者のみに限定するには、「Visible To」欄を「Public」以外に設定します。 This requires using a form which shows the "Visible To" field (for example the default advanced form). Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. To avoid vandalism, this "Visible To" field is only available to users who are members of some ACL projects or WMF-NDA. A list of all projects that you are a member of is available.

#WMF-NDA プロジェクト・タグ参加者である場合、作成予定のタスクへのアクセス権を#WMF-NDA プロジェクト参加者に限定するには、画面上部のバーからブックマークのドロップダウンメニューを開き、「NDA Protected Task」を選択します。

セキュリティの問題

新規にセキュリティの問題を提言するにはReporting security bugsの手順を守り、くれぐれも1番目のタスクが公表されないようご配慮ください。 既存のタスクをセキュリティの課題に変更するには、サイドバーの「Protect as security issue」を押します。

Existing tasks

「タスクの編集」から既存のタスクへのアクセス制限を変更し、その後、「Visible To（公開する対象）」欄を「Public（一般）」以外に変更します。 Note that setting "All Users" on a task will not restrict access to a task, as everybody can simply create an account and then still access a task with that visibility. 荒らし予防策として「Visible To」欄は一部の ACL プロジェクトまたは WMF-NDA メンバーにのみ表示されます。ご自分が参加するプロジェクトの総覧をご用意しています。

Spaceの表示と使い方

Space (アップストリーム説明文書) はオブジェクトのグループ（タスクなど）に対する制限付きのアクセスを特定のグループ限定で提供します。設定の詳細はSpaceの方針Restricting access via Space policiesを参照してください。

最低2件のSpaceにアクセスできる利用者には、オブジェクトの作成と編集中に「Visible To（公開する対象）」の下にドロップダウンメニューが表示されます。アクセス権が1件分しかない利用者には、このコントロールは提供されません。

Maniphestのタスク表示では、Spaceはタスクサマリより前面に表示されます。タスクを一括編集し、異なるSpaceへ移動することができます。

非公開（でありご自分にはアクセス権限があり検索クエリやプロジェクトのワークボードに表示される）Spaceであっても、「公開の」（というものが存在するなら）プロジェクトとタスクを対応付けする必要がある点にご注意ください。グローバルなHerald規約を申請すると「公開の」プロジェクトを自動的に追加できます。

Spaceでタスクを作成するには、「タスクの作成」ドロップダウンメニューにある"Create Advanced Task"オプション（高度なタスクの作成）を使用します。 このオプションはタスク作成UIにある「Visible To（公開する相手）」の下に別のドロップダウンを表示するので、それを使い、タスクを表示するSpaceを公開する相手の設定ができます。

もし「Create Task」ドロップダウンメニューにある「Create Simple Task」（単純なタスクの作成）オプションを使ってタスクを作成した場合は、作成後にタスクを編集してSpaceのどのメンバーに限定して公開するか設定します。 その編集を済ませないうちは、だれもがそのタスクを閲覧でき、また利用者のタスクの通知はログが公開されたチャットルームや、購読している個人に向けて送信される可能性があります。

  •  
    最低2件のSpaceにアクセス権がある場合のタスク作成の表示
  •  
    非公開Space上のタスクの表示
  •  
    非公開Space上にあるタスク2件のワークボード表示

MediaWikiのテンプレートとリンク

メインのページ: Help:Interwiki linking
Phabricator で追跡中
タスク T177
解決済
  • ウィキページからPhabricatorタスクにphabricator:および短縮形のphab:を使用して（ウィキ間リンク経由で）リンクすることができます。たとえば [[phab:T454|例]] とすると 例 が生成されます。
  • Template:Tracked というテンプレートが更新され、Phabricatorオブジェクトへのリンクを含むようになりました — 画面右手に表示された {{Tracked|T177|resolved}} の処理方法を参照してください。
  • Template:Phabricator というテンプレートも利用できます。{{Phabricator|T176}} の出力結果が タスク T176 です。

既存のBugzillaリンクやテンプレートは bugzilla.wikimedia.org を指し、さらに変換されたPhabricatorタスクにリダイレクトされることから、現在も使用できます。

統計

各プロジェクトページにはサイドバーに「報告」(Reports)リンクがあります。 これは主にチームプロジェクトにとって有用です。 これはタスクのスループット、タスクの経過時間、担当者（アサイニー）ごとの作業負荷、ワークボード・カラムごとのオープンタスク（未解決のタスク）の分布、バーンダウンチャート、およびアクティビティ図について情報を提供します。 特定の期間についてデータをフィルターすることもできます。

それ以外には、Phabricatorはさらなる統計、指標、グラフ、レポート（例えば、時間経過）あるいはどのような呼び出し方であれ、ビルトインであれAPI経由であれ、サポートしていません。[4]

Phabricatorには統計が提供され、オープンタスクの優先順位と利用者・プロジェクトごとに分類されています。

Some additional overall statistics can be found in the "Phabricator monthly statistics" emails sent to wikitech-l.

タスクデータのエクスポート

The results of an Advanced Search query on phab:maniphest/query/advanced/ can be exported to CSV and JSON formats. Use the "Use Results ▶ Export Data" in the upper right corner. If you are on the workboard of a project, the column header dropdown menu allows you to "View Tasks as Query" per column.


リポジトリ・ブラウザ（Diffusion）

詳細情報: Phabricator/Diffusion

DiffusionとはPhabricatorのリポジトリブラウザ[5]です。別のオプションとしては、リポジトリの閲覧専用のミラーとして https://gerrit.wikimedia.org/r/plugins/gitiles/?format=HTML でgitiles を用います。現状ではデモのため、Gitリポジトリを一部だけPhabricatorにミラーしています。

コードリポジトリの申請と新規作成は、Gerrit/New repositories/Requests を参照してください。

既定のフィールド (フォーム)

詳細情報: Phabricator/Help/Forms

Phabricatorでは特定のタスクに表示されるフィールドをある程度カスタマイズできます（例えば"bug report"あるいは"feature request"）。 これらはForms機能で処理されます。

API (Conduit)

Conduit（コンジュイット）はウェブAPIの名称です。 https://phabricator.wikimedia.org/conduit/ には多少の説明とサンプルが掲載されています。 Conduit アップストリーム説明文書を参照してください。 Phabricator/ボット も参照してください。

Phatality

Phatality is a plugin for the Wikimedia production Logstash installation which makes it easier to create Phabricator tasks for production errors.

Phatalityの紹介をご参照ください。

自動検索の概要

  • You can get a regular email with the results of a saved Phabricator query.
  • The emails are currently delivered by the PhabSearchEmail tool maintained by RhinosF1 on a weekly or monthly basis although, more frequenices can easily be added.
  • To request a summary email, fill out this form and let RhinosF1 know your email.

Get Notified about new UBN Tasks

See Setup UBN Notifications

脚注と関連項目

  1. ↑ しかしながら、Phabricatorでミラーされているリポジトリのどれかにコミットすると（コミットがGerrit経由かどうかにかかわらず）、他の利用者がアカウントとメールアドレスの間の接続を見ることができるようになります。
  2. ↑ phab:T243113#5814392
  3. ↑ T3670 (下位プロジェクト) 、アップストリーム Phabricator インスタンス
  4. ↑ T13279（統計）、アップストリーム Phabricator インスタンス
  5. ↑ Diffusionリポジトリ・ブラウザのユーザーガイドでアップストリームPhabricatorの例を説明します。
Retrieved from "https://www.mediawiki.org/w/index.php?title=Phabricator/Help/ja&oldid=6824668"