Entity State Example

Shows how the values of the entities that support pending state change at different stages during the MBO update process. The values that change between different states appear in bold.

Note these entity behaviors:

The IsDirty flag is set if the entity changes in memory but is not yet written to the database. Once you save the MBO, this flag clears.
The ReplayCounter value that gets sent to the Unwired Server is the value in the database before you call SubmitPending. After a successful replay, that value is imported from the Unwired Server.
The last two entries in the table are two possible results from the operation; only one of these results can occur for a replay request.

Description	Flags/Values
After reading from the database, before any changes are made.	IsNew=false IsCreated=false IsDirty=false IsDeleted=false IsUpdated=false Pending=false PendingChange='N' ReplayCounter=33422977 ReplayPending=0 ReplayFailure=0
One or more attributes are changed, but changes not saved.	IsNew=false IsCreated=false IsDirty=true IsDeleted=false IsUpdated=false Pending=false PendingChange='N' ReplayCounter=33422977 ReplayPending=0 ReplayFailure=0
After entity.Save()[entity save] or entity.Update()[entity update] is called.	IsNew=false IsCreated=false IsDirty=false IsDeleted=false IsUpdated=true Pending=true PendingChange='U' ReplayCounter=33424979 ReplayPending=0 ReplayFailure=0
After entity.SubmitPending()[entity submitPending] is called to submit the MBO to the server.	IsNew=false IsCreated=false IsDirty=false IsDeleted=false IsUpdated=true Pending=true PendingChange='U' ReplayCounter=33424981 ReplayPending=33424981 ReplayFailure=0
Possible result: the Unwired Server accepts the update, sends an import and a ReplayResult for the entity, and then refreshes the entity from the database.	IsNew=false IsCreated=false IsDirty=false IsDeleted=false IsUpdated=false Pending=false PendingChange='N' ReplayCounter=33422977 replayPending=0 ReplayFailure=0
Possible result: The Unwired Server rejects the update, sends a ReplayFailure for the entity, and refreshes the entity from the database	IsNew=false IsCreated=false IsDirty=false IsDeleted=false IsUpdated=true Pending=true PendingChange='U' ReplayCounter=33424981 ReplayPending=0 ReplayFailure=33424981