Multiuser Considerations

All DataSets returned from the ObjAcct Framework API contain a table called ObjAcctInfo, which contains several fields:  ErrorNumber, ErrorMessage and RetrieveTimestamp.

The RetrieveTimestamp contains the time the record was retrieved based on the time on the database server.  This value can be submitted back to the web service (using the class's SaveEntity() or SaveDocument() function) so the ObjAcct Framework can the detect if another user has updated the same record since you retrieved it.  If a multi-user conflict occurs (if another user updated the record after the RetrieveTimestamp), an ErrorNumber -50902 is returned.  Since the data in the DataSet is now out of date, a fresh copy of the record must be retrieved before modifying it and saving it back to the database.