sap hana business function library bfl en

8/20/2019 SAP HANA Business Function Library BFL En

http://slidepdf.com/reader/full/sap-hana-business-function-library-bfl-en 1/158

PUBLIC

SAP HANA Platform SPS 11

Document Version: 1.0 – 2015-11-25

SAP HANA Business Function Library(BFL)



Content

1 What is BFL?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

2 Getting Started with BFL. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.1 Prerequisites. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

2.2 Application Function Library (AFL). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

2.3 Security. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6

2.4 Checking BFL Installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.5 Calling BFL Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Generating BFL Procedures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

2.6 Using BFL in SAP HANA AFM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

3 BFL Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3.1 Annual Depreciation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Diminishing Balance Depreciation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Straight-line Depreciation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Sum-of-year Depreciation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19

3.2 Cycles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.3 Cumulate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

3.4 Days. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.5 Days Outstanding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

3.6 De-cumulate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

3.7 Delay. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

3.8 Delay Debt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

3.9 Delay Stock. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

3.10 Discounted Cash Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

3.11 Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

3.12 Feed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

3.13 Feed Overflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

3.14 Forecast. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

3.15 Forecast Agents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48

3.16 Forecast Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50

3.17 Forecast Dual Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

3.18 Forecast Mix. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

3.19 Forecast Sensitivity. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

3.20 Funds. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

3.21 Future. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

3.22 Grow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66

2

P U B L I C

© 2015 SAP SE or an SAP affiliate company. All rights reserved.

SAP HANA Business Function Library (BFL)

Content



3.23 Inflated Cash Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

3.24 Internal Rate of Return (IRR). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70

3.25 Lag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.26 Last. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74

3.27 Lease. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75

3.28 Lease Variable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

3.29 Linear Average. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

3.30 Max Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85

3.31 Minimum Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86

3.32 Moving Average&Moving Sum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

3.33 Moving Median. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92

3.34 Number of Periods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

3.35 Net Present Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97

3.36 Outlook. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

3.37 Payment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101

3.38 Present Value. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

3.39 Proportion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

3.40 Rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108

3.41 Repeat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

3.42 Rounding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112

3.43 Seasonal Simple&Seasonal Complex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114

Seasonal Complex. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116

Seasonal Simple. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

3.44 Seasonal Simulation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

3.45 Stock Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123

3.46 Stock Flow Reverse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

3.47 Stock Flow Batch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137

3.48 Time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

3.49 Time Sum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146

3.50 Transform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149

3.51 Volume Driver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151

3.52 Year-Over-Year Difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152

3.53 Year to Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154

3.54 Year-to-Date Statistical. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155


Content

P U B L I C

© 2015 SAP SE or an SAP affiliate company. All rights reserved. 3



1 What is BFL?

SAP HANA In-Memory Computing Engine offers various algorithms for in-memory computing. It provides

several application libraries for developers, partners, and customers who develop applications that run on SAP

HANA. The libraries are linked dynamically to the SAP HANA database kernel.

The Business Function Library (BFL) is one of these application libraries. It contains pre-built parameter-

driven functions in the financial area. The functions are implemented by C++. This library helps you develop

compound business algorithms that are fully compliant with the SAP HANA calculation engine. It offers you

the flexibility and efficiency to develop HANA-based applications with incredible performance.

The BFL extends the computation ability of SAP HANA with complex and performance-critical algorithmswhich are requested by applications. By using the library, you can achieve:

● Significant performance improvement for SAP applications

○ Utilizing new hardware (e.g. multi core, built-in vector engine)

○ Massive parallel main memory processing

○ Changing the boundaries between application server and data management layer

● Simplification of application programming model

○ Usage of extended SQL (SQL script)

○ Rich functionalities in calculation engine

○ Quick application delivery

4

P U B L I C



What is BFL?



2 Getting Started with BFL

This section covers the information you need to know to start working with the SAP HANA Business Function

Library.

2.1 Prerequisites

To use the BFL functions, you must:

● Install SAP HANA SPS 11.

● Install the Application Function Library (AFL), which includes the BFL.

For information on how to install or update AFL, see "Installing or Updating SAP HANA Components" in

SAP HANA Server Installation and U pdate Guide:

● Enable the Script Server in HANA instance. See SAP Note 1650957 for further information.

Note

The revision of the AFL must match the revision of SAP HANA.

Each release of the AFL has a version in the form of <revision_number>.<patch_level>. For example,AFL 40.01 refers to revision 40 and patch level 01, and it should be installed with SAP HANA revision 40

only.

Related Information

SAP HANA Server Installation and Update Guide

SAP Note 1650957

2.2 Application Function Library (AFL)

You can dramatically increase performance by executing complex computations in the database instead of at

the application sever level. SAP HANA provides several techniques to move application logic into the database,

and one of the most important is the use of application functions. Application functions are like database

procedures written in C++ and called from outside to perform data intensive and complex operations.

Functions for a particular topic are grouped into an application function library (AFL), such as the Predictive

Analysis Library (PAL) and the Business Function Library (BFL). Currently, PAL and BFL are delivered in one


Getting Started with BFL

P U B L I C


http://help.sap.com/disclaimer?site=http://service.sap.com/sap/support/notes/1650957

http://help.sap.com/hana/SAP_HANA_Server_Installation_Guide_en.pdf

http://help.sap.com/disclaimer?site=http://service.sap.com/sap/support/notes/1650957

http://help.sap.com/hana/SAP_HANA_Server_Installation_Guide_en.pdf



archive (that is, one SAR file with the name AFL<version_string>.SAR). The AFL archive is not part of the

HANA appliance, and must be installed separately by the administrator.

2.3 Security

This section provides detailed security information which can help administrator and architects answer some

common questions.

Role Assignment

For each AFL area, there are two roles. You must be assigned one of the roles to execute the functions in the

library. The roles for the BFL library are automatically created when the Application Function Library (AFL) is

installed. The role names are:

AFL__SYS_AFL_AFLBFL_EXECUTE

AFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION

Note

There are 2 underscores betweenAFL and SYS.

To generate or drop procedures for the following BFL functions, you also need the

AFLPM_CREATOR_ERASER_EXECUTE role, which is created when SAP HANA is installed:

● Delay

● Driver

● Forecast Driver

● Forecast Dual Driver

● Moving Average & Moving Sum

● Time Sum

Note

Once the above roles are automatically created, they cannot be dropped. In other words, even when an area

with all its objects is dropped and re-created during system startup, the user still keeps these roles

originally granted.

6

P U B L I C






2.4 Checking BFL Installation

To confirm that the BFL functions were installed successfully, you can check the following three public views:

● sys.afl_areas

● sys.afl_packages

● sys.afl_functions

These views are granted to the PUBLIC role and can be accessed by anyone.

To check the views, run the following SQL statements:

SELECT * FROM "SYS"."AFL_AREAS" WHERE AREA_NAME = 'AFLBFL'; SELECT * FROM "SYS"."AFL_PACKAGES" WHERE AREA_NAME = 'AFLBFL';

SELECT * FROM "SYS"."AFL_FUNCTIONS" WHERE AREA_NAME = 'AFLBFL';

The result will tell you whether the BFL functions were successfully installed on your system.

2.5 Calling BFL Functions

Most of the functions can be called directly once the BFL library has been installed and the script server has

started. The calling syntax is as follows:

CALL <schema_name>.AFLBFL_<function_name>_PROC(

{inputTab1,…}, <output_tab>) with overview;

● <schema_name>: The schema under which BFL functions are created.

● AFLBFL: The name of the BFL library.

● AFLBFL_<function_name>_PROC: The procedure name automatically generated by AFL.

● {inputTab1,…}: User-defined name(s) of the current procedure’s input table(s). Detailed input table

definition for each procedure can be found in Chapter 3.

● <output_tab>: User-defined name(s) of the current procedure’s output table(s). Detailed output table

definition for each procedure can be found in Chapter 3.

2.5.1 Generating BFL Procedures

The following functions require you to generate a procedure that wraps the function:

● Delay

● Driver

● Forecast Driver

● Forecast Dual Driver



P U B L I C




● Moving Average & Moving Sum

● Time Sum

Step 1 – Generate a BFL Procedure

Any user granted with the AFLPM_CREATOR_ERASER_EXECUTE role can generate an AFLLANG procedure for a

specific BFL function. The syntax is shown below:

CALL SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE (‘<area_name>’, ‘<function_name>’,‘<schema_name>’, '<procedure_name>', <signature_table>);

● <area_name>: Always set toAFLBFL.

● <function_name>: A BFL built-in function name.

● <schema_name>: A name of the schema that you want to create.

● <procedure_name>: A name for the BFL procedure. This can be anything you want.

● <signature_table>: A user-defined table variable. The table contains records to describe the position,

schema name, table type name, and parameter type, as defined below:

( POSITION int,SCHEMA_NAME nvarchar(256),TYPE_NAME nvarchar(256),PARAMETER_TYPE varchar(7))

A typical table variable references a table with the following definition:

Table 1:

Position Schema Name Table Type Name Parameter Type

1 <schema_name> BFL_INPUT1_T IN

2 <schema_name> … IN

3 <schema_name> BFL_INPUTN_T IN

4 <schema_name> BFL_OUTPUT_T OUT

Note

1. The records in the signature table must follow this order: first input table types, then the output table

types.

2. The signature table must be created before generating the BFL procedure. The table type names are

user-defined. You can find detailed table type definitions for each BFL function in Chapter 3.

3. If you want to drop an existing procedure and then generate it again, you need to call the

SYS.AFLLANG_WRAPPER_PROCEDURE_DROP procedure to clear the existing procedure. The syntax is

as follows:

CALL SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('<schema_name>','<procedure_name>');

4. The AFLLANG procedure generator described in this Step was introduced since SAP HANA SPS 09. For

backward compatibility information, see SAP Note 2046767.

8

P U B L I C






Step 2 – Call a BFL Procedure

After generating a BFL procedure, any user that has the AFL__SYS_AFL_AFLBFL_EXECUTE orAFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION role can call the procedure by using the syntax

below:

CALL <schema_name>.<procedure_name>( {input_table1,…}, <output_table>) with overview;

● <schema_name>: The name of the schema where the procedure is located.

● <procedure_name>: The procedure name specified when generating the procedure in Step 1.

● <input_table1,…>: User-defined name(s) of the procedure’s input table(s). Detailed input table

definitions for each procedure can be found in Chapter 3.

● <output_table>: User-defined name of the procedure’s output table. Detailed output table definition for

each procedure can be found in Chapter 3.

Note

1. The above tables must be created before calling the procedure.

2. Some BFL algorithms have more than one input table.

3. To call the BFL procedure generated in Step 1, you need theAFL__SYS_AFL_AFLBFL_EXECUTE or

AFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION role.

Related Information

SAP Note 2046767

2.6 Using BFL in SAP HANA AFM

The SAP HANA Application Function Modeler (AFM) in SAP HANA Studio supports functions from BFL inflowgraph models. With the AFM, you can easily add BFL function nodes to your flowgraph, specify its

parameters and input/output table types, and generate the procedure, all without writing any SQLScript code.

You can also execute the procedure to get the output result of the function, and save the auto-generated

SQLScript code for future use.

The main procedure is as follows:

1. Create a new flowgraph or open an existing flowgraph in the Project Explorer view.

Note

For details on how to create a flowgraph, see "Creating a Flowgraph" in SAP HANA Developer Guide for

SAP HANA Studio



P U B L I C


http://help.sap.com/disclaimer?site=https://service.sap.com/sap/support/notes/2046767

http://help.sap.com/disclaimer?site=https://service.sap.com/sap/support/notes/2046767



2. Specify the target schema by selecting the flowgraph container and editing Target Schema in the

Properties view.

3. Add the input(s) for the flowgraph by doing the following:

1. Right-click the input anchor region on the left side of the flowgraph container and choose Add Input.

2. Edit the table types of the input by editing the signature the Properties view.

Note

You can also drag a table from the catalog in the Systems view to the input anchor region of the

flowgraph container.

4. Add a BFL function to the flowgraph by doing the following:

1. Drag the function node from the Business Function Library compartment of the Palette to the

flowgraph editing area.

2. Specify the input table types of the function by selecting the input anchor and editing its signature in

the Properties view.

3. Specify the parameters of the function by selecting the parameter input anchor and editing its

signature and fixed content in the Properties view.

Note

A parameter table usually has fixed table content. If you want to supply the parameter values later

when you execute the procedure, clear the Fixed Content option.

4. Specify the output table types of the function by selecting the output anchor and editing the signature

in the Properties view.

5. (Optional) You can add more BFL nodes to the flowgraph if needed and connect them by holding the

Connect button from the source anchor and dragging a connection to the destination anchor.

6. Connect the input(s) in the input anchor region of the flowgraph container to the required input anchor(s)

of the BFL function node.

7. For the output tables that you want to see the output result after procedure execution, add them to the

output anchor region on the right side of the flowgraph container. To do that, move your mouse cursor

over the output anchor of the function node, hold the Connect button , and drag a connection to the

output anchor region.

8. Save the flowgraph by choosing File Save in the HANA Studio main menu.

9. Activate the flowgraph by right-clicking the flowgraph in the Project Explorer view and choosing Team

Activate .

A new procedure is generated in the target schema which is specified in Step 2.

Note

To activate the flowgraph, the database user _SYS_REPO needs SELECT object privileges for objects

that are used as data sources.

10. Select the black downward triangle next to the Execute button in the top right corner of the AFM.

A context menu appears. It shows the options Execute in SQL Editor and Open in SQL Editor as well as the

option Execute and Explore for every output of the flowgraph. In addition, the context menu shows the

option Edit Input Bindings.

10

P U B L I C






11. (Optional) If the flowgraph has input tables without fixed content, choose the option Edit Input Bindings.

A wizard appears that allows you to bind all inputs of the flowgraph to data sources in the catalog.

Note

If you do not bind the inputs, AFM will automatically open this wizard when executing the procedure.

12. Choose one of the options Execute in SQL Editor, Open in SQL Editor, or Execute and Explore for one of the

outputs of the flowgraph.

The behavior of the AFM depends on the execution mode.

○ Open in SQL Editor: Opens a SQL console containing the SQL code to execute the runtime object.

○ Execute in SQL Editor: Opens a SQL console containing the SQL code to execute the runtime object

and runs this SQL code.

○ Execute and Explore: Executes the runtime object and opens the Data Explorer view for the chosen

output of the flowgraph.

13. Close the flowgraph by choosing File Close in the HANA Studio main menu.

For more information on how to use AFM, see the "Transforming Data Using SAP HANA Application Function

Modeler"section in SAP HANA Developer Guide for SAP HANA Studio.

Related Information

SAP HANA Developer Guide for SAP HANA Studio



P U B L I C


http://help.sap.com/hana/SAP_HANA_Developer_Guide_for_SAP_HANA_Studio_en.pdf



3 BFL Functions

The following lists all available functions in the Business Function Library.

Table 2:

Function Description

Annual Depreciation [page 15] Calculates annual depreciation according to three common

methods: Diminishing Balance Depreciation [page 15],

Straight-line Depreciation [page 17], and Sum-of-year De

preciation [page 19]. It allows variable length of timescales

for all assets/items.

Cycles [page 20] Calculates seasonal factors from Fourier coefficients. It

combines sine and cosine waves to help you determine sea

sonality or other cyclical business factors.

Cumulate [page 22] Calculates the cumulative totals in one row based on the

original numbers in another row.

Days [page 23] Returns the number of days in each period defined by each

pair of From and To dates.

Days Outstanding [page 25] Calculates receipts or payments based on the level of days

outstanding.

De-cumulate [page 27] Calculates the original series starting from the cumulated

totals.

Delay [page 29] Calculates receivables or payables based on a delay be

tween the time of invoice and the time of payment.

Delay Debt [page 31] Calculates cash receipts using actual sales. The closing

debtor balance for each period is calculated by referring to

historic sales levels for a specified number of days.

Delay Stock [page 34] Calculates purchases required to meet future demand.

Discounted Cash Flow [page 36] Converts a future stream of cash flow to constant prices. It

calculates the inflated value of today's money.

Driver [page 38] Calculates the forecast for future periods using historical

data and as many drivers as needed. A driver drives cost,such as headcount, floor space, units sold, and unit price.

Feed [page 41] Calculates the closing balance and "feeds" it to the opening

balance of the next time period.

Feed Overflow [page 42] Calculates the closing balance and feeds it to the opening

balance of the next time period.

Forecast [page 45] Combines actual and forecast data to produce a rolling fore

cast. Eliminates scripting of feeds.

12

P U B L I C



BFL Functions




Forecast Agents [page 48] A specialized version of the Driver function focused on the

entities required to meet service levels. Used primarily forlabor in areas like call centers and mortgage processing

based on interest rate.

Forecast Driver [page 50] A specialized version of the Driver function that calculates

the forecast for future periods using historical data and one

single driver.

Forecast Dual Driver [page 53] Calculates the forecast for future periods using historical

data and two drivers. It also calculates the incremental ef

fect of each driver on the historical base figure.

Forecast Mix [page 56] Mixes actual data prior to the switchover date with forecast

data on and after the switchover date.

Forecast Sensitivity [page 58] Returns a calculation for the proportion of requests that willbe queued because there were no agents available when the

request was answered.

Funds [page 62] Calculates the use of funds or the source of funds.

Future [page 63] Calculates the closing balance of an account given the start

balance and the conditions under which the account runs.

Grow [page 66] Grows a base figure by a specified percentage each period.

It can be compound or linear.

Inflated Cash Flow [page 68] Calculates the amount of cash you must receive in a future

period to compensate for inflation.

Internal Rate of Return (IRR) [page 70] Calculates the internal rate of return for a series of cash flowon specified dates.

Lag [page 72] Calculates a result in one row by lagging an input from an

other row by a specified number of periods.

Last [page 74] Looks back over the series of data of the input row and re

turns the most recent non-zero value.

Lease [page 75] Calculates a payment schedule for a lease, loan, mortgage,

annuity or savings account.

Lease Variable [page 79] Allows an account to be scheduled along a time scale repre

senting the life of the loan.

Linear Average [page 83] Calculates a linear average that applies a larger weight to

more recent periods. The weights applied decrease linearly

as time goes backward.

Max Value [page 85] Returns the maximum value of a range.

Minimum Value [page 86] Returns the minimum value of a specific range.

Moving Average&Moving Sum [page 87] Calculates a moving average or moving sum over specified

periods. Key statistical component

Moving Median [page 92] Takes the median value after sorting all input values into an

ascending sequence.

Number of Periods [page 94] Calculates the number of periods over which the account

must run.


BFL Functions

P U B L I C





Net Present Value [page 97] Calculates the sum of a series of future cash flow values af

ter discounting each to a present value based on the annualrate input for the period in which it is being calculated.

Outlook [page 99] The outlook is calculated by using actuals of past months

and plan figures of future months.

Payment [page 101] Calculates the regular payment to an account for each pe

riod.

Present Value [page 104] Calculates opening value through the given target closing

balance and various parameters.

Proportion [page 106] Allows you to input a start and end date, and then calculates

the proportion of the period length. Important for project

planning with performance to plan calculations

Rate [page 108] Calculates the percentage interest rate per period for an ac

count, given its start balance, end balance, payment amount

per period and the number of periods.

Repeat [page 110] It is used to repeat data from a single period or group of pe

riods through the time scale of the Dimension List.

Rounding [page 112] Calculates the rounded values for a specified input item ac

cording to a chosen rounding method.

Seasonal Simple&Seasonal Complex [page 114] Performs seasonal adjustments of time to determine sea

sonal patterns in data.

Seasonal Simple [page 118] Performs seasonal adjustments of time to determine sea

sonal patterns in data.

Seasonal Simulation [page 121] Provides the building blocks to seasonal simulation seasonal

data using a variety of characteristics.

Stock Flow [page 123] Works out the level of supply needed to meet target fore

casts for stock cover.

Stock Flow Reverse [page 130] Allows you to input stock cover and work out what pur

chases were needed to meet the target stock levels.

Stock Flow Batch [page 137] Let’s you use batch quantities in stock flow calculations. Key

for constraint based models or non-discrete manufacturing

units of measure.

Time [page 144] Returns the information requested by the option you have

input. Eliminates scripting of alternative time dimensions

Time Sum [page 146] Allows you to accumulate an expense over a specified num

ber of periods in advance or arrears.

Transform [page 149] Helps users to build equations using angles and trigonome

try functions when Cycles does not provide the functionality

that they need.

Volume Driver [page 151] Calculates the year-over-year percentage difference for

each volume driver.

Year-Over-Year Difference [page 152] Calculates the year over year difference between the cur

rent and previous time periods.

14

P U B L I C



BFL Functions




Year to Date [page 154] Calculates year to date totals based on original data.

Year-to-Date Statistical [page 155] Calculates the original numbers in one row based on the

year-to-date figures in another row.

3.1 Annual Depreciation

This function calculates annual depreciation according to three common methods: Diminishing balance

depreciation, Straight line depreciation and Sum-of-year depreciation. It allows variable length of timescales

for all assets/items. This is critical for seasonality and creating adjusting periods.

3.1.1 Diminishing Balance Depreciation

This function calculates depreciation based on diminishing balances. It provides a higher depreciation charge

in the first year of an asset’s life and gradually decreases charges in subsequent years. Depreciation is

calculated by taking out the accumulated depreciation from the opening asset capitalization. Depreciation

starts high, progressively decreases. The asset will never be fully depreciated.

Formula

Depreciation = (Capitalization - Accumulated depreciation to date) * (rate / 100)

Signature

Input Tables

Table 3:

Name Direction Number of Col

umns

Column Type Column Name Description

Capitalization Input Table 1 Double VALUE Asset capitaliza

tion (the cost of

purchase)

Rate Input Table 1 Double VALUE The life of the cap

italized asset in

years


BFL Functions

P U B L I C





umns


Flag Input Table 1 Double VALUE Period(0) oryear(1)

Capitalization

Type

Input Table 1 Double VALUE Period(0) or

year(1)

Periods Input Table 1 Double VALUE The periods used

to calculate

Output Table

Table 4:


umns


Depreciation Output Table 2 Double VALUEINDEX The index of the

depreciation result

Double DEP_VALUE Diminishing bal

ance depreciation

result

Example

Assume that:

● BFL_TEST is a schema belonging to USER1; and

● USER1 has been assigned the AFL__SYS_AFL_AFLBFL_EXECUTE or


SET SCHEMA BFL_TEST;DROP TABLE BFL_DBD_CAPITALIZATION_TBL;CREATE COLUMN TABLE BFL_DBD_CAPITALIZATION_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DBD_CAPITALIZATION_TBL VALUES (100000) ; DROP TABLE BFL_DBD_RATE_TBL;CREATE COLUMN TABLE BFL_DBD_RATE_TBL ( "VALUE" DOUBLE) ;INSERT INTO BFL_DBD_RATE_TBL VALUES (0.1) ; DROP TABLE BFL_DBD_FLAG_TBL;CREATE COLUMN TABLE BFL_DBD_FLAG_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DBD_FLAG_TBL VALUES (0) ; DROP TABLE BFL_DBD_CAPITALIZATIONTYPE_TBL;CREATE COLUMN TABLE BFL_DBD_CAPITALIZATIONTYPE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DBD_CAPITALIZATIONTYPE_TBL VALUES (0) ; DROP TABLE BFL_DBD_PERIODS_TBL;CREATE COLUMN TABLE BFL_DBD_PERIODS_TBL ("VALUE" DOUBLE) ;INSERT INTO BFL_DBD_PERIODS_TBL VALUES (10) ; DROP TABLE BFL_DBD_DEPRECIATION_TBL;CREATE COLUMN TABLE BFL_DBD_DEPRECIATION_TBL ("VALUEINDEX" DOUBLE, "DEP_VALUE"

DOUBLE) ;

16

P U B L I C



BFL Functions



CALL _SYS_AFL.AFLBFL_DBDEPRECIATION_PROC (BFL_DBD_CAPITALIZATION_TBL,BFL_DBD_RATE_TBL, BFL_DBD_FLAG_TBL, BFL_DBD_CAPITALIZATIONTYPE_TBL,BFL_DBD_PERIODS_TBL, BFL_DBD_DEPRECIATION_TBL) WITH OVERVIEW;

SELECT * FROM BFL_DBD_DEPRECIATION_TBL;

3.1.2 Straight-line Depreciation

This function can help companies to estimate the residual value of each asset which is used during the

production process.

It calculates depreciation by dividing the asset capitalization by the life of it based on two inputs.

1. Asset capitalization

2. The life in periods or years.

Formula

Depreciation = Capitalization / Life of the asset

Signature

Input Tables

Table 5:


umns



tion (the cost of

purchase)

Life Input Table 1 Double VALUE Life of the asset.

Possible to import

from NWBI or

other ledger

Flag Input Table 1 Double VALUE Period(0) or

year(1)

Output Table


BFL Functions

P U B L I C




Table 6:


umns



depreciation result

Double DEP_VALUE Straight line de

preciation result

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SLD_CAPITALIZATION_TBL;CREATE COLUMN TABLE BFL_SLD_CAPITALIZATION_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (2400);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);

INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0);INSERT INTO BFL_SLD_CAPITALIZATION_TBL VALUES (0); DROP TABLE BFL_SLD_LIFE_TBL ;CREATE COLUMN TABLE BFL_SLD_LIFE_TBL( "VALUE" DOUBLE );INSERT INTO BFL_SLD_LIFE_TBL VALUES (10); DROP TABLE BFL_SLD_FLAG_TBL ;CREATE COLUMN TABLE BFL_SLD_FLAG_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_SLD_FLAG_TBL VALUES (1) ; DROP TABLE BFL_SLD_DEPRECIATION_TBL ;CREATE COLUMN TABLE BFL_SLD_DEPRECIATION_TBL ( "VALUEINDEX" DOUBLE, "DEP_VALUE"DOUBLE) ;result tables CALL _SYS_AFL.AFLBFL_SLDEPRECIATION_PROC (BFL_SLD_CAPITALIZATION_TBL,BFL_SLD_LIFE_TBL, BFL_SLD_FLAG_TBL, BFL_SLD_DEPRECIATION_TBL) with overview;

SELECT * FROM BFL_SLD_DEPRECIATION_TBL ;

18

P U B L I C



BFL Functions



3.1.3 Sum-of-year Depreciation

This is a depreciation method that results in a more accelerated write-off than straight line depreciation, butless than diminishing-balance method. It calculates the depreciation by dividing the asset capitalization by a

weighting that decreases over time.

Formula

(Depreciation, period p) = c * (n - p + 1)/ (n*(n+1)/2)

Where:

c = capitalization, n = life of the asset, p = period for which depreciation is being calculated

Signature

Input Tables

Table 7:


umns



tion (the cost of

purchase)

Life Input Table 1 Double VALUE Life of the asset.

Can be imported

from NWBI for ac

tual assets

Flag Input Table 1 Double VALUE Period(0) or

year(1)

Output Table

Table 8:


umns



depreciation result

Double DEP_VALUE Sum-of-year de

preciation result


BFL Functions

P U B L I C




Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SYD_CAPITALIZATION_TBL ;CREATE COLUMN TABLE BFL_SYD_CAPITALIZATION_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_SYD_CAPITALIZATION_TBL VALUES (15000); DROP TABLE BFL_SYD_LIFE_TBL ;CREATE COLUMN TABLE BFL_SYD_LIFE_TBL( "VALUE" DOUBLE );INSERT INTO BFL_SYD_LIFE_TBL VALUES (5);

DROP TABLE BFL_SYD_FLAG_TBL ;CREATE COLUMN TABLE BFL_SYD_FLAG_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_SYD_FLAG_TBL VALUES (0) ;DROP TABLE BFL_SYD_DEPRECIATION_TBL ;CREATE COLUMN TABLE BFL_SYD_DEPRECIATION_TBL ( "VALUEINDEX" DOUBLE, "DEP_VALUE"DOUBLE) ; CALL _SYS_AFL.AFLBFL_SOYDEPRECIATION_PROC (BFL_SYD_CAPITALIZATION_TBL,BFL_SYD_LIFE_TBL, BFL_SYD_FLAG_TBL, BFL_SYD_DEPRECIATION_TBL) with overview; SELECT * FROM BFL_SYD_DEPRECIATION_TBL ;

3.2 Cycles

Cycles calculates seasonal factors by using Fourier coefficients. It combines sine and cosine waves to help you

determine seasonality or other cyclical business factors.

Formula

● When {sine/cosine} = sine, the equation is:

{Cycle} = {amplitude} * Sin(360 * ({time} - {start date}) / {length})

● When {sine/cosine}= cosine, the equation is:

{Cycle}= {amplitude} * Cos(360 * ( {time} - {start date}) / {length})

Where: {time} is the center of the period.

Signature

Input Tables

20

P U B L I C



BFL Functions



Table 9:


umns


Amplitude Input Table 1 Double AMPLITUDE Amplitude of sine/

cosine.

Length Input Table 1 Double LENGTH Length (in years)

over which the cy

cle repeats itself.

Startdate Input Table 1 Double START Time in years at

which the cycle

starts.

Function Input Table 1 Int FUNCTION 0 for a sine wave,

and 1 for a cosine

wave.

Time Input Table 1 Double TIME Time periods.

Output Table

Table 10:


umns


Result Output Table 1 Double CYCLE Result table that

contains the ex

pected result.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_CYCLES_AMPLITUDE_TBL;CREATE COLUMN TABLE BFL_CYCLES_AMPLITUDE_TBL( "AMPLITUDE" DOUBLE ) ;INSERT INTO BFL_CYCLES_AMPLITUDE_TBL VALUES (200) ;INSERT INTO BFL_CYCLES_AMPLITUDE_TBL VALUES (300) ;INSERT INTO BFL_CYCLES_AMPLITUDE_TBL VALUES (2000) ;DROP TABLE BFL_CYCLES_LENGTH_TBL;CREATE COLUMN TABLE BFL_CYCLES_LENGTH_TBL( "LENGTH" DOUBLE ) ;INSERT INTO BFL_CYCLES_LENGTH_TBL VALUES (20) ;INSERT INTO BFL_CYCLES_LENGTH_TBL VALUES (6.5) ;INSERT INTO BFL_CYCLES_LENGTH_TBL VALUES (0) ;DROP TABLE BFL_CYCLES_START_TBL;CREATE COLUMN TABLE BFL_CYCLES_START_TBL( "START" DOUBLE ) ;INSERT INTO BFL_CYCLES_START_TBL VALUES (2000) ;INSERT INTO BFL_CYCLES_START_TBL VALUES (2003) ;INSERT INTO BFL_CYCLES_START_TBL VALUES (0) ;DROP TABLE BFL_CYCLES_FUNCTION_TBL;CREATE COLUMN TABLE BFL_CYCLES_FUNCTION_TBL( "FUNCTION" INTEGER ) ;

INSERT INTO BFL_CYCLES_FUNCTION_TBL VALUES (0) ;INSERT INTO BFL_CYCLES_FUNCTION_TBL VALUES (0) ;


BFL Functions

P U B L I C




INSERT INTO BFL_CYCLES_FUNCTION_TBL VALUES (0) ;DROP TABLE BFL_CYCLES_TIME_TBL;CREATE COLUMN TABLE BFL_CYCLES_TIME_TBL( "TIME" DOUBLE ) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2003) ;

INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2004) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2005) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2006) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2007) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2008) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2009) ;INSERT INTO BFL_CYCLES_TIME_TBL VALUES (2010) ;DROP TABLE BFL_CYCLES_RESULTS_TBL ;CREATE COLUMN TABLE BFL_CYCLES_RESULTS_TBL ( "CYCLE" DOUBLE); CALL _SYS_AFL.AFLBFL_CYCLES_PROC (BFL_CYCLES_AMPLITUDE_TBL,BFL_CYCLES_LENGTH_TBL, BFL_CYCLES_START_TBL, BFL_CYCLES_FUNCTION_TBL,BFL_CYCLES_TIME_TBL, BFL_CYCLES_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_CYCLES_RESULTS_TBL;

3.3 Cumulate

This function cumulates the original numbers in a row and the total results will be in another row.

Formula

Where: n is the current period number.

Signature

Input Tables

Table 11:


umns


Original Input Table 1 Double VALUE Item you want to

accumulate

Output Table

22

P U B L I C



BFL Functions



Table 12:


umns


Cumulated Output Table 1 Double CUMULATED_DE

CUMULATE

Cumulative Total

Input Flag

Table 13:

Name Direction Value Type Description

Flag Input Value 1 Int Specifies this as Cu

mulate function, corre

sponding to De-cumu

late Function

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_CMLT_ORIGINAL_TBL;CREATE COLUMN TABLE BFL_CMLT_ORIGINAL_TBL( "VALUE" DOUBLE );INSERT INTO BFL_CMLT_ORIGINAL_TBL VALUES (50);INSERT INTO BFL_CMLT_ORIGINAL_TBL VALUES (90);INSERT INTO BFL_CMLT_ORIGINAL_TBL VALUES (90);DROP TABLE BFL_CMLT_CUMULATED_TBL;CREATE COLUMN TABLE BFL_CMLT_CUMULATED_TBL( "CUMULATED_DECUMULATE" DOUBLE); CALL _SYS_AFL.AFLBFL_CUMULATE_DECUMULATE_PROC (BFL_CMLT_ORIGINAL_TBL,BFL_CMLT_CUMULATED_TBL,1) WITH OVERVIEW; SELECT *FROM BFL_CMLT_CUMULATED_TBL;

3.4 Days

This function returns the number of days in each period defined by each pair of “From” and “To” dates.

Formula

Days = Number of days in period


BFL Functions

P U B L I C




Signature

Input Tables

Table 14:


umns


FromDate Input Table 1 String FROMDATE Beginning of date

to be calculated

ToDate Input Table 1 String TODATE End of date to be

calculated

Config Input Table 1 Double CONFIG Normal(0) Ge

neric Month: re

turn 365/12

Output Table

Table 15:


umns


TotalDays Output Table 1 Double TOTALDAYS Displays the days

in the current pe

riod

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_DAYS_FROMDATE_TBL;CREATE COLUMN TABLE BFL_DAYS_FROMDATE_TBL( "FROMDATE" VARCHAR(255));INSERT INTO BFL_DAYS_FROMDATE_TBL VALUES('20000106');INSERT INTO BFL_DAYS_FROMDATE_TBL VALUES('20000206');INSERT INTO BFL_DAYS_FROMDATE_TBL VALUES('19990223');DROP TABLE BFL_DAYS_TODATE_TBL;CREATE COLUMN TABLE BFL_DAYS_TODATE_TBL ( "TODATE" VARCHAR(255));INSERT INTO BFL_DAYS_TODATE_TBL VALUES('20090909');INSERT INTO BFL_DAYS_TODATE_TBL VALUES('20100106');INSERT INTO BFL_DAYS_TODATE_TBL VALUES('20000806');DROP TABLE BFL_DAYS_CONFIG_TBL ;CREATE COLUMN TABLE BFL_DAYS_CONFIG_TBL ( "CONFIG" DOUBLE ) ;INSERT INTO BFL_DAYS_CONFIG_TBL VALUES (0) ;INSERT INTO BFL_DAYS_CONFIG_TBL VALUES (0) ;INSERT INTO BFL_DAYS_CONFIG_TBL VALUES (0) ;DROP TABLE BFL_DAYS_TOTALDAYS_TBL ;CREATE COLUMN TABLE BFL_DAYS_TOTALDAYS_TBL ( "TOTALDAYS" DOUBLE) ;result table CALL _SYS_AFL.AFLBFL_DAYS_PROC (BFL_DAYS_FROMDATE_TBL, BFL_DAYS_TODATE_TBL,

BFL_DAYS_CONFIG_TBL, BFL_DAYS_TOTALDAYS_TBL) WITH OVERVIEW; SELECT * FROM BFL_DAYS_TOTALDAYS_TBL;

24

P U B L I C



BFL Functions



3.5 Days Outstanding

This function calculates receipts or payments based on the level of days outstanding. It is similar to the Delay

Debt business function, and other business functions which can create an atypical period specific to each

business event (i.e. the average days outstanding of an invoice). However, it can also significantly simplify the

procedure of user business rule setup by allowing the period length to be abstracted. Normally, it would be

driven by a separate table/cube which has the actual DSO derived from the ERP system or NWBI – so the

Days Outstanding is accurate for each customer and provides a highly accurate forecast of pending receipts

for treasury (and for collections). In addition, it would guide the organization to easily understand the impactof collection activities relative to cash flow.

Formula

The closing balance is calculated as a function of the level of days outstanding.

Closing = (Days Outstanding / Days in Period) * Invoices this period

Or

(Closing, period n) = ([Level, period n] / [Days in period n]) * (Invoices, period n)

However, if the level of days outstanding is greater than the days in the current period

i.e. If

(Level, period n) > Days in period n

Then

(Closing, period n) = (Invoices, period n) + ([Invoices, period n - 1] *[Level - Days in period n] / Days period n - 1)

Payments are calculated as follows:

Cash payments = Opening - Closing + Invoices

Opening balances = The closing balance from the previous period

Signature

Input Tables


BFL Functions

P U B L I C




Table 16:


umns


Indicator Input Table 1 Double VALUE Used to indicate

what level value

specifies: 0: Pe

riod; 1: Days; 2:

Start/End

Prime Input Table 1 Double VALUE Debtor or creditor

balance at start of

first period

Invoice Input Table 1 Double VALUE Invoice in amount

Duration Input Table 1 Double VALUE Period length

Level Input Table 1 Double VALUE Number of days

outstanding or pe

riods outstanding

Days Input Table 1 Double VALUE Number of days

for each period

Input flag

Table 17:

Name Type Value Description

Indicator Int 1 Specify this is function of

days outstanding corre

sponding to delay debt

Output Table

Table 18:


umns


Result Output Table 3 Double OPENING Debtor or creditor

balance at start of

subsequent peri

ods, fed from the

closing balance of

the previous period

Double CLOSING Closing balance,

calculated from

days outstanding

Double RECEIPTS Payments

Example

Assume that:

26

P U B L I C



BFL Functions






SET SCHEMA BFL_TEST; DROP TABLE BFL_DYSOUTSTD_INDICATOR_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_INDICATOR_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_INDICATOR_TBL VALUES (1) ;DROP TABLE BFL_DYSOUTSTD_PRIME_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_PRIME_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_PRIME_TBL VALUES (3000) ;DROP TABLE BFL_DYSOUTSTD_INVOICE_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_INVOICE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;

INSERT INTO BFL_DYSOUTSTD_INVOICE_TBL VALUES (3000) ;DROP TABLE BFL_DYSOUTSTD_DURATION_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_DURATION_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_DURATION_TBL VALUES (2.5) ;DROP TABLE BFL_DYSOUTSTD_LEVEL_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_LEVEL_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DYSOUTSTD_LEVEL_TBL VALUES (41) ;DROP TABLE BFL_DYSOUTSTD_DAYS_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_DAYS_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (31) ;

INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DYSOUTSTD_DAYS_TBL VALUES (30) ;DROP TABLE BFL_DYSOUTSTD_RESULTS_TBL ;CREATE COLUMN TABLE BFL_DYSOUTSTD_RESULTS_TBL ( "OPENING" DOUBLE, "CLOSING"DOUBLE,"RECEIPTS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_DAYSOUTSTANDING_PROC(BFL_DYSOUTSTD_INDICATOR_TBL,BFL_DYSOUTSTD_PRIME_TBL, BFL_DYSOUTSTD_INVOICE_TBL, BFL_DYSOUTSTD_DURATION_TBL,BFL_DYSOUTSTD_LEVEL_TBL, BFL_DYSOUTSTD_DAYS_TBL, 1, BFL_DYSOUTSTD_RESULTS_TBL) WITH OVERVIEW ;

SELECT * FROM BFL_DYSOUTSTD_RESULTS_TBL ;

3.6 De-cumulate

This function calculates the original series from the cumulated totals.


BFL Functions

P U B L I C




Formula

(Original, Period n) = (Cumulative, Period n) - (Cumulative, Period n-1)

Signature

Input Tables

Table 19:


umns


Cumulative Input Table 1 Double VALUE Item you want tobreak down

Output Table

Table 20:


umns


Original Output Table 1 Double CUMULATED_DE

CUMULATE

Original item

Input Flag

Table 21:


Flag Input Value 0 Int Specifies this as De-

cumulate function,

corresponding to Cu

mulate Function

Example

Assume that:




SET SCHEMA BFL_TEST;DROP TABLE BFL_DECMLT_CUMULATIVE_TBL;CREATE COLUMN TABLE BFL_DECMLT_CUMULATIVE_TBL( "VALUE" DOUBLE );INSERT INTO BFL_DECMLT_CUMULATIVE_TBL VALUES (50);INSERT INTO BFL_DECMLT_CUMULATIVE_TBL VALUES (90);INSERT INTO BFL_DECMLT_CUMULATIVE_TBL VALUES (90);

DROP TABLE BFL_DECMLT_ORIGINAL_TBL;CREATE COLUMN TABLE BFL_DECMLT_ORIGINAL_TBL( "CUMULATED_DECUMULATE" DOUBLE);

28

P U B L I C



BFL Functions



CALL _SYS_AFL.AFLBFL_CUMULATE_DECUMULATE_PROC (BFL_DECMLT_CUMULATIVE_TBL,BFL_DECMLT_ORIGINAL_TBL,0) WITH OVERVIEW; SELECT *FROM BFL_DECMLT_ORIGINAL_TBL;

3.7 Delay

This function needs to use the generator mentioned in Calling BFL Functions [page 7].

This function calculates payables and receivables based on two factors:

1. Suspension time between the time of invoice and payment2. Sales and purchase history

Formula

Cash Paid, this month = (Input current month) * (%period1 current month)/100

+ (Input last month) * (%period2 from last month)/100

+ (Input 2 months ago) * (%period3 from 2 months ago)/100

+ (Input 3 months ago) * (%period4 from 3 months ago)/100

+ ........

(Opening n months ago) * (%period n+1 from n months ago/100)

The opening balance from the prior year is assigned to the future month using the percentages entered in the

first time period.

Closing = Opening + Inputs - Cash Paid

Opening, period 1 = Prime, period1

Opening, this month = Closing, last month

Note: The parameters do not necessarily have to be Dimension List items; they can also be constants.

Signature

Input Tables


BFL Functions

P U B L I C




Table 22:


umns


Prime Input Table 1 Double VALUE Opening balance,

beginning period

Invoice Input Table 1 Double INVOICE Invoices

Paid Input Table 1 or n Double/Int PAID1~PAIDn Percentage of cur

rent period’s invoi

ces paid in current

period.

Output Table

Table 23:

Name Direction Number of Columns


Result Output Table 3 Double/Int OPENING Opening balance

as closing of previ

ous period

Double/Int PAID Cash receipts or

payments

Double/Int CLOSING Closing balance

Example

Assume that:


● USER1 has been assigned the AFLPM_CREATOR_ERASER_EXECUTE role; and



SET SCHEMA BFL_TEST; DROP TYPE BFL_DELAY_PRIME_T;CREATE TYPE BFL_DELAY_PRIME_T AS TABLE("VALUE" DOUBLE);DROP TYPE BFL_DELAY_INVOICE_T;CREATE TYPE BFL_DELAY_INVOICE_T AS TABLE("INVOICE" DOUBLE);DROP TYPE BFL_DELAY_PAID_T;CREATE TYPE BFL_DELAY_PAID_T AS TABLE("PAID1" DOUBLE, "PAID2" DOUBLE, "PAID3"DOUBLE, "PAID4" DOUBLE);DROP TYPE BFL_DELAY_DELAY_T;CREATE TYPE BFL_DELAY_DELAY_T AS TABLE("OPENING" DOUBLE,"PAID" DOUBLE, "CLOSING"DOUBLE);DROP table BFL_DELAY_PDATA_TBL;CREATE column table BFL_DELAY_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_DELAY_PDATA_TBL values (1,'BFL_TEST’,’BFL_DELAY_PRIME_T', 'IN');insert into BFL_DELAY_PDATA_TBL values (2,'BFL_TEST’,’BFL_DELAY_INVOICE_T','IN');insert into BFL_DELAY_PDATA_TBL values (3,'BFL_TEST’,’BFL_DELAY_PAID_T', 'IN');

insert into BFL_DELAY_PDATA_TBL values (4,'BFL_TEST’,’BFL_DELAY_DELAY_T', 'OUT');call SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’, 'AFLBFL_DELAY_PROC');

30

P U B L I C



BFL Functions



call SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','DELAY','TEST_BFL','AFLBFL_DELAY_PROC',BFL_DELAY_PDATA_TBL); DROP TABLE BFL_DELAY_PRIME_TBL ;CREATE COLUMN TABLE BFL_DELAY_PRIME_TBL ( "VALUE" DOUBLE );INSERT INTO

BFL_DELAY_PRIME_TBL VALUES (1000) ;DROP TABLE BFL_DELAY_INVOICE_TBL ;CREATE COLUMN TABLE BFL_DELAY_INVOICE_TBL ( "INVOICE" DOUBLE) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;INSERT INTO BFL_DELAY_INVOICE_TBL VALUES (500) ;DROP TABLE BFL_DELAY_PAID_TBL ;CREATE COLUMN TABLE BFL_DELAY_PAID_TBL ( "PAID1" DOUBLE, "PAID2" DOUBLE, "PAID3"DOUBLE, "PAID4" DOUBLE) ;INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;

INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;INSERT INTO BFL_DELAY_PAID_TBL VALUES (40, 25, 20, 15) ;DROP TABLE BFL_DELAY_RESULTS_TBL ;CREATE COLUMN TABLE BFL_DELAY_RESULTS_TBL ( "OPENING" DOUBLE, "PAID" DOUBLE,"CLOSING" DOUBLE) ;CALL BFL_TEST.AFLBFL_DELAY_PROC(BFL_DELAY_PRIME_TBL, BFL_DELAY_INVOICE_TBL,BFL_DELAY_PAID_TBL, BFL_DELAY_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_DELAY_RESULTS_TBL ;

3.8 Delay Debt

This function calculates cash receipts using actual sales data. The closing debtor balance for each period is

calculated by referring to historical sales levels for a specified number of days. The days are taken first from

the current period, then the previous periods.

When using the Days function to calculate days, the start and the end dates must be defined for each period in

the timescale field or extracted from NetWeaver.

Formula

The closing balance is calculated as a function of the level of debtor days.

Closing = (Debtor Days/ Days in Period) * Sales of this period

Or

(Closing, period n) = ((Level, period n)/ (Days in period n)) * (Sales, period n)

However, if the level of days outstanding is greater than the days in the current period,

i.e. If

(Level, period n) > Days in period n

Then:


BFL Functions

P U B L I C




(Closing, period n) = (Invoices, period n) + ([Invoices, period n - 1]*[Level - Days in period n] / Days period n - 1)

Payments are calculated as follows:

Cash payments = Opening - Closing + Invoices

Opening balances = The closing balance from the previous period

Signature

Input Tables

Table 24:


umns


Indicator Input Table 1 Double VALUE Used to indicate

what level value

specifies: 0: Pe

riod; 1: Days

Prime Input Table 1 Double VALUE Opening debtor

balance

Invoice Input Table 1 Double VALUE Actual sales

Duration Input Table 1 Double VALUE Period length

Level Input Table 1 Double VALUE Number of debtor

days/periods

Days Input Table 1 Double VALUE Calculated in days

instead of periods

Input flag

Table 25:

Name Type Value Description

Indicator Int 0 Specifies this is a function ofdelay debt corresponding to

days outstanding

Output Table

Table 26:


umns


Result Output Table 3 Double OPENING Debtor balance

from closing bal

ance of the previ

ous period

32

P U B L I C



BFL Functions




umns


Double CLOSING Closing debtorbalance

Double RECEIPTS Cash receipts re

quired to meet

debtor targets

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_DLDBT_INDICATOR_TBL ;CREATE COLUMN TABLE BFL_DLDBT_INDICATOR_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_INDICATOR_TBL VALUES (1) ;DROP TABLE BFL_DLDBT_PRIME_TBL ;CREATE COLUMN TABLE BFL_DLDBT_PRIME_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_PRIME_TBL VALUES (3000) ;DROP TABLE BFL_DLDBT_INVOICE_TBL ;CREATE COLUMN TABLE BFL_DLDBT_INVOICE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;

INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;INSERT INTO BFL_DLDBT_INVOICE_TBL VALUES (3000) ;DROP TABLE BFL_DLDBT_DURATION_TBL ;CREATE COLUMN TABLE BFL_DLDBT_DURATION_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_DURATION_TBL VALUES (2.5) ;DROP TABLE BFL_DLDBT_LEVEL_TBL ;CREATE COLUMN TABLE BFL_DLDBT_LEVEL_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;INSERT INTO BFL_DLDBT_LEVEL_TBL VALUES (41) ;DROP TABLE BFL_DLDBT_DAYS_TBL ;CREATE COLUMN TABLE BFL_DLDBT_DAYS_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLDBT_DAYS_TBL VALUES (30) ;DROP TABLE BFL_DLDBT_RESULTS_TBL ;CREATE COLUMN TABLE BFL_DLDBT_RESULTS_TBL ( "OPENING" DOUBLE, "CLOSING"DOUBLE,"RECEIPTS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_DELAYDEBT_PROC(BFL_DLDBT_INDICATOR_TBL,BFL_DLDBT_PRIME_TBL, BFL_DLDBT_INVOICE_TBL, BFL_DLDBT_DURATION_TBL,BFL_DLDBT_LEVEL_TBL, BFL_DLDBT_DAYS_TBL, 0, BFL_DLDBT_RESULTS_TBL) WITH

OVERVIEW ;


BFL Functions

P U B L I C




SELECT * FROM BFL_DLDBT_RESULTS_TBL ;

3.9 Delay Stock

This function calculates purchases in order to meet the future needs or the required closing stock levels.

Through predicting sales demand in a certain period, the closing stock can be calculated.

Formula

Closing Inventory = (Inventoryturn Days/ Days Next Period) * Sales Next Period

or

(Closing, Period n) = ((Level, Period n)/ (Days in Period n+1) ) * (Sales, Period n+1)

If

(Level, Period n) > Days in Period n+1

Then

(Closing, Period n) = (Sales, Period n+1) + ((Level, Period n) - Days in Period n+1) / (Days in Period n+2) *

(Sales, Period n+2)

Purchases are calculated to meet the closing inventory levels required:

Purchases = Closing - Opening + Sales

Opening inventory balances are calculated as the closing inventory balance from the previous period except

for the first period, only when the opening balance equals prime.

Opening, Period n = Closing, Period n-1

Opening, Period 1= Prime, Period 1

Signature

Input Tables

Table 27:


umns


Prime Input Table 1 Double PRIME Stock balance at

the start of the

first period.

34

P U B L I C



BFL Functions




umns


Demand Input Table 1 Double DEMAND Expected sales demand.

Level Input Table 1 Double LEVEL Number of stock

days or periods.

Days Input Table 1 Double DAYS Time series. Num

ber of days in each

stage (e.g.

month).

Indicator Input Table 1 Double INDICATOR Periods or days.

Output Table

Table 28:


umns


Result Output Table 3 Double OPENING Stock balance at

the start of subse

quent periods

Double CLOSING Closing stock bal

ance

Double PURCHASES Purchases re

quired to meet

stock targets

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_DLSTK_PRIME_TBL;CREATE COLUMN TABLE BFL_DLSTK_PRIME_TBL ( "PRIME" DOUBLE ) ;INSERT INTO BFL_DLSTK_PRIME_TBL VALUES (5000) ; DROP TABLE BFL_DLSTK_DEMAND_TBL;CREATE COLUMN TABLE BFL_DLSTK_DEMAND_TBL ( "DEMAND" DOUBLE ) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (2000) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (3000) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (3000) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (3000) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (3000) ;INSERT INTO BFL_DLSTK_DEMAND_TBL VALUES (3000) ;DROP TABLE BFL_DLSTK_LEVELS_TBL;CREATE COLUMN TABLE BFL_DLSTK_LEVELS_TBL ( "LEVEL" DOUBLE ) ;

INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (61) ;INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (61) ;


BFL Functions

P U B L I C




INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (62) ;INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (61) ;INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (61) ;INSERT INTO BFL_DLSTK_LEVELS_TBL VALUES (61) ;

DROP TABLE BFL_DLSTK_DAYS_TBL;CREATE COLUMN TABLE BFL_DLSTK_DAYS_TBL ( "DAYS" DOUBLE ) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (30) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (31) ;INSERT INTO BFL_DLSTK_DAYS_TBL VALUES (30) ;DROP TABLE BFL_DLSTK_INDICATOR_TBL;CREATE COLUMN TABLE BFL_DLSTK_INDICATOR_TBL ( "INDICATOR" DOUBLE ) ;INSERT INTO BFL_DLSTK_INDICATOR_TBL VALUES (1) ;DROP TABLE BFL_DLSTK_RESULT_TBL;CREATE COLUMN TABLE BFL_DLSTK_RESULT_TBL ( "OPENING" DOUBLE, "CLOSING"DOUBLE,"PURCHASES" DOUBLE) ; CALL _SYS_AFL.AFLBFL_DELAYSTOCK_PROC(BFL_DLSTK_PRIME_TBL, BFL_DLSTK_DEMAND_TBL,BFL_DLSTK_LEVELS_TBL, BFL_DLSTK_DAYS_TBL, BFL_DLSTK_INDICATOR_TBL,

BFL_DLSTK_RESULT_TBL) WITH OVERVIEW; SELECT * FROM BFL_DLSTK_RESULT_TBL;

3.10 Discounted Cash Flow

This function converts a future stream of cash flow to constant prices. It calculates the inflated value of today's

money.

Formula

Where:

r = discount rate expressed as a decimal fraction

n= number of periods into the future

Signature

Input Tables

36

P U B L I C



BFL Functions



Table 29:


umns


Prime Input Table 1 Double PRIME Prime/base value

Time Input Table 1 String TIME The periods to be

calculated

Rate Input Table 1 Double RATE Discount rate

APR Input Table 1 Double APR =annual % by de

fault = annual rate

(rate=%/100) =

Periodic % = Peri

odic rate

Switchover Input Table 1 Double SWITCHOVER The switchover

date defines the

last historic pe

riod: = Historic:

Treat all periods

as historic =Input

Date: Formatted

date =TimeScale:

Use rate defined in

timescale =Month:

Use month

SwitchoverDate Input Table 1 String SWITCHOVER

DATE

Specify the

switchover date

Output Table

Table 30:


umns


Result Output Table 1 Double RESULT Constant value

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_DCF_PRIME_TBL;CREATE COLUMN TABLE BFL_DCF_PRIME_TBL( "PRIME" DOUBLE ) ;INSERT INTO BFL_DCF_PRIME_TBL VALUES (1000) ;DROP TABLE BFL_DCF_TIME_TBL;CREATE COLUMN TABLE BFL_DCF_TIME_TBL( "TIME" VARCHAR(255)) ;INSERT INTO BFL_DCF_TIME_TBL VALUES ('20100101') ;

INSERT INTO BFL_DCF_TIME_TBL VALUES ('20110101') ;INSERT INTO BFL_DCF_TIME_TBL VALUES ('20120101') ;


BFL Functions

P U B L I C




INSERT INTO BFL_DCF_TIME_TBL VALUES ('20130101') ;INSERT INTO BFL_DCF_TIME_TBL VALUES ('20140101') ;INSERT INTO BFL_DCF_TIME_TBL VALUES ('20150101') ;DROP TABLE BFL_DCF_RATE_TBL;

CREATE COLUMN TABLE BFL_DCF_RATE_TBL( "RATE" DOUBLE ) ;INSERT INTO BFL_DCF_RATE_TBL VALUES (0.1) ;DROP TABLE BFL_DCF_APR_TBL;CREATE COLUMN TABLE BFL_DCF_APR_TBL( "APR" DOUBLE) ;INSERT INTO BFL_DCF_APR_TBL VALUES (1) ;DROP TABLE BFL_DCF_SWITCHOVER_TBL;CREATE COLUMN TABLE BFL_DCF_SWITCHOVER_TBL( "SWITCHOVER" DOUBLE ) ;INSERT INTO BFL_DCF_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_DCF_SWITCHOVERDATE_TBL ;CREATE COLUMN TABLE BFL_DCF_SWITCHOVERDATE_TBL( "SWITCHOVERDATE" VARCHAR(255));INSERT INTO BFL_DCF_SWITCHOVERDATE_TBL VALUES ('20091231') ;DROP TABLE BFL_DCF_RESULTS_TBL ;CREATE COLUMN TABLE BFL_DCF_RESULTS_TBL ( "RESULT" DOUBLE); CALL _SYS_AFL.AFLBFL_DISCOUNTEDCASHFLOW_PROC(BFL_DCF_PRIME_TBL,BFL_DCF_TIME_TBL, BFL_DCF_RATE_TBL, BFL_DCF_APR_TBL, BFL_DCF_SWITCHOVER_TBL,

BFL_DCF_SWITCHOVERDATE_TBL, BFL_DCF_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_DCF_RESULTS_TBL;

3.11 Driver


This function is the key embedded calculation for system planning. It deploys a table-driven approach to

calculate the forecast for future periods using historical data and as many drivers as needed. A driver drives

cost, such as headcount, floor space, units sold, and unit price.

Although drivers can also be manually scripted for each item, the driver function is much more maintainable. It

facilitates real-time modeling and seasonal simulation.

Formula

The forecast is worked out as follows:

Forecast, Period n = (History, Period p) * Ratio 1 * Ratio 2 * … * Ratio n

Where:

Ratio 1 = (Driver 1, Period n) / (Driver 1, Period p)



“Period n” denotes the current period. “Period p” denotes the base period immediately prior to the switchover

date. “Period p” is the last period that contains historical data. From that period on, the data is forecast.

38

P U B L I C



BFL Functions



Signature

Input Tables

Table 31:


umns


History Input Table 1 Double HISTORY Base cost

Time Input Table 1 String TIME Time series to do

forecast based on

drivers

Switchover Input Table 1 Double SWITCHOVER Switchover type:

■ 0 = Default

Date■

1 = Specific Date ■ 2 =

Dimension List

■ 3 = Today

■ 4 = Month

Note: The 1 and 2

options are the

same in SAP

HANA 1.0 SP3

Switchover Date Input Table 1 String SWITCHOVE

RDATE

Defines the first

future period. This

parameter is de

pendent on the

SWITCHOVER

type you specify.

Drivers Input Table 1~n Double/Int DRIVER1~DRIV

ERN

A driver drives

cost (e.g. head

count, floor space,

unit price, etc.).

There is no limit to

the number of

drivers.

Output Table

Table 32:


umns


Result Output Table 1 Double FORECAST Forecasted cost

Example

Assume that:



BFL Functions

P U B L I C







SET SCHEMA BFL_TEST; DROP TYPE BFL_DRIVER_HISTORY_T;CREATE TYPE BFL_DRIVER_HISTORY_T AS TABLE("HISTORY" DOUBLE);DROP TYPE BFL_DRIVER_TIME_T;CREATE TYPE BFL_DRIVER_TIME_T AS TABLE("TIME" VARCHAR(100));DROP TYPE BFL_DRIVER_SWITCHOVER_T;CREATE TYPE BFL_DRIVER_SWITCHOVER_T AS TABLE("SWITCHOVER" DOUBLE);DROP TYPE BFL_DRIVER_SWITCHOVERDATE_T;CREATE TYPE BFL_DRIVER_SWITCHOVERDATE_T AS TABLE("SWITCHOVERDATE" VARCHAR(255));DROP TYPE BFL_DRIVER_DRIVER_T;CREATE TYPE BFL_DRIVER_DRIVER_T AS TABLE("DRIVER1" DOUBLE, "DRIVER2" DOUBLE,"DRIVER3" DOUBLE);DROP TYPE BFL_DRIVER_RESULT_T;CREATE TYPE BFL_DRIVER_RESULT_T AS TABLE("FORECAST" DOUBLE);

DROP table BFL_DRIVER_PDATA_TBL;CREATE column table BFL_DRIVER_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_DRIVER_PDATA_TBL values (1,'BFL_TEST’,’BFL_DRIVER_HISTORY_T','IN');insert into BFL_DRIVER_PDATA_TBL values (2,'BFL_TEST’,’BFL_DRIVER_TIME_T', 'IN');insert into BFL_DRIVER_PDATA_TBL values (3,'BFL_TEST’,’BFL_DRIVER_SWITCHOVER_T','IN');insert into BFL_DRIVER_PDATA_TBL values(4,'BFL_TEST’,’BFL_DRIVER_SWITCHOVERDATE_T', 'IN');insert into BFL_DRIVER_PDATA_TBL values (5,'BFL_TEST’,’BFL_DRIVER_DRIVER_T','IN');insert into BFL_DRIVER_PDATA_TBL values (6,'BFL_TEST’,’BFL_DRIVER_RESULT_T','OUT');call SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’, 'AFLBFL_DRIVER_PROC'); call SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','DRIVER','TEST_BFL',

'AFLBFL_DRIVER_PROC',BFL_DRIVER_PDATA_TBL); DROP TABLE BFL_DRIVER_HISTORY_TBL ;CREATE COLUMN TABLE BFL_DRIVER_HISTORY_TBL ( "HISTORY" DOUBLE ) ;INSERT INTO BFL_DRIVER_HISTORY_TBL VALUES (1000) ;DROP TABLE BFL_DRIVER_MONTHTAB_TBL ;CREATE COLUMN TABLE BFL_DRIVER_MONTHTAB_TBL ( "TIME" VARCHAR(255)) ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100401') ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100501') ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100601') ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100701') ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100801') ;INSERT INTO BFL_DRIVER_MONTHTAB_TBL VALUES ('20100901') ;DROP TABLE BFL_DRIVER_SWITCHOVER_TBL ;CREATE COLUMN TABLE BFL_DRIVER_SWITCHOVER_TBL ( "SWITCHOVER" DOUBLE ) ;INSERT INTO BFL_DRIVER_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_DRIVER_SWITCHOVERDATE_TBL ;CREATE COLUMN TABLE BFL_DRIVER_SWITCHOVERDATE_TBL ( "SWITCHOVERDATE"VARCHAR(255) ) ;INSERT INTO BFL_DRIVER_SWITCHOVERDATE_TBL VALUES ('20100401') ;DROP TABLE BFL_DRIVER_DRIVERS_TBL ;CREATE TABLE BFL_DRIVER_DRIVERS_TBL ( "DRIVER1" DOUBLE, "DRIVER2" DOUBLE,"DRIVER3" DOUBLE) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (10, 5, 10) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (10, 6, 10) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (10, 6, 10) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (10, 6, 10) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (12, 7, 10) ;INSERT INTO BFL_DRIVER_DRIVERS_TBL VALUES (13, 8, 11) ;DROP TABLE BFL_DRIVER_FORECAST_TBL ;CREATE COLUMN TABLE BFL_DRIVER_FORECAST_TBL( "FORECAST" DOUBLE) ; CALL BFL_TEST.AFLBFL_DRIVER_PROC(BFL_DRIVER_HISTORY_TBL,

BFL_DRIVER_MONTHTAB_TBL, BFL_DRIVER_SWITCHOVER_TBL,

40

P U B L I C



BFL Functions



