GitHub Issue管理からNotionへの同期 - n8n ワークフロー

ソフトウェア開発チーム： GitHubで管理しているバグ報告や機能要望をNotionのようなプロジェクト管理ツールに一元化したい場合。
プロジェクトマネージャー： 開発者がGitHub上で行ったアクティビティから得られる全プロジェクトの状況更新について、Notionを唯一の情報源（Single Source of Truth）として利用したい方。

• n8nユーザー： GitHubおよびNotionのn8n連携機能を利用して、複雑な分岐ロジックとデータベース同期を実現する高度なn8nテンプレートを探している方。

複数のプラットフォームにまたがる開発タスクの管理は、情報サイロ化を引き起こす可能性があります。この高機能なn8nワークフローは、GitHub IssueとNotionデータベース間に堅牢な双方向ミラーリングを構築することで、その問題を解決します。GitHub Issueでアクション（作成、編集、削除など）が取られるたびに、このn8n自動化がNotion内の対応するレコードを瞬時に更新します。この堅牢なn8nワークフローは、条件付きロジックとカスタムスクリプトを利用して、既存のNotionページを確実に検索・修正し、プラットフォーム間データ同期のための強力なノーコードソリューションを提供します。n8nトリガーを活用するこのテンプレートは、効率的なDevOpsとプロジェクト監視に不可欠です。

専用のGitHub n8nトリガーノードのおかげで、プロセスはGitHubで指定されたイベントが発生すると即座に開始されます。

1. トリガーと初期チェック： n8nトリガーが特定のGitHubリポジトリのIssueイベントを監視します。データペイロードは最初のIF n8nノードに送られ、GitHub Issueに対して実行されたアクション（例：'opened', 'edited', 'closed'）を検査します。


2. 新規Issueの作成： アクションが'opened'の場合、フローはNotionのCreate database page n8nノードに進み、新規Issueのタイトル、ID、URLが設定済みのNotionデータベースに記録されます。


3. 変更の処理： アクションが'opened'以外の場合、n8nワークフローはCreate custom Notion filters機能n8nノードに進みます。このノードはカスタムJavaScriptでJSONフィルターペイロードを動的に生成し、GitHub Issue IDを使用して既存のNotionページを検索します。


4. レコードの検索： Find database page n8nノードは、このカスタムフィルターを使用して、対応するNotionデータベースエントリの内部IDを取得します。


5. アクションのルーティング（Switch）： 中央のSwitch n8nノードが、実行された特定のアクション（'edited', 'deleted', 'closed', 'reopened'）を評価します。


6. 更新の実行： フローは該当するNotion n8nノード（Edit issue（タイトル更新）、Delete issue（ページをアーカイブ）、Close issue（'Closed'チェックボックスをTrueに設定）、またはReopen issue（'Closed'ボックスのチェックを外す））に分岐します。これにより、NotionレコードがGitHub Issueの正確な状態を反映することが保証され、この包括的なn8nワークフローの同期サイクルが完了します。

このn8nテンプレートをデプロイするには、以下の手順に従ってください。

1. n8nワークフローのインポート： 提供されたJSONデータをコピーし、「Workflows」画面で「新規作成」ボタンと「JSONからインポート」を使用して、ご自身のn8nインスタンスにインポートします。


2. 認証情報の設定： GitHubおよびNotionのn8nノード接続のプレースホルダー認証情報を、ご自身のAPIキーで更新してください。

1. データベースIDの指定： すべてのNotion n8nノード（Create database page, Find database pageなど）で、プレースホルダーのデータベースID (5026700b-6693-473a-8100-8cc6ddef62a6) を実際のNotionデータベースIDに置き換えてください。


2. GitHubトリガーの設定： Trigger on issues n8nトリガー内で、OwnerおよびRepositoryフィールドをGitHubの設定に合わせて更新します。


3. 有効化： 設定が完了したら、n8nワークフローを有効化してリアルタイム同期を開始します。

Issueでトリガー（GitHubトリガーn8nトリガー）：
機能： 特定のGitHubリポジトリのissuesイベントをリッスンする開始点として機能します。
主な設定： John-n8n/DemoRepoでのイベント監視に設定されており、特にissuesイベントタイプを対象としています。
IF（n8nノード）：
機能： GitHub Issueのアクションに基づいてフローを分岐させます。'opened'（新規Issue）とそれ以外のアクション（変更）でパスを分けます。
主な設定： body.actionがopenedと等しいかどうかを確認します。
カスタムNotionフィルターの作成（Function n8nノード）：
機能： 変更パスにおいて重要なn8nノードです。カスタムJavaScriptを使用し、プロパティ「Issue ID」が受信したGitHub Issue IDと一致するページを検索するためのNotion APIフィルターJSONペイロードを構築します。
データベースページの検索（Notion n8nノード）：
機能： 直前のn8nノードによって生成されたフィルターを実行し、既存のNotionレコードの一意なpageIdを取得します。
主な設定： 検索を実行するために、Function n8nノードからのJSONフィルター入力を利用します。
Switch（n8nノード）：
機能： GitHubアクション（edited, deleted, closed, reopened）に基づき、Notionで必要とされる後続のアクションを決定します。これはこの高度なn8nワークフローの核となるコンポーネントです。
主な設定： GitHubアクション文字列と4つの可能な結果を比較し、正しい更新n8nノードへフローをルーティングします。
Notionノード群（Issueの作成/編集/削除/クローズ/再オープン）：
機能： 以前に見つかったNotionデータベースページに対して、対応する状態変更を適用する責任を負います（例：Issueが削除された場合はページをアーカイブする、クローズ/再オープンされたIssueについてはチェックボックスの状態を更新するなど）。