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

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.

   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 1. 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 2. The Find Objects in the Enterprise System window

      

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

5. In the Configuration Parameters window, perform the following tasks:

   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 want to have IDocs sent to a queue on the SAP server, click Use qRFC to serialize outbound data with a queue, and then select the queue from the Select the queue name list.

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

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