WS-ExternInclude in ein Master-Template geholt werden. Welche Datei welche Aufgabe übernimmt, legen Sie in der Konfiguration wws-online-interface.config im Abschnitt Templates fest. Die Tags dieser Seite gelten ausschließlich in diesen Modul-Templates.
Wegweiser: WWS-Infodatenschnittstelle verwenden · Referenz: Konfiguration wws-online-interface.config
Die sechs Templates
Die Spalte “Templates” in den Tabellen dieser Seite nennt jeweils, in welchen dieser Templates ein Tag ausgewertet wird. “alle” bedeutet, dass es überall gilt.
Klammern Sie den Aufruf der Schnittstelle immer mit
WS-OnlineERPLink beziehungsweise WS-OnlineERPStockLevelLink. Die Klammerung greift nur, wenn die Schnittstelle überhaupt verfügbar ist, und hält den Block sonst aus der Seite heraus.
Die Feldnamen aus der Konfiguration
Welche Datenfelder die Warenwirtschaft liefert, ist von Shop zu Shop verschieden. Deshalb tragen die Felder keine sprechenden Tagnamen, sondern Nummern:H1 bis H1000 für die Kopfdaten eines Auftrags und P1 bis P1000 für die Positionsdaten. Welche Nummer wofür steht, legen Sie in wws-online-interface.config in den Abschnitten HeadData und PositionData fest.
Damit schreiben Sie die Spaltenüberschriften einer Tabelle nicht ins Template, sondern holen sie aus der Konfiguration. Ändert die Warenwirtschaft später die Bedeutung eines Feldes, genügt eine Änderung in der Konfiguration.
Die Auftragsliste
ERP-HeadData ist zugleich die Anzahl der gefundenen Aufträge, die Prüfung auf Treffer und die Schleife darüber.
wws-online-interface.config im Abschnitt Types fest. Fehlt dort ein Eintrag, bleibt ERP-HeadData_Type_Txt leer. Die Klammerung im Beispiel fängt das ab und zeigt dann wenigstens die Zahl.
ERP-HeadData_Download und ERP-LinkDownload sind zwei Namen für dasselbe Tag. Verwenden Sie in einem Template durchgängig einen davon.
Die Positionen eines Auftrags
Filter und Zeitraum
Die Übersichtsliste lässt sich über die Anzahl der Einträge, einen Zeitraum und einen alternativen Zeitraum einschränken. Alle dafür nötigen Auswahllisten bringt die Schnittstelle fertig mit.ERP-MaxEntries_select, ERP-AlternativeDate_select und ERP-Search_Type_select greifen als Klammerung nur, wenn mindestens zwei Einträge konfiguriert sind. Bei nur einer Auswahlmöglichkeit hat eine Liste keinen Sinn, und die Beschriftung daneben verschwindet gleich mit.
Die Monatsnamen und die Texte der vorgefertigten Zeiträume stehen in wws-online-interface.config im Abschnitt PeriodSelection. Dort legen Sie mit ShowYearsAgo auch fest, wie weit die Jahresliste zurückreicht.
Die Suche
ERP-Search_Type greift als Klammerung ohne Parameter genau dann, wenn überhaupt nach einem Typ gefiltert wird. Der Wert 0 bedeutet “kein Filter”.
Der Vergleich in ERP-Search_Type(Wert) läuft über Zahlen. Ein nicht numerischer Parameter wird zu 0 und trifft damit den ungefilterten Zustand.
Noch nicht übernommene Aufträge
Zwischen der Bestellung im Shop und der Übernahme in die Warenwirtschaft vergeht Zeit. In dieser Lücke kennt die Warenwirtschaft den Auftrag noch nicht, der Shop dagegen schon. Das eigene TemplatePendingEntries schließt diese Lücke.
ERP-LastShopOrderNumber ist die Grenze zwischen beiden Welten: Alles bis zu dieser Bestellnummer steht in der Auftragsliste, alles darüber in dieser Liste. Der Hinweis darauf erspart Rückfragen von Käufern, die ihre jüngste Bestellung in der Übersicht vermissen.
Der Lagerbestand
ERP-RequestSent trennt zwei Zustände, die im Template sonst gleich aussehen: Es wurde noch gar nicht angefragt, weil der Besucher erst eine Filiale wählen muss, oder es wurde angefragt und die Antwort lautet null. Ohne diese Klammerung meldet die Seite im ersten Fall fälschlich, das Produkt sei nicht vorrätig.
Allgemeine Anfragen
Neben Aufträgen und Lagerbestand kann die Schnittstelle beliebige weitere Datensätze liefern. Das TemplateCommonRequest zeigt sie an.
ERP-CommonName() erwartet den technischen Namen als festen Parameter. Die Überschrift je Datensatz bauen Sie deshalb über eine Klammerung mit ERP-CommonData_Name(…) auf, wie im Beispiel. Wer die Namen nicht kennt, gibt stattdessen schlicht ~ERP-CommonData_Name~ aus.
ERP-CommonName() verträgt einen zweiten Parameter. {ERP-CommonName(bestand,verfuegbar)} greift dann nur, wenn die konfigurierte Beschreibung zu bestand gleich verfuegbar ist.
ERP-Type_Selected(Wert) vergleicht numerisch. Der Parameter muss eine Zahl sein, kein Text.
Fehler und Meldungen
ERP-UserDependentRequest unterscheidet die käuferbezogenen Abfragen von der Lagerbestandsabfrage. Im gemeinsamen Fehler-Template können Sie damit dem angemeldeten Käufer einen anderen Text zeigen als dem anonymen Besucher.
Die Spalte Typ
Die Spalte “Typ” in den Tabellen dieser Seite hat vier Stellen. Jede Stelle steht für eine Verwendungsart,1 bedeutet zulässig, 0 nicht zulässig.
Ein Tag mit
1111 ist also in allen vier Formen verwendbar, ein Tag mit 0110 nur als positive und negative Klammerung.
Verwandte Themen
- Wegweiser: WWS-Infodatenschnittstelle verwenden
- Wegweiser: Externe Includes verwenden
- Referenz: Konfiguration wws-online-interface.config
- Referenz: WS-OnlineERPLink
- Referenz: WS-OnlineERPStockLevelLink