Hierarchy
SAP_APPL (Software Component) Logistics and Accounting⤷
CA (Application Component) Cross-Application Components⤷
ISX_MD (Package) Master Data Replication for Cross Billing
IMG Activity
| ID | ISXVC_SEARCH_ADP | Assign Replication Objects, Search Attributes, and Scenarios |
| Transaction Code | S_EBS_44000214 | (empty) |
| Created on | 20101112 | |
| Customizing Attributes | ISXVC_SEARCH_ADP | Assign Replication Objects, Search Attributes, and Scenarios |
| Customizing Activity | ISXVC_SEARCH_ADP | Assign Replication Objects, Search Attributes, and Scenarios |
Document
| Document Class | SIMG | Hypertext: Object Class - Class to which a document belongs. |
| Document Name | ISXVC_SEARCH_ADP |
Use
In this Customizing activity you define replication objects and assign search attributes you want to use for the read adapters.
Define Replication Object
A replication object represents the object that is to be distributed between one or more systems or is to be read by these systems. A replication object usually corresponds to a business object, such as contract object or the business partner. When you define the replication object, you make all of the central settings that control data replication. These are as follows:
- Query structure: Structure for reading data using a query. The attributes recorded in this structure are also used to define the search attributes and the adapters assigned to them.
- Maintain structure: Structure used to distribute data (create new data or change data).
- Replication object key fields (structure)
- Handler class: Class in which the methods for data distribution are implemented (or redefined). This class must be derived from the class Common Object Layer Framework (CL_ISX_MD_COL_FRAMEWORK ).
- Data buffer table type: Internal table type used to buffer data during the replication transaction.
Define Search Attributes for Read Adapter (Primary Read Adapter)
In the case of read accesses of the adapter to several systems, you can define an adapter that is executed before all other read adapters. You can specify this on an individual basis for each search attribute. This setting takes account of the fact that a specific system for which the adapter is responsible may contain attributes that do not exist in any other system. This can also have a positive effect on performance if you first define an attribute in a specific system before calling the other adapters.
If for example the attribute Telephone Number is only available in an external system but not in an internal system, you can use the primary adapter and the search attribute Telephone Number to first access the external system to read the data and then use the values returned (such as the contract number) to search in additional systems (for example for contract data and/or business partners) if necessary.
If you use several scenarios for data replication, only one read adapter from each scenario can be used as primary adapter.
You can use the priority to define the sequence in which search attributes are run. The system runs the first search attribute by entering the relevant search content when the read transaction is executed. It does not execute any other search attributes with a lower priority.
The system executes all assigned read adapters in the defined sequence for the first search attribute found with the highest priority.
Assign allowed Scenarios
Data can only be replicated to or from a system if a scenario is assigned to the replication object. The scenario enables you to handle multiple configurations of the the data distribution to several systems. The scenario that you define as the default scenario does not require a BadI implementation for scenario determination. The system selects it automatically if data is replicated. If you want to use a scenario that is not the default scenario, you must create an implementation for BAdI ISX_MD_COL_SCENARIO.
Requirements
You have already defined adapters in SAP Customizing under Define Adapter for Data Replication.
You have already defined scenarios in SAP Customizing under Define Scenario for Contract Distribution.
Standard settings
SAP supplies the following replication objects with their search attributes in the standard system:
Replication Object Description
CI_BDR CI-Billing Detail Record
CI_INVOICE CI-Invoice
PRV_CTR Provider Contract
Activities
Define Replication Object
Define the technical name and the name of the replication object and attributes required by the replication object to control data distribution or reading.
Define Search Attributes for Read Adapter (Primary Read Adapter)
- Select a replication object for which you want to define search attributes.
- Define the search attributes that are to be evaluated as selection criteria during the read transaction. You can access the search attributes that are supported by the respective replication object using the possible entries for the Search Attribute field. These are the attributes that have been recorded in the query structure for the selected replication object.
You can add your own attributes to the search attributes in existing query structures using an Append. You can also choose not to use the assigned structures and instead record your own structures that you define in the replication object.
You must define a unique priority for a search attribute that you create, which the system uses to evaluate the attribute for the search. - Define all read adapters for a search attribute that are to be evaluated for this selection criterion. The system executes the read adapters in the defined sequence. You can only use adapters that have been defined as read adapters.
Example
Business Attributes
| ASAP Roadmap ID | 204 | Establish Functions and Processes |
| Mandatory / Optional | 2 | Optional activity |
| Critical / Non-Critical | 2 | Non-critical |
| Country-Dependency | A | Valid for all countries |
Assigned Application Components
| Documentation Object Class | Documentation Object Name | Current line number | Application Component | Application Component Name |
|---|---|---|---|---|
| SIMG | ISXVC_SEARCH_ADP | 0 | ABA0000111 | Data Transfer |
Maintenance Objects
| Maintenance object type | C | Customizing Object |
| Assigned objects | ||||||
|---|---|---|---|---|---|---|
| Customizing Object | Object Type | Transaction Code | Sub-object | Do not Summarize | Skip Subset Dialog Box | Description for multiple selections |
| ISXVC_SEARCH_ADP | C - View cluster | SM34 |
History
| Last changed by/on | SAP | 20110217 |
| SAP Release Created in | 606 |
