Micro Focus Content Manager SDK 9.4
HP.HPTRIM.SDK.History Class Reference

Stores auditing information - a history of events that have happened to objects More...

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

Public Member Functions

 History (Database database, TrimURI uri)
 
 History (Database database, string name)
 
- 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...
 
bool HasPermission (GenericPermissions prm)
 Checks to see if the currently logged in user has permission to perform the generic action on this object More...
 
bool HasPropertyPermission (GenericPermissions prm, PropertyIds propId)
 Checks to see if the currently logged in user has permission to perform the generic action on the specified property of this object 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

Activity Activity [get]
 Gets the Activity object to which the event associated with this History object occurred. More...
 
string ClientIPAddress [get]
 Gets a string value indicating the IP address of the client used to originate the event. More...
 
string ConnectionIPAddress [get]
 Gets a string value indicating the IP address of computer where the event originated. More...
 
Record ContentRecord [get]
 Gets the contained record affected by the 'Content Added' and 'Content Removed' events More...
 
TrimDateTime DoneOn [get]
 Gets the date the audit event corresponding to this History object occurred. More...
 
TrimDateTime DoneOnGMT [get]
 Gets the date the audit event corresponding to this History object occurred adjusted to GMT time. More...
 
TrimDateTime DoneOnLocal [get]
 Gets the date the audit event corresponding to this History object occurred adjusted tothe local time of the originator of the event. More...
 
string DoneOnMachine [get]
 Gets a string value indicating the name of the computer where the event originated. More...
 
string EventDescription [get]
 Gets a string containing a full description of the audit event corresponding to this History object. More...
 
TrimURI EventObject [get]
 Gets the URI of the target object of this event More...
 
Events EventType [get]
 Gets an Events enum value indicating the type of audit event represented by this history object. More...
 
BaseObjectTypes ForObjectType [get]
 Gets the uri of the object to which the event associated with this History object occurred. More...
 
TrimURI ForObjectUri [get]
 Gets the uri of the object to which the event associated with this History object occurred. More...
 
bool IsSearch [get]
 Gets a boolean value indication if this event is a search execution event More...
 
bool IsSecurityViolation [get]
 Gets a Boolean value indicating whether a security violation has been detected. More...
 
Location Location [get]
 Gets the Location object to which the event associated with this History object occurred. More...
 
string Login [get]
 Gets a string containing the network login of the location by whom the audit event corresponding to this History object was performed. More...
 
Location LoginLocation [get]
 Gets the Location object by whom the audit event corresponding to this History object was performed. More...
 
Location MovementLocation [get]
 Gets the target Location of the event corresponding to this History event. For 'Assignee Changed', for example, this property holds the Location the record was moved to; for 'Contact Added', this property holds the contact Location that was added. If this event does not involve a target Location, for example, 'Document Removed', this property has a null value. More...
 
string RawEventDescription [get]
 Gets a string containing a description of what actually took place at the audit event corresponding to this History object. For a full description which includes also the event type, performing location and the date and time of the event. More...
 
Record Record [get]
 Gets the Record object to which the event associated with this History object occurred. More...
 
string RecordTitle [get]
 Gets the title of the record object to which the event associated with this History object occurred. More...
 
BaseObjectTypes RelatedObjectType [get, set]
 Gets the type of the related object for this event. Many events have a primary affected object, together with a related object. More...
 
TrimURI RelatedObjectUri [get]
 Gets the uri of the related object for this event. Many events have a primary affected object, together with a related object. More...
 
string SearchTitle [get]
 Gets a string value describing the search that was executed (only for search execution events) More...
 
string TextSummary [get]
 Gets an text string that provides a detailed summary of the event - only applicable for the created/modified events More...
 
string UpdateComments [get]
 Gets a string value indicating any comments provided with the object modified event More...
 
Workflow Workflow [get]
 Gets the Workflow to which the event associated with this History object occurred. More...
 
string XmlSummary [get]
 Gets an XML-formatted string that provides a detailed summary of the event - only applicable for the created/modified events More...
 
TrimMainObjectSearch Search [get]
 Gets the search assocated with this history event. It is only available for historical events that are associated with the execution of a search (IsSearch = true). Auditing of record searches needs to be enabled in the audit options page in order to see a history of record searches. 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...
 
Location LastUpdatedBy [get]
 Returns the user that committed the most recent change to this object. 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...
 
bool PossiblyHasSubordinates [get]
 Indicates if this object could possibly have child objects of the same type that can be displayed in a hierarchy. 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

Stores auditing information - a history of events that have happened to objects

Constructor & Destructor Documentation

