Creating Events

Why Use Events?

Events specify conditions that must be met before a step in the flow can take place. You can use SAS Visual Data Builder to create two types of events:
  • Time events, which are evaluated based on a specified time being reached
  • File events, which are evaluated based on the state of a specified file
You can create file events if your deployment includes a scheduling server that supports them and the flow is deployed to that scheduling server. Time and file events can be used as triggers (conditions that must be met in order to run a flow on the scheduling server).

Creating a Time Event

You can create a time event and use it as a trigger (a condition that must be met in order to run a flow on the scheduling server).
To create a time event:
  1. On the Schedule window, select Select one or more triggers for this query and then click New Time Event.
  2. On the New Time Event window, specify whether the time event should happen one time only or more than once. If the event should happen only once, specify the date and time for the time event.
  3. If the event should happen multiple times, select the More than once radio button, then select a radio button for how often the event should repeat (such as hourly, weekly, or yearly).
  4. Specify the details of when the time event should repeat. The specific fields that you can use depend on the recurrence interval that you select.
    If the recurrence interval requires you to select start times, use the Hours and Minutes check boxes to select the times. The Minutes area contains groupings of ten-minute intervals. Selecting a check box for the grouping selects all of the minutes in that grouping.
    multiple minutes selected
    To select individual minutes, expand the grouping first.
    single minute selected
    If you select multiple values for Hours, all of the selections for Minutes apply to all of the selected hours. For example, if you select 2:00 AM and 5:00 AM in the Hours area and 43 in the Minutes area, the time event is scheduled for 2:43 AM and 5:43 AM.
    multiple hours selected
  5. If needed, specify the start date and end date for the event. The default is to start at the current date and time and not to have an end date.

Creating a File Event

You can create a file event and use it as a trigger (a condition that must be met in order to run a flow on the scheduling server). The event can check for various file conditions, such as its existence, size, or age.
To create a file event:
  1. On the Schedule window, select Select one or more triggers for this query and then click New File Event.
  2. On the New File Event window, specify or select the file to use for the file event.
  3. Select the condition to evaluate for the file to make the event true. For example, if you selected not exist for the condition, the file event would be true only if the selected file was not in the specified location.
  4. If needed, specify the details (such as size or age) about the condition that you select.