Integrating SAP Portal Content into

Microsoft SharePoint Portal Server

Applies to:

SAP NetWeaver 04 SPS15, Portal Development Kit 2.0 for Microsoft .NET

Microsoft Visual Studio .NET 2003

Microsoft SharePoint Portal Server 2003

Summary

Enabling the integration of portal content created with Portal Development Kit 2.0 for Microsoft .NET for SAP
NetWeaver Portal, into Microsoft SharePoint Portal Server 2003.

By: Tarnoruder, Anne, SAP NetWeaver Product Management

Company: SAP

Date: February 2006

Table of Contents

Introduction.......................................................................................................................................2

Terminology ..................................................................................................................................2

Prerequisites .................................................................................................................................3

Creating an SAP Portal Application and Packaging it as a Web Part..............................................3

Preparing a SharePoint Portal Server ..............................................................................................3

Installing the SAP Portal Interoperability Web Part ......................................................................3

Modifying the Web Configuration File...........................................................................................4

Creating a Folder for Web Part Files ............................................................................................4

Installing the Portal CSS Files ......................................................................................................4

Integration.........................................................................................................................................6

Installing the Web Part on a SharePoint Portal Server ................................................................6

Adding the Web Part to a SharePoint Page .................................................................................6

Testing the Application .................................................................................................................6

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 1

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Introduction
As another element of interoperability with Microsoft, SAP provides tools that enable the integration of portal
content, created with Portal Development Kit 2.0 for Microsoft .NET for SAP NetWeaver Portal, into Microsoft
SharePoint Portal Server 2003. This capability is based on the new feature that allows packaging the SAP
portal content in the format required by Microsoft SharePoint.

This guide takes you through the sequence of steps required to perform this task.

Terminology

Term Description

Portal Development Kit 2.0 for Microsoft .NET (PDK A toolkit that enables development of SAP
2.0 for .NET) NetWeaver Portal content in the Microsoft.NET
environment

Portal Add-in 2.0 for Visual Studio 2003 The design-time environment of PDK 2.0 for .NET

Portal Runtime 2.0 for Microsoft .NET The runtime service of PDK 2.0 for .NET

Microsoft SharePoint Portal Server 2003 A scalable portal server that connects people, teams,
and knowledge across business processes.

SAP NetWeaver Portal The front-end component for SAP NetWeaverthe

comprehensive integration and application platform
that facilitates the alignment of people, information,
and business processes across organizational and
technical boundaries.

SAP Portal Application A collection of ASP.NET custom controls created for

SAP NetWeaver Portal using PDK for .NET

virtual server A virtual computer that resides on an HTTP server

but appears to the user as a separate HTTP server.
Each virtual server can have its own domain name
and IP address.

Web Part An ASP.NET custom control that can be installed on

any site based on Windows SharePoint Services, and
added to application pages.

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 2

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Prerequisites

Microsoft Visual Studio .NET 2003 installed on a development host

Portal Add-in 2.0 for Visual Studio 2003 installed on a development host
Portal Runtime 2.0 for Microsoft .NET installed and running on a Microsoft SharePoint Portal Server

For detailed installation instructions, see Installation, Upgrade and Configuration Guide PDK for .NET.

Creating an SAP Portal Application and Packaging it as a Web Part

1. Log on to your development host.
2. Open MS Visual Studio 2003 and from the Tools menu, select Options.
3. In the Options dialog box, expand the SAP PDK folder.
4. Set the Target property under Output Settings to Microsoft SharePoint and click OK.
5. Restart Visual Studio.
6. Design, develop and test a portal application project with PDK for .NET, as usual.
7. From the project menu, select Create PAR.
8. From the project menu, select Create Web Part Package.
9. The <par name>.par and <par name>.cab files are created in the output folder specified in the
Project PAR properties.

Preparing a SharePoint Portal Server

1. Log on to a MS SharePoint Portal Server as a user with administrative permissions.
2. Extract the contents of the supplied .zip file into a local folder of your choice.

Installing the SAP Portal Interoperability Web Part

1. Double-click the SAP Portal Interoperability WebPart.msi file to start the installation.
2. In the SAP Portal Interoperability WebPart dialog box, select Specific virtual servers, enter the site
name in the format http://<Host Name>:<TCP Port No>, and click Next.

3. In the next dialog box, click Yes to install the SAP Portal Interoperability WebPart.dll to the Global
Assembly Cache. A message appears, indicating that the installation was completed successfully.

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 3

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Modifying the Web Configuration File

Go to the home directory of your site, open the Web.config file, and modify the file as follows:

1. To enable the use of the Session object, which is required to run Portal Runtime for .NET, add the
following tag to the system.web section:
<pages enableSessionState="true" enableViewState="true"
enableViewStateMac="true" validateRequest="false" />
If this tag already exists, modify its attributes accordingly.

2. To enable redirection of requests for resources having the .ashx extension (.NET portal components)
to Portal Runtime for .NET, add the following tag to the httpHandlers element under the
system.web section.
<add verb="*" path="*.ashx"
type="SAP.Portal.Interoperability.WebPart.WebPartWrapper,
SAP.Portal.Interoperability.WebPart, Version=2.0.0.0, Culture=neutral,
PublicKeyToken=50436dca5c7f7d23" />

3. To define attributes for the Interoperability Web Part, such as the location of the resource files, Portal
Runtime for .NET connectivity parameters, and the deployment folder, add the following appSettings
element to the configuration section below the configSections element.
<appSettings>
<add key="PDKCSS"
value="/_wpresources/SAP.Portal.Interoperability.WebPart/2.0.0.0__50436dca5c
7f7d23/UR" />
<add key="PDKServer" value="localhost" />
<add key="PDKPort" value="8050" />
<add key="PDKDeploymentFolder" value="C:\SPSPCD" />
</appSettings>

