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 inbound processing > Configure a module for ALE inbound processing > Selecting business objects and services

Discovering IDocs from a file

To select IDocs from a file, first configure an IDoc definition file based on information on the SAP server.

You then specify, in the external service wizard, the path to the file on your local system.

You must have created an IDoc definition file.

If you are using Discover IDoc From System, do not complete the following steps. The IDoc definition file is needed only if you are using Discover IDoc From File.

Specify the IDoc definition file that the external service wizard uses to discover the IDoc.

The Discover IDoc From File 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 File to enable the filter button. Find Objects in the Enterprise System window shows the window as it appears in the ALE interface. If you are using the ALE pass-through interface, you also see a Generic IDoc choice.

      Figure 1. The Find Objects in the Enterprise System window

    3. Click the filter button.

      Instead of using the filter button, you can expand Discover IDoc From File and select the IDoc definition file. You then skip ahead to step 4.

  2. From the Filter Properties window, specify the location of the IDoc definition file.

    1. Click Browse to navigate to the IDoc definition file, or type the path to the file.

      Figure 2. The Filter Properties for Discover IDoc From File window

    2. After you type or select the file, click OK.

  3. Select the IDoc or IDocs.

    1. Expand Discover IDoc From File (filtered).

      The IDoc definition file is displayed.

    2. Click the IDoc definition file.

      Figure 3. The Find Objects in the Enterprise System window

  4. Click the arrow button to add it to the Selected objects list.

  5. In the Specify the Configuration Properties for 'object' window, perform the following tasks:

    If you are using the ALE pass-through IDoc interface, only the Send an IDoc Packet as one business object configuration property is available.

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

    3. 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)

    4. If you are working with an IDoc packet and want to specify that the packet not be split, select the Send an IDoc Packet as one business object check box.

    5. If you want to send the IDoc in an unparsed form (so that the client application, rather than the adapter, parses the data), select the Send an IDoc packet as unparsed data check box.

      Refer to Resolving data record (hexbinary) format issues for ALE inbound interfaces for more information on resolving data record format issues for ALE inbound interfaces.

    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.

    7. Click OK.

  6. Click Next.


Results

The external service wizard has returned an IDoc or a list of IDocs associated with the IDoc definition file. You see the Specify Composite Properties window (if you are using the ALE interface) or the Specify the Service Generation and Deployment Properties (if you are using the ALE pass-through IDoc interface).


What to do next

Selecting business objects and services for ALE inbound processing


Next topic: Configure the selected objects


Next topic: Setting deployment properties and generating the service