Show TOC

Importing BAPI Wrappers as Data ObjectsLocate this document in the navigation structure

Use

BAPI wrappers can exist in the back-end systems connected to the Data Orchestration Engine (DOE). You can import existing BAPI wrapper definitions from the back-end system to the DOE and create data objects that map these definitions.

The type of BAPI wrappers that can be imported are GetDetail , GetList or Create . The DOE creates the root nodes and the child nodes based on the type of BAPI wrappers. The following table lists the nodes created for the various types of BAPI wrappers:

BAPI Wrapper Type

Root Node

Child Nodes

GetDetail

Export parameter

Table parameters

GetList

Table parameter

N/ A

Create

Import parameters

Table parameters

If a BAPI wrapper has multiple types defined, the DOE selects a type based on the order shown in the table above, with GetDetail as the first selection. Additionally, when you import the BAPI wrappers, the back-end adapters are created automatically.

After you import the BAPI wrappers as data objects, you can have the following situations:

  1. You modify the BAPI wrappers in the back-end system.

    If you modify the BAPI wrappers after importing them as data objects, you must adjust the data objects and the back-end adapters, accordingly.

  2. You cannot activate the data objects because the node names start with a number.

    Note

    In the back-end system, BAPI wrappers can be stored with structure names that begin with a number. When these BAPI wrappers are imported, the data object nodes are stored with the same name. However, you cannot activate these data objects. After importing the BAPI wrappers as data objects, you must rename the nodes to start with a letter.

    This is because when you activate a data object, its data is converted into an XML format by the Extensible Stylesheet Language Transformations (XSLT) processor. The XSLT standard states that node names cannot start with a number and therefore the data objects are not activated. So, the node names must be renamed to start with a letter.

    Steps for these two situations are also provided in the procedure.

Prerequisites

You have created a software component version (SWCV) to store the data objects.

Procedure

Importing BAPI Wrappers as Data Objects

  1. Log on to the SAP NetWeaver AS.

  2. In the Navigation pane, choose Start of the navigation path Data Orchestration Engine  Next navigation step Development  Next navigation step  Data Orchestration Workbench End of the navigation path.

  3. Click the SWCV that you want to use with the secondary mouse button and choose Start of the navigation path Import Next navigation step BAPI Wrapper as Data Object End of the navigation path.

  4. Enter the required details.

  5. On the Import BAPI Wrapper as Data Object tab page, enter the required details.

    Note

    On the Customize Node Relationship tab page, you can modify the node hierarchy.

  6. Choose Save .

Note

In the root node, the workbench automatically sets the key field indicator for attributes that are back-end key fields. However, if you have key fields in child nodes of a data object, you must manually set the BE Key indicator for the child node attributes.

More information on how to set the BE Key: Defining Data Object Node Attributes

Adjusting Data Objects and Back-End Adapters

  1. Select the back-end adapters for the BAPI wrappers.

  2. Choose Change .

  3. Choose Adjust Adapter and Data Object .

    After you have imported the BAPI wrappers as a data object, you must manually select the back-end key fields ( BE Key checkbox) for all the child nodes of the data object.

Renaming and Activating Data Object Nodes That Start with a Number

  1. Choose the node, whose name starts with a number, and from the menu choose Start of the navigation path Data Object  Next navigation step  Display<->Change End of the navigation path.

  2. Double-click the back-end adapter and choose the Mapping Tool tab.

  3. Select the node and its mapped BAPI wrapper structure.

  4. To remove the mapping for the node, select all the fields for the node and choose Undo Selected Mapping .

  5. Choose Save .

  6. Choose Start of the navigation path Data Object  Next navigation step  Display<->Change End of the navigation path.

  7. In the node details area, rename the data object node.

    Note

    Node names must start with a letter. If you want to retain the number in the node name, you could place the number after a letter. For example, you can rename the node name 1_payroll to payroll_1 .

  8. To activate the data object, click the data object with the secondary mouse button and choose Activate .

  9. Double-click the back-end adapter and choose the Mapping Tool tab.

  10. To map the nodes to the BAPI wrapper fields, select all the structure fields and choose Map Selected Fields .

  11. To activate the adapter, select the back-end adapter with the secondary mouse button and choose Activate .