formbasedocs
Zur AppApp

Anleitungen · n8n (selbst gehostet)

Einen n8n-Workflow aus Freigabelink-Einreichungen starten

Diese Anleitung baut einen zweistufigen Workflow: Eine neue Einreichung zu einem Formular für die Lieferantenaufnahme kommt in einem formbase Trigger an, und ein Edit-Fields-Node pickt die Antworten heraus. Setz deinen E-Mail-, Sheets-, Slack- oder CRM-Node danach ein.

Last checked

Du brauchst eine formbase-Credential in n8n und ein veröffentlichtes Formular mit einem Freigabelink. Dein n8n muss aus dem Internet über HTTPS erreichbar sein; siehe Den formbase-Node in n8n installieren. Eine Einreichung über einen Request-Link startet diese Workflows nicht; siehe Auf das Ergebnis eines Requests in n8n reagieren dafür.

1. Den Trigger hinzufügen

Erstelle einen Workflow, klicke auf +, such nach formbase und wähle formbase Trigger. Wähle die Credential, das Formular, und eines der drei Freigabelink-Events unter Event:

Das geöffnete Event-Dropdown des formbase Trigger: Public Link Submission Created, Updated und Abandoned, dann Request Completed, Expired und Canceled, jeweils mit kurzer Beschreibung
EventFeuert wennBraucht
Public Link Submission CreatedEine befragte Person sendet das Formular über einen Freigabelink ab.Nichts Zusätzliches.
Public Link Submission UpdatedEine befragte Person bearbeitet eine Einreichung, die sie schon gesendet hat.Nach dem Absenden bearbeiten für das Formular aktiviert.
Public Link Submission AbandonedEine befragte Person lässt das Formular für die Zeit unter Consider Abandoned After unfertig liegen (12 Stunden bis 1 Woche). formbase prüft einmal pro Stunde, der Lauf kann also bis zu eine Stunde später kommen.Ein Pro- oder Business-Plan, der teilweise Einsendungen speichert.

2. Auf ein Test-Event hören

Klicke auf Execute step. Der Node zeigt Listening for test event, und formbase sendet die Events dieses Formulars zwei Minuten lang an die Test-URL des Nodes. Öffne den Freigabelink des Formulars in einem anderen Tab und sende es innerhalb dieser Zeit ab. Die Einreichung kommt innerhalb von Sekunden im Node an:

Der formbase Trigger nach einem Test-Event: Form [Guide] Supplier onboarding, Event Public Link Submission Created, und die Ausgabe mit id, type submission.completed, test false und data › answers mit company_name Nordlys Tekstil AS, contact_email, vat_number, der Zahlungsbedingungs-Antwort yes, und der hochgeladenen Zertifikatsdatei

n8n hat keinen Beispieldatensatz: Der Test ist eine echte Einreichung, und test ist false. Jede Antwort erscheint zweimal:

  • data.answers trägt den Wert, den ein Workflow vergleicht, unter dem Feldschlüssel der Frage: einen Optionsschlüssel wie yes, eine Zahl, ein Datum, oder eine Liste von Dateien.

  • data.display trägt den Text, den ein Mensch liest, wie Yes.

Nutze display in Nachrichten und answers in Bedingungen. Beides steht in der Webhooks-Referenz.

Abgebrochene Einreichungen kommen erst Stunden später an, Execute step kann also keine abfangen. Veröffentliche für dieses Event den Workflow und schau in Executions nach.

3. Die Antworten herauspicken

Füg nach dem Trigger einen Edit Fields (Set)-Node hinzu. Zieh Antworten aus dem Input-Panel in Fields to Set, oder tipp die Ausdrücke selbst:

Ein Edit-Fields-Node mit drei Feldern: company aus $json.data.answers.company_name, email aus $json.data.answers.contact_email, und payment_terms aus $json.data.display.do_you_accept_our_30_day_payment_terms, mit der Ausgabe Nordlys Tekstil AS, grace@nordlys.example und Yes
payment_terms liest aus display, trägt also das Label Yes statt des Optionsschlüssels yes.

Der nächste Node, etwa Gmail oder Google Sheets, liest {{ $json.company }} und die anderen Felder von hier. Wird eine Frage umbenannt, bleibt ihr Feldschlüssel gleich, diese Ausdrücke funktionieren also weiter.

4. Veröffentlichen und einen echten Lauf prüfen

Klicke auf Publish, gib der Version einen Namen, und bestätige. formbase sendet jetzt jede neue Einreichung an die Produktions-URL des Workflows. Das Veröffentlichen rückgängig zu machen, stoppt das.

Sende das Formular noch einmal ab und öffne den Tab Executions. Der Lauf erscheint innerhalb von Sekunden. Läufe, die du mit Execute step gestartet hast, tragen ein Flaschen-Symbol; ein Produktionslauf keines:

Der Tab Executions des veröffentlichten Workflows: der neueste Lauf Succeeded in 51ms ohne Flaschen-Symbol, drei frühere Testläufe mit Flaschen-Symbol, und die Canvas zeigt formbase Trigger, das 1 Item an Edit Fields übergibt

Wenn der Workflow nicht startet

  • Das Formular wurde über einen Request-Link abgesendet. Das löst Request Completed aus, nicht Public Link Submission Created.

  • Der Workflow ist nicht veröffentlicht. Nur Execute step hört, während der Workflow ein Entwurf ist, und nur bis das erste Event ankommt oder zwei Minuten vergehen.

  • Der Trigger zeigt targetUrl must use https.

    Dein n8n gibt eine http://- oder private URL heraus. Siehe n8n seine öffentliche Adresse mitteilen.

  • Die Credential erreicht einen anderen Workspace. Der Trigger hört auf das Formular im Workspace, auf den seine Credential zeigt.

Die Signatur prüfen

Der formbase Trigger prüft den X-formbase-Signature-Header jedes Events und weist jedes zurück, das die Prüfung nicht besteht. Halte die Uhr des n8n-Hosts genau: Ein Event, das vor mehr als fünf Minuten signiert wurde, wird ebenfalls zurückgewiesen.

Als Nächstes

Einen Request aus einem n8n-Workflow sendenNative IntegrationenSlack, Sheets und Notion ohne n8n.