Ansicht
Dokumentation

ISXVC_SEARCH_ADP - Assign Replication Objects, Search Attributes, and Scenarios

Vendor Master (General Section)   SUBST_MERGE_LIST - merge external lists to one complete list with #if... logic for R3up  
This documentation is copyright by SAP AG.

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

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.

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

PRV_CTR

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)

1. Select a replication object for which you want to define search attributes.
2. 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.
3. 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.

PRV_CTR

CL_GUI_FRONTEND_SERVICES - Frontend Services   PERFORM Short Reference  
This documentation is copyright by SAP AG.

Length: 6117 Date: 20240523 Time: 154136     sap01-206 ( 107 ms )