Localmind Automate Form-Knoten#

Verwenden Sie den Localmind Automate Form-Knoten, um benutzerorientierte Formulare mit mehreren Schritten zu erstellen. Sie können andere Knoten mit benutzerdefinierter Logik hinzufügen, um Benutzereingaben zu verarbeiten. Sie müssen den Workflow mit dem Localmind Automate Form-Trigger starten.

View workflow file

Einrichten des Knotens#

Standardauswahlen mit Abfrageparametern festlegen#

Sie können die Anfangswerte für Felder festlegen, indem Sie Abfrageparameter mit der anfänglichen URL verwenden, die vom Localmind Automate Form-Trigger bereitgestellt wird. Jede Seite im Formular empfängt die gleichen Abfrageparameter, die an die Localmind Automate Form-Trigger-URL gesendet werden.

Nur für die Produktion

Abfrageparameter sind nur verfügbar, wenn das Formular im Produktionsmodus verwendet wird. Localmind Automate füllt im Testmodus keine Feldwerte aus Abfrageparametern.

Bei Verwendung von Abfrageparametern sollten Sie alle Feldnamen oder -werte, die Sonderzeichen verwenden, prozentual kodieren. Dies stellt sicher, dass Localmind Automate die Anfangswerte für die angegebenen Felder verwendet. Sie können Tools wie URL Encode/Decode verwenden, um Ihre Abfrageparameter mithilfe von Prozentkodierung zu formatieren.

Nehmen wir als Beispiel an, Sie haben ein Formular mit den folgenden Eigenschaften:

Produktions-URL: https://my-account.lma.cloud/form/my-form
Felder:
- name: Jane Doe
- email: jane.doe@example.com

Mit Abfrageparametern und Prozentkodierung könnten Sie die folgende URL verwenden, um die anfänglichen Feldwerte auf die obigen Daten zu setzen:

https://my-account.lma.cloud/form/my-form?email=jane.doe%40example.com&name=Jane%20Doe

Hier ersetzt die Prozentkodierung das At-Symbol (@) durch die Zeichenfolge %40 und das Leerzeichen () durch die Zeichenfolge %20. Dadurch wird der Anfangswert für diese Felder festgelegt, unabhängig davon, auf welcher Seite des Formulars sie erscheinen.

Definieren des Formulars mit JSON#

Verwenden Sie Formular definieren > Mit JSON, um die Felder Ihres Formulars mit einem JSON-Array von Objekten zu definieren. Jedes Objekt definiert ein einzelnes Feld mithilfe einer Kombination dieser Schlüssel:

fieldLabel: Die Beschriftung, die über dem Eingabefeld erscheint.
fieldType: Wählen Sie zwischen date, dropdown, email, file, number, password, text oder textarea.
- Verwenden Sie date, um eine Datumsauswahl in das Formular einzufügen. Weitere Informationen zur Formatierung von Datumsangaben finden Sie unter Datum und Uhrzeit mit Luxon.
- Bei Verwendung von dropdown legen Sie die Auswahlmöglichkeiten mit fieldOptions fest (siehe Beispiel unten). Standardmäßig ist die Dropdown-Liste eine einfache Auswahl. Um sie zu einer Mehrfachauswahl zu machen, setzen Sie multiselect auf true.
- Bei Verwendung von file setzen Sie multipleFiles auf true, damit Benutzer mehr als eine Datei auswählen können. Um die zulässigen Dateitypen zu definieren, setzen Sie acceptFileTypes auf eine Zeichenfolge mit einer kommagetrennten Liste von Dateierweiterungen (siehe Beispiel unten).
placeholder: Geben Sie Platzhalterdaten für das Feld an. Sie können dies für jeden fieldType außer dropdown, date und file verwenden.
requiredField: Fordern Sie Benutzer auf, dieses Feld im Formular auszufüllen.

Ein JSON-Beispiel, das das erforderliche allgemeine Format und die verfügbaren Schlüssel zeigt:

