Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

If all the fields (except StartTime and StopTime) are left empty, the product, and its associated buckets, will be active the entire time between the StartTime and StopTime. Usage should only be counted in buckets connected to products that are active, and enforcements should only be checked and applied for products that are active.

Periods UDR

Field

Description

ID (int)

The unique ID of the period.

Name (string)

The name of the period.

StartTime (date)

Defines the start date and time for this period. This is the overall start time for the period and this field is mandatory for all periods.

StopTime (date)

Defines the end date and time for this period. This is the overall end time for the period and if it is left empty, the period will have no end.

StartTimeOfDay (date)

Defines the start time of the day in hours and minutes for the this period. The products using this period will start being active at this time of day. The format should be HH:MM.

StopTimeOfDay (date)

Defines the end time of the day in hours and minutes for this period. The products using this period will stop being active at this time of day. The format should be HH:MM.

Weekdays (list <int>)

Determines which weekdays the period should be active. The days are stated with integer values; 0 - Monday, 1 - Tuesday, 2 - Wednesday, 3 - Thursday, 4 - Friday, 5 - Saturday, and 6 - Sunday. Any combination is possible.

IncludedPeriods (list <Period (PCC.Periods)>)

Contains a list with other periods that should be included in this period. Since the list contains periods, they can in turn include or exclude other periods in their respective IncludedPeriods and ExcludedPeriods settings, which can be useful for creating a more complex inclusion setup.

ExcludedPeriods (list<Period (PCC.Periods)>)

Contains a list with other periods that should be excluded from this period. Since the list contains periods, they can in turn include or exclude other periods in their respective IncludedPeriods and ExcludedPeriods settings, which can be useful for creating a more complex exclusion setup.

Below is a screenshot of the UDR Assistance displaying the Periods UDR:

Periods UDR

Configuring a Period

A period configuration can consist of either a single period or a period including or excluding one or several other periods.

...

  • The current time stamp must be within the set StartTime and StopTime of the top level period.

  • If any periods are included, the current time stamp must be within the set StartTimeOfDay and StopTimeOfDay of at least one included period.

  • If any periods are excluded, the current time stamp cannot be within the StartTimeOfDay or StopTimeOfDay of any of the excluded periods.

Example of a Period Configuration

In this example, we have a period including and excluding five other periods, configured as follows:

...