4. Add the following tag to the <httpModules> section:

<add name="Session" type="System.Web.SessionState.SessionStateModule"/>

5. When finished, save the file, and restart IIS.

Creating a Folder for Web Part Files

Create a folder and name it C:\SPSPCD, as specified in the configuration setting. This folder will be used for
storing the PAR files required to execute the Web Parts that you create with PDK for .NET.

Installing the Portal CSS Files

1. On your SharePoint server, navigate to: %Program Files%\Common Files\Microsoft

Shared\web server
extensions\wpresources\SAP.Portal.Interoperability.WebPart\2.0.0.0__50436dca
5c7f7d23\UR, and create the following subfolders:

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 4

Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

\common
\jslib
\ur
2. On your SAP NetWeaver Portal server, navigate to the
<drive>:\usr\sap\..\..\j2ee\cluster\server0\apps\sap.com\irj\servlet_jsp\irj
\root\portalapps folder, for example,
C:\usr\sap\P43\JC00\j2ee\cluster\server0\apps\sap.com\irj\servlet_jsp\irj\ro
ot\portalapps folder.
3. Copy the specified files to their respective destinations on your SharePoint server under the root folder
%Program Files%\Common Files\Microsoft Shared\web server
extensions\wpresources\SAP.Portal.Interoperability.WebPart\2.0.0.0__50436dca
5c7f7d23\UR, as described in the following table:
Source Destination
\com.sap.portal.design.urdesigndata\themes\portal\sap_trades \common
how\common and all its subfolders
\ur
com.sap.portal.design.portaldesigndata\themes\portal\sap_tra
deshow

\glbl\glbl_ie6.css

\prtl_std\prtl_std_ie6.css

\ur\ur_bdy_prtl_ie6.css

\ur\ur_ie6.css
\jslib
\com.sap.portal.htmlb\jslib\popup_ie6.js

\com.sap.portal.htmlb\jslib\sapUrMapi_ie6.js
\jslib
\com.sap.portal.dotnet.framework\scripts\controls\dotNETHand
ler.js

\com.sap.portal.dotnet.framework\scripts\controls\urMessageB
undle_en.js

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 5

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Integration
Installing the Web Part on a SharePoint Portal Server

1. Copy the PAR and CAB files you have created (<par name>.par and <par name>.cab) from the
development host to the C:\SPSPCD folder on yout SharePoint server.
2. Register the Web Part by opening a command prompt, and running the following command:
C:\SPSPCD>stsadm -o addwppack -filename "<project name>.cab" -url "<your
site URL>" -force

Adding the Web Part to a SharePoint Page

To enable the processing of requests with pdk in their path:

1. Navigate to the Windows SharePoint Services Central Administration page.

2. Under Virtual Server Configuration, click Configure virtual server settings.
3. Click your virtual server name. In the page that opens, under Virtual Server Management, click Define
managed paths.
4. In the Add a new path pane, enter pdk in the Path textbox, select Excluded path, and click OK.

To add your Web Part to a page:

1. Navigate to your site home page.

2. Under Actions, click Edit Page.
3. Click Modify Shared Page in the upper right corner.
4. In the menu that opens, select Add Web Parts -> Browse.
5. In the pane that opens, select the gallery that contains your Web Part.
6. Select and drag your Web Part to the target zone on the page.

Testing the Application

Under Actions, click View Page. The Web Part you have added appears on the page.

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 6

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Limitations

In the Microsoft SharePoint Portal Server 2003 environment, PDK 2.0 for .NET supports limited functionality.

The following features are not supported at runtime:

SAP Portal Services:

{ SAP.Portal.Services.UserManagement
{ SAP.Portal.Services.Systems
{ SAP.Portal.Services.OBN
OBNAdapter component
Server-side and client-side events

When the Output Target option is set to MS Sharepoint 2003, the following features in the Visual Studio
IDE are not accessible:

SAP Toolbar
SAP Menu bar
Commands
{ Deploy
{ Publish Project
{ Publish Page
{ Create SDA
{ View in Portal
{ Debug
Portal Style Designer
Portal Page Designer

The following Visual Studio IDE features do not function properly:

Server Explorer
SAP Portal Page project item
SAP Portal System Template project item

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 7

 Integrating SAP Portal Content into
Microsoft SharePoint Portal Server

Author Bio

Anne Tarnoruder is an information developer for SAP NetWeaver Product Management in SAP
Labs, Israel, where she is responsible for the developers documentation of PDK for .NET and
Visual Composer. Prior to joining SAP in 2004, she held a number of positions in software
development, team management, system architecture and technical communications in various
high-tech companies. Anne holds an M.S. degree in Applied Mathematics.

Disclaimer & Liability Notice

This document may discuss sample coding or other information that does not include SAP official interfaces
and therefore is not supported by SAP. Changes made based on this information are not supported and can
be overwritten during an upgrade.

SAP will not be held liable for any damages caused by using or misusing the information, code or methods
suggested in this document, and anyone using these methods does so at his/her own risk.

SAP offers no guarantees and assumes no responsibility or liability of any type with respect to the content of
this technical article or code sample, including any liability resulting from incompatibility between the content
within this document and the materials and services offered by SAP. You agree that you will not hold, or seek
to hold, SAP responsible or liable with respect to the content of this document.

2005 SAP AG The SAP Developer Network: http://sdn.sap.com 8