Skip navigation.
Downloads | Product Documentation | Support

WebLogic Portlets for SAP Administration Guide

# WebLogic Portlets for SAP Administration Guide

This document explains how to administer the BEA WebLogic Portal application.

The BEA WebLogic Portlets for SAP application integrates BEA WebLogic Portal application with the SAP R/3 4.6C System.

This guide contains the following sections:

- BEA Weblogic Platform Administration Functions
- BEA WebLogic Portlets for SAP Administration Functions
- Troubleshooting

# BEA Weblogic Platform Administration Functions

You must have BEA WebLogic Platform administrator privileges in order to perform the following operations. Login to the BEA WebLogic Administration Portal user interface.

1. Create Users:

<user1>

<user2>

2. Create Groups:

<example EMPLOYEE >

<example CUSTOMER>

3. Add User to Group:

<user1> to Administrator group to make <user1> as administrator

<user1> to <example EMPLOYEE >

<user2> to <example CUSTOMER>

4. Create Roles:

<example CUSTOMER>

<example EMPLOYEE>

5. Assign Groups to Role:

<example EMPLOYEE Group> to <example EMPLOYEE Role>

<example CUSTOEMER Group> to <example CUSTOEMER Role>

6. Create a new Portal.
7. Create a new Desktop for that Portal.
8. Give Entitlements for Administration book for role <example EMPLOYEE>.
9. Give Entitlements for Administration page for role <example EMPLOYEE>.

Note: Refer to WebLogic Administration Portal Tutorial documentation for more details.

# BEA WebLogic Portlets for SAP Administration Functions

This section contains the following topics:

- Authentication / Logging In
- Managing User Privileges
- Setting Up EIS Object Preferences
- Viewing the Log Information

## Authentication / Logging In

