To specify which BAPI functions you want to call and which
data you want to process, you provide information in the external service wizard.
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 BAPI functions on the
SAP server.
The
external service wizard returns
a list of BAPI functions that meet the search criteria.
To specify
the search criteria and select the BAPI functions for the work unit,
use the following procedure.
Procedure
- In the Specify the Discovery Properties window,
indicate which BAPI you want to work with.
- Click RFC to enable the filter
button.
- Click the filter button.
Note: Instead of
using the filter capability, you can expand
RFC and
select the function from the list, or you can expand
BOR,
expand the functional grouping (for example,
Cross-Application
Components), and select the BAPI. Then skip ahead to step
4.
- From the Filter Properties window,
specify information about the BAPIs you want to discover:
- 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, BAPI_CUSTOMER*) representing
the BAPI you want to call.
This is the name of the BAPI
in SAP plus an asterisk as a wild card character to indicate that
you want a list of all SAP application components that start with
the phrase BAPI_CUSTOMER.
- 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 BAPIs.
- Expand RFC (filtered).
- From the Discovered object list,
select one or more BAPIs that you want to use.
- Click the arrow button to add the BAPIs to the Selected
objects list.
- In the Configuration
Properties window, perform the following steps for each
BAPI to add it to the list of business objects to be imported:
- Optionally, select the Use the original character
case of SAP field names to generate business object attribute names check
box. By default (when the check box is not selected), the field descriptions
are used to generate properties.
- Optionally, select the Process Date fields
as String check box. This allows the adapter to retrieve
SAP-specific date formats which are otherwise non-standard in Java
by using the String type instead of the Date type format.
Note: To
use this feature, ensure that the above check box is selected while
running the external service wizard.
As the date fields are converted to string type, ensure that all downstream
dependencies (if any) are taken care of.
- If the BAPI has optional parameters associated with
it, select the Select optional parameters to include as
child objects check box, expand Optional parameters,
and select the type of parameters (import, export, or table) that
you want to work with.
By default, the external service wizard generates
all the parameters required for the selected BAPI, so select this
check box and then clear the check boxes for any parameters you do
not want to include in your business object.
If you are adding
BAPI_CUSTOMER_GETDETAIL function module, you have the option of adding
the following parameters:
Optional Import Parameters:
- PI_PASS_BUFFER
- PI_DIVISION
- PI_DISTR_CHAN
Optional Export Parameters:
Refer to the SAP documentation for a list and description
of the optional parameters.
- Click OK to add the BAPI to the
list of business objects to be imported.
If you want to remove an object from the list, select the
object name and click the left arrow.
- Click Next.
Results
The
external service wizard has
returned the functions that match the search criteria, and you have
selected the functions you want to work with.
The Specify Composite Properties window
is displayed.
What to do next
Provide information about the business objects (such
as the name of the top-level object and associated operation).