GitHubインテグレーション

この記事の内容

NotionとGitHubを接続し、ワークフローを同期します 🧮

GitHubは、開発チームや企業が、ソフトウェアを構築・リリース・保守できるように支援するツールです。Notionでの仕事にGitHubを接続して、フィルターやビュー、リレーションなどの機能を持つNotionデータベースの力を活用しましょう。

NotionとGitHubのワークスペースを接続するには、Notionのワークスペースオーナー、およびGitHubのorg adminの両方の権限を持っている必要があります。

Notion内で直接、ファイルまたはファイル内の特定の行にリンクします。参照するコードを最新にしたい場合は、特定のコミットやブランチからリンクすることもできます。

これを行うには、GitHubから目的の行のパーマリンクをコピーし、Notionページに貼り付けます。表示されるメニューで プレビューとして貼り付け を選択して、コードをページに埋め込みます。

GitHubのプルリクエストをNotionにリンクするには、データベースにプレフィックス付きのユニークIDプロパティが必要です。

Notionデータベース内のGitHubプルリクエストプロパティは、タスクのステータスを部門横断的なチームに自動的に通知してくれます。また、ロールアップ、数式、フィルターで使用できる属性も多数あります。

Notionデータベースで ＋ をクリックし、新しいプロパティを追加します。
GitHubプルリクエスト プロパティを検索してクリックし、データベースに追加します。
データベースにユニークIDプロパティがあることを確認してください。このプロパティがデータベースにまだない場合は、追加されます。
GitHubプルリクエストプロパティを使用するには、GitHubアカウントがNotionに接続されている必要があります。接続したら、NotionタスクのユニークIDをプルリクエストに追加するか、GitHubプルリクエストURLをプロパティに貼り付けます。

Notionはデフォルトで、NotionタスクからGitHubへのバックリンクを有効にします。これをオフにする場合は、データベースのGitHubプルリクエストプロパティをクリックし、プロパティを編集 を選択したら、GitHubのリンクバックをオフに切り替えます。

このGitHubプルリクエストプロパティを使うと、Notion上のタスクのステータスを自動的に更新することができます。

リンクされたNotionタスクに、GitHubのアクティビティを表示することもできます。これを行うには、データベース内のGitHubプロパティをクリックし、プロパティを編集 を選択したら、アクティビティコメント をオンにします。

GitHubプルリクエストを1つ以上のNotionタスクにリンクする場合は、プルリクエストの説明にマジックワードとNotionタスクのユニークIDを入力するだけです。

マジックワードは、NotionタスクとGitHubプルリクエストとの間の関係を確立するのに役立つキーワードのことです。次の単語のどれでも使えます。

たとえば、PRに「fixes CTT-13」という説明を付けると、IDが「CTT-13」のNotionタスクがそのプルリクエストにリンクされます。

プルリクエストの説明にタスクの終了や完了に関するマジックワードが使われている場合、プルリクエストがマージされるときにNotionタスクは完了とマークされます。

プルリクエストの説明にタスクの参照や関連に関するマジックワードが使用されている場合、プルリクエストがマージされてもNotionタスクは完了とマークされません。

Notionタスクを参照専用としてリンクすると、それらのタスクは完了としてマークされません。

フィードバックを送信

Notion APIを使用すれば、他のソフトウェアをNotionに接続してワークスペース内のアクションを自動化したり、弊社パートナーが構築したコネクトにアクセスしたりできます 🤖