Users can act on items. For example, a user can accept an item. Accepting an item can create an event record with an event type of ItemAccept. The following sections explain different actions on items and the resulting event records that are created.
FolderItemDelete is obsolete. Do not use it because it will be removed from the schemas in a future release.
PersonalGroupItemAdd and PersonalGroupItemDelete are defined in the GroupWise 7.0.1 schemas. However, they are not used at this time but are reserved for future use.
When a user accepts a distributed appointment, note, or task, you can expect the following events:
ItemAccept: Created when the distributed item is accepted.
ItemModify: The item has been modified.
FolderItemMove: Reports the moving of the item from the mailbox folder to the calendar.
The first ItemModify event example shows changes to the status of the item, such as the item being opened and read. The second ItemModify example reports the change to the recipient status on the sent item record for the appointment. This ItemModify appears only if the sender is the recipient.
<gwe:event> <gwe:event>ItemAccept</gwe:event> <gwe:id>44E18F4D.domain1.po1.100.16E3837.1.F05.1</gwe:id> <gwe:timeStamp>2012-08-15T15:09:43Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10366</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
<gwe:event> <gwe:event>ItemModify</gwe:event> <gwe:id>44E18F4D.domain1.po1.100.16E3837.1.F05.1</gwe:id> <gwe:timeStamp>2012-08-15T15:09:43Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10368</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
<gwe:event> <gwe:event>ItemModify</gwe:event> <gwe:id>44E18F4C.domain1.po1.100.16E3837.1.F04.1</gwe:id> <gwe:timeStamp>2012-08-15T15:09:43Z</gwe:timeStamp> <gwe:field>RecipientStatus</gwe:field> <gwe:key>GWEvents</gwe:key> <gwe:uid>10367</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
<gwe:event> <gwe:event>FolderItemMove</gwe:event> <gwe:id>44E18F4D.domain1.po1.100.16E3837.1.F05.1</gwe:id> <gwe:timeStamp>2012-08-15T15:09:43Z</gwe:timeStamp> <gwe:container>A.domain1.po1.100.0.1.0.1@19</gwe:container> <gwe:from>7.domain1.po1.100.0.1.0.1@16</gwe:from> <gwe:key>GWEvents</gwe:key> <gwe:uid>10369</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
When a user archives an item, you can expect the following events:
ItemArchive: Created when the item is archived. The item is then deleted and purged from the on-line account.
ItemPurge: Created when an item is purged from the online account.
<gwe:event> <gwe:event>ItemArchive</gwe:event> <gwe:id>44E1A331.domain1.po1.100.16E3837.1.F1B.1</gwe:id> <gwe:timeStamp>2012-08-15T16:34:47Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10438</gwe:uid> </gwe:event>
<gwe:event> <gwe:event>ItemPurge</gwe:event> <gwe:id>44E1A331.domain1.po1.100.16E3837.1.F1B.1</gwe:id> <gwe:timeStamp>2012-08-15T16:34:47Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10439</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
When a user completes a task, you can expect the following events:
ItemComplete: Created when the item is completed.
ItemModify: Created when the recipient status of the sent item is changed to completed.
<gwe:event> <gwe:event>ItemComplete</gwe:event> <gwe:id>44E1A571.domain1.po1.100.16E3837.1.F1E.1</gwe:id> <gwe:timeStamp>2012-08-15T16:52:35Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10502</gwe:uid> <gwe:type>Task</gwe:type> </gwe:event>
<gwe:event> <gwe:event>ItemModify</gwe:event> <gwe:id>44E1A571.domain1.po1.100.16E3837.1.F1D.1</gwe:id> <gwe:timeStamp>2012-08-15T16:52:35Z</gwe:timeStamp> <gwe:field>RecipientStatus</gwe:field> <gwe:key>GWEvents</gwe:key> <gwe:uid>10503</gwe:uid> <gwe:type>Task</gwe:type> </gwe:event>
Deleting a calendar item (appointment, note, or task) creates an ItemDecline event.
<gwe:event> <gwe:event>ItemDecline</gwe:event> <gwe:id>44E0A919.domain1.po1.100.16E3837.1.F00.1</gwe:id> <gwe:timeStamp>2012-08-15T19:49:25Z</gwe:timeStamp> <gwe:from>A.domain1.po1.100.0.1.0.1@19</gwe:from> <gwe:key>GWEvents</gwe:key> <gwe:uid>10544</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
Deleting a mail or phone item creates an ItemDelete event.
<gwe:event> <gwe:event>ItemDelete</gwe:event> <gwe:id>44E0A919.domain1.po1.100.16E3837.1.F00.1</gwe:id> <gwe:timeStamp>2012-08-15T19:49:25Z</gwe:timeStamp> <gwe:from>A.domain1.po1.100.0.1.0.1@19</gwe:from> <gwe:key>GWEvents</gwe:key> <gwe:uid>10544</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
When items are created in a folder, a FolderItemAdd event is created.
<gwe:event> <gwe:event>FolderItemAdd</gwe:event> <gwe:id>44E34395.domain1.po1.100.16E3837.1.F3D.1</gwe:id> <gwe:timeStamp>2012-08-16T22:11:01Z</gwe:timeStamp> <gwe:container>7.domain1.po1.100.0.1.0.1@16</gwe:container> <gwe:key>GWEvents</gwe:key> <gwe:uid>10633</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
When an item is moved from one folder to another folder, a FolderItemMove event is created. The from container is the source folder and the container is the destination folder.
<gwe:event> <gwe:event>FolderItemMove</gwe:event> <gwe:id>44E34395.domain1.po1.100.16E3837.1.F3D.1</gwe:id> <gwe:timeStamp>2012-08-16T22:13:04Z</gwe:timeStamp> <gwe:container>C.domain1.po1.100.0.1.0.1@21</gwe:container> <gwe:from>7.domain1.po1.100.0.1.0.1@16</gwe:from> <gwe:key>GWEvents</gwe:key> <gwe:uid>10634</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
Private items cannot be viewed by proxy users. Marking an item private creates an ItemMarkPrivate event.
<gwe:event> <gwe:event>ItemMarkPrivate</gwe:event> <gwe:id>44E1F6FE.domain1.po1.100.16E3837.1.F2A.1</gwe:id> <gwe:timeStamp>2012-08-15T22:34:59Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10577</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
When an item is opened, the opened and read status flags on an item record are set.
Marking an item read creates an ItemMarkRead event.
<gwe:event> <gwe:event>ItemMarkRead</gwe:event> <gwe:id>44E1F6FE.domain1.po1.100.16E3837.1.F2A.1</gwe:id> <gwe:timeStamp>2012-08-15T22:39:01Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10580</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
By default, items are not private and can be seen by proxy users. Marking an item as not private creates an ItemMarkUnprivate event.
<gwe:event> <gwe:event>ItemMarkUnprivate</gwe:event> <gwe:id>44E1F6FE.domain1.po1.100.16E3837.1.F2A.1</gwe:id> <gwe:timeStamp>2012-08-15T22:35:35Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10578</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
In order for an item to be marked unread, it needs to have been opened first. When an item is opened, the opened and read status flags on an item record are set. When an item is marked unread, the read status flag is reset to not read and the opened flag is not changed.
Marking an item unread creates an ItemMarkRead event.
<gwe:event> <gwe:event>ItemMarkUnread</gwe:event> <gwe:id>44E1F6FE.domain1.po1.100.16E3837.1.F2A.1</gwe:id> <gwe:timeStamp>2012-08-15T22:38:41Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10579</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
ItemModify modifies an existing item.
A distributed item is sent to many users. A personal item is a posted or personal item. The number of fields that can be changed on a item depends on whether it is a distributed or a personal item. On a distributed item, only the category and personal subject can be modified.
Modifying a distributed item creates an ItemModify event. The field element defines the field that was changed on the item. In the following example, the Category and PersonalSubject were both changed.
<gwe:event> <gwe:event>ItemModify</gwe:event> <gwe:id>44E1FB97.domain1.po1.100.16E3837.1.F2C.1</gwe:id> <gwe:timeStamp>2012-08-16T21:17:19Z</gwe:timeStamp> <gwe:field>Category PersonalSubject</gwe:field> <gwe:key>GWEvents</gwe:key> <gwe:uid>10589</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
If an item is personal, most fields can be changed on the item after its sent. In the example below, the Alarm, Category, Classification, and other fields were modified.
<gwe:event>
<gwe:event>ItemModify</gwe:event>
<gwe:id>44E339DD.domain1.po1.100.16E3837.1.F30.1</gwe:id>
<gwe:timeStamp>2012-08-16T21:30:19Z</gwe:timeStamp>
<gwe:field>Alarm Category Classification Duration Place Security
SendPriority StartDate Subject Alarm</gwe:field>
<gwe:key>GWEvents</gwe:key>
<gwe:uid>10592</gwe:uid>
<gwe:type>Appointment</gwe:type>
</gwe:event>
Items that are deleted are moved to the Trash folder. Items can then be purged by deleting them from the Trash. Items can also be purged without sending the item to the Trash. In a client, select , and the item is removed from the user's account without storing the item in the Trash folder.
Purging an item creates an ItemPurge event.
<gwe:event> <gwe:event>ItemDelete</gwe:event> <gwe:id>44E1FB97.domain1.po1.100.16E3837.1.F2C.1</gwe:id> <gwe:timeStamp>2012-08-16T21:34:16Z</gwe:timeStamp> <gwe:from>7.domain1.po1.100.0.1.0.1@16</gwe:from> <gwe:key>GWEvents</gwe:key> <gwe:uid>10594</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
<gwe:event> <gwe:event>ItemPurge</gwe:event> <gwe:id>44E1FB97.domain1.po1.100.16E3837.1.F2C.1</gwe:id> <gwe:timeStamp>2012-08-16T21:34:17Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10595</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
When an application uses the unacceptRequest method defined in GroupWise Web Services, the ItemUnaccept event is created.
<gwe:event> <gwe:event>ItemUnaccept</gwe:event> <gwe:id>44EAE897.domain1.po1.100.16E3837.1.F6A.1</gwe:id> <gwe:timeStamp>2012-08-23T15:24:26Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10747</gwe:uid> <gwe:type>Appointment</gwe:type> </gwe:event>
When a user unarchives an item, the following events can be expected:
ItemUnarchive: Created when the item is unarchived.
FolderItemAdd: Created when the item is re-created in the online account
<gwe:event> <gwe:event>ItemUnarchive</gwe:event> <gwe:id>44E1A461.domain1.po1.100.16E3837.1.F1C.1</gwe:id> <gwe:timeStamp>2012-08-15T16:39:29Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10441</gwe:uid> </gwe:event>
<gwe:event> <gwe:event>FolderItemAdd</gwe:event> <gwe:id>44E1A461.domain1.po1.100.16E3837.1.F1C.1</gwe:id> <gwe:timeStamp>2012-08-15T16:39:29Z</gwe:timeStamp> <gwe:container>7.domain1.po1.100.0.1.0.1@16</gwe:container> <gwe:key>GWEvents</gwe:key> <gwe:uid>10440</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>
When a user marks a task as not being complete, a ItemUncomplete event is created.
<gwe:event> <gwe:event>ItemUncomplete</gwe:event> <gwe:id>44E1A571.domain1.po1.100.16E3837.1.F1E.1</gwe:id> <gwe:timeStamp>2012-08-15T16:51:50Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10492</gwe:uid> <gwe:type>Task</gwe:type> </gwe:event>
Items that are in the trash folder can be undeleted or moved back to the original folder. Undeleting an item creates an ItemUndelete event.
<gwe:event> <gwe:event>ItemUndelete</gwe:event> <gwe:id>44E1F6FE.domain1.po1.100.16E3837.1.F2A.1</gwe:id> <gwe:timeStamp>2012-08-16T21:42:14Z</gwe:timeStamp> <gwe:key>GWEvents</gwe:key> <gwe:uid>10596</gwe:uid> <gwe:type>Mail</gwe:type> </gwe:event>