Inhaltsverzeichnis

Standard Objekt Attribute

Abhängig von Klasse eBiss.Api.

Description("abcde")

Dieser Text erlaubt die Dokumentation von Schnittstellen, der Text zwischen den Klammern wird im Mapping Designer unter dem Feldnamen angezeigt.

MapDefaultValueAttribute("Standardwert")

Dieses Attribut erlaubt die Definition eines Standardwertes für ein Feld. Der Wert wird nur verwendet, falls ein geladenes Dokument keinen Wert für das attributierte Feld bereitstellt. Ist der Wert im Dokument explizit „leer“ bzw. <NULL> gesetzt so wird der gesetzte Standardwert ebenfalls überschrieben. (Dieses Attribut dient in erster Linie der Definition eines abweichenden Standardwertes im Typ-Editor.)

MapExternalName("Name")

Falls der Field-Name unzulässige Sonderzeichen enthält, kann dieser als MapExternalName angegeben werden.
Als Field -Name kann ein Alias-Name ohne Sonderzeichen angegeben werden.

MapFrameDocumentDate

1)|Speichert das gelesene Dokumentendatum als FrameValue2)

MapFrameDocumentNumber

3)|Speichert die gelesene Dokumentnummer als FrameValue.4)

MapFrameDocumentRecipient

5)|Speichert die gelesene Dokumentempfänger-Daten als FrameValue.6)

MapFrameDocumentSender

7)|Speichert die gelesenen Dokumentsender-Daten als FrameValue.8)

MapFrameInterchangeRecipient

9)|Speichert die gelesenen Interchangeempfänger-Daten als FrameValue,
damit dieses beim Analysieren eines Dokuments abgerufen und von eBiss ausgewertet werden können.

MapFrameInterchangeReference

10) Speichert die gelesene Interchange-Referenznummer als FrameValue.11)

MapFrameInterchangeSender

12) Speichert die gelesenen Interchangesender-Daten als FrameValue.13)

MapFormat

Formatiert ein NullableNumeric oder DateTime Feld für die Ausgabe.

Parameter:

  1. mandatory: string formatString : Formatierung wie z.B. „#.00“.
  2. optional: MapFormatScope.Read od. .Write od. .ReadWrite : Deklariert wann formatiert werden soll.
  3. optional:bool InvariantCulture : true erzwingt die Formatierung gemäß der InvariantCulture, unabhängig von den lokalen Formatierungseinstellungen, false oder Weglassen des Parameters verwendet die lokalen Formatierungseinstellungen des Computers, auf dem eBiss läuft.

Beispiele:

[MapFormat("###.000", MapFormatScope.Write, true)]

formatiert den NullableNumeric-Wert 102.50 in dem Feld beim Schreiben zu „102.500“.

[MapFormat("###.000", MapFormatScope.Write)]

Formatiert den NullableNumeric-Wert 102.50 in dem Feld beim Schreiben zu „102,500“.

[MapFormat("###.000", MapFormatScope.Read)]

formatiert den NullableNumeric-Wert 102.50 in dem Feld beim Einlesen zu „102,500“.

[MapFormat("{0,-20:0.000}")]

Ausgabe des numerischen Wertes in einer Breite von 20 Zeichen, linksbündig, mit 3 Nachkommastellen (Verwendung u.a. für den FixedLengthWriter).

[MapFormat("{0,20:0.0}")]

Ausgabe des numerischen Wertes in einer Breite von 20 Zeichen, rechtsbündig, mit einer Nachkommastelle (verwendung u.a. für den FixedLengthWriter).

[MapFormat("dd.MM.YY")]

Formatiert den Datumswert.

Hinweis: Soll der Wert eines String-Feldes im Zielobjekt formatiert werden, muss dies im Mapping durch die Funktion FormatNumber oder CustomNumberFormat erfolgen.

MapIgnore

Field wird beim Lesen eines Dokuments nicht mit Daten gefüllt, oder wird beim Erzeugen von Dokumenten nicht geschrieben.

MapIgnore(MapIgnoreScope.OnRead)

MapIgnoreBase

Basisklasse ignorieren. Wird kein Parameter ( bool b ) angegeben, so ist der Defaultwert auf true gesetzt.

MapInterchangeRecordAttribute

FIXME

MapListType(typeof("Klassenname"))