Log in to BEA WebLogic Portlets for SAP using the administrator account `weblogic'. A default administrator account is already created with the following authentication details:

Username: weblogic

Password: weblogic

### To Login to BEA WebLogic Portlets for SAP as an administrator:

1. Open the Web Browser.
2. Type in the URL of the BEA WebLogic Portlets for SAP system in the address bar and press Enter. The Login screen appears, as shown in Figure 1.

Figure 1 Login Screen

3. Enter the administrator Username <default UserName: weblogic> and Password. <Default Password: weblogic>.
4. Click Sign In.

Note: The Username and Password are case sensitive.

## Managing User Privileges

Only the existing BEA WebLogic Portal user(s) can be mapped as the user(s) of BEA WebLogic Portlets for SAP. This user is also referred to as an EIS (Enterprise Integration System) user. BEA WebLogic Portlets for SAP has three types of EIS users:

- Customer
- Employee
- Administrator

Customer

A user of type Customer has access to the SAP tab. This user can perform all the customer related operations.

Employee

A user of type Employee can perform all the customer related operations. In addition to that, an Employee can view the list of all the customers.

Administrator

The Administrator has access to all the operations, which the Customer and the Employee can perform. In addition to that, the Administrator has the privilege to perform administration tasks like Creating EIS Instances, Creating EIS Users, and Setting Up EIS Object Preferences.

### Viewing/Creating/Editing/Deleting an EIS Instance

This topic contains procedures for viewing, creating, editing, and deleting an EIS instance.

#### To View the List of EIS Instances:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab as shown in Figure 2.

Figure 2 EIS Administration Screen

3. Click the EIS Instance Setup link. The EIS Application screen appears, as shown in Figure 3.

Figure 3 EIS Administration - EIS Application Screen

4. Select the EIS Application as SAP46C and click Search. The list of existing EIS instances appears, as shown in Figure 4.

Figure 4 EIS Instance Screen

#### To Create an EIS Instance:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Instance Setup link.
4. Select the EIS Application as SAP46C and click Create. The Create EIS Instance screen appears, as shown in Figure 5.

Figure 5 Create EIS Instance Screen

5. Enter an Instance Name of your choice.
6. Enter the Native Base URL. This is the URL of the SAP system.
7. Enter the User Id and Password for logging in to the SAP system.
8. Enter the Client number of the SAP system.
9. Enter the Language code.
10. Enter the IP Address of the SAP system.
11. Enter the system number of the SAP system in the System Id field.
12. Enter the number of Maximum Connections allowed for the SAP system.
13. Enter a unique value for the SID. This is used while creating a connection pool.
14. Click Submit to create the instance.

#### To Edit an EIS Instance:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Instance Setup link.
4. Select the EIS Application as SAP46C and click Search.
5. Click the red pencil icon (below) to edit the required instance.

6. Make the necessary changes and click Submit.

#### To Delete an EIS Instance:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Instance Setup link.
4. Select the EIS Application as SAP46C and click Search. The list of existing EIS instances appears.
5. Click the trash bin icon (below) to delete the required EIS instance.

### Viewing/Creating/Editing/Deleting an EIS User Mapping

This section contains procedures for viewing, creating, editing, and deleting an EIS user mapping.

#### To View the List of EIS User Mappings:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Credential Mapping Details link. The EIS Credential Mapping screen appears, as shown in Figure 6.

Figure 6 EIS Credential Mapping - Search Screen

4. Use any one of the following search criteria:

- Enter the Portal User Id and click search.
- Click Show All Portal Users link.
- Click on an alphabet with which the user's login name starts.

5. The list of Portal Users matching the search criteria is populated in the Portal User Id drop down box. Select the required Portal User Id.
6. Select the EIS Name as SAP46C.
7. Select the Instance Name.
8. Click Search. The list of existing EIS User credentials is displayed.

#### To Map an EIS User to a Portal User:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Credential Mapping Details link.
4. Use any one of the following search criteria:

- Enter the Portal User Id and click search.
- Click Show All Portal Users link.
- Click on an alphabet with which the user's login name starts.

5. The list of Portal Users matching the search criteria is populated in the Portal User Id drop down box. Select the required Portal User Id.
6. Select the EIS Name.
7. Select the Instance Name.
8. Click Search. The list of existing EIS User credentials is displayed, as shown in Figure 7.

Figure 7 EIS Credential Mapping - Select User Type Screen

9. Select the User Type as either CUSTOMER or EMPLOYEE.
10. Click Create. The Create screen appears, as shown in Figure 8.

Figure 8 EIS Credential Mapping - Create Screen

11. Selecting the Use Selected EIS Instance Credential option will use the Instance Name information, which you have selected in the previous step.
12. Enter the SAP User Id and Password.
13. Selecting the Allow Drilldown To EIS option as Native allows you to view the information in the Portlet though ITS (Internet Transaction Service).
14. Selecting the Allow Detailed Information option as Target allows you to view the SAP window information in the Portlet.
15. Select the Status of the user as Active to activate this EIS user account, otherwise select the Status as Inactive. Only one EIS mapping will be active at a given time.
16. Click Search to select the Customer Id.
17. Click Submit.

#### To Edit an EIS User Mapping:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Credential Mapping Details link.
4. Use any one of the following search criteria:

- Enter the Portal User Id and click search.
- Click Show All Portal Users link.
- Click on an alphabet with which the user's login name starts.

5. The list of Portal Users matching the search criteria is populated in the Portal User Id drop down box.
6. Select the Portal User Id.
7. Select the EIS Name as SAP46C.
8. Select the Instance Name.
9. Click Search. The list of existing EIS User credentials is displayed.
10. Click the red pencil icon to edit the required EIS User.
11. Make the necessary changes and click Submit.

#### To Delete an EIS User Mapping:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the EIS Credential Mapping Details link.
4. Use any one of the following search criteria:

- Enter the Portal User Id and click search.
- Click Show All Portal Users link.
- Click on an alphabet with which the user's login name starts.

5. The list of Portal Users matching the search criteria is populated in the Portal User Id drop down box.
6. Select the Portal User Id.
7. Select the EIS Name as SAP46C.
8. Select the Instance Name.
9. Click Search. The list of existing EIS User credentials is displayed.
10. Click the trash bin icon to delete the required EIS User.

## Setting Up EIS Object Preferences

This section contains topics on setting up EIS object preferences.

### Viewing/Creating/Editing/Deleting a Portlet

This topic contains procedures on viewing, creating, editing, and deleting portlets.

#### To View the List of Portlets:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of Portlets is displayed, as shown in Figure 9.

Figure 9 List of Portlets Screen

#### To Create a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click the Add New Portlet link. The Portlet Name screen appears as shown in Figure 10.

Figure 10 Portlet Name Screen

6. Enter the Portlet name of your choice.
7. Click Submit. This Portlet appears in the list of Portlets.
8. You can now add new BAPIs for this Portlet.

#### To Edit the Name of a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of Portlets is displayed.
6. Click the red pencil icon to edit the name of the required Portlet.
7. Make the required changes and click Submit. The Portlet appears in the list of Portlets with the changed name.

#### To Delete a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of Portlets is displayed.
6. Click the trash icon to delete the required Portlet.

### Viewing/Adding/Editing/Deleting a BAPI for a Portlet

This topic contains procedures for viewing, adding, editing, and deleting a BAPI for a portlet.

#### To View the BAPIs for a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears, as shown in Figure 11.

Figure 11 List of BAPIs Screen

#### To Add a BAPI for a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet.
7. Click the Add New Bapi link.
8. Enter the BAPI Name.
9. Select the Purpose of the Portlet to specify whether it will be used for an UPDATE, VIEW or CREATE operation.
10. Click Submit. You can now add new Edit/Display parameters for this BAPI.

#### To Edit a BAPI for a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the red pencil icon to edit. The list of Edit/Display parameters appears.
8. You can now edit the required Edit/Display parameters.

#### To Delete a BAPI for a Portlet:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the trash icon to delete the required BAPI.

### Viewing/Adding/Editing/Deleting the Edit/Display Parameters for a BAPI

This topic contains procedures for viewing, adding, editing, and deleting the edit/display parameters for a BAPI.

#### To View the Edit/Display Parameters for a BAPI:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the red pencil icon. The list of Edit/Display parameters for that BAPI appears, as shown in Figure 12.

Figure 12 List of Edit / Display Parameters Screen

#### To Add the Edit/Display Parameters for a BAPI:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the red pencil icon.
8. Click the Add New Edit Display Parameter link. The Add New Edit Display Parameters screen appears, as shown in Figure 13.

Figure 13 Add New Edit / Display Parameters Screen

9. Select the Edit Display Type as either OUTPUT or INPUT.
10. Select the Sub Type as TABLE, SCALAR or STRUCT.
11. Click Submit.
12. The next screen will be displayed depending on the Sub Type selected.

If TABLE is selected:

1. Enter the Table Name.
2. Click Submit. The Table Name appears in the list of edit/display parameters.
3. Click the red pencil icon to edit the edit/display parameters.
4. Click the Add New Edit Display Table Parameters link. The Add New Edit Display Table Parameters screen appears, as shown in Figure 14.

Figure 14 Add New Edit / Display Table Parameters Screen

5. Enter the Field Name.
6. Enter the Label Name.
7. If the field is mandatory select YES, otherwise select NO.
8. Select the Data Type as NUMBER, CHAR or DATE.
9. Select the User Type as CUSTOMER or EMPLOYEE or select both.
10. Check Hidden status for selected user types.
11. Click Submit.

If SCALAR is selected:

1. Enter the Field Name.
2. Enter the Label Name.
3. Select YES if the Sub Type is mandatory, otherwise select NO.
4. Select the Data Type as NUBMER, CHAR or DATE.
5. Select User Type as CUSTOMER or EMPLOYEE, or select both.
6. Check Hidden status for selected user types.

If STRUCT is selected:

1. Enter the Table Name.
2. Click Submit. The Table Name appears in the list of edit/display parameters.
3. Click the red pencil icon to edit the edit/display parameters.
4. Click the Add New Edit Display Table Parameters link.
5. Enter the Field Name.
6. Enter the Label Name.
7. If the field is mandatory select YES, otherwise select NO.
8. Select the Data Type as NUBMER, CHAR or DATE.
9. Select the User Type as CUSTOMER or EMPLOYEE or select both.
10. Check Hidden status for selected user types.
11. Click Submit.

#### To Edit the Edit/Display Parameters for a BAPI:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the red pencil icon. The list of Edit/Display parameters for that BAPI appears.
8. Click the red pencil icon to edit the required Edit/Display parameter.

#### To Delete the Edit/Display Parameters for a BAPI:

1. Login to BEA WebLogic Portlets as administrator.
2. Click the Administration tab.
3. Click the Setup EIS Object Preferences link.
4. Select the EIS Application Name as SAP46C.
5. Click Search. The list of existing Portlets appears.
6. Click on the name of the required Portlet. The list of BAPIs for that Portlet appears.
7. Click the red pencil icon. The list of Edit/Display parameters for that BAPI appears.
8. Click the trash icon to delete the required Edit/Display parameter.

## Viewing the Log Information

BEA WebLogic Portlets for SAP logs all the error information in log files. These log files are stored in the portal directory, under the following path:

For example, if the domain used is samples then you will find the logs in `<%BEA_HOME%>\bea\weblogic81\samples\domains\portal`.

where `<%BEA_HOME%>` is the location where BEA WebLogic Portal is installed.

# Troubleshooting

Use Table 1 to troubleshoot common issues.

Table 1 Troubleshooting Issues

No. | Problem | Cause
1 | Login Failed. | Please verify that you have entered the correct username and password.
2 | Administrator tab is not visible. | Please login using the administrator account.