EHS_MD_135_04 - Extend Entry in Secondary Data Determination

General Material Data   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.

In this IMG activity, you create the entries for secondary data determination in user exit management that are required for the Expert.

The following reference modules are delivered with default settings for individual parameters:

• C1E5_SUB_EXPERT_EVALUATE
  C1R3_SUB_EXPERT_EVALUATE

Note:

To use the parameter EXPERT_PERFORM_DIFF_FLG, you must choose the reference module C1R3_SUB_EXPERT_EVALUATE. This allows you to compare the results of an Expert run before the output values are stored.

1. In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
2. Create a new user exit of the user exit category SUB_SEDACA. To do so, use the reference modules as a copy template.
3. Choose Parameters and Values. The following environment parameters must be set up for the reference modules C1E5_SUB_EXPERT_EVALUATE and C1R3_SUB_EXPERT_EVALUATE:

• EXPERT_COMMIT_MODE

Specifies the backup mode for secondary data determination by the Expert.

If you enter the value I, the SAP system creates the new data records that were determined by the Expert without changing other data records.

If you enter the value D, the SAP system deletes all the existing data records and creates the newly determined data. If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records are deleted that were determined during previous runs of the Expert. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter EXPERT_WRITE_OWNER), the SAP system recognizes which data was determined previously by the Expert.

Note:

If you enter the value C, the SAP system resets the active indicator for the newest of the data records and deletes all other existing ones. The number of data records to be deactivated can be derived from the parameter

EXPERT_NUM_OF_DEACT_VALUATIONS. The data records that were newly determined by the Expert are also created. If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records are deleted that were determined during previous runs of the Expert. This helps you prevent data records from being deleted inadvertently. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter EXPERT_WRITE_OWNER), the SAP system recognizes which data was determined previously by the Expert.

If you enter the value R, the SAP system deletes all the existing data records for which new data values were determined and creates the newly determined data. Header data for specifications with the exception of the identifiers is not deleted in this mode.

If the EXPERT_RES_BY_SRSID_OWNID_FLG parameter is set, then only those data records are deleted that were determined during previous runs of the Expert. Using the data origin (parameter EXPERT_WRITE_SOURCE_ID) and the data provider (parameter EXPERT_WRITE_OWNER), the SAP system recognizes which data was determined previously by the Expert.

• EXPERT_DESTINATION

Matches the name of the RFC destination that is entered under Tools -> Administration -> Administration -> Network -> RFC Destinations (transaction SM59) (see Set Up RFC Destination).

• EXPERT_READ_RATING and EXPERT_READ_VALIDITY_AREA

Determine the rating and validity area for which the data is transferred from the SAP system to the Expert.

• EXPERT_WRITE_RATING and EXPERT_WRITE_VALIDITY_AREA

Determine the rating and validity area with which the data determined is stored in the SAP system. In the Expert set of rules you can also specifically define a different rating and validity area that are used when storing data in the system.

• EXPERT_READ_USAGE_1...n and EXPERT_WRITE_USAGE_1...n

Note

In addition to the two previous parameter pairs, you can use the following parameters.

You can specify any number of usages in the format VACLID/RVLID/EXCLFLG (rating/validity/exclusion indicator). The numbering of the parameters must start with 1 and must be consecutive.

Examples

EXPERT_READ_USAGE_1:PUBLIC/REG_EU
EXPERT_READ_USAGE_2:PUBLIC/DE/X

In this example, the system reads all data records that are valid in the EU but not in Germany.

EXPERT_WRITE_USAGE_1:PUBLIC/REG_EU
EXPERT_WRITE_USAGE_2:PUBLIC/US

In this example, the system writes all data records that are valid both for the EU and for the United States.

• EXPERT_WRITE_SOURCE_ID

Data origin that must be created in the IMG activity Specify Data Origin. If no data origin is created, the system issues an error.

• EXPERT_RULE_SET

Set of rules according to which the data is determined.

The following environment parameters can be set up for the reference module C1E5_SUB_EXPERT_EVALUATE:

• DOCUMENTATION

