Standard Properties of Business Objects

This page describes the standard properties that exist in every business object.

All business objects have properties called Key, Revision, and Stamp. The Service Edge server assigns these properties when an object is created or updated.

Dictionary items have the Key and Revision properties. They do not have a Stamp property.

Key

A unique integer identifier for an object in the Service Edge database. No two objects in the database. whether of the same or different types. can have the same key.
When you create an object and add it to the database, the server assigns the Key. A value of Key = -1 means that the object does not yet exist in the database, and the key is unassigned.

Revision

A serial number (1, 2, ...) representing the version or revision of an object in the database. The system increments the revision number automatically whenever you update an object in the database.
If you attempt to update an object with a revision number that is earlier than the existing revision number in the database, the system rejects the update. This can occur, for example, if your code is working with an old revision that has since been updated by another user. In that case, you should retrieve the latest revision of the object from the database before you try to update it.

Stamp

A stamp indicating the user and time when an object was created or updated. The server assigns the creation fields when you first add an object to the database and the update fields whenever you update the object.

<Stamp>
  <CreatedBy>CLICKSOFTWARE\JimS</CreatedBy>
  <TimeCreated>2009-03-14T19:07:38</TimeCreated>
  <CreatingProcess>0</CreatingProcess>
  <ModifiedBy>CLICKSOFTWARE\JimS</ModifiedBy>
  <TimeModified>2009-03-14T21:14:26</TimeModified>
  <ModifyingProcess>0</ModifyingProcess>
</Stamp>