IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Services and service-related functions > Access external services with adapters > Configure and using adapters > IBM WebSphere Adapters > SAP Software > Configure the module for deployment > Configure the module for outbound processing > Configure a module for ALE outbound processing > Selecting business objects and services

Discovering IDocs from the system

Use the Discover IDocs from System option to have the external service wizard search for IDocs based on the criteria you specify.

Make sure you have set the connection properties for the external service wizard.

Specify search criteria that the external service wizard uses to discover IDocs on the SAP server.

The Discover IDoc From System choice applies to both the ALE interface and the ALE pass-through IDoc interface.


Procedure

  1. In the Find Objects in the Enterprise System window, indicate which IDoc you want to work with.

    1. Expand ALE.

    2. Click Discover IDoc From System to enable the filter button.

    3. Click the filter button.

      Instead of using the filter button, you can expand Discover IDoc From System and select the IDoc from the list. You then skip ahead to step 4.

  2. From the Filter Properties window, specify information about the IDoc or IDocs:

    1. Select Discover objects by name or Discover objects by description from the Object attribute to use for discovery list.
    2. Type a search string (for example, ALEREQ*) representing the IDoc you want to call.

      This is the name of the IDoc in SAP plus an asterisk as a wild card character to indicate that you want a list of all IDocs that start with ALEREQ.

    3. Select Basic IDocs or Extension IDocs from the IDoc type to use for discovery field.

    4. Indicate the number of functions you want returned by changing the value in the Maximum number of objects to retrieve field or by accepting the default value.

    5. Click OK.

  3. Select the IDoc or IDocs.

    1. Expand Discover IDoc From System (filtered).

    2. From the Discovered object list, click the IDoc you want to use. If you are working with multiple IDocs, click the names of all the IDocs.

  4. Click the arrow button to add the IDoc or IDocs to the Selected objects list.

  5. In the Configuration Parameters window, perform the following tasks to add the IDoc to the list of business objects to be imported.

    1. Optionally select the Use SAP field names to generate attribute names. By default, when the check box is not selected, field descriptions are used to generate properties. If you choose to use SAP field names to generate attribute names, two more check boxes are enabled:

    2. Optionally select the Use SAP field names to generate attribute names check box. By default (when the first check box is not selected), field descriptions are used to generate properties.

    3. Select the Use SAP-original casing for Control Record Business object attribute names check box to generate attribute names in SAP original casing. If unchecked, attribute names are generated using field names from SAP in camel-casing.

    4. Select the Use SAP-original casing for Data Record Business object attribute names check box to generate attribute names in SAP original casing. If unchecked, attribute names are generated using field Name from SAP in camel-casing.

      The following are the different possible combinations:

      Scenario Use SAP field names to generate attribute names (check-box) Use SAP-original casing Control Record business object attribute names (check-box) Use SAP-original casing Data Record business object attribute names (check-box) Control Record Data Record
      1 Checked Checked Checked Attribute names are generated using Field Name from SAP (Original SAP casing) Attribute names are generated using Field Name from SAP (Original SAP casing)
      2 Checked Checked Not checked Attribute names are generated using Field Name from SAP (Original SAP casing) Attribute names are generated using Field Name from SAP (Camel-casing)
      3 Checked Not checked Checked Attribute names are generated using Field Name from SAP (Camel-casing) Attribute names are generated using Field Name from SAP (Original SAP casing)
      4 Checked Not checked Not checked Attribute names are generated using Field Name from SAP (Camel-casing) Attribute names are generated using Field Name from SAP (Camel-casing)
      5 Not checked Not checked Not checked Attribute names are generated using Field Description from SAP (Camel-casing) Attribute names are generated using Field Description from SAP (Camel-casing)

    5. If you want to have IDocs sent to a queue on the SAP server, click Use qRFC to serialize outbound data using a queue, and then select the queue from the Select the queue name list.

    6. In the IDoc release version field, specify the SAP release number to identify the IDoc type you want the external service wizard to use for creating business objects. If the selected IDoc has unreleased segments, the IDoc release version property becomes required. It is recommended that you select the default value Unreleased if the IDoc you are working with has unreleased segments. If Unreleased is selected, the adapter generates the business objects for segments using the unreleased segment definition.

    7. In the IDoc release version field, specify the SAP release number to identify the IDoc type you want the external service wizard to use for creating business objects. The version of the SAP system is set as default. If the selected IDoc has unreleased segments, the IDoc release version property becomes required. It is recommended that you select Unreleased if the IDoc you are working with has unreleased segments. If Unreleased is selected, the adapter generates the business objects for segments using the unreleased segment definition.

    8. Optional: In the node area, you can either select or deselect the optional segments for which you want to generate the artifacts that will be part of the Data record.

    9. Click OK.

  6. Click Next.


Results

The external service wizard has returned an IDoc or a list of IDocs, and you have selected the ones you want to work with. You see the Specify Composite Properties window.


What to do next

Optionally specify a namespace and directory to which the generated business object will be stored and indicate whether you want a business graph generated.

Selecting business objects and services for ALE outbound processing


Next topic: Configure the selected objects


Next topic: Setting deployment properties and generating the service