EHS_MD_135_04 - Extend Entry in Secondary Data DeterminationGeneral Data in Customer Master Vendor Master (General Section)
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:
- 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.
- In Customizing for Basic Data and Tools, call the IMG activity Manage User Exits.
- Create a new user exit of the user exit category SUB_SEDACA. To do so, use the reference modules as a copy template.
- 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:
- 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.
- 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.
- 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
- 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.
- In this example, the system reads all data records that are valid in the EU but not in Germany.
- In this example, the system writes all data records that are valid both for the EU and for the United States.
- Data origin that must be created in the IMG activity Specify Data Origin. If no data origin is created, the system issues an error.
- 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:
- 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.
- 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.
- 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.
- Determines the number of data records that are not deleted for save mode C, but are set to inactive.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- If you set this indicator, you will be prompted in a dialog box when the Expert is to start as a background job.
- 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.
- Enter one of the following values for writing messages to the application log:
|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:
- 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.
- 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:
- 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.
- 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.
- 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.
- If you want to prevent Expert or OCC from reading or writing Unicode data, set the parameter to X.
|Environment parameter||Sample value|