Use the Discover IDocs from System option
to have the external service wizard search
for IDocs based on the criteria you specify.
Before you begin
Make sure you have set the connection properties for the
external service wizard.
About this task
Specify search criteria that the
external service wizard uses
to discover IDocs on the
SAP server.
Note: The Discover
IDoc From System choice applies to both the ALE interface
and the ALE pass-through IDoc interface.
Procedure
- In the Find Objects in the Enterprise System window,
indicate which IDoc you want to work with.
- Expand ALE.
- Click Discover IDoc From System to
enable the filter
button.
- Click the filter button.
Note: 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.
- From the Filter Properties window,
specify information about the IDoc or IDocs:
- Select Discover objects by name or Discover
objects by description from the Object attribute
to use for discovery list.
- 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.
- Select Basic IDocs or Extension
IDocs from the IDoc type to use for discovery field.
- 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.
- Click OK.
- Select the IDoc or IDocs.
- Expand Discover IDoc From System (filtered).
- 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.
- Click the arrow button to add the IDoc or IDocs
to the Selected objects list.
- In the Configuration
Parameters window, perform the following tasks to add the
IDoc to the list of business objects to be imported.
- 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:
- 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.
- 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.
- 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:
Table 1. | 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) |
- 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.
- 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.
- 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.
- 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.
- Click OK.
- 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.