OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

obix-xml message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [obix-xml] History Push


Regarding the response, it is probably better if I give you guy the full text of the entire section and you can see what you think.  Note I have added a "tz" property to the History contract and beefed up the spec in how timezones should work.  All the example queries and rollups how use example timezones.

The Append section now reads as follows:

 

1.1 History Append

The History.append operation allows a client to push new HistoryRecords into a History log (assuming proper security credentials).  This operation comes in handy when bi-direction HTTP connectivity is not available.  For example if a device in the field is behind a firewall, it can still push history data on an interval basis to a server using the append operation.

1.1.1 HistoryAppendIn

The History.append input contract:

<obj href=""obix:HistoryAppendIn">

  <list name="data" of="obix:HistoryRecord"/>

</obj>

The HistoryAppendIn is a wrapper for the list of HistoryRecords to be inserted into the History.  The HistoryRecords SHOULD use a timestamp which matches History.tz.  If the timezone doesn’t match, then the server MUST normalize to its configured timezone based on absolute time.  The HistoryRecords in the data list MUST be sorted by timestamp from oldest to newest, and MUST not include a timestamp equal to or older than History.end.

1.1.2 HistoryAppendOut

The History.append output contract:

<obj href=""obix:HistoryAppendOut">

  <int     name="numAdded"/>

  <int     name="newCount"/>

  <abstime name="newStart" null="true"/>

  <abstime name="newEnd"   null="true"/>

</obj>

The output of the append operation returns the number of new records appended to the History and the new total count, start time, and end time of the entire History.  The newStart and newEnd timestamps MUST have a timezone which matches History.tz.



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]