getEventsRequest

Returns the list of events that are accumulating in the user's account.

Request

<getEventsRequest>
   <key/>
   <from/>
   <until/>
   <uid/>
   <count/>
   <remove/>
   <notify/>
   <view/>
</getEventsRequest>

Response

<getEventsResponse>
   <events>
      <event>
      <event> 
         <id/>
         <timeStamp/>
         <container/> 
         <key/>
      </event>
      . . .
   </events>
   <status>
      <code/>
   </status>
</getEventsResponse>

Definitions

key

String. Uniquely identifies the event configuration in a user's database. It is up to the application to control the uniqueness of the application key. GroupWise Web Services Events uses any key that it is passed. If two applications or two instances of an application pass the same key, GroupWise Web Services Events maps both to one event configuration structure in the user’s database.

from

Provides the starting date for the list of events to be returned.

until

Provides the ending date for the list of events to be returned.

count

Specifies how many events to return. If not specified, all events are returned. We recommend providing a count of 250 or less.

remove

Specifies whether to remove the event. True (1) indicates to remove the event from the database upon a successful response to getEventsRequest.

notify

Specifies whether the application wants to be notified the next time the event it is tracking occurs. The notification process (POA) maintains a list of all applications that want to be notified when that event occurs. Every time an application receives an event notification, it is removed from the notification list. To be placed on the notification list again, an application must send getEventsRequest with the notify element set to True (1). The IP address and port must be in the event definition to be added to the notification list.

event

Identifies a GroupWise event that has occurred for a user, as defined in EventType in events.xsd.

id

Identifies the item, as defined in types.xsd.

timeStamp

Specifies the date and time that the GroupWise event occurred.

container

Specifies the location in the GroupWise account where the event occurred.

status

Specifies whether getEventsRequest was successful.

code

Provides the error number related to the event. 0 means that the request was successful.

view

Specifies the elements that are returned for each item. The view reduces the amount of data returned. If a view is not specified, all elements are returned.

Remarks

After a successful call to configureEventsRequest, events are created in user's database.

The from and until date elements can be used to return a subset of events, based on dates. The from element can be used by itself to return all events greater than the specified time. Another way to return a subset of events is to provide the UID for a specific event and provide a count. A list of events is returned, starting at the UID for the count specified.

Applications should emove events as soon as possible. One way to remove events is to set the remove element to True in getEventsRequest. After the events are returned, the events are purged from the user's store.

Example

<getEventsRequest>
   <key>Acme</key>
   <remove>1</remove>
   <notify>1</notify>
</getEventsRequest>

Following is a sample response to getEventsRequest:


<getEventsResponse>
   <events>
      <event>
         <event>FolderItemAdd</event>
         <id>41937EE0.AutoDomain.AutoPO1.100.1363230.1.272D.1</id>
         <timeStamp>2012-11-11T22:01:55Z</timeStamp>
         <container>7.AutoDomain.AutoPO1.100.0.1.0.1@16</container>
         <key>Acme</key>
      </event>
     <event>
        <event>FolderItemAdd</event>
        <id>41937F2C.AutoDomain.AutoPO1.100.1363230.1.272E.1</id>
        <timeStamp>2012-11-11T22:03:10Z</timeStamp>
        <container>7.AutoDomain.AutoPO1.100.0.1.0.1@16</container>
        <key>Acme</key>
     </event>
   </events>
   <status>
      <code>0</code>
   </status>
</getEventsResponse>