Testing and troubleshooting - Notion
Testing the integration
Pick a low-priority error from a test project and create a Notion page from it. In Notion, check that the page landed in the right database, with a correct title, a fact list and a link to the DockRay panel. To check the sync back, move that page to a status from the Complete group by hand and wait up to five minutes - the error in DockRay should switch to resolved with no action on your part.
Common problems
The database list in project settings is empty
This almost always means no database has been shared with the integration, not that the workspace has none. Notion only shows an integration what someone has manually shared with it through Connections on the database page - the generated token alone grants access to nothing. Open the right database in Notion, add the integration to it, then refresh the list in DockRay.
The page stopped being created although the integration used to work
DockRay does not save the database's property names - it reads the schema live and looks for the first property of type title, people and status, so a plain rename in Notion breaks nothing on its own. What breaks it is deleting the property of a given type, or changing its type to something else - for instance, turning the only title property into plain text leaves the database with no field DockRay can write the page title into, and creating the page fails.
The page is created but without the closing link back to DockRay
Notion accepts at most one hundred blocks per request, and DockRay trims the content to that limit from the end of the list. With an error that has a very long stack trace and an extensive fact list, the closing paragraph with the link to the panel can fail to fit inside that limit. The page itself still gets created - only the last element is missing.
The status changes in Notion, but the error stays open in DockRay
Check the type of the status property in the database. The sync back reads the property groups of type status ('To do', 'In progress', 'Done') - only those let it work out what 'done' means. A select property is a fallback: it lets you set a status when the page is created, but has no groups, so the sync back has nothing to read from it and will never mark the error resolved. Fix: change the status property in the database to type status.
Creating a page fails with an access error
Check whether the database id in the project settings is still correct, and whether the integration's access to that database has been revoked in Notion - removing the integration from the Connections list looks, from DockRay's side, exactly like a database that was never shared.
Still not working
Work through the troubleshooting checklist, and if that does not help, write to us. Include the project name, the integration version and roughly when you ran the test: it shortens the way to an answer.