Managing Events

To open the calendar view, click on the calendar displayed under Time-off calendar or Processing Calendars options.


Figure: Calendar View - By Month

The calendar view supports:

By default, calendar opens in the Month view.

Event Markers

Color coded event markers provide an overview of the existing events in the calendar view. Event markers indicate the following:


Figure: Calendar View

Clicking an event marker displays properties of that event. If the event is not from a subscribed calendar, clicking an event marker displays the Event property dialog which supports updating its properties.

If the event is from a subscribed calendar, clicking an event marker displays read-only event properties.

Moving Events via Drag and Drop

You can drag and drop the event in the calendar. Moving the event changes the start date. Note that only events defined in the in-scope calendar can be moved.

To move the event, drag the event marker from its current time to the desired start date.

Time-off Calendars

The Time off calendars define holidays and other blocks of time at which process instances are not triggered from general processing calendars.

Adding a new Time-off Calendar Event

To add a new time-off calendar event:

  1. Create a time-off calendar from the Calendar outline. By default, the calendar displays the current month.


    Figure: Create Calendar - Time-off Calendar

  2. Double-click on the date for which you want to create a new event. The New Event dialog box gets displayed.


    Figure: New Event - Time-off Calendar

  3. Specify the following details to add the event:
  4. Range of Recurrence

The event gets added in the calendar for the specified time period.


Figure: Event

Viewing and Modifying a Time-off Event

To modify a time-off event, perform the following steps:

  1. In the calendar, double-click on the event to view the details
  2. Perform the changes and click Save


    Figure: Modify Time-off Event

Note that events can be modified only from the calendar in which they are defined.

Deleting a Time-off Event

To delete a time-off event, open the event and click Delete. Note that events can be deleted only from the Calendar in which they are defined.

Managing Recurring Events

Allows you to set the pattern and range of recurrence for the Event. For recurring events, the No End Date option is selected, by default. Editing and deleting individual instances of recurring events is not supported.

Editing the Recurring Event

You can edit recurring event from any date of the specified date range. When the user clicks on any of the date of the specified date range, currently the start date is displayed as the start date of the instance the user has clicked on and not the series. The following message is displayed at the top the of dialog box:


Figure: Editing the Recurring Event - Message

Deleting the Recurring Event

You can delete the recurring event from any date of the specified date range.

Subscribing the Time-off Calendars

Processing Calendars and Time-off Calendars can subscribe to Time-off calendars so that events defined in the Subscribed Calendars are included in the Parent Calendars.

Nesting "n" levels deep is supported. That is Calendar A can import Calendar B, and Calendar B in turn imports another Calendar C. However, circular references are not allowed.

To subscribe a calendar, perform the following steps:

  1. Open the Time-off Calendars or General Process Start calendar view from which you want to subscribe the calendars
  2. Select check box for calendars that you want to subscribe. You can select more than one calendar.


    Figure: Subscribed Time-off Calendars

The subscribed event gets displayed in the calendar.


Figure: Subscribed Time-off Calendar Events

In case of updates in the subscribed calendar, the parent calendar reflects these updates. Subscribed events are read-only events and you cannot edit or delete them from the parent calendar. Similarly, subscribed events cannot be dragged and dropped. Note that the Start Time is shown as 12AM and End Time as 11.59PM for All Day event when subscribed in other calendar.

Unsubscribing the Time-off Calendar

To unsubscribe the time-off calendar, open the Time-off Calendars or General Process Start calendar view and clear the check box of calendars that you want to unsubscribe. You can unsubscribe more than one calendar.


Figure: Unsubscribed Time-off Calendar

Read-only Time-off Event

The subscribed time-off events are read-only events. Clicking the subscribed event marker in the calendar displays the read-only properties of the event. If the event is recurring:

The subscribed icon is displayed in the corner of the dialog box to indicate that it is read-only.

The recurring event icon is also displayed in the corner of the dialog box.

Processing Calendars

Processing calendars support scheduling general process start events and business object dependent process start events. Note that processing calendars cannot be added manually.

General Process Start Calendar

The general process start calendar provides a central point for scheduling processing events that are not dependent upon business objects. The events defined in this calendar simply trigger one process instance per process start event. Note that events can only trigger process definitions with a manual trigger. Note that the General Process Start Calendar is provided by default, and cannot be deleted or renamed.

