====== JSON ======

Mit der JSON Schreibkomponente schreiben Sie Nachrichten in das [[http://json.org/|JSON]]-Format.

==== Konfiguration ====

Neben den Standardeinstellungen wie z.B. Name, Zeichenkodierung, stellen sie für die JSON Datei folgende Optionen ein:
  * **Indent**: Rückt die Attribute zur besseren Lesbarkeit ein.
  * **Länge des Objektnamensraum**: Definiert, ob und wie der Klassenname als JSON Root Objekt geschrieben werden soll. 
    * **Default**: Es wird kein Root Objekt erstellt
    * **Short**: Der Klassenname wird als JSON Root Objekt erstellt
    * **Long**: Der volle Namensraum wird als JSON Root Objekt erstellt

==== Formatieren von Datumswerten ====

Datumswerte werden im Format **yyyy-MM-ddTHH:mm:ss.FFFFFFFK** exportiert. Mittels des MapFormat Attributs (s. [[transformation:mappings:objektdefinition:attribute:standardobject|]]) 
kann man das Format ändern. Z.B. mit
  * MapFormat("yyyy-MM-dd")
werden die Datumswerte im Jahr-Monat-Tag Format ausgegeben. 
Das gilt nur, wenn unter **Typenamen** nicht der **Legacy Json Writer** konfiguriert wurde. 

~~ GENERATED src="eBiss.Data.Resources.JsonWriterConfig.de" changed="" ~~
^Eigenschaften^^
^Name^Beschreibung^
|**Name**|Der Name der Schreibkomponente|
|**Typ der Schreibkomponente**|Systemname der Schreibkomponente|
|**Zeichenkodierung**|Die standardmässig zu verwendende Kodierung.((Mögliche Wert sind: [ascii][utf-7][utf-8][windows-1252][windows-1250][utf-16][iso-8859-1][1000-MAC Roman][ibm852][ibm855][ISO-2022-jp][cp850]))|
|**Indent**|
|**Typenamen**|Sollen Typinformationen geschrieben werden|
|**Fehlende Werte**|Wie sollen fehlende Werte (null-Werte) geschrieben werden|
|**Empty lists**|Definition of the output of empty lists|
|**Write empty references (null)**|If set, empty references are written as '..:null'.|
|**Änderungsprotokoll**|Es werden die Änderungen an dem Element protokolliert. Die Protokollierung wird in den [[hauptmenue:einstellungen:systemeinstellungen|Systemeinstellungen]] aktiviert, was bei einer vorhanden Versionierungslizenz möglich ist.|


{{:images:sign_warning.png?nolink|}}**Hinweis:** : Soll ein Datenelement als **JSON String Array**((JSON String Array Beispiel:<code>["rot", "grün", "blau"]</code>)) ausgegeben werden muss das Datenelement selbst als komplexer Typ mit einem einfachen Kindelement als einfacher Typ definiert sein.
Auf dem komplexen Typ muss noch das Attribut **ExportType** mit dem Wert **AsValueList** definiert werden. Das darin befindliche Kindelement wird als String definiert und kann einen beliebigen((Der Datenelementnamen wird im erzeugten Array nicht sichtbar.)) Namen haben.