The Expiration tab is used to specify how long a work item can remain at the Command Line BIC activity and what will happen to the work item if that period is exceeded. Setting an expiration period is optional, but should an error occur with the BIC Manager, an expired Command Line BIC activity will indicate that the BIC Manager was unavailable for a time longer than the expiration period.
To enable work item expiration:
-
Click the Expiration Period checkbox.
-
Specify when the expiration should occur by
clicking any of these options:
Specific Period – If the expiration is set to Specific Period, set the amount of time until work item expiration by entering values in Days, Hours, Minutes, and Seconds fields. You can manually enter the values or click the up and down arrows to fill out the fields. Make sure that at least one of the four fields should be filled out.
The Seconds value must be at least 15 seconds. Setting an expiration period less than 60 seconds will cause delay in the actual work item expiration period because, by default, the Control Manager checks for expired work items every 60 seconds. The expiration polling interval can be reduced by modifying the value of the control.expiredWorkItem.interval setting in <EPX>\bin\config.properties (in the Control Manager Properties section), but before doing so you should consider the impact that this change will have on the performance of your system.
Dynamic Date - If the expiration is set to Dynamic Date, you will need to provide the following:
- Work Item Key – The key you will use to get the actual send date and/or time during runtime. For example, type in "DynamicExpiration.Date" if the expiration date is designated by the Date field of the DynamicExpiration work item type in the work item.
Date Format – The default format is MM dd yyyy HH:mm. Select your desired date format from the Date Format dropdown list or enter values in the combo box.
Format Test – Contains the current date and/or time formatted using the format selected in the Date Format field. Each time a new format is selected, this value is updated to reflect the newly selected format. Refer to "Appendix," on page 16 for the available date formats and time zones.
Instead of setting the expiration date by specifying a work item key, a send action class can be used to set that date. Click the Custom Action tab and enter the fully qualified class name for the custom code in the Send Action Class field.
After filling out the necessary fields, proceed to the next step.
-
Click the Send Work Item checkbox to
automatically send the work item to the next activity in the flow upon
expiration.
Note: The work item cannot go to another point in a flow that needs manual intervention to select a participant. For example, the work item can go to an All split to specify that all participants receive the work item following the split. If it is a Some or a One split, however, manual intervention is required to choose a participant.
- Click the Send E-mail checkbox to automatically notify one or more participants, groups, or roles should the activity expire. When you select the Send E-mail checkbox, the E-mail table is enabled. Use the E-mail table to add e-mail recipients. To add e-mail recipients, select one or more recipients from the E-mail address selection dialog. For more information about the Expiration tab, see the Process Modeling guide.
- Save the data entered and proceed to another tab by clicking Apply. Clicking OK will also save the data entered and exit the Command Line BIC editor. To cancel saving the data entered, click Cancel.