Note: General Process start event shows all startable processes created in the Eclipse based modeler, Modeling perspective or Model & Go! perspective.

You can add, modify and delete the general process start event.

Adding a General Process Start Calendar Event

To add a general process start calendar event, perform the following steps:

  1. Click on the date on which you want to add the event. The New Event dialog box gets displayed.


    Figure: New Event - General Process Start

  2. Specify the following details to add the event:
  3. Click Save to add the event. The event gets added in the calendar.

Modifying a General Process Start Calendar

To modify a general process start event, perform the following steps:

  1. In the calendar, double-click on the event to view the details
  2. Perform the changes and click Save

Note that events can be modified only from the Calendar in which they are defined.

Deleting a General Process Start Event

To delete a general process start event, open the event and click Delete. Note that events can be deleted only from the Calendar in which they are defined.

Business Object Instance Process Start Calendar

The Business Object instance process start calendar provides a calendar for each business object instance. Calendars are added and deleted dynamically as new business object instances are added and deleted. These calendars are provided for scheduling events that trigger process instances and apply business object instance data to the process instance. Business Object Instance based calendar shows processes only from Model & Go! related to selected business object instance. They can also spawn multiple process instances - one for each related business object instance. For details on Business Objects, please refer to the chapter Business Objects Business Objects of the IPP Concepts. Concepts in the Documentation.

Each Event defined in these calendars can trigger either:

Events can trigger process definitions created in the Model & Go! perspective and marked for business calendar start.

Note that to work with Business Object dependent Calendars, you need perform the following steps:

  1. Create a model with a business object data and deploy the same in the Modeling perspective.
  2. In the Control Center perspective, create instances of that business object.
  3. Then, in the Model & Go! perspective, using the same business object, deploy the process.

A business object instance calendar nodes are created based on the value provided in the business object instance Name Field.


Figure: Business Object Instance - Name Field

For example, you specified a value ABCCompany and XYZ Company in the Name field as the instances of the business object named Customer. Then, the business object instance calendar would be created based on these values under the business object node of the specific model as shown in the following screenshot.


Figure: Business Object Instance - Calendar Nodes

Adding a Business Object Instance Process Start Event

To add a business object instance process start event, perform the following steps:

  1. Click on the business object instance to open its calendar
  2. Click on the date on which you want to add the event. The New Event dialog box gets displayed.


    Figure: New Event

  3. Specify the following details to add the event:

Modifying a Business Object Instance Process Start Event

To modify a business object instance process start event, perform the following steps:

Note that events can be modified only from the Calendar in which they are defined.

Deleting a Business Object Instance Process Start Event

To delete a business object instance process start event, open the event and click Delete. Note that events can be deleted only from the calendar in which they are defined.

Examples

Note: You need to start the Business Calendar daemon before scheduling any process start from the Calendar perspective. For more information, please refer to the section Business Calendar Daemon of the Daemons chapter from the Concepts handbook.

Scheduling the Process Start from General Process Start Calendar

  1. Deploy the model in the Modeling perspective or Model & Go! perspective
  2. Switch to the Calendar perspective
  3. In the calendar outline, click on the General Process Start Calendar
  4. Set the event for the current day and time as shown in the following screenshot. Note that the start date and time is set as 03/26/15 05:00 PM.


    Figure: Set Time

  5. Switch to the Workflow execution perspective and wait for the clock to tick 5:00 PM.
  6. Notice that the process is started at 5:00 PM as shown in the following screenshot:


    Figure: Scheduled Process Start

Scheduling the Process Start from the Subscribed Time-off Event

  1. Deploy the model in the Modeling perspective or Model & Go! perspective
  2. Switch to the Calendar perspective
  3. Define the time-off event for a specific date as shown in the following example:


    Figure: Time-off Event - Holiday

  4. In the General Process Start calendar, subscribe the time-off event as shown in the following screenshot:


    Figure: Subscribed Time-off Event

  5. Define a general process start event and match its date and time with subscribed time-off event as shown in the following screenshot:


    Figure: General Process Start Event

  6. Check the worklist. Verify that the worklist is empty. Note that the process start event is blocked.