Redefining Services from External Framework (SPI, BW Query, GenIL)

The Service Builder allows you to redefine a service and model from different external frameworks (integration topics) and redefine the service and model without having to navigate to a different transaction. This function comprises three steps:

Specify the parameters for the selected external framework
Generate the service
Redefine the service

Redefining Services

The Service Builder allows you to redefine services from the following external frameworks:

Service Provider Interface (SPI)
SAP Business Warehouse (BW)
Generic Interaction Layer (GenIL)

A separate plug-in for each framework provides a wizard to create services starting from framework-specific data. Since these plug-ins belong to different software components they might not be available in every system.

Note Based on the component installed in your system, the relevant context menu is displayed.

If software component IW_SPI is installed in your system, Create from SPI is displayed in the context menu.
If software component IW_GIL is installed in your system, Create from GenIL is displayed in the context menu.
If software component IW_BEP is installed in your system, BW Query Service is displayed in the context menu.

To redefine services from an external framework, proceed as follows:

Log onto the SAP Business Suite backend system.
Open transaction SEGW. The SAP Gateway Service Builder opens.
Create an empty project. For more information, see Creating a Service Builder Project..
Right-click the project folder and select Redefine SPI Service, BW Query Service or GenIL Service . Depending on the external framework you select, the appropriate framework-specific screen is displayed.
- Service Generator for SPI Service
  1. Enter the RFC Destination of the SPI system. Alternatively, you can use the input help available for this field.
  2. Enter the Application Building Block ID for which you want to generate the SAP Gateway service. For example, EAMS_OBJK. Alternatively, you can use the input help available for this field.
  3. Select the Generate Metadata Specific to Application to generate metadata specifically for this application. If this indicator is set, then the DEFINE Method of Generated Model Provider Class is redefined and the model is defined in this generated method. Otherwise, the generic metadata provisioning options are used to obtain the metadata.
  4. Click Next.
- Service Generator for BW Query Service
  1. Enter the Access Type, RFC Destination, Catalog Name, and Query Name for the BW Query service. Alternatively, use the input help available for these fields.
  2. Click Next.
- Service Generator for GenIL Service
  1. Enter the GenIL Component for the service you wish to create. Alternatively, use the input help available for this field.
  2. Choose Next.

On clicking Next in all these scenarios, the Wizard Step 2 of 3: Redefine Service opens. The screen displays the following fields. Make an entry in each of the fields to proceed to the next step of the wizard:

Fields	Description
Package	Enter the target package name. This is the package in which the generated model provider class and data provider class is stored.
Transport Request	Enter a valid transport request number.
Model Provider Class	Enter a name for the model provider class to be created. For example, `ZCL_MPC_SPI_SAMPLE.`
Data Provider Class	Enter a name for the data provider class to be created. For example, `ZCL_DPC_SPI_SAMPLE.`
Model Name, Version and Description	Enter a unique model name. For example, `ZMO_SPI_SAMPLE.` Enter '1' for version in the corresponding text box. Enter a description. This is a mandatory field.
Service Name, Version and Description	Enter a unique service name. For example, `ZSV_SPI_SAMPLE.` Enter '1' for version in the corresponding text box. Enter a description. This is a mandatory field..

Choose Next. The Wizard step 3 of 3: Redefine Service opens. This screen shows all the artifacts generated in a selectable tree. This screen provides an option to view all the relevant messages of the selected service. A Display messages button is provided on the tool bar, and on clicking this button, a messages window opens.
Figure 1: Display messages icon-> Display Logs window
- (Display messages button--> with error) - denotes that there are error messages, and the service builder also displays an error message.
- (Display messages button--> without error)- denotes that there are no error messages. Click to see the information messages.
Select the required artifacts.
Note Incase of easy query, if query has an advances selection option, it will have entities like:
- <Query name> Result
- <Query name> Parameters
- Value Help entity(s) for a query variable and related associations
Ensure not to unselect the Parameter entities as it will make the service unusable. Also, ensure that at least one property of dimension and key figure under the Result node is selected for the service to work.
Click Finish. The Service Builder runs the consistency check for the imported model and a message is displayed. The selected artifacts are transferred to the respective folders in the tree view of the Service Builder. Also, the name and the version of the service selected for redefinition are displayed in the Model References folder.