// Verwenden Sie den Schlüssel "requiredField" für jedes Feld, um es als obligatorisch zu kennzeichnen
// Verwenden Sie den Schlüssel "placeholder", um Platzhalterdaten für alle Felder anzugeben
//     außer 'dropdown', 'date' und 'file'

[
	{
		"fieldLabel": "Date Field",
		"fieldType": "date",
		"formatDate": "mm/dd/yyyy", // So formatieren Sie das empfangene Datum in lma
		"requiredField": true
	},
	{
		"fieldLabel": "Dropdown Options",
		"fieldType": "dropdown",
		"fieldOptions": {
			"values": [
				{
					"option": "option 1"
				},
				{
					"option": "option 2"
				}
			]
		},
		"requiredField": true
	},
	{
		"fieldLabel": "Multiselect",
		"fieldType": "dropdown",
		"fieldOptions": {
			"values": [
				{
					"option": "option 1"
				},
				{
					"option": "option 2"
				}
			]
		},
		"multiselect": true // Das Setzen auf true ermöglicht die Mehrfachauswahl
	},
	{
		"fieldLabel": "Email",
		"fieldType": "email",
		"placeholder": "me@mail.con"
	},
	{
		"fieldLabel": "File",
		"fieldType": "file",
		"multipleFiles": true, // Das Setzen auf true ermöglicht die Auswahl mehrerer Dateien
		"acceptFileTypes": ".jpg, .png" // Zulässige Dateitypen
	},
	{
		"fieldLabel": "Number",
		"fieldType": "number"
	},
	{
		"fieldLabel": "Password",
		"fieldType": "password"
	},
	{
		// "fieldType": "text" kann weggelassen werden, da es sich um den Standardtyp handelt
		"fieldLabel": "Text"
	},
	{
		"fieldLabel": "Textarea",
		"fieldType": "textarea"
	}
]

Formularende#

Verwenden Sie den Seitentyp Formularende, um ein Formular zu beenden und entweder eine Abschlussseite anzuzeigen oder den Benutzer zu einer URL weiterzuleiten. Pro Ausführung wird nur eine Formularendeseite angezeigt, selbst wenn Localmind Automate mehrere Zweige ausführt, die Formularende-Knoten enthalten.

Wählen Sie zwischen diesen Optionen, wenn Sie Bei Localmind Automate Formularübermittlung verwenden:

Abschlussbildschirm anzeigen: Zeigt Benutzern einen abschließenden Bildschirm, um zu bestätigen, dass sie das Formular übermittelt haben.
- Füllen Sie Abschlusstitel aus, um den h1-Titel auf dem Formular festzulegen.
- Localmind Automate zeigt die Abschlussmeldung als Untertitel unter dem Haupt-h1-Titel auf dem Formular an. Verwenden Sie \n oder <br>, um einen Zeilenumbruch hinzuzufügen.
- Wählen Sie Option hinzufügen und füllen Sie Abschlussseitentitel aus, um den Titel der Seite in der Browser-Registerkarte festzulegen.

Wenn Sie Weiterleitung zu URL verwenden, füllen Sie das Feld URL mit der Seite aus, zu der Sie weiterleiten möchten, wenn Benutzer das Formular ausfüllen.

Formulare mit Verzweigungen#

Der Localmind Automate Form-Knoten führt seine zugehörige Formularseite aus und zeigt sie an, wenn er Daten von einem vorherigen Knoten empfängt. Beim Erstellen von Formularen mit Localmind Automate ist es wichtig, das Verhalten von Formularen zu verstehen, wenn Verzweigungen auftreten, um Verwirrung zu vermeiden.

Workflows mit sich gegenseitig ausschließenden Zweigen#

Formular-Workflows, die sich gegenseitig ausschließende Zweige enthalten, funktionieren wie erwartet. Localmind Automate führt einen einzelnen Zweig gemäß den übermittelten Daten und den von Ihnen umrissenen Bedingungen aus. Bei der Ausführung zeigt Localmind Automate jede Seite im Zweig an, die mit einem Localmind Automate Form-Knoten mit dem Seitentyp Formularende endet.