In the specification workbench, you can display the documentation for a set of rules from the Determine Secondary Data dialog box. If documentation exists for a set of rules, an Information pushbutton is displayed beside the rule set. If you want to store documentation for a set of rules, specify the file name and path (in the company network) of the relevant documentation in the environment parameters.

• EXPERT_COMMIT_FLG

If you set this indicator to X, the system calls the update function specified in the parameter EXPERT_COMMIT_FUNCTION after the calculation is finished on the Expert server.

If you do not set this indicator, the Expert server calls the update function directly. In a productive system, we recommend that you set the indicator so that the Expert server is available again more quickly for other parallel calls. During development and testing it may be useful to not set the indicator, so that error messages from the update function are logged in the log files and so you have the option of displaying the runtime of the update function on the console or in the event display.

• EXPERT_COMMIT_FUNCTION

Update function, for example, C1E5_SUB_EXPERT_DATA_CHANGE that writes the data to the SAP system. The interface must match the update function C1E5_SUB_EXPERT_DATA_CHANGE supplied with the system. This allows you to modify the standard updating.

• EXPERT_NUM_OF_DEACT_VALUATIONS

Determines the number of data records that are not deleted for save mode C, but are set to inactive.

• EXPERT_PARAMETER_CHANGE_MODE

If you enter the value S (default), the SAP system displays the Determine Secondary Data dialog box in display mode when starting secondary data determination using the Expert.

If you enter the value E, you can revise the environment parameters in the Determine Secondary Data dialog box when starting secondary data determination using the Expert. The environment parameters set in Customizing are displayed as default values.

If you enter the value H, the SAP system does not display the Determine Secondary Data dialog box when starting secondary data determination using the Expert.

• EXPERT_RES_BY_SRSID_OWNID_FLG

Set this indicator if in backup modes C or D only data is to be deleted by the Expert that was determined during previous runs of the Expert.

Caution:

If you do not set this indicator, data that has also been entered manually or imported can be deleted in backup mode C or D by the Expert during secondary data determination.

• EXPERT_WRITE_OWNER

Data provider that you must have created in the SAP component Product Safety under Tools -> Addresses -> Edit Data Providers. The data provider must always be entered with 10 digits.

If you do not specify a data provider, the SAP system uses the authorization group for the specification to determine the respective data provider (see IMG activity Specify Authorization Groups). If the SAP system does not find any data providers there, it creates the data without a data provider.

• EXPERT_RULES_IN_R3_FLG

If you set this indicator, the Expert reads sets of rules from the SAP system as an alternative to locally stored files.

From the rule editor, you can save sets of rules in the SAP system.

• EXPERT_PERFORM_DIFF_FLG

If you set this indicator, you can obtain a comparison of the output values and results of the Expert run before the results are stored.

Note:

To be able to use the EXPERT_PERFORM_DIFF_FLG parameter, reference module C1R3_SUB_EXPERT_EVALUATE must be selected.

Take note of the options described in the documentation on the Expert to control the correct comparison of old and new data.

• EXPERT_PREVENT_DB_COMMIT_FLG

If you set this indicator, the data records are not written from the buffer to the database.

If you do not set this indicator, the content of the buffer is written to the database.

• EXPERT_HIDDEN_PROCESSING_MODE

You can choose between two operating modes:

ONLINE (default): The Expert run starts immediately after you choose Execute.

BACKGROUND: The Expert runs as a background job. The indicator for the EXPERT_ASK_FOR_STARTTIME parameter must be set for the start time prompt.

• EXPERT_ASK_FOR_STARTTIME

If you set this indicator, you will be prompted in a dialog box when the Expert is to start as a background job.

• EXPERT_ADD_PARAM_1...n

You can pass any number of parameters to the set of rules. This means you can make sets of rules configurable. In the set of rules you must create a fact for this purpose that is mapped to the external ID P:I_TAB_PARAMS in fact mapping.

• EXPERT_APPL_LOG_LEVEL

Enter one of the following values for writing messages to the application log:

Value	Description
0	Messages are not written to the application log.
1	Only error messages are written to the application log.
2	Error messages and warning messages are written to the application log.
3	All messages are written to the application log.