BFL_DRIVER_SWITCHOVERDATE_TBL, BFL_DRIVER_DRIVERS_TBL, BFL_DRIVER_FORECAST_TBL) WITH OVERVIEW; SELECT * FROM BFL_DRIVER_FORECAST_TBL;

3.12 Feed

This function calculates the closing balance of a period which will be regard as the opening balance of the

following. The opening balance of the first period is defined as Prime which can be a constant or a dimension

list item.

Formula

Closing Balance = Opening + In - Out

Opening Balance, Period n = Closing Balance, Period n-1

Opening Balance, Period 1 = Prime, Period 1

Signature

Input Tables

Table 33:


umns


Prime Input Table 1 Double VALUE The opening bal

ance of the first

period

In Input Table 1 Double VALUE Incremental

amount

Out Input Table 1 Double VALUE Decremented

amount

Output Table


BFL Functions

P U B L I C




Table 34:


umns


Result Output Table 2 Double OPENING The opening bal

ance based on

previous closing

balance

Double CLOSING Closing balance

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FEED_PRIME_TBL ;CREATE COLUMN TABLE BFL_FEED_PRIME_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_FEED_PRIME_TBL VALUES (5000) ;DROP TABLE BFL_FEED_IN_TBL ;CREATE COLUMN TABLE BFL_FEED_IN_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_FEED_IN_TBL VALUES (2000) ;INSERT INTO BFL_FEED_IN_TBL VALUES (5000) ;INSERT INTO BFL_FEED_IN_TBL VALUES (6000) ;

INSERT INTO BFL_FEED_IN_TBL VALUES (2000) ;INSERT INTO BFL_FEED_IN_TBL VALUES (3000) ;INSERT INTO BFL_FEED_IN_TBL VALUES (2000) ;DROP TABLE BFL_FEED_OUT_TBL ;CREATE COLUMN TABLE BFL_FEED_OUT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;INSERT INTO BFL_FEED_OUT_TBL VALUES (1000) ;DROP TABLE BFL_FEED_RESULTS_TBL ;CREATE COLUMN TABLE BFL_FEED_RESULTS_TBL ("OPENING" DOUBLE, "CLOSING" DOUBLE); CALL _SYS_AFL.AFLBFL_FEED_PROC(BFL_FEED_PRIME_TBL, BFL_FEED_IN_TBL,

BFL_FEED_OUT_TBL, BFL_FEED_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_FEED_RESULTS_TBL ;

3.13 Feed Overflow

This function calculates the closing balance of a period which will be regard as the opening balance of the

following. The opening balance of the first period is defined as Prime which can be a constant or a dimension

list item.

42

P U B L I C



BFL Functions



The difference between Feed and Feed Overflow is the following:

● The Out parameter in Feed is a fixed input

● The Out parameter in Feed Overflow is an output which is proportional to Opening.

Feed overflow is commonly used to predict closing balances. This is critical in current planning and seasonal

simulation scenarios when the balance sheet has replaced the P&L as the dominant financial report. It is used

when the outflow is a function of the opening balance such as tax payments, periodic payments, and accruals

or wastage calculations.

Formula

Out = Opening * Factor / 100 for Indicator set to %

Out = Opening * Factor for Indicator set to *

Out = Opening / Factor for Indicator set to /

Closing = Opening + In - Out

Opening, Period 1 = Prime, Period 1

Opening, Period n = Closing, Period n-1

Signature

Input Tables

Table 35:


umns


Prime Input Table 1 Double VALUE The opening bal

ance of the first

period (default=0)

In Input Table 1 Double VALUE Inflow or incre

mental amount

Factor Input Table 1 Double VALUE The factor to apply

to the opening bal

ance when calcu

lating the parame

ter Out.

Indicator Input Table 1 Double VALUE Indicate factor is

used as a percent

age(0), frac

tion(1), or denomi

nator(2).

Output Table


BFL Functions

P U B L I C




Table 36:


umns



ance of each pe

riod; fed from

closing balance of

previous period.

Double OUTS Outflow or reduc

tion calculated us

ing the opening

balance, parame

ter and factor

Double CLOSING Closing balance

(Closing cash bal

ance)

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FDOF_PRIME_TBL ;CREATE COLUMN TABLE BFL_FDOF_PRIME_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_FDOF_PRIME_TBL VALUES (5000) ;DROP TABLE BFL_FDOF_IN_TBL ;CREATE COLUMN TABLE BFL_FDOF_IN_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;INSERT INTO BFL_FDOF_IN_TBL VALUES (1000) ;DROP TABLE BFL_FDOF_FACTOR_TBL ;CREATE COLUMN TABLE BFL_FDOF_FACTOR_TBL ( "VALUE" DOUBLE ) ;

INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (0) ;INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (0) ;INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (50) ;INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (0) ;INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (0) ;INSERT INTO BFL_FDOF_FACTOR_TBL VALUES (0) ;DROP TABLE BFL_FDOF_INDICATOR_TBL ;CREATE COLUMN TABLE BFL_FDOF_INDICATOR_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FDOF_INDICATOR_TBL VALUES (0) ;DROP TABLE BFL_FDOF_RESULTS_TBL ;CREATE COLUMN TABLE BFL_FDOF_RESULTS_TBL ( "OPENING" DOUBLE, "OUTS"DOUBLE,"CLOSING" DOUBLE) ; CALL _SYS_AFL.AFLBFL_FEEDOVERFLOW_PROC(BFL_FDOF_PRIME_TBL, BFL_FDOF_IN_TBL,BFL_FDOF_FACTOR_TBL, BFL_FDOF_INDICATOR_TBL, BFL_FDOF_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_FDOF_RESULTS_TBL ;

44

P U B L I C



BFL Functions



3.14 Forecast

This function combines actual and forecast data to produce a rolling forecast. In general, it can consume

hundreds or thousands of lines of custom business rules in any business scenario or plan, potentially more if it

is a "rolling forecast" where actual results refactor forward feeds (see Feed business function). So

implementing forecast as a common function not only reduces the effort on the part of the customer, but also

ensures integrity and delivers predictable performance.

Formula

The following methods are available:

● Act/Bud = Use actuals of historical periods and budget for future periods.

● Override = Enter your own forecast manually, overriding the original budget.

● Trend% = Follow the trend to date by working out the actuals to date as a percentage of the budget, and

applying this percentage to the future budget.

● Goal = Scale future periods to meet the budget goal over the duration of the timescale.

● Average = Forecast based on an average of actuals to date.

● Linear = Forecast using linear extrapolation.

●Periodic = Scale future periods to meet the cumulative budget goal between points in time defined by aflag.

● Subtotal = Scale future periods to meet the cumulative budget goal between points in time defined by

subtotals in the timescale Dimension List.

● Full-term = Scale future periods to meet the budget goal over the duration of the timescale. When the

budgets for future periods are all zero, spread any shortfall according to days in period so that the full-

term forecast always matches the budget.

Note: The forecast method used is whichever one is specified in the first time period.

Signature

Input Tables

Table 37:


umns


Period Input Table 1 String PERIOD Specify the period

value

Budget Input Table 1 Double BUDGET The budget

amount


BFL Functions

P U B L I C





umns


Actual Input Table 1 Double ACTUAL The actual amount

AFflag Input Table 1 Int AFFLAG A list of specific ta

ble driven labels

(actual, budget,

forecast, etc)

PeriodsNum Input Table 1 Int PERIODSNUM Number of periods

to be calculated

Override Input Table 1 Double OVERRIDE Allows new fore

cast used to over

ride the budget-

key for resetting

the budget

Days Input Table 1 Int DAYS Number of days

(When method is

average or linear)

PeriodsFlag Input Table 1 Int PERIODSFLAG Average, Linear

Input Flags

Table 38:

Name Direction Type Description

Method Input Value Int Act/Bud(0), Override(1),

Trend(2), Goal(3), Aver

age(4), Linear(5), Peri

odic(6), Subtotal(7), Full-

term(8).

Indicator Input Value Int Number periods(0) Days in

period(1)

Output Table

Table 39:


umns


Result Output Table 2 String RE_PERIOD The period value

from period table

Double FORECAST The revised fore

cast based on a

combination of ac

tual and forecast

amounts

46

P U B L I C



BFL Functions



Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FCST_PERIOD_TBL ;CREATE COLUMN TABLE BFL_FCST_PERIOD_TBL ( "PERIOD" VARCHAR(255)) ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Jan') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Feb') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Mar') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Apr') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('May') ;

INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Jun') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('Jul') ;INSERT INTO BFL_FCST_PERIOD_TBL VALUES ('YEAR') ;DROP TABLE BFL_FCST_BUDGET_TBL ;CREATE COLUMN TABLE BFL_FCST_BUDGET_TBL ( "BUDGET" DOUBLE ) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (1000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (1000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (2000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (1000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (1000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (2000) ;INSERT INTO BFL_FCST_BUDGET_TBL VALUES (2000) ;DROP TABLE BFL_FCST_ACTUAL_TBL ;CREATE COLUMN TABLE BFL_FCST_ACTUAL_TBL ( "ACTUAL" DOUBLE ) ;INSERT INTO BFL_FCST_ACTUAL_TBL VALUES (800) ;INSERT INTO BFL_FCST_ACTUAL_TBL VALUES (800) ;

INSERT INTO BFL_FCST_ACTUAL_TBL VALUES (1200) ;DROP TABLE BFL_FCST_AFFLAG_TBL ;CREATE COLUMN TABLE BFL_FCST_AFFLAG_TBL ( "AFFLAG" INT) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (1) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (1) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (1) ;INSERT INTO BFL_FCST_AFFLAG_TBL VALUES (1) ;DROP TABLE BFL_FCST_PERIODSNUM_TBL ;CREATE COLUMN TABLE BFL_FCST_PERIODSNUM_TBL ( "PERIODSNUM" INT ) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSNUM_TBL VALUES (0) ;DROP TABLE BFL_FCST_OVERRIDE_TBL ;CREATE COLUMN TABLE BFL_FCST_OVERRIDE_TBL ( "OVERRIDE" DOUBLE ) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (0) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (0) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (0) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (1500) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (1500) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (1500) ;INSERT INTO BFL_FCST_OVERRIDE_TBL VALUES (1500) ;DROP TABLE BFL_FCST_DAYS_TBL ;CREATE COLUMN TABLE BFL_FCST_DAYS_TBL ( "DAYS" INT ) ;INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;

INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;


BFL Functions

P U B L I C




INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;INSERT INTO BFL_FCST_DAYS_TBL VALUES (0) ;

DROP TABLE BFL_FCST_PERIODSFLAG_TBL ;CREATE COLUMN TABLE BFL_FCST_PERIODSFLAG_TBL ( "PERIODSFLAG" INT ) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;INSERT INTO BFL_FCST_PERIODSFLAG_TBL VALUES (0) ;DROP TABLE BFL_FCST_RESULTS_TBL ;CREATE COLUMN TABLE BFL_FCST_RESULTS_TBL ( "RE_PERIOD" VARCHAR(255), "FORECAST"DOUBLE) ; CALL _SYS_AFL.AFLBFL_FORECAST_PROC(BFL_FCST_PERIOD_TBL, BFL_FCST_BUDGET_TBL,BFL_FCST_ACTUAL_TBL, BFL_FCST_AFFLAG_TBL, BFL_FCST_PERIODSNUM_TBL,BFL_FCST_OVERRIDE_TBL, BFL_FCST_DAYS_TBL, BFL_FCST_PERIODSFLAG_TBL,0,0,BFL_FCST_RESULTS_TBL) WITH OVERVIEW ; SELECT * FROM BFL_FCST_RESULTS_TBL;

3.15 Forecast Agents

This function is focused on the entities required to meet service levels.

Forecast Agents is used primarily for labor in areas like call centers and mortgage processing based on

interest rate. It can also be used for any constraint-based discrete drivers such as CPU requirements for cloud

computing (based on load/users).

Formula

The calculation of Forecast Agents is complex. It can be summarized as follows:

(Agents; LevelFound; LowerLevel; C; LowerC) = Forecast Agents (Method; SLA; ServiceTime; CallsPerHour;

AHT)

Signature

Input Tables

48

P U B L I C



BFL Functions



Table 40:


umns


Method Input Table 1 Double VALUE 1 for fractional

agents, and other

wise for whole

agents (default)

SLA Input Table 1 Double VALUE Service level: the

proportion of serv

ice requests that

reach an agent in

time

ServiceTime Input Table 1 Double VALUE Critical average

waiting time (in

seconds) before a

service request

reaches an agent

SRPH Input Table 1 Double VALUE Average number

of service re

quests received in

an hour (or a de

fined period)

Average Handle

Time

Input Table 1 Double VALUE Average handling

time: service re

quest duration (in

seconds)

Output Table

Table 41:


umns


Result Output Table 1 Double AGENTS Number of agents

required

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FA_METHOD_TBL ;CREATE COLUMN TABLE BFL_FA_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FA_METHOD_TBL VALUES (0) ; DROP TABLE BFL_FA_SLA_TBL ;

CREATE COLUMN TABLE BFL_FA_SLA_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FA_SLA_TBL VALUES (0.7975606) ;


BFL Functions

P U B L I C




DROP TABLE BFL_FA_SERVICETIME_TBL ;CREATE COLUMN TABLE BFL_FA_SERVICETIME_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FA_SERVICETIME_TBL VALUES (15) ;DROP TABLE BFL_FA_SRPH_TBL ;

CREATE COLUMN TABLE BFL_FA_SRPH_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FA_SRPH_TBL VALUES (720) ;DROP TABLE BFL_FA_HANDLETIME_TBL ;CREATE COLUMN TABLE BFL_FA_HANDLETIME_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FA_HANDLETIME_TBL VALUES (240) ;DROP TABLE BFL_FA_RESULTS_TBL ;CREATE COLUMN TABLE BFL_FA_RESULTS_TBL ( "AGENTS" DOUBLE) ; TRUNCATE TABLE BFL_FA_RESULTS_TBL; CALL _SYS_AFL.AFLBFL_FORECASTAGENTS_PROC(BFL_FA_METHOD_TBL, BFL_FA_SLA_TBL,BFL_FA_SERVICETIME_TBL, BFL_FA_SRPH_TBL, BFL_FA_HANDLETIME_TBL,BFL_FA_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_FA_RESULTS_TBL;

3.16 Forecast Driver


This function is a specialized version of the Driver Function. It calculates the forecast for future periods using

historical data and one single driver.

Forecast Driver shows the incremental effect of the driver on the historical base figure. The forecast

calculation is based on the ratio of the future driver value to the driver value in a base period (the last period

containing historical data).

Formula

The forecast and effect are calculated as follows:

Forecast = h * (c / o)

Effect = h * ((c / o) – 1))

Where:

c = Current Driver

o = Original Driver

h = Historical base cost in the period before the switchover date

Signature

Input Tables

50

P U B L I C



BFL Functions



Table 42:


umns


History Input Table 1 Double HISTORY Base cost.


forecast based on

drivers.

Switchover Input Table 1 Double SWITCHOVER Switchover type:

■ 0 = Default

Date ■ 1 = Spe

cific Date ■ 2 =

Dimension List

■ 3 = Today

■ 4 = Month

Note: The 1 and 2

options are the

same in SAP

HANA 1.0 SP3.


RDATE

Defines the first

future period. This

parameter is de

pendent on the

SWITCHOVER

type you specify.

Driver Input Table 1 Double/ Int DRIVER A driver drives

cost (e.g. head

count, floor space,

unit price, etc.).

Only one driver is

allowed.

Output Table

Table 43:


umns



Double EFFECT Incremental effect

of an increase in

driver

String TIME The time value

from time table

Example

Assume that:


BFL Functions

P U B L I C








SET SCHEMA BFL_TEST; DROP TYPE BFL_FD_HISTORY_T;CREATE TYPE BFL_FD_HISTORY_T AS TABLE("HISTORY" DOUBLE);DROP TYPE BFL_FD_TIME_T;CREATE TYPE BFL_FD_TIME_T AS TABLE("TIME" VARCHAR(100));DROP TYPE BFL_FD_SWITCHOVER_T;CREATE TYPE BFL_FD_SWITCHOVER_T AS TABLE("SWITCHOVER" DOUBLE);DROP TYPE BFL_FD_SWITCHOVERDATE_T;CREATE TYPE BFL_FD_SWITCHOVERDATE_T AS TABLE("SWITCHOVERDATE" VARCHAR(255));DROP TYPE BFL_FD_DRIVER_T;CREATE TYPE BFL_FD_DRIVER_T AS TABLE("DRIVER" DOUBLE);DROP TYPE BFL_FD_RESULT_T;CREATE TYPE BFL_FD_RESULT_T AS TABLE("FORECAST" DOUBLE, "EFFECT" DOUBLE, "TIME"

VARCHAR(100));DROP table BFL_FD_PDATA_TBL;CREATE column table BFL_FD_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_FD_PDATA_TBL values (1,'BFL_TEST’,’BFL_FD_HISTORY_T','IN');insert into BFL_FD_PDATA_TBL values (2,'BFL_TEST’,’BFL_FD_TIME_T','IN');insert into BFL_FD_PDATA_TBL values (3,'BFL_TEST’,’BFL_FD_SWITCHOVER_T', 'IN');insert into BFL_FD_PDATA_TBL values (4,'BFL_TEST’,’BFL_FD_SWITCHOVERDATE_T','IN');insert into BFL_FD_PDATA_TBL values (5,'BFL_TEST’,’BFL_FD_DRIVER_T','IN');insert into BFL_FD_PDATA_TBL values (6,'BFL_TEST’,’BFL_FD_RESULT_T','OUT');call SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’,'AFLBFL_FORECASTDRIVER_PROC'); call SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','DRIVER','TEST_BFL','AFLBFL_FORECASTDRIVER_PROC',BFL_FD_PDATA_TBL); DROP TABLE BFL_FD_HISTORY_TBL ;

CREATE COLUMN TABLE BFL_FD_HISTORY_TBL ( "HISTORY" DOUBLE ) ;INSERT INTO BFL_FD_HISTORY_TBL VALUES (1000) ;INSERT INTO BFL_FD_HISTORY_TBL VALUES (2000) ;DROP TABLE BFL_FD_MONTHTAB_TBL ;CREATE COLUMN TABLE BFL_FD_MONTHTAB_TBL ( "TIME" VARCHAR(255)) ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100401') ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100501') ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100601') ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100701') ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100801') ;INSERT INTO BFL_FD_MONTHTAB_TBL VALUES ('20100901') ;DROP TABLE BFL_FD_SWITCHOVER_TBL ;CREATE COLUMN TABLE BFL_FD_SWITCHOVER_TBL ( "SWITCHOVER" DOUBLE ) ;INSERT INTO BFL_FD_SWITCHOVER_TBL VALUES (2) ;DROP TABLE BFL_FD_SWITCHOVERDATE_TBL ;CREATE COLUMN TABLE BFL_FD_SWITCHOVERDATE_TBL ( "SWITCHOVERDATE" VARCHAR(255) ) ;

INSERT INTO BFL_FD_SWITCHOVERDATE_TBL VALUES ('20100501') ;DROP TABLE BFL_FD_DRIVER_TBL ;CREATE COLUMN TABLE BFL_FD_DRIVER_TBL ( "DRIVER" DOUBLE) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (10) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (11) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (11) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (11) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (12) ;INSERT INTO BFL_FD_DRIVER_TBL VALUES (12) ;DROP TABLE BFL_FD_RESULT_TBL;CREATE COLUMN TABLE BFL_FD_RESULT_TBL ( "FORECAST" DOUBLE, "EFFECT" DOUBLE,"TIME" VARCHAR(255)) ; CALL BFL_TEST.AFLBFL_FORECASTDRIVER_PROC(BFL_FD_HISTORY_TBL,BFL_FD_MONTHTAB_TBL, BFL_FD_SWITCHOVER_TBL, BFL_FD_SWITCHOVERDATE_TBL,BFL_FD_DRIVER_TBL, BFL_FD_RESULT_TBL) WITH OVERVIEW; SELECT * FROM BFL_FD_RESULT_TBL;

52

P U B L I C



BFL Functions



3.17 Forecast Dual Driver


This function calculates:

1. The forecast, by using historical data and two drivers.

2. The incremental effect of each driver based on the historical figure.

This is a very powerful modeling and scenario planning calculation that is extremely difficult for a customer to

script and maintain.

Formula

The base historical period is the period immediately prior to the switchover date. The forecast period is

denoted by period n.

Table 44:

Effect1, period n = ((Driver1, period n)/(Driver1, base pe

riod)) * (History, base period)

Effect2, period n = ((Driver2, period n)/(Driver2, base pe

riod)) * (History, base period)

Interaction, period n = +((Driver1, period n) * (Driver2, period

n)) - ((Driver1, base period) * (Driver2,

base period)) - ((Effect1, period n) - (Ef

fect2, period n))

Forecast, period n = +(History, base period) +(Effect1, pe

riod n) +(Effect2, period n) +(Interac

tion, period n)

Signature

Input Tables

Table 45:


umns


History Input Table 1 Double HISTORY Base cost.


forecast based on

drivers.


BFL Functions

P U B L I C





umns


Switchover Input Table 1 Double SWITCHOVER Switchover type:■ 0 = Default

Date ■ 1 = Spe

cific Date ■ 2 =

Dimension List

■ 3 = Today

■ 4 = Month

Note: The 1 and 2

options are the

same in SAP

HANA 1.0 SP3.


RDATE

Defines the first

future period. This

parameter is de

pendent on the

SWITCHOVER

type you specify.

Driver Input Table 2 Double/Int DRIVER1 DRIVER2 A driver is some

thing that drivers

the cost (head

count, floor space,

unit price, and so

on.) Two drivers

are allowed.

Output Table

Table 46:


umns



Double EFFECT1 Incremental effect

of an increase in

driver

Double EFFECT2 Incremental effect

of an increase in

second driver

Double INTERACTION The small incre

mental effect be

tween the drivers

Example

Assume that:


54

P U B L I C



BFL Functions






SET SCHEMA BFL_TEST; DROP TYPE BFL_FDD_HISTORY_T;CREATE TYPE BFL_FDD_HISTORY_T AS TABLE("HISTORY" DOUBLE);DROP TYPE BFL_FDD_TIME_T;CREATE TYPE BFL_FDD_TIME_T AS TABLE("TIME" VARCHAR(100));DROP TYPE BFL_FDD_SWITCHOVER_T;CREATE TYPE BFL_FDD_SWITCHOVER_T AS TABLE("SWITCHOVER" DOUBLE);DROP TYPE BFL_FDD_SWITCHOVERDATE_T;CREATE TYPE BFL_FDD_SWITCHOVERDATE_T AS TABLE("SWITCHOVERDATE" VARCHAR(255));DROP TYPE BFL_FDD_DRIVER_T;CREATE TYPE BFL_FDD_DRIVER_T AS TABLE("DRIVER1" DOUBLE, "DRIVER2" DOUBLE);DROP TYPE BFL_FDD_RESULT_T;CREATE TYPE BFL_FDD_RESULT_T AS TABLE("FORECAST" DOUBLE, "EFFECT1" DOUBLE,"EFFECT2" DOUBLE, "INTERACTION" DOUBLE) ;

DROP table BFL_FDD_PDATA_TBL;CREATE column table BFL_FDD_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_FDD_PDATA_TBL values (1,'BFL_TEST’,’BFL_FDD_HISTORY_T', 'IN');insert into BFL_FDD_PDATA_TBL values (2,'BFL_TEST’,’BFL_FDD_TIME_T','IN');insert into BFL_FDD_PDATA_TBL values (3,'BFL_TEST’,’BFL_FDD_SWITCHOVER_T', 'IN');insert into BFL_FDD_PDATA_TBL values (4,'BFL_TEST’,’BFL_FDD_SWITCHOVERDATE_T','IN’);insert into BFL_FDD_PDATA_TBL values (5,'BFL_TEST’,’BFL_FDD_DRIVER_T','IN');insert into BFL_FDD_PDATA_TBL values (6,'BFL_TEST’,’BFL_FDD_RESULT_T', 'OUT');callSYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’,'AFLBFL_FORECASTDUALDRIVER_PROC'); call SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','DRIVER','TEST_BFL','AFLBFL_FORECASTDUALDRIVER_PROC',BFL_FDD_PDATA_TBL); DROP TABLE BFL_FDD_HISTORY_TBL;CREATE COLUMN TABLE BFL_FDD_HISTORY_TBL ( "HISTORY" DOUBLE ) ;

INSERT INTO BFL_FDD_HISTORY_TBL VALUES (1000) ;INSERT INTO BFL_FDD_HISTORY_TBL VALUES (1000) ;INSERT INTO BFL_FDD_HISTORY_TBL VALUES (1000) ;INSERT INTO BFL_FDD_HISTORY_TBL VALUES (1000) ;DROP TABLE BFL_FDD_DATECOL_TBL;CREATE COLUMN TABLE BFL_FDD_DATECOL_TBL ( "TIME" VARCHAR(255)) ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100101') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100201') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100301') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100401') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100501') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100601') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100701') ;INSERT INTO BFL_FDD_DATECOL_TBL VALUES ('20100801') ;DROP TABLE BFL_FDD_SWITCHOVER_TBL;CREATE COLUMN TABLE BFL_FDD_SWITCHOVER_TBL ( "SWITCHOVER" INT ) ;INSERT INTO BFL_FDD_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_FDD_SWITCHOVERDATE_TBL;CREATE COLUMN TABLE BFL_FDD_SWITCHOVERDATE_TBL ( "SWITCHOVERDATE"VARCHAR(255) ) ;INSERT INTO BFL_FDD_SWITCHOVERDATE_TBL VALUES ('20100401') ;DROP TABLE BFL_FDD_DRIVERS_TBL;CREATE COLUMN TABLE BFL_FDD_DRIVERS_TBL ( "DRIVER1" DOUBLE,"DRIVER2" DOUBLE) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (10,100) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (10,100) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (10,100) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (10,100) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (11,120) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (11,100) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (10,120) ;INSERT INTO BFL_FDD_DRIVERS_TBL VALUES (11,124) ;

