HPE Content Manager SDK 9.1
HP.HPTRIM.SDK.ElectronicStore Class Reference

Defines settings for a place to store electronic documents More...

Inheritance diagram for HP.HPTRIM.SDK.ElectronicStore:
HP.HPTRIM.SDK.TrimMainObject HP.HPTRIM.SDK.TrimObject HP.HPTRIM.SDK.TrimPropertySet

Public Member Functions

 ElectronicStore (Database database, TrimURI uri)
 
 ElectronicStore (Database database, string name)
 
 ElectronicStore (Database inDatabase, EstoreTypes initializeAsType)
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimMainObject
virtual void Save ()
 Permanently commits all changes made to this object (and all its child objects). For new objects a new unique identifier will be allocated (Uri). More...
 
string MakeReference (string SuggestName)
 Creates a TRIM reference file for this object, given the path and filename. A reference file can be associated with the Open command of various of the TRIM executables - TRIM.exe, TRIMDesktop.exe, etc. When the reference file is double-clicked, the associated application will then launch (or activate if it already running) and the object will then be displayed inside that executable. Returns a string containing the path and filename of the reference file created. More...
 
virtual void Delete ()
 Permanently removes this object and all its associated child objects from the database. More...
 
bool IsDeleteOk ()
 Determines if this object can be deleted. If it returns false, check the ErrorMessage details for more information. It is possible that the ErrorMessage property could contain a warning message even though the function returns true. More...
 
bool Verify (bool failOnWarning)
 Verifies all properties that have been modified since this object was last saved. Returns a Boolean value indicating whether the function succeeded. If false, the error description is stored in the ErrorMessage property. More...
 
TrimChildObjectList GetChildObjectList (BaseObjectTypes childType)
 Retrieves the child object collection of the nominated child object type. More...
 
TrimMainObject GetNewCopy ()
 Creates a new TrimMainObject which is a copy of this TrimMainObject. Where appropriate, property values are copied from this TrimMainObject to the new TrimMainObject. You will generally need to set any unique properties manually afterwards, prior to committing this new TrimMainObject to the TRIM database with the Save() method. See also the NewCopy function of the derived objects that implement this capability. Will return NULL if this object does not support the Copy function. More...
 
virtual void Refresh ()
 Resets this object to the current state on the database, will revert any changes that might have been made. Only required if you are not using BOBnotifications, or need to guarantee a really up-to-date version of the object state. More...
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimObject
bool IsMandatory (FieldDefinition field)
 Gets a boolean value indication whether the specified field must have a non-NULL value for this object. More...
 
bool IsValidFor (int purpose)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. More...
 
bool IsValidFor (int purpose, TrimMainObject purposeExtraObject)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. The purposeExtraObject is necessary for some purpose types - once again, the derived class will have more information. More...
 
bool IsValidFor (int purpose, int purposeExtraEnumValue)
 Call this method to determine if this object can be used for the nominated purpose. To determine what the valid purposes are, look in the derived class at the more type safe versions of this function. The purposeExtraInformation is necessary for some purpose types - once again, the derived class will have more information. More...
 
- Public Member Functions inherited from HP.HPTRIM.SDK.TrimPropertySet
TrimIcon GetPropertyIcon (PropertyIds propertyId)
 Gets the icon value associated the a property of this object. More...
 
TrimMainObject GetPropertyTrimObject (PropertyIds dnPropId)
 
string GetPropertyString (PropertyIds dnPropId)
 
int GetPropertyLong (PropertyIds dnPropId)
 
long GetPropertyLong64 (PropertyIds dnPropId)
 
bool GetPropertyBool (PropertyIds dnPropId)
 
TrimDateTime GetPropertyDate (PropertyIds dnPropId)
 
TrimDecimal GetPropertyDecimal (PropertyIds dnPropId)
 
TrimCurrency GetPropertyCurrency (PropertyIds dnPropId)
 
TrimURI GetPropertyUri (PropertyIds dnPropId)
 
bool SetPropertyTrimObject (PropertyIds dnPropId, TrimMainObject newValue)
 
bool SetPropertyString (PropertyIds dnPropId, string newValue)
 
bool SetPropertyLong (PropertyIds dnPropId, int newValue)
 
bool SetPropertyLong64 (PropertyIds dnPropId, long newValue)
 
bool SetPropertyBool (PropertyIds dnPropId, bool newValue)
 
