Daniel Chang PC 10.0 Process Control - Continuous Monitoring Framework

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

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

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.

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

„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).

2.2.3 Pattern

Select View to analysis
Select fields to analysis

Enter decision table contents to analyzie deficiency


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 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.

 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


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

 BRFPlus Object Types used in Business Rule – Automatically generated

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

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

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

Class: CL_GRFN_BRFP_PATTERN Pattern Function

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
Class: CL_GRFN_AM_BRFP_UI_MODE _DISPLAY - Set BRFplus UI in Display 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
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

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

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.

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

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

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

BRFPlus Object Types used in Business Rule – Automatically generated

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

This is BRFplus function for Business Rule BR/90001197
Input and Output Structure from Business Rule:



Amount Samples:

Main Expression:


Simulation:


Another sample simulation with Data exist


Daniel Chang PC 10.0 Process Control - Continuous Monitoring Framework

Enviado por

Dados do documento

Descrição original:

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Daniel Chang PC 10.0 Process Control - Continuous Monitoring Framework

Enviado por

Direitos autorais:

Formatos disponíveis

1

Continuous Monitoring Framework –

1 Specification of functionality ........................................................................................ 3

1.2 Examples ........................................................................................................ Error! Bookmark not defined.

2 Design of functionality ....................................................... Error! Bookmark not defined.

2.2 Technical information .................................................................................... 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

BRFplus information center:

BRFplus functions in PC10.0 Business Rules:

Take-Over Document Page 3

2.2.1 Additional Filter

„Additional Filter‟ is opitional

Take-Over Document Page 4

2.2.2 Field Value Calculation

Take-Over Document Page 5

Take-Over Document Page 6

Take-Over Document Page 7

Select View to analysis

Select fields to analysis

Take-Over Document Page 8

Enter decision table contents to analyzie deficiency

Take-Over Document Page 9

Take-Over Document Page 10

3.2 Technical information

BRFplus information center:

Take-Over Document Page 11

 BRFplus ABAP Types

Take-Over Document Page 12

Take-Over Document Page 13

Syntax Description Type Declaration Syntax Example Values

TEXT Data lv_text_elt TYPE lv_text_elt = ‘Sample Text’

NUMBER Data lv_num_elt TYPE

BOOLEAN Data lv_bool_elt TYPE

AMOUNT Data ls_amount_elt TYPE

TIMEPOINT Data ls_timept_elt TYPE

Take-Over Document Page 14

 BRFPlus Object Types used in Business Rule – Automatically generated

Take-Over Document Page 15

3.2.1 List of transaction codes

BRF+ BRFplus workbench

3.2.2 List of WebDynpro applications/components/views

GRFN_AM_UIBB_BRFP_INT BRFplus Integration

3.2.3 List of ABAP programs: class, interface, reports, includes

GRFN_AM_FDT_XML_EXPORT Export BRFplus XML for Business Rule

3.2.4 List of function groups and modules

3.2.5 Important methods

ADD_EXCEPT_ATTRS_ELEMENT Add exception list special attribute to context and result

Take-Over Document Page 16

CHECK_ACTION_NAME Check action name follow the standard

Take-Over Document Page 17

Class: CL_GRFN_BRFP_ADDITIONAL_FILTER Additional Filter Function

IF_GRFN_BRFP~EXECUTE Execute function, this method must be static

Class: CL_GRFN_BRFP_CALC_DEF Calculating Deficiency Function

Class: CL_GRFN_BRFP_PATTERN Pattern Function

Class: CL_GRFN_AM_BRFP_UI_MODE – Set BRFplus UI in Edit Mode

IF_FDT_WD_UI_MODE~GET_CONFIGURATION Returns the configuration

Class: CL_GRFN_AM_BRFP_UI_MODE _DISPLAY - Set BRFplus UI in Display Mode

Take-Over Document Page 18

IF_FDT_WD_UI_MODE~GET_CONFIGURATION Returns the configuration

3.2.6 List of database tables