Einrichtung und Konfiguration - Notion
Was diese Integration macht
Die Integration mit Notion erstellt eine Seite in einer gewählten Datenbank direkt aus der Detailansicht eines Fehlers in DockRay - ohne Meldung, Absturzort oder Stacktrace von Hand zu kopieren. Das Anlegen der Seite speichert eine dauerhafte Verknüpfung: ein DockRay-Fehler zu einer Notion-Seite. Sobald die Seite in die Statusgruppe Complete wechselt, markiert DockRay den Fehler selbständig als gelöst. Das Lesen geschieht periodisch: der Befehl thor:sync-notion prüft verknüpfte Seiten alle fünf Minuten - Notion bietet Webhooks nur öffentlichen Apps an, und eine interne Integration eines Kunden ist keine solche.
Was du auf Notion-Seite brauchst
- Berechtigung, Integrationen im Notion-Workspace zu erstellen,
- eine Datenbank, die die Einträge empfangen soll,
- einen Moment, um diese Datenbank der neu erstellten Integration freizugeben - der Schritt, der am leichtesten vergessen wird und ohne den die Integration nichts sieht.
Anders als bei Jira gibt es hier keine Instanzadresse und keine E-Mail - Notion hat eine einzige API unter fester Adresse, authentifiziert allein durch das Integrationstoken.
Integration erstellen und Token kopieren
Erstelle in den Notion-Integrationseinstellungen (Workspace-Ebene) eine neue interne Integration und kopiere das erzeugte Token. Das Token bleibt in Notion jederzeit sichtbar, aber in DockRay ist es - wie jedes andere Geheimnis dieser Art - verschlüsselt und kehrt nach dem Speichern nie ins Formular zurück.
Der Integration eine Datenbank freigeben
Eine Notion-Integration sieht standardmäßig keine Datenbank - das ist keine Einschränkung von DockRay, sondern die Funktionsweise von Notion: Zugriff muss von Hand gewährt werden. Öffne die Datenbank, die du verbinden möchtest, und füge ihr unter Connections die zuvor erstellte Integration hinzu. Erst nach diesem Schritt erscheint die Datenbank in der DockRay-Liste.
Verbindung auf Konto- und Projektebene
Gehe im DockRay-Panel zu Einstellungen → Notion und füge das Integrationstoken ein - diese Verbindung bedient jedes Projekt des Kontos ohne eigenes Token. Wähle in Projekteinstellungen → Notion die Datenbank, die Einträge empfangen soll, eine Standard-Zuweisung sowie einen optionalen Startstatus. Die Namen der Eigenschaften in der Datenbank spielen dabei keine Rolle - DockRay erkennt Felder an ihrem Typ (Titel, Person, Status), nicht an dem Namen, den jemand in Notion eingetragen hat.
Der erste Test
Erstelle eine Notion-Seite aus einem beliebigen vorhandenen Fehler in einem Testprojekt. Prüfe in Notion, dass die Seite in der richtigen Datenbank gelandet ist, mit Titel, diagnostischer Beschreibung und Link zum DockRay-Panel. Beim Fehler in DockRay sollte jetzt ein Link zur erstellten Seite erscheinen.