Wird benötigt, falls Dokumente mehrfach Werte des gleichen Datenelements enthalten14).

MapMinOccurs(1)

MapMinOccurs(1) ist per default auf 1 gesetzt wenn kein Parameter angegeben wird und bedeutet, daß diese Liste mind. einmal im Order-Objekt enthalten ist.

MapRequired

Feld muss beim Lesen eines Dokuments mit Daten gefüllt werden, sonst wird eine Fehlermeldung angezeigt. Beim Schreiben muss das Zielfeld zwingend bedient werden.

MapSize

MapSize gibt die Länge in Zeichen (Fixed Length in Byte) an.

MapSupressRecordTag

Wird z.Bsp. bei CSV Dateien ohne Zeilentypen angewendet.

MapTrigger

Hilfsattribut, um den Anfang des nächsten Dokuments zu triggern.
Hinweis: Wird benötigt, wenn mehrere Dokumenten innerhalb eines Anhangs enthalten sind.

MapXmlHandling

Attribut zum Steuern des XmlWriters.

Beispiel:

[MapIgnore(MapIgnoreScope.OnRead), MapXmlHandling(MapXmlHandlingAttribute.HandlingType.AsAttribute)]
        public string xmlns = "http://schemas.microsoft.com/dynamics/2011/01/documents/Message";

MapXmlNamespaceAttribute("Xml Namensraum Präfix", ".NET Namensraum")

Erlaubt das Abbilden eines .NET Namensraums auf einen XML Namensraum. Wird eine Klasse mit dem Attribut versehen, so werden alle Felder im Namensraum dieser Klasse (beim Lesen und Schreiben) mit dem zugehörigen Präfix versehen. Standardmäßig werden nur Elemente (Tags) voll qualifiziert, dieses Verhalten kann aber über die verschiedenen Konstruktoren des MapXmlNamespaceAttributes beeinflusst werden.

MapXmlNamespaceIgnoreAttribute

Die o.g. Funktionalität des MapXmlNamespaceAttributes wird für das mit diesem Attribut markierten Feld ausgesetzt.

MapXmlNamespacePrefixAttribute("Präfix")

Alernativ zu der o.g. Funktionalität des MapXmlNamespaceAttributes können mit diesem Attribut individuelle Felder mit einem XML Namensraum-Präfix versehen werden.

MapXPathExpression

Ein so markiertes Feld wird über den X-Path Ausdruck befüllt und sollte im Zusammenhang mit MapIgnore(MapIgnoreScope.OnReadWrite) verwendet werden.

Beispiel:

        [MapIgnore(MapIgnoreScope.OnReadWrite), MapXPathExpression("Addresses[@Kind='RCPT']/@ILN"), MapFrameDocumentRecipient]
        public string Sender{get; set; }
 
        public List<MapXPathExpressionSampleAddress> Addresses { get; set; }

Hinweis: Wird nur vom XML- und FlatFile Analyzer ausgewertet.

NotMapped

Ein mit diesem Attribut ausgestattetes Datenelement steht im Mapping nicht zur Verfügung und wird auch nicht im DbAdapter verwendet.

1) , 3) , 5) , 7) , 10)
Hinweis: Ändert sich der attributierte Wert zwischen den Dokumenten, wird ein neuer Container erzeugt.
2) , 4) , 6) , 8) , 11) , 13)
Kann beim Analysieren eines Dokuments abgerufen und von eBiss ausgewertet werden.
9)
analog MapFrameDocumentRecipient
12)
analog MapFrameDocumentSender
14)
z.Bsp. Items
15)
Wenn beim XML-Writer das XML-Verhalten = „Feld als Text“ eingestellt ist
16)
BeispieL: <semiramis xmlns=„com.cisag.app.purchasing.obj.PurchaseContract“ xsi:schemaLocation=„com.cisag.app.purchasing.obj.PurchaseContract PurchaseContract.xsd“ created=„“ locale=„en-US-XMLSchemaCompliant“ xmlns:xsi=„http://www.w3.org/2001/XMLSchema-instance“ nlsMode=„SINGLE_LANGUAGE“ dateTimeMode=„COMPACT“>
17)
Beispiel: <beginDate mark=„“ mode=„“ invalid=„“>2020-03-09T00:00:00.0000000+01:00</beginDate>