Export (0) Print
Expand All

Appendix B: Install the Microsoft SharePoint Adapter

[Unless specifically noted, the content in this topic applies to BizTalk Server 2013 and 2013 R2.]

This topic describes the changes with the SharePoint adapter in BizTalk Server 2013 R2 and BizTalk Server 2013. There are two installation options: Client Side Object Model (CSOM) and Service Side Object Model (SSOM). Specifically:

Before You Install

Install the SharePoint Adapter: CSOM Steps

Install the SharePoint Adapter: SSOM (Deprecated)

Additional

Before You Install

BizTalk Server includes a SharePoint Services adapter that can receive messages or send messages to SharePoint Services. The Windows SharePoint Services (WSS) adapter has changed. If you are using SharePoint 2013, SharePoint Online, or SharePoint 2010, you can use the new Client Side Object Model (CSOM) to connect to SharePoint Services; which is recommended. BizTalk Server 2010 and previous versions use the Server Side Object Model (SSOM) to connect to SharePoint 2010. The SSOM option is deprecated.

The following table describes the differences between the installation options:

 

Installation option Description

SharePoint Services Adapter

Recommended. Uses the SharePoint Services Client Side Object Model (CSOM) by automatically installing the SharePoint Client Object Model Redistributable on the BizTalk Server. There are no installation requirements on the SharePoint computer.

SharePoint Client Object Model Redistributable

SharePoint Services Web Service

Deprecated. Uses the SharePoint Services Service Side Object Model (SSOM). An IIS web service is installed on the SharePoint Services computer, which can be on the same computer as BizTalk Server or a separate computer. In most environments, BizTalk Server and SharePoint Services are on separate computers.

The SharePoint Services support is listed in the following table:

 

  Supports CSOM Supports SSOM

SharePoint Services 2013

Yes

No

SharePoint Services Online

Yes

No

SharePoint Services 2010

Yes

Yes

SharePoint Services 2007

ImportantImportant
Not supported with BizTalk Server 2013 R2.

No

Yes

Install the SharePoint Adapter: CSOM Steps

  1. Use a SharePoint computer based on the following requirements:

     

      CSOM Support

    SharePoint Services 2013

    Install and deploy SharePoint 2013

    Yes

    SharePoint Services Online

    SharePoint Online administration

    Yes

    SharePoint Services 2010

    Installation and Deployment for SharePoint Server 2010

    Yes

    SharePoint Services 2007

    ImportantImportant
    Not supported with BizTalk Server 2013 R2.

    No

  2. On the BizTalk Server, install Windows Identity Foundation:

     

    Windows 8.1, Windows Server 2012, and Windows Server 2012 R2

    Windows Identity Foundation is included with the operating system as a Feature in Turn Windows features on or off.

    Windows 7 SP1

    Download available at Windows Identity Foundation.

  3. On the BizTalk Server, install BizTalk Server. Do not check Windows SharePoint Services Adapter. See Installation Overview for BizTalk Server 2013 and 2013 R2.

Additional

  • When BizTalk Server is installed, it automatically installs the SharePoint Client Object Model Redistributable on the BizTalk Server. There are no installation requirements on the SharePoint Services computer.

Install the SharePoint Adapter: SSOM (Deprecated)

  1. Use a SharePoint Services computer based on the following SSOM requirements:

     

      SSOM Support

    SharePoint Services 2013

    Install SharePoint 2013

    No

    SharePoint Services Online

    SharePoint Online administration

    No

    SharePoint Services 2010

    Installation and Deployment for SharePoint Server 2010

    Yes

    SharePoint Services 2007

    Installation for SharePoint Server 2007

    ImportantImportant
    Not supported with BizTalk Server 2013 R2.

    Yes

  2. On the SharePoint Services computer, configure SharePoint and extend the Default Web Site. When you extend the web site, a separate IIS web site is created that contains the same content but also provides a unique URL and authentication type.

    See SharePoint 2010: Extend a Web Application.

  3. On the SharePoint Services computer, run the BizTalk Server installation and only check Windows SharePoint Services Adapter. This installs the web service. Do not run the BizTalk configuration.

  4. On the BizTalk Server, install BizTalk Server (Installation Overview for BizTalk Server 2013 and 2013 R2). Do not check Windows SharePoint Services Adapter.

  5. The SharePoint Services Web Service (SSOM) only runs in 64-bit mode. ASP.NET and the IIS application pool must be in 64-bit mode on the SharePoint computer before installing SharePoint. To do this:

    • ASP.NET: Open IIS Manager, click the web site, and then double-click Handler Mappings. In the Enabled list, confirm PageHandlerFactory-ISAPI-2.0-64 is listed.

    • Application Pool: Open IIS Manager, click Application Pools, select the application pool, and then click Advanced Settings. In Enable 32-bit applications, select False.

Additional

  • The BizTalk Server SharePoint Services adapter uses an IIS web service installed on the SharePoint Services computer. This web service installation option (SSOM) is deprecated.

Additional

  • The SharePoint Services Web Service (SSOM) installed on the SharePoint Server is deprecated. Instead, use the adapter with the CSOM option. The CSOM option installs the SharePoint Client Object Model Redistributable package on the BizTalk Server, not on the SharePoint computer.

  • The SharePoint Services SSOM and CSOM components can both be installed if BizTalk Server and SharePoint Services are installed on the same computer.

  • CSOM is automatically installed when BizTalk Server is installed with no additional steps or installation requirements.

  • If you do not use the SSOM option (the web service on the SharePoint computer), then do not check Windows SharePoint Services Adapter in the BizTalk installation.

  • The BAM Portal only runs in 32-bit mode. If the BAM Portal is installed on a 64-bit machine, ensure that ASP.NET 2.0 32-bit is enabled and the IIS application pool is in 32-bit mode. To do this:

    • ASP.NET: Open IIS Manager, click the BAM Portal web site, and then double-click Handler Mappings. In the Enabled list, confirm PageHandlerFactory-ISAPI-2.0 is listed.

    • Application Pool: Open IIS Manager, click Application Pools, click the BAMAppPool, and then click Advanced Settings. In Enable 32-bit applications, select True.

  • When installing SharePoint Services, click the Server Farm option, even when you are creating a single-server BizTalk Server and SharePoint Services installation. A Server Farm installation allows you to configure the SharePoint Services databases.

  • CSOM: SharePoint Services Adapter provides information on configuring a SharePoint receive location and send port.

See Also

© 2014 Microsoft Corporation. All rights reserved.

Community Additions

ADD
Show:
© 2015 Microsoft