ta (Typisiertes Attribut lesen)

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))

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

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.

$ta(de.lobster.scm.base.bto.attribute.DateAttribute,PICKUP_REQUESTED,value.date,$el(1))

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.