If you do not specify a value, no messages are written to the application log.

Some values are preset. Expert evaluates them itself and does not pass them to the set of rules:

• With the value LOGLEVEL = n, you can control the logging of the rule execution independently of the settings in the Windows registry of the Expert server PC (see Set Up Windows Registry). See the Activities section in the IMG activity Set Up Windows Registry for possible values for n.

• With the values RFCLOG = Y or RFCLOG = N, you can activate or deactivate the logging of data exchange independently of the settings in the Windows registry of the Expert server PC.

• With the value DEFCOMPCAT = , you can preset the component type for specification listings. If a set of rules writes data for specification listings, the problem exists that the component type field in the composition table ESTVP must be filled although it is neither relevant for specification listings nor does it appear on the interface. If no value is specified, ACT_AGENT is entered.

You set up the explanation component of the Expert using the following parameters:

• EXPERT_EXPLANATION_DISPLAY

If you set this parameter to X and allow the set of rules to run in the foreground, the system displays the explanation immediately after the set of rules run. For sets of rules that run in the background, the system does not display the explanation automatically.

• EXPERT_EXPLANATION_SAVE

Set this parameter to X if you want to save the explanation for the set of rules run in the specification. If you set the parameter to X, you must also edit the following parameters:

• EXPERT_EXPLANATION_ESTCAT

In the EXPERT_EXPLANATION_ESTCAT parameter, you specify the value assignment type in which the explanation is to be saved as a user-defined text. The standard version of the demo sets of rules contains the entry SAP_EHS_0101_002. This value assignment type is not in a property tree because the explanation is not displayed as a user-defined text but in the menu.

• EXPERT_EXPLANATION_RULE_PROP

In this EXPERT_EXPLANATION_RULE_PROP parameter, you specify the characteristic in which the name of the set of rules is saved to allow it to be assigned when displayed at a later stage. The characteristic must be in the same value assignment type as the user-defined text for the explanation. The standard version of the demo sets of rules contains the entry SAP_EHS_0101_002_RULESET.

Note: If you run a master data matchup, the system automatically appends a phrase set and a check module to the characteristic. You must remove this check module again.

• EXPERT_EXPLANATION_TEXTCAT

In this EXPERT_EXPLANATION_TEXTCAT parameter, you specify the user-defined text type with which the explanation is to be saved in the specification. The standard version of the demo sets of rules contains the entry EX.

• EXPERT_WRITE_RUN_DATE

Set this parameter to X if you want to save the date of the last calculation of this ruleset in the specification.

• EXPERT_EXPLANATION_DATE_PROP

In this parameter, you specify the characteristic in which the date of the last calculation is saved. The default characteristic is SAP_EHS_0101_002_RUN_DATE.

• EXPERT_PROHIBIT_UNICODE

If you want to prevent Expert or OCC from reading or writing Unicode data, set the parameter to X.

Example:

BAL Application Log Documentation   ABAP Short Reference  
This documentation is copyright by SAP AG.

Length: 21750 Date: 20220521 Time: 053207     sap01-206 ( 297 ms )

Environment parameter		Sample value
EXPERT_COMMIT_FLG		X
EXPERT_COMMIT_FUNCTION		C1E5_SUB_EXPERT_DATA_CHANGE
EXPERT_COMMIT_MODE		C
EXPERT_DESTINATION		EHS_EXPERT
EXPERT_NUM_OF_DEACT_VALUATIONS		2
EXPERT_PARAMETER_CHANGE_MODE		X
EXPERT_READ_RATING		PUBLIC
EXPERT_READ_VALIDITY_AREA		REG_WORLD
EXPERT_RES_BY_SRSID_OWNID_FLG		X
EXPERT_RULE_SET		EU_RULES
EXPERT_WRITE_OWNER		0000020546
EXPERT_WRITE_RATING		PUBLIC
EXPERT_WRITE_SOURCE_ID		EHS_EXPERT
EXPERT_WRITE_VALIDITY_AREA		REG_WORLD