com.filenet.api.core
Interface VersionSeries

All Superinterfaces:
EngineObject, IndependentlyPersistableObject, IndependentObject, RepositoryObject, java.io.Serializable, Subscribable

public interface VersionSeries
extends RepositoryObject, Subscribable, IndependentlyPersistableObject

Represents the complete set of versions for a versionable object, or document (that is, an object instantiated from a subinterface of the Versionable interface). Because a VersionSeries object is constructed by the server from versionable objects and does not have its state stored in a database, it is read-only, and thus you cannot modify any of its properties. In addition, a VersionSeries object has no security attached to it; it is secured by the current document version associated with it. You can access a specific document version by navigating through the collection returned by the Versions property. Use extreme caution when deleting a VersionSeries object; if you delete it, all of its associated document versions will also be deleted.

Metadata

Auditable: true
AllowsInstances: false
AllowsSubClasses: false
ClassDefinitionName: SubscribableClassDefinition
IsDependent: false
IsHidden: false
Searchable: false
StorageType: ObjectStore
SuperclassName: Subscribable

See Also:
Versionable, Document

Method Summary
 Versionable cancelCheckout()
          Cancels the check-out reservation held on this document or version series by deleting the reservation object associated with it.
 void checkout(ReservationType type, Id reservationId, java.lang.String reservationClass, Properties reservationProperties)
          Creates a reservation object that can be modified and checked in as a new version of this document.
 EventSet get_AuditedEvents()
          Returns the value of the AuditedEvents property.
 Versionable get_CurrentVersion()
          Returns the value of the CurrentVersion property.
 Id get_Id()
          Returns the value of the Id property.
 java.lang.Boolean get_IsReserved()
          Returns the value of the IsReserved property.
 java.lang.Boolean get_IsVersioningEnabled()
          Returns the value of the IsVersioningEnabled property.
 Versionable get_ReleasedVersion()
          Returns the value of the ReleasedVersion property.
 IndependentObject get_Reservation()
          Returns the value of the Reservation property.
 VersionableSet get_Versions()
          Returns the value of the Versions property.
 InstanceWorkflowSubscriptionSet get_WorkflowSubscriptions()
          Returns the value of the WorkflowSubscriptions property.
 void moveContent(StorageArea storageArea)
          Moves the content data of an object to a new storage area.
 void set_Id(Id value)
          Sets the value of the Id property.
 
Methods inherited from interface com.filenet.api.core.RepositoryObject
getObjectStore
 
Methods inherited from interface com.filenet.api.core.Subscribable
raiseEvent
 
Methods inherited from interface com.filenet.api.core.IndependentlyPersistableObject
addPendingAction, clearPendingActions, delete, getAccessAllowed, getPendingActions, getUpdateSequenceNumber, isCurrent, save, save, setUpdateSequenceNumber
 
Methods inherited from interface com.filenet.api.core.IndependentObject
fetchProperties, fetchProperties, fetchProperty, fetchProperty, getObjectReference, refresh, refresh, refresh
 
Methods inherited from interface com.filenet.api.core.EngineObject
get_ClassDescription, getClassName, getConnection, getProperties, getSuperClasses
 

Method Detail

get_Id

Id get_Id()
Returns the value of the Id property. For more information, see Id Property.


set_Id

void set_Id(Id value)
Sets the value of the Id property. For more information, see Id Property.


get_AuditedEvents

EventSet get_AuditedEvents()
Returns the value of the AuditedEvents property. For more information, see AuditedEvents Property.


get_IsReserved

java.lang.Boolean get_IsReserved()
Returns the value of the IsReserved property. For more information, see IsReserved Property.


get_Versions

VersionableSet get_Versions()
Returns the value of the Versions property. For more information, see Versions Property.


get_Reservation

IndependentObject get_Reservation()
Returns the value of the Reservation property. For more information, see Reservation Property.


get_IsVersioningEnabled

java.lang.Boolean get_IsVersioningEnabled()
Returns the value of the IsVersioningEnabled property. For more information, see IsVersioningEnabled Property.


