Time Series Functions

Time Series Function are useful to evaluate and compare the business performance against time period, analyzing the data for multiple periods.

1. Ago:  calculates the aggregated value from the current time back to a specified time period.

Ex: Month Ago Revenue, Year Ago Revenue

Syntax: AGO(expr, [time_level], offset)

Expr is an expression that references at least one measure column.

Time_level is Level in the Time Hierarchy, such as quarter, month, or year.

Offset is an integer literal that represents the time shift amount.

2. ToDate: aggregates a measure attribute from the beginning of a specified time period to the current time

Ex: Year To Date Revenue (YTD), Mont To Date Revenue ( MTD)

Syntax: TODATE(expr, time_level)

3. Periodic Rolling: This function computes the sum of a measure over the period starting offset of time and ending offset of time from the current time

Ex: 3Month Rolling Revenue

Syntax: PERIODROLLING(expr, starting period offset [,ending period offset])

Practice: (Copied from Oracle Tutorial)

Identifying a Logical Dimension as a Time Dimension

1. Return to the Administration Tool and open the BISAMPLE repository in offline mode.
2. In the BMM layer, double-click the H1 Time logical dimension to open the Logical Dimension dialog box.

3. In the Structure section, select Time.

Time series functions operate on time-oriented dimensions. To use these functions on a particular dimension, you must designate the dimension as a Time dimension.

4. Click OK to close the Logical Dimension dialog box.

 Identifying Level Keys as Chronological Keys

1. Expand the H1 Time logical dimension and double-click the Time Detail level to open the Logical Level dialog box.
2. Click the Keys tab.

3. Select the Chronological Key check box for Calendar Date.

4. Click OK to close the Logical Level dialog box.
5. Repeat and set chronological keys for the following levels:

Logical Level	Chronological Key
Year	Per Name Year
Half	Per Name Half
Quarter	Per Name Qtr
Month	Per Name Month
Week	Per Name Week

6. It is best practice to designate a chronological key for every level of a time logical dimension.
7. 
   

 Creating a Measure Using the AGO Function

1. Right-click the F1 Revenue logical table and select New Object > Logical Column.
2. On the General tab, name the column Month Ago Revenue.

3. On the Column Source tab, select "Derived from existing columns using an expression".

4. Open the Expression Builder.
5. Select Functions > Time Series Functions > Ago.

6. Double-click Ago or click Insert selected item to add the Ago function to the Expression Builder.

7. Click <<Measure>>in the expression.

8. Select Logical Tables > F1 Revenue and then double-click Revenue to add it to the expression.

9. Click <<Level>> in the expression.

10. Select Time Dimensions > H1 Time and then double-click Month to add it to the expression.

11. Click <<Number of Periods>> and enter 1. The Ago function will calculate the Revenue value one month before the current month.

12. Click OK to close the Expression Builder. Check your work in the Logical Column dialog box:

13. Click OK to close the Logical Column dialog box. The Month Ago Revenue time series measure is added to the F1 Revenue logical table.

14. Drag the Month Ago Revenue logical column to the Base Facts presentation folder.

 Creating a Measure Using the TODATE Function

1. Right-click the F1 Revenue logical table and select New Object > Logical Column.
2. On the General tab, name the new logical column Year To Date Revenue.

3. On the Column Source tab, select "Derived from existing columns using an expression".

4. Open the Expression Builder.
5. Select Functions > Time Series Functions and double-click ToDate to insert the expression.

6. Click <<Measure>> in the expression.

7. Select Logical Tables > F1 Revenue and then double-click Revenue to add it to the expression.

8. Click <<Level>> in the expression.

9. Select Time Dimensions > H1 Time and then double-click Year to add it to the expression.

10. Click OK to close the Expression Builder.
11. Check your work in the Logical Column dialog box.

12. Click OK to close the Logical Column dialog box.
13. Drag the Year To Date Revenue logical column to the Base Facts presentation folder.

 Creating a Measure Using the PERIODROLLING Function

1. Right-click the F1 Revenue logical table and select New Object > Logical Column.
2. On the General tab, name the new logical column Revenue 3-Period Rolling Sum.

3. On the Column Source tab, select "Derived from existing columns using an expression".

4. Open the Expression Builder.
5. Select Functions > Time Series Functions and double-click PeriodRolling to insert the expression.

6. Click <<Measure>> in the expression.

7. Select Logical Tables > F1 Revenue and then double-click Revenue to add it to the expression.

8. Click <<Starting Period Offset>> in the expression.

9. Enter -2. This identifies the first period in the rolling aggregation.

10. Click <<Ending Period Offset>>.

11. Enter 0. This identifies the last period in the rolling aggregation.

These integers are the relative number of periods from a displayed period. In this example, if the query grain is month, the 3 month rolling sum starts two months in the past (-2) and includes the current month (0).

12. Click OK to close the Expression Builder.
13. Check your work in the Logical Column dialog box.

14. Click OK to close the Logical Column dialog box.
15. Drag the Revenue 3-Period Rolling Sum logical column to the Base Facts presentation folder.

16. Save the repository and check consistency. Fix any errors or warnings before you proceed.
17. Close the repository. Leave the Administration Tool open.

 Testing Your Work

1. Return to Oracle Enterprise Manager and load the BISAMPLE repository.
2. Return to Oracle BI and sign in.
3. Create the following analysis to test AGO and TODATE functions:

Time.Per Name Month
Time.Per Name Year
Base Facts.Revenue
Base Facts.Month Ago Revenue
Base Facts.Year to Date Revenue

4. Set the following filter for the analysis:

Per Name Year is equal to / is in 2008.

5. For the Per Name Year column, select Column Properties > Column Format > Hide. This will prevent Per Name Year from displaying in the analysis results.

6. Sort Per Name Month in ascending order.

7. Click Results.

Month Ago Revenue displays revenue from the previous month. Year To Date Revenue calculates a running sum of revenue for the year on a monthly basis.

8. Create the following new analysis and filter to test the PERIODROLLING function at the month grain:

Time.Per Name Month
Time.Per Name Year
Base Facts.Revenue
Base Facts.Revenue 3-Period Rolling Sum

Per Name Year is equal to / is in 2008

9. For the Per Name Year column, select Column Properties > Column Format > Hide. This will prevent Per Name Year from displaying in the analysis results.

10. Sort Per Name Month in ascending order.

11. Click Results.

Revenue 3-Period Rolling Sum is calculated based on the month grain.

12. Create the following new analysis and filter to test the PERIODROLLING function at the year grain:

Time.Per Name Year
Base Facts.Revenue
Base Facts.Revenue 3-Period Rolling Sum

13. Sort Per Name Year in ascending order.

14. Click Results.

Revenue 3-Period Rolling Sum is calculated based on the year grain. A measure with the PERIODROLLING function calculates results based on the query grain.