CALE_LOOK_AHEAD

Use the CALE_LOOK_AHEAD script function in two ways. In Workflows or Schedules, you can determine the next execution date of an included object depending on its calendar conditions. The particular task number identifies the object. For details about task numbers, see Task Boxes in Workflows, for example. Alternatively, you can use this script function to calculate the next date on which one, all, or no calendar conditions apply. You can define a maximum of five Calendars, including Calendar events. The administrator can specify the maximum number of days that should be considered for each client in the UC_CLIENT_SETTINGS variable with the CALE_LOOK_AHEAD_MAX key, see CALENDAR Parameters.

Syntax

CALE_LOOK_AHEAD ([[Date Format]:Date], JOBP|JSCH, Task Number)
CALE_LOOK_AHEAD ([[Date Format]:Date], Condition, Calendar, Calendar Event [ [,Calendar][,Calendar Event] ]...)

Parameters

  • CALE_LOOK_AHEAD
    Returns the next date based on calendar conditions
  • Date
    (Optional) Define the date from which on the calendar condition should be checked. If no date is specified, the current date is used for the calculation.
  • JOBP|JSCH
    Name of a workflow or schedule
    Format: script literal or script variable
  • Task Number
    Task number in the workflow or schedule
    Format: script literal or script variable
  • Condition
    A condition that must comply with the date definition. If no calendar condition applies to a task, this script function returns a blank. In this case, CALE_LOOK_AHEAD_MAX is displayed in the Schedule Monitor (see Monitoring Schedules).
    Format: script literal or script variable
    Allowed values:

    • ONE
      One of the given calendar conditions must apply
    • ALL
      All the given calendar conditions must apply
    • NO
      None of the given calendar conditions must apply
  • Calendar
    (Optional) Name of a Calendar object
    Format: script literal or script variable
  • Calendar Event
    (Optional) Calendar Event in the Calendar object. Always use this parameter together with the Calendar parameter.
    Format: script literal or script variable

Return codes

  • Date in the specified format
  • " "
    No calendar condition applies


Examples

The following example shows how you can identify the next date on which the object with task number 3 will run in the MM.DAY workflow.

:SET  &DATE# = CALE_LOOK_AHEAD('YYYYMMDD:20201010','MM.DAY','3')

The second example identifies the next date on which all assigned calendar conditions apply.

:SET  &DATE# = CALE_LOOK_AHEAD(,'ALL','FIRM.CALENDAR','WORKDAYS','FIRM.CALENDAR','READINESS01')

See also: