Zum Inhalt springen

Notion-Sync

Verknüpfe eine Vorlage mit einer deiner Notion-Datenbanken, und jede Einsendung wird dort zu einer Zeile — angelegt, wenn das Formular abgesendet wird, aktualisiert, wenn sich das Dokument danach ändert.

1 · Deinen Workspace verbinden

Lege in Notion eine interne Verbindung an (unter notion.so/my-integrations; die Einstellungen in Pocper verlinken dorthin) und kopiere ihr internes API-Token. Füge es in Pocper unter Einstellungen → Integrationen → Notion ein. Das kann nur der Eigentümer des Teams, und das Token wird verschlüsselt gespeichert. Zum Wechseln nimm „Token ersetzen“ auf derselben Seite: Das neue Token wird geprüft, bevor es das alte ersetzt.

Teile dann die Datenbank, in die du schreiben willst, oder die Seite, in der sie liegt, mit dieser Verbindung: Öffne sie in Notion, wähle ••• → „Integrationen und Konnektoren“ → „Verbindungen hinzufügen“ (in manchen Versionen unter ••• → Mehr) und wähle deine Verbindung aus. Ohne diesen Schritt fehlt die Datenbank in der Liste von Pocper, und ein eingefügter Link zu ihr wird als nicht gefunden gemeldet.

2 · Eine Vorlage mit einer Datenbank verknüpfen

Öffne den Arbeitsbereich der Vorlage, wähle den Reiter Integration und drück „Notion-Datenbank verknüpfen“. Wähle eine Datenbank, die deine Verbindung sieht (tippe, um zu suchen), oder füge ihren Link ein. Die erste Zeile, „Neue Datenbank“, legt eine Datenbank in einer Seite deiner Wahl an, mit einer Spalte pro Feld, schon zugeordnet, und einer Spalte Pocper ID.

Jedes Feld bekommt ein Auswahlmenü mit den Spalten, deren Typ passt: ein Datumsfeld in eine Datumsspalte, eine Checkbox in eine Checkbox, Text in Text oder in den Titel. Unter „Angaben zur Einreichung“ kannst du auch den Kunden, den Zeitpunkt der Einreichung, den Status und den Einreicher zuordnen.

Jedes Dokument aus der Vorlage kopiert diese Einstellungen beim Anlegen, und sein eigener Reiter Integration kann sie allein für dieses Dokument ändern. Eine spätere Änderung an der Vorlage erreicht nur neue Dokumente; für ältere, die ihr noch folgen, bietet die Vorlage „Auch auf diese anwenden“ an. Ein Dokument, das vor der Verknüpfung der Vorlage entstand, bietet „Einstellungen der Vorlage übernehmen“ an.

3 · Was beim Absenden passiert

Wird ein Formular abgesendet — von der Person, die es ausfüllt, oder indem du es als eingereicht markierst —, entsteht innerhalb von Sekunden eine Zeile. Unter „Synchronisierung“ nennt der Reiter Integration des Dokuments dann den Zeitpunkt der letzten Synchronisierung, mit einem Link zur Zeile, oder dass eine Änderung wartet oder fehlschlug; „Jetzt synchronisieren“ erscheint nur, wenn das Senden fehlschlug oder das Dokument nie gesendet wurde. Soll die Zeile schon entstehen, sobald das Dokument existiert, ändere „Zeitpunkt der Synchronisierung“ in den Integrationseinstellungen der Vorlage.

Spätere Änderungen aktualisieren dieselbe Zeile wenige Sekunden nach der letzten Bearbeitung, und ein storniertes Dokument aktualisiert seine Statusspalte.

Die Seite der Zeile bekommt ein Lesezeichen zurück zum Dokument und die Antworten als Liste (sehr lange gekürzt, höchstens hundert). In den Integrationseinstellungen der Vorlage lässt sich der Seiteninhalt abschalten.

4 · Dateien, Unterschriften und Duplikate

