XML Wire Format message set properties

The tables below define the properties for the XML Wire Format for the message set.

Namespace settings

Property Type Meaning
Namespace URI String Enter the namespace name that will identify which namespace you are using for the associated prefix.
Prefix String Enter the prefix to associate the element and attribute names you use it with to the namespace name.

Namespace schema locations

Property Type Meaning
Namespace URI String Enter the namespace name that will identify which namespace you are using.
Schema location String Enter the location of the schema for the associated namespace name that will be used to validate objects within the namespace.

XML declarations

Property Type Meaning
Suppress XML Declaration Check box Select the check box to suppress the XML declaration. If selected, the declaration (for example, <?xml version='1.0'>) is suppressed.
Standalone Document Enumerated Type Select Yes, No, or Null from the drop-down list. If Null is selected, no standalone declaration is present in the XML declaration. If you select Yes or No, the declaration standalone = "yes" or standalone = "no" is added to the XML declaration when the output message is written.

The setting of this property does not determine if an external DTD subset is loaded: external DTD subsets are never loaded in this release.

If you set Suppress XML Declaration to Yes, this property is ignored.

Output Namespace Declaration Enumerated Type The Output Namespace Declaration property controls where the namespace declarations will placed in the output XML document. Select from:
  • At start of document. Declarations for all of the entries in the Namespace schema locations table above will be output as attributes of the message in the output XML document. The disadvantage of this option is that in some cases unnecessary declarations may be output.
  • As required. Declarations will only be output when required by an element or attribute that is in that namespace. The disadvantage of this option is that the same namespace declaration may need to be output more than once in the output XML document.

The default option is At start of document.

This property is only active if namespaces are enabled for this message set.

XML document type settings

Property Type Meaning
Suppress DOCTYPE Check box If you select the check box, the DOCTYPE (DTD) declaration is suppressed.
DOCTYPE System ID String Specify the System ID for DOCTYPE external DTD subset (if DOCTYPE is present). This is normally set to the name of the generated (or imported) DTD for a message set.

If Suppress DOCTYPE is set, this property is ignored and cannot be changed (the field is disabled). The default value is www.mrmnames.net/ followed by the message set identifier.

DOCTYPE Public ID String Specify the Public ID for DOCTYPE external DTD subset (if DOCTYPE is present, and System ID is specified).

If Suppress DOCTYPE is set, this property is ignored and cannot be changed (the field is disabled). The default value is the message set identifier.

DOCTYPE Text String Use this property to add additional DTD declarations. It is not parsed by the XML parser and thus it might not be valid XML. You can include ENTITY definitions or internal DTD declarations. It is a string (up to 32KB) in which new line and tab characters are replaced by \n and \t respectively.

The content is not parsed, and appears in the output message. If there is an in-line DTD, the content of this property takes precedence.

If you have set Suppress DOCTYPE, this property is ignored and cannot be changed (the field is disabled).

For more information, see In-line DTDs and the DOCTYPE text property.

The default value is empty (not set).

Root Tag Name

Property Type Meaning
Root Tag Name String Specify the name of the message set root tag. You can leave this property blank, in which case no wrapper tags are used for messages (that is, the message tag is the root of the document). The name can be followed by a space and additional text for attribute/value pairs to appear with the root tag.

The default value is MRM.

Suppress Timestamp Comment

Property Type Meaning
Suppress Timestamp Comment Check box If selected, the timestamp comment string in the XML output is suppressed.

If not selected, the comment is not suppressed, and a comment of the form <!--MRM Generated XML Output on: Tue Apr 23 09:34:42 2002--> is included in the output message.

The default is for the check box to be selected.

Enable Versioning Support

Property Type Meaning
Enable Versioning Support Check box If this is selected, versioning support is enabled. This property specifies whether XML namespace definitions are coded for the root tag in the message, together with namespace qualifiers for any elements that do not belong to the default namespace. These namespace definitions are used to represent the message set dependency information, which is used to support the exchange of messages between applications that are based on different customizations of the same message set.

The default is for the check box to be selected, for compatibility with MRM XML messages in earlier releases. If you did not use MRM XML messages in earlier releases, you are strongly recommended to ensure this check box is not selected.

XML representation of boolean values

