Demotes the latest major version of this document to an unreleased minor version. This method changes the previous major version (if it exists) to the current released major version, but does not delete any document versions (including content) from the document's version series, therefore allowing you to continue to have access to all version changes. Note that you can demote frozen document versions and documents that are not versioning-enabled (documents whose IsVersioningEnabled property is set to false).

To successfully demote a document, the following requirements must be met or an error will occur:

  • The document must be the latest major version (VersionStatus property is set to RELEASED).
  • The document must be the current version (IsCurrentVersion property is set to true).
  • The user must have the appropriate access rights (MINOR_VERSION).
  • The document must not be reserved (IsReserved property is set to false).

After a successful call to demoteVersion, the Content Engine performs the following steps on the document version that is being demoted:

  • Applies the versioning security template (if it exists and is enabled) for the IN_PROCESS state.
  • Decrements the value of the MajorVersionNumber property by 1.
  • Sets the value of the MinorVersionNumber property to the number of the latest minor version belonging to the last major version + 1.
  • Sets the VersionStatus property to IN_PROCESS.

In addition, the Content Engine performs the following steps on the previous major document version:

  • Sets the VersionStatus property to RELEASED.
  • Applies the versioning security template for the RELEASED state.


Namespace: FileNet.Api.Core
Assembly: FileNet.Api (in filenet.api.dll)

Syntax

Visual Basic (Declaration)
Sub DemoteVersion()
C#
void DemoteVersion()
C++
void DemoteVersion() abstract 
J#
void DemoteVersion()
JScript
function DemoteVersion()

See Also