bool SetPropertyDate (PropertyIds dnPropId, TrimDateTime newValue)
 
bool SetPropertyCurrency (PropertyIds dnPropId, TrimCurrency newValue)
 
bool SetPropertyDecimal (PropertyIds dnPropId, TrimDecimal newValue)
 
bool SetPropertyDouble (PropertyIds dnPropId, double newValue)
 
bool SetPropertyUri (PropertyIds dnPropId, TrimURI newValue)
 
bool ClearProperty (PropertyIds dnPropId)
 
object GetProperty (PropertyIds propId)
 
bool SetProperty (PropertyIds propId, object newValue)
 
string GetPropertyAsString (PropertyIds propertyId, StringDisplayType propertyValueStringType, bool useHTMLEscapeChars)
 Gets a string representation of a property value in a format appropriate for a specific use. More...
 
bool IsMandatory (PropertyIds propertyId)
 Gets a boolean value indication whether the specified property must have a non-NULL value for this object. More...
 
bool VerifyProperty (PropertyIds propertyId, bool doMandatoryChecks)
 Verifies the value of a particular property, by cross checking it against other property values. The ErrorMessage property provides details if the verification fails. More...
 
bool CanModifyProperty (PropertyIds propertyId)
 Indicates whether the current user has the permission to modify the specified property. More...
 

Properties

int AlertLevel [get, set]
 Gets or sets an integer indicating the percentage of total capacity at which users should be alerted of the storage level reached. More...
 
string AutnGroup [get, set]
 Gets or sets a string value indicating the AUTN_GROUP property for a IDOL CFS Connector based store. This allows a TRIM store to use distributed IDOL CFS More...
 
long BytesRemaining [get]
 Gets a number value indicating the actual amount of space currently availablefor this store. More...
 
long BytesUsed [get]
 Gets a number value indicating the actual amount of space currently used for this store. More...
 
long Capacity [get, set]
 Gets or sets an integer containing the maximum capacity of the Document Store (bytes). More...
 
bool Compress [get, set]
 Gets or sets a boolean value indicating whether items to be stored in this document store should be compressed. More...
 
TrimDateTime DefaultAccessDate [get, set]
 Gets or sets a datetime value which is used as the lastAccessedDate for an item if there is no other record of a last accessed date. Used when access date logging has been implemented part way through a store implementation, also when not logging access dates during the add operation. More...
 
long DeleteRetriesQueued [get]
 Gets a number indicating the number of delete requests that have not yet been successfully processed. More...
 
StoreStatus DeploymentStatus [get, set]
 Gets or sets a storeStatus enum value to indicate the availability of this document store. More...
 
bool Encrypt [get, set]
 Gets or sets a boolean value indicating whether items to be stored in this document store should be encrypted. More...
 
string ExternalConfig [get, set]
 Gets or sets a string containing configuration information for an external store. More...
 
string ExternalProgId [get, set]
 Gets or sets a COM ProgID for the external store component. More...
 
int FilesPerFolder [get, set]
 Gets or sets an integer containing the maximum number of files per subdirectory in the store. A new subdirectory within the store will be created when this maximum is reached. Setting the value of this property will automatically set the ElectronicStore.MaxMBsInDir property to '0'. More...
 
bool InPool [get, set]
 Gets or sets a boolean value to indicate whether this store in part of the default storage pool. More...
 
bool KeepAccessDates [get, set]
 Gets or sets a boolean value indicating whether a last accessed date should be maintained for documents held within this store. More...
 
string LoginName [get, set]
 Gets or sets a string containing the User name for connecting to the Store, if this Document Store is an External or FTP Store. More...
 
string LoginPassword [get, set]
 Gets or sets a string containing the password used in connecting to the Store, if this Document Store is an External or FTP Store. More...
 
long MaxFolderSize [get, set]
 Gets or sets an number indicating the maximum size of each subdirectory in the store, in bytes. A new subdirectory within the store will be created when this maximum is reached. More...
 
new string Name [get, set]
 Gets or sets a string containing the name of this Document Store. More...
 
string Path [get]
 Gets a string containing the full path to the directory where this Document Store is located. The electronic documents are kept in subdirectories of this location. A string containing the path to the base directory of the Document Store is held in the ElectronicStore.DbPath property. More...
 
TieredStorageType StorageTier [get, set]
 Gets or sets a TieredStorageType enumeration value indicating the storage tier that this document store belongs to. More...
 
