Prizm Content Connect Plus for SharePoint Installation Guide for...

38
Prizm Content Connect Plus for SharePoint Installation Guide for Windows Version 6.2

Transcript of Prizm Content Connect Plus for SharePoint Installation Guide for...

Page 1: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

Prizm Content Connect Plus for SharePoint Installation Guide for Windows

Version 6.2

Page 2: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

2

Published January 2013

Accusoft believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED AS IS. WE MAKE NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WITH RESPECT TO THE INFORMATION IN

THIS PUBLICATION, AND SPECIFICALLY DISCLAIM IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

Use, copying, and distribution of any software described in this publication requires an applicable

software license.

For the most up‑to‑date listing of product names, see www.accusoft.com.

All other trademarks used herein are the property of their respective owners.

Page 3: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

3

Attributions, Notices & Copyrights

Apache PDFBox (http://pdfbox.apache.org/) Copyright 2002-2010 The Apache Software Foundation

Download: http://pdfbox.apache.org/download.html License: http://www.apache.org/licenses/LICENSE-2.0

Apache FontBox (http://pdfbox.apache.org/)

Copyright 2008-2010 The Apache Software Foundation

Download: http://pdfbox.apache.org/download.html License: http://www.apache.org/licenses/LICENSE-2.0

Apache JempBox (http://pdfbox.apache.org/)

Copyright 2008-2010 The Apache Software Foundation

Download: http://pdfbox.apache.org/download.html License: http://www.apache.org/licenses/LICENSE-2.0

Apache POI (http://poi.apache.org/)

Copyright 2001-2007 The Apache Software Foundation Download: http://www.apache.org/dyn/closer.cgi/poi/

License: http://www.apache.org/licenses/LICENSE-2.0

Apache Commons FileUpload (http://commons.apache.org/fileupload/)

Copyright 2002-2008 The Apache Software Foundation Download: http://commons.apache.org/fileupload/download_fileupload.cgi

License: http://www.apache.org/licenses/LICENSE-2.0

Apache Commons IO (http://commons.apache.org/io/)

Copyright 2001-2008 The Apache Software Foundation Download: http://commons.apache.org/io/download_io.cgi

License: http://www.apache.org/licenses/LICENSE-2.0

Apache Commons Lang (http://commons.apache.org/lang/)

Copyright 2001-2010 The Apache Software Foundation Download: http://commons.apache.org/lang/download_lang.cgi

License: http://www.apache.org/licenses/LICENSE-2.0

Apache Commons Logging (http://commons.apache.org/logging/)

Copyright 2003-2007 The Apache Software Foundation Download: http://commons.apache.org/logging/download_logging.cgi

License: http://www.apache.org/licenses/LICENSE-2.0

ImageMagick (http://www.imagemagick.org)

Copyright 1999-2010 ImageMagick Studio LLC. Download: http://www.imagemagick.org/script/binary-releases.php

License: http://www.imagemagick.org/script/license.php

ffmpeg (http://ffmpeg.org/) Copyright (C) 2000, 2001, 2002 Fabrice Bellard

Source: <install path>\src\ffmpeg\r20545\

Download: http://image_magick.veidrodis.com/image_magick/binaries/ImageMagick-6.6.5-3-Q16-windows-static.exe

Page 4: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

4

License (GPL v3): <install path>\Prizm\licenses\ImageMagick\Notice-1.txt

Attributions, Notices & Copyrights Implementation/Integration: This open source product has not been recompiled and a call to

binary file is directly made from the code, keeping the binaries totally separate from the Prizm Content Connect Plus

Source Code. dcraw.exe (http://www.cybercom.net/~dcoffin/dcraw/)

Copyright (C) 1997-2008 by Dave Coffin. Source: <install path>\src\dcraw\9.03\

Download: http://image_magick.veidrodis.com/image_magick/binaries/ImageMagick-6.6.5-3-Q16-windows-static.exe

License (GPL v3): <install path>\Prizm\licenses\ImageMagick\Notice-1.txt

Implementation/Integration: This open source product has not been recompiled and a call to binary file is directly made from the code, keeping the binaries totally separate from the Prizm

Content Connect Plus Source Code.

hp2xx.exe (http://www.gnu.org/s/hp2xx/)

Copyright (C) 1998 - 2000 M. Kroeker, 1992 - 1994 H. Werntges. Source: <install path>\src\hp2xx\3.4.2\

Download: http://image_magick.veidrodis.com/image_magick/binaries/ImageMagick-6.6.5-3-Q16-windows-static.exe

License (GPL v2): <install path>\Prizm\licenses\ImageMagick\hp2xx_gpl-2.0.txt Implementation/Integration: This open source product has not been recompiled and a call to

binary file is directly made from the code, keeping the binaries totally separate from the Prizm

Content Connect Plus Source Code.

Java Advanced Imaging API (http://java.sun.com/javase/technologies/desktop/media/jai/) Copyright (c) 2006 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054,

U.S.A. All rights reserved.

Download: http://download.java.net/media/jai/builds/release/1_1_3/ License: http://download.java.net/media/jai/builds/release/1_1_3/LICENSE-jai.txt

Java Advanced Imaging Image I/O Tools (http://java.sun.com/javase/technologies/desktop/media/) Copyright (c) 2006 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054, U.S.A. All rights reserved. Download: http://download.java.net/media/jai-imageio/builds/release/1.1/License: http://download.java.net/media/jai-imageio/builds/release/1.1/LICENSE-jai_imageio.txt

JavaMail 1.4.3 (http://www.oracle.com/technetwork/java/javamail/index.html) Copyright © 2009 Sun Microsystems, Inc., 4150 Network Circle, Santa Clara, California 95054,

U.S.A. All rights reserved. Download: http://www.oracle.com/technetwork/java/javamail/index-138643.html

License: http://download.oracle.com/otn-pub/java/licenses/javamail-1.4.3-oth-

JPR_license_1.html

JDOM This product includes software developed by the JDOM Project (http://www.jdom.org/).

Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin. All rights reserved. Source: http://www.jdom.org/downloads/source.html

Download: http://www.jdom.org/downloads/index.html

Page 5: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

5

License: <install path>\Prizm\licenses\jdom\LICENSE.txt

(http://www.jdom.org/docs/faq.html#a0030)

JRE 1.6.0.22 (http://java.sun.com/products/archive/j2se/6u22/index.html) Copyright © 2006, 2010, Oracle and/or its affiliates. All rights reserved.

Download: http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-

downloads-javase6-419409.html#jre-6u22-oth-JPR License: http://www.oracle.com/technetwork/java/javase/terms/license/index.html

ODF Converter (http://odf-converter.sourceforge.net/)

Copyright (c) 2006-2008, Clever Age, DIaLOGIKa, Sonata Software Ltd All rights reserved. Download: http://sourceforge.net/projects/odf-converter/files/

License: http://odf-converter.sourceforge.net/#license

OpenOffice.org Portable (http://portableapps.com/apps/office/openoffice_portable)

Copyright 2002,2008 Sun Microsystems, Inc. Source:

http://sourceforge.net/projects/portableapps/files/Source%20%28OpenOffice.org%29/OpenOffic

e.org%203.2.0%20Source/ Download:

http://sourceforge.net/projects/portableapps/files/OpenOffice.org%20Portable/OpenOffice.org%20Portable%203.2.0/OpenOfficePortable_3.2.0_English.paf.exe/download

http://sourceforge.net/projects/portableapps/files/OpenOffice.org%20Portable/OpenOffice.org%20Portable%203.0/OpenOffice.org_Portable_3.0_en-us.paf.exe/download

License (LGPL v3): <install path>\Prizm\licenses\OpenOfficePortable\license.txt

Implementation/Integration: This open source product has not been recompiled and a call to binary file is directly made from the code, keeping the binaries totally separate from the Prizm

Content Connect Plus Source Code.

String Search (http://johannburkard.de/software/stringsearch/)

StringSearch - high-performance pattern matching algorithms in Java Copyright (c) 2003-2010 Johann Burkard

Download: http://johannburkard.de/software/stringsearch/

License: http://johannburkard.de/software/stringsearch/copying.txt

The Legion of the Bouncy Castle Copyright (c) 2000-2009 The Legion Of The Bouncy Castle (http://www.bouncycastle.org)

Download: http://bouncycastle.org/latest_releases.html License: http://www.bouncycastle.org/licence.html

Touch.exe (http://www.codeproject.com/KB/applications/touch_win.aspx) Copyright 2002 by Jörgen Sigvardsson

Download: http://www.codeproject.com/KB/applications/touch_win.aspx License: http://www.codeproject.com/KB/applications/touch_win.aspx

JTNEF (http://www.freeutils.net/source/jtnef/) The JTNEF package used in this product is copyright (c) 2003-2010 by Amichai Rothman.

JavaBeans Activation Framework (http://www.oracle.com/technetwork/java/javase/downloads/index-135046.html)

Download: http://www.oracle.com/technetwork/java/javasebusiness/downloads/java-archive-

Page 6: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

6

downloads-java-plat-419418.html#jaf-1.1-fr-oth-JPR

License: http://download.oracle.com/otn-pub/java/licenses/jaf-1.1-mrel-spec-oth-JPR_license_1.html

SWF Tools (http://www.swftools.org)

Source: <install path>/src/SWFTools/0.9.0/

Download: http://www.swftools.org/swftools-0.9.0.exe Attributions, Notices & Copyrights

License (GPL v2): <install path>/Prizm/licenses/SWF Tools/gpl-2.0.txt

Implementation/Integration: This open source product has not been recompiled and a call to binary file is directly made from the code, keeping the binaries totally separate from the Prizm

Content Connect Plus Source Code.

Tanuki Java Service Wrapper (http://www.tanukisoftware.com)

Copyright (C) 1999, 2010 Tanuki Software, Ltd. All rights reserved. The Software Program includes software and documentation components developed in part by

Silver Egg Technology, Inc.("SET") prior to 2001 and released under the following license.

Copyright (c) 2001 Silver Egg Technology Permission is hereby granted, free of charge, to any person

obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without

restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sub-license, and/or

sell copies of the Software, and to permit persons to whom the

Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

GraphicsUtil (http://www.dncompute.com/blog/2008/07/17/graphicsutil-a-utility-class-for-drawing-arrows.html)

Copyright (c) 2008 Noel Billig (www.dncompute.com) Download: http://www.dncompute.com/blog/2008/07/17/graphicsutil-a-utility-class-for-drawing-

arrows.html

License: MIT (in source)

URL Validator (http://ctrloptcmd.com/archives/587/actionscript-3-url-validator-class/) Copyright 2009 Martin Jacobsen

Download: http://ctrloptcmd.com/as3/URLValidator.as License: (in source)

jQuery (http://jquery.org/) Copyright (c) 2011 John Resig

Download: http://docs.jquery.com/Downloading_jQuery License: http://jquery.org/license/

Lazy Load - jQuery plugin for lazy loading images (http://www.appelsiini.net/projects/lazyload) Copyright (c) 2007-2009 Mika Tuupola

Download: http://www.appelsiini.net/projects/lazyload License: http://www.opensource.org/licenses/mit-license.php

Page 7: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

7

jQuery.ScrollTo (http://plugins.jquery.com/project/ScrollTo)

Copyright (c) 2007-2009 Ariel Flesler Download: http://plugins.jquery.com/node/635/release

License: MIT (in source)

ScrollView - jQuery plugin (http://code.google.com/p/jquery-scrollview/)

Copyright (c) 2009 Toshimitsu Takahashi Download: http://code.google.com/p/jquery-

scrollview/downloads/detail?name=jquery.scrollview.js&can=2&q= License: http://www.opensource.org/licenses/mit-license.php

Viewport - jQuery selectors for finding elements in viewport

(http://www.appelsiini.net/projects/viewport)

Copyright (c) 2008-2009 Mika Tuupola Download: http://www.appelsiini.net/projects/viewport

License: http://www.opensource.org/licenses/mit-license.php

transform: A jQuery cssHooks adding cross-browser 2d transform capabilities to $.fn.css() and

$.fn.animate() (https://github.com/louisremi/jquery.transform.js)

Copyright 2011 @louis_remi Download: https://github.com/louisremi/jquery.transform.js

License: MIT (https://github.com/louisremi/jquery.transform.js)

jQuery UI (http://jqueryui.com/)

Copyright (c) 2011 Paul Bakaus Download: http://jqueryui.com/download

License: http://jquery-ui.googlecode.com/svn/tags/latest/MIT-LICENSE.txt

jquery.waitforimages (http://alexanderdickson.com/blog/2011/02/a-new-jquery-plugin-2/)

Copyright (c) 2011 Alex Dickson Download: https://github.com/alexanderdickson/waitForImages

License: https://github.com/alexanderdickson/waitForImages/blob/master/README.md

jQuery Context Menu Plugin (http://abeautifulsite.net/blog/2008/09/jquery-context-menu-

plugin/) Copyright A Beautiful Site, LLC

Download: http://abeautifulsite.net/blog/2008/09/jquery-context-menu-plugin/ License: MIT (in source)

jqprint (http://plugins.jquery.com/project/jqPrint)

Provided by Eros Fratini - [email protected]

Download: http://plugins.jquery.com/node/8069/release License: http://www.opensource.org/licenses/mit-license.php

jQuery Patch (http://www.zachstronaut.com/posts/2009/08/07/jquery-animate-css-rotate-

scale.html)

2009-2010 Zachary Johnson www.zachstronaut.com Download: https://github.com/zachstronaut/jquery-animate-css-rotate-scale/

License: MIT (https://github.com/zachstronaut/jquery-animate-css-rotate-scale/blob/master/README)

Page 8: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

8

Google Translate API for .NET (http://code.google.com/p/google-api-for-dotnet/)

Copyright (c) 2008-2009 iron9light Download: http://code.google.com/p/google-api-for-dotnet/downloads/list

License: http://www.opensource.org/licenses/mit-license.php Other Terms: http://code.google.com/apis/language/translate/terms.html

SWFObject (http://code.google.com/p/swfobject/) Provided by code.google.com

Download: http://code.google.com/p/swfobject/downloads/list License: http://www.opensource.org/licenses/mit-license.php

Page 9: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

9

Preface

This document describes how to install Prizm Content Connect Plus for SharePoint on Windows Server, and integrate the Viewer with your existing SharePoint installation.

Intended Audience This manual is intended for IT developers and administrators. Some familiarity with SharePoint development, .Net, JavaScript, and Windows OS is expected.

Page 10: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

10

Table of Contents

ATTRIBUTIONS, NOTICES & COPYRIGHTS .................................................................... 3

PREFACE ......................................................................................................................... 9

INTENDED AUDIENCE ............................................................................................................... 9

TABLE OF CONTENTS .................................................................................................... 10

CHAPTER 1: INTRODUCTION ....................................................................................... 11

SPECIFICATIONS: SERVER ....................................................................................................... 11 Supported Operation Systems ........................................................................................ 11 System Requirements .................................................................................................... 11

SPECIFICATIONS: CLIENT ........................................................................................................ 11

CHAPTER 2: INSTALLATION OF PRIZM CONTENT CONNECT PLUS .............................. 12

CHAPTER 3: PREREQUISITES ....................................................................................... 13

CHAPTER 4: DECIDING ON YOUR DEPLOYMENT & INTEGRATION ............................. 14

WHERE ARE THE DEPLOYMENT INSTRUCTIONS? ............................................................................ 14

CHAPTER 5: INSTALLATION WITH INSTALLERS AND WEBPARTS............................... 15

USING THE INSTALLER FOR SHAREPOINT .................................................................................... 15 USING WEB PARTS PROVIDED BY ACCUSOFT ............................................................................... 24

Using the Document Preview Custom Field ..................................................................... 26 Using the Document Library Tree Viewer Web part ......................................................... 28

CHAPTER 6: SHAREPOINT CLIENT INTEGRATION FEATURES ..................................... 37

Page 11: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

11

Chapter 1: Introduction

Prizm Content Connect is a web-based online document viewer and can be embedded into any web page or linked to from any website. The Flash and HTML5 viewers use AJAX technology to

communicate with the server to create a fast rendering of your content on the fly.

The document viewers can be embedded into any web application allowing content publishers,

bloggers and individual users to publish content and embed their documents in their web pages, while still maintaining the integrity, consistency and look and feel of the document.

Prizm Content Connect can help you streamline your content integration efforts. Leverage web technologies to get a completely scalable content viewer that easily handles over 300 different

types of content with unmetered volume.

Specifications: Server

Supported Operation Systems

Windows Server 2003 R2 (32-bit & 64-bit)

Windows Server 2008 (32-bit & 64-bit)

Windows Server 2008 R2 (32-bit & 64-bit) Windows Vista (32-bit & 64-bit)

Windows 7 (32-bit & 64-bit)

System Requirements

Minimum 2GB RAM (Recommended 4GB+ RAM) 450 MB of free disk space

Java Runtime Environment: Oracle JavaSE 1.6.0.23 or later

Specifications: Client Flash Viewer minimum browser requirements:

Internet Explorer 5+

Mozilla Firefox 2+

Page 12: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

12

Chapter 2: Installation of Prizm Content Connect Plus

Installation of Prizm Content Connect Plus is very straightforward for the Windows environment and is a required prerequisite for installing the Prizm Content Connect Plus for SharePoint

integration components.

Before continuing with the instructions in this document, make sure you have completed the

installation of Prizm Content Connect Plus, as described in the PCC Installation Guide found in the PCC help file.

Page 13: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

13

Chapter 3: Prerequisites

This document assumes the following: You will install Prizm Content Connect on the same server as your SharePoint installation

You have created a ‘Document Library’ in SharePoint and uploaded some sample

documents in it

You have Microsoft Office SharePoint Designer installed

Sharepoint 2010 WebConfig Changes

Follow these steps if you are using Sharepoint 2010 / Sharepoint 14:

- Open the following file in notepad to edit it:

C:\inetpub\wwwroot\wss\VirtualDirectories\80\web.config - Change this statement in the file <pages enableSessionState="false" to <pages

enableSessionState="true" - Remove this statement from the file <remove name="Session" />

Page 14: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

14

Chapter 4: Deciding on your Deployment & Integration You can deploy Prizm Content Connect Plus for SharePoint integration component using several

different approaches. One or more of the following approaches may be used depending on your

requirements and architecture.

1) Using the Installers for SharePoint Prizm Content Connect Plus for SharePoint comes with a pre-configured set of installers that

install all of the necessary pre-requisite files on SharePoint to start using it easily. Running these

installers will enable you to deploy the viewer for use with Document Libraries and controlling Digital Rights Management. Additionally, these installers enable the installation approaches 2 and

3 below.

2) Using Web Parts Provided by Accusoft

The Document Library Viewer Web Part and Preview Custom Field are available to add additional functionality to the integration with SharePoint. These enable new ways of viewing documents in

a library, such as displaying a tree view for exploring and viewing documents in the library, or adding a new field to a list where the field displays a link to preview the document in a new

browser window. This installation approach builds on top of the approach Using the Installers for SharePoint.

3) Manual Integration This method demonstrates to ways of manually customizing SharePoint to integrate Prizm

Content Connect Plus using SharePoint Designer, Web Part Pages, and Content Editor Web Parts. This is an alternative to installing the parts from method 2 above.

4) Using WebDAV When you install Prizm on SharePoint, the viewer needs to access the documents in the

Document Library. Access to the documents in Document Library can be provided by using WebDAV; this is an alternative to the method of accessing the documents using the server-side

object model, as done in items 1, 2, and 3 above. Sample code and instructions for integrating using the WebDAV approach need to be requested from Accusoft Sales, these items ship

separately from the main Prizm Content Connect for SharePoint packages.

Note that the instructions and web tier code for integrating Prizm Content Connect Plus with

SharePoint using WebDAV are for the standard (non-Plus) version of the product.

Where are the Deployment Instructions? For methods 1 and 2 above, Using the Installers for SharePoint and Using Web Parts Provided by Accusoft, installation and deployment instructions can be found in the sections of this document

below.

For method 3, Manual Integration, installation and deployment instructions can be found in the

document Windows-InstallGuide-PCC-PCCPlus-SP-Manual.doc.

For method 4, Using WebDAV, installation and deployment instructions can be found in Windows-

InstallGuide-PCC-SP-WebDAV.doc. Note that the sample code and instructions for integrating

Page 15: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

15

using the WebDAV approach need to be requested from Accusoft Sales, these items ship

separately from the main Prizm Content Connect for SharePoint packages.

Chapter 5: Installation with Installers and WebParts

Using the Installer for SharePoint 1) Download the SharePoint Installation Zip file and unzip it. This file is different for a SharePoint

2007 and 2010 installation.

For SharePoint 2007 – PCCPlusSharePoint2007.zip

For SharePoint 2010 – PCCPlusSharePoint2010.zip

2) Create the tempcache and markups storage locations.

Create a directory named “tempcache” on your C: drive. It should look like C:\tempcache.

Give all users read/write permissions to this directory.

Create a directory named “markups” on your C: drive. It should look like C:\markups. Give all

users read/write permissions to this directory.

3) Check the aHandler file Make sure aHandler.config file exists in your Prizm Content Connect installation directory, the

default location of this install directory is C:\Prizm folder. If file does not exist, create a new one in notepad and add contents below

TemporaryPathToDownloadSharePointFiles=C:\tempcache customURLToRedirectTo=/_layouts/Prizm/default.aspx

URLVariableToPost=documentURL NameVariableToPost=document

UserGroupVariableToPost=userType

encrypt=1

4) Install Right click to run PrizmViewerInstaller.exe and click on Run As Administrator (Option if Available).

Also make sure you uncheck “Run this with restricted access” (Option if Available).

This will open a window. Click on “Install Prizm SharePoint Viewer”. Wait a minute for IIS restart

to happen. A dialog will appear when installation is complete. Close the Installer dialog window by clicking on “x” cross on right top corner.

Page 16: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

16

Page 17: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

17

5) Setup

SharePoint 2007 Right click to run Install.bat and click on Run As Administrator (Option if Available). Also make

sure you uncheck “Run this with restricted access” (Option if Available).

SharePoint 2010

Right click to run Setup.exe and click on Run As Administrator (Option if Available). Also make sure you uncheck “Run this with restricted access” (Option if Available).

Follow the prompts on the installer to install.

Make sure Windows SharePoint Services Administration service is running in Services in Control

Panel.

Page 18: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

18

Page 19: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

19

Page 20: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

20

6) Configure

After installation & setup, next step is to configure the viewer from within Central Administrator Open the SharePoint Central Administration Site

Click on Application Management

Click on “Prizm Configuration” and then “Manage Viewer & Rights Management” Select the site, document library and User Group from the drop down

Select the permissions for viewer Click on Enable the Viewer.

Viewer will be turned on for the User Group for that site document library. Browse to the document library in the site and click on a document. It should now open in the

viewer.

Troubleshooting Tips

If you see a SharePoint Correlation Error when you browse to viewer, it could be due to

permissions error on installation files. Make sure that Prizm directory has WSS User Accounts access

Give full access to following users on WSS_WPG

WSS_ADMIN_WPG IUSR_

IWAM_

on directory C:\Program Files\Common Files\Microsoft

Shared\webserverextensions\12\TEMPLATE\LAYOUTS\Prizm (for SharePoint 2007 & WSS)

Page 21: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

21

C:\Program Files\Common Files\Microsoft

Shared\webserverextensions\14\TEMPLATE\LAYOUTS\Prizm (for SharePoint 2010)

Note- Setting Copy/Print/Save permissions as No for Viewer does NOT change the rights on

document in SharePoint for that User Group. It simply turns off the buttons on viewer.

To make DRM work properly, see next step (7) Setting the rights

SharePoint 2010

Page 22: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

22

SharePoint 2007

Page 23: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

23

7) Setting the rights Prizm Content Connect Plus comes with Digital Rights Management (DRM) capabilities.

DRM does NOT alter or change the existing rights of documents in SharePoint, but works with them.

If a user has full permissions on a document library in SharePoint, turning Save/Download off in Central Administrator for the viewer will only turn off the save button in the viewer. It will not

change the rights of user in SharePoint.

To make DRM work correctly with SharePoint, ensure the following-

Assign viewer rights to built-in User Groups like “Home_Visitors” or “Viewers” only

Or

- Create a new User Group in SharePoint and assign it View only Permission Set - Add members to the UserGroup and assign members to document library

- Turn on/off rights for that UserGroup in Central Administrator under Prizm Configuration in

Application Management

Assigning specific Viewer Rights to User Groups with full permissions like “Home_Owners” or “Home_Members” will not make DRM work correctly as those User Groups will have full

permissions set in SharePoint.

Note- SharePoint already has View only UserGroups pre-built.

These are “Home_Visitors” in SharePoint 2007 & WSS and “Home_Visitors” & “Viewers” in SharePoint 2010.

Page 24: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

24

Note- If you do not want to use the default “Home_Visitors” & “Viewers” user groups, you can create your own similar groups using the following steps:

1) Create a new permission level set

a) Browse to

Home > Site Actions >Site Settings > Advanced Permissions > Permission Levels (for SharePoint 2007)

Home > Site Actions >Site Settings > Site Permissions > Permission Levels (for SharePoint 2010)

b) Double Click on “Read” or “View Only” permission level and scroll down to “Copy Permission Level”.

c) Give a Name like “DocumentViewOnly”

d) Uncheck “Use Client Integration Features” checkbox. See Appendix of this document on – “SharePoint Client Integration Features” for more details on

this. e) Click on Create

2) Create a new user group a) Browse to

Home > Site Actions >People and Groups >New ->New Group (for SharePoint 2007) Home > Site Actions >Site Settings > Site Permissions -> Create Group (for SharePoint 2010)

b) Enter name of group like “Document View Group” c) Scroll down and Choose the permission level group as “DocumentViewOnly” – the one you

created in step above

d)Click on Create

3) Now you can add users/members to this group and assign group/users to the document library

4) Finally, go to Central Administration and click on Prizm Configuration in Application Management. Assign appropriate rights to the User Group in Document Library under the site.

Using Web Parts Provided by Accusoft 1) Prerequisites

For web parts to run, make sure you have completed the installation in the previous section, Using the Installers for SharePoint.

Important! The web parts will not work correctly with a specific document library if you have enabled the viewer redirection for that document library, as defined in the previous section. You

must first disable viewer redirection for the document library that you will be deploying the web parts to. Disable redirection through the page at Central Administration > Application

Management > Prizm Configuration > Manage Viewer & Rights Management, using the instructions from the previous sections.

2) Ensure the existence of the tempcache and markups storage locations. Ensure that the tempcache and markups directories were created as instructed in the section

Using the Installer for SharePoint. These directories should be located at C:\tempcache and C:\markups, respectively.

3) Browse & test

Page 25: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

25

Test Prizm by browsing to following link http://<sharepointserver>/_layouts/Prizm/index.aspx?document=test.doc

where test.doc is a document in location C:\tempcache

Note – To make above link work, place a document named test.doc in C:\tempcache

Troubleshooting Tips

1) If you browse to http://<SharePointserver>/_layouts/Prizm/index.aspx?document=test.doc and see IO Error in Viewer.

-- Make sure that test.doc is available in C:\tempcache 2) If you browse to http://<SharePointserver>/_layouts/Prizm/index.aspx?document=test.doc

and see a blank page or Some Error Occurred.

-- Make sure that the directory has WSS User Accounts access Give full access to following users on

WSS_WPG WSS_ADMIN_WPG

IUSR_

IWAM_ on directory

C:\Program Files\Common Files\Microsoft

Shared\webserverextensions\12\TEMPLATE\LAYOUTS\Prizm (for SharePoint 2007 & WSS)

C:\Program Files\Common Files\Microsoft Shared\webserverextensions\14\TEMPLATE\LAYOUTS\Prizm

(for SharePoint 2010)

Page 26: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

26

Using the Document Preview Custom Field

1) Download the Document Preview installation package.

Unzip the package onto the desktop of the server on which SharePoint is installed.

2) Run Install Prizm Previewer.bat by double clicking on it.

3) Add a new to your document libraries.

To set up the Column go to the document library,

Click on Settings in toolbar and Create Column (for SharePoint 2007) Select all items (checkbox) -> Library (on ribbon toobar) -> Create Column (for SharePoint 2010)

SharePoint 2007

SharePoint 2010

Page 27: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

27

Now in Column Name type the word “View” and then select the Prizm Custom Field checkbox and

click on OK. This will add a View Column in the Document Library. Clicking on View will open the document in a popup window of Prizm Content Connect Plus Viewer.

Page 28: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

28

Note – If you cannot see the column in the Document Library, you might need to create a View

of the Library.

Using the Document Library Tree Viewer Web part

1) Download the Web part.

Unzip the Web part on the desktop of the server on which SharePoint is installed.

2) Run Setup.exe following the wizard. Select which site collections you wish to deploy the web

part to.

Page 29: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

29

3) Create a new Web part page in SharePoint site with any name and save it in a site document

library or any other location.

SharePoint 2007

Page 30: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

30

For SharePoint 2010, create a page and Click on Insert Web part.

SharePoint 2010

4) Click to Add a Web part and select DocLibTreeViewer part under Accusoft section.

SharePoint 2007

Page 31: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

31

SharePoint 2010

Page 32: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

32

5) Click Edit to Modify the Shared Web part.

SharePoint 2007

SharePoint 2010

Page 33: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

33

6) Click on Web Part Settings to expand the options for configuring the Web part.

Page 34: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

34

Page 35: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

35

Fill in the various fields. When complete click OK and save the page.

Parameter Value Required

Authentication

Mode

Choose the method of Authentication you are using

for SharePoint

Yes

Document

Library Site

URL

This is the URL for the SharePoint Site containing the

the Document Library.

Example: http://servername/ http://servername/sites/testsite/

Yes

Document

Library Site Name

This is the name of the Document Library

Example: Docs Shared Documents

Yes

User Name This is the account username that will be used to access the documents in document library. If left

blank current logged in user account will be used.

No

User Password

Above account user password No

Windows

Authentication Domain

Above account user domain No

Local server

path to store the

documents in temporarily

This is where temp documents will be stored. If you

are using the default code and have not made any changes in source code, this would be C:\tempcache\

Yes

Viewer Site

URL:

This is the location where you set up Prizm. If you are

using default installation and have not made any changes in code, this should be

/_layouts/Prizm/index.aspx (to load viewer in full access mode)

/_layouts/Prizm/indexreadonly.aspx (to load viewer in read only mode)

You can create or modify asp files to load viewer as

per your requirements. (See Developer Guide :

Customizing the Viewer)

Yes

Frame Width Iframe height where viewer will be loaded.

Can be in percentage of pixels like 100% or 700px

Yes

Frame Height Iframe width where viewer will be loaded Can be in percentage of pixels like 100% or 700px

Yes

Generate

Unique Document

Names

(You should

Setting this parameter will make the viewer put

documents in temp location with unique names each time.

Unsetting this parameter will result in Viewer storing the documents with original names in C:\tempcache\.

You can use this parameter if your documents are not

changing and you want to load old generated files when new requests come.

You should always keep this NOT Checked, unless

necessary.

No

Page 36: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

36

always keep

this NOT Checked,

unless

necessary.)

Generate a

log file

For debug purposes.

You should always keep this NOT Checked, unless necessary.

No

Page 37: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

37

Chapter 6: SharePoint Client Integration Features

SharePoint’s ability to work seamlessly with Office 2007 and newer can be a great feature – when it works. Click to download and open a Word document, edit then save directly back to the

SharePoint site or using the Explorer View to bulk move files are both examples of integration

features that can boost productivity.

To get to Client Integration section, SharePoint Central Administration Web site, on the Application Management page, in the Application Security section, click Authentication providers.

Click the zone that you want to modify authentication settings for. The Edit Authentication page

opens.

Note- Enabling the Prizm Content Connect Plus for SharePoint viewer for any document library, turns OFF Client integration for that site. The reason is that the viewer acts as a redirector and

cannot work with Client integration On.

To change this, you have 2 options:

1) Turn on Client integration by default, but let it be turned off for the site in which the viewer will be used

2) Turn on Client integration by default, Create a New Permission Set with Client Integration Off

and Assign that permission level set to the User Groups & Users. You can also alter existing user

group and disable Client Integration only for Users & User Groups with that Permission Level Set.

Here are steps to create a new permission level set and new user group: Create a new permission level set -

a) Browse to

Home > Site Actions >Site Settings > Advanced Permissions > Permission Levels (for SharePoint 2007)

Home > Site Actions >Site Settings > Site Permissions > Permission Levels (for SharePoint 2010)

b) Double Click on “Read” or “View Only” permission level and scroll down to “Copy Permission Level”.

c) Give a Name like “DocumentViewOnly”

d) Uncheck “Use Client Integration Features” checkbox. See Appendix of this document on – “SharePoint Client Integration Features” for more details

on this. e) Click on Create

Create a new user group - a) Browse to

Home > Site Actions >People and Groups >New ->New Group (for SharePoint 2007) Home > Site Actions >Site Settings > Site Permissions -> Create Group (for SharePoint

2010)

b) Enter name of group like “Document View Group” c) Scroll down and Choose the permission level group as “DocumentViewOnly” – the one

you created in step above d) Click on Create

Now you can add users/members to this group and assign group/users to the document library

Page 38: Prizm Content Connect Plus for SharePoint Installation Guide for …products.accusoft.com/PCC/integrations/Sharepoint/6.2/... · 2013-01-21 · Prizm Content Connect Plus for SharePoint

38

Finally, go to Central Administration and click on Prizm Configuration in Application Management. Assign appropriate rights to the User Group in Document Library under the site.