Add-On: Lokaler Bestellworkflow Mehrfachauswahl

Ab Release 8.27.0

Lokaler Bestellworkflow -- Mehrfachauswahl (LocalReleaseWorkflowSelection)

Beschreibung

Standardmäßig kann einem Artikel nur ein einzelner lokaler Bestellworkflow zugewiesen werden. Mit dem Add-On Lokaler Bestellworkflow Mehrfachauswahl können einem Artikel mehrere Workflows zugewiesen werden. Der Endbenutzer (Shop-User) kann dann an zwei Stellen den gewünschten Workflow auswählen:

  • Im Warenkorb -- vor der Bestellung

  • Auf der Freigabeseite -- beim Artikelwechsel (sofern das Modul Artikeländerung aus der Freigabe ebenfalls aktiv ist)

Funktionsumfang

  • Mehrfachauswahl von lokalen Bestellworkflows pro Artikel im Backend

  • Durchsuchbare Auswahl im Backend

  • Workflow-Dropdown im Warenkorb (nur sichtbar bei mehr als einem verfügbaren Workflow)

  • Workflow-Auswahl im Artikelwechsel-Dialog auf der Freigabeseite

  • Option "Aktuellen Workflow beibehalten" beim Artikelwechsel

  • Bei Workflow-Wechsel auf der Freigabeseite: automatischer Reset auf den ersten Workflow-Schritt, MD5-Neugenerierung und erneuter Versand der Freigabemail

  • Abwärtskompatibilität: Der erste ausgewählte Workflow wird weiterhin als Standardwert gespeichert


Voraussetzung: Modul aktivieren

Das Add-On Lokaler Bestellworkflow Mehrfachauswahl (LocalReleaseWorkflowSelection) muss für den jeweiligen Mandanten aktiviert werden. Ohne aktiviertes Modul bleibt die bisherige Einzelauswahl bestehen und es ändert sich nichts am Verhalten.


Backend-Konfiguration

Workflows einem Artikel zuweisen

Navigieren Sie zu Produkte > Artikel > bearbeiten > Reiter "Freigabe / Dienstleister".

Im Abschnitt Lokaler Bestellworkflow wird bei aktiviertem Modul statt des bisherigen Einzel-Dropdowns ein Mehrfach-Dropdown mit Suchfunktion angezeigt.

Bedienung:

  1. Klicken Sie auf das Dropdown-Feld

  2. Nutzen Sie die Suchfunktion, um Workflows zu finden

  3. Wählen Sie einen oder mehrere Workflows aus (die Workflows sind nach Shop gruppiert)

  4. Speichern Sie den Artikel

Hinweise:

  • Wird kein Workflow ausgewählt, ist kein lokaler Bestellworkflow für den Artikel aktiv (wie bei "Deaktiviert" im Einzelmodus)

  • Der erste ausgewählte Workflow wird als Standard-Workflow verwendet und ist abwärtskompatibel mit der bisherigen Einzelauswahl

  • Bei deaktiviertem Modul wird automatisch die bisherige Einzelauswahl mit "Deaktiviert"-Option angezeigt


Bedienung im Warenkorb

Wenn für einen Artikel mehrere Workflows konfiguriert sind, wird im Warenkorb unterhalb der Kostenstelle ein Dropdown "Lokaler Bestellworkflow" angezeigt.

  • Das Dropdown erscheint nur, wenn mehr als ein Workflow für den Artikel konfiguriert ist

  • Der Standard-Workflow (erster konfigurierter) ist vorausgewählt

  • Die Auswahl wird automatisch gespeichert und beim Checkout berücksichtigt

  • Bei nur einem konfigurierten Workflow läuft der Prozess wie bisher im Hintergrund


Bedienung auf der Freigabeseite

Workflow-Auswahl beim Artikelwechsel

Auf der Freigabeseite ist die Workflow-Auswahl in den Artikelwechsel-Dialog integriert (erfordert zusätzlich das Modul Artikeländerung aus der Freigabe).

Im Dialog erscheint unterhalb der Preis-/Mengenauswahl ein Dropdown "Workflow auswählen" mit folgenden Optionen:

Option

Beschreibung

{Aktueller Workflow} (beibehalten)

Behält den aktuellen Workflow bei -- auch wenn der neue Artikel diesen Workflow nicht konfiguriert hat. Dies ist die Standardauswahl.

{Workflow-Name}

Wechselt zum ausgewählten Workflow des neuen Artikels.

Ablauf bei einem Workflow-Wechsel:

  1. Der Workflow-Schritt wird auf den ersten Schritt des neuen Workflows zurückgesetzt

  2. Der MD5-Hash der Bestellposition wird neu generiert (bisherige Freigabe-Links werden ungültig)

  3. Die Freigabemail wird erneut versendet

  4. Der Wechsel wird im Workflow-Log dokumentiert

Ablauf ohne Workflow-Wechsel (beibehalten):

  • Der Workflow bleibt unverändert

  • Es findet kein Reset statt

  • Nur die Artikeländerung wird verarbeitet (sofern ein anderer Artikel/Preis gewählt wurde)

Workflow-Dropdown beim Nachladen

Wenn im Dialog ein anderer Artikel ausgewählt wird, werden die verfügbaren Workflows für den neuen Artikel automatisch per AJAX nachgeladen. Der aktuelle Workflow wird als "beibehalten"-Option beibehalten, auch wenn er nicht für den neuen Artikel konfiguriert ist.


Artikelsteuerung über Export / Import

Mit dem Artikelexport 2.0 / Artikelimport 2.0 kann die Mehrfach-Workflow-Zuordnung exportiert und importiert werden.

Dafür muss das Feld "article_settings" hinzugefügt werden und dem Feld "Artikel Zusatzinformationen" der Name "local_release_workflow_ids" ergänzt werden.

Es ist ratsam, einen Artikel zu konfigurieren und den Datensatz erst einmal zu exportieren, um für den Import die korrekte Schreibweise und den Aufbau zu haben.

Sobald die Einstellung für local_release_workflow_ids beim Import nicht JSON-konform ist oder die Struktur aus einem anderen Grund nicht stimmt, wird diese Einstellung für den Artikel ignoriert.

Es wird immer die komplette Einstellung überschrieben.


Zusammenspiel mit anderen Modulen

Modul

Zusammenspiel

Artikeländerung aus der Freigabe (ArticleChangeFromRelease)

Die Workflow-Auswahl auf der Freigabeseite ist in den Artikelwechsel-Dialog integriert. Ohne dieses Modul ist die Workflow-Auswahl nur im Warenkorb verfügbar.

Nachträgliche Änderungen (SubsequentChangesFromRelease)

Bei einem Workflow-Wechsel wird geprüft, ob der neue Workflow-Schritt ein Reset erfordert (doNotResetAfterSubsequentChanges).


Technische Hinweise

  • Datenhaltung: Die Workflow-IDs werden als JSON-Array in der Artikel-Einstellung local_release_workflow_ids gespeichert. Die bisherige Einzeleinstellung local_release_workflow_id wird weiterhin mit dem ersten Workflow befüllt (Abwärtskompatibilität).