Virtuelle Entitäten

Jeder Workflow läuft auf einem Datensatztyp. Üblicherweise ist das ein echter, gespeicherter Typ: Lead, Deal, Rechnung, ein eigener Datensatz. Eine virtuelle Entität ist ein spezieller Datensatztyp (angezeigt als virtual) für Workflows, die auf Daten reagieren, die von außen eintreffen, wenn es noch nichts Gespeichertes gibt, worauf sie laufen könnten.

Wenn eine Anfrage einen dynamischen Endpunkt erreicht, verpackt Flexie diese Anfrage als virtuelle Entität und führt den Workflow darauf aus. Die Schritte des Workflows lesen dann den Inhalt der Anfrage und verrichten echte Arbeit: Sie schlagen gespeicherte Datensätze nach und aktualisieren sie, versenden Nachrichten, rufen andere Systeme auf und antworten dem Aufrufer.

Stellen Sie es sich als einen kurzlebigen Datensatz aus den eingehenden Daten vor, der genau so lange existiert, wie der Workflow zur Verarbeitung braucht.

Was eine virtuelle Entität speist

Eine virtuelle Entität kann aus verschiedenen Arten eingehender Daten entstehen, nicht nur aus Webanfragen. Die Quellen, die Flexie unterstützt:

• Eine Webanfrage an einen dynamischen Endpunkt (der Hauptfall, im Fokus dieses Abschnitts)
• Eine eingehende E-Mail
• Eine eingehende SMS
• Eine eingehende WhatsApp-Nachricht
• Ein Formular-Versand
• Ein zeitgesteuerter Trigger
• Ein Ereignis beim Löschen eines Datensatzes

In jedem Fall gilt dasselbe Prinzip: Es treffen Daten ein, sie werden zu einer virtuellen Entität, und ein Workflow verarbeitet sie.

Die eine Regel, die Sie sich merken sollten

Ein Workflow, dessen Datensatztyp virtual ist, kann nur die Quellen Listener oder Scheduled verwenden. Das ergibt Sinn: Eine virtuelle Entität entsteht deshalb, weil ein Signal eingetroffen ist (Listener) oder eine Uhr ausgelöst hat (Scheduled). Es gibt keinen gespeicherten Datensatz, der „bei Erstellung oder Aktualisierung“ auslösen könnte.

Der Builder erzwingt das. Wenn Sie den virtuellen Datensatztyp wählen, werden Ihnen nur diese beiden Quellen angeboten.

Wie die Daten erreicht werden

Sobald der Workflow auf einer virtuellen Entität läuft, stehen die eingehenden Daten Ihren Schritten über Flexie Scripting-Tokens zur Verfügung. Bei einer Webanfrage:

• Die Felder des Body sind als {{ __data.field_name }} verfügbar.
• Die Anfrage-Header liegen unter {{ __data.__headers.* }}.
• Alles, was frühere Schritte gespeichert haben, liegt unter {{ __data.* }}.

Die Details, wie unterschiedliche Body-Formate gelesen werden und wo genau jedes Stück landet, finden Sie auf der Seite Daten empfangen.

Einen Workflow mit virtueller Entität erstellen

1. Öffnen Sie den Bereich Workflows und wählen Sie New.
2. Wählen Sie als Datensatztyp den virtuellen Typ.
3. Wählen Sie als Quelle Listener (für einen Endpunkt oder eine eingehende Nachricht) oder Scheduled.
4. Fügen Sie den Endpunkt-Listener hinzu (für Webanfragen), siehe Einen Endpunkt erstellen, und bauen Sie Ihre Schritte.

Nächste Schritte

• Einen Endpunkt erstellen: die URL und ihre Sicherheit.
• Daten empfangen: die Anfrage in nutzbare Werte verwandeln.