KeyView 24.4
KeyView XML Export SDK C Programming Guide

# Convert Revision Tracking Information

The revision tracking feature in applications—such as Microsoft Word's Track Changes—marks changes to a document (typically, strikethrough for deleted text and underline for inserted text) and tracks each change by reviewer name and date.

If revision tracking was enabled when changes were made to a document, you can configure Export to convert the deleted text and graphics and include revision tracking information in the XML output. (The deleted content and revision tracking information is excluded from the XML output by default.)

Content that was added to the document is identified by `<ins>` tags. Content that was deleted from the document is identified by `<del>` tags.

The `<ins>` and `<del>` tags include `cite` and `datetime` attributes which define the name of the reviewer who made the change and the date the change was made respectively. (The date is in ISO-8601 format: `YYYY-MM-DDThh:mm:ss`.) The tags also include a `title` attribute which allows you to display the author and date information in a browser. These elements are included in the `verity.dtd`.

The following markup is generated for inserted text:

    <ins title="Inserted: JohnD, 2006-04-24Tl4:47:00" cite="mailto:JohnD" datetime="2006-04-24T14:47:00">This text was added</ins> in a previous version.

The following markup is generated for deleted text:

    <del title="Deleted: JohnD, 2006-04-24Tl4:56:00" cite="mailto:JohnD" datetime="2006-04-24T14:56:00">This text was deleted</del> in a previous version.

To convert deleted text and graphics and include revision tracking information

1. Call the fpInit() function.

2. Call the `fpXMLConfig()` function with the following arguments (See KVXMLConfig()):

   Argument | Parameter
   `nType` | `KVCFG_INCLREVISIONMARK`
   `nValue` | `TRUE` (non-zero)
   `pData` | `NULL`

   For example:

       (*fpXMLConfig)(pKVXML, KVCFG_INCLREVISIONMARK, TRUE, NULL);

   The `xmlini` sample program demonstrates this function. See xmlini.

3. Call the `fpConvertStream()` or `KVXMLConvertFile()` function. See fpConvertStream() or KVXMLConvertFile().

Copyright 1997-2024 Open Text
Version 24.4 | Last updated September 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL KeyView 24.4

Topic Title: Convert Revision Tracking Information