Fields in legacy event records

Once an Event record has been created, the values of its fields must be set. A Schedule workflow task does not set the values of an Event record's fields, except for EventRefId. This is what a Schedule task does:
  • A Schedule workflow task creates an Event record.
  • A Schedule workflow task creates a Recurrence record.
  • A Schedule task sets the values of the Recurrence record's fields with what is specified in the Schedule task's Recurrence section.
  • A Schedule task associates the Recurrence record with the Event record.
An Event record has these fields:
EventStartDate

This is the date and time when the event will happen.

If the Event record has an associated Recurrence record and the selection of recurrence is not None, the date portion of this field will be used to determine the earliest start date, not the actual start date. In this case, the information in the associated Recurrence record determines the actual dates on which the event happens.

The time of day an event starts is always the time of day in this field.

The value of this field must be specified.

EventDuration

This is the duration of the event.

The value of this field must be specified, but can be zero.

EventEndDate

The value of this field is when the event ends.

This is a read-only field. Its value is calculated from the values of EventStartDate and EventDuration fields. The date portion of this value is meaningful only if the date portion of the EventStartDate field is meaningful.

Subject
A person can type a few words into this field to describe what the event is about. The value of this field is copied into the Subject field of Scheduled Event records created from the Event record. The text in a Scheduled Event record's Subject field is used in the label for the Scheduled Event record that is displayed in a calendar tab.
EventType

This is a list field. A workflow may use the value of this field to determine something about the nature of an event.

The value of this field will be an item from a list named Event Type. The Event Type list contains values that are used by multiple applications. Feel free to add items to the Event Type list for other applications. However, it is not safe to remove items in this list or change them unless you are certain that it will not hurt any applications.

EventInstruction
This is a read-only text field that is used to present some text in the Event form.
EventRefId
This is a read-only control number that is used as an Event record's name.
Recurrence Id
This is a read-only field that is used internally by the IBM TRIRIGA Application Platform. It must never be modified by a workflow or the user.

When the values of all the fields of an Event record and its associated Recurrence record have been set to the correct values, you can cause the event they describe to be scheduled by performing a Schedule action on the Event record.

Performing a Schedule action on an Event record causes a Scheduled Event record to be created for occurrences of the event that are scheduled. Another consequence of performing a Schedule action on an Event record is that a SCHEVENTCREATE system event happens to the record that the event is scheduled for.

The way that the life cycle for an Event record is organized, a Schedule action can be performed only once on an Event record.

After a Schedule action is performed on an Event record, its scheduling effect can be undone by performing an Unschedule action on the Event record. Performing an Unschedule action on the Event record does not allow another Schedule action to be performed on the Event record.