get_WorkflowSubscriptions

InstanceWorkflowSubscriptionSet get_WorkflowSubscriptions()
Returns the value of the WorkflowSubscriptions property. For more information, see WorkflowSubscriptions Property.


cancelCheckout

Versionable cancelCheckout()
Cancels the check-out reservation held on this document or version series by deleting the reservation object associated with it. Any changes made to the reservation object are lost. If the reservation object is an exclusive reservation (the object's ReservationType property is set to EXCLUSIVE), the user must be the reservation owner (the reservation owner's name is the value of the reservation object's Owner property) or have both WRITE_OWNER and DELETE access rights. Note that this method is provided only as a convenience method for canceling a checkout; all it does is delete the reservation version held by the document or version series from which it is called.

After a document's reservation object is deleted, the Content Engine performs the following steps on the reserved document version:

Returns:
A Versionable object specifying the reservation object for which a delete pending action has been created. You must call this Versionable object’s save method to compete the cancellation of the checkout.
Throws:
API_NOT_A_RESERVATION - if this document is not checked out.
E_NOT_SUPPORTED - if this document is a newly created object that has never been checked in.

checkout

void checkout(ReservationType type,
              Id reservationId,
              java.lang.String reservationClass,
              Properties reservationProperties)
Creates a reservation object that can be modified and checked in as a new version of this document. The reservation object can be accessed from this document's Reservation property. You can either specify the type of checkout reservation (exclusive or collaborative) or use the default checkout reservation setting of the object store.

After a successful call to checkout, the Content Engine performs the following steps:

Parameters:
type - A ReservationType constant that specifies the type of checkout reservation: collaborative, exclusive, or the default object store setting.
reservationId - A String representing a GUID to be assigned to the reservation object that is created when a document is checked out. An assigned ID can be useful if you need to later import a series of document versions. Do not assign an ID that already belongs to an existing Content Engine object. If this parameter is null, the Content Engine will automatically assign a GUID to the reservation object.
reservationClass - A String representing the symbolic name of the class to which this document's reservation object will belong, thus allowing you to specify the class of the new document version that will be created when the reservation object is checked in. If this parameter is null, the reservation object's class will be the same as the reserved document's class.
reservationProperties - A Properties object containing the collection of this document's property values that will be carried over to its reservation object, thus allowing you to modify them. Once the reservation is checked in, these property values will belong to the new document version. Note that if you use a Factory.Document.createInstance() method to create a new document as a reservation object in order to use its Properties collection, you should ensure that the new document will not be saved before it is checked in. This is because only "dirty" properties (those that have had their values changed and have not yet been saved) will be marked by the server to be updated by the reservation object. Otherwise, once an object has been saved, its properties will no longer be "dirty" and thus their values will not be used by the server for the new document version that is created during check-in.
Throws:
E_READ_ONLY - if you attempt to set the value of a Property object in the Properties collection specified by reservationProperties that is read-only (its Settability property is READ_ONLY). Note that this exception will be thrown even if you attempt to set a read-only property's value to the same value as its current value.
E_NOT_SUPPORTED - if the following requirements are not met:
  • The document must be the current version (IsCurrentVersion property is set to true).
  • .
  • The document must not already be checked out (IsReserved property is set to false).
  • The document must be version-enabled (IsVersioningEnabled property is set to true).
  • The user must have the appropriate access rights (MINOR_VERSION to check out a minor version, or MAJOR_VERSION to check out a released version).

moveContent

void moveContent(StorageArea storageArea)
Moves the content data of an object to a new storage area.

Parameters:
storageArea - A StorageArea object specifying the new storage area for this object's content data.

get_ReleasedVersion

Versionable get_ReleasedVersion()
Returns the value of the ReleasedVersion property. For more information, see ReleasedVersion Property.


get_CurrentVersion

Versionable get_CurrentVersion()
Returns the value of the CurrentVersion property. For more information, see CurrentVersion Property.



© Copyright IBM Corporation 2006, 2009. All rights reserved.