SAP ABAP IMG Activity WCF_WSC_BOL_OBJECTS ( Web Service Consumption Tool: Create BOL Objects)
Hierarchy
☛ WEBCUIF (Software Component) SAP Web UI Framework
   ⤷ CA-WUI (Application Component) WebClient UI
     ⤷ WCF_IMG_STRUCTURE (Package) Structure and Activities for WEBCUIF IMG
IMG Activity
ID WCF_WSC_BOL_OBJECTS Web Service Consumption Tool: Create BOL Objects  
Transaction Code S_A0F_96000058   (empty) 
Created on 20090424    
Customizing Attributes WCF_WSC_BOL_OBJECTS   Web Service Consumption Tool: Create BOL Objects 
Customizing Activity WCF_WSC_BOL_OBJECTS   Web Service Consumption Tool: Create BOL Objects 
Document
Document Class SIMG   Hypertext: Object Class - Class to which a document belongs.
Document Name WCF_WSC_BOL_OBJECTS    

Use

In this activity, you can create the BOL objects you require to consume Web services. This means that if you need to retrieve data from locations other than SAP CRM using Web services, the BOL object you create enables you to make this data available on the UI using the same tools provided for standard CRM functionality.

The tool provides the following:

  • Save: You can always save the current status of your work.
  • Delete: You can delete a component from the list.
  • Generate Component: Once your component settings are complete, you can generate your component.
  • Show Client Proxy: You can display the details of the client proxy in the ABAP Workbench (from the operation details screen)
  • Start Proxy Generation: Start the generation wizard.
  • Web Service Administration: You can perform various administrative tasks, including logical port configuration.
  • Check: Check the consistency of the names to make sure they are unique and check other settings that are required to successfully generate a component (see step 4 below).
  • Transport: Trigger the transport of the objects.

Requirements

Standard settings

Activities

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.
  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.
  3. Select an operation and choose Details to go to the next level.

Note

Once you have generated a client proxy and used it in an operation, you must not make any changes to the client proxy (for example, by displaying the client proxy in this tool or using transaction SE80, and then switching to edit mode). If you do make changes, the operation and generated component will no longer work.

If you really need to change a client proxy, you should first delete the operation that uses it, then create the operation again, select the attributes required in the tree, and generate the component.

3. Select Attributes

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

You have the following options:

  • 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 always 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 the attribute belongs to input or output, 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
    • 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, 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 per structure
    • 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 transactions GENIL_MODEL_BROWSER and GENIL_BOL_BROWSER.

Example

Business Attributes
ASAP Roadmap ID 201   Make global settings 
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 WCF_WSC_BOL_OBJECTS 0 PNF0000025 Web Services Tool 
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
CRMVC_WSC_CT C - View cluster CRM_GENIL_WSC  
History
Last changed by/on SAP  20090424 
SAP Release Created in 701