Dieser Workflow demonstriert sich gegenseitig ausschließende Verzweigungen. Jede Auswahl kann nur einen einzelnen Zweig ausführen.

View workflow file

Workflows, die möglicherweise mehrere Zweige ausführen#

Formular-Workflows, die Daten gleichzeitig an mehrere Zweige senden, erfordern mehr Sorgfalt. Wenn mehrere Zweige während einer Ausführung Daten empfangen (z. B. von einem Switch-Knoten), führt Localmind Automate jeden Zweig, der Daten empfängt, sequenziell aus. Nach Erreichen des Endes eines Zweigs wechselt die Ausführung zum nächsten Zweig mit Daten.

Localmind Automate führt nur einen einzigen Formularende Localmind Automate Form-Knoten für jede Ausführung aus. Wenn mehrere Zweige eines Formular-Workflows Daten empfangen, ignoriert Localmind Automate alle Formularende-Knoten mit Ausnahme desjenigen, der dem letzten Zweig zugeordnet ist.

Dieser Workflow kann während einer Ausführung mehr als einen Zweig ausführen. Hier führt Localmind Automate alle gültigen Zweige sequenziell aus. Dies wirkt sich darauf aus, welche Localmind Automate Form-Knoten Localmind Automate ausführt (insbesondere welcher Formularende-Knoten angezeigt wird):

View workflow file

Knotenoptionen#

Wählen Sie Option hinzufügen, um weitere Konfigurationsoptionen anzuzeigen:

Formulartitel: Der Titel für Ihr Formular. Localmind Automate zeigt den Formulartitel als Webseitentitel und Haupt-h1-Titel auf dem Formular an.
Formularbeschreibung: Die Beschreibung für Ihr Formular. Localmind Automate zeigt die Formularbeschreibung als Untertitel unter dem Haupt-h1-Titel auf dem Formular an. Verwenden Sie \n oder <br>, um einen Zeilenumbruch hinzuzufügen.
Schaltflächenbeschriftung: Die Beschriftung, die für die Submit-Schaltfläche Ihres Formulars verwendet werden soll. Localmind Automate zeigt die Schaltflächenbeschriftung als Namen der Submit-Schaltfläche an.

Ausführen des Knotens#

Erstellen und Testen von Workflows#

Verwenden Sie beim Erstellen oder Testen eines Workflows die Test-URL im Localmind Automate Form-Trigger. Die Verwendung einer Test-URL stellt sicher, dass Sie die eingehenden Daten in der Editor-Benutzeroberfläche anzeigen können, was für das Debuggen nützlich ist.

Es gibt zwei Möglichkeiten zum Testen:

Wählen Sie Testschritt. Localmind Automate öffnet das Formular. Wenn Sie das Formular absenden, führt Localmind Automate den Knoten und alle vorherigen Knoten aus, aber nicht den Rest des Workflows.
Wählen Sie Workflow testen. Localmind Automate öffnet das Formular. Wenn Sie das Formular absenden, führt Localmind Automate den Workflow aus.

Produktions-Workflows#

Wenn Ihr Workflow fertig ist, wechseln Sie zur Verwendung der Produktions-URL des Localmind Automate Form-Triggers, indem Sie den Trigger-Knoten öffnen und die Produktions-URL in der Von URLs-Auswahl auswählen. Sie können dann Ihren Workflow aktivieren, und Localmind Automate führt ihn automatisch aus, wenn ein Benutzer das Formular absendet.

Stellen Sie bei der Arbeit mit einer Produktions-URL sicher, dass Sie den Workflow gespeichert und aktiviert haben. Daten, die durch den Formular-Trigger fließen, sind in der Editor-Benutzeroberfläche mit der Produktions-URL nicht sichtbar.