All of the adapter’s work is performed by the poll() method. Scheduling the adapter requires setting up a poll() method to search for and retrieve changed information on the resource.
This method is the main method of the Active Sync-enabled adapter. The adapter manager calls the poll() method to poll the remote resource for changes. The call then converts the changes into IAPI calls and posts them back to a server. This method is called on its own thread and can block for as long as needed.
It should call its ActiveSyncUtil instance’s isStopRequested method and return when true. Check isStopRequested as part of the loop condition when looping through changes.
To configure defaults for polling, you can set the polling-related resource attributes in the adapter file. Setting these polling-related attributes provides administrators with a means to later use the Identity Manager interface to set the start time and date for the poll interval and the length of the interval.
Scheduling Parameters
You use the following scheduling parameters in Active Sync-enabled adapters:
RA_SCHEDULE_INTERVAL
RA_SCHEDULE_INTERVAL_COUNT
RA_SCHEDULE_START_TIME
RA_SCHEDULE_START_DATE
See Table 9–6 for a description of these parameters.
Scheduling Parameters in the prototypeXML
The scheduling parameters are present in the string constant ActiveSync. ACTIVE_SYNC_STD_RES_ATTRS_XML, along with all other general Active Sync-related resource attributes.
The following table describes the usage of scheduling parameters using some sample polling scenarios.
Table 9–26 Sample Polling Scenarios
Polling Scenario |
Parameters |
---|---|
Daily at 2 A.M. |
Interval = day, count =1, start_time=0200 |
Four times daily |
Interval=hour, count=6. |
Poll once every two weeks on Thursday at 5 P.M |
Interval = week, count=2, start date = 20020705 (a Thursday), time = 17:00. |