GitHub Issue-Verwaltung mit Notion synchronisieren - n8n-Workflow

Softwareentwicklungsteams: Müssen Bug-Reports und Feature Requests, die in GitHub verwaltet werden, in einem Projektmanagement-Tool wie Notion zentralisieren.
Projektmanager: Bevorzugen Notion als die zentrale Wahrheitsquelle (Single Source of Truth) für alle Projektstatus-Updates, die sich aus der Entwickleraktivität auf GitHub ergeben.

• n8n-Anwender: Personen, die nach fortgeschrittenen n8n-Vorlagen suchen, welche komplexe Verzweigungslogik und Datenbank-Synchronisation mittels der GitHub- und Notion-n8n-Konnektoren demonstrieren.

Die Verwaltung von Entwicklungsaufgaben über verschiedene Plattformen hinweg kann zu Informationssilos führen. Dieser hochfunktionale n8n-Workflow löst dieses Problem, indem er eine robuste Zwei-Wege-Synchronisation zwischen GitHub Issues und einer Notion-Datenbank herstellt. Jedes Mal, wenn eine Aktion auf einem GitHub Issue ausgeführt wird – sei es das Erstellen, Bearbeiten, Schließen oder sogar Löschen – stellt diese n8n-Automatisierung sicher, dass der entsprechende Datensatz in Notion sofort aktualisiert wird. Dieser robuste n8n-Workflow verwendet bedingte Logik und benutzerdefinierte Skripte, um bestehende Notion-Seiten zuverlässig zu lokalisieren und zu modifizieren, was eine leistungsstarke No-Code-Lösung für die plattformübergreifende Datensynchronisation bietet. Durch die Nutzung eines n8n-Triggers ist diese Vorlage für effizientes DevOps und die Projektüberwachung unerlässlich.

Der Prozess startet unmittelbar, sobald ein definiertes Ereignis in GitHub auftritt, dank des dedizierten GitHub n8n Trigger-Knotens.

1. Trigger und Erstprüfung: Der n8n-Trigger überwacht ein spezifisches GitHub-Repository auf Issue-Ereignisse. Die Daten (Payload) treffen dann auf den anfänglichen IF n8n-Knoten, welcher die Aktion prüft, die am GitHub Issue vorgenommen wurde (z.B. 'opened', 'edited', 'closed').


2. Erstellung neuer Issues: Wenn die Aktion 'opened' lautet, fährt der Ablauf zum n8n-Knoten Create database page in Notion fort, wo Titel, ID und URL des neuen Issues direkt in der konfigurierten Notion-Datenbank protokolliert werden.


3. Bearbeitungshandhabung: Wenn die Aktion eine andere als 'opened' ist, bewegt sich der n8n-Workflow zum Funktionsknoten Create custom Notion filters n8n node. Dieser Knoten generiert dynamisch eine JSON-Filter-Payload, um die bestehende Notion-Seite anhand der GitHub Issue ID zu lokalisieren.


4. Datensatz finden: Der n8n-Knoten Find database page verwendet diesen benutzerdefinierten Filter, um die interne ID des entsprechenden Notion-Datenbankeintrags abzurufen.


5. Aktionsverteilung (Switch): Der zentrale Switch n8n-Knoten wertet anschließend die spezifische Aktion aus ('edited', 'deleted', 'closed', 'reopened').


6. Updates ausführen: Der Ablauf verzweigt zum zuständigen Notion n8n-Knoten: Edit issue (aktualisiert den Titel), Delete issue (archiviert die Seite), Close issue (setzt das Häkchen bei 'Closed' auf 'wahr') oder Reopen issue (entfernt das Häkchen bei 'Closed'). Dies stellt sicher, dass der Notion-Datensatz den exakten Status des GitHub Issues widerspiegelt und schließt den Synchronisationszyklus für diesen umfassenden n8n-Workflow ab.

Um diese n8n-Vorlage bereitzustellen (zu deployen), folgen Sie diesen Schritten:

1. n8n-Workflow importieren: Kopieren Sie die bereitgestellten JSON-Daten und importieren Sie sie in Ihre n8n-Instanz über den 'Workflows'-Bildschirm mittels der Schaltfläche 'Neu' und 'Aus JSON importieren'.


2. Anmeldedaten konfigurieren: Aktualisieren Sie die Platzhalter-Anmeldeinformationen für die Verbindungen der GitHub- und Notion-n8n-Knoten mit Ihren persönlichen API-Schlüsseln.

1. Datenbank-ID festlegen: Ersetzen Sie in allen Notion n8n-Knoten (Create database page, Find database page etc.) die Platzhalter-Datenbank-ID (5026700b-6693-473a-8100-8cc6ddef62a6) durch die ID Ihrer tatsächlichen Notion-Datenbank.


2. GitHub Trigger konfigurieren: Aktualisieren Sie im n8n-Trigger Trigger on issues die Felder Owner und Repository, damit sie zu Ihrer GitHub-Konfiguration passen.


3. Aktivieren: Sobald alles konfiguriert ist, aktivieren Sie den n8n-Workflow, um die Echtzeit-Synchronisation zu starten.

Trigger on issues (GitHub Trigger n8n trigger):
Funktion: Dient als Startpunkt und lauscht auf issues-Ereignisse in einem spezifischen GitHub-Repository.
Wichtige Konfiguration: Konfiguriert, um Ereignisse für John-n8n/DemoRepo zu beobachten und zielt speziell auf den Ereignistyp issues ab.
IF (n8n node):
Funktion: Steuert den Ablauf basierend auf der GitHub-Issue-Aktion. Trennt den Pfad zwischen 'opened' (neues Issue) und allen anderen Aktionen (Änderungen).
Wichtige Konfiguration: Prüft, ob body.action gleich opened ist.
Create custom Notion filters (Function n8n node):
Funktion: Kritischer n8n-Knoten für die Änderungs-Pfade. Er verwendet benutzerdefiniertes JavaScript, um eine Notion-API-Filter-JSON-Payload zu erstellen, die nach einer Seite sucht, bei der die Eigenschaft 'Issue ID' mit der eingehenden GitHub Issue ID übereinstimmt.
Find database page (Notion n8n node):
Funktion: Führt den vom vorherigen n8n-Knoten generierten Filter aus, um die eindeutige pageId des bestehenden Notion-Datensatzes abzurufen.
Wichtige Konfiguration: Verwendet die JSON-Filter-Eingabe des Function n8n-Knotens, um die Suche durchzuführen.
Switch (n8n node):
Funktion: Bestimmt die nachfolgende Aktion, die in Notion erforderlich ist, basierend auf der GitHub-Aktion (edited, deleted, closed, reopened). Dies ist eine Kernkomponente dieses fortschrittlichen n8n-Workflows.
Wichtige Konfiguration: Vergleicht den GitHub-Aktions-String mit vier möglichen Ergebnissen und leitet den Ablauf zum korrekten Update-n8n-Knoten.
Notion Nodes (Create/Edit/Delete/Close/Reopen issue):
Funktion: Eine Suite von Notion n8n-Knoten, die dafür verantwortlich ist, die entsprechende Zustandsänderung auf der zuvor gefundenen Notion-Datenbankseite anzuwenden (z.B. Archivierung der Seite, wenn das Issue gelöscht wurde, oder Aktualisierung des Kontrollkästchenstatus bei geschlossenen/wiedereröffneten Issues).