HP.HPTRIM.SDK.History.History ( Database  database,
TrimURI  uri 
)
HP.HPTRIM.SDK.History.History ( Database  database,
string  name 
)

Property Documentation

Activity HP.HPTRIM.SDK.History.Activity
get

Gets the Activity object to which the event associated with this History object occurred.

string HP.HPTRIM.SDK.History.ClientIPAddress
get

Gets a string value indicating the IP address of the client used to originate the event.

string HP.HPTRIM.SDK.History.ConnectionIPAddress
get

Gets a string value indicating the IP address of computer where the event originated.

Record HP.HPTRIM.SDK.History.ContentRecord
get

Gets the contained record affected by the 'Content Added' and 'Content Removed' events

TrimDateTime HP.HPTRIM.SDK.History.DoneOn
get

Gets the date the audit event corresponding to this History object occurred.

TrimDateTime HP.HPTRIM.SDK.History.DoneOnGMT
get

Gets the date the audit event corresponding to this History object occurred adjusted to GMT time.

TrimDateTime HP.HPTRIM.SDK.History.DoneOnLocal
get

Gets the date the audit event corresponding to this History object occurred adjusted tothe local time of the originator of the event.

string HP.HPTRIM.SDK.History.DoneOnMachine
get

Gets a string value indicating the name of the computer where the event originated.

string HP.HPTRIM.SDK.History.EventDescription
get

Gets a string containing a full description of the audit event corresponding to this History object.

TrimURI HP.HPTRIM.SDK.History.EventObject
get

Gets the URI of the target object of this event

Events HP.HPTRIM.SDK.History.EventType
get

Gets an Events enum value indicating the type of audit event represented by this history object.

BaseObjectTypes HP.HPTRIM.SDK.History.ForObjectType
get

Gets the uri of the object to which the event associated with this History object occurred.

TrimURI HP.HPTRIM.SDK.History.ForObjectUri
get

Gets the uri of the object to which the event associated with this History object occurred.

bool HP.HPTRIM.SDK.History.IsSearch
get

Gets a boolean value indication if this event is a search execution event

bool HP.HPTRIM.SDK.History.IsSecurityViolation
get

Gets a Boolean value indicating whether a security violation has been detected.

Location HP.HPTRIM.SDK.History.Location
get

Gets the Location object to which the event associated with this History object occurred.

string HP.HPTRIM.SDK.History.Login
get

Gets a string containing the network login of the location by whom the audit event corresponding to this History object was performed.

Location HP.HPTRIM.SDK.History.LoginLocation
get

Gets the Location object by whom the audit event corresponding to this History object was performed.

Location HP.HPTRIM.SDK.History.MovementLocation
get

Gets the target Location of the event corresponding to this History event. For 'Assignee Changed', for example, this property holds the Location the record was moved to; for 'Contact Added', this property holds the contact Location that was added. If this event does not involve a target Location, for example, 'Document Removed', this property has a null value.

string HP.HPTRIM.SDK.History.RawEventDescription
get

Gets a string containing a description of what actually took place at the audit event corresponding to this History object. For a full description which includes also the event type, performing location and the date and time of the event.

Record HP.HPTRIM.SDK.History.Record
get

Gets the Record object to which the event associated with this History object occurred.

string HP.HPTRIM.SDK.History.RecordTitle
get

Gets the title of the record object to which the event associated with this History object occurred.

BaseObjectTypes HP.HPTRIM.SDK.History.RelatedObjectType
getset

Gets the type of the related object for this event. Many events have a primary affected object, together with a related object.

TrimURI HP.HPTRIM.SDK.History.RelatedObjectUri
get

Gets the uri of the related object for this event. Many events have a primary affected object, together with a related object.

TrimMainObjectSearch HP.HPTRIM.SDK.History.Search
get

Gets the search assocated with this history event. It is only available for historical events that are associated with the execution of a search (IsSearch = true). Auditing of record searches needs to be enabled in the audit options page in order to see a history of record searches.

string HP.HPTRIM.SDK.History.SearchTitle
get

Gets a string value describing the search that was executed (only for search execution events)

string HP.HPTRIM.SDK.History.TextSummary
get

Gets an text string that provides a detailed summary of the event - only applicable for the created/modified events

string HP.HPTRIM.SDK.History.UpdateComments
get

Gets a string value indicating any comments provided with the object modified event

Workflow HP.HPTRIM.SDK.History.Workflow
get

Gets the Workflow to which the event associated with this History object occurred.

string HP.HPTRIM.SDK.History.XmlSummary
get

Gets an XML-formatted string that provides a detailed summary of the event - only applicable for the created/modified events