The following list summarizes the Entity object
methods:
Note: For all Perl Get and Set methods
that map to Visual Basic Properties, see the Properties section of
this object.
- Method name
- Description
- AddAttachmentFieldValue
- Inserts the file and description into the list
of attachments.
- AddFieldValue
- Adds the specified value to the list of values
in the named field.
- BeginNewFieldUpdateGroup
- Marks the beginning of a series of SetFieldValue
calls.
- Commit
- Updates the database with the changes made to the
Entity object.
- DeleteAttachmentFieldValue
- Deletes the attachment.
- DeleteFieldValue
- Removes the specified value from the field's list
of values.
- EditAttachmentFieldDescription
- Updates the description field of the given attachment.
- EditEntity
- Performs the specified action on a record and makes
the record available for editing.
- FireNamedHook
- Executes a named hook (record script) of this record's EntityDef Object.
- GetActionName
- Returns the name of the action associated with
the current Entity object.
- GetActionType
- Returns the type of the action associated with
the current Entity object.
- GetAllDuplicates
- Returns links to all of the duplicates of this
Entity, including duplicates of duplicates.
- GetAllFieldValues
- Returns an array of FieldInfo objects corresponding
to all of the Entity object's fields.
- GetAttachmentDisplayNameHeader
- Returns the attachment display names, given the
attachment fieldname.
- GetDbId
- Returns the Entity object's database ID number.
- GetDefaultActionName
- Returns the default action associated with the
current state.
- GetDisplayName
- Returns the unique key associated with the Entity.
- GetDisplayNameAsList
- Returns the field values that comprise the unique key of the Entity
as an array.
- GetDisplayNameFields
- Returns a list of field names that comprise the unique key for
the Entity.
- GetDuplicates
- Returns links to the immediate duplicates of this
object.
- GetEntityDefName
- Returns the name of the EntityDef object that serves
as a template for this object.
- GetFieldChoiceList
- Returns the list of permissible values for the
specified field.
- GetFieldChoiceType
- Returns the type of the given choice-list field.
- GetFieldMaxLength
- Returns the maximum length of the field as specified
when you create the field using Rational® ClearQuest® Designer. This
value corresponds to the number of bytes allowed in the column.
- GetFieldNames
- Returns the names of the fields in the Entity object.
- GetFieldOriginalValue
- Returns the FieldInfo containing the value that
the specified field will revert to, if the action is cancelled.
- GetFieldRequiredness
- Identifies the behavior of the specified
field.
- GetFieldStringValue
- Returns the list of values of the specified field
as a single String.
- GetFieldStringValueAsList
- Returns a list of values for the specified field.
- GetFieldStringValues
- Returns the list of values stored for each of the
specified field names.
- GetFieldsUpdatedThisAction
- Returns a FieldInfo object for each field that
was modified by the most recent action.
- GetFieldsUpdatedThisEntireAction
- Returns a FieldInfo object for each field that
was modified by the entire action, including changes made in any initialization
hooks.
- GetFieldsUpdatedThisGroup
- Returns a FieldInfo object for each field that
was modified since the most recent call to BeginNewFieldUpdateGroup.
- GetFieldsUpdatedThisSetValue
- Returns a FieldInfo object for each of the Entity's
fields that was modified by the most recent SetFieldValue call.
- GetFieldType
- Identifies the type of data that can be stored
in the specified field.
- GetFieldValue
- Returns the FieldInfo object for the specified
field.
- GetInvalidFieldValues
- Returns an array of FieldInfo objects corresponding
to all the Entity's incorrect fields.
- GetLegalAccessibleActionDefNames
- Returns the names of accessible actions for a given record (Entity
object) that are both legal for the user and possible to execute if
there is an access control hook defined.
- GetLegalActionDefNames
- Returns the names of the actions that can be used
on this Entity object.
- GetLockOwner
- Can be used to determine whether the record is locked or not.
- GetOriginal
- Returns the Entity object that is marked as the original of
this duplicate object.
- GetOriginalID
- Returns the visible ID of this object's original
Entity object.
- GetSession
- Returns the current Session
Object.
- GetType
- Returns the type (state-based or stateless) of
the Entity.
- HasDuplicates
- Reports whether this object is the original of
one or more duplicates.
- InvalidateFieldChoiceList
- Use with SetFieldChoiceList to
refresh values in a choice list.
- IsDuplicate
- Indicates whether this Entity object has been marked
as a duplicate of another Entity object.
- IsEditable
- Returns True if the Entity object can be modified
at this time.
- IsOriginal
- Returns True if this Entity has duplicates but
is not itself a duplicate.
- LoadAttachment
- Loads an attachment to the specified destination
filename.
- LockRecord
- Creates a lock on the record.
- LookupStateName
- Returns the name of the Entity object's current
state.
- Reload
- Refreshes the current in-memory copy of the record
with the latest value from the database.
- Revert
- Discards any changes made to the Entity object.
- SetFieldChoiceList
- Use with InvalidateFieldChoiceList to
reset choice list values.
- SetFieldRequirednessForCurrentAction
- Sets the behavior of a field for the duration of
the current action.
- SetFieldValue
- Places the specified value in the named field.
- SetFieldValues
- Places the specified values in the named fields.
- SiteHasMastership
- Tests whether this object is mastered in the local
(session) database.
- UnlockRecord
- Releases the lock on the record.
- Validate
- Validates the Entity object and reports any errors.
Additional Perl Get and Set Methods that map to
VBScript properties:
- Method name
- Description
- GetAttachmentFields
- Returns the AttachmentFields collection object
containing this Entity object's attachment fields.
- GetHistoryFields
- Returns the HistoryFields collection object containing
this Entity object's history fields.