Ein großer Vorteil des Application Integration Frameworks (AIF) gegenüber “selbst
geschriebene” Schnittstellen ist es, dass man sich über Dinge wie Datentyp-Mapping
keine Gedanken machen muss.
Das Application Integration Framework verfügt über die entsprechende Logik, um alle
Dynamic AX Datentypen automatisch in den jeweils gültigen XSD-Datentyp zu “mappen”
(oder umgekehrt).
Zeiten, in denen sich der Entwickler zum Beispiel Gedanken machen musste, wie viele
Nachkommastellen eine Zahl haben darf, oder welches Zeichen als Dezimaltrennzeichen
verwendet werden muss, sind somit vorbei.
Da alle Daten die aus Dynamics AX exportiert oder nach Dynamics AX importiert werden,
in einem XSD-Schema konformen XML-Dokument “transportiert” werden, und das AIF entsprechendes
Mapping bereits stellt, geschieht das Datentyp-Mapping automatisch.
Allerdings kann auf Seiten der Anwendung, welche über das Application Integration
Framework (AIF) angebunden werden soll, ein wenig “Verwirrung” entstehen.
Durch die von Programmiersprache zu Programmiersprache durchaus unterschiedlichen
Datentypen kann es vorkommen, dass Dynamics AX Datentypen nicht in dem erwarteten
Datentyp der anderen Programmiersprache erscheinen.
Dies ist allerding kein “wirkliches” Problem des Application Integration Frameworks
(AIF), sondern eher eine Frage, welche Datentypen eine Programmiersprache bereit stellt
und wie diese in XSD-Datentypen “gemappt” werden.
Ein gutes Beispiel hierfür sind die Dynamics AX Datentypen “Date”, “Time” und “DateTime” (inklusive aller von diesen Basisdatentypen abgeleiteten EDT’s).
Ohne genauere Betrachtung liegt die Annahme nahe, dass ein DateTime Datentyp von Dynamics
AX in einen DateTime Datentyp von z.B. C# “gemappt” wird.
Dies ist allerdings nicht richtig. Da nicht direkt zwischen Dynamics AX Datentyp und
C# Datentyp gemappt wird, sondern immer von/zu einem XSD-Datentyp gemappt wird, wird
in C# eine neue Klasse hierfür erzeugt.
Ein wenig schwieriger wird es bei den beiden Dynamics AX Datentypen “Date” und “Time”.
Für diese Datentypen wird z.B. in C# kein direkt vergleichbarer Datentyp bereit gestellt.
Diese Datentypen werden jeweils als C# DateTime Datentypen gemappt.
Das Mapping der Datentypen geschieht wie folgt:
|
Dynamics AX |
XSD Schema |
.NET (C#) |
|
Date |
xs:date | System.DateTime |
|
Time |
xs:time | System.DateTime |
|
DateTime |
xs:dateTime |
new class i.e. “AxdType_DateTime” |
Da die beiden Dynamics AX Datentypen “Date” und “Time” in den C# Datentyp “DateTime”
gemappt werden, kann an dieser Stelle leider ein kleines Problem entstehen.
In C# ist nun leider nicht mehr zu erkennen, um was für einen Dynamics AX Datentyp
es sich z.B. bei einem Feld handelt, und ob nun ein Datum oder eine Zeit in diesem
enthalten ist.
Oftmals entsteht diese Problem dadurch nicht, dass der jeweilige Business-Kontext
die Datentypverwendung entsprechend einschränkt und es somit teilweise egal ist ob
nun in ein Dynamics AX Date oder Time gemappt wird.
Ist es aber erforderlich zu wissen, um ob ein Feld nun den Dynamics AX Datentyp Date
oder Time hat, kann der generierte Code der Proxyklasse Aufschluss geben (oder das
XSD-Schema).
Durch die Angabe eines Serialisierungs-Attributes wird bestimmt, welcher “Teil” des
DateTime Datentyps verwendet wird.
Für ein Feld, welches in einen Dynamics AX Date Datentyp gemappt wird, wird nur der
“Datumsteil” in das XML-Dokument serialisiert.
Entsprechendes geschieht für einen Dynamics AX Time Datentyp.
Mapping eines C# Datetime Datentyps in einen Dynamics AX Date Datentyp (generierter Code der Proxyklasse):
1: [System.Xml.Serialization.XmlElementAttribute(DataType="date",
IsNullable=true, Order=54)]
2:
public System.Nullable<System.DateTime>
MyDateField {
3: get {
4:
return
this.myDateFieldField;
5: }
6: set {
7:
this.myDateFieldField
= value;
8:
this.RaisePropertyChanged("MyDateField");
9: }
10: }
Mapping eines C# Datetime Datentyps in einen Dynamics AX Time Datentyp (generierter Code der Proxyklasse):
1: [System.Xml.Serialization.XmlElementAttribute(DataType="time",
IsNullable=true, Order=56)]
2:
public System.Nullable<System.DateTime>
MyTimeField {
3: get {
4:
return
this.myTimeFieldField;
5: }
6: set {
7:
this.myTimeFieldField
= value;
8:
this.RaisePropertyChanged("MyTimeField");
9: }
10: }
Wie durch den generierten Code der Proxyklasse ersichtlich wird, wird nur der jeweils benötigte “Teil” eines C# Datetime Datentyps serialisiert/deserialisiert und somit verwendet.
Für einen Dynamics AX DateTime Datentyp wird bei Erstellung des Proxys eine neue Klasse generiert. Somit kann der Dynamics AX Datentyp hierbei immer eindeutig identifiziert werden.
1: [System.CodeDom.Compiler.GeneratedCodeAttribute("System.Xml", "2.0.50727.4016")]
2: [System.SerializableAttribute()]
3: [System.Diagnostics.DebuggerStepThroughAttribute()]
4: [System.ComponentModel.DesignerCategoryAttribute("code")]
5: [System.Xml.Serialization.XmlTypeAttribute(Namespace="http://schemas.microsoft.com/dynamics/2008/01/documents/Customer")]
6:
public
partial
class AxdType_DateTime
: object, System.ComponentModel.INotifyPropertyChanged {
7:
8:
private System.DateTime
localDateTimeField;
9:
10:
private
bool localDateTimeFieldSpecified;
11:
12:
private AxdEnum_Timezone
timezoneField;
13:
14:
private
bool timezoneFieldSpecified;
15:
16:
private System.DateTime
valueField;
17:
18: [System.Xml.Serialization.XmlAttributeAttribute()]
19:
public System.DateTime
localDateTime ...
20:
21: [System.Xml.Serialization.XmlIgnoreAttribute()]
22:
public
bool localDateTimeSpecified...
23:
24: [System.Xml.Serialization.XmlAttributeAttribute()]
25:
public AxdEnum_Timezone
timezone...
26:
27: [System.Xml.Serialization.XmlIgnoreAttribute()]
28:
public
bool timezoneSpecified...
29:
30: [System.Xml.Serialization.XmlTextAttribute()]
31:
public System.DateTime
Value {
32:
33:
public
event System.ComponentModel.PropertyChangedEventHandler
PropertyChanged;
34:
35:
protected
void RaisePropertyChanged(string propertyName)...
36: }
Dieses Verhalten ist nicht nur mit C# zu beobachten. Auch JAVA oder andere Programmiersprachen verhalten sich ähnlich und muss entsprechend berücksichtigt werden.
Es wird keine Haftung oder Gewährleistung auf die Richtigkeit der gemachten Angaben gegeben. Die Verwendung erfolgt auf eigene Gefahr. Copyright © Axel Kühn (Aku's AX Blog, http://blog.ak-home.net) and Mathias Füßler (jinx's AX Blog, http://starside.eu)
