--- kind: screen project: HiveGrid Screen Project ticket: D-FORM package: WF-D-FORM Form Builder id: D08 screen: Action Detail mit Mapping typ: Panel-Zustand in S01 umsetzung: Bauen status: Subframe Draft / Review offen route: in S01 Actions-Modus, kein eigener Screen subframe: "https://app.subframe.com/f023064a5ca0/design/0759d779-91f5-4e06-b1d6-7cd0095461ea/edit" --- # D08 - Action Detail mit Mapping ## Ziel Interne Nutzer konfigurieren eine einzelne Post-Submit-Action und sehen sofort, ob Pflichtmapping oder Zielwerte fehlen. ## Pattern / Archetyp Detailpanel / Drawer innerhalb des Actions-Modus von S01. ## Daten - Action-Typ - Action-Name - Status aktiv/inaktiv - Ziel, z. B. Empfaenger, Pipeline, Projektstatus, Webhook-URL - Field-Mapping: Formularfeld -> Ziel-Feld - Pflichtfelder - optionale Bedingungen - Teststatus ## Aktionen - Action benennen - Ziel konfigurieren - Mapping-Zeilen setzen - optionale Bedingung setzen - Test ausfuehren - Action speichern - Action deaktivieren - Action loeschen ## Verhalten - Nach Auswahl eines Action-Typs oeffnet sich dieses Detailpanel. - Mapping wird inline als Zeilenliste bearbeitet. - Pflichtmapping wird klar markiert. - Test zeigt ein Ergebnis im Panel, kein eigener Screen. - Loeschen einer aktiven oder published-relevanten Action nutzt Confirm. - Detailfaelle fuer halb gesetztes Mapping, Typwechsel und fehlende Pflichtziele stehen in [[D10 Builder Interaktionsfaelle]]. ## Action-Typen | Typ | Wichtigste Konfiguration | |---|---| | Email Submitter | Submitter-Email-Feld, Betreff, Nachricht. | | Email Team | Empfaenger, Betreff, Feldauswahl. | | Lead | Mapping fuer Name, Email, Telefon, Nachricht, Quelle. | | Kontakt | Kontakt-Mapping und Duplikat-/Auto-Match-Hinweis. | | Projekt | Pipeline, Status, Verantwortlicher, Pflichtmapping. | | Task | Titel, Beschreibung, Faelligkeit, Assignee. | | Auto-Match | Match-Felder, Fallback. | | Webhook | URL, Test, Payload-Vorschau. | | Automation-Trigger | Automation-Auswahl und Trigger-Hinweis. | ## Zustaende | Zustand | Beschreibung | Umsetzung | |---|---|---| | Neu | Action-Typ gewaehlt, Detail noch leer. | Nur dokumentieren | | Vollstaendig | Pflichtfelder und Mapping gesetzt. | Nur dokumentieren | | Pflichtmapping fehlt | Publish oder Action-Test blockiert. | Nur dokumentieren | | Test erfolgreich | Inline-Ergebnis plus Toast. | Wiederverwenden | | Test fehlgeschlagen | Inline-Fehler im Panel. | Nur dokumentieren | ## Auswahlfolge im Panel | Schritt | Verhalten | |---|---| | 1. Action-Typ | Bestimmt, welche Pflichtfelder und Mapping-Zeilen erscheinen. | | 2. Ziel | Empfaenger, Pipeline, Webhook-URL, Automation oder Entity-Ziel wird gesetzt. | | 3. Mapping | Formularfelder werden Ziel-Feldern zugeordnet. | | 4. Optional Bedingung | Nur einfache Bedingung; kein zweiter Logic-Builder. | | 5. Test | Erst aktiv, wenn Pflichtziel und Pflichtmapping vollstaendig sind. | | 6. Aktiv | Aktive unvollstaendige Actions blockieren Publish; inaktive unvollstaendige Actions nicht. | ## Was-passiert-wenn-Faelle | Fall | UI-Reaktion | Folge | |---|---|---| | Action-Typ gewaehlt, Pflichtziel vergessen | Inline-Fehler im Zielbereich. | Test disabled; aktive Action blockiert Publish. | | Mapping-Ziel gesetzt, Quelle vergessen | Mapping-Zeile markiert fehlende Quelle. | Test disabled; aktive Action blockiert Publish. | | Email Submitter ohne Email-Feld | Hinweis mit CTD `Email-Feld hinzufuegen`. | Action bleibt unvollstaendig. | | Projekt erstellen ohne Pipeline | Pipeline-Auswahl markiert. | Publish blockiert aktive Action. | | Webhook-URL ungueltig | URL-Feld zeigt Fehler. | Test disabled. | | Action-Typ nach Mapping wechseln | Confirm/Popover erklaert, dass Mapping ungueltig werden kann. | Nutzer bestaetigt oder bricht ab. | ## Subframe - [Subframe](https://app.subframe.com/f023064a5ca0/design/0759d779-91f5-4e06-b1d6-7cd0095461ea/edit) Gebaut als zusaetzlicher Builder-Zustand. Das Detail bleibt fachlich ein Zustand im Actions-Modus von S01, ist aber als eigener Frame sichtbar, weil Mapping und Pflichtfelder fuer den Builder sehr fehleranfaellig sind. Layout-Regel: D08 nutzt das vorhandene Subframe `Default Page Layout`. Keine eigene Sidebar oder Header-Navigation nachbauen. ## Notizen ActionLog, Re-Run und Fehlerhistorie pro Submission bleiben ausserhalb von D-FORM.