Hochgeladene Dateien und Unterschriften können in eine Spalte Dateien & Medien gehen: Die Datei wird nach Notion kopiert, bis 20 MB (eine größere wird übersprungen und im Sync-Protokoll vermerkt). Sie als Links in eine URL-Spalte zu senden ist ein eigener Schalter, standardmäßig aus, weil jeder, der die Zeile sieht, so einen Link ohne Anmeldung bei Pocper öffnen könnte.

Der Duplikatschutz verhindert, dass eine erneut gesendete Einsendung doppelt auftaucht: Pocper schreibt die Pocper ID jedes Dokuments in eine Textspalte dieses Namens und findet die Zeile darüber. Eine Datenbank, die diese Spalte schon hat, nutzt sie; sonst legt der Verknüpfungsdialog sie an (das Kästchen ist vorab angehakt), oder die Einstellungen im Reiter Integration legen sie mit einem Klick an.

5 · Änderungen in Notion

Schalte im Reiter Integration die Rücksynchronisierung ein, und zwei Dinge kommen aus Notion zurück. Wird die Statusspalte auf Submitted, Cancelled oder Collected gesetzt, wechselt das Dokument in diesen Status; wird eine Zelle bearbeitet, die einem Text-, Checkbox-, Datums- oder Uhrzeitfeld zugeordnet ist, wird der Wert ins Dokument geschrieben, und seine Historie zeigt die Änderung als aus Notion kommend. Haben beide Seiten eine Zelle geändert, gilt der Wert aus Notion — außer solange ein Kunde das Formular noch ausfüllt (nicht eingereicht und in den letzten zehn Minuten gespeichert): Dann bleibt sein Wert, die Zelle in Notion wird zurückgesetzt, und der Reiter Integration vermerkt das.

Die Rücksynchronisierung braucht einen Webhook, den der Eigentümer einmal pro Team unter Einstellungen → Integrationen → Notion einrichtet: Webhook-URL erzeugen, sie im Webhooks-Tab deiner Verbindung in Notion als Abonnement hinzufügen und das von Notion gesendete Verifizierungs-Token zurück einfügen. Pocper fragt Notion nie von sich aus ab, ohne Webhook bleiben Änderungen in Notion also dort. Eine Spalte, die keinen Wert zurücknehmen kann — eine Unterschrift, eine Datei, jedes Feld eines gesperrten Dokuments —, wird in Notion wiederhergestellt, und der Reiter Integration vermerkt das.

6 · Wenn etwas schiefgeht

Eine Zeile, die nicht gesendet werden konnte, wird einen Tag lang erneut versucht, mit wachsenden Abständen. Sind die Versuche aufgebraucht oder lehnt Notion sie rundweg ab — Token widerrufen, Datenbank nicht mehr geteilt —, stoppt die Synchronisierung, und der Eigentümer des Teams und wer die Datenbank verknüpft hat bekommen eine Benachrichtigung in der App, die den Reiter Integration des Dokuments öffnet. Der Fehler dort sagt, was zu tun ist; die Meldung von Notion selbst steht unter „Meldung von Notion anzeigen“.

Eine angehaltene Synchronisierung läuft von selbst wieder an, sobald die Ursache behoben ist: wenn du in den Einstellungen neu verbindest oder das Token ersetzt, wenn Pocper die Datenbank wieder liest („Spalten aus Notion neu laden“ neben der Überschrift „Felder“ oder jede im Reiter Integration gespeicherte Änderung) oder wenn das Dokument bearbeitet wird. In der Vorlage zählt die Zeile „Synchronisierungsprotokoll“ die Fehlschläge und kann nur diese zeigen, und eine Zeile wie „3 Dokumente sind noch nicht in Notion“ hat einen Knopf „Senden“, der sie alle sendet — und vorher die Spalte Pocper ID anlegt, falls sie fehlt; aufgeklappt zeigt sie, welche und warum. „Synchronisierung pausieren“ neben der Überschrift „Synchronisierung“ hält das Senden von Änderungen an, bis du „Synchronisierung fortsetzen“ drückst.