Administration
Die Administration des Plugins besteht aus vier Teilen: dem Einstellungsmodul für Vorgangstypen und -gruppen, dem Reiter „Bisherige Vorgänge" an jedem Kunden, fünf CMS-Elementen für Erlebniswelten und der Plugin-Konfiguration (siehe Installation).
Typen und Gruppen verwalten
Das Modul liegt unter Einstellungen → Erweiterungen → Vorgangsanzeige (Route leoparden.businessTransactions.index). Es hat zwei Reiter, Vorgangstypen und Vorgangsgruppen, jeweils mit einer Tabelle, einem Bearbeiten-Eintrag im Kontextmenü und Löschen (einzeln oder per Mehrfachauswahl); der Sprachumschalter sitzt in der Kopfleiste. Über der Tabelle legt die Schaltfläche Vorgangstyp erstellen bzw. Vorgangsgruppe erstellen einen neuen Eintrag an. Die Formulare für Typ, Gruppe und Vorgang speichern auch mit der Tastenkombination Systemtaste + S.
Die Tabelle der Typen zeigt Name, typeMatch (Spaltenüberschrift „Type Id"), Gruppe und „Count", die Anzahl der Vorgänge je Typ. Die Tabelle der Gruppen zeigt Name und „Count", die Anzahl der Typen. Die Spaltenüberschriften sind im Modul fest auf Englisch hinterlegt.
Eine Gruppe anlegen
Öffnen Sie das Modul und wechseln Sie zum Reiter Vorgangsgruppen.
Klicken Sie auf Vorgangsgruppe erstellen.
Tragen Sie den Namen ein. Der Name ist übersetzbar; wechseln Sie dazu die Sprache im Sprachumschalter.
Speichern Sie. Das Formular zeigt die Typen der Gruppe als Liste an und öffnet nach dem Speichern die gespeicherte Gruppe.
Einen Typ anlegen
Wechseln Sie zum Reiter Vorgangstypen und klicken Sie auf Vorgangstyp erstellen.
Tragen Sie den Namen ein (übersetzbar).
Tragen Sie bei Typ eine Zahl ein. Sie bestimmt die Reihenfolge der Typen innerhalb der Gruppe, aufsteigend (Feld
typeMatch, Pflichtfeld).Wählen Sie die Gruppe. Tippen Sie einen neuen Namen ein, legt das Auswahlfeld die Gruppe an.
Speichern Sie.
Löschen Sie einen Typ oder eine Gruppe nur, wenn Sie wissen, was daran hängt:
Beim Löschen eines Typs setzt die Datenbank
transaction_type_idder zugehörigen Vorgänge aufNULL(ON DELETE SET NULL). Die Vorgänge bleiben bestehen, haben aber keinen Typ mehr.Für die Gruppe legt die Migration keinen Fremdschlüssel von den Typen auf die Gruppe an. Das Plugin sichert nicht ab, was mit den Typen einer gelöschten Gruppe geschieht.
Änderungen an Gruppen erzeugen die SEO-URLs der Gruppenseiten neu (DynamicSeoUrlPageSubscriber), Änderungen an Vorgängen die der Detailseiten.
Kundengruppen den Typen zuordnen
Welche Typen ein Kunde im Shop sieht, legen Sie in der Plugin-Konfiguration fest (Feld „Belegtypen wählen, welche im Account gezeigt werden sollen", Schlüssel showCategoriesInTransactionsView), siehe Installation.
Typen einer Kundengruppe freigeben
Öffnen Sie die Konfiguration des Plugins.
Wählen Sie im Feld Gruppe eine Kundengruppe.
Wählen Sie unter Typen für … die Vorgangstypen, die diese Kundengruppe sehen soll.
Wiederholen Sie das für jede Kundengruppe und speichern Sie.
Außerdem wählen Sie in der Konfiguration die Typen für „Offen" (openCategories) und „Rechnung" (invoiceCategories); sie speisen die Elemente Artikel in Bearbeitung, Kürzlich gelieferte und Meist gekauft nach Kunde.
Vorgänge am Kunden ansehen
An jedem Kunden (Kunden → Kunde → Reiter „Bisherige Vorgänge") listet die Administration die Vorgänge des Kunden: Vorgangsnummer, Belegdatum, Lieferdatum, Typ, Versand- und Rechnungsadresse sowie das Archivkennzeichen, sortiert nach Belegdatum absteigend, 50 je Seite. Die Aktion Ansehen öffnet die Detailansicht (Route sw.customer.detail.business-transactions-detail) mit:
Status (aus dem Lieferdatum abgeleitet) und dem Hinweis „Archiviert" oder „Aktuell"
Versand- und Rechnungsadresse (ist keine Adresse verknüpft, der Freitext
fallbackShippingbzw.fallbackBilling)den Positionen des Vorgangs
den Zusatzfeldern des Vorgangs
Die Detailansicht ist in der Linie 6.7 bearbeitbar: Die Karte hat eine Schaltfläche Speichern, die erst aktiv wird, wenn sich am Vorgang etwas geändert hat (zum Beispiel ein Zusatzfeld), und speichert den Vorgang. Das Modul trägt außerdem die Route leoparden.businessTransactions.detail (mit Schaltfläche Speichern) als Detailroute der Entität ein und hinterlegt eine Suchkonfiguration für Vorgangsnummer und Kundennummer; keine Liste des Plugins verlinkt auf diese Route.
Auch das Zusatzfeld-Set lässt sich auf Vorgänge anwenden: In der Verwaltung der Zusatzfeld-Sets steht „Vorgänge" als zusätzliche Entität zur Auswahl.
CMS-Elemente platzieren
Die fünf Elemente erscheinen im Erlebniswelten-Editor in der Elementauswahl. Sie funktionieren nur für angemeldete Kunden; für Gäste bleiben die Listen leer.
Ein Element in einer Erlebniswelt platzieren
Öffnen Sie die Erlebniswelt und wählen Sie einen Block mit einem Slot.
Wählen Sie im Slot das gewünschte Element aus der Tabelle unten.
Konfigurieren Sie das Element, soweit es Einstellungen hat.
Speichern Sie die Erlebniswelt und ordnen Sie sie einer Kategorie zu.
Element (technischer Name) | Bezeichnung im Editor | Einstellungen | Zeigt |
|---|---|---|---|
| Vorgangsgruppe | Gruppe (Auswahl einer Vorgangsgruppe) | Die nicht archivierten Vorgänge des Kunden aus dieser Gruppe als Liste |
| Vorgangslisting | Überschrift, Hilfetext, Kontrollkästchen „Archive", Typen (Mehrfachauswahl) | Vorgänge der gewählten Typen als sortierbare Tabelle, optional das Archiv |
| Artikel in Bearbeitung | keine | Positionen mit Lieferdatum aus den Typen |
| Kürzlich gelieferte | keine | Positionen aus den Typen |
| Meist gekauft nach Kunde | keine | Die bis zu 100 am häufigsten gekauften Artikelnummern aus den Typen |
Zu den Elementen gelten folgende Einschränkungen:
Die Elemente
articles-on-orderundmost-bought-by-customerbieten im Editor keine Einstellungen, die Typen kommen aus der Plugin-Konfiguration.Bei
articles-on-orderzeigt die Typauswahl über der Tabelle die Typen ausopenCategories, beschriftet mit dem Namen des Typs. Die Namen lädt derArticlesOnOrderCmsElementResolver; ist für einen Typ kein Name zu finden, steht seine ID in der Option. Das Template ist mit{% sw_extends %}überschreibbar (siehe Frontend).transactionsundprocessesgehören zu den Elementen, deren Daten vom Kunden abhängen. Zum Zwischenspeichern der Seiten mit diesen Elementen siehe Backend.
Status- und Mailtexte
Die Texte zu den Statuswerten stehen in den Storefront-Snippets unter plugin.leoparden.BusinessTransactions.states.<Zahl>. Sie sind auf einen konkreten Betrieb zugeschnitten (Maschinenbau, BAFA-Anträge, Fragebogen vor der Produktion). Passen Sie sie über die Snippet-Verwaltung an Ihren Ablauf an.
Zum Mailversand siehe den Abschnitt „Benachrichtigung bei neuen und geänderten Vorgängen" unter Backend: Das Plugin liefert Flow-Auslöser und eine Mailvorlage, einen Flow legen Sie selbst im Flow Builder an.