Konfigurationsanleitung
Zielgruppe: Backend-Administratoren
Dieses Dokument beschreibt die Einrichtung des Add-Ons Artikelmapping: Lokaler Bestellworkflow je Benutzergruppe im Backend. Es richtet sich an Mitarbeiter, die Add-Ons für Mandanten aktivieren und Artikel pflegen.
Voraussetzungen
Das Add-On Artikelmapping: Lokaler Bestellworkflow je Benutzergruppe muss dem Mandanten in der Modulverwaltung zugewiesen sein.
Lokale Bestellworkflows müssen im Mandanten existieren (über Lokaler Bestellworkflow → Workflows verwalten).
Den Shops, denen der Artikel zugewiesen ist, müssen Benutzergruppen mit den gewünschten Endkunden hinterlegt sein.
Wenn pro Benutzergruppe mehrere Workflows hinterlegt werden sollen, muss zusätzlich das Add-On Lokaler Bestellworkflow Mehrfachauswahl aktiv sein.
Schritt 1: Add-On aktivieren
Im Backend unter Administrator → Alle Add-Ons das Add-On Artikelmapping: Lokaler Bestellworkflow je Benutzergruppe für den Mandanten aktivieren. Das Add-On hat keine eigene Konfigurationsseite — nach der Aktivierung erscheint die Mapping-Tabelle automatisch in der Artikelverwaltung.
Hinweis: Eine Aktivierung wirkt mandantenweit. Pro Artikel wird die Mapping-Tabelle erst sichtbar, wenn der Artikel mindestens einem Shop zugewiesen ist und in einem dieser Shops Benutzergruppen existieren.
Schritt 2: Artikel öffnen und „Freigabe"-Tab aufrufen
Im Backend unter Artikel → Bearbeiten → Tab „Freigabe" wechseln. Direkt unterhalb des Felds „Lokaler Bestellworkflow" (Standard-Workflow am Artikel) erscheint die Mapping-Tabelle — ohne eigene Überschrift, sie schließt nahtlos an den Workflow-Block an. Die Tabelle hat zwei Spalten plus eine Plus-Schaltfläche zum Hinzufügen neuer Zeilen:
Spalte | Inhalt |
|---|---|
Benutzergruppe | Dropdown mit allen Benutzergruppen aus den dem Artikel zugewiesenen Shops, gruppiert nach Shop, durchsuchbar. |
Lokaler Bestellworkflow | Dropdown mit allen aktiven lokalen Bestellworkflows aus den dem Artikel zugewiesenen Shops, gruppiert nach Shop. Bei aktivem Add-On Lokaler Bestellworkflow Mehrfachauswahl ist Mehrfachauswahl mit Anzeige „X Optionen ausgewählt" möglich. |
Pro Zeile lässt sich am Ende ein „−"-Symbol anklicken, um die Zeile wieder zu entfernen.
Schritt 3: Mapping-Zeile hinzufügen
Auf das „+"-Symbol in der Tabellenüberschrift klicken — eine leere Zeile wird angefügt.
Benutzergruppe auswählen. Bereits in anderen Zeilen verwendete Benutzergruppen sind im Dropdown gesperrt, damit es keine Doppelung gibt.
Lokalen Bestellworkflow auswählen.
Single-Modus: genau ein Workflow.
Mehrfach-Modus (mit Mehrfachauswahl-Add-On): beliebig viele Workflows. Der erste ausgewählte Eintrag wird automatisch als Standard für die Endkunden-Vorbelegung im Warenkorb verwendet.
Schritt 4: Speichern
Mit dem Speichern des Artikels wird die Mapping-Konfiguration komplett mit dem Artikel zusammen gespeichert. Inaktive oder gelöschte Workflows werden beim Speichern automatisch verworfen, ebenso Mapping-Einträge auf Benutzergruppen, die nicht (mehr) zu einem dem Artikel zugewiesenen Shop gehören. Die Tabelle zeigt nach dem Reload den bereinigten Stand.
Zusammenspiel mit anderen Add-Ons und Einstellungen
Konstellation | Verhalten |
|---|---|
Add-On aktiv, Mehrfachauswahl-Add-On inaktiv | Pro Benutzergruppe genau ein Workflow. Im Warenkorb wird kein Auswahl-Dropdown angezeigt; der Workflow ist gesetzt. |
Add-On aktiv, Mehrfachauswahl-Add-On aktiv | Pro Benutzergruppe können mehrere Workflows ausgewählt werden. Der Endkunde sieht im Warenkorb ein Dropdown mit den für seine Benutzergruppe gemappten Workflows; ohne Mapping sieht er die am Artikel hinterlegten Workflows. |
Standard-Workflow am Artikel auf „Deaktiviert" | Für Benutzergruppen mit Mapping greift trotzdem der gemappte Workflow. Für Benutzergruppen ohne Mapping läuft die Bestellung ohne lokalen Bestellworkflow (Standard-Verhalten ohne dieses Add-On). |
Endkunde, dessen Benutzergruppe nicht im Mapping eingetragen ist (z.B. Gast-Gruppe) | Kein Mapping-Treffer — der Standard-Workflow am Artikel greift, identisch zum Verhalten ohne dieses Add-On. |
Wann ist das Mapping sichtbar bzw. wirksam?
Sichtbar im Backend: Die Mapping-Tabelle erscheint im Artikel-Edit, sobald das Add-On aktiv ist und der Artikel mindestens einem Shop zugewiesen ist, der Benutzergruppen hat.
Wirksam im Warenkorb: Die Mapping-Auswahl wird im Warenkorb berücksichtigt, sobald das Add-On aktiv ist und der bestellende Endkunde einer gemappten Benutzergruppe angehört.
Wirksam beim Bestellabschluss: Greift identisch — der gemappte Workflow wird auch dann verwendet, wenn er für eine andere Benutzergruppe konfiguriert wurde.
Mapping per Export / Import pflegen
Die Mapping-Konfiguration kann mit dem Artikelexport 2.0 / Artikelimport 2.0 exportiert und importiert werden — z.B. um viele Artikel mit identischer Konfiguration zu pflegen.
Dafür muss in der Export-/Import-Vorlage das Feld „article_settings" mit dem Namen „local_release_workflow_user_group_mapping" ergänzt werden. Der Wert dieser Spalte ist ein JSON-Objekt, das pro Benutzergruppe die Default-Workflow-ID (id) und die Mehrfachauswahl (ids) enthält:
Die äußeren Schlüssel (z.B. "10", "20") sind die IDs der Benutzergruppen. Pro Eintrag ist id der vorausgewählte Default und ids die komplette Auswahl an verfügbaren Workflows. Im Single-Modus (ohne aktives Add-On „Lokaler Bestellworkflow Mehrfachauswahl") enthält ids genau einen Eintrag.
Wenn parallel auch das Add-On „Lokaler Bestellworkflow Mehrfachauswahl" verwendet wird, sollten die Felder „local_release_workflow_id" (Single, Default am Artikel) und „local_release_workflow_ids" (Mehrfachauswahl am Artikel) zusätzlich exportiert/importiert werden — wie in der Wiki-Seite zu jenem Add-On beschrieben. Damit ist sichergestellt, dass auch der Artikel-Standardworkflow korrekt mitgenommen wird.
Hinweise zum Import-Verhalten:
Der Import validiert den JSON-Wert. Ist die Spalte nicht JSON-konform oder die Struktur fehlerhaft, wird die Einstellung für den betroffenen Artikel ignoriert (kein Abbruch, der Rest des Imports läuft weiter).
Beim Import wird die komplette Einstellung am Artikel überschrieben — partielle Aktualisierungen einzelner Benutzergruppen sind über Export/Import nicht möglich. Vorhandene Einträge, die im Import-Wert nicht enthalten sind, werden verworfen.
Beim nächsten Speichern des Artikels im Backend werden Mapping-Einträge auf Benutzergruppen, die nicht zu einem dem Artikel zugewiesenen Shop gehören, oder auf inaktive/gelöschte Workflows automatisch verworfen. Es ist daher ratsam, vor einem größeren Import zu prüfen, dass die referenzierten Benutzergruppen und Workflows zum Mandanten und zu den Artikel-Shops passen.
Es empfiehlt sich, einen vollständig konfigurierten Test-Artikel zuerst zu exportieren — der Export liefert dann die korrekte Schreibweise und Struktur für den Import-Vorgang.
Bekannte Einschränkungen
Kein expliziter Ausschluss einer Benutzergruppe: Es ist aktuell nicht möglich, eine Benutzergruppe so zu hinterlegen, dass für sie gar kein lokaler Bestellworkflow läuft, während andere Gruppen den Standard-Workflow nutzen. Wer für eine bestimmte Gruppe (z.B. Admin-Mitarbeiter) keine Freigabe wünscht, muss aktuell entweder den Standard-Workflow am Artikel auf „Deaktiviert" setzen (wirkt dann auf alle nicht gemappten Gruppen) oder mit einem getrennten Artikel arbeiten.
Standardwert innerhalb der Mehrfachauswahl ist nicht konfigurierbar: Bei mehreren Workflows pro Mapping wird automatisch der erste Eintrag als Standard verwendet. Eine manuelle Auswahl des Standards ist aktuell nicht möglich, das Speicherformat ist aber bereits darauf vorbereitet.
Kein direktes Bulk-Editing in der Backend-UI: In der Artikelverwaltung selbst lässt sich das Mapping nur pro Artikel pflegen. Für Massenpflege steht jedoch der oben beschriebene Weg über Artikelexport / Artikelimport 2.0 zur Verfügung — ein Artikel wird vollständig konfiguriert, exportiert und der Mapping-Wert anschließend für die gewünschten Zielartikel im Import wiederverwendet.