Formatkonfiguration der Tourenliste
Mithilfe einer Maske, die im Admin für einzelne Displays definiert wird, kann man den Inhalt bei jeder Tour/jedem Auftrag in der Übersichtsliste und in der Detailansicht vielfältig gestalten. Es gibt zwei frei definierbare Felder, die jeweils eine Maske bekommen können. Es ist vollkommen frei, nur ein Feld oder beide mit einer Maske zu definieren. Der Unterschied zwischen der beiden Feldern besteht darin, dass, wenn beide definiert sind, das erste ein bisschen prominenter erscheint als das zweite (mit einer größeren Schriftart). Ist dagegen nur ein Feld definiert (egal welches), erscheint es immer an der prominentesten Stelle.
Im Bild oben ist ein Beispiel, wo das erste Feld die Ortschaften beim Tour-Start und dem Tour-Stopp zeigt und das zweite Feld die entsprechenden Kontaktdaten mit Angaben zu der Anzahl der Sendungen an jeweiligen Zielen zeigt.
Im Admin (Bild oben) definiert man diese Masken unter "Display" im Tab "Aufträge".
Syntax
Eine Maske besteht aus einer oder mehreren Angaben zu den gewünschten Datenfeldern aus einer Tour/einem Auftrag. Die allgemeine Syntax:
Ein Datenfeld ist durch ein Schlüsselwort definiert. Außerdem kann fast jedes Datenfeld parametrisiert werden. Mit zusätzlichen Parametern lässt sich ein Datenfeld präzise adressieren und mit freien Texten umrahmen. Ohne Parametern versteht sich ein Datenfeld immer aus einem ersten Ziel in einer Tour (für Ziel-Felder) und aus einer ersten Sendung in einem Ziel (für Sendung-Felder).
Außerdem kann man Zahl-basierte Datenfelder mit einem Ausgabenformat versehen, um die Darstellung von Zahlen zu präzisieren.
Das Format versteht sich als Standardformat in einer printf-Funktion (C++, Java etc.).
Jedes Datenfeld (mit einigen Ausnahmen) aus einer Tour/einem Auftrag kann in einer Maske abgebildet werden. Hier ist die Liste mit allen möglichen Datenfeldern:
Schlüsselwort | Bedeutung |
TourChildrenCount | Die Anzahl aller Ziele. |
TourNumber | Text, Tour-Nummer |
TourDescription | Text, Tour-Beschreibung |
OrderNumber | Text, Auftragsnummer |
OrderDescription | Text, Auftragsbeschreibung |
OrderName | Text, Kontaktname aus dem Auftrag |
OrderCity | Text, Stadt aus dem Auftrag |
OrderStreet | Text, Straße aus dem Auftrag |
OrderCountry | Text, Land aus dem Auftrag |
OrderZipCode | Text, PLZ aus dem Auftrag |
OrderHouseNumber | Text, Hausnummer aus dem Auftrag |
OrderContact | Text, Kontaktdaten aus dem Auftrag |
DestinationChildrenCount | Die Anzahl aller Sendungen im aktuellen Ziel. |
DestinationNumber | Text, Nummer aus dem Ziel |
DestinationDescription | Text, Beschreibung aus dem Ziel |
DestinationPosition | Zahl, Position des Ziels in der Tour: kann mit "int" formatiert werden |
ShipmentNumber | Text, Nummer der Sendung |
ShipmentDescription | Text, Beschreibung der Sendung |
ShipmentPosition | Zahl, Position der Sendung im Ziel: kann mit "int" formatiert werden |
ShipmentAction | Text, Aktion der Sendung (Beladen, Entladen oder Dienstleistung) |
ShipmentPackageCount | Zahl, die Anzahl der Pakete in der Sendung: kann mit "double" oder "float" formatiert werden |
ShipmentUnit | Text, Einheit aus der Sendung |
ShipmentName1 | Text, Name 1 aus der Sendung |
ShipmentName2 | Text, Name 2 aus der Sendung |
ShipmentContact | Text, Kontaktdaten aus der Sendung |
ShipmentStreet | Text, Straße aus der Sendung |
ShipmentHouseNumber | Text, Hausnummer aus der Sendung |
ShipmentZipCode | Text, PLZ aus der Sendung |
ShipmentCity | Text, Stadt aus der Sendung |
ShipmentCountry | Text, Land aus der Sendung |
Parameter für die Datenfelder.
Suffix | Bedeutung | Argumente | Beispiel |
first last | Definiert die genaue Position eines Elementes aus der Tour:
Die Reihenfolge von first und last bestimmt, welches Unterelement angesprochen wird:
| +/-N wo N ist eine Zahl, die relative Position des Elementes bestimmt:
Wenn nicht angegeben: versteht sich immer als first. |
|
skip | Wenn dieses Element nicht ermittelbar ist, werden alle Ausgaben bis zum nächsten gültigen Tour-Element übersprungen. | Ein beliebiger Text. Die Zeichen '.' und '}' sind nicht erlaubt. |
|
count | Kombinierbar mit zwei Feldnamen: TourChildrenCount oder DestinationChildrenCount. Gibt die Anzahl der Kinderelemente bei der übergeordneten Stelle.
Wenn die berechnete Zahl eine 0 oder negativ ist, erscheint keine Anzeige. | -N wo N ist eine negative Zahl, die von der Gesamtzahl subtrahiert wird. |
|
ltext | Ein beliebiger Text links vom eigentlichen Datenfeldes. | Ohne Text macht dieses Suffix keinen Sinn. Die Zeichen '.' und '}' sind nicht erlaubt. | ${TourChildrenCount.count-2.ltext Dazwischen: .rtext Ziele![]() ![]() |
rtext | Ein beliebiger Text rechts vom eigentlichen Datenfeldes. | Ohne Text macht dieses Suffix keinen Sinn. Die Zeichen '.' und '}' sind nicht erlaubt. | |
range | Das Datenfeld wird in einem angegebenen Bereich bei allen Zielen wiederholt. Die Suffix "range" ersetzt die Adressierung eines Ziels (sowohl bei Ziel- als auch bei Sendungsfeldern). | +N-M wo N ist eine positive Zahl, die den Abstand zum Anfang aller Ziele bestimmt und M ist eine negative Zahl, die den Abstand zum letzten Ziel festlegt. | ${ShipmentName1.first.range1-1} Zeigt einen Sendungsnamen aus allen ersten Sendungen, die zwischen dem zweiten und dem vorletzten Ziel liegen. |