DirectOrder

DirectOrder-Aktionen für die Direktbestellung: Produkte per Artikelnummer in eine Bestellliste eintragen, ändern und in den Warenkorb übernehmen.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Direktbestellung beschrieben. Mit diesen Aktionen können Produkte pro Artikelnummer direkt in eine Bestellliste eingetragen, aktualisiert und in den Warenkorb übernommen werden.

---

​

Aktionen im Überblick

Aktion	Beschreibung
DirectOrderAdd	Fügt ein Produkt per Artikelnummer zur Direktbestellliste hinzu.
DirectOrderUpdate	Aktualisiert die Menge eines Produkts in der Direktbestellliste.
DirectOrderDelete	Entfernt ein Produkt aus der Direktbestellliste.
DirectOrderAddLines	Fügt eine weitere Eingabezeile zur Direktbestellliste hinzu.
DirectOrderDeleteLines	Entfernt die letzte Eingabezeile aus der Direktbestellliste.

---

​

Aktionen

​

DirectOrderAdd

Mit dieser Aktion wird ein Produkt per Artikelnummer zur Direktbestellliste hinzugefügt. Nach erfolgreicher Ausführung wird das Produkt mit seinen Informationen in der Liste angezeigt.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, auf der Kunden Produkte schnell per Artikelnummer suchen und zur Bestellliste hinzufügen können, ohne die Produktdetailseite aufrufen zu müssen.

Parameter

Name	Beschreibung
id	Die Artikelnummer des Produkts, das hinzugefügt werden soll.

Fehlercodes

Fehlercode	Beschreibung
errorsByField.id	Fehler bei der Eingabe der Artikelnummer.
errorsByField.quantity	Fehler bei der Eingabe der Menge.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items
• $wsDirectOrders.currentLines

Beispiel das zeigt, wie ein Produkt über ein Artikelnummer-Eingabefeld zur Direktbestellliste hinzugefügt wird.

{{ var $myActionDirectOrderAdd = $wsActions.create("DirectOrderAdd", tag=string($myDirectOrderProduct)) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderAdd.csrf }}">
    <input type="text" name="id" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].id | ifNull('') }}">
    <button type="submit" name="wsact" value="{{= $myActionDirectOrderAdd.id }}">Produkt suchen.</button>
</form>

---

​

DirectOrderUpdate

Mit dieser Aktion wird die Menge eines Produkts in der Direktbestellliste aktualisiert.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde die Menge eines bereits eingetragenen Produkts anpassen möchte.

Parameter

Name	Beschreibung
quantity	Die neue Menge des Produkts.

Fehlercodes

Fehlercode	Beschreibung
errorsByField.quantity	Fehler bei der Eingabe der Menge.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items

Beispiel das zeigt, wie die Menge eines Produkts in der Direktbestellliste über ein Eingabefeld aktualisiert wird.

{{ var $myActionDirectOrderUpdate = $wsActions.create("DirectOrderUpdate", tag=string($myDirectOrderProduct)) }}
<input type="text" name="quantity" value="{{= $wsDirectOrder.items[$myDirectOrderProduct].quantity | ifNull('1') }}">
<button type="submit" name="wsact" value="{{= $myActionDirectOrderUpdate.id }}">Produkt aktualisieren.</button>

---

​

DirectOrderDelete

Mit dieser Aktion wird ein Produkt aus der Direktbestellliste entfernt.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde ein Produkt aus der Bestellliste entfernen möchte.

Parameter

Name	Beschreibung
id	Die Artikelnummer des Produkts, das entfernt werden soll.

Fehlercodes

Fehlercode	Beschreibung
errorsByField.id	Fehler bei der Eingabe der Artikelnummer.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrder.items

Beispiel das zeigt, wie ein Produkt über einen Button aus der Direktbestellliste entfernt wird.

{{ var $myActionDirectOrderDelete = $wsActions.create("DirectOrderDelete", tag=string($myDirectOrderProduct)) }}
<button type="submit" name="wsact" value="{{= $myActionDirectOrderDelete.id }}">Produkt entfernen.</button>

---

​

DirectOrderAddLines

Mit dieser Aktion wird eine weitere Eingabezeile zur Direktbestellliste hinzugefügt, sodass der Kunde mehr Produkte auf einmal eintragen kann.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde mehr Produkte eintragen möchte als aktuell Zeilen vorhanden sind.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrders.currentLines

Beispiel das zeigt, wie über einen Button eine neue Eingabezeile zur Direktbestellliste hinzugefügt wird.

{{ var $myActionDirectOrderAddLines = $wsActions.create("DirectOrderAddLines") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wsact" value="{{= $myActionDirectOrderAddLines.id }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderAddLines.csrf }}">
    <button type="submit">Zeile hinzufügen.</button>
</form>

---

​

DirectOrderDeleteLines

Mit dieser Aktion wird die letzte Eingabezeile aus der Direktbestellliste entfernt. Die Aktion ist nur verfügbar, wenn mehr als fünf Zeilen vorhanden sind.

Anwendungsbeispiel
Nutzbar auf der Direktbestellseite, wenn ein Kunde zu viele Zeilen hinzugefügt hat und diese wieder entfernen möchte.

Zugehörige Module, Variablen & Methoden

• $wsDirectOrder
• $wsDirectOrders.currentLines

Beispiel das zeigt, wie die letzte Eingabezeile über einen Button entfernt wird, sofern mehr als fünf Zeilen vorhanden sind.

{{ if $wsDirectOrder.currentLines > 5 }}
    {{ var $myActionDirectOrderDeleteLines = $wsActions.create("DirectOrderDeleteLines") }}
    <form method="post" action="{{= $wsViews.current.url() }}">
        <input type="hidden" name="wsact" value="{{= $myActionDirectOrderDeleteLines.id }}">
        <input type="hidden" name="wscsrf" value="{{= $myActionDirectOrderDeleteLines.csrf }}">
        <button type="submit">Zeile entfernen.</button>
    </form>
{{ /if }}