Prizm Content Connect Plus for Sharepoint Installation Guide for Windows

Prizm Content Connect Plus for SharePoint Installation Guide for Windows

Version 6.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.

Attributions, Notices & Copyrights

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: \src\ffmpeg\r20545\ Download: http://image_magick.veidrodis.com/image_magick/binaries/ImageMagick-6.6.5-3- Q16-windows-static.exe 3

License (GPL v3): \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: \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): \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: \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): \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

License: \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): \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-

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: /src/SWFTools/0.9.0/ Download: http://www.swftools.org/swftools-0.9.0.exe Attributions, Notices & Copyrights

License (GPL v2): /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

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)

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

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.

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

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+

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.

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

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

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.

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.

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)

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

SharePoint 2007

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

- 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.

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 24

Test Prizm by browsing to following link http:///_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:///_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:///_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)

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

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.

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.

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

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

SharePoint 2010

5) Click Edit to Modify the Shared Web part.

SharePoint 2007

SharePoint 2010

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

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

Parameter Value Required Authentication Choose the method of Authentication you are using Yes Mode for SharePoint Document This is the URL for the SharePoint Site containing the Yes Library Site the Document Library. URL Example: http://servername/ http://servername/sites/testsite/ Document This is the name of the Document Library Yes Library Site Example: Docs Name Shared Documents User Name This is the account username that will be used to No access the documents in document library. If left blank current logged in user account will be used. User Above account user password No Password Windows Above account user domain No Authentication Domain Local server This is where temp documents will be stored. If you Yes path to store are using the default code and have not made any the changes in source code, this would be C:\tempcache\ documents in temporarily Viewer Site This is the location where you set up Prizm. If you are Yes URL: 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) Frame Width Iframe height where viewer will be loaded. Yes Can be in percentage of pixels like 100% or 700px Frame Height Iframe width where viewer will be loaded Yes Can be in percentage of pixels like 100% or 700px Generate Setting this parameter will make the viewer put No Unique documents in temp location with unique names each Document time. Names 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 (You should necessary. 35

always keep this NOT Checked, unless necessary.) Generate a For debug purposes. No log file You should always keep this NOT Checked, unless necessary.

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

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.