Modifying Object Mapped Elements (OME): Arbortext Editor Only
This section describes what happens when you modify an Object Mapped Element (OME) when change tracking is turned on in your editor. It also contains information about the preferred method to use for accepting or rejecting changes in the editor application.
Deleting an OME
- The text in the deleted element displays in the interface with red-colored strike through lines.
- Delete wrappers are inserted around the deleted element; the wrappers are not visible in the interface.
- The modified flag of the parent OME is set to yes.
When the user saves the data back into SDL Contenta the delete wrappers are stored in the parent object, not in the object containing the data that was deleted. The object mapped to the deleted element is never actually deleted unless, and until, someone accepts the change. (See Accept or Reject Changes).
Because change tracking wrappers are stored in the parent object of the modified data, it is important for you to understand that your editor should be executed consistently on the same object within the Contenta hierarchy.
If for example, you check-out a parent object, delete the first OME in that object, then check-in the data to SDL Contenta, you may still be able to select and check-out the Contenta object that is mapped to the deleted OME. The deletion wrapper is saved in the parent object, not in the deleted object so your editor displays the deleted OME and its data as if it were not deleted—that is, the data in the deleted OME does not display with the red-colored strike through lines. To realize the effects of the delete wrappers, you must check-out at the parent level or higher.
Inserting an OME
- the data is wrapped with add wrappers.
- the data is green and underlined.
- the modified flag of the parent OME is set to
yes.
When the user saves to SDL Contenta, the add wrappers and the inserted data are stored in the parent object. When the user scans for new objects, the ACL custom code skips over the data between the add wrappers unless, when the document is opened, the CreateObjectsOnElementInsert is set on.
By default CreateObjectsOnElementInsert is set off. If it is set on, the regions between the add wrappers are scanned for object-mapped elements just as it would if change tracking were not turned on. If an OME is found by the scan, the element is marked with a xy_object PI. When the user checks-in the document to SDL Contenta, the user is prompted for object name verification and the object is created.
The add wrapper is stored in the parent object of the newly created object. If a user later rejects the change (see Accept or Reject Changes), the newly created object is deleted and the wrapper is deleted from the parent object.
Copying an OME
Copying an OME is done the same way whether change tracking is activated or not.
Note that the xy_object PIs are stripped during the paste process of the copy function. Therefore, the same functionality described for Inserting an OME applies for a copied OME.
Moving an OME
When change tracking is activated (turned on) an OME cannot be moved.
If you right-click on the OME, the option Select Contenta object <element> for Moving or
Copying is not available. However, the Select Contenta object <element> for Copying is available.
If you try to move an OME using a drag-and-drop method, the following error appears
Do not select the the contents of an object-mapped element with your mouse then drag the it to another object-mapped element to move it; this method becomes a copy and paste instead of a move (the data is not always removed from the old location). If you want to manually highlight the data to move, use the Ctrl+E keys on your keyboard to select the data you want to move.
Accept or Reject Changes
Accepting the change is standard functionality with one exception; the entire changed region including the PIs, which are not visible, must be selected to accept or reject the change. You should not highlight the changed area then accept or reject changes. Instead, use the following method to accept or reject changes to ensure that the entire changed region is selected. Click within the area to be accepted or rejected (do not highlight) then click
In the resulting dialog box, click either the Accept or Reject button.