About the BI SAP Query Connector

Version 3.50 SP12

This document is called howto.html and is delivered in the resource adapter archive (RAR file) bi_sdk_sapq.rar. You may extract howto.html to a separate location for your reference before deploying the resource adapter archive.

Note that the BI SAP Query Connector is deployed to the Web Application Server by default with the BW 3.5 installer. Refer to this document for configuration information, or to manually deploy this connector if, for example, you did not choose to deploy it during the BW 3.5 installation.

This document contains the following information:

• Overview
• System Requirements
• Connection Properties
• Deployment Procedure
• Additional Information

Overview

SAP Query is a component of SAP's Web Application Server that allows you to create custom reports without any ABAP programming knowledge. The BI SAP Query Connector uses SAP Query to allow applications created with the BI Java SDK to access data from these SAP operational applications. This connector is fully compliant with the J2EE Connector Architecture (JCA) and may be deployed into SAP's J2EE Server.

You can also use the BI SAP Query Connector to make these data sources available in BW, via UD Connect.

The BI SAP Query Connector implements the BI Java SDK's IBIRelational interface.

System Requirements

Connection Properties

* Note: For the set of connection properties relevant for your system, refer to the JCo documentation in your JCo download.

If you have trouble establishing a connection to a server that does not have a PUBLIC logon group, try removing the properties for R3Name and ServerGroup. See the JCo documentation on the SAP Service Marketplace (http://service.sap.com/connectors/) for more connection troubleshooting information.

Deployment Procedure

The BI SAP Query Connector is deployed to the Web Application Server by default with the BW 3.5 installer. Follow the instructions below if you have not selected this connector for installation or to manually deploy the resource adapter archive onto the Web Application Server:

1. Check system requirements
   
   Ensure that your system is properly configured and that any software prerequisites are satisfied (see System Requirements table above).
   
   
   1. SAP BW 3.5 Java Components:
      
      The BW system installer allows you to deploy the necessary components to the Web Application Server. Verify that these components are present by using the Web Application Server's SDM (Software Deployment Manager).
      
      These components are required by this connector's deployment descriptor. You will receive a warning during the deployment process if they are not already present.
      
      
   2. JCo:
      
      JCo is already present in your managed environment.
      
      
2. Deploy the resource adapter archive
   
   Deploy the archive using the SDM:
   
   
   1. In the SDM, select the Deployment tab
   2. Press the Add SCA/SWC/SDA to Deployment List button
   3. Navigate to and select the bi_sdk_sapq.rar file
   4. Continue pressing Next until the Start button appears
   5. Press Start
   6. Once finished, press Confirm
      
      
3. Configure the connection properties
   
   Configure your connector with the properties in the Connection Properties table above by using the Connector Container service of the Web Application Server's Visual Administrator:
   
   
   1. In the Connector Container service, select the Runtime tab
   2. Find your connector in the Connector Container tree which shows the currently-installed resource adapters, and select it
   3. Select the Managed Connection Factory tab
   4. Select the Properties sub-tab
   5. Select and edit each property as appropriate
   6. Press Add to transfer the changes back into the active properties
   7. Save changes with the Save button in the toolbar
   
   Note: You may also clone an existing connection by using the Clone button in the toolbar. If you are using this connector with UD Connect, when entering the resource adapter name during the cloning process, you must prefix the name with "SDK_" in order for UD Connect to properly recognize the connector.
   

Your BI SAP Query Connector is now ready for use in a managed environment. Refer to this connector in your application by its JNDI name: SDK_SAPQ. For code samples, refer to the Connection Interfaces Javadocs package in the documentation set delivered with the BI Java SDK .

Additional Information

For more information about Sun's J2EE Connector Architecture, see:

• http://java.sun.com/j2ee/connector/

For information about the Visual Administrator in SAP's Web Application Server, see:

• http://help.sap.com/saphelp_nw04/helpdata/en/39/
  83682615CD4F8197D0612529F2165F/frameset.htm

For more information about the connection architecture in the BI Java SDK, refer to the following documentation in the SDK distribution package:

• Connection Interfaces Javadocs package
• Developer's Guide (PDF)

For more information about UD Connect, see:

• http://help.sap.com/saphelp_nw04/helpdata/en/78/
  EF1441A509064ABEE6FFD6F38278FD/frameset.htm

For more information about SAP Query, see:

• http://help.sap.com/saphelp_nw04/helpdata/en/d2/
  CB3EFB455611D189710000E8322D00/frameset.htm