1
Daniel Chang
PC 10.0 Process
Control – Continuous
Monitoring Framework
Continuous Monitoring Framework –
BRF+
Take-Over Document
Date: Nov 22, 2011
Location: Palo Alto
Continuous Monitoring Framework – BRF+
Content:
1 Specification of functionality ........................................................................................ 3
1.1 Business Logic............................................................................................... Error! Bookmark not defined.
1.2 Examples ........................................................................................................ Error! Bookmark not defined.
2 Design of functionality ....................................................... Error! Bookmark not defined.
2.1 Flow logic........................................................................................................ Error! Bookmark not defined.
2.2 Technical information .................................................................................... Error! Bookmark not defined.
2.2.1 List of transaction codes .......................................................................... Error! Bookmark not defined.
2.2.2 List of WebDynpro applications/components/views ................................ Error! Bookmark not defined.
2.2.3 List of ABAP programs: class, interface, reports, includes ..................... Error! Bookmark not defined.
2.2.4 List of function groups and modules ....................................................... Error! Bookmark not defined.
2.2.5 Important methods .................................................................................. Error! Bookmark not defined.
2.2.6 List of database tables ............................................................................ Error! Bookmark not defined.
2.2.7 List of notes and customer-specific corrections ...................................... Error! Bookmark not defined.
2.2.8 List of help-programs............................................................................... Error! Bookmark not defined.
2.3 Important hints ............................................................................................... Error! Bookmark not defined.
3 Other sources of information and links............................ Error! Bookmark not defined.
Take-Over Document Page 2
Continuous Monitoring Framework – BRF+
2 Specification of functionality
2.1 Business Logic
Describe the function from the business perspective in your own wording. The focus is mainly on the end
user perspective.
GRC 10 uses BRF+, the standard Netweaver rule engine, to let users define additional filters and
calculations. You can configure very powerful processing using this rule engine, and our goal was to make it
easy to configure relatively simple rules (calculate an average of two fields, say, or compare two dates), and
yet provide a path to configure more complex rules if that is your need.
BRFplus information center:
http://www.sdn.sap.com/irj/sdn/index?rid=/webcontent/uuid/90754865-f283-2b10-6d9f-b10f3c28c3a0
BRFplus is used in Configurable Business rule, BI Query, SAP Query and Event.
BRFplus functions in PC10.0 Business Rules:
Additional Filter
Field Value Calculation
Pattern
Currency Conversion
Grouping/Aggregation
Send Notification
Trigger AM Job
Take-Over Document Page 3
Continuous Monitoring Framework – BRF+
2.2 Examples
Specify system access and global parameters, which you usually use for testing the program. This should
also contain the example data, customizing data and also the data, which is posted to the system.
Description
2.2.1 Additional Filter
„Additional Filter‟ is opitional
„Additional Filter‟ is used to get qualified data based on user entry in BRFplus formula
st
„Additional Filter‟ will be always placed in the 1 BRFplus function.
Take-Over Document Page 4
Continuous Monitoring Framework – BRF+
Select BRFplus object name (Field Name) to be compared with another BRFplus object names or use
existing formula button to create additional formula to check against BRFplus object names. You can create
complex Additional Filter logics using existing BRFplus object names and formula buttons as long as long as
there is no error found when click button „Check Syntax‟.
Click button „Check Syntax‟ to make sure no errors found in formula entry.
During Business Rule execution time, if the data does not match the additional filter condition, then this
record will be ignored.
2.2.2 Field Value Calculation
Take-Over Document Page 5
Continuous Monitoring Framework – BRF+
„Field Value Calculation‟ is used to assign value to specific „Calculated Field‟. The value can come from
single BRFplus object name or multi BRFplus object name with operation (i.e +, -, ..) or use formula button
to create more complex value.
For a “calculated field” deficiency (above), this tab lets you define the calculation necessary to compute its
value.
The “Calculations” tab (or corresponding wizard step when creating the rule) allows three types of
calculations: A Field Value calculation, a currency conversion, or grouping and aggregation (see screenshot
below).
Take-Over Document Page 6
Continuous Monitoring Framework – BRF+
2.2.3 Pattern
Take-Over Document Page 7
Continuous Monitoring Framework – BRF+
Select View to analysis
Select fields to analysis
Take-Over Document Page 8
Continuous Monitoring Framework – BRF+
Enter decision table contents to analyzie deficiency
Take-Over Document Page 9
Continuous Monitoring Framework – BRF+
Take-Over Document Page 10
Continuous Monitoring Framework – BRF+
3 Design of functionality
3.1 Flow logic
Describe the main logical flow in the program to help with analysis of the code, especially parts which have
been error prone in the past.
3.2 Technical information
BRFplus information center:
http://www.sdn.sap.com/irj/sdn/index?rid=/webcontent/uuid/90754865-f283-2b10-6d9f-b10f3c28c3a0
BRFplus is used in Configurable Business rule, BI Query, SAP Query and Event.
BRFplus application name for Business Rule: GRFN_AM_RUNTIME
BRFplus functions and related components (Data Element, Expression, Function..) will be automatically
generated from Web Dynpro GRFN_AM_UIBB_BRFP_INT methods using AMF and BRFplus standard APIs
and is ready to be used.
User could configure more complex Additional Filter and Field Value Calculation in BRF+ formula only. But, it
is not recommended and should avoid to modify value in BRF+ directly if it is possible. Modify the rest of
BRF+ components (i.e Input, Output structure, Rule, Loop, Expression.....) are not allowed and will cause the
Busines Rule out of sync between BR BRF+ components and BRF+ workbench components and cannot be
executed.
Take-Over Document Page 11
Continuous Monitoring Framework – BRF+
BRFplus ABAP Types
The elementary internal BRFplus ABAP types can be found via the interface IF_FDT_TYPES:
ELEMENT_BOOLEAN
ELEMENT_CURRENCY (component of ELEMENT_AMOUNT)
ELEMENT_NUMBER
ELEMENT_TEXT
ELEMENT_UNIT (component of ELEMENT_QUANTITY)
ELEMENT_AMOUNT
ELEMENT_QUANTITY
ELEMENT_TIMEPOINT
Take-Over Document Page 12
Continuous Monitoring Framework – BRF+
Take-Over Document Page 13
Continuous Monitoring Framework – BRF+
Syntax Description Type Declaration Syntax Example Values
TEXT Data lv_text_elt TYPE lv_text_elt = ‘Sample Text’
if_fdt_types=>element_text
NUMBER Data lv_num_elt TYPE
lv_num_elt = 1234
if_fdt_types=>element_number
BOOLEAN Data lv_bool_elt TYPE
lv_bool_elt = ‘X’ (ABAP_TRUE)
if_fdt_types=>element_boolean
AMOUNT Data ls_amount_elt TYPE
ls_amount_elt‐number = 1000
if_fdt_types=>element_amount
ls_amount_elt‐currency = ‘USD’
=> 1000 USD
QUANTITY Data ls_quantity_elt TYPE
ls_quantity_elt‐number = 100
if_fdt_types=>element_quantit
y ls_amount_elt‐unit = ‘cgm’
=> 100 centigram
TIMEPOINT Data ls_timept_elt TYPE
ls_ timept_elt‐date =
if_fdt_types=>element_timepoi
‘20081224’
nt
=> 24th of Dec 2008.
The following table Element Type Max Length Max Number Only Positive Timepoint
describes which element of Decimals Values Type
type is created according to
the supplied DDIC type:
DDIC Type
Char Text 1-255 n/a n/a n/a
String Text 255 n/a n/a n/a
Numc Text 1-255 n/a n/a n/a
Int1 Number 1-3 0 Yes n/a
Int, int4 Number 10 0 No n/a
Int2 Number 5 0 No n/a
Packed Number 1-31 10 No n/a
Float Number 16 10 No n/a
Decfloat16 Number 16 10 No n/a
Decfloat34 Number 31 10 No n/a
Date Timepoint n/a n/a n/a Date
Time Timepoint n/a n/a n/a Time
Timestamp (!) Timepoint n/a n/a n/a UTC
Timestamp
Take-Over Document Page 14
Continuous Monitoring Framework – BRF+
BRFPlus Object Types used in Business Rule – Automatically generated
Take-Over Document Page 15
Continuous Monitoring Framework – BRF+
3.2.1 List of transaction codes
Write down the transaction codes, which are used to run or customize the functionality.
Transaction Code Description
BRF+ BRFplus workbench
GRFN_AMF_FDT_EXPORT Export BRFplus XML for Business Rule
GRFN_AMF_FDT_IMPORT Import BRFplus XML for Business Rule
3.2.2 List of WebDynpro applications/components/views
Specify the list of WebDynpro applications/components/views. Do not forget to add short description of them,
containing the most difficult or problematic parts, etc.
WebDynpro Description
GRFN_AM_UIBB_BRFP_INT BRFplus Integration
V_ADDITIONAL_FILTER Additional Filter and Field Calculation
V_BRFP_FUNC Create Condition, Calculation, and Pattern BRFPlus functions
V_DEF_HANDLERS Select View to retrieve data
V_INPUT_BRFP_DATA Input BRFplus formula data
V_PATTERN Pattern Bisiness Rule
3.2.3 List of ABAP programs: class, interface, reports, includes
Specify the list of ABAP reports and includes. Do not forget to add short description of them, containing the
most difficult or problematic parts, etc.
Program Description
GRFN_AM_FDT_XML_EXPORT Export BRFplus XML for Business Rule
GRFN_AM_FDT_XML_IMPORT Import BRFplus XML for Business Rule
3.2.4 List of function groups and modules
Specify the list of function groups and modules. Please give the details desription for each function modules.
3.2.5 Important methods
Specify details description for each important medthod. And please list the name of the important methods
which are used in the area too.
Class: CL_GRFN_AM_BRFP
ADD_EXCEPT_ATTRS_ELEMENT Add exception list special attribute to context and result
Take-Over Document Page 16
Continuous Monitoring Framework – BRF+
CHECK_ACTION_NAME Check action name follow the standard
CHECK_DT_ACTION_ENTERED Check DT Action entered
CHECK_RULE_DEEP Deep Check Active BRF function, so can be transported
CHECK_SPECIAL_TOKEN check Formula Tokens
CHECK_SYSTEM_NAME_SPACE Check system name space
CONSTRUCTOR CONSTRUCTOR
CONVERT_ABAPTYPE_TO_DDTYPE Convert ABAPTYPE to DDTYPE
CONVERT_INT_TO_EXT Convert internal to external representation
CONVERT_INT_TO_EXT_QUANTITY Convert quantity to external (text) format
CREATE_ACT_CALL_PROCEDURE Create call procedure
CREATE_APPLICATION Create Application - Test only !!!
CREATE_CALC_DEF_RULE_EXP Create calculation deficiency Rule expression
CREATE_CALL_PROCEDURE Create call procedure
CREATE_CONSTANT Creat constant timepoint
CREATE_DATA_OBJECTS Create data objects - used to create 1st BR function
CREATE_DATA_OBJECTS_AGAIN Create data objects - except for the 1st BR function
CREATE_DDIC_STRUCTURE Create contxet parameter using DDIC definition
CREATE_DT_EXPRESSION Create decision table expression
CREATE_ELEMENT Create element
CREATE_FORMULA Creat formula with empty formula
CREATE_LOOP_EXPRESSION Create Loop expression
CREATE_RULE_EXPRESSION Create Rule expression
CREATE_TRIGGER_ACT_RULE_EXPR Create EVENT Rule expression
DELETE_RULE Delete BRF function
DEQUEUE_DT_ID Deque Decision Table ID
DEQUEUE_EXPRESSION_ID Deque Expression ID
DEQUEUE_FUNCTION_ID Deque BRFplus Function ID
EXECUTE_RULE Execute Function
GET_APPLICATION Get Application detail - transport...
GET_APPLICATION_DATA Get Application data
GET_APPL_FUNCTION_ID Get ID for specific function and application combination
GET_BR_FIELDS_DT_COLUMNS Get BR fields Decision Tables columns
Get number of decimals for currency (TCURX), default 2 -
GET_CURRENCY_DECIMALS new
GET_DATA_OBJECT_TYPE Get Object and Data Object Type
GET_DECISION_TABLE_COLUMNS Get Decision Tables columns
GET_DECISION_TABLE_DATA Get Decision Table Data - Action ID in Decision table
GET_DECISION_TABLE_ID Get Decision Table Object ID
GET_FIELDS_LIST Get input context elements
GET_FORMULA_ID Get formula Id
GET_ID Get Object ID
GET_INPUT_DATAOBJ_LAYOUT Get function input/output layout
GET_INSTANCE Get Instance
GET_NAME Get Name and related data object information
MODIFY_DECISION_TABLE_COLUMNS Modify Decision Tables columns
RAISE_ERROR Set error message
Take-Over Document Page 17
Continuous Monitoring Framework – BRF+
RAISE_EXCEPTION Exception
READ_SYSTEM_PARAMS Read System Installation
RETRIEVE_RULE Retrieve function and Formula
RETRIEVE_RULE_NORMAL_MODE Retrieve function and Formula - Normal Mode
SAVE_ACTION Save BRF Action
SAVE_DELETE_RULE Save BRF deleted function
SAVE_DT_CONTENT Save decision table content
SAVE_RULE Save BRF function
SET_AM_NAME Set Table/Structure/Expression name
SET_DECISION_TABLE_DATA Set decision table data
SET_ELEMENT_DATATYPE Set data type
Set new functionm name to generated new version brfplus
SET_NEXT_FUNCTION_NAME func
SET_EVENT_DECISION_RESULT Set the Event decision table result
SET_PATTERN_DECISION_RESULT Set the Pattern decision table result to abap_true
SET_TEXT Set text
SUBSTITUTE_STRINGS Parse string to FDT UUID code - Internal format
SUBSTITUTE_STRINGS_FDTNAME Parse string to FDT Name - External format
UPDATE_RULE Update BRF function and formula
VALIDATE_RULE Validate BRF function
Class: CL_GRFN_BRFP_ADDITIONAL_FILTER Additional Filter Function
IF_GRFN_BRFP~EXECUTE Execute function, this method must be static
IF_GRFN_BRFP~CREATE_FUNCTION Create
IF_GRFN_BRFP~CREATE_FUNCTION_AGAIN Create new function ID due to formula change
Class: CL_GRFN_BRFP_CALC_DEF Calculating Deficiency Function
IF_GRFN_BRFP~EXECUTE Execute function, this method must be static
IF_GRFN_BRFP~CREATE_FUNCTION Create
IF_GRFN_BRFP~CREATE_FUNCTION_AGAIN Create new function ID due to formula change
Class: CL_GRFN_BRFP_PATTERN Pattern Function
IF_GRFN_BRFP~EXECUTE Execute function, this method must be static
IF_GRFN_BRFP~CREATE_FUNCTION Create
IF_GRFN_BRFP~CREATE_FUNCTION_AGAIN Create new function ID due to formula change
Class: CL_GRFN_AM_BRFP_UI_MODE – Set BRFplus UI in Edit Mode
IF_FDT_WD_UI_MODE~GET_CONFIGURATION Returns the configuration
IF_FDT_WD_UI_MODE~GET_DESCRIPTION Returns the description for the mode
IF_FDT_WD_UI_MODE~GET_NAME Returns the name of the mode
IF_FDT_WD_UI_MODE~GET_UI_CONTEXT Returns the UI Context
CONSTRUCTOR CONSTRUCTOR
Class: CL_GRFN_AM_BRFP_UI_MODE _DISPLAY - Set BRFplus UI in Display Mode
Take-Over Document Page 18
Continuous Monitoring Framework – BRF+
IF_FDT_WD_UI_MODE~GET_CONFIGURATION Returns the configuration
IF_FDT_WD_UI_MODE~GET_DESCRIPTION Returns the description for the mode
IF_FDT_WD_UI_MODE~GET_NAME Returns the name of the mode
IF_FDT_WD_UI_MODE~GET_UI_CONTEXT Returns the UI Context
CONSTRUCTOR CONSTRUCTOR
3.2.6 List of database tables
Specify the list of ABAP database table. Do not forget to add short description of them.
ID Description
GRFNBRFPATTRS BRFPlus - Exception function attribute fields
GRFNBRFPFUNC BRF Plus Function Type
HRP5350 BRF Plus Function
Take-Over Document Page 19
Continuous Monitoring Framework – BRF+
3.2.7 List of notes and customer-specific corrections
ID Description
1584124 Missing BRF+ fields when create Calculated fields
1586597 Missing BRF+ fields when create Calculated fields
1588564 Re-create BRF+ Application Name & ID
1519164 Create BRF+ application name & ID for Co
Take-Over Document Page 20
Continuous Monitoring Framework – BRF+
Since the BRFplus application name must be unique to import BRFplus
contents from source system to target system, so we need to create same
BRFplus application name and application id in all enviroments first.
Other terms
In case this note was not applied right after installation and the
Business Rule was created, then please use note 1588564 to install PC
10.0 BRF+ Application ID and Name.
Solution
Create Continuous Monitoring application ID for application name
'GRFN_AM_RUNTIME'.
This application id will be used to create BRFplus function in
Continuous Monitoring Business Rule processing.
The BRFplus application name and id must be created in installation
stage.
Please use attached file 'GRFN_AM_RUNTIME_BRF_APPL_ID.xml' to create
Continuous Monitorin BRFplus Application ID.
Take-Over Document Page 21
Continuous Monitoring Framework – BRF+
3.2.8 List of help-programs
Describe the programs, which help you analyze or correct errors. In case the program is a local object please
specify the name and system also.
3.3 Important hints
Give any hints and describe procedures which might be important:
transaction codes to analyze the functionality or debug the program
ok-codes to be used in debugger
other involved persons and contacts for SAP tools, etc.
4 Other sources of information and links
BRFplus information center:
http://www.sdn.sap.com/irj/sdn/index?rid=/webcontent/uuid/90754865-f283-2b10-6d9f-b10f3c28c3a0
4.1 Transfer BR BRF+ components to target system
1. BRF+ application name and ID must be transfered first in all systems.
Use the attachments of Notes 1588564 or 1519164 to create BR BRF+ Application name and
Application ID in all systems.
The Application name must be GRFN_AM_RUNTIME
The Application ID must be 80E0ED08B0561DEF92B59B6E451DCE60
Take-Over Document Page 22
Continuous Monitoring Framework – BRF+
2. Use the following two programs to transfer the rest of BR BRF+ components to target systems
Run program GRFN_AM_FDT_XML_EXPORT to export Source systemBRF+ components
Run program GRFN_AM_FDT_XML_IMPORT to import BRF+ components to target system
4.2 Find Corresponding BR Condition and Calculation functions in
BRF+ workbench
Application name: GRFN_AM_RUNTIME
Take-Over Document Page 23
Continuous Monitoring Framework – BRF+
BRFPlus Object Types used in Business Rule – Automatically generated
Take-Over Document Page 24
Continuous Monitoring Framework – BRF+
Sample BRF+:
Business Rule: BR/90001197
You could find the corresponding BRFplus function in tcode BRF+ by following steps.
(1) Go to tcode BRF+
(2) Click Advance Search button
Enter Object Type: Function
Object Name: BR90001197*
Click search button
Take-Over Document Page 25
Continuous Monitoring Framework – BRF+
This is BRFplus function for Business Rule BR/90001197
Input and Output Structure from Business Rule:
Take-Over Document Page 26
Continuous Monitoring Framework – BRF+
Take-Over Document Page 27
Continuous Monitoring Framework – BRF+
Take-Over Document Page 28
Continuous Monitoring Framework – BRF+
Amount Samples:
Take-Over Document Page 29
Continuous Monitoring Framework – BRF+
Main Expression:
Take-Over Document Page 30
Continuous Monitoring Framework – BRF+
Take-Over Document Page 31
Continuous Monitoring Framework – BRF+
Simulation:
Take-Over Document Page 32
Continuous Monitoring Framework – BRF+
Take-Over Document Page 33
Continuous Monitoring Framework – BRF+
Another sample simulation with Data exist
Take-Over Document Page 34
Continuous Monitoring Framework – BRF+
Take-Over Document Page 35
