Comments and Tracked Changes - XML Fragment
Edit online

This section contains information about how each type of tracked change is structured in the merged map XML file.

Insertions

For an insertion type of tracked change, the structure that defines the insertion details is inside the range (<oxy-range-start> to <oxy-range-end>), the inserted text is highlighted by an <oxy-insert-hl> element, and the details are stored in the <oxy-insert> element.

    <oxy:oxy-range-start id="sc_1" hr_id="1"/>

       <oxy:oxy-insert href="#sc_1" hr_id="1">
           <oxy:oxy-author>dan</oxy:oxy-author>
           <oxy:oxy-content>insert</oxy:oxy-content>
           <oxy:oxy-date>2018/03/15</oxy:oxy-date>
           <oxy:oxy-hour>09:38:29</oxy:oxy-hour>
           <oxy:oxy-tz>+02:00</oxy:oxy-tz>
       </oxy:oxy-insert>

       <oxy:oxy-insert-hl>This is an insert!!</oxy:oxy-insert-hl>

    <oxy:oxy-range-end hr_id="1"/>

Comments

Similar to insertions, comments are defined in a range (<oxy-range-start> to <oxy-range-end>), the comment details is in the <oxy-comment> element, and the highlighted content is wrapped in the <oxy-comment-hl> element. 

    <oxy:oxy-range-start id="sc_1" hr_id="1"/>
      
        <oxy:oxy-comment href="#sc_1" hr_id="1">
              <oxy:oxy-author>dan</oxy:oxy-author>
              <oxy:oxy-comment-text>This is a comment.</oxy:oxy-comment-text>
              <oxy:oxy-date>2018/03/15</oxy:oxy-date>
              <oxy:oxy-hour>09:56:59</oxy:oxy-hour>
              <oxy:oxy-tz>+02:00</oxy:oxy-tz>
        </oxy:oxy-comment>
          
        <oxy:oxy-comment-hl>Context</oxy:oxy-comment-hl>
          
    <oxy:oxy-range-end hr_id="1"/>
Note: Comments that are marked as done have a flag="done" attribute:
<oxy:oxy-comment href="#sc_6" hr_id="6" flag="done">

Attribute changes

The attribute changes are more complex. The range is empty, and is directly above the affected element (the one that has modified attributes). The <oxy-attributes> element contains details about multiple attribute changes, each stored in the <oxy-attributed-change> element. 

<element>

  <oxy:oxy-range-start id="sc_3" hr_id="3"/>
  <oxy:oxy-range-end hr_id="3"/>

  <oxy:oxy-attributes href="#sc_3" hr_id="3">

     <oxy:oxy-attribute-change type="inserted" name="platform">
          <oxy:oxy-author>dan</oxy:oxy-author>
          <oxy:oxy-current-value>windows</oxy:oxy-current-value>
          <oxy:oxy-date>2018/03/15</oxy:oxy-date>
          <oxy:oxy-hour>10:05:04</oxy:oxy-hour>
          <oxy:oxy-tz>+02:00</oxy:oxy-tz>
     </oxy:oxy-attribute-change>
    ....
     <oxy:oxy-attribute-change type="removed" name="audience">
        ....    
     </oxy:oxy-attribute-change>
  </oxy:oxy-attributes>
...
</element>

Deletions

For a deletion, there are some elements that define the start and end of the deletion, and the highlighted text is wrapped in the <oxy-delete-hl> element.

   <oxy:oxy-range-start id="sc_2" hr_id="2"/>
   <oxy:oxy-delete-hl> This is a deleted text. </oxy:oxy-delete-hl>
   <oxy:oxy-range-end hr_id="2"/>

There is a structure that offers details about the deletion change, using the <oxy-delete> elment. This is linked to the above deletion range by the same ID value:

   <oxy:oxy-delete href="#sc_2" hr_id="2">
       <oxy:oxy-author>dan</oxy:oxy-author>
       <oxy:oxy-content><image href="../img/ex.gif"></oxy:oxy-content>
       <oxy:oxy-date>2018/03/14</oxy:oxy-date>
       <oxy:oxy-hour>11:38:06</oxy:oxy-hour>
       <oxy:oxy-tz>+02:00</oxy:oxy-tz>
   </oxy:oxy-delete>

Colored Highlights

To show some text as highlighted with a background color: 
  <oxy:oxy-color-hl color="rgba(140,255,140,50)">Some colored text.</oxy:oxy-color-hl>