Test und Problembehebung - Notion
Die Integration testen
Nimm einen Fehler mit geringer Bedeutung aus einem Testprojekt und erstelle daraus eine Notion-Seite. Prüfe in Notion, dass die Seite in der richtigen Datenbank gelandet ist, mit korrektem Titel, Faktenliste und Link zum DockRay-Panel. Um die Rücksynchronisation zu prüfen, verschiebe diese Seite von Hand in einen Status aus der Gruppe Complete und warte bis zu fünf Minuten - der Fehler in DockRay sollte ohne dein Zutun auf gelöst wechseln.
Typische Probleme
Die Datenbankliste in den Projekteinstellungen ist leer
Das bedeutet fast immer, dass keine Datenbank der Integration freigegeben wurde - nicht, dass der Workspace keine Datenbanken hat. Notion zeigt einer Integration ausschließlich, was ihr jemand manuell über Connections auf der Datenbankseite freigegeben hat - das erzeugte Token allein gewährt keinen Zugriff. Öffne die richtige Datenbank in Notion, füge ihr die Integration hinzu und aktualisiere dann die Liste in DockRay.
Die Seite wird nicht mehr erstellt, obwohl die Integration vorher funktionierte
DockRay speichert die Eigenschaftsnamen der Datenbank nicht - es liest das Schema live und sucht die erste Eigenschaft vom Typ Titel, Person und Status, ein einfaches Umbenennen in Notion stört also für sich genommen nichts. Es geht kaputt, wenn die Eigenschaft dieses Typs gelöscht oder ihr Typ geändert wird - wandelt man etwa die einzige Titel-Eigenschaft in einfachen Text um, bleibt der Datenbank kein Feld, in das DockRay den Seitentitel schreiben könnte, und das Erstellen der Seite schlägt fehl.
Die Seite entsteht, aber ohne abschließenden Link zurück zu DockRay
Notion akzeptiert höchstens hundert Blöcke pro Anfrage, und DockRay kürzt den Inhalt vom Ende der Liste her auf diese Grenze. Bei einem Fehler mit sehr langem Stacktrace und umfangreicher Faktenliste kann der abschließende Absatz mit dem Link zum Panel nicht mehr in diese Grenze passen. Die Seite selbst wird trotzdem erstellt - es fehlt nur das letzte Element.
Der Status ändert sich in Notion, der Fehler bleibt aber in DockRay offen
Prüfe den Typ der Statuseigenschaft in der Datenbank. Die Rücksynchronisation liest die Eigenschaftsgruppen vom Typ status („Zu erledigen", „In Arbeit", „Erledigt") - nur daraus lässt sich ableiten, was „fertig" bedeutet. Eine Eigenschaft vom Typ select ist ein Ausweichplan: Sie erlaubt es, beim Erstellen der Seite einen Status zu setzen, hat aber keine Gruppen, sodass die Rücksynchronisation daraus nichts lesen kann und den Fehler nie als gelöst markiert. Lösung: die Statuseigenschaft in der Datenbank auf den Typ status ändern.
Das Erstellen einer Seite endet mit einem Zugriffsfehler
Prüfe, ob die Datenbank-ID in den Projekteinstellungen noch korrekt ist und ob der Zugriff der Integration auf diese Datenbank in Notion widerrufen wurde - das Entfernen der Integration aus der Connections-Liste sieht aus Sicht von DockRay genauso aus wie eine nie freigegebene Datenbank.
Es funktioniert weiterhin nicht
Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.