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

You use the JSON write component to write messages to [[http://json.org/|JSON]]-Format.

==== Configurations ====

In addition to the standard settings such as name and character encoding, you can set the following options for the JSON file:
  * **Indent**: Indents the attributes for better readability.
  * **Length of the object namespace**: Defines whether and how the class name is to be written as a JSON root object. 
    * **Default**: No root object is created
    * **Short**: The class name is created as a JSON root object.
    * **Long**: The full namespace is created as a JSON root object.

==== Formatting date values ====

Date values are exported in the format **yyy-MM-ddTHH:mm:ss.FFFFFFFK**. Using the MapFormat attribute (see [[en:transformation:mappings:objektdefinition:attribute:standardobject|]]) 
you can change the format. E.g. with
  * MapFormat("yyyy-MM-dd")
the date values are output in year-month-day format. 
This only applies if the **Legacy Json Writer** has not been configured under **TypeName**. 


~~ GENERATED src="eBiss.Data.Resources.JsonWriterConfig" changed="" ~~
^Properties^^
^Name^Description^
|**Name**|The name of the writer|
|**Writer config type name**|System name of write component|
|**Character encoding**|The default encoding to use((Possible values are: [ascii][utf-7][utf-8][windows-1252][windows-1250][utf-16][iso-8859-1][1000-MAC Roman][ibm852][ibm855][ISO-2022-jp][cp850]))|
|**Indent**|
|**Write Type**|Should type information be written|
|**Null Values**|How to write missing values (zero values)|
|**Leere Listen**|Definition der Ausgabe von leeren Listen|
|**Leere Referenzen schreiben (null)**|Wenn angegen, dann werden leere Referenzen als '..:null' geschrieben|
|**Change logs**|The changes to the element are logged. The logging is activated in the [[en:hauptmenue:einstellungen:systemeinstellungen]], which is possible if a versioning license is available.|

{{:images:sign_warning.png?nolink|}}**Note:** : If a data element is to be output as a **JSON string array**((JSON string array example:<code>["red", "green", "blue"]</code>)) the data element itself must be defined as a complex type with a child element as a simple type.
On the complex type the attribute **ExportType** with the value **AsValueList** must be defined. The child element inside is defined as a string and can have any((The data element name will not be visible in the created array.)) name.