Property Type Meaning
Boolean True Value String Specify the string that is used to encode and recognize BOOLEAN true values. When an XML document is parsed, the string 1 is always accepted as true for a BOOLEAN element. Enter a string of up to 254 characters.

The default is true. 1 is also valid.

Boolean False Value String Specify the string that is used to encode and recognize BOOLEAN false values. When an XML document is parsed, the string 0 is always accepted as false for a BOOLEAN element. Enter a string of up to 254 characters.

The default is false. 0 is also valid.

XML representation of null values

Property Type Meaning
Encoding Numeric Null Enumerated Type Specify the null encoding for numeric fields. This provides a method of affirming by comparison that the element is null. You must select one of the following values from the drop-down list:
  • NULLEmpty. The empty string is used as the comparison. This is the default value.
  • NULLAttribute. The property Encoding Null Num Val of the parent element is used.
  • NULLValue. The value of property Encoding Null Num Val is used.
  • NULLElement. The property Encoding Null Num Val of the child element is used.
  • NULLValAttr. This option is valid only for elements instantiated in a complex type with property Member Render set to XMLElementAttrVal or XMLElementAttrIDVal.
See XML Null handling options for full details.
Encoding Numeric Null Value String Specify the value to qualify the Encoding Null Num property, if you have set that to NULLAttribute, NULLValue, or NULLElement. Refer to XML Null handling options for further information.
Encoding Non-Numeric Null Enumerated Type Specify the null encoding for non numeric fields. This is a method of affirming that the element is null. The options are identical to those available for property Encoding Null Num.
Encoding Non-Numeric Null Value String Specify the value to qualify the Encoding Null Non-Num property. Refer to XML Null handling options for further information.

DateTime settings

Property Type Meaning
Derive default dateTime format from logical type Button Select this option if the dateTime format that will be used is to be taken from the dateTime format specified in the properties of an object that has one of the dateTime types. For example, a type gDay.
Use default dateTime Format Button and dateTime Select this option if you want to specify a dateTime format that is different from the logical dateTime format.

Specify the default format for objects of type dateTime for this physical format. You can override this property for a dateTime object within a complex type.

The initial value for this property is yyyy-MM-dd'T'HH:mm:ssZZZ, which you can change by over-typing.

For more information about dateTime formats, see DateTime formats.

Century Window Integer This property determines how two-digit years are interpreted. Specify the two digits that start a 100-year window that contains the current year. For example, if you specify 89, and the current year is 2002, all two-digit dates are interpreted as being in the range 1989 to 2088.

The initial value is 53, which you can change by over-typing.

Days in First Week of Year Enumerated Type Specify the number of days of the new year that must fall within the first week.

The start of a year usually falls in the middle of a week. If the number of days in that week is less than the value specified here, the week is considered to be the last week of the previous year; hence week 1 starts some days into the new year. Otherwise it is considered to be the first week of the new year; hence week 1 starts some days before the new year.

Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a number from the drop-down list. The initial value is 4.

First Day of Week Enumerated Type Specify the day on which each new week starts.

Select Use Broker Locale, which causes the broker to get the information from the underlying platform, or select a value from the drop-down list. The initial value is Monday.

Strict DateTime Checking Check box Select this option if you want to restrict dateTimes to a valid dateTime format. This will not allow 35th March to be processed as 4th April, and 10:79 to be processed as 11:19. If Strict DateTime Checking is set, receiving an incorrect dateTime will cause an error. The default is to not to restrict dateTimes.
Time Zone Enumerated Type The value that you set for this property is used if the value that you specified for the Default DateTime Format property does not include Time Zone information.

The initial value is Use Broker Locale which causes the broker to get the information from the underlying platform.

You can change this using the drop down box.

Daylight Savings Time Check box Select this option if the area in the Time Zone property observes daylight savings time. If it does not observe daylight savings time, this option should not be selected.

For example, if an area is selected in Time Zone and this option is not selected, the value passed will represent the time zone without the daylight savings time.

Default is not to observe daylight savings time.

Related concepts
Physical formats in the MRM domain
XML wire format

Related tasks
Working with physical properties

Related reference
Message set properties
Custom Wire Format message set properties
In-line DTDs and the DOCTYPE text property
TDS Format message set properties
Documentation properties for all message set objects