<customXmlDelRangeStart> (Custom XML Markup Deletion Start)

This element specifies the beginning of a region in which all custom XML markup has been deleted and tracked as a revision. The @id attribute on this element shall be used to link this element with the corresponding custom XML markup deletion end marker in the document.

Providing a physical representation of custom XML markup results in regions which can be inserted and deleted, but cannot be encapsulated by a single revision element, since their representation in WordprocessingML is the start or end XML tag for the custom XML markup which it represents. Therefore, the start/end "cross structure" annotation format surrounds the WordprocessingML region to which this deletion applies.

The following restrictions shall be applied to this element:

  • If this element occurs without a corresponding <customXmlDelRangeEnd> element (§2.13.5.4) with a matching @id attribute value, then this revision is ill-formed, and the revision may be ignored or all custom XML from this point forward may be treated as deleted.

  • If this element and its paired end encapsulate a range with no custom XML markup, then they shall be ignored and may be omitted when the document is subsequently saved.

  • If multiple start elements exist with the same @id attribute value, then the each instance in the document shall be matched with an end in document order, and unmatched starts (no corresponding end) shall be handled as described above.

example: 
<w:p>
  <w:customXml … >
    <w:customXml … >
      <w:r>
        <w:t>Text.</w:t>
      </w:r>
    </w:customXml>
  </w:customXml>
  <w:r>
    <w:t>More text.</w:t>
  </w:r>
</w:p>

Now, if each custom XML markup element's start and end tag have a physical representation, imagine that the region from the start of the paragraph until the point between the two end points is deleted with revisions enabled. This revision cannot be encapsulated by one <del> element, since it starts outside of the first custom XML markup element and ends just inside of it, so it must be done using the custom XML markup revision "cross structure" syntax, as follows:

<w:p>
  <w:customXmlDelRangeStart w:id="0" />
  <w:customXml … >
    <w:customXml … >
      <w:del … >
        <w:r>
          <w:delText>Text.</w:delText>
        </w:r>
      </w:del>
    </w:customXml>
    <w:customXmlDelRangeEnd w:id="0" />
  </w:customXml>
  <w:r>
    <w:t>More text.</w:t>
  </w:r>
</w:p>

The <customXmlDelRangeStart> element delimits the start of the region in which all custom XML elements have been deleted with revisions enabled, and the <del> element (§2.13.5.12) handles the deletion of the text performed by this revision. Since the end of the outer <customXml> element was not in the deleted range, it is not revision marked deleted, but the corresponding physical character for the start element is. ]

Parent Elements

<body> (§2.2.2); <comment> (§2.13.4.2); <customXml> (§2.5.1.3); <customXml> (§2.5.1.4); <customXml> (§2.5.1.5); <customXml> (§2.5.1.6); <deg> (§7.1.2.26); <del> (§2.13.5.12); <den> (§7.1.2.28); <docPartBody> (§2.12.6); <e> (§7.1.2.32); <endnote> (§2.11.2); <fldSimple> (§2.16.21); <fName> (§7.1.2.37); <footnote> (§2.11.10); <ftr> (§2.10.3); <hdr> (§2.10.4); <hyperlink> (§2.16.24); <ins> (§2.13.5.20); <lim> (§7.1.2.52); <moveFrom> (§2.13.5.21); <moveTo> (§2.13.5.26); <num> (§7.1.2.75); <oMath> (§7.1.2.77); <p> (§2.3.1.22); <rt> (§2.3.3.23); <rubyBase> (§2.3.3.26); <sdtContent> (§2.5.2.32); <sdtContent> (§2.5.2.33); <sdtContent> (§2.5.2.34); <sdtContent> (§2.5.2.35); <smartTag> (§2.5.1.9); <sub> (§7.1.2.112); <sup> (§7.1.2.114); <tbl> (§2.4.36); <tc> (§2.4.62); <tr> (§2.4.75); <txbxContent> (§2.17.1.1)

Attributes

Description

<author> (Annotation Author)

Specifies the author for an annotation within a WordprocessingML document.

If this attribute is omitted, then no author shall be associated with the parent annotation type.

<w:… w:id="1" w:author="Example Author">
  …
</w:…>

The <author> attribute specifies that the author of the current annotation is Example Author, which may be used as desired. ]

The possible values for this attribute are defined by the ST_String simple type (§2.18.89).

<date> (Annotation Date)

Specifies the date information for an annotation within a WordprocessingML document. The use of this information is outside of the scope of this Office Open XML Standard.

If this attribute is omitted, then no date information shall be associated with the parent annotation type.

<w:… w:id="1" w:date="2006-01-01T10:00:00">
  …
</w:…>

The <date> attribute specifies that the date of the current annotation is January 1st 2006 at 10:00 AM, which may be used as desired. ]

The possible values for this attribute are defined by the ST_DateTime simple type (§2.18.15).

<id> (Annotation Identifier)

Specifies a unique identifier for an annotation within a WordprocessingML document. The restrictions on the @id attribute, if any, are defined by the parent XML element.

If this attribute is omitted, then the document is non-conformant.

<w:… w:id="1" … >
  …
</w:…>

The <id> attribute specifies that the ID of the current annotation is 1. This value is used to uniquely identify this annotation within the document content. ]

The possible values for this attribute are defined by the ST_DecimalNumber simple type (§2.18.16).

The following XML Schema fragment defines the contents of this element:

<complexType name="CT_TrackChange">
	<complexContent>
	<extension base="CT_Markup">
	<attribute name="author" type="ST_String" use="required"/>
	<attribute name="date" type="ST_DateTime" use="optional"/>
	</extension>
	</complexContent>
</complexType>