string StoreLocation [get, set]
 Gets or sets a string containing the path to the base directory within which the subdirectory named after the database id which in turn contains the folder for this Document Store is located. The electronic documents are kept in subdirectories of the document store folder. Note: If connected to a network, this string must be set to the string path of a a network share. If not connected to a network, a local path must be used. More...
 
EstoreTypes StoreType [get]
 Gets an esEstoreTypes enum value indicating what type of document store it is. More...
 
bool UpdateAccessDateOnAdd [get, set]
 Gets or sets a boolean value indicating whether a last accessed date should be set for a document at the time the document is added to this store. More...
 
bool WriteProtected [get, set]
 Gets or sets a Boolean value indicating whether this Document Store should be designated read only. Use the DeploymentStatus property for version 7.2 or later. More...
 
- Properties inherited from HP.HPTRIM.SDK.TrimMainObject
TrimDateTime LastUpdatedOn [get]
 Returns the date and time that changes to this object were last committed. More...
 
string Name [get]
 Gets a string name for this object which is a user-friendly way of displaying this object. For most TRIM objects the name is a unique string, although some times this is not the case (eg Location Names). More...
 
bool Verified [get]
 Gets a Boolean value indicating whether the object has been verified. That is, whether a call to the 'Verify' method has been made and has succeeded. More...
 
string WebURL [get]
 
bool IsInFavorites [get]
 Gets a boolean value indicating whether this object is in the current user's list of favorites More...
 
string UpdateComment [get, set]
 Gets or sets a string value to be recorded with any audit entries related to the update of this object More...
 
- Properties inherited from HP.HPTRIM.SDK.TrimObject
BaseObjectTypes TrimType [get]
 Gets a BaseObjectTypes enum value indicating the type of this object. More...
 
TrimURI Uri [get]
 Gets the unique row identifier for this object. Once an object has been committed to the database, typically by calling a Save method, this unique identifier is allocated. From that time on, the uri will remain constant and can never be changed. It is always unique across all objects of the same Type. More...
 
string URN [get]
 Gets the uniform resource name for this object. More...
 
string NameString [get]
 Gets a string name for this object which is a user-friendly way of displaying this object. For most TRIM objects the name is a unique string, although some times this is not the case (eg Location Names). More...
 
string NameStringExtra [get]
 Gets a more verbose description of this object, particularly when the name is perhaps a little cryptic or not enough to fully describe the object. More...
 
bool IsReadOnly [get]
 Gets a boolean parameter indicating if this object is "ReadOnly". This would generally indicate that none of the object's properties could be modified, in some cases there are exceptions that can be tested via CanModifyProperty method. More...
 
- Properties inherited from HP.HPTRIM.SDK.TrimPropertySet
string ErrorMessage [get]
 All TRIM SDK objects have an ErrorMessage property which can be used to examine any error that may have occurred in the most recent method call. More...
 
TrimException Error [get]
 All TRIM SDK objects have an Error property which can be used to examine any error that may have occurred in the most recent method call. More...
 
Database Database [get]
 Gets the TRIM Database object in which this object resides. All Trim objects live within a particular TRIM database and cannot be created without one. More...
 
virtual string Caption [get]
 Gets the user-defined caption that has been associated with all TrimPropertySets of this type. More...
 
virtual TrimIcon Icon [get]
 Gets the icon value associated this TrimPropertySet. More...
 
bool IsModified [get]
 Gets a boolean parameter indicating if any changes have been made to this object since it was first constructed, or last saved. More...
 

Detailed Description

Defines settings for a place to store electronic documents

Constructor & Destructor Documentation

HP.HPTRIM.SDK.ElectronicStore.ElectronicStore ( Database  database,
TrimURI  uri 
)
HP.HPTRIM.SDK.ElectronicStore.ElectronicStore ( Database  database,
string  name 
)
HP.HPTRIM.SDK.ElectronicStore.ElectronicStore ( Database  inDatabase,
EstoreTypes  initializeAsType 
)

Property Documentation

int HP.HPTRIM.SDK.ElectronicStore.AlertLevel
getset

Gets or sets an integer indicating the percentage of total capacity at which users should be alerted of the storage level reached.

string HP.HPTRIM.SDK.ElectronicStore.AutnGroup
getset

Gets or sets a string value indicating the AUTN_GROUP property for a IDOL CFS Connector based store. This allows a TRIM store to use distributed IDOL CFS

