The following tables define the properties for the XML Wire Format for the message set.
Property | Type | Meaning |
---|---|---|
Namespace URI | String | Enter the name of the namespace that you are using for the associated prefix. |
Prefix | String | Enter the prefix to associate the element and attribute names that you use it with to the namespace name. |
Property | Type | Meaning |
---|---|---|
Namespace URI | String | Enter the namespace name that identifies which namespace you are using. |
Schema location | String | Enter the location of the schema for the associated namespace name that is used to validate objects within the namespace. |
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. By default, the check box is cleared. |
XML Version | Enumerated type | This controls the value of the version in the generated
XML declaration. The default is 1.0. If you set Suppress XML Declaration to Yes, this property is ignored. |
XML Encoding | Enumerated type | This controls whether an encoding attribute is written
in the generated XML declaration. If Null is selected, no encoding attribute is written in the XML declaration of the output XML document. If As document text is selected, an encoding attribute is generated that is consistent with the text in the XML document. The default is Null. If the Suppress XML Declaration check box is selected, this property is ignored. |
Standalone Document | Enumerated type | Select Yes, No, or Null from
the list of values. If you select Null,
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 default
value is Null. The setting of this property does not determine whether an external DTD subset is loaded; external DTD subsets are never loaded in this release. If the Suppress XML Declaration check box is selected, this property is ignored. |
Output Namespace Declaration | Enumerated type | The Output Namespace
Declaration property controls where the namespace declarations
are placed in the output XML document. Select from:
The default option is At start of document. This property is active only if namespaces are enabled for this message set. |
Property | Type | Meaning |
---|---|---|
Suppress DOCTYPE | Check box | If you select the check box, the DOCTYPE (DTD) declaration
is suppressed. By default, the check box is selected. |
DOCTYPE System ID | String | Specify the System ID for DOCTYPE external DTD subset
(if DOCTYPE is present). This is typically 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, therefore, it might not be valid XML.
You can include ENTITY definitions or internal DTD declarations. It is a string
(up to 32 KB) 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 MRM XML: In-line DTDs and the DOCTYPE text property. The default value is empty (not set). |
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. |
Property | Type | Meaning |
---|---|---|
Encoding Numeric Null | Enumerated type | Specify the null encoding for numeric XML elements.
This provides a method of assigning a logical null meaning to such elements.
You must select one of the following values from the list shown:
|
Encoding Numeric Null Value | String | Specify the value to qualify the Encoding Numeric Null property, if you have set that to NULLValue, NULLAttribute, or NULLElement. Refer to XML Null handling options for further information. |
Encoding Non-Numeric Null | Enumerated type | Specify the null encoding for non-numeric XML elements. This provides a method of assigning a logical null meaning to such elements. The options are identical to those available for property Encoding Numeric Null. |
Encoding Non-Numeric Null Value | String | Specify the value to qualify the Encoding Non-Numeric Null property. Refer to XML Null handling options for further information. |
Property | Type | Meaning |
---|---|---|
Derive default dateTime format from logical type | Button | Select this option if you want the default dateTime
format to be determined by the logical type of the element or attribute. You can override this property for an element or attribute within a complex type. |
Use default dateTime format | Button and String | Select this option if you want to specify a default
dateTime format that is fixed for all elements or attributes of logical type
dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay, and gDay. You can override this property for an element or attribute within a complex type. For more information, see DateTime formats. |
Start of century for 2 digit years | 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. |
Days in First Week of Year | Enumerated | Specify the number of days of the new year that must
fall within the first week. The start of a year typically 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; therefore, week 1 starts some days into the new year. Otherwise, it is considered to be the first week of the new year; in this case, 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 list that is displayed. |
First Day Of Week | Enumerated | 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 list that is displayed. |
Strict DateTime Checking | Check box | Select this option if you want to restrict dateTimes
to a valid dateTime format. If Strict DateTime
Checking is selected, receiving an incorrect dateTime causes an error.
|
Time Zone | Enumerated | 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 property by selecting from the list of values. |
Daylight Savings Time | Check box | Select this option if the area in the Time
Zone property observes Daylight Saving Time. If it does not observe
Daylight Saving Time, do not select this option. For example, if an area is selected in Time Zone and this option is not selected, the value passed represents the time zone without the Daylight Saving Time. |
Use input UTC format on output | Check box | This property applies to elements and attributes of
logical type xsd:dateTime or xsd:time that have a dateTime format of I, IU,
T, or TU, or that include ZZZ or ZZZU. Such elements and attributes can specify Coordinated Universal Time (UTC) by using either the Z character or timezone +00:00 in the value. On input, the MRM parser remembers the way that UTC was specified. If this property is selected, and the element or attribute is copied to an output message, the UTC format is preserved into the output message and overrides the format that is implied by the dateTime format property. If this property is cleared, or the element or attribute was not copied from an input message, the UTC format in the output message is controlled solely by the dateTime format property. |
Property | Type | Meaning |
---|---|---|
Output policy for xsi:type attributes | Enumerated type | When writing XML documents, this property allows you to specify the circumstances under which the xsi:type attribute of elements will be output.
|
If an xsi:type attribute needs to be output, but does not appear in the message tree, its value will be generated as follows:
Element type | Value generated when element is defined in model | Value generated when element is self-defining |
---|---|---|
Simple type | If the type is global or is a built-in type, use it. If the type is local, use the global or built-in type from which it is derived. |
Use the built-in type which best matches the data type of the element in the message tree. |
Complex type with simple content | If the type is global use it. If the type is local, use the global or built-in type from which it is derived. |
Use the built-in type which best matches the data type of the element in the message tree. |
Complex type with complex content | If the type is global use it. If the type is local, no xsi:type attribute is output. |
No xsi:type attribute is output. |
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 blank. |
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 | 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 should ensure that this check box is not selected. |