/ doc / DocFrag / ARCCore.ClientUpdatePosition / Description

Description

Edit keys at this level only

= Describes from WHERE (from WHEN) in the historic -PropertyStream- new data is to be returned.0x000D0x000A(or actually, it describes up to which point in time client already has updated data).0x000D0x000A0x000D0x000ACommunicated between client and server as follows:0x000D0x000A0x000D0x000A1) At initialization of -ActualConnection-:0x000D0x000ASent by client to server in order to inform the server about the client's update status.0x000D0x000A0x000D0x000A2) For every new -PropertyStreamLine- sent from server to client:0x000D0x000ASent by server to client. Done by prepending to the -PropertyStreamLine- being sent, with '::' (double colon) as a separator.0x000D0x000AExplains from where in the -PropertyStream- this line originated.0x000D0x000AThe server also keeps track of the last value sent to the client as long as the -ActualConnection- is active.0x000D0x000A0x000D0x000AUsed in connection with -Subscription- which describes WHAT data is required from the -PropertyStream-.0x000D0x000ATODO: Clarify difference between -ClientUpdatePosition- and -FromTime- / -ToTime-.0x000D0x000A0x000D0x000ATODO: Build revision number into this? (-DataRetention- or keep in filename?0x000D0x000A0x000D0x000ATODO: Ensure that the format being used suits the encoding mechanism well (see EncodeValuePart) (no special encoding should be necessary as want a human readable format also after encoding)0x000D0x000A0x000D0x000ADescribes status of a client's up-to-date level.0x000D0x000ANote that client in this case not only means -Client- but any -ARNodeType-.0x000D0x000Ar0x000AExamples:0x000D0x000A0x000D0x000A1) 'ClientDatastoreIsEmpty' (see -ClientDatastoreIsEmpty-).0x000D0x000A0x000D0x000A2) 'OnlyNewDataIsRequested' (see -OnlyNewDataIsRequested-).0x000D0x000A0x000D0x000A3) 'GoBack|1000' (see -IsGoBack-) means start from 1000 elements back.0x000D0x000A0x000D0x000A4) 'StorageFile0042|42042': The common scenario. Last update was index 42042 in 'StorageFile0042', next update should be at least 42043 (or index 0 in next file)0x000D0x000A0x000D0x000AAn 'IsEndOfStream' marker may be added, like this:0x000D0x000A'StorageFile0068|42042042|IsEndOfStream' (see -IsAtEndOfStream-).0x000D0x000A0x000D0x000AThis class is immutable.0x000D0x000A

Edit keys at all sub levels.
NOTE: Edits are always additive. Use 'Invalid' in order to delete keys.

Generated 2025-08-14 18:03:23.675 UTC