Micro Focus Content Manager SDK 10.1
TRIM.SDK.RecordAction Class Reference

An Action associated with a Record More...

Inheritance diagram for TRIM.SDK.RecordAction:
TRIM.SDK.TrimMainObject TRIM.SDK.ITrimNotes TRIM.SDK.TrimObject TRIM.SDK.TrimPropertySet

Public Member Functions

 RecordAction (Database database, TrimURI uri)
 
 RecordAction (Database database, string name)
 
void SetNotes (string newValue, NotesUpdateType TypeOfNotesUpdate)
 Updates the notes attached to this object. Typically used when a new contibution is to be combined with the existing notes, as some users only have the privilige to add to the notes, rather than overwriting them. More...
 
- Public Member Functions inherited from TRIM.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...
 
virtual void Reindex (bool doWordIndex, bool doAdditionalFields, bool doContentEngine)
 Sends an indexing request to the event processor to update main text index on the object, indexes for additional fields or indexes for the content engine. More...
 
- Public Member Functions inherited from TRIM.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 TRIM.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

string ActionName [get]
 Gets a string value which is the name of the record action. More...
 
int ActualDays [get]
 Gets a number indicating the number of days portion of the actual duration of this action. More...
 
string ActualDuration [get]
 Gets a string that displays a formatted version of the actual duration. More...
 
int ActualHours [get]
 Gets a number indicating the number of hours portion of the actual duration of this action. More...
 
int ActualMinutes [get]
 Gets a number indicating the number of minutes portion of the actual duration of this action. More...
 
LocationAssignedBy [get]
 Gets a location object representing the user responsible for allocating the current assignee for this action. More...
 
TrimDateTime AttachDate [get]
 Gets a date and time when this action was attached to its record. More...
 
string Barcode [get]
 Gets a string that is a barcode representing this record action. More...
 
LocationCompletedBy [get]
 Gets a location object represnting the person responsible for actually completing this action. More...
 
bool CompletedOnTime [get]
 Gets a boolean value indicating whether this action has been completed and was completed before the due date. More...
 
TrimCurrency Cost [get]
 Gets a currency value indicating the estimated cost of completing this action. More...
 
int Days [get]
 Gets a number indicating the number of days portion of the estimated duration of this action. More...
 
bool Done [get]
 Gets a boolean value indicating whether this record action has been completed. More...
 
TrimDateTime DueDate [get]
 Gets a date and time when this action was meant to be completed. More...
 
string Duration [get]
 Gets a string that displays a formatted version of the estimated duration. More...
 
TrimDateTime EndDate [get]
 Gets a date and time when this action was actually completed. More...
 
int Hours [get]
 Gets a number indicating the number of hours portion of the estimated duration of this action. More...
 
string Instructions [get]
 Gets a string containing any instructions regarding this record action. More...
 
bool IsReadyToStart [get]
 Gets a boolean value indicating whether this action is ready to be started. More...
 
bool LockDates [get]
 Gets a boolean property indicating that, for this action, any calculated start and due dates will not be modified by any rescheduling operation. More...
 
int Minutes [get]
 Gets a number indicating the number of minutes portion of the estimated duration of this action. More...
 
bool Overdue [get]
 Gets a boolean value indicating whether this record action is currently overdue. More...
 
RecordActionParentRecordAction [get]
 Gets a uri value for the parent action of this record action if it is step within a procedure. More...
 
int PercentComplete [get]
 Gets a number indication the percentage of the work on this action that has been completed. More...
 
bool Procedure [get]
 Gets a boolean value indicating whether this record action is part of a record action procedure. More...
 
RecordRecord [get]
 Gets the record object associated with this record action. More...
 
LocationResponsibility [get]
 Gets a location object represnting the person assigned to performing this action. More...
 
TrimDateTime StartDate [get]
 Gets a date and time when this action was meant to be started. More...
 
string Status [get]
 Gets a string value describing the current status of this record action. More...
 
TrimDateTime SuspendUntil [get]
 Gets a date and time that indicates the date until this action is suspended. More...
 
bool Viewable [get]
 Gets a boolean property indicating if the current user has access rights to view the metadata of the record associated with this record action. More...
 
bool CanModifyExistingNotes [get]
 
bool CanAddToNotes [get]
 
string Notes [get, set]
 
- Properties inherited from TRIM.SDK.TrimMainObject
TrimDateTime LastUpdatedOn [get]
 Returns the date and time that changes to this object were last committed. More...
 
