プルリクエストの使用方法

プルリクエストとは、ある開発ブランチの変更を他の開発者のブランチに取り込んでもらうためのリクエストを出す機能のことです。

Backlogのプルリクエストでは、次のようなことができます。

詳しくはプルリクエストとは？ - サル先生のGit入門を参照してください。

プルリクエストの一覧画面では、登録済みのプルリクエストの一覧を表示できます。

プルリクエストの閲覧画面へは、以下の方法でアクセスしてください。

最初に画面を開くと、状態が「Open」のプルリクエストだけが一覧に表示されています。

状態が「Close」や「Merged」のプルリクエストを表示したい場合は、テーブルヘッダーの「状態」をクリックしフィルターを変更してください。

プルリクエストの一覧を絞り込んで表示したい場合は「🔍キーワード」にキーワードを入力してください。

プルリクエストの追加は、Gitのブランチ画面、ブランチ / タグ間差分の画面、もしくはプルリクエストの一覧画面で行うことができます。

次の手順でプルリクエストを追加してください。

ターゲットブランチとプルリクエストブランチを選択したタイミングで、「コミット履歴」と「ファイル」の差分が閲覧できます。

また、プルリクエストブランチの名前に、Backlogの課題キーを含めておくと、その課題の件名がプルリクエストの「件名」に表示されます。「関連課題」にその課題キーが自動で設定され、変更も可能です。

プルリクエストの一覧画面で任意のプルリクエストを選択して詳細画面に進み、「編集」をクリックすると、プルリクエストを編集できます。

ターゲットブランチ（プルリクエストをマージする対象のブランチ）とプルリクエストブランチ（マージしてもらうブランチ）は変更できません。

プルリクエストのコメントは課題のコメントのように、お知らせしたいユーザーを指定してコメントできます。

プルリクエストの登録時や更新時、コメント登録時に送信されるメールに対して返信してもプルリクエストのコメントは登録できません。

また、コードを指定してコメントができます。「ファイル」タブでコードを表示し、マウスオーバーした時に対象の行に表示されるコメントアイコンをクリックするとコメント欄が表示されます。

対応してほしい内容とお知らせしたいユーザーを入力し、登録をクリックします。

プルリクエストされたコードをマージせずにクローズする場合は、プルリクエストの詳細画面で「却下」をクリックします。

コメント欄が表示されるので、却下理由がある場合はコメント欄に記載して「却下」をクリックしてください。

プルリクエストされたコードをマージする場合はプルリクエストの詳細画面で「マージ」をクリックします。

「マージ」をクリックする前に「マージされたあとにブランチ［ブランチ名］を削除する」にチェックを入れておけば、マージした後に作業ブランチが削除されます。

コードが競合する場合は「競合が発生しているため、マージができません」というメッセージが表示され、Backlog上からはマージできません。この場合、競合を解消しマージしてください。

競合の解消方法は、競合の解決を参照してください。