ListEventObservations

From The Contingency Market

Jump to: navigation, search

Contents

ListEventObservations(ulSessionID,uSequenceID,sIntegrity,sEventID,sAgentID,sSince,uLimit)

Returns at most uLimit observations of this event where the occurrence time is after sSince. Includes any official observation. An observation of an event is either an observation that it occurred, or an observation that it became impossible.

PARAMETERS

ulong ulSessionID 
ID of authenticated session.
uint uSequenceID 
Sequence number.
string sIntegrity 
md5("ipaddr(sid,seq)->ListEventObservations(sEventID,sAgent,sSince,uLimit)/secret")
string sEventID 
ID of event whose observations should be returned.
string sAgentID 
ID of agent whose observations should be returned.
string sSince 
Earliest observation date to count from. NB Not a TimeInstant or DateTime. The timezone is UTC.
uint uLimit 
Maximum number of event observations to return (0=all).

RETURNS

[ SEventRecordData {sEventID,sParameterValue,sParameterType,sAgentIDObserver,bOccurred,sTimeOccurred,sTimeObserved} ]

string sEventID 
ID of event observed to occur.
string sParameterValue 
The value the event parameter is observed to have (blank if unknown).
string sParameterType 
Type of the parameter.
string sAgentIDObserver 
Empty if official, otherwise ID of most recent observer.
bool bOccurred 
True if this is a record of the event occurring, False if a record of the event becoming impossible.
string sTimeOccurred 
Time at which the event occurred/or not.
string sTimeObserved 
Time this event record was originally submitted - Blank for official observations.

FAULTS

Session. Time format.

TEST

ListEventObservations() according to the respective template currently returns Event #185d426e5d434d79a044434a376c971a was registered observed by agent # at 1787-09-17T12:00:00.0000000Z to have a perpetual value of 1:Count(Number) as at 1787-09-17T12:00:00.0000000Z, which means that it is occurring.

Views
Personal tools