# Structure element properties

Generally when adding a new element, the properties associated with is are configured automatically and correctly, but you can edit them if needed.

## General properties

| Property | Description |
| --- | --- |
| Name | Name of the element. For XML structures, you can specify a namespace<br>prefix using the following syntax:<br>prefix:name. |
| Description | Short description of the element. This<br>description is displayed next to the element name in the editor.<br>![](https://help.qlik.com/talend/en-US/data-mapper-user-guide/Resources/images/structure_element_properties_1_description.png) |
| Occurs<br>Min/Max | Minimum and maximum number of times the element can appear in a<br>document. For example, you can enter 1 in the<br>Min field to indicate an element is<br>mandatory. If the number is unlimited, enter<br>-1. |
| Size<br>Min/Max | Minimum and maximum number of characters in the element. |
| Group<br>Type | Indicates how the children of this element are grouped. The value can be:<br><br><ul> <li> <kbd>None</kbd>:  this element contains text										only; it has no child elements that define additional										structure. </li> <li> <kbd>Sequence</kbd>: all children must occur (if										they occur) in the order specified. </li> <li> <kbd>Choice</kbd>: only one of the children can										occur. If the element loops, a different child element can										occur for each instance of the loop. </li> <li> <kbd>All</kbd>: all of the elements must occur,										and they can occur in any order.</li> </ul> |
| Data<br>Type | Type of text content for the element. The value can be:<br><br><ul> <li> <kbd>String</kbd>: character										string. </li> <li> <kbd>Byte (8)</kbd>: signed 8-bit										byte. </li> <li> <kbd>Character</kbd>:</li> <li> <kbd>Short (16)</kbd>: signed										16-bit quantity. </li> <li> <kbd>Integer (32)</kbd>:  signed										32-bit quantity. </li> <li> <kbd>Long (64)</kbd>: signed										64-bit quantity. </li> <li> <kbd>Unsigned Byte (8)</kbd>: unsigned 8-bit byte.</li> <li> <kbd>Unsigned Short (16)</kbd>: unsigned 16-bit quantity.</li> <li> <kbd>Unsigned Integer (32)</kbd>: unsigned 32-bit quantity.</li> <li> <kbd>Decimal</kbd>:</li> <li> <kbd>Float (32)</kbd>: 32-bit										floating-point number. </li> <li> <kbd>Double (64)</kbd>: 64-bit										floating-point number. </li> <li> <kbd>Date/Time</kbd>: date and										time value together. This includes the timezone information. </li> <li> <kbd>Date</kbd>: date value. </li> <li> <kbd>Time</kbd>: time value. </li> <li> <kbd>Boolean</kbd>: either true										or false. </li> <li> <kbd>Duration</kbd>: duration of										time. This is in the ISO 8601 format of <kbd>PnYnMnDTnHnMnS</kbd>. It must										begin with a <kbd>P</kbd>, and										the remaining capital letters identify the type of the										period. The capital letters can be omitted when the										corresponding period is not used. Examples: <kbd>P4Y</kbd> is 4 years; <kbd>P6Y7M2D</kbd> is 6 years, 7										months, and 2 days; P30S is 30 seconds. </li> <li> <kbd>Binary</kbd>: binary value. </li> <li> <kbd>QName</kbd>: qualified name										with an optional prefix and local name. The prefix must be										found in one of the XML Namespaces and Containers associated										with the structure. It is used only in the <span>Constant</span> function. </li> <li> <kbd>None</kbd>: </li> </ul> |
| Element<br>Type | Defines how this element is used in a document. This is mostly<br>relevant for XML documents. The value can be:<br><br><ul> <li> <kbd>Standard</kbd>: element with no special										treatment (e.g., a standard XML element). For XML documents,										the value of the element refers to the value of all text										included within the element, provided there are no child										elements. When you want to access mixed content, you must										use an element type of XML Text to access the text between										the child XML elements. </li> <li> <kbd>XML Attribute</kbd> (XML documents only):										the element appears as an XML attribute. Child elements of										this type must be of type <kbd>value</kbd>. </li> <li> <kbd>XML Processing Instruction</kbd> (XML										documents only): the element appears as an XML processing										instruction. Elements of this type cannot have child										elements. </li> <li> <kbd>XML Text</kbd> (XML documents only): This										element accesses text values, which is necessary only when										accessing text values for mixed XML content, where text is										interleaved with XML elements. Elements of this type cannot										have child elements. </li> <li> <kbd>Value</kbd>: this element's name is used to										match the text value of its enclosing element. This is used										to define possible code values for validation and mapping										purposes. An element will have a child element with element										type of <kbd>Value</kbd> for each possible code										value. Elements of this type cannot have child elements. </li> <li> <kbd>Any</kbd>: the content of this element can										be any collection of elements, which are completely										unspecified. Elements of this type cannot have child										elements. </li> </ul> |
| Data<br>Format | Describes how the data type is to be concretely manifested. The options<br>available depend on the Data Type you selected. The<br>Default option automatically selects the default<br>format for the data type standard. For example, the default format for a<br>DateTime element is ISO 8601.<br><br>In the output, the time format<br>HHMMSSDD includes the offset if it is specified in<br>the input. For example, the 01:02:03+01:00 input becomes<br>010203+01:00 in the output. |
| Visible<br>Group | Indicates if this element is visible in the document. |
| Null | Indicates if this element can have a null value. |

## Flat structure properties

| Property | Description |
| --- | --- |
| Initiator | Sequence of characters that signals the start of this element. |
| Terminator | Sequence of characters that signals the end of this element. |
| Include<br>Initiator? | Indicates if the initiator should be included as part of the text<br>value of the element. |
| Include<br>Terminator? | Indicates if the terminator should be included as part of the text<br>value of the element. |
| Start<br>Offset | Number of characters to skip before starting this element. |
| Column | Indicates the column where the element starts. |
| Quote<br>Handling | This provides pre-defined options for handling possible quotation<br>marks around elements. The value can be:<br><br><ul> <li> <kbd>None</kbd>: no special handling for quotation marks.</li> <li> <kbd>OptionalQuotes</kbd>: double quotation marks may be present or absent										for this element. If they are present, they bound the										element, and they are not included in the data. If they are										absent, the element is bounded by the normal initiator or										terminator.</li> <li> <kbd>RequiredQuotes</kbd>: double quotation marks must be present for each										element. If they are missing, an error occurs.</li> </ul> |
| Release | Defines the single character that causes an initiator or terminator<br>not to be recognized. For example, if the terminator character is a<br>double quote, and you specify a backslash as the release character,<br>you can include a double quote within the value of the element by<br>preceding it with a backslash. |
| EDI Elem<br>Type | Defines the type of EDI element represented by this element. The value<br>can be:<br><br><ul> <li> <kbd>None</kbd>: this is not an										EDI element. </li> <li> <kbd>Transaction</kbd>: the root										element of a transaction. This defines the transaction. The										name of this element is the name of the EDI transaction,											<kbd>832</kbd> or <kbd>PRICAT</kbd> for example. </li> <li> <kbd>Segment</kbd>: defines an										EDI segment. The name of this element is the segment and										must be less than or equal to three characters, <kbd>DTM</kbd> for example. </li> <li> <kbd>Element</kbd>: defines an										EDI element. The name of this element is the name of the										enclosing segment and is followed by the two digit sequence										number of the segment, <kbd>DTM02</kbd> for example. </li> <li> <kbd>Composite</kbd>: defines an										EDI composite. If the parent of the composite is an EDI										segment, the name of the composite follows the same										convention as that for an EDI element. If the parent of the										composite is an EDI element, the name of the composite is										the name of the element followed by a hyphen and a two digit										sequence number, <kbd>SEG05-01</kbd> for example. </li> <li> <kbd>Loop</kbd>: defines an EDI										loop. The name of this element must start with <kbd>Loop-</kbd>. </li> <li> <kbd>Code Value Part</kbd>: used										when a code value has two parts to it. One element defines										each of the parts of the code value. </li> </ul> |
| EDI Elem<br>Ref | Defines the EDI data element reference number. |

## Inheritance properties

| Property | Description |
| --- | --- |
| Inherits<br>From | Specifies the structure from which this element inherits. |
| Inherited<br>Root | Specifies how to reconcile the root element from the parent structure<br>with this element. The value can be:<br><br><ul> <li> <span>Use Only Children</span>:										only the properties from the child elements are included in										the child structure under this element. The properties of										the root element of the parent (inherited) structure are										ignored. </li> <li> <span>Use Everything</span>: the										element properties of the current element are ignored, and										all of its properties are inherited from the root element of										the parent (inherited) structure. </li> <li> <span>Use All Except											Name/Occurs</span>: all properties of the root										element of the parent (inherited) structure are inherited,										except for the name, description, and occurs properties.										These properties are defined by this element in the child										structure. This corresponds to the type of inheritance										defined in XML Schema by a particle. </li> </ul> |
| Ignore Inherited<br>Adds? | Indicates if new elements added in the parent structure should be<br>propagated to this element. |
| Use Children<br>Of | For recursive elements, this property allows you to use the same<br>content as the parent element. |

## EDI properties

| Property | Description |
| --- | --- |
| Syntax<br>Rules | For EDI elements, this property defines the valid combinations of<br>required elements for that segment |
| Sequence<br>Id | For EDI elements, this property defines the sequence number of this<br>element, in the nn format. |

## Other properties

| Property | Description |
| --- | --- |
| XPath Name | Allows you to define the XPath corresponding to entries of this<br>element. You can use the following expressions:<br><br><ul> <li>A node name, <span>item/price</span> for example.</li> <li>A node name with a predicate defining the										value of a child, <span>item[price&gt;1]</span> for example.</li> <li>A node name with a predicate defining the										value of an attribute, <span>item[@status='available']</span>.</li> <li>A node name with a predicate using a										function, <span>item[fn:position()&gt;3]</span> for example.</li> <li>An axis, <span>child::*</span> for example.</li> </ul><br><br>If the structure has namespaces, they need to be added as a<br>prefix for each element.<br><br>If you are using this property<br>with a representation other than XML, you need to prefix each<br>element with the name of the representation,<br>JSON:item/JSON:price.<br><br>For more information about how to use this<br>property, see [Mapping an XML structure with dynamic elements](https://help.qlik.com/talend/en-US/data-mapper-user-guide/8.0/mapping-xml-structure-with-dynamic-elements)<br>and [Filtering structure elements](https://help.qlik.com/talend/en-US/data-mapper-user-guide/8.0/filtering-structure-elements). |
| Text | Allows you to document the element. You can select a type of text in<br>the drop-down list and enter your text in the field below. |
| External<br>name | Allows the processing of element names that include characters not<br>supported in the element name, such as spaces or<br>$. |