Pruebas y resolución de problemas - Notion
Probar la integración
Toma un error de baja importancia de un proyecto de pruebas y crea a partir de él una página de Notion. Comprueba en Notion que la página ha llegado a la base de datos correcta, con un título correcto, una lista de datos y un enlace al panel de DockRay. Para comprobar la sincronización de vuelta, mueve esa página a mano a un estado del grupo Complete y espera hasta cinco minutos - el error en DockRay debería pasar a resuelto sin ninguna acción por tu parte.
Problemas habituales
La lista de bases de datos en los ajustes del proyecto está vacía
Esto casi siempre significa que no se ha compartido ninguna base de datos con la integración, no que el workspace no tenga ninguna. Notion solo muestra a una integración lo que alguien le ha compartido a mano mediante Connections en la página de la base de datos - el token generado por sí solo no da acceso a nada. Abre la base de datos correcta en Notion, añádele la integración y luego actualiza la lista en DockRay.
La página ha dejado de crearse aunque la integración funcionaba antes
DockRay no guarda los nombres de las propiedades de la base de datos - lee el esquema en vivo y busca la primera propiedad de tipo título, persona y estado, así que un simple cambio de nombre en Notion no rompe nada por sí mismo. Lo que rompe es borrar la propiedad de ese tipo o cambiar su tipo por otro - por ejemplo, convertir la única propiedad de título en texto plano deja la base de datos sin un campo donde DockRay pueda escribir el título de la página, y la creación de la página falla.
La página se crea, pero sin el enlace final de vuelta a DockRay
Notion acepta como máximo cien bloques por petición, y DockRay recorta el contenido a ese límite desde el final de la lista. Con un error de pila de llamadas muy larga y una lista de datos extensa, el párrafo final con el enlace al panel puede no caber dentro de ese límite. La página en sí se crea igualmente - solo falta el último elemento.
El estado cambia en Notion, pero el error sigue abierto en DockRay
Comprueba el tipo de la propiedad de estado en la base de datos. La sincronización de vuelta lee los grupos de propiedades de tipo status ('Por hacer', 'En curso', 'Hecho') - solo con ellos se puede deducir qué significa 'terminado'. Una propiedad de tipo select es un plan de emergencia: permite fijar un estado al crear la página, pero no tiene grupos, así que la sincronización de vuelta no tiene de dónde leer y nunca marcará el error como resuelto. Solución: cambia la propiedad de estado de la base de datos al tipo status.
Crear una página termina en un error de acceso
Comprueba si el identificador de la base de datos en los ajustes del proyecto sigue siendo correcto y si se ha revocado en Notion el acceso de la integración a esa base de datos - quitar la integración de la lista de Connections se ve, desde el lado de DockRay, exactamente igual que una base de datos que nunca se compartió.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.