eventtab.Read()

Syntax

list eventtab.Read(map search-field);

Parameters

Parameter	Type	Description
search-field	map	A field that identifies one or more rows in the synchronization events table, represented as a map object where the column name is the key, and the field value is the value.

Returns

A list of map objects; one for each of the rows (synchronization events) that match the search-field parameter in the synchronization events object.

Sample

The synchronization events table used in the sample below has two columns: one for the mobile user whose synchronization with the server will trigger the processing of the events in the sync events table, and one for a string that will identify the event in the table.

sampleEvents.evem

<Event Name="sampleEvents" xmlns="http://schemas.mobilengine.com/event/v1">
  <Columns>
    <Column Name="user" Type="Text" AgentName="true"></Column>
    <Column Name="item" Type="Text"></Column>
  </Columns>
</Event>

The webform that will trigger the server script has two textbox controls.

dummy.fls.xml

<form id='dummy' menuName='Add list items' platforms='web' xmlns="http://schemas.mobilengine.com/fls/v1">
  <textbox id="todo1" label="List item 1"/>
  <textbox id="todo2" label="List item 2"/>
</form>

The script that the webform triggers will create two synchronization events, and trace their item column values to the activity log.

eventSample.rfs

server program eventSample for form dummy
using eventtab sampleEvents;

{
    var todo1 = form.todo1.text;
    events.sampleEvents.Create({user: form.info.user.name, item: todo1});
    
    var todo2 = form.todo2.text;
    events.sampleEvents.Create({user: form.info.user.name, item: todo2});
    
    var items = events.sampleEvents.Read({user: form.info.user.name});
    foreach(var item in items) trace item.item;
}

"Water plants"
"Buy detergent"

Figure 421. The script above will trace the item column of the events table to the activity log

Developer Documentation

The eventtab type