LocationLastUpdatedBy [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 TRIM.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 TRIM.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...
 
- Properties inherited from TRIM.SDK.ITrimNotes
bool CanModifyExistingNotes [get]
 Gets a boolean parameter indicating whether the current user can modify the existing notes attached to this object. More...
 
bool CanAddToNotes [get]
 Gets a boolean value indicating whether the current user can either append or prepend some text to the existing notes. More...
 
string Notes [get, set]
 Gets or sets a string value corresponding to the notes attached to this object. More...
 

Detailed Description

An Action associated with a Record

Constructor & Destructor Documentation

◆ RecordAction() [1/2]

TRIM.SDK.RecordAction.RecordAction ( Database  database,
TrimURI  uri 
)

◆ RecordAction() [2/2]

TRIM.SDK.RecordAction.RecordAction ( Database  database,
string  name 
)

Member Function Documentation

◆ SetNotes()

void TRIM.SDK.RecordAction.SetNotes ( string  NewNotesText,
NotesUpdateType  TypeOfNotesUpdate 
)

Updates the notes attached to this object. Typically used when a new contibution is to be combined with the existing notes, as some users only have the privilige to add to the notes, rather than overwriting them.

Implements TRIM.SDK.ITrimNotes.

Property Documentation

◆ ActionName

string TRIM.SDK.RecordAction.ActionName
get

Gets a string value which is the name of the record action.

◆ ActualDays

int TRIM.SDK.RecordAction.ActualDays
get

Gets a number indicating the number of days portion of the actual duration of this action.

◆ ActualDuration

string TRIM.SDK.RecordAction.ActualDuration
get

Gets a string that displays a formatted version of the actual duration.

◆ ActualHours

int TRIM.SDK.RecordAction.ActualHours
get

Gets a number indicating the number of hours portion of the actual duration of this action.

◆ ActualMinutes

int TRIM.SDK.RecordAction.ActualMinutes
get

Gets a number indicating the number of minutes portion of the actual duration of this action.

◆ AssignedBy

Location? TRIM.SDK.RecordAction.AssignedBy
get

Gets a location object representing the user responsible for allocating the current assignee for this action.

◆ AttachDate

TrimDateTime TRIM.SDK.RecordAction.AttachDate
get

Gets a date and time when this action was attached to its record.

◆ Barcode

string TRIM.SDK.RecordAction.Barcode
get

Gets a string that is a barcode representing this record action.

◆ CanAddToNotes

bool TRIM.SDK.RecordAction.CanAddToNotes
get

◆ CanModifyExistingNotes

bool TRIM.SDK.RecordAction.CanModifyExistingNotes
get

◆ CompletedBy

Location? TRIM.SDK.RecordAction.CompletedBy
get

Gets a location object represnting the person responsible for actually completing this action.

◆ CompletedOnTime

bool TRIM.SDK.RecordAction.CompletedOnTime
get

Gets a boolean value indicating whether this action has been completed and was completed before the due date.

◆ Cost

TrimCurrency TRIM.SDK.RecordAction.Cost
get

Gets a currency value indicating the estimated cost of completing this action.

◆ Days

int TRIM.SDK.RecordAction.Days
get

Gets a number indicating the number of days portion of the estimated duration of this action.

◆ Done

bool TRIM.SDK.RecordAction.Done
get

Gets a boolean value indicating whether this record action has been completed.

◆ DueDate

TrimDateTime TRIM.SDK.RecordAction.DueDate
get

Gets a date and time when this action was meant to be completed.

◆ Duration

string TRIM.SDK.RecordAction.Duration
get

Gets a string that displays a formatted version of the estimated duration.

◆ EndDate

TrimDateTime TRIM.SDK.RecordAction.EndDate
get

Gets a date and time when this action was actually completed.

◆ Hours

int TRIM.SDK.RecordAction.Hours
get

Gets a number indicating the number of hours portion of the estimated duration of this action.

◆ Instructions

string TRIM.SDK.RecordAction.Instructions
get

Gets a string containing any instructions regarding this record action.

◆ IsReadyToStart

bool TRIM.SDK.RecordAction.IsReadyToStart
get

Gets a boolean value indicating whether this action is ready to be started.

◆ LockDates

bool TRIM.SDK.RecordAction.LockDates
get

Gets a boolean property indicating that, for this action, any calculated start and due dates will not be modified by any rescheduling operation.

◆ Minutes

int TRIM.SDK.RecordAction.Minutes
get

Gets a number indicating the number of minutes portion of the estimated duration of this action.

◆ Notes

string TRIM.SDK.RecordAction.Notes
getset

◆ Overdue

bool TRIM.SDK.RecordAction.Overdue
get

Gets a boolean value indicating whether this record action is currently overdue.

◆ ParentRecordAction

RecordAction? TRIM.SDK.RecordAction.ParentRecordAction
get

Gets a uri value for the parent action of this record action if it is step within a procedure.

◆ PercentComplete

int TRIM.SDK.RecordAction.PercentComplete
get

Gets a number indication the percentage of the work on this action that has been completed.

◆ Procedure

bool TRIM.SDK.RecordAction.Procedure
get

Gets a boolean value indicating whether this record action is part of a record action procedure.

◆ Record

Record? TRIM.SDK.RecordAction.Record
get

Gets the record object associated with this record action.

◆ Responsibility

Location? TRIM.SDK.RecordAction.Responsibility
get

Gets a location object represnting the person assigned to performing this action.

◆ StartDate

TrimDateTime TRIM.SDK.RecordAction.StartDate
get

Gets a date and time when this action was meant to be started.

◆ Status

string TRIM.SDK.RecordAction.Status
get

Gets a string value describing the current status of this record action.

◆ SuspendUntil

TrimDateTime TRIM.SDK.RecordAction.SuspendUntil
get

Gets a date and time that indicates the date until this action is suspended.

◆ Viewable

bool TRIM.SDK.RecordAction.Viewable
get

Gets a boolean property indicating if the current user has access rights to view the metadata of the record associated with this record action.