Getting Entity objects
To obtain an existing Entity object whose ID you know, you can use the Session object's GetEntity or GetEntityByDbId methods. If you do not know the ID of the record, you can use the Session object's BuildQuery method to create a query and search for records that match a desired set of criteria. Entity objects found using these techniques are read-only. To edit an Entity object, you must call the Session object's EditEntity method.
After you acquire an Entity object, you can call its methods
to perform tasks such as the following:
Note: The methods listed here is a
sample of the methods you can use for each task. It is not a complete list
of all methods you can use.
- Task
- Entity Object methods you can use
- Examine or modify the values of a field
- Validate and commit the record
- Validate, Commit
- Determine which fields must be filled in by the user
- GetFieldRequiredness
- Determine the acceptable values for each field, and which fields have incorrect values
- Determine which fields have been updated
GetFieldsUpdatedThisAction,
GetFieldsUpdatedThisGroup,
GetFieldsUpdatedThisSetValue- Find other data records that are considered duplicates of this one
- GetDuplicates
- Find the original data record, if this one is a duplicate
- GetFieldOriginalValue