Event-status constants
The event-status constants are typically used in the
poll method to track the current status of an event. Table 110 summarizes the static event-status
constants in the CWConnectorEventStatusConstants class.
Table 110. Static constants of the CWConnectorEventStatusConstants class
Event-status constant |
Meaning |
ERROR_OBJECT_NOT_FOUND |
Error in finding the event in the application
database |
ERROR_POSTING_EVENT |
Error in sending the event to InterChange Server.
A description of the error can be appended to the event description
in the event record. |
ERROR_PROCESSING_EVENT |
Error in processing the event. A description
of the error can be appended to the event description in the event
record. |
IN_PROGRESS |
Event is in progress |
READY_FOR_POLL |
Ready for poll |
SUCCESS |
Sent to connector framework |
UNSUBSCRIBED |
No subscriptions for event |
Figure 69 shows
when the different event-status constants are set.
Figure 69. Event-status values for the poll method
As Figure 69 shows,
the poll method takes the following steps to maintain the status of
an event object:
- The fetchEvents() retrieves the Ready-for-Poll event record and creates an
event object with the READY_FOR_POLL status.
- The getNextEvent() method retrieves a Ready-for-Poll event object from the events
vector and update its status to IN_PROGRESS.
- The poll method uses the isSubscribed() method to check whether the retrieved event has any subscriptions.
- If no subscriptions exist, the poll method uses updateEventStatus() to change the event object's status to UNSUBSCRIBED.
- If subscriptions do exist, execution of the poll event continues
with step 4.
-
The poll method calls the getBO() method to retrieve the application entity's data
to populate the business object.
- If getBO() cannot locate the application entity's data, the
poll method uses updateEventStatus() to change the event object's status to ERROR_OBJECT_NOT_FOUND.
- If the application entity data is found, execution of the poll
event continues with step 5.
-
The poll method calls the gotApplEvent() method to send the business object to the connector framework,
where it is then routed to its destination. The poll method uses
the updateEventStatus() method to change the event object's status to reflect
the success of gotApplEvent(). For a list of event status values that correspond to the gotApplEvent() return codes, see Table 82.
