Creating a BOL Object

Use

You use the Web service consumption tool to create a BOL component with a root BOL object and search objects. The tool is available in Customizing for Customer Relationship Management under Start of the navigation pathUI Framework Next navigation step UI Framework Definition Next navigation step Web Services Next navigation step Web Service Consumption Tool: Create BOL ObjectsEnd of the navigation path and provides the following options:

  • Create Component: Create new component.

  • Save: Save the current status of your work.

  • Delete: Delete a component from the list.

  • Check: Check the consistency of the names to ensure they are unique and check other settings that are required to successfully generate a component (see step 4 below).

  • Generate Component: Generate the component once the component settings are complete.

  • Transport: Trigger the transport of the objects.

  • Start Proxy Generation: Start the generation wizard.

  • Web Service Administration: Perform various administrative tasks, including logical port configuration.

  • Show Client Proxy: Display the details of the client proxy in the ABAP Workbench (from operation details screen).

Procedure

1. Create New Component

  1. Choose Create Component and enter the name of the component that you want to create, a prefix, and a description. The prefix is used to prefix the BOL object names and generated structures.

  2. Save your settings, select the entry, and go to the next level in the tree to select the operation.

2. Assign BOL Operation to Component

  1. Choose Create Operation to assign a BOL operation, for example, a search object type for queries, or read.

  2. Enter an object name, a proxy class, and proxy method that belongs to the specified class, and save your settings. You can create one or more query operations. Only one read operation is allowed per component.

    You can also copy and delete operations. Only query operations can be copied.

  3. Select an operation and choose Details to go to the next level.

3. Select Attributes

You select the attributes that are to be contained in the component you are creating. Choose Attribute Selection. The next screen shows all available input and output attributes in the form of a tree.

Make the following settings, as appropriate:

  • Designate the selected node as a key field

  • Explicitly set the selected node to “selected”

  • Designate the selected node as the entry point

  • Set a meaningful default value for the attribute, if you know that an attribute has a constant value (queries)

  • Specify a new name for the node (BOL field name or BOL object name)

Bear in mind that certain constraints apply when selecting attributes. These depend on the operation type, whether it is an input or output structure, and the level (element or structure). You have the following options:

  • Query input

    • Selected at element level

    • Default value at element level

    • BOL field name at element level

  • Query output

    • Key at element level

    • BOL field name at element level

    • Entry point at structure level

  • Read input

    • Key at element level

    • BOL field name at element level

  • Read output

    • Key at element level

    • Selected at element level

    • BOL field name at element level

    • Selected at structure level

    • Entry point at structure level

    • BO name at structure level

This information can be summarized as follows:

Screen Field

Element

Structure

Key

QO, RI, RO

 

Selected

QI, RO

RO

Entry Point

 

QO, RO

Default Value

QI

 

BOL Field Name

QI, QO, RI, RO

 

BO Name

 

RO

4. Check Settings

Before you generate the component, check the settings you have made. The following checks are performed:

  • Component

    • A component must not contain more than one read operation

    • A component must contain one read operation to be generated

  • Read operation input

    • At least one field must be designated as a key field

    • BOL field names must be unique

  • Read operation output

    • If the node is a structure and selected, the BO name must be filled

    • BO names must be unique

    • BOL field names must be unique

    • If the node is a table and selected, at least one field must be designated as a key field

    • Exactly one structure must be designated as the entry point

  • Query operation input

    • At least one field must be selected

    • BOL field names must be unique

  • Query operation output

    • At least one field must be designated as a key field

    • Fields designated as key fields must correspond to key fields in corresponding read input

    • Exactly one structure must be designated as the entry point

5. Test Generated Component

Once your component has been generated, you can test it using the transaction GENIL_MODEL_BROWSER to check the model, and GENIL_BOL_BROWSER to check the query operations.