Automatisierungen in Apps

Verbinde eine Automatisierung einmal und verwende sie anschließend über einen Button, eine Anfragekarte, ein Formular oder eine eigene App-Oberfläche. Die Verbindung gehört zur App und ist unabhängig von der Darstellung ihrer Daten.

Eine Automatisierung verbinden

1. Füge der Automatisierung einen manuellen Auslöser hinzu und aktiviere sie im vorgesehenen Arbeitsbereich.
2. Öffne die App in Operations Studio und wähle Automatisierungen in der Editor-Werkzeugleiste.
3. Wähle Automatisierung verbinden, wähle den Workflow und benenne die App-Aktion verständlich.
4. Füge einen Aktionsbutton hinzu, wähle App-Automatisierung und anschließend die verbundene Aktion.
5. Ergänze bei Bedarf feste Eingaben. Der Editor unterstützt Text, Zahlen, Ja/Nein-Werte und strukturiertes JSON.

Verbinden und Konfigurieren starten keinen Workflow. Studio-Vorschauen lassen die Ausführung deaktiviert. Speichere und veröffentliche die App und teste sie anschließend als vorgesehener Benutzer mit vereinbarten Testdaten.

Beim Umbenennen bleibt die logische ID der App-Aktion erhalten. Beim Trennen bleiben die Automatisierung und bisherige Ausführungen gespeichert; ersetze Verweise in konfigurierten Buttons und eigenem Code vor der Veröffentlichung. Die Veröffentlichung prüft, dass verbundene Workflows aktiv sind, einen manuellen Auslöser besitzen und zum selben Arbeitsbereich gehören.

Ausführen und prüfen

Ein Button startet den Workflow und öffnet seinen Fortschritt. Abgeschlossen, laufend, Freigabe ausstehend, wartend, fehlgeschlagen und unklarer Ausgang haben unterschiedliche Status. Fortschritt aktualisieren lädt den aktuellen Ausführungsbeleg. Letzte Ausführungen öffnet deine eigenen Ausführungen dieser Aktion in der aktuellen veröffentlichten App-Version.

Geht eine Antwort verloren, findet Prüfen und erneut versuchen dieselbe beabsichtigte Ausführung wieder. Es entsteht keine neue Anfrage. Verwende Workflow fortsetzen nur, wenn die Ausführung diese Möglichkeit anbietet; Freigaben und die Wiederherstellung unklarer externer Ergebnisse bleiben Teil der bestehenden Workflow-Steuerung. Ein Workflow, der auf ein Ereignis oder einen Zeitpunkt wartet, läuft über seinen normalen Hintergrund-Worker weiter.

Die Ausführungshistorie ist auf den auslösenden Benutzer und die veröffentlichte App-Version begrenzt. Eine neue Veröffentlichung löscht keine gespeicherten Ausführungen, besitzt aber eine eigene Ausführungsliste. Aktuelle Berechtigungen und der Aktivierungszustand des Workflows bleiben maßgeblich.

Aktuelle Eingaben aus eigenen Oberflächen verwenden

Konnie kann eine Oberfläche bauen, die Werte aus einem Formular, einem ausgewählten Tabellendatensatz, einer Karte oder einer anderen Interaktion übergibt. Bitte Konnie, die echte Automatisierung zu ermitteln, eine benannte App-Aktion zu verbinden und diese über die vorgesehene Benutzerinteraktion auszulösen. Datenabfragen allein starten keine Workflows.

Derselbe Blueprint kann über App-Datenquellen Tabellendatensätze abfragen, erstellen, bearbeiten oder löschen und die verbundene Workflow-Aktion für den nächsten Schritt verwenden. Halte Tabellenänderungen und Workflow-Ausführungsbelege getrennt, damit die Oberfläche ein Teilergebnis wieder aufnehmen kann, ohne bereits abgeschlossene Arbeit zu wiederholen. Ein Beispiel zur Erstellung findest du unter Datensätze und Workflows verbinden.

Eigener Code verwendet die logische Aktions-ID über das kontrollierte SDK:

const pending = {
  invocationKey: ennea.automations.createInvocationKey(),
  input: { requestId: selectedRecord._id, priority: "urgent" },
};
const result = await ennea.automations.trigger("review_request", pending);
const run = result.data.run;

Behalte pending unverändert, solange der Ausgang der Anfrage unklar ist. Verwende es erneut für dieselbe Absicht und erzeuge erst für eine neue Anfrage einen neuen Schlüssel. Verhindere doppelte Eingaben während einer laufenden Anfrage. Prüfe einen erhaltenen Lauf mit readActionRun(actionId, runId) oder listActionRuns(actionId); löse nicht erneut aus, nur weil der Workflow noch läuft. resumeActionRun(actionId, runId) steht für geeignete Ausführungen bereit.

Eingaben sind begrenzte JSON-Objekte: bis zu 64 KiB, 1.000 Werte und 10 Verschachtelungsebenen. Übergib nur benötigte Werte. Workflow-Bedingungen und unterstützte dynamische Zuordnungen können payload.appInput.<Eingabename> lesen. Eingaben können weder Plattformidentität noch Geltungsbereich oder App-Berechtigungen überschreiben. Eingestellte formularspezifische Tabellenaktionen sind für neue Eingabeflüsse nicht verfügbar; verwende das App-Tabellen-SDK für gewöhnliche Datensatzvorgänge.

Verwende ausdrückliche Buttons (type="button") für SDK-Aktionen. Die App-Sandbox blockiert das native Absenden von Browserformularen. Bestätigte Automatisierungsänderungen aktualisieren benachbarte native Datenansichten; eigene Oberflächen können ihre Daten nach abgeschlossenem Lauf erneut abfragen.

Der aktuelle Benutzer benötigt die passenden App- und Automatisierungsberechtigungen. Die Ausführungsansicht liefert Fortschrittsdaten statt privater Workflow-Eingaben, Ausgaben oder zugrunde liegender Geschäftsdaten. Öffentliche Ereignisfeeds und der standardmäßige Ereigniskontext für KI-Anbieter enthalten keine App-Eingaben; ausdrücklich konfigurierte Workflow-Aktionen behalten ihre bestehenden Berechtigungen und Datenverarbeitungskontrollen.