Die Berechnungsfunktion "$ta" liest ein beliebiges typisiertes Attribut von einem Objekt, welches Attribute besitzen kann.
Wird dabei kein expliziter Attributbesitzer angegeben (Parameter "owner"), so wird versucht das Attribut vom Eingangsobjekt ($input) zu lesen.
Tooltip
Syntax: $ta(attributeType,typeValue[,path[,owner]])
|
Parameter
|
Beschreibung
|
|
attributeType
|
Der qualifizierte Name des Attributs
z.B. "de.lobster.scm.base.bto.attribute.DateAttribute"
|
|
typeValue
|
Der Typ des Attributwertes (Name des Aufzählungswertes)
z.B. "PICKUP_REQUESTED"
|
|
path
|
Ein optionaler Datenfeldpfad, welcher direkt den Wert eines Datenfelds des Attributs zurück liefert (Ausgehend vom Eingabeobjekt $input).
z.B. "value.date" (Tipp: Auch hier empfielt sich über einen "Objekt Feld" Wertauflöser der Ereignisbehandlung oder des Abfragekonfigurators, die verfügbaren Datenfelder auflisten zu lassen)
Wird dieser Parameter nicht angegeben, so wird das gesamte Attributobjekt zurückgegeben
|
|
owner
|
Ein optionaler Parameter, welcher das Objekt übergibt, von dem das Attribut gelesen werden soll.
Tipp: Anstatt direkt ein Objekt zu übergeben, kann hier auch ein Datenfeldpfad, relativ zum Eingabeobjekt ($input), angegeben werden, von dem der Attributsbesitzer gelesen wird
|
Gibt das gelesene Attribut oder (wenn gegeben) den Wert eines Attributdatenfeldes (siehe Parameter path) zurück. Ist der Attributbesitzer, das Attribut oder das angegebene Datenfeld nicht vorhanden, wird null zurückgegeben.
Beispiel:
$ta(de.lobster.scm.base.bto.attribute.DateAttribute,DUE_DATE,value.date,$el(1))
Syntax
$ta(attributeType,typeValue[,path[,owner]])
Parameter
|
Name
|
Beschreibung
|
|
attributeType
|
Der qualifizierte Name des Attributs
z.B. "de.lobster.scm.base.bto.attribute.DateAttribute"
|
|
typeValue
|
Der Typ des Attributwertes (Name des Aufzählungswertes)
z.B. "PICKUP_REQUESTED"
|
|
|
Anmerkung zu attributeType und typeValue:
Im Handbuch existiert keine Liste der verfügbaren Attribute und deren Klassennamen oder Typen da hier extrem viele Kombinationsmöglichkeiten existieren, welche über die entsprechenden Dynamischen Aufzählungen erweiterbar sind.
Welche Attribute überhaupt zugreifbar sind, hängt dabei zusätzlich vom Attributsbesitzer ab ($input/owner-Parameter) ab.
Es empfielt sich daher, mit Hilfe eines "Typisierten Attribut" Wertauflösers (Ereignisbehandlung oder Abfragekonfigurator), eine Liste der im Kontext verfügbaren Attribute und deren Typen anzeigen zu lassen.
Hier werden dann in Klammern die qualifizierten Namen der Attribute und die Originalnamen der Typen dargestellt.
|
|
path
|
Ein optionaler Datenfeldpfad, welcher direkt den Wert eines Datenfelds des Attributs zurück liefert (Ausgehend vom Eingabeobjekt $input).
z.B. "value.date" (Tipp: Auch hier empfielt sich über einen "Objekt Feld" Wertauflöser der Ereignisbehandlung oder des Abfragekonfigurators, die verfügbaren Datenfelder auflisten zu lassen)
Wird dieser Parameter nicht angegeben, so wird das gesamte Attributobjekt zurückgegeben
|
|
owner
|
Ein optionaler Parameter, welcher das Objekt übergibt, von dem das Attribut gelesen werden soll.
Tipp: Anstatt direkt ein Objekt zu übergeben, kann hier auch ein Datenfeldpfad, relativ zum Eingabeobjekt ($input), angegeben werden, von dem der Attributsbesitzer gelesen wird
|
Rückgabewert
Gibt das gelesene Attribut oder (wenn gegeben) den Wert eines Attributdatenfeldes (siehe Parameter path) zurück. Ist der Attributbesitzer, das Attribut oder das angegebene Datenfeld nicht vorhanden, wird null zurückgegeben.
Beispiel
Zugriff auf das Datumsattribut "PICKUP_REQUESTED" einer Sendung. Ausgeführt in einem Berechnen Verhalten.
Der Rückgabewert ist das DateRange (Datumsbereich) Objekt des Attributs.
Hinweis: $el(1) liefert die Daten des Formularelements (Element-ID: 1), welches die Sendung geladen hat.