long HP.HPTRIM.SDK.ElectronicStore.BytesRemaining
get

Gets a number value indicating the actual amount of space currently availablefor this store.

long HP.HPTRIM.SDK.ElectronicStore.BytesUsed
get

Gets a number value indicating the actual amount of space currently used for this store.

long HP.HPTRIM.SDK.ElectronicStore.Capacity
getset

Gets or sets an integer containing the maximum capacity of the Document Store (bytes).

bool HP.HPTRIM.SDK.ElectronicStore.Compress
getset

Gets or sets a boolean value indicating whether items to be stored in this document store should be compressed.

TrimDateTime HP.HPTRIM.SDK.ElectronicStore.DefaultAccessDate
getset

Gets or sets a datetime value which is used as the lastAccessedDate for an item if there is no other record of a last accessed date. Used when access date logging has been implemented part way through a store implementation, also when not logging access dates during the add operation.

long HP.HPTRIM.SDK.ElectronicStore.DeleteRetriesQueued
get

Gets a number indicating the number of delete requests that have not yet been successfully processed.

StoreStatus HP.HPTRIM.SDK.ElectronicStore.DeploymentStatus
getset

Gets or sets a storeStatus enum value to indicate the availability of this document store.

bool HP.HPTRIM.SDK.ElectronicStore.Encrypt
getset

Gets or sets a boolean value indicating whether items to be stored in this document store should be encrypted.

string HP.HPTRIM.SDK.ElectronicStore.ExternalConfig
getset

Gets or sets a string containing configuration information for an external store.

string HP.HPTRIM.SDK.ElectronicStore.ExternalProgId
getset

Gets or sets a COM ProgID for the external store component.

int HP.HPTRIM.SDK.ElectronicStore.FilesPerFolder
getset

Gets or sets an integer containing the maximum number of files per subdirectory in the store. A new subdirectory within the store will be created when this maximum is reached. Setting the value of this property will automatically set the ElectronicStore.MaxMBsInDir property to '0'.

bool HP.HPTRIM.SDK.ElectronicStore.InPool
getset

Gets or sets a boolean value to indicate whether this store in part of the default storage pool.

bool HP.HPTRIM.SDK.ElectronicStore.KeepAccessDates
getset

Gets or sets a boolean value indicating whether a last accessed date should be maintained for documents held within this store.

string HP.HPTRIM.SDK.ElectronicStore.LoginName
getset

Gets or sets a string containing the User name for connecting to the Store, if this Document Store is an External or FTP Store.

string HP.HPTRIM.SDK.ElectronicStore.LoginPassword
getset

Gets or sets a string containing the password used in connecting to the Store, if this Document Store is an External or FTP Store.

long HP.HPTRIM.SDK.ElectronicStore.MaxFolderSize
getset

Gets or sets an number indicating the maximum size of each subdirectory in the store, in bytes. A new subdirectory within the store will be created when this maximum is reached.

new string HP.HPTRIM.SDK.ElectronicStore.Name
getset

Gets or sets a string containing the name of this Document Store.

string HP.HPTRIM.SDK.ElectronicStore.Path
get

Gets a string containing the full path to the directory where this Document Store is located. The electronic documents are kept in subdirectories of this location. A string containing the path to the base directory of the Document Store is held in the ElectronicStore.DbPath property.

TieredStorageType HP.HPTRIM.SDK.ElectronicStore.StorageTier
getset

Gets or sets a TieredStorageType enumeration value indicating the storage tier that this document store belongs to.

string HP.HPTRIM.SDK.ElectronicStore.StoreLocation
getset

Gets or sets a string containing the path to the base directory within which the subdirectory named after the database id which in turn contains the folder for this Document Store is located. The electronic documents are kept in subdirectories of the document store folder. Note: If connected to a network, this string must be set to the string path of a a network share. If not connected to a network, a local path must be used.

EstoreTypes HP.HPTRIM.SDK.ElectronicStore.StoreType
get

Gets an esEstoreTypes enum value indicating what type of document store it is.

bool HP.HPTRIM.SDK.ElectronicStore.UpdateAccessDateOnAdd
getset

Gets or sets a boolean value indicating whether a last accessed date should be set for a document at the time the document is added to this store.

bool HP.HPTRIM.SDK.ElectronicStore.WriteProtected
getset

Gets or sets a Boolean value indicating whether this Document Store should be designated read only. Use the DeploymentStatus property for version 7.2 or later.