Relationship Between Original and Converted Documents in SharePoint Server 2010 (ECM)

Applies to: SharePoint Server 2010

Microsoft SharePoint Server 2010 uses document library metadata to track which documents are actually converted copies of other documents. For each converted copy in a document library, SharePoint Server 2010 stores additional information in the following two fields:

• ParentID   A string that represents the name of the original file on which the converted copy is based.

• ParentVersionID   An integer that represents the version number of the original file on which the converted copy is based.

The original file is not altered in any way, and includes no references to any converted copies generated from it.

These two columns enable SharePoint Server 2010 to determine which documents in a library are actually converted copies, and determine the original from which a specific converted copy was generated. For example, SharePoint Server 2010 uses this information to list the converted copies available for an original file on that document's settings page in the user interface.

Users can use this information also; for example, to create views that filter out the converted copies included in a document library.

The relationship between the original file and any converted copies remains only as long as both the original file and the copy are located in the same document library. It is a one-way relationship; SharePoint Server 2010 stores information on the converted copy that references the original document, but includes no references from the original document to the copy.any converted copies.

Altering Files After Document Conversion

Changes you make to either the original document or a converted copy can affect the relationship between the files, as described in the following sections.

Moving Files

The relationship between the original document and any converted copies remains intact as long as both files are located in the same document library.

If you move the original file out of the document library, the converted copy remains in its current location. However, the converted copy's reference to the original copy is no longer valid; therefore, the relationship is severed.

Similarly, if you move the converted file out of the document library, the original file remains in its current location. However, the converted copy's reference to the original copy is no longer valid; again, the relationship is severed.

Deleting Files

If you delete the original file, the converted copy remains in its current location. However, the converted copy's reference to the original copy is no longer valid; therefore, the relationship is severed.

If you delete a converted copy, the original file remains in its current location. The original copy never includes references to its converted copies. Any other converted copies for that original file remain unaffected, and retain their reference to the original file.

Copying Files

If you make a copy of the original file, that copy has no relationship to any converted copies of the original file. The reference for the converted copy still points to the original file, instead of to the new copy of the original file.

If you make a copy of a converted file, the new copy does not include a reference to the original file.

Renaming Files

If you rename the original file, the converted copy retains its original name.

If you rename a converted copy, the original file retains its original name. The renamed converted copy retains a reference to the original file.

Versioning Files

If you create a new version of the original file, the converted copy retains its original version number, and still includes a reference to the version of the original file from which it was generated. This includes major and minor versioning.

If you create a new version of a converted file, the original file is unaffected. The new version of the converted file does not include a reference to the original file.

The following figure shows how the relationship between original files and their converted copies are affected by making changes to the documents.

See Also

Concepts

SharePoint Server 2010 Document Converter Development Overview (ECM)

Document Converters in SharePoint Server 2010 (ECM)

Converted Documents in SharePoint Server 2010 (ECM)