XML

Example

<?xml version="1.0" encoding="UTF-8"?>
<Sync xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="sync.xsd">
	<Entity mainType="Package" customType="Feature" typeVersion="1.0">
		<Property name="redmine_feature_id" isIdentity="true">
			<Value>58</Value>
		</Property>
		<Property name="release.system_name">
			<Value>REL-2011-01</Value>
		</Property>
		<Property name="email_property">
			<Value>john.doe@example.com John Doe</Value>
		</Property>
		<Property name="date_property">
			<Value>2011-02-20T17:35:00Z</Value>
		</Property>
		<Property name="multi_value_property">
			<Value>Value1#;#Value2#;#Value3</Value>
		</Property>
	</Entity>
</Sync>

Description

  • Entity (element)

    A single entity

  • mainType

    The main type of this entity

  • customType

    The custom type of this entity. Some main types (for example, PackageRelation) do not have a custom type. In these cases you do not have to specify the custom_type attribute.

  • typeVersion

    The custom type version of this entity. When importing types, you can omit the type version.

  • Property (Element)

    One or more properties of this entity

  • name

    The name of the property. Use the dot notation to access related entities (see: Serialization)

  • isIdentity

    If the property is used to uniquely identify the entity.

  • Value (Element)

    The values of the property.

    Dates have to be UTC ISO 8601 formatted.

    Floats decimal separator is a dot (.)

    Integers contain only numbers and at max one minus sign, no thousand separators

Property type serialization

  • Single line text

    string

  • Short text

    string

  • Long Text

    string

  • Single Choice

    string

  • Multi Choice

    The selected choices are separated by "#;#"

  • Integer

    Only integers and at max one minus sign, no thousand separators

  • Float

    Decimal separator is a dot (.)

  • Date

    ISO 8601

  • Time

    ISO 8601

  • Checkbox

    "true" or "false"

  • E-Mail

    Space separated

    (for example "example@example.org My Mail")

  • URL

    Space separated
    (for example "http://example.com My URL")

  • File

    Cannot be serialized

  • Identity

    string