VirtualViewer®

xCP Designer Integration Guide

DOC-0200-01

Copyright InformationWhile Snowbound® Software believes the information included in this publication is correct asof the publication date,information in this document is subject to change without notice.

UNLESSEXPRESSLYSET FORTH IN AWRITTEN AGREEMENT SIGNED BYAN AUTHORIZEDREPRESENTATIVEOF SNOWBOUND SOFTWARECORPORATIONMAKESNOWARRANTYORREPRESENTATIONOF ANYKINDWITH RESPECT TOTHE INFORMATION CONTAINED HEREIN,INCLUDINGWARRANTYOF MERCHANTABILITYAND FITNESSFOR APURPOSE. Snowbound Software Cor-poration assumesno responsibility or obligation of any kind for anyerrors contained herein or in connection with the fur-nishing, performance, or use of this document.

Software described in Snowbound documents (a) is the property of Snowbound Software Corporation or the thirdparty, (b) is

furnished only under license, and (c) maybe copied or used only asexpressly permitted under the termsof the license.

All contents of thismanual are copyrighted bySnowbound Software Corporation. The information contained herein isthe exclusive property of Snowbound Software Corporation and shall not be copied, transferred, photocopied, trans-lated on paper, film, electronicmedia, or computer-readable form, or otherwise reproduced in anyway, without theexpresswritten permission of Snowbound Software Corporation.

Microsoft, MS,MS-DOS,Windows,WindowsNT, and SQLServer are either trademarksor registered trademarksofMicrosoft Corporation in the United Statesand/or other countries.

Adobe, the Adobe logo, Acrobat, and the Acrobat logo are trademarksof Adobe Systems Incorporated.

Sun, SunMicrosystems, the Sun Logo, and Java are trademarksor registered trademarksof SunMicrosystems, Inc.in the United Statesand other countries.

Kakadu JPEG2000©, is copyrighted byDr. David Taubman, and is proprietary to NewSouth Innovations, Pty. Ltd, Aus-tralia.

iText Copyright (c) 1998-2016 iText Group NV, Authors: Bruno Lowagie, Paulo Soares, et al iText® is a registeredtrademarkof iText Group NV.

Aspose™, Aspose.Cells© (copyrighted 2003), Aspose.Words© (copyrighted 2003), and Aspose.Slides© (copy-righted 2004), are all proprietary to Aspose Software, Pty. Ltd, Australia.

I-NET JWebEngine© is proprietary to I-NET Software GmbH, and shall remain the sole and exclusive property of I-Net Software GmbH.

United States Government Restricted RightsThe Software is provided with RESTRICTED RIGHTS. Use, duplication or disclosure by the United StatesGovern-ment is subject to restrictionsas set forth under subparagraph (c)(1)(ii) of The Rights in TechnicalData and ComputerSoftware clause of DFARS252.227 –19 or subparagraphs (c)(i) and (2) of the CommercialComputer Software-Restricted Rights at 48 CFR 52.227 – 19 asapplicable. TheManufacturer isSnowbound Software Corporation, 309WaverleyOaksRd., Suite 401,Waltham,MA02452, USA.All other trademarksand registered trademarksare the property of their respective holders.Manual Title:Snowbound Software VirtualViewer® xCPDesigner Integration GuidePart Number: DOC-0200-01Revision: 01Printing Date: April 2017Published bySnowbound Software Corporation.309WaverleyOaksRoad, Suite 401Waltham,MA02452 USAphone: 617-607-2000fax: 617-607-2002©1996 - 2017 bySnowbound Software Corporation. All rights reserved.

Table of Contents

Chapter 1 - Integrating the VirtualViewer with xCP Designer 4

III

Chapter 1 - Integrating the VirtualViewer with xCP Designer

Chapter 1 - Integrating the VirtualViewerwith xCP DesignerThe following explains how to integrate VirtualViewer win xCP Designer:

1. Get the SnowboundVirtualViewer.jar file from Snowbound and place it in local

machine where xCP Designer is present.

2. Open your design time xCP Application in xcp Designer.

3. Go toApplication Model Tab in Designer.

4

Chapter 1 - Integrating the VirtualViewer with xCP Designer

4. Once in ApplicationModel Tab, you will find on the right hand corner, Libraries.

5. Here wewill either add or update the libraries for Snowbound related server end pro-

gramming done for SB Integration.

6. The name of the jar file uploaded is:

“sb.SnowboundVirtualViewer-2.3.0.jar”

sb - It is namespace for the Imported library which we can provide while configuring

2.3.0 - It is the version label of the jar which we give while configuring

8. On Click of Add /Update Library, the following screen appears. Please select the jar file

from the local folder and in Next screen, enter namespace and version. Click on Finish.

5

Chapter 1 - Integrating the VirtualViewer with xCP Designer

9. Go to Application UI tab in xCP Designer. And create one view Base content.

6

Chapter 1 - Integrating the VirtualViewer with xCP Designer

10. From the palette, drag and drop viewer widget and rename the properties as shown in the

screenshot below and ensure to select preferred viewer as Snowbound.

7

Chapter 1 - Integrating the VirtualViewer with xCP Designer

11. Once above steps are done, click on theSave All icon in menubar of xCPDesigner.12. And click on theRefresh button.

13. Then click on theValidate button.

14. Then click on thePackage button.

15. On Click of thePackage Application button, place where you want the export to

appear.

8

Chapter 1 - Integrating the VirtualViewer with xCP Designer

16. Click onOK and click on Finish.

9

Chapter 1 - Integrating the VirtualViewer with xCP Designer

17. xCP Designer will package, validate the design time Application with the Snowbound

related changes. The outcome of above step is a *.war file, which we need to deploy in

the Application server where we have configured all the prerequisites  as per the xCP 2.3

deployment guide.

18. TheWAR file by design time <Namespace>-Application name-<Version> will be cre-

ated.

19. Rename theWAR file to the name of the application which you want to show in the URL

As an example, xCPSnowbound

10

Chapter 1 - Integrating the VirtualViewer with xCP Designer

l Deploy theWAR file.

l Follow Guide-2, to configure the deployment WAR for VirtualViewer.

11