When a document is created, the order of precedence for setting the storage on the Document instance is (from highest to lowest):
- instance value for the StorageArea property
- class default for the StorageArea property
- instance value for the StoragePolicy property
- class default for the StoragePolicy property
The default ClassDefinition for a document sets the StorageArea to Database Storage Area and the StoragePolicy to All Storage Areas. Therefore, if you create a new Document instance of the default Document ClassDefinition with only the StoragePolicy property set, the document will use the class default for the StorageArea property (Database Storage Area).
To avoid this situation, you must set the instance value for the document's StorageArea property to null. Because the instance value for StorageArea is set, but has no value, the StoragePolicy property will be evaluated and used.
In general, storage policies should be used to allow administrators to properly administer their storage systems. They can assign multiple storage areas to be load balanced, and also assign standby storage areas to be used if any of the current storage areas become full.
Assembly: FileNet.Api (in FileNet.Api.dll)
Syntax
Visual Basic (Declaration) |
---|
Property StoragePolicy As IStoragePolicy |
C# |
---|
IStoragePolicy StoragePolicy { get; set; } |
Visual C++ |
---|
property IStoragePolicy^ StoragePolicy { IStoragePolicy^ get (); void set (IStoragePolicy^ value); } |
JavaScript |
---|
function get_storagePolicy(); function set_storagePolicy(value); |
Remarks
Metadata
AllowsDefaultChange: true
Cardinality: SINGLE
CopyToReservation: false
DataType: OBJECT
DeletionAction: NONE
IsHidden: true
IsOrderable: true
IsSearchable: true
IsValueRequired: true
ModificationAccessRequired: WRITE
PersistenceType: OWN_COLUMN
ReflectiveProperty: null
RequiredClass: StoragePolicy
RequiresUniqueElements: false
Settability: READ_WRITE
TargetAccessRequired: READ