DROP TABLE BFL_FDD_RESULTS_TBL;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_FDD_RESULTS_TBL ("FORECAST" DOUBLE, "EFFECT1" DOUBLE,"EFFECT2" DOUBLE, "INTERACTION" DOUBLE) ;CALL BFL_TEST.AFLBFL_FORECASTDUALDRIVER_PROC (BFL_FDD_HISTORY_TBL,BFL_FDD_DATECOL_TBL, BFL_FDD_SWITCHOVER_TBL, BFL_FDD_SWITCHOVERDATE_TBL,

BFL_FDD_DRIVERS_TBL, BFL_FDD_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_FDD_RESULTS_TBL ;

3.18 Forecast Mix

This function mixes the actual data prior to the switchover date with prediction data on and after. For example,

if the switchover date is set in May, then the function Mixed=Mix (May; Actual; Forecast) will mix the actual

data before and including April, and prediction data from May onwards.

Formula

If the current period is before the period containing the switchover date:

Mixed = Actual

If the current period comes on or after the switchover date:

Mixed = Forecast

Signature

Input Tables

Table 47:


umns


Actual Input Table 1 Double ACTUAL Actual historic

data.

Periods Input Table 1 Double FORECASTMIX

PERIODS

Periods need to

forecast.

56

P U B L I C



BFL Functions




umns


Switchover Input Table 1 Double SWITCHOVER Switchover type:■ 0 = Historic

■ 1 = Specific

Date ■ 2 = Di

mension List ■

3 = Today ■ 4

= Month Note: The

1 and 2 options are

the same in SAP

HANA 1.0 SP3.


RDATE

Defines the first

future period. This

parameter is de

pendent on the

SWITCHOVER

type you specify.

Forecast Input Table 1 Double FORECAST Forecast or plan.

Output Table

Table 48:


umns


Result Output Table 1 Double FORECASTMIX Mixes historic ac

tual data with fu

ture forecast fig

ures

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FM_ACTUAL_TBL;CREATE COLUMN TABLE BFL_FM_ACTUAL_TBL ( "ACTUAL" DOUBLE ) ;INSERT INTO BFL_FM_ACTUAL_TBL VALUES (120) ;INSERT INTO BFL_FM_ACTUAL_TBL VALUES (140) ;INSERT INTO BFL_FM_ACTUAL_TBL VALUES (130) ;DROP TABLE BFL_FM_FORECASTMIXPERIODS_TBL;CREATE COLUMN TABLE BFL_FM_FORECASTMIXPERIODS_TBL ( "FORECASTMIXPERIODS"DOUBLE) ;INSERT INTO BFL_FM_FORECASTMIXPERIODS_TBL VALUES (12) ;

DROP TABLE BFL_FM_SWITCHOVER_TBL;CREATE COLUMN TABLE BFL_FM_SWITCHOVER_TBL ( "SWITCHOVER" DOUBLE ) ;


BFL Functions

P U B L I C




INSERT INTO BFL_FM_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_FM_SWITCHOVERDATE_TBL;CREATE COLUMN TABLE BFL_FM_SWITCHOVERDATE_TBL ( "SWITCHOVERDATE" VARCHAR(255)) ;INSERT INTO BFL_FM_SWITCHOVERDATE_TBL VALUES ('20100301') ;

DROP TABLE BFL_FM_FORECAST_TBL;CREATE COLUMN TABLE BFL_FM_FORECAST_TBL ( "FORECAST" DOUBLE) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;INSERT INTO BFL_FM_FORECAST_TBL VALUES (100) ;DROP TABLE BFL_FM_RESULTS_TBL;CREATE COLUMN TABLE BFL_FM_RESULTS_TBL ("FORECASTMIX" DOUBLE) ;

CALL _SYS_AFL.AFLBFL_FORECASTMIX_PROC(BFL_FM_ACTUAL_TBL,BFL_FM_FORECASTMIXPERIODS_TBL, BFL_FM_SWITCHOVER_TBL, BFL_FM_SWITCHOVERDATE_TBL,BFL_FM_FORECAST_TBL, BFL_FM_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_FM_RESULTS_TBL ;

3.19 Forecast Sensitivity

This erLang function calculates the proportion of requests which will be queued, when there is no agent

available.

Formula

This section lists the equations for each method.

Useful Identities

Some of the equations can be expressed in two Year over Year Difference ways:

(1 - {rho}) * s = s - a

or

{mu} * ST / 3600 = ST / AHT

The preferred usage is the second expression, which may disguise the equations you are expecting.

Loss

Loss uses the recursive equations:

B[0, a] = 1; and B[s, a] = (a * B[s-1, a]) / (s + a * B[s-1,a]

Where B[s, a] is loss for {s} servers and intensity {a}.

58

P U B L I C



BFL Functions



Delay

Delay is calculated from the corresponding Loss:

C[s, a] = B[s, a] / ( 1 - {rho}) * ( 1 - B[s, a])

Service Level

Service Level Provided (SLP) is the service level provided by a given number of agents " s" and a given average

service time {ST}:

SLP = 1 - C[s, a] * {e}^((a - s) * ST / AHT)

Where {e} is Euler's number.

Agents

The number of agents needed to provide a given SLA is the lowest whole number such that:

SLP >= SLA

Queue Time

The average waiting time in queue once a call is put in:

1 / ((s - a) * {mu})

Queue Length

The average number of calls in the queue is:

(C[s,a] * {rho} / ( 1 - {rho})

Time to Agent

The average time to agent is:

C[s, a] * AQT=Cs{AQT}

Critical Queue Time

The CQTP is the proportion of calls in the queue for longer than the critical queue time:

{e} ^ ((a-s) * CQT / AHT)

Where {e} is Euler's number.

Critical Queue Length

When critical queue length is positive, CQLP is the probability that the number of calls in the queue is greateror equal to the critical queue length:

C[s, a] * {rho} ^ CQL

When CQL is negative, the value returned represents the probability that (-{CQL}) or fewer of the agents are

free to answer a call when it arrives, or the probability that at least (Agents + Critical Queue Length) agents are

busy. The calculations are recursive. Working back from CQL = 0, one agent at a time, they are:

Stop when you know CQLP[j] for j = s + {CQL};

delta[s-1] = C[s,a] * ((s/a)-1); CQLP[s-1] = delta[s-1] + C[s,a] = C[s,a]*s/a.


BFL Functions

P U B L I C




Then, for each j:

delta[j-1] = delta[j]*j/a; CQLP[j-1] = delta[j-1] + CQLP[j]

Signature

Input Tables

Table 49:


umns


Agents Input Table 1 Double VALUE The number of

agents available

Service Requests

Per Hour

Input Table 1 Double VALUE The average serv

ice request re

ceived in an hour

(or period)

Average Handle

Time

Input Table 1 Double VALUE The average han

dling time = re

quest duration in

seconds

Service Time Input Table 1 Double VALUE The critical aver

age waiting time in

seconds before a

request reaches

an agent

Critical Queue

Time

Input Table 1 Double VALUE CQT = critical time

in seconds that a

request remains in

the queue once it

is put there

Critical Queue

Length

Input Table 1 Double VALUE Critical queue

length (may be

negative)

Output Table

Table 50:


umns


Result Output Table 11 Double COMPLE

TION_RATE

3600/AHT = aver

age number of re

quests handled

per hour by one

agent

Double TRAFFIC_RATE Traffic Intensity =

Birth Rate/

Completion

60

P U B L I C



BFL Functions




umns


Double UTILIZATION =Traffic Rate /Agents Proportion

of an average

agent's time is

spent handling a

request

Double LOSS Loss Function

Double DELAY Delay Function

Double QUEUE_TIME Average queue

time, once a re

quest is put in the

queue

Double QUEUE_LENGTH Average number

of requests in the

queue

Double TIME_TO_AGENT Average time in

which a request

reaches an agent

Double CQT_PROPOR

TION

Proportion of calls

in queue for longer

than critical queue

time

Double CQL_PROBABIL

ITY

Probability that

number of calls in

queue is greater or

equal to critical

queue length

Double SERV

ICE_LEVEL_PRO-

VIDED

Service level pro

vided

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FS_VALUES1_TBL ;CREATE COLUMN TABLE BFL_FS_VALUES1_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_FS_VALUES1_TBL VALUES (55) ;DROP TABLE BFL_FS_VALUES2_TBL ;CREATE COLUMN TABLE BFL_FS_VALUES2_TBL ( "VALUE" DOUBLE ) ;

INSERT INTO BFL_FS_VALUES2_TBL VALUES (720) ;DROP TABLE BFL_FS_VALUES3_TBL ;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_FS_VALUES3_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FS_VALUES3_TBL VALUES (240) ;DROP TABLE BFL_FS_VALUES4_TBL ;CREATE COLUMN TABLE BFL_FS_VALUES4_TBL ( "VALUE" DOUBLE ) ;

INSERT INTO BFL_FS_VALUES4_TBL VALUES (15) ;DROP TABLE BFL_FS_VALUES5_TBL ;CREATE COLUMN TABLE BFL_FS_VALUES5_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FS_VALUES5_TBL VALUES (5) ;DROP TABLE BFL_FS_VALUES6_TBL ;CREATE COLUMN TABLE BFL_FS_VALUES6_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_FS_VALUES6_TBL VALUES (10) ;DROP TABLE BFL_FS_RESULTS_TBL ;CREATE COLUMN TABLE BFL_FS_RESULTS_TBL ( "COMPLETION_RATE" DOUBLE,"TRAFFIC_RATE" DOUBLE,"UTILIZATION" DOUBLE, "LOSS" DOUBLE, "DELAY" DOUBLE,"QUEUE_TIME" DOUBLE, "QUEUE_LENGTH" DOUBLE, "TIME_TO_AGENT" DOUBLE,"CQT_PROPORTION" DOUBLE, "CQL_PROBABILITY" DOUBLE, "SERVICE_LEVEL_PROVIDED"DOUBLE) ; CALL _SYS_AFL.AFLBFL_FORECASTSENSITIVITY_PROC(BFL_FS_VALUES1_TBL,BFL_FS_VALUES2_TBL, BFL_FS_VALUES3_TBL, BFL_FS_VALUES4_TBL, BFL_FS_VALUES5_TBL,

BFL_FS_VALUES6_TBL, BFL_FS_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_FS_RESULTS_TBL ;

3.20 Funds

This function calculates the amount of increased assets or decreased liabilities resulting from the use of funds.

This is a critical functionality when planning within government environments or within project planning.

Formula

Funds=Funds (Assets; Sign)

With the parameter sign positive, Funds calculates the use of funds.

Funds=Funds (Assets; +)

Funds, Period n = (Assets, Period n) - (Assets, Period n-1)

With the parameter sign negative, Funds calculates the source of funds.

Funds = Funds (Assets; -)

Funds, Period n = (Assets, Period n-1) - (Assets, Period n)

Signature

Input Tables

62

P U B L I C



BFL Functions



Table 51:


umns


Assets Input Table 1 Double VALUE The asset values

Sign Input Table 1 Int VALUE + or – When the

source of funds

are displayed as

negative numbers,

increase in assets

displays as posi

tive numbers, and

vice versa.

Output Table

Table 52:


umns


Result Output Table 1 Double FUNDS The use of funds

Example

Assume that:




SET SCHEMA BFL_TEST;DROP TABLE BFL_FUNDS_ASSETS_TBL;CREATE COLUMN TABLE BFL_FUNDS_ASSETS_TBL( "VALUE" DOUBLE ) ;INSERT INTO BFL_FUNDS_ASSETS_TBL VALUES (1000) ;INSERT INTO BFL_FUNDS_ASSETS_TBL VALUES (2000) ;INSERT INTO BFL_FUNDS_ASSETS_TBL VALUES (4000) ;INSERT INTO BFL_FUNDS_ASSETS_TBL VALUES (8000) ;INSERT INTO BFL_FUNDS_ASSETS_TBL VALUES (8000) ;DROP TABLE BFL_FUNDS_SIGN_TBL;

CREATE COLUMN TABLE BFL_FUNDS_SIGN_TBL( "VALUE" INTEGER);INSERT INTO BFL_FUNDS_SIGN_TBL VALUES (-1) ;DROP TABLE BFL_FUNDS_FUNDS_TBL;CREATE COLUMN TABLE BFL_FUNDS_FUNDS_TBL( "FUNDS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_FUNDS_PROC(BFL_FUNDS_ASSETS_TBL, BFL_FUNDS_SIGN_TBL,BFL_FUNDS_FUNDS_TBL) WITH OVERVIEW ; SELECT * FROM BFL_FUNDS_FUNDS_TBL ;

3.21 Future


BFL Functions

P U B L I C




This function calculates the closing balance of an account given the start balance and the conditions under

which the account runs. As a key treasury planning function, it is extremely useful for scheduling purchases

and payments around favorable account balances, which is particularly important to address when the current

economic focus is on balance sheet versus P&L (profit and loss).

Formula

FUTURE VALUE = PRESENT VALUE(Number Periods; Rate; PAYMENT; PRESENT VALUE; Type; Payments;

Opening Value; Closing Value; Interest Paid; Periods Left)

Start[1+Number Periods]=End[Number Periods]=-FUTURE VALUE

If Rate equals 0, then

FUTURE VALUE =-( (PAYMENT * Number Periods) + PRESENT VALUE)

If the rate is non-zero, then

FUTURE VALUE

= -(( PRESENT VALUE * (1 + Rate) Number Periods) + Payment(1 + (Rate* type))

Signature

Input Tables

Table 53:


umns


Periods Input Table 1 Double PERIOD Number of periods

the account is to

run

Rate Input Table 1 Double RATE Rate per period

Original Input Table 1 Double PRESENT Present values

Payment Input Table 1 Double PAYMENT Constant payment

applied to the ac

count in each pe

riod

64

P U B L I C



BFL Functions




umns


Type Input Table 1 Double METHOD Specifies whetherthe payment is ap

plied at the begin

ning or end of the

period: ■ 0 =

at the end of the

period ■ 1 = at

the beginning of

the period

Output Table

Table 54:


umns


Result Output Table 6 Double FUTURE Future values

Double PAYMENT Constant payment

applied to the ac

count in each pe

riod

Double OPENING The original value

Double CLOSING The final value

Double INTEREST The total paid in

terest

Double PERIODS Present values

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_FUTURE_PERIODS_TBL;CREATE COLUMN TABLE BFL_FUTURE_PERIODS_TBL ( "PERIOD" DOUBLE ) ;INSERT INTO BFL_FUTURE_PERIODS_TBL VALUES (4) ;INSERT INTO BFL_FUTURE_PERIODS_TBL VALUES (3) ;DROP TABLE BFL_FUTURE_RATE_TBL;CREATE COLUMN TABLE BFL_FUTURE_RATE_TBL ( "RATE" DOUBLE ) ;INSERT INTO BFL_FUTURE_RATE_TBL VALUES (0.5) ;INSERT INTO BFL_FUTURE_RATE_TBL VALUES (0.5) ;DROP TABLE BFL_FUTURE_ORIGINAL_TBL;CREATE COLUMN TABLE BFL_FUTURE_ORIGINAL_TBL ( "PRESENT" DOUBLE ) ;INSERT INTO BFL_FUTURE_ORIGINAL_TBL VALUES (10000) ;INSERT INTO BFL_FUTURE_ORIGINAL_TBL VALUES (-10000) ;

DROP TABLE BFL_FUTURE_PAYMENT_TBL;CREATE COLUMN TABLE BFL_FUTURE_PAYMENT_TBL ( "PAYMENT" DOUBLE ) ;


BFL Functions

P U B L I C




INSERT INTO BFL_FUTURE_PAYMENT_TBL VALUES (500) ;INSERT INTO BFL_FUTURE_PAYMENT_TBL VALUES (2500) ;DROP TABLE BFL_FUTURE_METHOD_TBL;CREATE COLUMN TABLE BFL_FUTURE_METHOD_TBL ( "METHOD" DOUBLE ) ;

INSERT INTO BFL_FUTURE_METHOD_TBL VALUES (1) ;INSERT INTO BFL_FUTURE_METHOD_TBL VALUES (1) ;DROP TABLE BFL_FUTURE_FUTURE_TBL;CREATE COLUMN TABLE BFL_FUTURE_FUTURE_TBL ( "FUTURE" DOUBLE, "PAYMENT" DOUBLE,"OPENING" DOUBLE, "CLOSING" DOUBLE, "INTEREST" DOUBLE, "PERIODS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_FUTURE_PROC(BFL_FUTURE_PERIODS_TBL, BFL_FUTURE_RATE_TBL,BFL_FUTURE_ORIGINAL_TBL, BFL_FUTURE_PAYMENT_TBL, BFL_FUTURE_METHOD_TBL,BFL_FUTURE_FUTURE_TBL) WITH OVERVIEW; SELECT * FROM BFL_FUTURE_FUTURE_TBL;

3.22 Grow

This function makes a base figure grow at a specified percentage for each period. This can either be

compound or linear growth. This function is extremely important for financial calculation that is difficult to

script (similar to compound interest functions).

Formula

If the date of which growth is needed to be calculated is prior to the period containing the switchover date:

Grow_result=Base

If the date is in the period containing the switchover date:

For compound growth, the increase of each period is calculated based on the previous result:

Where n= periods after switchover date, rate=% growth rate, and Base is the base figure in the period

containing the switchover date.

Signature

Input Tables

66

P U B L I C



BFL Functions



Table 55:


umns


Values Input Table 1 Double VALUE Base data.

Periods Input Table 1 Double VALUE Periods to grow.

Rate Input Table 1 Double VALUE Percentage to

grow by in each

period.

Type Input Table 1 Double VALUE Linear or com

pound.

Switchover Input Table 1 Double VALUE Linear or com

pound. ■ Lin

ear – linear growth

rate ■ Com

pound – com

pound growth rate

(default if not

specified)

Switchoverdate Input Table 1 String VALUE Defines the first

future period. This

parameter is de

pendent on the

switchover type

you specify.

Output Table

Table 56:


umns


Result Output Table 1 Double GROW Grow result

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_GROW_VALUES_TBL ;CREATE COLUMN TABLE BFL_GROW_VALUES_TBL ( "VALUE" DOUBLE ) ;base valuesINSERT INTO BFL_GROW_VALUES_TBL VALUES (800);INSERT INTO BFL_GROW_VALUES_TBL VALUES (800);INSERT INTO BFL_GROW_VALUES_TBL VALUES (900);INSERT INTO BFL_GROW_VALUES_TBL VALUES (1000);DROP TABLE BFL_GROW_GROWPERIODS_TBL ;CREATE COLUMN TABLE BFL_GROW_GROWPERIODS_TBL( "VALUE" DOUBLE );

INSERT INTO BFL_GROW_GROWPERIODS_TBL VALUES (3);DROP TABLE BFL_GROW_GROWRATE_TBL ;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_GROW_GROWRATE_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_GROW_GROWRATE_TBL VALUES (0.1) ;DROP TABLE BFL_GROW_GROWTYPE_TBL ;CREATE COLUMN TABLE BFL_GROW_GROWTYPE_TBL ( "VALUE" DOUBLE ) ;

INSERT INTO BFL_GROW_GROWTYPE_TBL VALUES (0) ;DROP TABLE BFL_GROW_SWITCHOVER_TBL ;CREATE COLUMN TABLE BFL_GROW_SWITCHOVER_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_GROW_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_GROW_SWITCHOVERDATE_TBL ;CREATE COLUMN TABLE BFL_GROW_SWITCHOVERDATE_TBL ( "VALUE" VARCHAR(255) ) ;INSERT INTO BFL_GROW_SWITCHOVERDATE_TBL VALUES ('20100301') ;DROP TABLE BFL_GROW_RESULTS_TBL ;CREATE COLUMN TABLE BFL_GROW_RESULTS_TBL ( "GROW" DOUBLE) ;CALL _SYS_AFL.AFLBFL_GROW_PROC(BFL_GROW_VALUES_TBL, BFL_GROW_GROWPERIODS_TBL,BFL_GROW_GROWRATE_TBL, BFL_GROW_GROWTYPE_TBL, BFL_GROW_SWITCHOVER_TBL,BFL_GROW_SWITCHOVERDATE_TBL, BFL_GROW_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_GROW_RESULTS_TBL;

3.23 Inflated Cash Flow

In order to compensate inflation, this function calculates the cash amount in a specific future period that you

need to receive.

Formula

Where,

r = discount rate expressed as a decimal fraction

n = number of periods into the future

Signature

Input Tables

Table 57:


umns


Prime Input Table 1 Double PRIME Prime/base value

Time Input Table 1 String TIME The periods to be

calculated

68

P U B L I C



BFL Functions




umns


Rate Input Table 1 Double RATE Discount rate

APR Input Table 1 Double APR =annual % by de

fault = annual rate

(rate=%/100) =

Periodic % = Peri

odic rate

Switchover Input Table 1 Double SWITCHOVER The switchover

date defines the

last historic pe

riod: = Historic:

Treat all periods

as historic =Input

Date: Formatteddate =TimeScale:

Use rate defined in

timescale =Month:

Use month

SwitchoverDate Input Table 1 String SWITCHOVER

DATE

Specify the

switchover date

Output Table

Table 58:


umns


Result Output Table 1 Double RESULT Constant value

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_ICF_PRIME_TBL;CREATE COLUMN TABLE BFL_ICF_PRIME_TBL( "PRIME" DOUBLE ) ;INSERT INTO BFL_ICF_PRIME_TBL VALUES (1000) ;DROP TABLE BFL_ICF_TIME_TBL;CREATE COLUMN TABLE BFL_ICF_TIME_TBL( "TIME" VARCHAR(255)) ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20100101') ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20110101') ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20120101') ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20130101') ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20140101') ;INSERT INTO BFL_ICF_TIME_TBL VALUES ('20150101') ;DROP TABLE BFL_ICF_RATE_TBL;

CREATE COLUMN TABLE BFL_ICF_RATE_TBL( "RATE" DOUBLE ) ;INSERT INTO BFL_ICF_RATE_TBL VALUES (0.1) ;


BFL Functions

P U B L I C




DROP TABLE BFL_ICF_APR_TBL;CREATE COLUMN TABLE BFL_ICF_APR_TBL( "APR" DOUBLE) ;INSERT INTO BFL_ICF_APR_TBL VALUES (3) ;DROP TABLE BFL_ICF_SWITCHOVER_TBL;

CREATE COLUMN TABLE BFL_ICF_SWITCHOVER_TBL( "SWITCHOVER" DOUBLE ) ;INSERT INTO BFL_ICF_SWITCHOVER_TBL VALUES (1) ;DROP TABLE BFL_ICF_SWITCHOVERDATE_TBL ;CREATE COLUMN TABLE BFL_ICF_SWITCHOVERDATE_TBL( "SWITCHOVERDATE" VARCHAR(255));INSERT INTO BFL_ICF_SWITCHOVERDATE_TBL VALUES ('20091231') ;DROP TABLE BFL_ICF_RESULTS_TBL ;CREATE COLUMN TABLE BFL_ICF_RESULTS_TBL ( "RESULT" DOUBLE); CALL _SYS_AFL.AFLBFL_INFLATEDCASHFLOW_PROC(BFL_ICF_PRIME_TBL, BFL_ICF_TIME_TBL,BFL_ICF_RATE_TBL, BFL_ICF_APR_TBL, BFL_ICF_SWITCHOVER_TBL,BFL_ICF_SWITCHOVERDATE_TBL, BFL_ICF_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_ICF_RESULTS_TBL;

3.24 Internal Rate of Return (IRR)

This function is closely related to the Net Present Value (NPV) Function. It calculates the IRR, the rate of which

makes NPV equal to zero for any series of cash flows.

Formula

Internal Rate of Return is the solution to the equation below:

Where:

Pi is the Payment Value in the ith period.

di is the ith or last payment date.

d1 is the date at which The IRR is being calculated so that di - d1 means the number of days forward from the

day where IRR is being calculated.

It is found by making repeated iterations starting from the value of Estimate.

Signature

Input Tables

70

P U B L I C



BFL Functions



Table 59:


umns


Values Input Table 1 Double VALUE The series of cash

values for which a

rate is to be calcu

lated.

Flag Input Table 1 Double FLAG Date of Payment:

Start; Middle; End;

User defines

when, during the

period, the pay

ment takes place.

Payment Date Input Table 1 String PAYDATE The payment date

Estimate Input Table 1 Double ESTIMATE Input as a percentage

Method Input Table 1 Double METHOD Calculate looking

forward to all fu

ture periods.

Days Input Table 1 Double DAYS Days number in

each period

Output Table

Table 60:


umns


Result Output Table 1 Double INTERNALRATE The Internal Rate

of Return. The rate

of return yielded

by the series of

cash flows calcu

lated as an annual

percentage. Re

cursive calcula

tion.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_IRR_VALUES_TBL;CREATE COLUMN TABLE BFL_IRR_VALUES_TBL( "VALUE" DOUBLE );

INSERT INTO BFL_IRR_VALUES_TBL VALUES (-10000);INSERT INTO BFL_IRR_VALUES_TBL VALUES (1000);


BFL Functions

P U B L I C




INSERT INTO BFL_IRR_VALUES_TBL VALUES (2500);INSERT INTO BFL_IRR_VALUES_TBL VALUES (4000);INSERT INTO BFL_IRR_VALUES_TBL VALUES (4000);INSERT INTO BFL_IRR_VALUES_TBL VALUES (4000);

INSERT INTO BFL_IRR_VALUES_TBL VALUES (4000);DROP TABLE BFL_IRR_FLAG_TBL;CREATE COLUMN TABLE BFL_IRR_FLAG_TBL( "FLAG" DOUBLE );INSERT INTO BFL_IRR_FLAG_TBL VALUES (4);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);INSERT INTO BFL_IRR_FLAG_TBL VALUES (3);DROP TABLE BFL_IRR_USERDATE_TBL;CREATE COLUMN TABLE BFL_IRR_USERDATE_TBL( "PAYDATE" VARCHAR(255) );INSERT INTO BFL_IRR_USERDATE_TBL VALUES ('12/10/00');DROP TABLE BFL_IRR_ESTIMATE_TBL;CREATE COLUMN TABLE BFL_IRR_ESTIMATE_TBL( "ESTIMATE" DOUBLE );INSERT INTO BFL_IRR_ESTIMATE_TBL VALUES (0.3);

DROP TABLE BFL_IRR_METHOD_TBL;CREATE COLUMN TABLE BFL_IRR_METHOD_TBL( "METHOD" DOUBLE );INSERT INTO BFL_IRR_METHOD_TBL VALUES (0);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);INSERT INTO BFL_IRR_METHOD_TBL VALUES (1);DROP TABLE BFL_IRR_DAYS_TBL;CREATE COLUMN TABLE BFL_IRR_DAYS_TBL( "DAYS" DOUBLE );INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);INSERT INTO BFL_IRR_DAYS_TBL VALUES (365);DROP TABLE BFL_IRR_RESULT_TBL;CREATE COLUMN TABLE BFL_IRR_RESULT_TBL( "INTERNALRATE" DOUBLE); CALL _SYS_AFL.AFLBFL_INTERNALRATE_PROC(BFL_IRR_VALUES_TBL, BFL_IRR_FLAG_TBL,BFL_IRR_USERDATE_TBL, BFL_IRR_ESTIMATE_TBL, BFL_IRR_METHOD_TBL,BFL_IRR_DAYS_TBL, BFL_IRR_RESULT_TBL) WITH OVERVIEW; SELECT * FROM BFL_IRR_RESULT_TBL;

3.25 Lag

This function lags an input from one row by a certain number of periods and returns the result in another row.

This is a streamlined method for estimating lag periods (such as invoice to receipt) directly into the model.

Formula

The result in period n lags the input by p periods;

(Lag result, period n) = (Input, period n-p)

72

P U B L I C



BFL Functions



If the lagged result requires inputs outside the timescale, use the values from parameter Pad.

(Lag result, period n) = (Pad, period n)

Signature

Input Tables

Table 61:


umns


Basevalues Input Table 1 Double VALUE Sets a lag of a vari

able number of pe

riods according to

what is contained

in the Dimension

List item.

Pad Input Table 1 Double PAD Constant to pad

values contrast to

the corresponding

base values.

Periods Input Table 1 Double PERIOD The series to be

lagged (e.g. in

voiced amounts).

Output Table

Table 62:


umns


Result Output Table 1 Double VALUE Lag result (e.g.

cash payments

made after a lag of

n periods).

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_LAG_VALUES_TBL ;CREATE COLUMN TABLE BFL_LAG_VALUES_TBL ( "VALUE" DOUBLE ) ;base values

INSERT INTO BFL_LAG_VALUES_TBL VALUES (1000);INSERT INTO BFL_LAG_VALUES_TBL VALUES (2000);


BFL Functions

P U B L I C




INSERT INTO BFL_LAG_VALUES_TBL VALUES (2500);INSERT INTO BFL_LAG_VALUES_TBL VALUES (2300);INSERT INTO BFL_LAG_VALUES_TBL VALUES (3000);INSERT INTO BFL_LAG_VALUES_TBL VALUES (1200);

DROP TABLE BFL_LAG_PAD_TBL ;CREATE COLUMN TABLE BFL_LAG_PAD_TBL ( "PAD" DOUBLE ) ;INSERT INTO BFL_LAG_PAD_TBL VALUES (999);INSERT INTO BFL_LAG_PAD_TBL VALUES (888);INSERT INTO BFL_LAG_PAD_TBL VALUES (0);INSERT INTO BFL_LAG_PAD_TBL VALUES (0);INSERT INTO BFL_LAG_PAD_TBL VALUES (0);INSERT INTO BFL_LAG_PAD_TBL VALUES (0);DROP TABLE BFL_LAG_PERIOD_TBL ;CREATE COLUMN TABLE BFL_LAG_PERIOD_TBL ( "PERIOD" DOUBLE ) ;INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);INSERT INTO BFL_LAG_PERIOD_TBL VALUES (2);

DROP TABLE BFL_LAG_RESULTS_TBL ;CREATE COLUMN TABLE BFL_LAG_RESULTS_TBL ( "VALUE" DOUBLE) ; CALL _SYS_AFL.AFLBFL_LAG_PROC(BFL_LAG_VALUES_TBL, BFL_LAG_PAD_TBL,BFL_LAG_PERIOD_TBL, BFL_LAG_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_LAG_RESULTS_TBL;

3.26 Last

This function returns the most recent non-zero value of the input over a number of periods. When the inputchanges rarely, it helps to avoid re-entering data.

Formula

The result is the most recent non-zero value of the input in Period n .

Signature

Input Tables

Table 63:


umns


Prime Input Table 1 Double VALUE The series of data

on which Last op

erates.

Output Table

74

P U B L I C



BFL Functions



Table 64:


umns


Result Output Table 1 Double LAST The most recent

non-zero value in

the series of data

to a precision of

1x10^(-12).

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_LAST_PRIME_TBL;CREATE COLUMN TABLE BFL_LAST_PRIME_TBL( "VALUE" DOUBLE );INSERT INTO BFL_LAST_PRIME_TBL VALUES (200);INSERT INTO BFL_LAST_PRIME_TBL VALUES (0);INSERT INTO BFL_LAST_PRIME_TBL VALUES (0);INSERT INTO BFL_LAST_PRIME_TBL VALUES (300);INSERT INTO BFL_LAST_PRIME_TBL VALUES (0);INSERT INTO BFL_LAST_PRIME_TBL VALUES (400);INSERT INTO BFL_LAST_PRIME_TBL VALUES (0);INSERT INTO BFL_LAST_PRIME_TBL VALUES (500);INSERT INTO BFL_LAST_PRIME_TBL VALUES (0);DROP TABLE BFL_LAST_LAST_TBL;CREATE COLUMN TABLE BFL_LAST_LAST_TBL( "LAST" DOUBLE); CALL _SYS_AFL.AFLBFL_LAST_PROC(BFL_LAST_PRIME_TBL, BFL_LAST_LAST_TBL) WITHOVERVIEW; SELECT * FROM BFL_LAST_LAST_TBL;

3.27 Lease

This function calculates a payment schedule (e.g. How much you need to pay in each period) for a lease, loan,

mortgage, annuity or savings account. Multiple lease contracts are allowed to be entered on one single page,

and the terms of each contract in one single column. This is similar to the Payment Function, but it allows Year

over Year Difference leases to be entered in Year over Year Difference columns, as opposed to Year over Year

Difference pages.

For each lease, the inputs include annual interest rate, term, present and future values, and the result is a

constant payment. Interest, a constant or vary by each period, is entered per period and compounded at the

end of each period. Early redemption is allowed, which is a percentage of the opening balance. Lease requires

equal, consecutive periods.

Embedded Lease Function is a critical element for accurate CAPEX planning and treasury applications.


BFL Functions

P U B L I C




Signature

Input Tables

Table 65:


umns


Advance Amount Input Table 1 Double ADVANCE The payment from

or to the account

at the start of the

calculation. If no

further advances

occur, leave it as

zero.

Residual Amount Input Table 1 Double RESIDUAL The payment fromor to account at

the end of the cal

culation. If the ac

count is repaid

completely, the

loan would be

zero.

Number Periods Input Table 1 Double PERIODS The number of pe

riods the account

is to run.

When to Pay Input Table 1 Double WHENTOPAY 0 = Payment is

made at the end ofthe period. (De

fault) 1= Payment

is made at the

start of the period.

Interest Rate Input Table 1 Double RATE Percentage rate

per period.

Redemption Rate Input Table 1 Double REDEMPTION

REATE

Interpreted as a

percentage, but it

must be the rate

per period.

Output Table

Table 66:


umns



ance of the ac

count. Will be

equal to PRESENT

VALUE in the first

calculation period.

76

P U B L I C



BFL Functions




umns


Double ADJUSTED The opening balance of the ac

count adjusted for

redemptions and

further advances.

Double INTEREST 0 = Adjusted

Opening * Rate

per Period/100 1 =

(Adjusted Opening

+ Payment) * Rate

per Period/100

Double PAYMENT The single pay

ment to the account this period

which contains in

terest element and

capital element.

Double REDEMPTION The amount of the

account paid off

early Calculated

by: First period:

Advance Amount*

Redemption

Rate /100 Subse

quent periods:

(Opening Value)*

Redemption

Rate /100

Double CAPITAL The amount of

capital paid off in

the period

Double RESIDUALPAID

OFF

Will be non-zero

only in the last pe

riod of the account

when it represents

the residual value

of the loan being

repaid. It is equal

to FUTURE VALUE

from the first pe

riod adjusted by

any redemptions

during the life of

the loan.

Double CLOSING The closing bal

ance of the ac

count. Should be

set as a time aver

age, last period.


BFL Functions

P U B L I C





umns


Double PERIODSREMAINING

Will be the Number of periods in

the first calcula

tion period and will

reduce by 1 in

each subsequent

period.

Double CALCRESIDUAL FUTURE VALUE

from the first pe

riod adjusted by

redemptions dur

ing the life of the

loan to date.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_LEASE_ADVANCE_TBL ;CREATE COLUMN TABLE BFL_LEASE_ADVANCE_TBL ( "ADVANCE" DOUBLE );INSERT INTO BFL_LEASE_ADVANCE_TBL VALUES (150000) ;INSERT INTO BFL_LEASE_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LEASE_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LEASE_ADVANCE_TBL VALUES (0) ;DROP TABLE BFL_LEASE_RESIDUAL_TBL ;CREATE COLUMN TABLE BFL_LEASE_RESIDUAL_TBL ( "RESIDUAL" DOUBLE ) ;INSERT INTO BFL_LEASE_RESIDUAL_TBL VALUES (10000) ;INSERT INTO BFL_LEASE_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LEASE_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LEASE_RESIDUAL_TBL VALUES (0) ;DROP TABLE BFL_LEASE_PERIODS_TBL ;CREATE COLUMN TABLE BFL_LEASE_PERIODS_TBL ( "PERIODS" DOUBLE ) ;INSERT INTO BFL_LEASE_PERIODS_TBL VALUES (4) ;INSERT INTO BFL_LEASE_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LEASE_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LEASE_PERIODS_TBL VALUES (0) ;DROP TABLE BFL_LEASE_WHENTOPAY_TBL ;CREATE COLUMN TABLE BFL_LEASE_WHENTOPAY_TBL ( "WHENTOPAY" DOUBLE ) ;INSERT INTO BFL_LEASE_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LEASE_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LEASE_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LEASE_WHENTOPAY_TBL VALUES (1) ;DROP TABLE BFL_LEASE_RATE_TBL ;CREATE COLUMN TABLE BFL_LEASE_RATE_TBL ( "RATE" DOUBLE ) ;INSERT INTO BFL_LEASE_RATE_TBL VALUES (0.02) ;INSERT INTO BFL_LEASE_RATE_TBL VALUES (0.015) ;INSERT INTO BFL_LEASE_RATE_TBL VALUES (0.015) ;INSERT INTO BFL_LEASE_RATE_TBL VALUES (0.015) ;

DROP TABLE BFL_LEASE_REDEMPTIONREATE_TBL ;CREATE COLUMN TABLE BFL_LEASE_REDEMPTIONREATE_TBL ( "REDEMPTIONREATE" DOUBLE ) ;

78

P U B L I C



BFL Functions



INSERT INTO BFL_LEASE_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LEASE_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LEASE_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LEASE_REDEMPTIONREATE_TBL VALUES (0) ;

DROP TABLE BFL_LEASE_RESULTS_TBL ;CREATE COLUMN TABLE BFL_LEASE_RESULTS_TBL( "OPENING" DOUBLE, "ADJUSTED" DOUBLE,"INTEREST" DOUBLE, "PAYMENT" DOUBLE, "REDEMPTION" DOUBLE, "CAPITAL" DOUBLE,"RESIDUALPAIDOFF" DOUBLE, "CLOSING" DOUBLE, "PERIODSREMAINING" DOUBLE,"CALCRESIDUAL" DOUBLE) ; CALL _SYS_AFL.AFLBFL_LEASE_PROC(BFL_LEASE_ADVANCE_TBL, BFL_LEASE_RESIDUAL_TBL,BFL_LEASE_PERIODS_TBL, BFL_LEASE_WHENTOPAY_TBL, BFL_LEASE_RATE_TBL,BFL_LEASE_REDEMPTIONREATE_TBL, BFL_LEASE_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_LEASE_RESULTS_TBL ;

3.28 Lease Variable

This function calculates a payment schedule along a time scale (life of the loan). The time scale requires equal

and consecutive periods. In each period, a single payment must be made according to the When to Pay

parameter. It is not necessary to compound the interest in each period.

Compared with the Lease function, Lease Variable has two more input columns which represent two more

parameters: Compound and Recalculate.

● Compound: indicates whether or not to calculate compound interest in this period.

● Recalculate: determines whether or not to recalculate the payment schedule to take account of interestrate changes or other changes during this period.

Signature

Input Tables

Table 67:


umns


Advance Amount Input Table 1 Double ADVANCE The payment from

or to the account

at the start of the

calculation. If no

further advances

occur, leave it as

zero.


BFL Functions

P U B L I C





umns


Residual Amount Input Table 1 Double RESIDUAL The payment fromor to account at

the end of the cal

culation. If the ac

count is repaid

completely, the

loan would be

zero.

Number Periods Input Table 1 Double PERIODS The number of pe

riods the account

is to run.

When to Pay Input Table 1 Double WHENTOPAY 0 = Payment is

made at the end ofthe period. (De

fault) 1= Payment

is made at the

start of the period.

Interest Rate Input Table 1 Double RATE Percentage rate

per period.

Redemption Rate Input Table 1 Double REDEMPTION

REATE

Interpreted as a

percentage but

must be the rate

per period.

Compound Input Table 1 Double COMPOUND Indicate whether

or not to com

pound interest this

period.

Recalculate Input Table 1 Double RECALCULATE Indicate whether

or not to recalcu

late payments to

take account of in

terest rate

changes during

this period.

Output Table

Table 68:


umns



ance of the ac

count. Will be

equal to PRESENT

VALUE in the first

calculation period.

80

P U B L I C



BFL Functions




umns


Double ADJUSTED The opening balance of the ac

count adjusted for

redemptions and

further advances.

Double INTEREST 0 = Adjusted

Opening * Rate

per Period/100. 1

= (Adjusted Open

ing + Payment) *

Rate per Period/

100.

Double ACCRUED Any interest calculated in previous

periods not yet ap

plied to the ac

count.

Double PAYMENT The single pay

ment to the ac

count this period

which contains in

terest element and

capital element.

Double REDEMPTION The amount of the

account paid offearly Calculated

by: First Period:

Advance Amount*

Redemption

Rate /100 Subse

quent periods:

(Opening Value)*

Redemption

Rate /100

Double CAPITAL The amount of

capital paid off in

the period

Double RESIDUALPAID

OFF

Will be non-zero

only in the last pe

riod of the account

when it represents

the residual value

of the loan being

repaid. It is equal

to FUTURE VALUE

from the first pe

riod adjusted by

any redemptions

during the life of

the loan.


BFL Functions

P U B L I C





umns


Double CLOSING The closing balance of the ac

count. Should be

set as a time aver

age, last period.

Double PERIODSREMAIN

ING

Will be Number of

periods in the first

calculation period

and will reduce by

1 in each subse

quent period.

Double CALCRESIDUAL FUTURE VALUE

from the first period adjusted by

redemptions dur

ing the life of the

loan to date.

Example

Assume that:

●

BFL_TEST is a schema belonging to USER1; and● USER1 has been assigned the AFL__SYS_AFL_AFLBFL_EXECUTE or


SET SCHEMA BFL_TEST; DROP TABLE BFL_LSVB_ADVANCE_TBL ;CREATE COLUMN TABLE BFL_LSVB_ADVANCE_TBL ( "ADVANCE" DOUBLE );INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (100000) ;INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_ADVANCE_TBL VALUES (0) ;DROP TABLE BFL_LSVB_RESIDUAL_TBL ;CREATE COLUMN TABLE BFL_LSVB_RESIDUAL_TBL ( "RESIDUAL" DOUBLE ) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (15000) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (0) ;INSERT INTO BFL_LSVB_RESIDUAL_TBL VALUES (0) ;DROP TABLE BFL_LSVB_PERIODS_TBL ;CREATE COLUMN TABLE BFL_LSVB_PERIODS_TBL ( "PERIODS" DOUBLE ) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (6) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (0) ;INSERT INTO BFL_LSVB_PERIODS_TBL VALUES (0) ;DROP TABLE BFL_LSVB_WHENTOPAY_TBL ;

CREATE COLUMN TABLE BFL_LSVB_WHENTOPAY_TBL ( "WHENTOPAY" DOUBLE ) ;INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;

82

P U B L I C



BFL Functions



INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;

INSERT INTO BFL_LSVB_WHENTOPAY_TBL VALUES (1) ;DROP TABLE BFL_LSVB_RATE_TBL ;CREATE COLUMN TABLE BFL_LSVB_RATE_TBL ( "RATE" DOUBLE ) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;INSERT INTO BFL_LSVB_RATE_TBL VALUES (0.01) ;DROP TABLE BFL_LSVB_REDEMPTIONREATE_TBL ;CREATE COLUMN TABLE BFL_LSVB_REDEMPTIONREATE_TBL ( "REDEMPTIONREATE" DOUBLE ) ;INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;

INSERT INTO BFL_LSVB_REDEMPTIONREATE_TBL VALUES (0) ;DROP TABLE BFL_LSVB_COMPOUND_TBL ;CREATE COLUMN TABLE BFL_LSVB_COMPOUND_TBL ( "COMPOUND" DOUBLE ) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;INSERT INTO BFL_LSVB_COMPOUND_TBL VALUES (2) ;DROP TABLE BFL_LSVB_RECALCULATE_TBL ;CREATE COLUMN TABLE BFL_LSVB_RECALCULATE_TBL ( "RECALCULATE" DOUBLE ) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;INSERT INTO BFL_LSVB_RECALCULATE_TBL VALUES (2) ;DROP TABLE BFL_LSVB_RESULTS_TBL ;CREATE COLUMN TABLE BFL_LSVB_RESULTS_TBL( "OPENING" DOUBLE, "ADJUSTED" DOUBLE,"INTEREST" DOUBLE,"ACCRUED" DOUBLE, "PAYMENT" DOUBLE, "REDEMPTION" DOUBLE,"CAPITAL" DOUBLE, "RESIDUALPAIDOFF" DOUBLE, "CLOSING" DOUBLE, "PERIODSREMAINING"DOUBLE, "CALCRESIDUAL" DOUBLE) ; CALL _SYS_AFL.AFLBFL_LEASEVARIABLE_PROC(BFL_LSVB_ADVANCE_TBL,BFL_LSVB_RESIDUAL_TBL, BFL_LSVB_PERIODS_TBL, BFL_LSVB_WHENTOPAY_TBL,BFL_LSVB_RATE_TBL, BFL_LSVB_REDEMPTIONREATE_TBL, BFL_LSVB_COMPOUND_TBL,BFL_LSVB_RECALCULATE_TBL, BFL_LSVB_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_LSVB_RESULTS_TBL ;

3.29 Linear Average

This function calculates a linear average, in which larger weights are applied to more recent periods. The

weights decrease linearly as you look back over time.


BFL Functions

P U B L I C




Formula

Where: Avg(n)= the average for the nth period

Orig(i)= original data for ith period

Signature

Input Tables

Table 69:


umns


Sales Input Table 1 Double VALUE The original series

to be averaged

(sales)

Output Table

Table 70:


umns


Result Output Table 1 Double AVERAGED_RE

SULT

The linear average

(average sales)

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_LA_SALES_TBL;CREATE COLUMN TABLE BFL_LA_SALES_TBL( "VALUE" DOUBLE );INSERT INTO BFL_LA_SALES_TBL VALUES (1000) ;INSERT INTO BFL_LA_SALES_TBL VALUES (2000) ;INSERT INTO BFL_LA_SALES_TBL VALUES (1500) ;INSERT INTO BFL_LA_SALES_TBL VALUES (2200) ;INSERT INTO BFL_LA_SALES_TBL VALUES (1750) ;

INSERT INTO BFL_LA_SALES_TBL VALUES (2000) ;DROP TABLE BFL_LA_AVERGAESALES_TBL;

84

P U B L I C



BFL Functions



CREATE COLUMN TABLE BFL_LA_AVERGAESALES_TBL( "AVERAGED_RESULT" DOUBLE) ; CALL _SYS_AFL.AFLBFL_LINEARAVERAGE_PROC(BFL_LA_SALES_TBL,BFL_LA_AVERGAESALES_TBL) WITH OVERVIEW ; SELECT * FROM BFL_LA_AVERGAESALES_TBL ;

3.30 Max Value

This function returns the maximum value of a specific field of items.

Signature

Input Tables

Table 71:


umns


Value Input Table 1 Double VALUE Identifies the

items that the

maximum is taken

over

Output Table

Table 72:


umns


Result Output Table 1 Double MAX_MIXVALUE The maximum

value for the se

lected items

Input Flag

Table 73:


Flag Input Value 1 Int Specifies this as Max

function, correspond

ing to Min Function

Example

Assume that:


BFL Functions

P U B L I C







SET SCHEMA BFL_TEST; DROP TABLE BFL_MAX_VALUES1_TBL;CREATE COLUMN TABLE BFL_MAX_VALUES1_TBL("VALUE" DOUBLE);INSERT INTO BFL_MAX_VALUES1_TBL VALUES (10);INSERT INTO BFL_MAX_VALUES1_TBL VALUES (20);INSERT INTO BFL_MAX_VALUES1_TBL VALUES (25);INSERT INTO BFL_MAX_VALUES1_TBL VALUES (5);INSERT INTO BFL_MAX_VALUES1_TBL VALUES (15);DROP TABLE BFL_MAX_RESULTS_TBL;CREATE COLUMN TABLE BFL_MAX_RESULTS_TBL ("MAX_MIXVALUE" DOUBLE); CALL _SYS_AFL.AFLBFL_MAX_MIN_VALUE_PROC(BFL_MAX_VALUES1_TBL, BFL_MAX_RESULTS_TBL,1) WITH OVERVIEW; SELECT * FROM BFL_MAX_RESULTS_TBL;

3.31 Minimum Value

This function returns the minimum value of a specified field of items.

Signature

Input Tables

Table 74:


umns


Value Input Table 1 Double VALUE Identifies the

items that the

minimum is taken

over

Output Table

Table 75:


umns


Result Output Table 1 Double MAX_MIXVALUE The minimum

value for the se

lected items

Input Flag

86

P U B L I C



BFL Functions



Table 76:


Flag Input Value 0 Int Specifies this as Min

function, correspond

ing to Max Function

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_MIN_VALUES1_TBL;CREATE COLUMN TABLE BFL_MIN_VALUES1_TBL("VALUE" DOUBLE);INSERT INTO BFL_MIN_VALUES1_TBL VALUES (10);INSERT INTO BFL_MIN_VALUES1_TBL VALUES (20);INSERT INTO BFL_MIN_VALUES1_TBL VALUES (25);INSERT INTO BFL_MIN_VALUES1_TBL VALUES (5);INSERT INTO BFL_MIN_VALUES1_TBL VALUES (15);DROP TABLE BFL_MIN_RESULTS_TBL;CREATE COLUMN TABLE BFL_MIN_RESULTS_TBL ("MAX_MIXVALUE" DOUBLE); CALL _SYS_AFL.AFLBFL_MAX_MIN_VALUE_PROC(BFL_MIN_VALUES1_TBL, BFL_MIN_RESULTS_TBL,0) WITH OVERVIEW; SELECT * FROM BFL_MIN_RESULTS_TBL;

3.32 Moving Average&Moving Sum


These two built-in functions calculate a moving average or moving sum over a specified number of periods.

Formula

The formula for Moving Average is:

Moving Average = Sum of Originals over n periods/ Number of periods to be averaged

The formula for Moving Sum is:

Moving Sum = Sum of Originals over n periods

The relationship between the Moving Sum S and the Moving Average A is:


BFL Functions

P U B L I C




S=A*length

where length is the length of the moving average.

The choice of which originals to include in the formula depends on the style of average and the method ofdealing with end conditions for missing data.

Methods R for replicate and L for linear extrapolation estimate the values for the missing periods. Methods P

for prime, T for take, U for unequal, and W for weightings estimate the result directly.

Replicate: The first and last original periods are replicated as many times as needed. This is the simplest rule

and is used as the default if you do not specify another method.

Linear extrapolation: The missing n periods at the front of the original series are provided by extending theline joining the centers of the first and second set of n periods of the original series. The missing periods at the

back are provided in the same way by extending the line joining the last two sets of n input periods to the right.

Prime: Get the unavailable averages from another variable. This is typically a constant (e.g. zero), as strictly

speaking the data is not available, but if you know the missing data you can enter it here in the Prime variable.

Take: Takes an average over as many periods as there is data available but does not extrapolate or estimate

any further. For example, using a 3 period last average style (L3) with method T for the end conditions would

give an average of (Jan/1) in Jan, (Jan+Feb)/2 in Feb and (Jan+Feb+Mar)/3 in Mar. Method T is not permitted

with style W.

Unequal: Calculates separate right and left averages using the largest average available and then averages the

two averages. This is a better variant of the "T for Take" method for the centered styles C. For styles F and L

method U is the same as method T. The central period is shared between the two averages. Method U is not

permitted with style W.

Weights: This option gives you the flexibility to provide appropriate weights for the data being averaged/

summed. A set of weights is provided for each missing average or sum for styles L and F. For the centered

styles C and W, a set of weights is provided for half of the series, the same weights being used to fill the front

and the back of the smoothed series.

Signature

Input Tables

88

P U B L I C



BFL Functions



Table 77:


umns


Original Input Table 1 Double ORIGINAL The original series

to be averaged or

summed.

Average Style Input Table 1 Double AVERAGESTYLE Last Periods(0):

Apply to number

of previous peri

ods. Center(1):

The average is re

turned in the cen

ter of the n peri

ods averaged.

Weightings(2):

Weightings specifythe weighting ap

plied to each pe

riod. (i.e. 1,2,1 for 3

periods)


BFL Functions

P U B L I C





umns


Average Method Input Table 1 Double AVERAGEMETHOD

Method describeshow to fill the peri

ods at the start

and end for which

data is missing.

Replicate(0): Rep

licate the first

and/or last input

periods as many

times as needed.

Prime input(1):

Prime input varia

ble is used to pro

vide the missingaverages that can

not be calculated

because the origi

nal data is not

available. This also

applies to Estimat

ing. Truncated or

Take(2): Trun

cated sums re

quired are scaled

up to carry their

full weight. For ex

ample, if you are

calculating a 5 pe

riod sum but only

3 periods are

available, it will be

scaled up by a fac

tor of 5/3. Un

equal length(3):

Unequal length

averages. Un

equal=(Left

+Right)/2 using

the full length on

the side where it is

available, and the

longest available

on the other side.

Weighted Replace

ment(4): Weights

provided in for

mula to calculate

missing inputs.

Prime Input Table 1 Double PRIME The original series

to be averaged or

summed.

90

P U B L I C



BFL Functions




umns


Average Periods Input Table 1 Double AVERAGEPERIODS

Periods to be calculated.

Weightings Input Table 1~N Double WEIGHTING1~

WEIGHTINGN

Weightings specify

the weighting ap

plied to each pe

riod. (i.e. 1,2,1 for 3

periods).

Output Table

Table 78:


umns


Result Output Table 1 Double RESULTS The moving aver

age or sum over n

periods.

Example

Assume that:





SET SCHEMA BFL_TEST; DROP TYPE BFL_MAMS_ORIGINAL_T ;CREATE TYPE BFL_MAMS_ORIGINAL_T AS TABLE( "ORIGINAL" DOUBLE ) ;DROP TYPE BFL_MAMS_AVERAGESTYLE_T ;CREATE TYPE BFL_MAMS_AVERAGESTYLE_T AS TABLE( "AVERAGESTYLE" DOUBLE ) ;DROP TYPE BFL_MAMS_AVERAGEMETHOD_T ;CREATE TYPE BFL_MAMS_AVERAGEMETHOD_T AS TABLE( "AVERAGEMETHOD" DOUBLE ) ;DROP TYPE BFL_MAMS_PRIME_T ;CREATE TYPE BFL_MAMS_PRIME_T AS TABLE( "PRIME"DOUBLE ) ;DROP TYPE BFL_MAMS_AVERAGEPERIODS_T ;CREATE TYPE BFL_MAMS_AVERAGEPERIODS_T AS TABLE( "AVERAGEPERIODS" DOUBLE ) ;DROP TYPE BFL_MAMS_WEIGHTINGS_T ;CREATE TYPE BFL_MAMS_WEIGHTINGS_T AS TABLE( "WEIGHTING1" DOUBLE,"WEIGHTING2"DOUBLE, "WEIGHTING3" DOUBLE) ;DROP TYPE BFL_MAMS_RESULT_T;CREATE TYPE BFL_MAMS_RESULT_T AS TABLE("RESULTS" DOUBLE) ;DROP table BFL_MAMS_PDATA_TBL;CREATE column table BFL_MAMS_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_MAMS_PDATA_TBL values (1,'BFL_TEST’,’BFL_MAMS_ORIGINAL_T', 'IN');insert into BFL_MAMS_PDATA_TBL values (2,'BFL_TEST’,’BFL_MAMS_AVERAGESTYLE_T','IN');insert into BFL_MAMS_PDATA_TBL values (3,'BFL_TEST’,’BFL_MAMS_AVERAGEMETHOD_T','IN');insert into BFL_MAMS_PDATA_TBL values (4,'BFL_TEST’,’BFL_MAMS_PRIME_T', 'IN');

insert into BFL_MAMS_PDATA_TBL values (5,'BFL_TEST’,’BFL_MAMS_AVERAGEPERIODS_T','IN');


BFL Functions

P U B L I C




insert into BFL_MAMS_PDATA_TBL values (6,'BFL_TEST’,’BFL_MAMS_WEIGHTINGS_T','IN');insert into BFL_MAMS_PDATA_TBL values (7,'BFL_TEST’,’BFL_MAMS_RESULT_T', 'OUT');call

SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’,'AFLBFL_MOVINGAVERAGEANDSUM_PROC'); callSYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','MOVINGAVERAGEANDSUM','TEST_BFL','AFLBFL_MOVINGAVERAGEANDSUM_PROC',BFL_MAMS_PDATA_TBL); DROP TABLE BFL_MAMS_ORIGINAL_TBL ;CREATE COLUMN TABLE BFL_MAMS_ORIGINAL_TBL ( "ORIGINAL" DOUBLE );INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (1000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (2000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (3000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (2000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (2000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (8000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (6000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (8000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (7000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (10000) ;

INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (1000) ;INSERT INTO BFL_MAMS_ORIGINAL_TBL VALUES (9000) ;DROP TABLE BFL_MAMS_AVERAGESTYLE_TBL ;CREATE COLUMN TABLE BFL_MAMS_AVERAGESTYLE_TBL ( "AVERAGESTYLE" DOUBLE ) ;INSERT INTO BFL_MAMS_AVERAGESTYLE_TBL VALUES (2) ;DROP TABLE BFL_MAMS_AVERAGEMETHOD_TBL ;CREATE COLUMN TABLE BFL_MAMS_AVERAGEMETHOD_TBL ( "AVERAGEMETHOD" DOUBLE ) ;INSERT INTO BFL_MAMS_AVERAGEMETHOD_TBL VALUES (0) ;DROP TABLE BFL_MAMS_PRIME_TBL ;CREATE COLUMN TABLE BFL_MAMS_PRIME_TBL ( "PRIME" DOUBLE ) ;INSERT INTO BFL_MAMS_PRIME_TBL VALUES (1000) ;DROP TABLE BFL_MAMS_AVERAGEPERIODS_TBL ;CREATE COLUMN TABLE BFL_MAMS_AVERAGEPERIODS_TBL ( "AVERAGEPERIODS" DOUBLE ) ;INSERT INTO BFL_MAMS_AVERAGEPERIODS_TBL VALUES (3) ;DROP TABLE BFL_MAMS_WEIGHTINGS_TBL ;CREATE COLUMN TABLE BFL_MAMS_WEIGHTINGS_TBL ( "WEIGHTING1" DOUBLE,"WEIGHTING2"DOUBLE, "WEIGHTING3" DOUBLE) ;INSERT INTO BFL_MAMS_WEIGHTINGS_TBL VALUES (1, 2, 1) ;DROP TABLE RESULTS_TBL ;CREATE COLUMN TABLE BFL_MAMS_RESULTS_TBL("RESULTS" DOUBLE) ;CALL BFL_TEST.AFLBFL_MOVINGAVERAGEANDSUM_PROC(BFL_MAMS_ORIGINAL_TBL,BFL_MAMS_AVERAGESTYLE_TBL, BFL_MAMS_AVERAGEMETHOD_TBL, BFL_MAMS_PRIME_TBL,BFL_MAMS_AVERAGEPERIODS_TBL, BFL_MAMS_WEIGHTINGS_TBL, BFL_MAMS_RESULTS_TBL) WITHOVERVIEW; SELECT * FROM BFL_MAMS_RESULTS_TBL ;

3.33 Moving Median

This function sorts the entire input values into ascending sequence and takes the median value. If the number

of input values is even, it takes the average of the middle two numbers.

Signature

Input Tables

92

P U B L I C



BFL Functions



Table 79:


umns


Value Input Table 1 Double VALUE The variable

whose median is

required

Length Input Table 1 Double LENGTH Number of periods

over which to take

the median

Offset Input Table 1 Double OFFSET The number of pe

riods offset from

the center

Exclude Input Table 1 Double EXCLUDE 0=Include; 1=Ex

clude

Output Table

Table 80:


umns


Result Output Table 1 Double RESULTS The median

Example

Assume that:




SET SCHEMA BFL_TEST;DROP TABLE BFL_MVMD_VALUE_TBL ;CREATE COLUMN TABLE BFL_MVMD_VALUE_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_MVMD_VALUE_TBL VALUES (1) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (2) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (3) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (4) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (5) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (6) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (7) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (8) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (9) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (10) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (11) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (12) ;INSERT INTO BFL_MVMD_VALUE_TBL VALUES (13) ;DROP TABLE BFL_MVMD_LENGTH_TBL ;CREATE COLUMN TABLE BFL_MVMD_LENGTH_TBL ( "LENGTH" DOUBLE ) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;

INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;


BFL Functions

P U B L I C




INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;

INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;INSERT INTO BFL_MVMD_LENGTH_TBL VALUES (6) ;DROP TABLE BFL_MVMD_OFFSET_TBL ;CREATE COLUMN TABLE BFL_MVMD_OFFSET_TBL ( "OFFSET" DOUBLE ) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;

INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;INSERT INTO BFL_MVMD_OFFSET_TBL VALUES (0.5) ;DROP TABLE BFL_MVMD_EXCLUDE_TBL ;CREATE COLUMN TABLE BFL_MVMD_EXCLUDE_TBL ( "EXCLUDE" DOUBLE ) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (1) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;INSERT INTO BFL_MVMD_EXCLUDE_TBL VALUES (0) ;DROP TABLE BFL_MVMD_RESULTS_TBL ;CREATE COLUMN TABLE BFL_MVMD_RESULTS_TBL("RESULTS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_MOVINGMEDIAN_PROC(BFL_MVMD_VALUE_TBL, BFL_MVMD_LENGTH_TBL,BFL_MVMD_OFFSET_TBL, BFL_MVMD_EXCLUDE_TBL, BFL_MVMD_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_MVMD_RESULTS_TBL ;

3.34 Number of Periods

This function calculates the number of periods over which the account must run.

Formula

Start [1+Number Periods] =End [Number Periods] = -Future Value

When rate is zero:

Number of Periods =-(Present Value + Future Value)/Payment

94

P U B L I C



BFL Functions



When rate is not zero:

Where:

Rate = {%rate}/100

and

Inter = (1+type*rate)*Payment/rate

Signature

Input Tables

Table 81:


umns


Rate Input Table 1 Double VALUE Rate percentage.

Present Input Table 1 Double VALUE The constant pay

ment applied to

the account each

period.

Payment Input Table 1 Double VALUE The constant pay

ment applied to

the account each

period.

Future Input Table 1 Double VALUE The value of the

account at the end

of the calculation.

Method Input Table 1 Double VALUE Specifies whether

the payment is ap

plied at the begin

ning or end of the

period: ■ 0 =

at the end of the

period ■ 1 = at

the beginning of

the period

Output Table


BFL Functions

P U B L I C




Table 82:


umns


Result Output Table 7 Double PERIOD The number of pe

riods for which the

account must run

to satisfy the input

criteria.

Double CALFUTURE

VALUE

The calculated fu

ture value of the

account. The cal

culated end cash

flow to or from the

account.

Double PAYMENT Constant payment

applied to the ac

count in each pe

riod.

Double OPENING Returns the open

ing balance of the

account. Will be

equal to Present

Value.

Double CLOSING Closing balance of

the account.

Double INTEREST Opening Value *

Rate per Period/100. (Opening

Value + Payment)

* Rate per Period/

100.

Double PERIODS Will be Number

Periods in the first

calculation period

and will reduce by

1 in each subse

quent period.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_NP_RATE_TBL ;

CREATE COLUMN TABLE BFL_NP_RATE_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_NP_RATE_TBL VALUES (0.5) ;

96

P U B L I C



BFL Functions



INSERT INTO BFL_NP_RATE_TBL VALUES (0.5) ;DROP TABLE BFL_NP_PRESENT_TBL ;CREATE COLUMN TABLE BFL_NP_PRESENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_NP_PRESENT_TBL VALUES (10000) ;

INSERT INTO BFL_NP_PRESENT_TBL VALUES (-10000) ;DROP TABLE BFL_NP_PAYMENT_TBL ;CREATE COLUMN TABLE BFL_NP_PAYMENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_NP_PAYMENT_TBL VALUES (500) ;INSERT INTO BFL_NP_PAYMENT_TBL VALUES (2500) ;DROP TABLE BFL_NP_FUTURE_TBL ;CREATE COLUMN TABLE BFL_NP_FUTURE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_NP_FUTURE_TBL VALUES (12000) ;INSERT INTO BFL_NP_FUTURE_TBL VALUES (-2600) ;DROP TABLE BFL_NP_METHOD_TBL ;CREATE COLUMN TABLE BFL_NP_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_NP_METHOD_TBL VALUES (1) ;INSERT INTO BFL_NP_METHOD_TBL VALUES (1) ;DROP TABLE BFL_NP_PERIODS_TBL ;CREATE COLUMN TABLE BFL_NP_PERIODS_TBL ( "PERIOD" DOUBLE,"CALFUTUREVALUE"DOUBLE,"PAYMENT" DOUBLE,"OPENING" DOUBLE, "CLOSING" DOUBLE,"INTEREST" DOUBLE,

"PERIODS" DOUBLE); CALL _SYS_AFL.AFLBFL_NUMBERPERIODS_PROC(BFL_NP_RATE_TBL, BFL_NP_PRESENT_TBL,BFL_NP_PAYMENT_TBL, BFL_NP_FUTURE_TBL, BFL_NP_METHOD_TBL, BFL_NP_PERIODS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_NP_PERIODS_TBL ;

3.35 Net Present Value

This function calculates the net present value of a series of future cash flow. The result is the summation of the

present values which are discounted based on the annual rate.

NPV always calculates for future periods and ignore the past data.

No restrictions are applied to:

1. The number of future payment

2. The period between each payment does not need to be equal.

Formula

Where:

Pi is the Payment Value in the ith period.

di is the ith or last payment date.


BFL Functions

P U B L I C




dj is the date at which the Net Present Value is being calculated so that di - dj means the number of days

forward from the day where Net Present Value is being calculated.

Rate is the discount rate per annum to apply to values in future periods.

Signature

Input Tables

Table 83:


umns


Rate Input Table 1 Double VALUE The annual rate at

which future val

ues are to be dis

counted.

Values Input Table 1 Double VALUE The series of cash

values to be calcu

lated.

Date Flag Input Table 1 Double VALUE Start(1); Mid(2);

End(3); User(4)

Payment Date Input Table 1 String VALUE Date of Payment.

Days Input Table 1 Double VALUE Number of days in

each period.

Output Table

Table 84:


umns


Result Output Table 1 Double NETPRESENT

VALUE

The net present

value of the series

of cash flow.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_NPV_RATE_TBL;CREATE COLUMN TABLE BFL_NPV_RATE_TBL( "VALUE" DOUBLE );

INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);

98

P U B L I C



BFL Functions



INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);INSERT INTO BFL_NPV_RATE_TBL VALUES (0.05);

DROP TABLE BFL_NPV_VALUES_TBL;CREATE COLUMN TABLE BFL_NPV_VALUES_TBL( "VALUE" DOUBLE );INSERT INTO BFL_NPV_VALUES_TBL VALUES (-100000);INSERT INTO BFL_NPV_VALUES_TBL VALUES (60000);INSERT INTO BFL_NPV_VALUES_TBL VALUES (0);INSERT INTO BFL_NPV_VALUES_TBL VALUES (40000);INSERT INTO BFL_NPV_VALUES_TBL VALUES (50000);INSERT INTO BFL_NPV_VALUES_TBL VALUES (10000);DROP TABLE BFL_NPV_FLAG_TBL;CREATE COLUMN TABLE BFL_NPV_FLAG_TBL( "VALUE" INT );INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);INSERT INTO BFL_NPV_FLAG_TBL VALUES (3);

DROP TABLE BFL_NPV_USERDATE_TBL;CREATE COLUMN TABLE BFL_NPV_USERDATE_TBL( "VALUE" VARCHAR(255) );INSERT INTO BFL_NPV_USERDATE_TBL VALUES ('12/10/00');DROP TABLE BFL_NPV_DAYS_TBL;CREATE COLUMN TABLE BFL_NPV_DAYS_TBL( "VALUE" INT );INSERT INTO BFL_NPV_DAYS_TBL VALUES (90);INSERT INTO BFL_NPV_DAYS_TBL VALUES (91);INSERT INTO BFL_NPV_DAYS_TBL VALUES (92);INSERT INTO BFL_NPV_DAYS_TBL VALUES (92);INSERT INTO BFL_NPV_DAYS_TBL VALUES (365);INSERT INTO BFL_NPV_DAYS_TBL VALUES (365);DROP TABLE BFL_NPV_RESULT_TBL;CREATE COLUMN TABLE BFL_NPV_RESULT_TBL( "NETPRESENTVALUE" DOUBLE); CALL _SYS_AFL.AFLBFL_NETPRESENTVALUE_PROC(BFL_NPV_RATE_TBL, BFL_NPV_VALUES_TBL,BFL_NPV_FLAG_TBL, BFL_NPV_USERDATE_TBL, BFL_NPV_DAYS_TBL, BFL_NPV_RESULT_TBL) WITH OVERVIEW; SELECT * FROM BFL_NPV_RESULT_TBL;

3.36 Outlook

The Outlook is calculated by using actuals of past months and plan figures of future months. This is a critical

function both for current shortfalls and overachievement. For shortfall, it drives management attention to key

drivers, while for overachievement it reflects the necessary changes to the supply chain to meet increased

demand.

The switchover date is taken as the first future period. The outlook for future periods is derived by revising the

plan. The method is based on keeping the target for each subtotal the same as the plan, taking into account

the actuals to date. In periods on/prior to switchover date, the outlook is calculated as equal to the actuals.

Formula

If the current period is before the period containing the switchover date, then:

Outlook = Actual


BFL Functions

P U B L I C




If the current period comes on or after the switchover date, where possible the Outlook is adjusted to meet the

plan:

Outlook, Full Year = Plan, Full Year

Outlook, period n = Pro-rata allocation of ((Plan, Full Year) - (Sum of actuals to date))

Signature

Input Tables

Table 85:


umns


Plan Input Table 1 Double VALUE The original plan.

Actual Input Table 1 Double VALUE Actual historic

data.

Method Input Table 1 Double VALUE 0: Full Year 1: Peri

ods

Switchover Input Table 1 Double VALUE Historic: Treat all

periods as his

toric. Specific

Date: Select a

date. Field: Use

switchover date intimescale field.

Today: Use to

day's date. Month:

Input month.

Switchoverdate Input Table 1 String SWITCHOVER

DATE

Defines the first

future period. This

parameter is de

pendent on the

switchover type

you specify.

Output Table

Table 86:


umns


Result Output Table 1 Double OUTLOOK The outlook result

combines historic

actual with a fu

ture plan.

100

P U B L I C



BFL Functions



Example

Assume that:● BFL_TEST is a schema belonging to USER1; and



SET SCHEMA BFL_TEST; DROP TABLE BFL_OUTLOOK_PLAN_TBL ;CREATE COLUMN TABLE BFL_OUTLOOK_PLAN_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;INSERT INTO BFL_OUTLOOK_PLAN_TBL VALUES (1000) ;DROP TABLE BFL_OUTLOOK_ACTUAL_TBL ;CREATE COLUMN TABLE BFL_OUTLOOK_ACTUAL_TBL ("VALUE" DOUBLE) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;INSERT INTO BFL_OUTLOOK_ACTUAL_TBL VALUES (500) ;

DROP TABLE BFL_OUTLOOK_METHOD_TBL ;CREATE COLUMN TABLE BFL_OUTLOOK_METHOD_TBL ("VALUE" DOUBLE) ;INSERT INTO BFL_OUTLOOK_METHOD_TBL VALUES (0) ;DROP TABLE BFL_OUTLOOK_SWITCHOVER ;CREATE COLUMN TABLE BFL_OUTLOOK_SWITCHOVER ("VALUE" DOUBLE) ;INSERT INTO BFL_OUTLOOK_SWITCHOVER VALUES (1) ;DROP TABLE BFL_OUTLOOK_SWITCHOVERDATE ;CREATE COLUMN TABLE BFL_OUTLOOK_SWITCHOVERDATE ("SWITCHOVERDATE" VARCHAR(255)) ;INSERT INTO BFL_OUTLOOK_SWITCHOVERDATE VALUES ('20050701') ;DROP TABLE BFL_OUTLOOK_RESULTS_TBL ;CREATE COLUMN TABLE BFL_OUTLOOK_RESULTS_TBL ("OUTLOOK" DOUBLE) ; CALL _SYS_AFL.AFLBFL_OUTLOOK_PROC(BFL_OUTLOOK_PLAN_TBL, BFL_OUTLOOK_ACTUAL_TBL,BFL_OUTLOOK_METHOD_TBL, BFL_OUTLOOK_SWITCHOVER, BFL_OUTLOOK_SWITCHOVERDATE,BFL_OUTLOOK_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_OUTLOOK_RESULTS_TBL ;

3.37 Payment

This function calculates the regular payment to an account for each period.


BFL Functions

P U B L I C




Formula


When rate is zero, then:

Payment=-(Present Value +Future Value)/Number Periods

When rate is not zero:

and

Q=(1+type*rate)*(NR-1)/rate

Signature

Input Tables

Table 87:


umns


Rate Input Table 1 Double VALUE Rate per period as

a percentage.

Periods Input Table 1 Double VALUE The number of pe

riods to be run.

Present Input Table 1 Double VALUE Payment to/from

the account initiat

ing the calculation

(can be zero).

Future Input Table 1 Double VALUE The payment to or

from the account

at the end of the

calculation, which

would be zero if a

loan repays com

pletely.

102

P U B L I C



BFL Functions




umns


Method Input Table 1 Double VALUE■

End of Period (0) ■ Be

ginning of Period

(1)

Output Table

Table 88:


umns


Result Output Table 5 Double PAYMENT Constant payment

applied to the ac

count in each period.

Double OPENING Returns the open

ing balance of the

account. Will be

equal to Present

Value.


the account.


Rate per Period/

100. (Opening

Value + Payment)

* Rate per Period/

100.

Double PERIODS Number Periods in

the first calcula

tion period and will

reduce by 1 in

each subsequent

period.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_PAYMENT_RATE_TBL ;CREATE COLUMN TABLE BFL_PAYMENT_RATE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PAYMENT_RATE_TBL VALUES (0.5) ;

INSERT INTO BFL_PAYMENT_RATE_TBL VALUES (0.5) ;DROP TABLE BFL_PAYMENT_PERIODS_TBL ;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_PAYMENT_PERIODS_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PAYMENT_PERIODS_TBL VALUES (4) ;INSERT INTO BFL_PAYMENT_PERIODS_TBL VALUES (3) ;DROP TABLE BFL_PAYMENT_PRESENT_TBL ;

CREATE COLUMN TABLE BFL_PAYMENT_PRESENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PAYMENT_PRESENT_TBL VALUES (10000) ;INSERT INTO BFL_PAYMENT_PRESENT_TBL VALUES (-10000) ;DROP TABLE BFL_PAYMENT_FUTURE_TBL ;CREATE COLUMN TABLE BFL_PAYMENT_FUTURE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PAYMENT_FUTURE_TBL VALUES (-12000) ;INSERT INTO BFL_PAYMENT_FUTURE_TBL VALUES (-2600) ;DROP TABLE BFL_PAYMENT_METHOD_TBL ;CREATE COLUMN TABLE BFL_PAYMENT_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PAYMENT_METHOD_TBL VALUES (1) ;INSERT INTO BFL_PAYMENT_METHOD_TBL VALUES (1) ;DROP TABLE BFL_PAYMENT_RESULTS_TBL ;CREATE COLUMN TABLE BFL_PAYMENT_RESULTS_TBL ( "PAYMENT" DOUBLE, "OPENING"DOUBLE, "CLOSING" DOUBLE,"INTEREST" DOUBLE, "PERIODS" DOUBLE) ; CALL _SYS_AFL.AFLBFL_PAYMENT_PROC(BFL_PAYMENT_RATE_TBL, BFL_PAYMENT_PERIODS_TBL,

BFL_PAYMENT_PRESENT_TBL, BFL_PAYMENT_FUTURE_TBL, BFL_PAYMENT_METHOD_TBL,BFL_PAYMENT_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_PAYMENT_RESULTS_TBL ;

3.38 Present Value

This function calculates opening value given target closing balance and various parameters by assuming:

● Equal consecutive periods

● Constant interest rate compounded to the account at the end of each period

● A constant payment amount each period

Payments can be calculated at either the start or the end of the period.

Formula

Start [1+Number Periods] =End [Number Periods] =-Future Value

If Rate = 0, then:

Present Value = (Payment * Number Periods) + Future Value

If the rate is non-zero, then:

104

P U B L I C



BFL Functions



Signature

Input Tables

Table 89:


umns


Rate Input Table 1 Double VALUE Rate per period.


riods.

Payment Input Table 1 Double VALUE Constant payment

applied each pe

riod.

Future Input Table 1 Double VALUE The payment to/from at the end of

the calculation.

Method Input Table 1 Double VALUE ■ 0 = at the

end of the period

■ 1 = at the be

ginning of the pe

riod

Output Table

Table 90:



Result Output Table 6 Double ORIGINAL The start value or

opening payment

to or from the ac

count in the first

period.

Double PAYMENT Value of PAY

MENT for every

period

Double OPENING Opening balance

of the account.Will be equal to

Present Value.


the account.


Rate per Period/

100. (Opening

Value + Payment)

* Rate per Period/

100.


BFL Functions

P U B L I C





umns


Double PERIODS Will be NumberPeriods in the first

calculation period

and will reduce by

1 in each subse

quent period.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_PV_RATE_TBL ;CREATE COLUMN TABLE BFL_PV_RATE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PV_RATE_TBL VALUES (0.5) ;INSERT INTO BFL_PV_RATE_TBL VALUES (0.5) ;DROP TABLE BFL_PV_PERIODS_TBL ;CREATE COLUMN TABLE BFL_PV_PERIODS_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PV_PERIODS_TBL VALUES (4) ;INSERT INTO BFL_PV_PERIODS_TBL VALUES (3) ;DROP TABLE BFL_PV_PAYMENT_TBL ;CREATE COLUMN TABLE BFL_PV_PAYMENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PV_PAYMENT_TBL VALUES (500) ;INSERT INTO BFL_PV_PAYMENT_TBL VALUES (2500) ;DROP TABLE BFL_PV_FUTURE_TBL ;CREATE COLUMN TABLE BFL_PV_FUTURE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PV_FUTURE_TBL VALUES (12000) ;INSERT INTO BFL_PV_FUTURE_TBL VALUES (-2600) ;DROP TABLE BFL_PV_METHOD_TBL ;CREATE COLUMN TABLE BFL_PV_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_PV_METHOD_TBL VALUES (1) ;INSERT INTO BFL_PV_METHOD_TBL VALUES (1) ;DROP TABLE BFL_PV_PRESENT_TBL ;CREATE COLUMN TABLE BFL_PV_PRESENT_TBL ( "ORIGINAL" DOUBLE,"PAYMENT"DOUBLE,"OPENING" DOUBLE, "CLOSING" DOUBLE,"INTEREST" DOUBLE, "PERIODS" DOUBLE) ;

CALL _SYS_AFL.AFLBFL_PRESENTVALUE_PROC(BFL_PV_RATE_TBL, BFL_PV_PERIODS_TBL,BFL_PV_PAYMENT_TBL, BFL_PV_FUTURE_TBL, BFL_PV_METHOD_TBL, BFL_PV_PRESENT_TBL) WITH OVERVIEW;

SELECT * FROM BFL_PV_PRESENT_TBL ;

3.39 Proportion

This function allows you to input a start and end date, and then calculates the proportion of the period length.

106

P U B L I C



BFL Functions



Formula

Proportion all days = (Stop date - Start date) / (Period finish date - Period start date)

Proportion working days is the same, but excludes weekends.

Signature

Input Tables

Table 91:


umns


Year Input Table 1 String VALUE The year to be cal

culated

Start Input Table 1 String VALUE Start Date

Stop Input Table 1 String VALUE End Date to be cal

culated

Output Table

Table 92:


umns


Result Output Table 1 Double PROPORTION The proportion of

the period length

Example

Assume that:


●

USER1 has been assigned the AFL__SYS_AFL_AFLBFL_EXECUTE orAFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION role.

SET SCHEMA BFL_TEST; DROP TABLE BFL_PRPTN_YEAR_TBL ;CREATE COLUMN TABLE BFL_PRPTN_YEAR_TBL ( "VALUE" varchar(8) ) ;INSERT INTO BFL_PRPTN_YEAR_TBL VALUES ('2000');DROP TABLE BFL_PRPTN_START_TBL ;CREATE COLUMN TABLE BFL_PRPTN_START_TBL( "VALUE" varchar(8) );INSERT INTO BFL_PRPTN_START_TBL VALUES ('20000401');DROP TABLE BFL_PRPTN_STOP_TBL ;CREATE COLUMN TABLE BFL_PRPTN_STOP_TBL( "VALUE" varchar(8) );INSERT INTO BFL_PRPTN_STOP_TBL VALUES ('20000625');DROP TABLE BFL_PRPTN_RESULTS_TBL;CREATE COLUMN TABLE BFL_PRPTN_RESULTS_TBL ( "PROPORTION" DOUBLE) ; CALL _SYS_AFL.AFLBFL_PROPORTION_PROC(BFL_PRPTN_YEAR_TBL, BFL_PRPTN_START_TBL,BFL_PRPTN_STOP_TBL, BFL_PRPTN_RESULTS_TBL) WITH OVERVIEW;


BFL Functions

P U B L I C




SELECT * FROM BFL_PRPTN_RESULTS_TBL ;

3.40 Rate

This function helps to calculate the percentage interest rate of each period for an account. The four required

inputs are start balance, end balance, payment per period and the number of periods. Because it is an iterative

solution, more than one solution or no solution can be found for given inputs.

If Present Value, Future Value, and Payment are all input with the same sign then there will be no solution. If

there is more than one solution, setting a non-zero value for parameter Estimate may cause an alternative rate

value to be returned.

Assumptions:

● Equal consecutive periods

● Constant, compounded interest rate applied at the end of each period

● Payment is constant

Payment can be at the start or the end of the period.

Formula


Rate is the solution to the family equation for the Payment, Present Value, Future Value, Number Periods, and

Rate:

Rate is an iterative method requiring a start value. Therefore parameter Estimate is used as the starting value

and is set to a default of 0.

Signature

Input Tables

108

P U B L I C



BFL Functions



Table 93:


umns


Present Input Table 1 Double VALUE Value of the pay

ment to/from the

account at the be

ginning.


riods the account

runs.

Payment Input Table 1 Double VALUE Constant payment

applied each pe

riod.

Future Input Table 1 Double VALUE The payment to/

from at the end ofthe calculation.

Method Input Table 1 Double VALUE ■ 0 = at the

end of the period

■ 1 = at the be

ginning of the pe

riod

Output Table

Table 94:


umns


Result Output Table 6 Double RATE The percentage

rate per period for

the account.

Double PAYMENT Value of PAY

MENT for every

period,

Double OPENING Opening balance

of the account.

Will be equal to

Present Value,

Double CLOSING Closing balance ofthe account.


Rate per Period/

100. (Opening

Value + Payment)

* Rate per Period/

100.


BFL Functions

P U B L I C





umns


Double PERIODS Will be NumberPeriods in the first

calculation period

and will reduce by

1 in each subse

quent period.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_RATE_PRESENT_TBL ;CREATE COLUMN TABLE BFL_RATE_PRESENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_RATE_PRESENT_TBL VALUES (10000) ;INSERT INTO BFL_RATE_PRESENT_TBL VALUES (-10000) ;DROP TABLE BFL_RATE_PERIODS_TBL ;CREATE COLUMN TABLE BFL_RATE_PERIODS_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_RATE_PERIODS_TBL VALUES (4) ;INSERT INTO BFL_RATE_PERIODS_TBL VALUES (3) ;

DROP TABLE BFL_RATE_PAYMENT_TBL ;CREATE COLUMN TABLE BFL_RATE_PAYMENT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_RATE_PAYMENT_TBL VALUES (450) ;INSERT INTO BFL_RATE_PAYMENT_TBL VALUES (2500) ;DROP TABLE BFL_RATE_FUTURE_TBL ;CREATE COLUMN TABLE BFL_RATE_FUTURE_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_RATE_FUTURE_TBL VALUES (12000) ;INSERT INTO BFL_RATE_FUTURE_TBL VALUES (-2600) ;DROP TABLE BFL_RATE_METHOD_TBL ;CREATE COLUMN TABLE BFL_RATE_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_RATE_METHOD_TBL VALUES (1) ;INSERT INTO BFL_RATE_METHOD_TBL VALUES (1) ;DROP TABLE BFL_RATE_RATE_TBL ;CREATE COLUMN TABLE BFL_RATE_RATE_TBL ( "RATE" DOUBLE, "PAYMENT"DOUBLE,"OPENING" DOUBLE, "CLOSING" DOUBLE,"INTEREST" DOUBLE, "PERIODS" DOUBLE);

CALL _SYS_AFL.AFLBFL_RATE_PROC(BFL_RATE_PRESENT_TBL, BFL_RATE_PERIODS_TBL,BFL_RATE_PAYMENT_TBL, BFL_RATE_FUTURE_TBL, BFL_RATE_METHOD_TBL,BFL_RATE_RATE_TBL) WITH OVERVIEW;

SELECT * FROM BFL_RATE_RATE_TBL ;

3.41 Repeat

This function repeats data of a single period or group of periods according to the time scale of the Dimension

List.

110

P U B L I C



BFL Functions



It has two inputs:

● Number: The number of periods to be repeated and is set by entering as a prime into the first time period

of the timescale.

● Original Value: The series of values to be repeated.

Repeat can be used to copy seasonal factors through the timescale.

Signature

Input Tables

Table 95:



Number Input Table 1 Double VALUE The number of pe

riods to be re

peated and is set

by entering as a

prime into the first

time period of the

timescale.

Input Input Table 1 Double VALUE The series of val

ues to be re

peated.

Output Table

Table 96:


umns


Result Output Table 1 Double RESULT Repeat output re

sult

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_REPEAT_NUMBER_TBL;CREATE COLUMN TABLE BFL_REPEAT_NUMBER_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_REPEAT_NUMBER_TBL VALUES (7) ;DROP TABLE BFL_REPEAT_INPUT_TBL;

CREATE COLUMN TABLE BFL_REPEAT_INPUT_TBL ( "VALUE" DOUBLE );INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (1) ;


BFL Functions

P U B L I C




INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (1) ;INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (1) ;INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (1) ;INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (1) ;

INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (0) ;INSERT INTO BFL_REPEAT_INPUT_TBL VALUES (0) ;DROP TABLE BFL_REPEAT_RESULTS_TBL;CREATE COLUMN TABLE BFL_REPEAT_RESULTS_TBL ( "RESULT" DOUBLE) ; CALL _SYS_AFL.AFLBFL_REPEAT_PROC(BFL_REPEAT_NUMBER_TBL, BFL_REPEAT_INPUT_TBL,BFL_REPEAT_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_REPEAT_RESULTS_TBL ;

3.42 Rounding

This function calculates the rounded values for a specified input item according to a chosen rounding method.

These rounding methods allow you to round figures up, down, away from zero (up for positive numbers, down

for negative numbers), or toward zero (down for positive numbers, up for negative numbers).

You can combine the rounding methods with either of the below cumulative option:

1. Sum a series of rounded values

2. Sum a series of non-rounded values and then rounding the total

Always, ensure the above two results are the same.

Signature

Input Tables

Table 97:


umns


Date Input Table 1 Double DATE The item with the

values you want to

round.

Precision Input Table 1 Double PRECISION The decimal inter

val. 1 = To nearest

integer 0.1 = To 1

decimal place 0.01

= To 2 decimal

places 1000 = To

nearest 1000 0.25

= To nearest quar

ter 12 = To nearest

dozen

112

P U B L I C



BFL Functions




umns


Method Input Table 1 Double METHOD Nearest(0): Nearest rounds to the

nearest whole in

teger. This is the

default method.

Up(1): Up rounds

up to the nearest

whole integer.

Down(2): Down

rounds down to

the nearest whole

integer. Away(3):

Away from zero

rounds a positivevalue up to the

nearest whole in

teger and a nega

tive value down to

the nearest whole

integer. To

ward(4): Toward

zero rounds a pos

itive value down to

the nearest whole

integer and a neg

ative value up to

the nearest whole

integer.

Output Table

Table 98:


umns


Result Output Table 1 Double ROUNDING The outlook result

combines historic

actual with a fu

ture plan.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_ROUND_DATE_TBL ;CREATE COLUMN TABLE BFL_ROUND_DATE_TBL ( "DATE" DOUBLE ) ;


BFL Functions

P U B L I C




INSERT INTO BFL_ROUND_DATE_TBL VALUES (200.1345);DROP TABLE BFL_ROUND_PRECISION_TBL ;CREATE COLUMN TABLE BFL_ROUND_PRECISION_TBL( "PRECISION" DOUBLE );INSERT INTO BFL_ROUND_PRECISION_TBL VALUES (0.1);

DROP TABLE BFL_ROUND_METHOD_TBL ;CREATE COLUMN TABLE BFL_ROUND_METHOD_TBL( "METHOD" DOUBLE );INSERT INTO BFL_ROUND_METHOD_TBL VALUES (5);DROP TABLE BFL_ROUND_RESULTS_TBL;CREATE COLUMN TABLE BFL_ROUND_RESULTS_TBL ( "ROUNDING" DOUBLE) ; CALL _SYS_AFL.AFLBFL_ROUNDING_PROC(BFL_ROUND_DATE_TBL, BFL_ROUND_PRECISION_TBL,BFL_ROUND_METHOD_TBL, BFL_ROUND_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_ROUND_RESULTS_TBL ;

3.43 Seasonal Simple&Seasonal Complex

These two built-in functions both perform seasonal adjustments of time to determine seasonal patterns in

data. They use the same programs to calculate their results. They are different only in the number of methods

and input and output variables available.

Seasonal Complex has more functionality and flexibility than Seasonal Simple and is intended for the highly

advanced user of statistical data. Seasonal Simple is much easier to use because it uses fewer methods,

inputs and outputs.

Method

The full Seasonal Complex model is following:

O=T*C*S*W*I

Where: O is the original data, T is the trend, C is the cyclical effect, S is the seasonal effect, I is the internal rate

of return and W is working days.

Method 1- Basic method

1 = Multiplicative; 2 = Additive.

The multiplicative model is O = T * C * S * I. All Seasonal Simple methods are Multiplicative.

The arithmetic for additive model is O = T + C + S + I.

In the multiplicative model the seasonal effects add up to the number of periods in a year, whereas in an

additive model they add up to zero.

For example, you must use Seasonal Complex if you want to expect the minimum temperature in a month to

be better represented by an additive model, particularly if you want to compare the seasonal patterns of Year

over Year Difference places.

Method 2- Average method

1 = Medial average; 2 = MA average; 3 = Average year; 4 = Typical year.

114

P U B L I C



BFL Functions



For each actual period, Seasonal Factor (SF) is calculated as 100 * {original} / {Trend estimate}, where {Trend

estimate} is usually a moving average, that is, with 6 years of history you only have 5 years of SF values. To get

one estimate for the factor of each period over all its years, the preferred approach is to throw away the

highest and lowest values, then average the rest, and the result is the medial average. With 2 to 5 years of data(that is, 2 to 4 SF values), Seasonal Simple averages all the available factors and this is the MA average.

With fewer than 2 years actual data we have to use the Typical year method. For each period, the {period

average} is the average of its original values over all available history years. The typical year is then a year of all

the {period average} values, and the seasonal factor for each period is

{Seasonal Factor} = 100 * {Period average} / {year total of period averages}

Complex Method 3 - MA method

1 = Centered MA; 2 = Uncentered MA; 3 = Straight line trend fitted to original data; 4 = Straight line trend fitted

to whole year totals.

When using Averages Methods 1 or 2, the {Trend Estimate} is used and it is provided by a moving average(MA), whose length is equal to the number of periods in a year. Because the number of periods per year

(typically months or quarters) for most timescales is even, it is necessary to center the MA to avoid bias when

the trend is not constant. The centered MA for May is the average of the two averages for (November to

October) and for (December to November). When you calculate the MA using this method, you lose a whole

year of actuals (six months at the beginning and six months at the end).

With 2 to 4 years of actuals, method 4, the trend through whole years, is used by Seasonal Simple to provide

the {trend estimate} to calculate factors. This means assembling as many whole year averages, as far apart

from each other as possible, and fitting a straight line through them to get the {Trend Estimate}.

Method 4 - Working Days

1 = No working day adjustment; 2 = User input working days; 3 = Use calendar days as working days.

Seasonal Simple always uses method 1, the no working day adjustment method.

Seasonal Complex will remove the adjustment from actual periods, and then apply it to forecast periods. Doing

this can improve the accuracy of your forecasts if you believe that the level of your data depends on the

number of days in your month,.

Method 5 - Cycles

1 = No cycles in forecast or calculations; 2 = Apply cycles to forecast; 3 = Adjust for cycles in calculations and

apply them to the forecast.

Seasonal Simple always uses method 1, no cycles in forecast or calculations.

Using the Seasonal Complex method enables you to exert considerable control over the results from

calculating the factors and forecasts.

Method 6 - Trend

1 = Fit straight line trend through the adjusted data; 2 = Fit straight line trend through the original data; 3 =

Constant trend = Average of adjusted actual data; 4 = Parabolic trend, through the adjusted data

Seasonal Simple usually uses method 1, but will use method 3 when there is not much history. You can insist

on any of methods 1, 3 or 4. Method 2 is the classic method, you can use Seasonal Complex if you want to.


BFL Functions

P U B L I C




3.43.1 Seasonal Complex

Formula

Seasonal Complex = Seasonal Complex (Method; ActFlag; Original; WorkingDays; Cycle%; OverFlag; OverValue;

Factor; Adjusted; MovingAverage; Ratio; Trend; Cycle; Internal Rate of Returnegular; Calculated; Diagnostics)

Signature

Input Tables

Table 99:


umns


Original Input Table 1 Double ORIGINAL The data to be

seasonally ad

justed

Working Days Input Table 1 Double WORKINGDAYS The working daysin the period

Cycle Input Table 1 Double CYCLE The cycle percent

Override Input Table 1 Double OVERRIDE Override flag

Override Value Input Table 1 Double OVERRIDEVALUE Override value

Config Input Table 1 Double CONFIG Has three rows,

the meaning is as

follows: Row 0:

Specify method

like in Seasonal

Simple Row1:

Specify the periodnumber, refer to

Seasonal Simple

Row 2: Specify the

forecast periods

Output Table

Table 100:


umns


Result Output Table 4 Double TREND The long term

trend of the data

116

P U B L I C



BFL Functions




umns


Double DIAGNOTICS A few simple diagnostics to evaluate

the model

Double CALCULATED The forecast of the

expected original

value for every pe

riod

Double FORECAST OverValue if Over

Flag = 1, Original if

ActFlag = 1, other

wise Calculated

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SC_ORIGINAL_TBL ;

CREATE COLUMN TABLE BFL_SC_ORIGINAL_TBL ( "ORIGINAL" DOUBLE ) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (150) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (108) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (112) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (119) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (134) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (139) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (143) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (240) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (220) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (155) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (162) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (166) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (172) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (170) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (171) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (169) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (188) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (195) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (198) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (320) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (300) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (220) ;INSERT INTO BFL_SC_ORIGINAL_TBL VALUES (222) ;DROP TABLE BFL_SC_WORKINGDAYS_TBL ;CREATE COLUMN TABLE BFL_SC_WORKINGDAYS_TBL ( "WORKINGDAYS" DOUBLE ) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;

INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;


BFL Functions

P U B L I C




INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;

INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (28) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (29) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (29) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;

INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (29) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (30) ;INSERT INTO BFL_SC_WORKINGDAYS_TBL VALUES (31) ;DROP TABLE BFL_SC_CYCLE_TBL ;CREATE COLUMN TABLE BFL_SC_CYCLE_TBL ( "CYCLE" DOUBLE ) ;INSERT INTO BFL_SC_CYCLE_TBL VALUES (1) ;INSERT INTO BFL_SC_CYCLE_TBL VALUES (100) ;INSERT INTO BFL_SC_CYCLE_TBL VALUES (1) ;INSERT INTO BFL_SC_CYCLE_TBL VALUES (10) ;INSERT INTO BFL_SC_CYCLE_TBL VALUES (2002) ;DROP TABLE BFL_SC_OVERRIDE_TBL ;CREATE COLUMN TABLE BFL_SC_OVERRIDE_TBL("OVERRIDE" DOUBLE);INSERT INTO BFL_SC_OVERRIDE_TBL VALUES (1.0) ;DROP TABLE BFL_SC_OVERRIDEVALUE_TBL ;CREATE COLUMN TABLE BFL_SC_OVERRIDEVALUE_TBL("OVERRIDEVALUE" DOUBLE);INSERT INTO BFL_SC_OVERRIDEVALUE_TBL VALUES (10.0);DROP TABLE BFL_SC_CONFIG_TBL ;CREATE COLUMN TABLE BFL_SC_CONFIG_TBL("CONFIG" DOUBLE);INSERT INTO BFL_SC_CONFIG_TBL VALUES (111111);INSERT INTO BFL_SC_CONFIG_TBL VALUES (12);INSERT INTO BFL_SC_CONFIG_TBL VALUES (1);DROP TABLE BFL_SC_RESULTS_TBL ;CREATE COLUMN TABLE BFL_SC_RESULTS_TBL ("TREND" DOUBLE, "DIAGNOTICS"DOUBLE,"CALCULATED" DOUBLE, "FORECAST" DOUBLE) ; CALL _SYS_AFL.AFLBFL_SEASONALCOMPLEX_PROC(BFL_SC_ORIGINAL_TBL,BFL_SC_WORKINGDAYS_TBL, BFL_SC_CYCLE_TBL, BFL_SC_OVERRIDE_TBL,BFL_SC_OVERRIDEVALUE_TBL, BFL_SC_CONFIG_TBL, BFL_SC_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_SC_RESULTS_TBL;

3.43.2 Seasonal Simple

Seasonal Simple is suitable for calculating data with sufficient history, at least one whole year, although five or

more years are preferred and all trends are straight lines, and the data is of a multiplicative type. If you have a

longer history and the seasonal factors have changed during the course of the history, other methods should

be used.

118

P U B L I C



BFL Functions



Formula

In Seasonal Simple the Cyclical and Working Day effects are not calculated, so the model is:

O = T * S * I

Seasonal Simple shows the seasonal factors as percentages (S = SF / 100) and replicates them throughout

the time scale. The forecast is set equal to the historical value in the actual periods and calculated as T * SF /

100 for forecast periods.

Seasonal Simple has seven methods which use selected combinations of the six independent Seasonal

Complex methods.

Table 101:

## Description Seasonal Complex Method Note

1 Based on the number of actuals: less than two complete

years 2 or more, but less

than 4 years 4 or more, but

less than 6 years 6 or more

years

141113 124111 121111 111111 1

2 Multiplicative, typical year,

constant trend

141113 1, 2

3 Multiplicative, whole year ini

tial trend, final trend through

adjusted

124111 1, 3

4 Multiplicative, average, centered MA, trend through ad

justed

121111 1, 4

5 Multiplicative, medial, cen

tered MA, trend through ad

justed

111111 1, 5

6 As method 1, but force con

stant trend

1xx113 1, 6

7 As method 1, but force linear

trend

1xx111 1, 7

Note:

1. To choose the best Seasonal Simple method you must understand something of the Seasonal Complex

methods, which are described above.

2. You can use this instead of method 1, even though you have more than 2 years of history.

3. You can use this instead of method 1, even though you have more than 4 years of history.

4. You can use this instead of method 1, even if you have 6 or more years of actuals.

5. You can use this instead of method 1, even if you have less than 6 years of actuals.

6. Use this method if you believe your data is most likely to stay constant, even though you have enough

actuals to get a good estimate of the slope.

7. Use this method to use a linear trend, even though you have less than two years history.


BFL Functions

P U B L I C




Signature

Input Tables

Table 102:


umns


Method Input Table 1 Double METHOD Method in which

the function

works.

ActFlag Input Table 1 Double FLAG Actual periods

that are used to

calculate the sea

sonal factors.

Note: this parameter is not sup

ported in SAP

HANA 1.0 SP3.

Original Input Table 1 Double ORIGINAL Data to be season

ally adjusted.

Period Number Input Table 1 Double PERIODNUMBER Length of step for

moving average.

Forecast Period Input Table 1 Double PERIODFORE

CAST

Number of periods

to be forecasted.

Output Table

Table 103:


umns


Result Output Table 1 Double FORECAST Forecast result ta

ble

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SS_METHOD_TBL ;CREATE COLUMN TABLE BFL_SS_METHOD_TBL ( "METHOD" DOUBLE ) ;INSERT INTO BFL_SS_METHOD_TBL VALUES (141111) ;DROP TABLE BFL_SS_ACTFLAG_TBL ;CREATE COLUMN TABLE BFL_SS_ACTFLAG_TBL ( "FLAG" DOUBLE ) ;INSERT INTO BFL_SS_ACTFLAG_TBL VALUES (0) ;

DROP TABLE BFL_SS_ORIGINAL_TBL ;CREATE COLUMN TABLE BFL_SS_ORIGINAL_TBL ( "ORIGINAL" DOUBLE ) ;

120

P U B L I C



BFL Functions



INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (150) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (108) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (112) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (115) ;

INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (119) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (115) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (134) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (139) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (143) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (240) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (220) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (155) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (162) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (166) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (172) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (170) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (171) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (169) ;

INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (188) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (195) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (198) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (320) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (300) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (220) ;INSERT INTO BFL_SS_ORIGINAL_TBL VALUES (222) ;DROP TABLE BFL_SS_PERIODNUMBER_TBL ;CREATE COLUMN TABLE BFL_SS_PERIODNUMBER_TBL("PERIODNUMBER" DOUBLE);INSERT INTO BFL_SS_PERIODNUMBER_TBL VALUES (12) ;DROP TABLE BFL_SS_FORECATPERIOD_TBL ;CREATE COLUMN TABLE BFL_SS_FORECATPERIOD_TBL("PERIODFORECAST" DOUBLE);INSERT INTO BFL_SS_FORECATPERIOD_TBL VALUES (1);DROP TABLE BFL_SS_FORECAST_TBL ;CREATE COLUMN TABLE BFL_SS_FORECAST_TBL ("FORECAST" DOUBLE) ; CALL _SYS_AFL.AFLBFL_SEASONALSIMPLE_PROC(BFL_SS_METHOD_TBL, BFL_SS_ACTFLAG_TBL,BFL_SS_ORIGINAL_TBL, BFL_SS_PERIODNUMBER_TBL, BFL_SS_FORECATPERIOD_TBL,BFL_SS_FORECAST_TBL) WITH OVERVIEW; SELECT * FROM BFL_SS_FORECAST_TBL;

3.44 Seasonal Simulation

This built-in function is used to test and explore how Seasonal Complex and other Business Functions handle

the input data. It provides the building blocks to Seasonal Simulation seasonal data using a variety of

characteristics.

Signature

Input Tables


BFL Functions

P U B L I C




Table 104:


umns


Method Input Table 1 Double METHOD Period(0) Re

peat(1) Sea

sonal(2) BoxMul

ler(3) Random(4)

Normal(5) Uni

form(6) Re

peated(7)

Periods Input Table 1 Double PERIODS Specify the period

number

Param Input Table 1 Double PARAM Varies with the

method data en

tered across the

periods of the

timescale as de

scribed below

Output Table

Table 105:


umns


Result Output Table 1 Double RESULT Seasonal simula

tion for time series

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SNSMLTN_METHOD_TBL;CREATE COLUMN TABLE BFL_SNSMLTN_METHOD_TBL ( "METHOD" DOUBLE ) ;INSERT INTO BFL_SNSMLTN_METHOD_TBL VALUES (6) ;DROP TABLE BFL_SNSMLTN_PERIODS_TBL;CREATE COLUMN TABLE BFL_SNSMLTN_PERIODS_TBL ( "PERIODS" DOUBLE ) ;INSERT INTO BFL_SNSMLTN_PERIODS_TBL VALUES (5) ;INSERT INTO BFL_SNSMLTN_PERIODS_TBL VALUES (5) ;DROP TABLE BFL_SNSMLTN_PARAM_TBL;CREATE COLUMN TABLE BFL_SNSMLTN_PARAM_TBL ( "PARAM" DOUBLE ) ;INSERT INTO BFL_SNSMLTN_PARAM_TBL VALUES (5.0) ;INSERT INTO BFL_SNSMLTN_PARAM_TBL VALUES (6.0) ;INSERT INTO BFL_SNSMLTN_PARAM_TBL VALUES (12.0) ;DROP TABLE BFL_SNSMLTN_RESULT_TBL;CREATE COLUMN TABLE BFL_SNSMLTN_RESULT_TBL ( "RESULT" DOUBLE) ; CALL _SYS_AFL.AFLBFL_SEASONALSIMULATION_PROC(BFL_SNSMLTN_METHOD_TBL,

BFL_SNSMLTN_PERIODS_TBL, BFL_SNSMLTN_PARAM_TBL, BFL_SNSMLTN_RESULT_TBL) WITHOVERVIEW;

122

P U B L I C



BFL Functions



SELECT * FROM BFL_SNSMLTN_RESULT_TBL;

3.45 Stock Flow

The Stock Flow figures out the level of supply needed in order to meet the prediction for stock cover.

Supply Outlook = Stock Flow(Prime;{Opening Stock};{Forecast Sales};{Forecast Cover};{Closing Stock};{Actual

Sales};{Actual Cover};{Actual Supply};{Actual Closing};19980301;1;{Period Length};{Max Supply};{Min Supply};

{% Wastage}; Wastage;0;1;1;{Sales Outlook})

The supply is calculated to meet the Closing Stock target.

Outlook method

Outlook Method determines how Sales Outlook is calculated.

Both Outlook methods try to set Sales Outlook to equal Actual Sales for historical periods and Forecast Sales

for future periods. The default Outlook Method is Year over Year Difference. It allows for the Closing Stock to

go negative in certain cases, identifying stock shortfalls. By setting the Outlook Method parameter to Restrict,

parameters also can prevent Closing Stock from dropping below zero.

End Method

By default the demand in the last period is replicated, the last period sales are replicated to provide for future

periods. Lengths of Period are replicated in a similar manner.

End Method can alternatively calculate an average demand over the last n periods and replicate this average

over the future periods.

Min and Max Supply

The maximum supply can be restricted due to warehouse capacity, existing contracts, production

constraints...etc. Minimum supply can be restricted where stock can only be depleted at the rate of sales. For

example, in June there is an actual stock cover of over 80 days but only a planned cover of 30 days for July.

Even with zero incoming supply, sales in June will not reduce stock levels to the planned levels. This then

requires disposal (or donation) of stock to bring the stock levels down quickly. The closing stock levels and

actual stock cover are adjusted accordingly.

Wastage

Wastage for each period to cover a variety of non-sales related stock reduction, such as shrinkage, spoilage,

etc.

Cover Units and Period Length

Based on the Sales Outlook, using calendar days, Cover Units Forecast Cover is measured in stock-turn days.

Rounding Method

By default, there is no rounding of discrete units. You can use the rounding method to round each element or

to round each time total (preserve sum and preserve sum YoY ). Using the preserve sum methods, the

elements are rounded in such a way that they continue to add up to the time total.


BFL Functions

P U B L I C




Signature

Input Tables

Table 106:


umns


Prime Input Table 1 Double PRIME Prime - opening

stock of the first

period.

Time Input Table 1 String TIME The calculated

time.

Forecast Sales Input Table 1 Double FORECASTSALES Forecast sales will

be used in the pe

riod containing the

switchover date

and there after.

Prior to the

switchover date

there is no fore

cast, only actuals.

Forecast Cover Input Table 1 Double FORECASTCOVER The forecast stock

cover. How many

days/periods of

future sales the

closing stock

should support.100 means to set

Closing Stock at

such a level that it

lasts 100 days

based on Sales

Outlook.

Actual Sales Input Table 1 Double ACTUALSALES Actual sales input

for historic peri

ods only.

Actual Supply Input Table 1 Double ACTUALSUPPLY Actual supply in

put for historic pe

riods only.

Actual Closing Input Table 1 Double ACTUALCLOSING Actual closing

stock input for his

toric periods only.

Switchover Input Table 1 Int SWITCHOVER The period con

taining the switch

over date is de

fined as the first

future period.

124

P U B L I C



BFL Functions




umns


Switchover Date Input Table 1 String SWITCHOVERDATE

Specify theswitchover date

base on Switch

over

Cover Units Input Table 1 Int COVERUNITS Identifies the

measure for Stock

Cover in terms of

future sales. Days:

Use calendar

days. Default.

Units: Use custom

units from the

item Period

Length Periods:

Use number of pe

riods. Each detail

item in the time

scale field is a pe

riod.

Period Length Input Table 1 Int PERIODLENGTH Available if you

want to use non-

standard calendar

period lengths. For

example: 4 - 4 - 5

for weeks in each

period. PeriodLength will be ig

nored unless you

set Cover

Units=Period.

Max Supply Input Table 1 Double MAXSUPPLY Physical limita

tions (constraints)

to the maximum

supply available to

increase stock lev

els (warehouse

space, etc). If left

blank, the default

is for Max Supplyto be allowed to go

to infinity.

Min Supply Input Table 1 Double MINSUPPLY Limitation to the

flow out of stock.


BFL Functions

P U B L I C





umns


Wastage Rate Input Table 1 Double WASTAGERATE Changes in stockdue to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.

Rounding Method Input Table 1 Int ROUNDMETHOD DNR: Do not

round. This is the

default if left blank

(no partial units…

discrete). Round:

Round each ele

ment (process).

Preserve Sum:

Preserve the sum

by changing the

most obvious ele

ment(s)….where

rounded value is

furthest from orig

inal value. Pre

serve Sum YoY:

Preserve the sum

by rounding cu

mulated data andthen taking the

Year over Year Dif

ference (the de

fault).

End Method Input Table 1 Int ENDMETHOD Integer Constant:

The number of pe

riods over which

to average sales

when projecting

beyond the last

period in the time

scale. This is used

in the closing

stock calculation

toward the end of

the timescale. N

periods: Use the

average of the last

3 periods to

project sales for

ward.

126

P U B L I C



BFL Functions




umns


Outlook Method Input Table 1 Int OUTLOOKMETHOD

How ForecastSales input is used

to provide future

Sales Outlook. De

fault: Use Forecast

Sales from the pe

riod containing the

switchover date

onwards, Actual

Sales prior to this

(the default

method). Restrict:

Restrict future

sales if closingstock goes nega

tive.

Output Table

Table 107:


umns


Result Output Table 6 Double OPENING Opening Stock.

Fed from the Clos

ing Stock of the

previous period.

Double CLOSING Closing Stock. Ac

tual Closing Stock

prior to the

switchover date;

the level required

to meet the Fore

cast Stock Cover

thereafter.

Double ACTUALCOVER Actual Stock

Cover. How many

days/periods of

future sales the

Closing Stock ac

tually does sup

port.


BFL Functions

P U B L I C





umns


Double WASTAGE Changes in stockdue to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.

Double SALESOUTLOOK Sales Outlook is

equal to the Actual

Sales history prior

to the switchover

date, Forecast

Sales thereafter.

See Outlook

Method.

Double SUPPLYOUTLOOK The supply in fu

ture periods re

quired to meet

forecast stock

cover based on

forecast sales. The

supply is subject

to the constraints

of Min and Max

Supply. Prior tothe switchover

date, Supply Out

look equals Actual

Supply.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SF_PRIME_TBL;CREATE COLUMN TABLE BFL_SF_PRIME_TBL ("PRIME" DOUBLE);INSERT INTO BFL_SF_PRIME_TBL VALUES(10000);DROP TABLE BFL_SF_TIME_TBL;CREATE COLUMN TABLE BFL_SF_TIME_TBL ("TIME" VARCHAR(255));INSERT INTO BFL_SF_TIME_TBL VALUES('20100801');INSERT INTO BFL_SF_TIME_TBL VALUES('20100912');INSERT INTO BFL_SF_TIME_TBL VALUES('20101020');INSERT INTO BFL_SF_TIME_TBL VALUES('20101130');

INSERT INTO BFL_SF_TIME_TBL VALUES('20110105');INSERT INTO BFL_SF_TIME_TBL VALUES('20110220');

128

P U B L I C



BFL Functions



DROP TABLE BFL_SF_FORECASTSALES_TBL;CREATE COLUMN TABLE BFL_SF_FORECASTSALES_TBL ("FORECASTSALES" DOUBLE);INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(0);INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(0);

INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(3000);INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SF_FORECASTSALES_TBL VALUES(3500);DROP TABLE BFL_SF_FORECASTCOVER_TBL;CREATE COLUMN TABLE BFL_SF_FORECASTCOVER_TBL ("FORECASTCOVER" DOUBLE);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(100);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(70);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(75);INSERT INTO BFL_SF_FORECASTCOVER_TBL VALUES(50);DROP TABLE BFL_SF_ACTUALSALES_TBL;CREATE COLUMN TABLE BFL_SF_ACTUALSALES_TBL ("ACTUALSALES" DOUBLE);INSERT INTO BFL_SF_ACTUALSALES_TBL VALUES(1500);INSERT INTO BFL_SF_ACTUALSALES_TBL VALUES(2000);

DROP TABLE BFL_SF_ACTUALSUPPLY_TBL;CREATE COLUMN TABLE BFL_SF_ACTUALSUPPLY_TBL ("ACTUALSUPPLY" DOUBLE);INSERT INTO BFL_SF_ACTUALSUPPLY_TBL VALUES(2000);INSERT INTO BFL_SF_ACTUALSUPPLY_TBL VALUES(2500);DROP TABLE BFL_SF_ACTUALCLOSING_TBL;CREATE COLUMN TABLE BFL_SF_ACTUALCLOSING_TBL ("ACTUALCLOSING" DOUBLE);INSERT INTO BFL_SF_ACTUALCLOSING_TBL VALUES(10000);INSERT INTO BFL_SF_ACTUALCLOSING_TBL VALUES(10000);DROP TABLE BFL_SF_SWITCHOVER_TBL;CREATE COLUMN TABLE BFL_SF_SWITCHOVER_TBL ("SWITCHOVER" INTEGER);INSERT INTO BFL_SF_SWITCHOVER_TBL VALUES(1);DROP TABLE BFL_SF_SWITCHOVERDATE_TBL;CREATE COLUMN TABLE BFL_SF_SWITCHOVERDATE_TBL ("SWITCHOVERDATE" VARCHAR(255));INSERT INTO BFL_SF_SWITCHOVERDATE_TBL VALUES('20101001');DROP TABLE BFL_SF_COVERUNITS_TBL;CREATE COLUMN TABLE BFL_SF_COVERUNITS_TBL ("COVERUNITS" INTEGER);INSERT INTO BFL_SF_COVERUNITS_TBL VALUES(0);DROP TABLE BFL_SF_PERIODLENGTH_TBL;CREATE COLUMN TABLE BFL_SF_PERIODLENGTH_TBL ("PERIODLENGTH" INTEGER);INSERT INTO BFL_SF_PERIODLENGTH_TBL VALUES(0);DROP TABLE BFL_SF_MAXSUPPLY_TBL;CREATE COLUMN TABLE BFL_SF_MAXSUPPLY_TBL ("MAXSUPPLY" DOUBLE);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MAXSUPPLY_TBL VALUES(0);DROP TABLE BFL_SF_MINSUPPLY_TBL;CREATE COLUMN TABLE BFL_SF_MINSUPPLY_TBL ("MINSUPPLY" DOUBLE);INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);

INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SF_MINSUPPLY_TBL VALUES(0);DROP TABLE BFL_SF_WASTAGERATE_TBL;CREATE COLUMN TABLE BFL_SF_WASTAGERATE_TBL ("WASTAGERATE" DOUBLE);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SF_WASTAGERATE_TBL VALUES(5);DROP TABLE BFL_SF_ROUNDMETHOD_TBL;CREATE COLUMN TABLE BFL_SF_ROUNDMETHOD_TBL ("ROUNDMETHOD" INTEGER);INSERT INTO BFL_SF_ROUNDMETHOD_TBL VALUES(0);

DROP TABLE BFL_SF_ENDMETHOD_TBL;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_SF_ENDMETHOD_TBL ("ENDMETHOD" INTEGER);INSERT INTO BFL_SF_ENDMETHOD_TBL VALUES(2);DROP TABLE BFL_SF_OUTLOOKMETHOD_TBL;CREATE COLUMN TABLE BFL_SF_OUTLOOKMETHOD_TBL ("OUTLOOKMETHOD" INTEGER);

INSERT INTO BFL_SF_OUTLOOKMETHOD_TBL VALUES(0);DROP TABLE BFL_SF_RESULTS_TBL;CREATE COLUMN TABLE BFL_SF_RESULTS_TBL ("OPENING" DOUBLE,"CLOSING"DOUBLE,"ACTUALCOVER" DOUBLE,"WASTAGE" DOUBLE,"SALESOUTLOOK"DOUBLE,"SUPPLYOUTLOOK" DOUBLE); CALL _SYS_AFL.AFLBFL_STOCKFLOW_PROC(BFL_SF_PRIME_TBL, BFL_SF_TIME_TBL,BFL_SF_FORECASTSALES_TBL, BFL_SF_FORECASTCOVER_TBL, BFL_SF_ACTUALSALES_TBL,BFL_SF_ACTUALSUPPLY_TBL, BFL_SF_ACTUALCLOSING_TBL, BFL_SF_SWITCHOVER_TBL,BFL_SF_SWITCHOVERDATE_TBL, BFL_SF_COVERUNITS_TBL, BFL_SF_PERIODLENGTH_TBL ,BFL_SF_MAXSUPPLY_TBL, BFL_SF_MINSUPPLY_TBL, BFL_SF_WASTAGERATE_TBL,BFL_SF_ROUNDMETHOD_TBL, BFL_SF_ENDMETHOD_TBL, BFL_SF_OUTLOOKMETHOD_TBL,BFL_SF_RESULTS_TBL ) WITH OVERVIEW; SELECT * FROM BFL_SF_RESULTS_TBL;

3.46 Stock Flow Reverse

This function is based on the standard Stock Flow Business Function. In Stock Flow, the switchover date

applies to the entire timescale, but in Stock Flow Reverse, an actual/forecast flag acts as a Year over Year

Difference switchover date. This allows stock flow simulation for Year over Year Difference scenarios where

the switchover date may vary due to departure from standard calendars and periods (projects).

Signature

Input Tables

Table 108:


umns



stock of the firstperiod.


time.


be used in the pe

riod containing the

switchover date

and thereafter.

Prior to the

switchover date

there is no fore

cast, only actual.

130

P U B L I C



BFL Functions




umns


Forecast Cover Input Table 1 Double FORECASTCOVER The forecast stockcover. How many

days/periods of

future sales the

closing stock

should support.

100 sets Closing

Stock at such a

level that it lasts

100 days based on

Sales Outlook.

Actual Sales Input Table 1 Double ACTUALSALES Actual Sales input

for historic peri

ods only.

Actual Supply Input Table 1 Double ACTUALSUPPLY Actual Supply in

put for historic pe

riods only.

Actual Closing Input Table 1 Double ACTUALCLOSING Actual Closing

Stock input for

historic periods

only.

Forecast Flag Input Table 1 Int FORECASTFLAG Enter a flag to set

a Year over Year

Difference switch

over date on eachpage. The first

value > 1 indicates

the start of fore

cast periods.

Cover Units Input Table 1 Int COVERUNITS Identifies the

measure for Stock

Cover in terms of

future sales. Days:

Use calendar

days. Default.

Units: Use custom

units from the

item Period

Length. Periods:

Use number of pe

riods. Each detail

item in the time

scale field is a pe

riod.


BFL Functions

P U B L I C





umns


Period Length Input Table 1 Int PERIODLENGTH Available if youwant to use non-

standard calendar

period lengths. For

example: 4 - 4 - 5

for weeks in each

period. Period

Length will be ig

nored unless you

set Cover

Units=Period.


tions (constraints)

to the maximum

supply available to

increase stock lev

els (warehouse


blank, the default

is for Max Supply

to be allowed to go

to infinity.


flow out of stock.

Wastage Rate Input Table 1 Double WASTAGERATE Changes in stock

due to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.

132

P U B L I C



BFL Functions




umns


Rounding Method Input Table 1 Int ROUNDMETHOD DNR: Do notround. This is the


(no partial units,

that is discrete

only). Round:

Round each ele

ment (process).

Preserve Sum:

Preserve the sum

by changing the

most obvious ele

ment(s), where

rounded value isfurthest from orig

inal value. Pre

serve Sum YoY:

Preserve the sum

by rounding cu

mulated data and

then taking the

Year over Year Dif

ference (the de

fault).


The number of pe

riods over whichto average sales

when projecting

beyond the last

period in the time

scale. This is used

in the Closing

Stock calculation

toward the end of

the timescale. N

periods: Use the

average of the last

3 periods to

project sales forward.


BFL Functions

P U B L I C





umns



How forecastsales input is used

to provide future

sales outlook. De

fault: Use Forecast

Sales from the pe

riod containing the

switchover date

onwards, Actual

Sales prior to this

(the default

method). Restrict:

Restrict future


tive.

Output Table

Table 109:


umns



Fed from the Clos

ing Stock of the

previous period.


tual Closing Stock

prior to the

switchover date;

the level required

to meet the Fore

cast Stock Cover

thereafter.


Cover. How many

days/periods of

future sales theClosing Stock ac

tually does sup

port.

Double WASTAGE Changes in stock

due to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.

134

P U B L I C



BFL Functions




umns


Double SALESOUTLOOK Sales Outlook isequal to the Actual

Sales history prior

to the switchover

date, Forecast

Sales thereafter.

See Outlook

Method.


ture periods re

quired to meet

forecast stock

cover based on

forecast sales. The

supply is subject

to the constraints

of Min and Max

Supply. Prior to

the switchover

date, Supply Out

look equals Actual

Supply.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SFR_PRIME_TBL;CREATE COLUMN TABLE BFL_SFR_PRIME_TBL ("PRIME" DOUBLE);INSERT INTO BFL_SFR_PRIME_TBL VALUES(10000);DROP TABLE BFL_SFR_TIME_TBL;CREATE COLUMN TABLE BFL_SFR_TIME_TBL ("TIME" VARCHAR(255));INSERT INTO BFL_SFR_TIME_TBL VALUES('20100801');INSERT INTO BFL_SFR_TIME_TBL VALUES('20100912');INSERT INTO BFL_SFR_TIME_TBL VALUES('20101020');INSERT INTO BFL_SFR_TIME_TBL VALUES('20101130');INSERT INTO BFL_SFR_TIME_TBL VALUES('20110105');INSERT INTO BFL_SFR_TIME_TBL VALUES('20110220');DROP TABLE BFL_SFR_FORECASTSALES_TBL;CREATE COLUMN TABLE BFL_SFR_FORECASTSALES_TBL ("FORECASTSALES" DOUBLE);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(3000);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SFR_FORECASTSALES_TBL VALUES(3500);

DROP TABLE BFL_SFR_FORECASTCOVER_TBL;CREATE COLUMN TABLE BFL_SFR_FORECASTCOVER_TBL ("FORECASTCOVER" DOUBLE);


BFL Functions

P U B L I C




INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(100);INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(70);

INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(75);INSERT INTO BFL_SFR_FORECASTCOVER_TBL VALUES(50);DROP TABLE BFL_SFR_ACTUALSALES_TBL;CREATE COLUMN TABLE BFL_SFR_ACTUALSALES_TBL ("ACTUALSALES" DOUBLE);INSERT INTO BFL_SFR_ACTUALSALES_TBL VALUES(1500);INSERT INTO BFL_SFR_ACTUALSALES_TBL VALUES(2000);DROP TABLE BFL_SFR_ACTUALSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFR_ACTUALSUPPLY_TBL ("ACTUALSUPPLY" DOUBLE);INSERT INTO BFL_SFR_ACTUALSUPPLY_TBL VALUES(2000);INSERT INTO BFL_SFR_ACTUALSUPPLY_TBL VALUES(2500);DROP TABLE BFL_SFR_ACTUALCLOSING_TBL;CREATE COLUMN TABLE BFL_SFR_ACTUALCLOSING_TBL ("ACTUALCLOSING" DOUBLE);INSERT INTO BFL_SFR_ACTUALCLOSING_TBL VALUES(10000);INSERT INTO BFL_SFR_ACTUALCLOSING_TBL VALUES(10000);DROP TABLE BFL_SFR_FORECASTFLAG_TBL;CREATE COLUMN TABLE BFL_SFR_FORECASTFLAG_TBL ("FORECASTFLAG" INTEGER);

INSERT INTO BFL_SFR_FORECASTFLAG_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTFLAG_TBL VALUES(0);INSERT INTO BFL_SFR_FORECASTFLAG_TBL VALUES(2);DROP TABLE BFL_SFR_COVERUNITS_TBL;CREATE COLUMN TABLE BFL_SFR_COVERUNITS_TBL ("COVERUNITS" INTEGER);INSERT INTO BFL_SFR_COVERUNITS_TBL VALUES(0);DROP TABLE BFL_SFR_PERIODLENGTH_TBL;CREATE COLUMN TABLE BFL_SFR_PERIODLENGTH_TBL ("PERIODLENGTH" INTEGER);INSERT INTO BFL_SFR_PERIODLENGTH_TBL VALUES(0);DROP TABLE BFL_SFR_MAXSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFR_MAXSUPPLY_TBL ("MAXSUPPLY" DOUBLE);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MAXSUPPLY_TBL VALUES(0);DROP TABLE BFL_SFR_MINSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFR_MINSUPPLY_TBL ("MINSUPPLY" DOUBLE);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFR_MINSUPPLY_TBL VALUES(0);DROP TABLE BFL_SFR_WASTAGERATE_TBL;CREATE COLUMN TABLE BFL_SFR_WASTAGERATE_TBL ("WASTAGERATE" DOUBLE);INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);

INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFR_WASTAGERATE_TBL VALUES(5);DROP TABLE BFL_SFR_ROUNDMETHOD_TBL;CREATE COLUMN TABLE BFL_SFR_ROUNDMETHOD_TBL ("ROUNDMETHOD" INTEGER);INSERT INTO BFL_SFR_ROUNDMETHOD_TBL VALUES(0);DROP TABLE BFL_SFR_ENDMETHOD_TBL;CREATE COLUMN TABLE BFL_SFR_ENDMETHOD_TBL ("ENDMETHOD" INTEGER);INSERT INTO BFL_SFR_ENDMETHOD_TBL VALUES(2);DROP TABLE BFL_SFR_OUTLOOKMETHOD_TBL;CREATE COLUMN TABLE BFL_SFR_OUTLOOKMETHOD_TBL ("OUTLOOKMETHOD" INTEGER);INSERT INTO BFL_SFR_OUTLOOKMETHOD_TBL VALUES(0);DROP TABLE BFL_SFR_RESULTS_TBL;CREATE COLUMN TABLE BFL_SFR_RESULTS_TBL ("OPENING" DOUBLE,"CLOSING"DOUBLE,"ACTUALCOVER" DOUBLE,"WASTAGE" DOUBLE,"SALESOUTLOOK"DOUBLE,"SUPPLYOUTLOOK" DOUBLE); CALL _SYS_AFL.AFLBFL_STOCKFLOWREVERSE_PROC(BFL_SFR_PRIME_TBL, BFL_SFR_TIME_TBL,BFL_SFR_FORECASTSALES_TBL, BFL_SFR_FORECASTCOVER_TBL, BFL_SFR_ACTUALSALES_TBL,

136

P U B L I C



BFL Functions



BFL_SFR_ACTUALSUPPLY_TBL, BFL_SFR_ACTUALCLOSING_TBL, BFL_SFR_FORECASTFLAG_TBL,BFL_SFR_COVERUNITS_TBL, BFL_SFR_PERIODLENGTH_TBL , BFL_SFR_MAXSUPPLY_TBL,BFL_SFR_MINSUPPLY_TBL, BFL_SFR_WASTAGERATE_TBL, BFL_SFR_ROUNDMETHOD_TBL,BFL_SFR_ENDMETHOD_TBL, BFL_SFR_OUTLOOKMETHOD_TBL, BFL_SFR_RESULTS_TBL ) WITH

OVERVIEW; SELECT * FROM BFL_SFR_RESULTS_TBL;

3.47 Stock Flow Batch

This function enables the use of batch quantities when calculating stock flow.

Supply Outlook=Stock Flow Reverse(Prime; Opening Stock; Forecast Sales; Forecast Cover; Closing Stock; Actual Sales; Actual Cover; Actual Supply; Actual Closing; Forecast flag; Cover Units; Period Length; Max

Supply; Min Supply; Batch Quantity; Minimum Method; % Wastage; Wastage; Rounding Method; End Method;

Outlook Method; Sales Outlook)

Methods

See the Stock Flow Function for complete information on methods.

Batch Quantity

When {Batch Quantity} is non-zero, the {Supply Outlook} will be rounded up to the next integer multiple of

{Batch Quantity}. Stock Flow Reverse has more information about other inputs and calculations.

Minimum Method

Applies to {Supply Outlook} in forecast periods.

It modifies the effect of {Min Supply}.

Minimum, Maximum and batch size

Stock Flow Batch resolves inconsistent inputs in the following manner:

● If {Min Supply} > 0 and {Batch Size} > 0, then round {Min Supply} up to the next integer multiple of {Batch

Size}.

● If {Batch Size} > 0 and {Max Supply} > 0, then round {Max Supply} down to the next integer multiple of

{Batch Size}.

● If {Min Supply} > {Max Supply}, then set {Max Supply} = {Min Supply}.

Signature

Input Tables


BFL Functions

P U B L I C




Table 110:


umns



stock of the first

period.


time.


be used in the pe

riod containing the

switchover date

and thereafter.

Prior to the

switchover date

there is no fore

cast – only actual.

Forecast Cover Input Table 1 Double FORECASTCOVER The forecast stock

cover. How many

days/periods of

future sales the

closing stock

should support.

100 sets Closing

Stock at such a

level that it lasts

100 days based on

Sales Outlook.

Actual Sales Input Table 1 Double ACTUALSALES Actual Sales input

for historic peri

ods only.

Actual Supply Input Table 1 Double ACTUALSUPPLY Actual Supply in

put for historic pe

riods only.

Actual Closing Input Table 1 Double ACTUALCLOSING Actual Closing

Stock input for

historic periods

only.

Forecast Flag Input Table 1 Int FORECASTFLAG Enter a flag to actas a Year over

Year Difference

switchover date

on each page. The

first value > 1 indi

cates the start of

forecast periods.

138

P U B L I C



BFL Functions




umns


Cover Units Input Table 1 Int COVERUNITS Identifies themeasure for Stock

Cover in terms of

future sales. Days:

Use calendar

days. Default.

Units: Use custom

units from the

item Period

Length. Periods:

Use number of pe

riods. Each detail

item in the time

scale field is a period.

Period Length Input Table 1 Int PERIODLENGTH Available if you

want to use non-

standard calendar

period lengths. For

example: 4 - 4 - 5

for weeks in each

period. Period

Length will be ig

nored unless you

set Cover

Units=Period.


tions (constraints)

to the maximum

supply available to

increase stock lev

els (warehouse


blank, the default

is for Max Supply

to be allowed to go

to infinity.


flow out of stock.

Batch Quantity Input Table 1 Double BATCHQUANTITY When {Batch

Quantity} is non-

zero, the {Supply

Outlook} will be

rounded up to the

next integer multi

ple of {Batch

Quantity}. Stock

Flow Reverse has

more information

about other inputs

and calculations.


BFL Functions

P U B L I C





umns


Wastage Rate Input Table 1 Double WASTAGERATE Changes in stockdue to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.

Rounding Method Input Table 1 Int ROUNDMETHOD DNR: Do not

round. This is the


(no partial units,

discrete units

only). Round:

Round each ele

ment (process).

Preserve Sum:

Preserve the sum

by changing the

most obvious ele

ment(s), where

rounded value is

furthest from orig

inal value. Pre

serve Sum YoY:

Preserve the sum

by rounding cumulated data and

then taking the

Year over Year Dif

ference (the de

fault).


The number of pe

riods over which

to average sales

when projecting

beyond the last

period in the time

scale. This is used

in the closing

stock calculation

toward the end of

the timescale. N

periods: Use the

average of the last

3 periods to

project sales for

ward.

140

P U B L I C



BFL Functions




umns



How forecastsales input is used

to provide future

sales outlook. De

fault: Use Forecast

Sales from the pe

riod containing the

switchover date

onwards, Actual

Sales prior to this

(the default

method). Restrict:

Restrict future


tive.

Output Table

Table 111:


umns



Fed from the Clos

ing Stock of the

previous period.


tual Closing Stock

prior to the

switchover date;

the level required

to meet the Fore

cast Stock Cover

thereafter.


Cover. How many

days/periods of

future sales theClosing Stock ac

tually does sup

port.

Double WASTAGE Changes in stock

due to shrinkage

(not explained by

sales and supply).

Wastage is = to %

Wastage applied

to the Opening

Stock.


BFL Functions

P U B L I C





umns


Double SALESOUTLOOK Sales Outlook isequal to the Actual

Sales history prior

to the switchover

date, Forecast

Sales thereafter.

See Outlook

Method.


ture periods re

quired to meet

forecast stock

cover based on

forecast sales. The

supply is subject

to the constraints

of Min and Max

Supply. Prior to

the switchover

date, Supply Out

look equals Actual

Supply.

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_SFB_PRIME_TBL;CREATE COLUMN TABLE BFL_SFB_PRIME_TBL ("PRIME" DOUBLE);INSERT INTO BFL_SFB_PRIME_TBL VALUES(10000);DROP TABLE BFL_SFB_TIME_TBL;CREATE COLUMN TABLE BFL_SFB_TIME_TBL ("TIME" VARCHAR(255));INSERT INTO BFL_SFB_TIME_TBL VALUES('20100801');INSERT INTO BFL_SFB_TIME_TBL VALUES('20100912');INSERT INTO BFL_SFB_TIME_TBL VALUES('20101020');INSERT INTO BFL_SFB_TIME_TBL VALUES('20101130');INSERT INTO BFL_SFB_TIME_TBL VALUES('20110105');INSERT INTO BFL_SFB_TIME_TBL VALUES('20110220');DROP TABLE BFL_SFB_FORECASTSALES_TBL;CREATE COLUMN TABLE BFL_SFB_FORECASTSALES_TBL ("FORECASTSALES" DOUBLE);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(3000);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(2500);INSERT INTO BFL_SFB_FORECASTSALES_TBL VALUES(3500);

DROP TABLE BFL_SFB_FORECASTCOVER_TBL;CREATE COLUMN TABLE BFL_SFB_FORECASTCOVER_TBL ("FORECASTCOVER" DOUBLE);

142

P U B L I C



BFL Functions



INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(100);INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(70);

INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(75);INSERT INTO BFL_SFB_FORECASTCOVER_TBL VALUES(50);DROP TABLE BFL_SFB_ACTUALSALES_TBL;CREATE COLUMN TABLE BFL_SFB_ACTUALSALES_TBL ("ACTUALSALES" DOUBLE);INSERT INTO BFL_SFB_ACTUALSALES_TBL VALUES(1500);INSERT INTO BFL_SFB_ACTUALSALES_TBL VALUES(2000);DROP TABLE BFL_SFB_ACTUALSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFB_ACTUALSUPPLY_TBL ("ACTUALSUPPLY" DOUBLE);INSERT INTO BFL_SFB_ACTUALSUPPLY_TBL VALUES(2000);INSERT INTO BFL_SFB_ACTUALSUPPLY_TBL VALUES(2500);DROP TABLE BFL_SFB_ACTUALCLOSING_TBL;CREATE COLUMN TABLE BFL_SFB_ACTUALCLOSING_TBL ("ACTUALCLOSING" DOUBLE);INSERT INTO BFL_SFB_ACTUALCLOSING_TBL VALUES(10000);INSERT INTO BFL_SFB_ACTUALCLOSING_TBL VALUES(10000);DROP TABLE BFL_SFB_FORECASTFLAG_TBL;CREATE COLUMN TABLE BFL_SFB_FORECASTFLAG_TBL ("FORECASTFLAG" INTEGER);

INSERT INTO BFL_SFB_FORECASTFLAG_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTFLAG_TBL VALUES(0);INSERT INTO BFL_SFB_FORECASTFLAG_TBL VALUES(2);DROP TABLE BFL_SFB_COVERUNITS_TBL;CREATE COLUMN TABLE BFL_SFB_COVERUNITS_TBL ("COVERUNITS" INTEGER);INSERT INTO BFL_SFB_COVERUNITS_TBL VALUES(0);DROP TABLE BFL_SFB_PERIODLENGTH_TBL;CREATE COLUMN TABLE BFL_SFB_PERIODLENGTH_TBL ("PERIODLENGTH" INTEGER);INSERT INTO BFL_SFB_PERIODLENGTH_TBL VALUES(0);DROP TABLE BFL_SFB_MAXSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFB_MAXSUPPLY_TBL ("MAXSUPPLY" DOUBLE);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MAXSUPPLY_TBL VALUES(0);DROP TABLE BFL_SFB_MINSUPPLY_TBL;CREATE COLUMN TABLE BFL_SFB_MINSUPPLY_TBL ("MINSUPPLY" DOUBLE);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);INSERT INTO BFL_SFB_MINSUPPLY_TBL VALUES(0);DROP TABLE BFL_SFB_BATCHQUANTITY_TBL;CREATE COLUMN TABLE BFL_SFB_BATCHQUANTITY_TBL("BATCHQUANTITY" DOUBLE);INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);

INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);INSERT INTO BFL_SFB_BATCHQUANTITY_TBL VALUES(0);DROP TABLE BFL_SFB_WASTAGERATE_TBL;CREATE COLUMN TABLE BFL_SFB_WASTAGERATE_TBL ("WASTAGERATE" DOUBLE);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);INSERT INTO BFL_SFB_WASTAGERATE_TBL VALUES(5);DROP TABLE BFL_SFB_ROUNDMETHOD_TBL;CREATE COLUMN TABLE BFL_SFB_ROUNDMETHOD_TBL ("ROUNDMETHOD" INTEGER);INSERT INTO BFL_SFB_ROUNDMETHOD_TBL VALUES(0);DROP TABLE BFL_SFB_ENDMETHOD_TBL;CREATE COLUMN TABLE BFL_SFB_ENDMETHOD_TBL ("ENDMETHOD" INTEGER);INSERT INTO BFL_SFB_ENDMETHOD_TBL VALUES(2);

DROP TABLE BFL_SFB_OUTLOOKMETHOD_TBL;


BFL Functions

P U B L I C




CREATE COLUMN TABLE BFL_SFB_OUTLOOKMETHOD_TBL ("OUTLOOKMETHOD" INTEGER);INSERT INTO BFL_SFB_OUTLOOKMETHOD_TBL VALUES(0);DROP TABLE BFL_SFB_RESULTS_TBL;CREATE COLUMN TABLE BFL_SFB_RESULTS_TBL ("OPENING" DOUBLE,"CLOSING"

DOUBLE,"ACTUALCOVER" DOUBLE,"WASTAGE" DOUBLE,"SALESOUTLOOK"DOUBLE,"SUPPLYOUTLOOK" DOUBLE); CALL _SYS_AFL.AFLBFL_STOCKFLOWBATCH_PROC(BFL_SFB_PRIME_TBL, BFL_SFB_TIME_TBL,BFL_SFB_FORECASTSALES_TBL, BFL_SFB_FORECASTCOVER_TBL, BFL_SFB_ACTUALSALES_TBL,BFL_SFB_ACTUALSUPPLY_TBL, BFL_SFB_ACTUALCLOSING_TBL, BFL_SFB_FORECASTFLAG_TBL,BFL_SFB_COVERUNITS_TBL, BFL_SFB_PERIODLENGTH_TBL , BFL_SFB_MAXSUPPLY_TBL,BFL_SFB_MINSUPPLY_TBL, BFL_SFB_BATCHQUANTITY_TBL, BFL_SFB_WASTAGERATE_TBL,BFL_SFB_ROUNDMETHOD_TBL, BFL_SFB_ENDMETHOD_TBL, BFL_SFB_OUTLOOKMETHOD_TBL,BFL_SFB_RESULTS_TBL ) WITH OVERVIEW; SELECT * FROM BFL_SFB_RESULTS_TBL;

3.48 Time

This function returns the information requested by the option you have input. It is one of the most time

consuming elements in FPM or simulation because of the relevance of specific periods. Scripting of time,

particularly in excel driven formats (such as BPC) can be extremely costly and extremely difficult to maintain.

If any modeling requires modification of the time series, the condition becomes worse.

Timescale standard:

● Start of a period = Midnight of the first day

● Middle of a period = Noon or midnight (This depends on the number of days in the period)

● End of a period = Midnight on the last day (also the start of the next day)

Signature

Input Tables

Table 112:


umns


Time Scale Input Table 1 Double TIMESCALE Input amount

Start Date Input Table 1 Double STARTDATE The date start to

calculate

Switchover Input Table 1 Double SWITCHOVER Switchover date

144

P U B L I C



BFL Functions




umns


Time information Input Table 1 Double TIMEINFORMATION

The option you require for time in

formation. Detail

information shown

below: Now(0)

Last(1) Start(2)

Mid(3) End(4)

Days(5) IID(6)

Current(7) Switch

over(8) Actual(9):

Cycle(10): Pe

riod(11): First(12):

Last(13): Ac

tual(14): Min(15):Method(16)

Output Table

Table 113:


umns


Result Output Table 1 String TIME Returns time-re

lated information

Specification of Method

Now(0): Current system date and time

Last(1): Last Save

Start(2): the date and time at the start of this period

Mid(3): the date and time at the middle of this period

End(4): the date and time at the end of this period

Days(5): the number of days in this period

IID(6)

Current(7): Sets a flag = 1 in the period containing system date

Switchover(8): Sets a flag =1 in the period containing switchover date

Actual(9): Sets a flag =1 in periods up to, but not including, the period containing the system date (current)

Cycle(10): The number of periods like this in a year to the nearest whole number (minimum 1)

Period(11): Number the periods within a year, starting again at 1 each year and counting up until it reaches the

total number of periods in the year (as defined in ‘cycle’)

First(12): Sets a flag =1 in the first period of every timescale subtotal


BFL Functions

P U B L I C




Last(13): Sets a flag =1 in the last period of every timescale subtotal

Actual(14): Sets a flag =1 in periods up to, but not including, the period containing the switchover date

Min(15): the date and time 1 minute before midnight on last day of period

Method(16): the middle of each period in year units, where 2003.5 means the middle of 2003. It is used by

Cycles as its measure of time

Example

Assume that:


● USER1 has been assigned the AFL__SYS_AFL_AFLBFL_EXECUTE orAFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION role.

SET SCHEMA BFL_TEST; DROP TABLE BFL_TIME_TIMESCALE_TBL;CREATE COLUMN TABLE BFL_TIME_TIMESCALE_TBL ( "TIMESCALE" DOUBLE ) ;INSERT INTO BFL_TIME_TIMESCALE_TBL VALUES (0) ;DROP TABLE BFL_TIME_STARTDATE_TBL;CREATE COLUMN TABLE BFL_TIME_STARTDATE_TBL ( "STARTDATE" DOUBLE ) ;INSERT INTO BFL_TIME_STARTDATE_TBL VALUES ('20040228') ;DROP TABLE BFL_TIME_SWITCHOVER_TBL;CREATE COLUMN TABLE BFL_TIME_SWITCHOVER_TBL ( "SWITCHOVER" DOUBLE ) ;INSERT INTO BFL_TIME_SWITCHOVER_TBL VALUES ('20040307') ;DROP TABLE BFL_TIME_TIMEINFORMATION_TBL;CREATE COLUMN TABLE BFL_TIME_TIMEINFORMATION_TBL ( "TIMEINFORMATION" DOUBLE ) ;

INSERT INTO BFL_TIME_TIMEINFORMATION_TBL VALUES (4) ;DROP TABLE BFL_TIME_TIME_TBL;CREATE COLUMN TABLE BFL_TIME_TIME_TBL ( "TIME" VARCHAR(255)) ; CALL _SYS_AFL.AFLBFL_TIME_PROC(BFL_TIME_TIMESCALE_TBL, BFL_TIME_STARTDATE_TBL,BFL_TIME_SWITCHOVER_TBL, BFL_TIME_TIMEINFORMATION_TBL, BFL_TIME_TIME_TBL) WITHOVERVIEW; SELECT * FROM BFL_TIME_TIME_TBL;

3.49 Time Sum


This function allows you to accumulate an expense over a specified number of periods in advance or in arrears.

It can also be used in conjunction with the Delay function to convert an expense stream in the P&L firstly into

invoice amounts, then into cash payments.

Formula

Time Sum=Time Sum (Amount, Periods, Arrears/Advance, End, Override, Days in Period, Indicator)

146

P U B L I C



BFL Functions



Signature

Input Tables

Table 114:


umns


Data Input Table 1 Double DATE The amount to ac

crue.

Number Periods Input Table 1 Double NUMPERIODS The number of pe

riods to add up to

determine the size

of the bill. For ex

ample, if you enter

3, it accumulatesthree periods. This

parameter reads

the Advance/

Arrears parameter

to determine

whether to count

the periods for

ward (Advance) or

backward (Ar

rears). Periods are

processed in chro

nological order, re

gardless of the sequence of the peri

ods.

Methods Input Table 3 Double METHOD1 Arrears/ Advance

type:

● In arrears

● In advance

Double METHOD2 End type:

● Zero (default)

● Average

● Replicate

● Override -The

override is

used even if

the number of

periods is 0.

● Spare

Double METHOD2 Override value.

Days Input Table 1 Double DAYS Length of period in

days.


BFL Functions

P U B L I C





umns


Config Input Table 1 Double CONFIG Has six rows, eachrows specify as

below:

● 0: 0, days is

not used; 1,

days is used;

2, days is not

used

● 1: First calcu

lated month

● 2: To calcu

late month

length

● 3: First calcu

lated year

● 4: Length of

Year

● 5: Zero or

non-zero, if

zero, days is

not used

Output Table

Table 115:


umns


Result Output Table 1 Double TIMESUM The cash pay

ments

Example

Assume that:





SET SCHEMA BFL_TEST; DROP TYPE BFL_TMSM_DATA_T;CREATE TYPE BFL_TMSM_DATA_T AS TABLE("DATA" DOUBLE);DROP TYPE BFL_TMSM_NUMPERIODS_T;CREATE TYPE BFL_TMSM_NUMPERIODS_T AS TABLE("NUMPERIODS" DOUBLE);DROP TYPE BFL_TMSM_METHOD_T;CREATE TYPE BFL_TMSM_METHOD_T AS TABLE("METHOD1" DOUBLE, "METHOD2" DOUBLE,"METHOD3" DOUBLE);

DROP TYPE BFL_TMSM_DAYS_T;CREATE TYPE BFL_TMSM_DAYS_T AS TABLE("DAYS" DOUBLE);

148

P U B L I C



BFL Functions



DROP TYPE BFL_TMSM_CONFIG_T;CREATE TYPE BFL_TMSM_CONFIG_T AS TABLE("CONFIG" DOUBLE);DROP TYPE BFL_TMSM_RESULT_T;CREATE TYPE BFL_TMSM_RESULT_T AS TABLE("TIMESUM" DOUBLE);

DROP table BFL_TMSM_PDATA_TBL;CREATE column table BFL_TMSM_PDATA_TBL("POSITION" INT,"SCHEMA_NAME"NVARCHAR(256),"TYPE_NAME" NVARCHAR(256), ”PARAMETER_TYPE” VARCHAR(7));insert into BFL_TMSM_PDATA_TBL values (1,'BFL_TEST’,’BFL_TMSM_DATA_T', 'IN');insert into BFL_TMSM_PDATA_TBL values (2,'BFL_TEST’,’BFL_TMSM_NUMPERIODS_T','IN');insert into BFL_TMSM_PDATA_TBL values (3,'BFL_TEST’,’BFL_TMSM_METHOD_T', 'IN');insert into BFL_TMSM_PDATA_TBL values (4,'BFL_TEST’,’BFL_TMSM_DAYS_T', 'IN');insert into BFL_TMSM_PDATA_TBL values (5,'BFL_TEST’,’BFL_TMSM_CONFIG_T', 'IN');insert into BFL_TMSM_PDATA_TBL values (6,'BFL_TEST’,’BFL_TMSM_RESULT_T', 'OUT'); call SYS.AFLLANG_WRAPPER_PROCEDURE_DROP('BFL_TEST’,'AFLBFL_TIMESUM_PROC'); call SYS.AFLLANG_WRAPPER_PROCEDURE_CREATE('AFLBFL','TIMESUM','TEST_BFL','AFLBFL_TIMESUM_PROC',BFL_TMSM_PDATA_TBL); DROP TABLE BFL_TMSM_DATA_TBL;CREATE COLUMN TABLE BFL_TMSM_DATA_TBL ( "DATA" DOUBLE ) ;INSERT INTO BFL_TMSM_DATA_TBL VALUES (30) ;

INSERT INTO BFL_TMSM_DATA_TBL VALUES (40) ;INSERT INTO BFL_TMSM_DATA_TBL VALUES (40) ;INSERT INTO BFL_TMSM_DATA_TBL VALUES (300) ;INSERT INTO BFL_TMSM_DATA_TBL VALUES (400) ;INSERT INTO BFL_TMSM_DATA_TBL VALUES (500) ;DROP TABLE BFL_TMSM_NUMPERIODS_TBL;CREATE COLUMN TABLE BFL_TMSM_NUMPERIODS_TBL ( "NUMPERIODS" DOUBLE ) ;INSERT INTO BFL_TMSM_NUMPERIODS_TBL VALUES (0) ;INSERT INTO BFL_TMSM_NUMPERIODS_TBL VALUES (3) ;INSERT INTO BFL_TMSM_NUMPERIODS_TBL VALUES (0) ;INSERT INTO BFL_TMSM_NUMPERIODS_TBL VALUES (12) ;DROP TABLE BFL_TMSM_METHOD_TBL;CREATE COLUMN TABLE BFL_TMSM_METHOD_TBL ( "METHOD1" DOUBLE ,"METHOD2"DOUBLE,"METHOD3" DOUBLE);INSERT INTO BFL_TMSM_METHOD_TBL VALUES (1, 0, 0) ;DROP TABLE BFL_TMSM_DAYS_TBL;CREATE COLUMN TABLE BFL_TMSM_DAYS_TBL ( "DAYS" DOUBLE ) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (30) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (30) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (30) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (360) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (360) ;INSERT INTO BFL_TMSM_DAYS_TBL VALUES (360) ;DROP TABLE BFL_TMSM_CONFIG_TBL; CREATE COLUMN TABLE BFL_TMSM_CONFIG_TBL( "CONFIG" DOUBLE) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (1) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (10) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (1) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (0) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (3) ;INSERT INTO BFL_TMSM_CONFIG_TBL VALUES (3) ;

DROP TABLE BFL_TMSM_TIMESUM_TBL;CREATE COLUMN TABLE BFL_TMSM_TIMESUM_TBL ( "TIMESUM" DOUBLE) ; CALL BFL_TEST.AFLBFL_TIMESUM_PROC(BFL_TMSM_DATA_TBL, BFL_TMSM_NUMPERIODS_TBL,BFL_TMSM_METHOD_TBL, BFL_TMSM_DAYS_TBL, BFL_TMSM_CONFIG_TBL,BFL_TMSM_TIMESUM_TBL) WITH OVERVIEW; SELECT * FROM BFL_TMSM_TIMESUM_TBL;

3.50 Transform

This function provides some angles and trigonometry functions for users based on different methods. It can be

used when the Cycles function does not meet the functionality you need.


BFL Functions

P U B L I C




Signature

Input Tables

Table 116:


umns


Input Input Table 1 Double VALUE Input value, varies

with the method,

for example: angle

measured in radi

ans.

Method Input Table 1 Double VALUE Methods: 0=No

Change; 1=Sine;

2=Cosine; 3=Tan

gent;4=(1+in

put^2)^.5;5=sinh;

6=cosh;7=tanh;

8=Degrees to radi

ans; ...

Output Table

Table 117:


umns


Result Output Table 1 Double TRANSFORM Transformations

for time series

Example

Assume that:


● USER1 has been assigned the AFL__SYS_AFL_AFLBFL_EXECUTE orAFL__SYS_AFL_AFLBFL_EXECUTE_WITH_GRANT_OPTION role.

SET SCHEMA BFL_TEST; DROP TABLE BFL_TSFM_INPUT_TBL ;CREATE COLUMN TABLE BFL_TSFM_INPUT_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_TSFM_INPUT_TBL VALUES (10) ;DROP TABLE BFL_TSFM_METHOD_TBL ;CREATE COLUMN TABLE BFL_TSFM_METHOD_TBL ( "VALUE" DOUBLE ) ;INSERT INTO BFL_TSFM_METHOD_TBL VALUES (7) ;DROP TABLE BFL_TSFM_RESULTS_TBL ;CREATE COLUMN TABLE BFL_TSFM_RESULTS_TBL ("TRANSFORM" DOUBLE) ; CALL _SYS_AFL.AFLBFL_TRANSFORM_PROC(BFL_TSFM_INPUT_TBL, BFL_TSFM_METHOD_TBL,BFL_TSFM_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_TSFM_RESULTS_TBL;

150

P U B L I C



BFL Functions



3.51 Volume Driver

This function calculates the year-over-year percentage difference for each volume driver. A volume driver is

entered as a percentage and a bandwidth. The bandwidth should be a positive number. The bandwidth of the

first volume driver always starts at zero.

After allocating percentage to all non-zero bandwidth, the remaining percentage will be applied to any residue.

Formula

Volume Driver result = Volume Driver(Value, Volume Driver1 %, Volume Driver1, Volume Driver2 %, Volume

Driver2, Volume Driver3 %, Volume Driver3 …)

Signature

Input Tables

Table 118:



Salary Input Table 1 Double SALARY Input amount

Percent Input Table 1 Double PERCENT Percentage to be

applied, starting at

zero

Bandwidth Input Table 1 Double BANDWIDTH Bandwidth value

Output Table

Table 119:


umns


Result Output Table 1 Double OVERHEAD Calculated volume

driver result

Example

Assume that:



BFL Functions

P U B L I C






SET SCHEMA BFL_TEST; DROP TABLE BFL_VD_VALUES_TBL;CREATE COLUMN TABLE BFL_VD_VALUES_TBL ( "SALARY" DOUBLE );INSERT INTO BFL_VD_VALUES_TBL VALUES (2000);INSERT INTO BFL_VD_VALUES_TBL VALUES (15000);INSERT INTO BFL_VD_VALUES_TBL VALUES (25000);INSERT INTO BFL_VD_VALUES_TBL VALUES (35000);INSERT INTO BFL_VD_VALUES_TBL VALUES (45000);DROP TABLE BFL_VD_PERCENTS_TBL;CREATE COLUMN TABLE BFL_VD_PERCENTS_TBL ( "PERCENT" DOUBLE );INSERT INTO BFL_VD_PERCENTS_TBL VALUES (0);INSERT INTO BFL_VD_PERCENTS_TBL VALUES (0.2);INSERT INTO BFL_VD_PERCENTS_TBL VALUES (0.4);DROP TABLE BFL_VD_BANDWITHS_TBL;CREATE COLUMN TABLE BFL_VD_BANDWITHS_TBL ( "BANDWIDTH" DOUBLE );INSERT INTO BFL_VD_BANDWITHS_TBL VALUES (3000);

INSERT INTO BFL_VD_BANDWITHS_TBL VALUES (27000);DROP TABLE BFL_VD_RESULTS_TBL;CREATE COLUMN TABLE BFL_VD_RESULTS_TBL ( "OVERHEAD" DOUBLE); CALL _SYS_AFL.AFLBFL_VOLUMEDRIVER_PROC(BFL_VD_VALUES_TBL, BFL_VD_PERCENTS_TBL,BFL_VD_BANDWITHS_TBL, BFL_VD_RESULTS_TBL) WITH OVERVIEW; SELECT * FROM BFL_VD_RESULTS_TBL;

3.52 Year-Over-Year Difference

This function calculates the year-over -year difference between the current and previous one time period. The

function result can be a percentage, proportion, or actual amount.

Formula

Three formulas are required by the Business function for percentage, actual number, or proportion

respectively.

Year over Year Difference = Year over Year Difference (Base; Style)

For percentage:

Year over Year Difference, period n = Year over Year Difference (Base; %) = 100*(((Base, period n) - (Base

period n-1))/(Base, period n))

For actual amount:

Year over Year Difference, period n = Year over Year Difference (Base; a) = (Base, period n) - (Base, period n-1)

For proportion:

Year over Year Difference, period n = Year over Year Difference ({Base Sales; p) = (Base, period n)/(Base,

period n-1)

152

P U B L I C



BFL Functions



Signature

Input Tables

Table 120:


umns


Base Input Table 1 Double BASE The data to com

pare

Style Input Table 1 Double STYLE 0: Percent Year

over Year Differ

ence 1: Arithmetic

Year over Year Dif

ference 2: Propor

tion Year over

Year Difference

Output Table

Table 121:


umns


Result Output Table 1 Double DIFFERENCE The Year over

Year Difference

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_YOYD_BASE_TBL;CREATE COLUMN TABLE BFL_YOYD_BASE_TBL( "BASE" DOUBLE ) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (1000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (2000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (4000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (5000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (2000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (1000) ;INSERT INTO BFL_YOYD_BASE_TBL VALUES (0) ;DROP TABLE BFL_YOYD_STYLE_TBL;CREATE COLUMN TABLE BFL_YOYD_STYLE_TBL( "STYLE" INT);INSERT INTO BFL_YOYD_STYLE_TBL VALUES (0) ;DROP TABLE BFL_YOYD_DIFFERENCE_TBL;CREATE COLUMN TABLE BFL_YOYD_DIFFERENCE_TBL( "DIFFERENCE" DOUBLE) ; CALL _SYS_AFL.AFLBFL_YEAROVERYEARDIFFERENCE_PROC(BFL_YOYD_BASE_TBL,BFL_YOYD_STYLE_TBL, BFL_YOYD_DIFFERENCE_TBL) WITH OVERVIEW;

SELECT * FROM BFL_YOYD_DIFFERENCE_TBL ;


BFL Functions

P U B L I C




3.53 Year to Date

This function calculates the sum of original data in the year to date. If the current period contains start date of

the fiscal year, it will start accumulating again from scratch.

It is one of the most reused calculations in business and is extremely time-consuming to constantly re-script.

Formula

Year to Date = Sum of original data from the start of the fiscal year.

Signature

Input Tables

Table 122:


umns


Sales Input Table 1 Double SALES The original series

Start Date Input Table 1 Double STARTDATE The date used to

start to calculate

Output Table

Table 123:


umns


Result Output Table 1 Double YEARTODATE Year to date result

(Year To Date

Sales)

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_YDT_SALES_TBL ;CREATE COLUMN TABLE BFL_YDT_SALES_TBL ( "SALES" DOUBLE );

154

P U B L I C



BFL Functions



INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;

INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;INSERT INTO BFL_YDT_SALES_TBL VALUES (1000) ;DROP TABLE BFL_YDT_STARTDATE_TBL ;CREATE COLUMN TABLE BFL_YDT_STARTDATE_TBL ( "STARTDATE" DOUBLE );INSERT INTO BFL_YDT_STARTDATE_TBL VALUES (4) ;DROP TABLE BFL_YDT_RESULTS_TBL ;CREATE COLUMN TABLE BFL_YDT_RESULTS_TBL ("YEARTODATE" DOUBLE); CALL _SYS_AFL.AFLBFL_YEARTODATE_PROC(BFL_YDT_SALES_TBL, BFL_YDT_STARTDATE_TBL,BFL_YDT_RESULTS_TBL) WITH OVERVIEW;

SELECT * FROM BFL_YDT_RESULTS_TBL ;

3.54 Year-to-Date Statistical

This function is used to calculate the original series by the year-to-date values input. This is a critical planning

function for spreading, target seeking and so on.

Formula

Original, Period n = (Year to Date Value, Period n) - (Year to Date Value, Period n-1)

At the first period of the fiscal year, use the below formula:

Original, Period 1 = Year to Date value, Period 1

Signature

Input Tables

Table 124:


umns


Year to Date Ser

ies

Input Table 1 Double YEARTODATES

ERIES

Accumulated total

(Year to Date

Sales)

Start Date Input Table 1 Int STARTDATE The date used to

start to calculate

Output Table


BFL Functions

P U B L I C




Table 125:


umns


Result Output Table 1 Double ORIGINAL Original Series

Example

Assume that:




SET SCHEMA BFL_TEST; DROP TABLE BFL_YTDS_SALES_TBL;CREATE COLUMN TABLE BFL_YTDS_SALES_TBL( "YEARTODATESERIES" DOUBLE );INSERT INTO BFL_YTDS_SALES_TBL VALUES (1000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (2000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (3000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (2000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (4000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (6000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (8000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (10000);INSERT INTO BFL_YTDS_SALES_TBL VALUES (12000);DROP TABLE BFL_YTDS_STARTDATE_TBL;CREATE COLUMN TABLE BFL_YTDS_STARTDATE_TBL( "STARTDATE" INT);

INSERT INTO BFL_YTDS_STARTDATE_TBL VALUES (3);DROP TABLE BFL_YTDS_ORIGINAL_TBL;CREATE COLUMN TABLE BFL_YTDS_ORIGINAL_TBL( "ORIGINAL" DOUBLE); CALL _SYS_AFL.AFLBFL_YEARTODATESTATISTICAL_PROC(BFL_YTDS_SALES_TBL,BFL_YTDS_STARTDATE_TBL, BFL_YTDS_ORIGINAL_TBL) WITH OVERVIEW; SELECT * FROM BFL_YTDS_ORIGINAL_TBL;

156

P U B L I C



BFL Functions



Important Disclaimers and Legal Information

Coding Samples

Any software coding and/or code lines / strings ("Code") included in this documentation are only examples and are not intended to be used in a productive system

environment. The Code is only intended to better explain and visualize the syntax and phrasing rules of certain coding. SAP does not warrant the correctness and

completeness of the Code given herein, and SAP shall not be liable for errors or damages caused by the usage of the Code, unless damages were caused by SAP

intentionally or by SAP's gross negligence.

Accessibility

The information contained in the SAP documentation represents SAP's current view of accessibility criteria as of the date of publication; it is in no way intended to be

a binding guideline on how to ensure accessibility of software products. SAP in particular disclaims any liability in relation to this document. This disclaimer, however,

does not apply in cases of wilful misconduct or gross negligence of SAP. Furthermore, this document does not result in any direct or indirect contractual obligations of

SAP.

Gender-Neutral Language

As far as possible, SAP do cumentation is gender neutral. Depending on the context, the reader is addressed directly with "you", or a gender-neutral noun (such as

"sales person" or "working days") is used. If when referring to members of both sexes, however, the third-person singular cannot be avoided o r a gender-neutral noun

does not exist, SAP reserves the right to use the masculine form of the noun and pronoun. This is to ensure that the documentation remains comprehensible.

Internet Hyperlinks

The SAP documentation may contain hyperlinks to the Internet. These hyperlinks are intended to serve as a hint about where to find related information. SAP does

not warrant the availability and correctness of this related information or the ability of this information to serve a particular purpose. SAP shall not be liable for any

damages caused by the use of related information unless damages have been caused by SAP's gross negligence or willful misconduct. All links are categorized for

transparency (see: http://help.sap.com/disclaimer).


Important Disclaimers and Legal Information

P U B L I C


http://help.sap.com/disclaimer/

http://help.sap.com/disclaimer/



www.sap.com/contactsap

http://www.sap.com/contactsap

sap hana business function library bfl en

Documents