Release 7.0.354

Updates

  • Document Tab Context Menu – To provide control over the right-click context menu options for the document tabs.
  • Drag and Move Pages – Drag & move multiple selected pages via thumbnails using Ctrl/Shift Key.

APIs Added

  • setTabMenuHandler(function)
  • Annotation Preferences

Release 7.0.344

Updates

  • Custom Annotation Toolbar – Provided APIs that enable developers to build their own annotation toolbar.

APIs Added

  • setDrawingMode(modeName)
  • getDrawingMode()
  • _drawingModeChange(drawingMode) {
  • setDrawingModeChangeCallback(callback)

Release 7.0.338

Updates

  • Dirty Document Indication – To mark the document as either dirty or not.

APIs Added

  • displayAnnIndicator
  • setDirty
  • getAllDocumentInfo

Release 7.0.327

Updates

  • Multiple Cut, Copy, and Paste Pages – Support for multiple cut, copy, and paste processes of pages.
  • Saving Annotation in MO:DCA Format – Support for saving annotations in MO:DCA format.

Release 7.0.315

Updates

  • Enable/Disable Hyperlinks – Enable specific hyperlinks while rendering the documents and disabling the rest.

Release 7.0.311

Updates

  • Stamp Annotation
    • To improve this functionality by enhancing the user interface.
    • Users can create and edit the text and image stamps. Users can also manage the stamps.
  • Multilingual Annotation – Supports adding text in multiple languages in annotations or comments.
  • CSP Support.

APIs Added

  • gotoDocument()
  • gotoNextDocument()
  • gotoPrevDocument()
  • gotoFirstDocument()
  • gotoLastDocument()

Release 7.0.309

Callback APIs Added

  • _pageInvert
  • _docSplit
  • _docRedact

Release 7.0.307

APIs Added

  • addContentSecurityPolicy
  • getAttachments

Release 7.0.306

Updates

  • Text Search – Search text across multiple documents that are displayed in the viewer.

Release 7.0.294

APIs Added

  • rotateClockwise
  • rotateCounterClockwise
  • rotate180
  • rotateByAngle

Release 7.0.287

Updates

  • Thumbnail Alignment – Aligning thumbnails on the Top/Bottom of the viewer window.

API Added

  • alignThumbnails

Release 7.0.279

Updates

  • Crop Page – Crop a section of the page.
  • Audio/Video – Viewer support for presenting audio and video content and support adding annotations to them.
  • Document Compare – Compares two documents and provides a consolidated overview of their differences.
  • Floating Thumbnails – Move the thumbnail panel around the viewer’s document window.
  • Support for EML & MSG formats.

Release 7.0.275

Updates

  • Thumbnail Indicators – Provide more control to developers on displaying custom icons or indicators over page thumbnails.

APIs Added

  • getIconService
  • getIconCacheManagerService
  • getDocMetaDataService
  • getSelectedPages
  • snipArea
  • nativeDocumentDownloading
  • Added new class – IconCacheManagerService with invalidateThumbnailIconForPages and getCacheInfo APIs
  • Added new class – DocMetadataService with setMetadata and getMetadata APIs
  • Added thumbnailIconCallback a new attribute in the loadDocumentsWithOptions API

Release 7.0.272

Updates

  • Adobe Annotations XFDF – Support of rendering XFDF annotations.

Release 7.0.266

Updates

  • Thumbnail Zoom Controls – Change the size of the thumbnails in the thumbnail panel. Small (S), Medium (M), or Large (L)

Release 7.0.265

Updates

  • Redaction – New options to redact using the following options:
    • Redact Complete Page
    • Redact Selected Text
  • Metadata – Display or edit custom metadata fields within the viewer.
  • Native Document Downloading – Viewer now supports retrieving native document stream and download.

Release 7.0.264

Updates

  • PDF Form Flattening – PDF form fields can be configured to be read-only, meaning they cannot be edited.

Release 7.0.259

Callback API Added

  • _docSaveComplete

Release 7.0.255

Updates

  • Snipping Tool – Copy the selected area of the page and paste it into the current, another, or new document.

Release 7.0.254

Updates

  • Multiple Thumbnail Selection – Multiple pages can be selected via thumbnails using the Ctrl / Shift key including APIs.

APIs Added

  • setSelectedPages, getSelectedPages, clearSelectedPages, getPageInfoByRange, invertPages, docExportWithOptions
  • setDocumentScrollMode
  • getCurrentScale

Release 7.0.252

Updates

  • REST APIs – Support for merging / Splitting non-PDF documents via REST APIs.

Release 7.0.240

Updates

  • Added support for viewing watermarks and redaction on thumbnails.

Release 7.0.239

Updates

  • Document Tab Styling – Added ability for developers to customize the styling and colors of documents in focus and out-of-focus tabs.

APIs Added

  • loadDocumentWithOptions
  • setDocumentTabStyle
  • getDocumentTabStyle
  • tabSwitch
  • onDocumentTabHover
  • setDocumentNameTooltipDirection

Release 7.0.235

APIs Added

  • addEditWatermark
  • deleteWatermark
  • Callback API – _tabSwitch

Release 7.0.231

Updates

  • Speech Synthesis – For the ADA feature to read out the text of the document.
  • Copy To Clipboard – Copy the current page of the document, save it to the viewer’s clipboard, and paste the image outside of the viewer.

Release 7.0.221

Updates

  • IBM AFP file format – Viewer now supports rendering of IBM AFP file format.

Release 7.0.220

API Added

  • Callback API – _updateDefaultCertificate

Release 7.0.219

Updates

  • Annotation Preview – Thumbnails to start displaying annotations on the page.

Release 7.0.213

API Added

  • setCustomStamps

Release 7.0.210

Updates

  • Collaboration – Updates that allow easy collaboration using annotation blogs and linking them to other areas of the same or external documents.

Release 7.0.209

Updates

  • Invert Pages
    • An option to reverse page colors.
    • An API to invert pages has also been introduced that allows inverting single or multiple pages at once.

Release 7.0.197

Callback API Added

  • _onContextMenu

Release 7.0.192

APIs Added

  • getSignatureService
  • Added new Class SignatureService with setAvailableCertificates and setAvailableAppearances APIs
  • Callback APIs – _newCertificate, _newAppearance, _preferenceUpdate, _zoomChange

Release 7.0.182

Updates

  • eSigning & Digital Signatures – eSign documents and collect signatures:
    • Access any document and sign them from anywhere, on mobile or desktop.
    • Your recipients can sign in a snap — no downloads or sign-ups required.
    • Sign by typing, scanning signature, or by touch.
    • Secure your documents with data encryption, audit trails, tamper-proofing, and industry-standard compliances.

Release 7.0.180

Updates

  • Filter Pages – Display or hide specific pages of a document at any time during or after the rendering of the document.

Release 7.0.178

APIs Added

  • getDocumentInfo
  • getActiveDocumentInfo
  • getPageInfo
  • getCurrentScale
  • getCurrentRotation
  • filterPages
  • showOnlyPages
  • hideOnlyPages
  • Callback API – docCompleteNotification

Release 7.0.172

Updates

  • Shortcut Keys – Enable administrators and end users to customize Shortcut Keys.

Release 7.0.165

Updates

  • Providing the ability to hide the top ribbon bar.
  • Providing the ability to hide the context menu based on preference settings.

Release 7.0.158

API Added

  • getCurrentPage

Release 7.0.154

API Added

  • registerLicense

Release 7.0.145

APIs Added

  • removeButtons
  • Callback API – textSelected

Release 7.0.141

Updates

  • Added a new button “Select Text” in the View ribbon toolbar, allowing users to select text.

API Added

  • updateButtons

Release 7.0.121

Updates

  • Supports fast rendering of TIFF images via web assembly.

Callback APIs Added

  • _docLoadComplete
  • _firstPageRendered

Release 7.0.105

API Added

  • addButtons

IBM Deployment of Viewer Component

This section details the creation and deployment of the eViewer WAR file on the IBM WebSphere. Make sure the file name of eViewer 7 is in the following format:

eViewer7.0.xx

Step 1: Use the following command to generate the war file:

jar –cvf “.war” *

For example: Open the command prompt and input the path of the location of eViewer7.0.xx file. Then the command to make it a war file.
Step 1 Viewer Component
Step 2: Access the IBM WebSphere console and log into WebSphere.
Step 2 Viewer Component
Step 3: Go to Applications and select “New Application”. Next, select the “New Enterprise Application” in order to deploy eViewer in WebSphere.
Step 3 Viewer Component
Step 4: Select the location of the eViewer7.0.01.war file and then select “Next”.
Step 4 Viewer Component
Step 5: Select the “Fast Path – Prompt only when additional information is required” option and the click “Next”.
Step 5 Viewer Component
Step 6: Add and verify the installation details for the “Application Name” and “Application Build ID” fields, then click “Next” to go to the Step 2.
Step 6 Viewer Component
Step 7: For Step 2: Map modules with server, it will show all the modules which needs to be mapped with the IBM application services. Select the eViewer7.0.01.war module and then select Next.
Step 7 Viewer Component
Step 8: Select the desired “Virtual host” from the dropdown menu and then select Next.
Step 8 Viewer Component
Step 9: Configure values for the context roots in web modules and select Next.
Step 9 Viewer Component
Step 10: Select the checkbox to enable metadata if needed and select Next.
Step 10 Viewer Component
Step 11: Confirm the details in the Summary. If the details are correct, select Finish.
Step 11 Viewer Component
Step 12: Select Save for saving the final changes and finalize the deployment.
Step 12 Viewer Component
Step 13: To confirm the deployment of the WAR file, go to Applications>Application types>WebSphere enterprise applications, eViewer7_0_01_war application should be displayed.
Step 13 Viewer Component
Step 14: You can start the application by clicking the “Start” button.
Step 14 Viewer Component

IBM Deployment of server component

This section details the creation and deployment of the eViewer Server WAR file on the IBM WebSphere.

Step 1:

jar –cvf “eViewerServer-0.0.1.war” *

Open the command prompt and navigate to the path of the eViewer7 folder. The enter in the command to generate a war file. For example:
Step 1 Server Component
Step 2: Access the IBM WebSphere console and log into WebSphere.

Step 3: Go to Applications and select “New Application”. Next, select the “New Enterprise Application” in order to deploy eViewer in WebSphere.
Step 3 Server Component
Step 4: Select the eViewerServer-0.0.1.war file from the folder and select Next.
Step 4 Server Component
Step 5: Add and verify the installation details for the “Application Name” and “Application Build ID” fields, then click “Next” to go to the Step 2.
Step 5 Server Component
Step 6: For Step 2: Map modules with server, it will show all the modules which needs to be mapped with the IBM application services. Select the eViewerServer-0.0.1.war module and then select Next.
Step 6 Server Component
Step 7: Select the desired “Virtual host” from the dropdown menu and then select Next.
Step 7 Server Component
Step 8: Configure values for the context roots in web modules and select Next.
Step 8 Server Component
Step 9: Select the checkbox to enable metadata if needed and select Next.
Step 9 Server Component
Step 10: Confirm the details in the Summary. If the details are correct, select Finish.
Step 10 Server Component
Step 11: Select Save for saving the final changes and finalize the deployment.

Step 12: To confirm the deployment of the WAR file, go to Applications>Application types>WebSphere enterprise applications, eViewerServer_0_0_1_war application should be displayed.
Step 12 Server Component
Step 13: You can start the application by clicking the “Start” button.
Step 13 Server Component

Apache Tomcat Deployment on Windows Server

This section describes the installation of the eViewer 7 viewer as well as server component on the Apache Tomcat application server.

Step 1: For deploying eViewer 7 on Apache Tomcat server, place the complete eViewer folders, eViewer7.0.01 and eViewerServer-0.0.1, and the corresponding WAR files in the Tomcat webapps folder.
Step 1 Apache Tomcat
Step 2: Navigate to the bin folder of the Apache Tomcat service and then click on the Tomcat(xx).exe file to launch.
Step 2 Apache Tomcat
Step 3: A dialogue box will appear through which the service can be started by clicking the Start button.
Step 3 Apache Tomcat
Step 4: Service manager is attempting to start the following service and automatically deploy the WAR files.
Step 4 Apache Tomcat

Architecture Overview: Deployment over AWS App Runner

eViewer consists of multiple app services that can be deployed over the AWS infrastructure. In this guide, we will focus on deploying two specific services of eViewer: eViewer 7 and eViewer server

To begin, navigate to AWS Console and select AWS App Runner. Below are the services we will discuss how to deploy them step by step.

eViewer v7

  • Purpose: The primary frontend service required for advanced document viewing, editing, and collaboration features. It allows users to view, edit, fill out PDF form fields, add watermarks, annotations, save documents, and more.
  • Deployment: Runs in a Linux-based Docker container.
  • Docker Image: For instance, the Docker image can be referenced as index.docker.io/mstechinc/eviewer7:<version_tag>

Deployment Steps:

Step1: In the AWS App Runner, click on ‘Create an App Runner service’ on the right side.
eViewer v7 Deployment Step 1
Step 2: Choose ‘Container Registry’ as a source, and provide the ‘public.ecr.aws/z7l1z8s2/mstechinc/eviewer7:<version_tag>’ in the container image URI.
eViewer v7 Deployment Step 2
Step 3: Click Next.

Step 4: Provide a name to the service. For example, eviewer7.
eViewer v7 Deployment Step 4
Step 5: Choose the Virtual CPU memory, eViewer requires a minimum of 2 GB.
eViewer v7 Deployment Step 5
Step 6: Create Next and select Create & deploy.

Step 7: Once deployed, access the resource. You can view the eviewer7 service running.

Step 8: Now, verify the URL in the Default domain field.

Step 9: Open the URL to ensure the viewer is rendered correctly.
eViewer v7 Deployment Step 9

eViewer Server

  • Purpose: The viewer’s backend service requires the eViewer server to support advanced functionalities such as redaction, document comparison, digital signature, crop page, and office document rendering.
  • Deployment: This service is optional and will be deployed using a Linux-based Docker container.
  • Docker Image: For instance, the Docker image can be referenced as index.docker.io/mstechinc/eviewer-server:<version_tag>

Deployment Steps:

Step 1: In the AWS App Runner, click on ‘Create an App Runner service’ on the right side.
eViewer Server Deployment Step 1
Step 2: Choose Container Registry as a source, and provide the public.ecr.aws/z7l1z8s2/mstechinc/eviewer-server:<version_tag> in the container image URI.
eViewer Server Deployment Step 2
Step 3: Click Next.

Step 4: Provide a name to the service. For example, eviewerserver.

Step 5: Choose Virtual CPU memory, 4 GB or higher is recommended.
eViewer Server Deployment Step 5
Step 6: Add an environment variable for the license named: evSrvrLicenseKey
eViewer Server Deployment Step 6
Step 7: Set port to: 8086
eViewer Server Deployment Step 7
Step 8: Create Next and select Create & deploy. The deployment of eviewer7 will be completed successfully.

Step 9: Once deployed, access Resource, where you can view the eviewer7 service running.

Step 10: Now, verify the URL in the Default domain field.

Step 11: Open the URL in the browser with /api/v1/getCurrentTimeStamp. This will display the current date and time of the server.

By completing these steps, you can successfully deploy eViewer into AWS. This deployment will grant you access to advanced features for document viewing and editing capabilities, ensuring smooth and effective management of your documents.

Introduction: Deployment with Docker Compose

Deploying eViewer in a Docker environment allows seamless integration into web applications while minimizing setup complexities. Using Docker Compose, we can define the eViewer service in a docker-compose.yml file, manage dependencies, and quickly spin up the application. By the end of this guide, you will have a fully functional eViewer instance running in a Docker container, accessible through a web browser.

eViewer consists of multiple app services that can be deployed over the Docker Compose. In this guide, we will focus on deploying two specific services of eViewer: eViewer 7 and eViewer server

eViewer v7

Purpose: This service is the primary frontend service required for document viewing, editing, and collaboration features. The docker-compose.yml file script is provided by MST.

Deployment Steps:

Step 1: Create a directory for the project and navigate to it.

Step 2: Create a docker-compose.yml file using the script provided below:

version: '3.8'
services:
    eviewer7-service:
        image: mstechinc/eviewer7:7.0.349
        container_name: eviewer7-container
        ports:
             - "8080:80"
        restart: always	

Explanation:

  • Services: This defines a service called eviewer7-service.
  • Image: Specifies the Docker image to use for this service. For example, mstechinc/eviewer7:<version_tag>. This will be pulled from Docker Hub.
  • Container Name: Sets the name of the running container. For example, eviewer7-container.
  • Ports: Maps port 80 inside the container to port 8080 (you can change the port if 8080 is already in use). This allows you to access eViewer by visiting http://localhost:8080 in a browser.

Step 3: Run the following command to pull the image and start the service: docker-compose up -d

eViewer v7 Deployment Step 3

Step 4: Once deployed, you can view the eviewer7 service running.

Step 5: Open the URL to ensure the viewer is rendered correctly.

eViewer v7 Deployment Step 5

eViewer Server

Purpose: This service is the viewer’s backend component to support advanced functionalities of MS Office document rendering, OCR, document redaction, document comparison, digital signatures, and page cropping.

Deployment Steps:

Step 1: Create a directory for the project and navigate to it.

Step 2: Create a docker-compose.yml file using the script provided below:

version: '3.8'
services:
    eviewerserver-service:
        image: mstechinc/eviewer-server:0.0.89
        container_name: eviewerserver-container
        ports:
            - "8086:8086"
        environment:
             - evSrvrLicenseKey= PROVIDED BY MST
        restart: always	

Explanation:

  • Services: This defines a service called: eviewerserver-service.
  • Image: Specifies the Docker image to use for this service. For example, mstechinc/eviewer-server:<version_tag>. This will be pulled from Docker Hub.
  • Container Name: Sets the name of the running container. For example, eviewerserver-container.
  • Ports: Maps port 8086 inside the container to port 8086 (you can change the port if 8086 is already in use).
  • Environment Variables: Includes evSrvrLicenseKey, the eViewer license key provided by MSTech.

Step 3. Run the following command to pull the image and start the service: docker-compose up -d

eViewer Server Deployment Step 3

Step 4: Once deployed, now verify the URL in the browser with http://localhost:8086/api/v1/getCurrentTimeStamp. This will display the current date and time of the server.

By completing these steps, you can successfully deploy eViewer with Docker Compose.

Configuring IBM CM8 Connector

eViewer server connector using IBM Java CM8 beans would search for “cmbicmsrvs.ini” and other supporting “.INI” files which are deployed with the IBM Content Manager 8 pClient/eClient or ICN installation.

Step 1: The path to the connectors folder needs to be pointed within eViewer server component deployment.
Step 1 IBM CM8

Step 2: The “Connectors” folder consists of multiple files for configuration settings of IBM CM8 with eViewer 7. IBM CM8 reads the file “cmbicmsrvs.ini” at runtime.
Step 2 IBM CM8

Step 3: Go to the eViewer 7 application server folder, and locate the property file named cmbcmenv.properties. Open the file in an editor application.
Step 3 IBM CM8

Step 4: The cmbcmenv.properties file contains the concrete path of the “connectors” folder for making the connection between the CM8 application with eViewer 7.
Step 4 IBM CM8

Step 5: Set the values in the application property file for making connection with IBM CM8 and save.
Step 5 IBM CM8

IBM Content Navigator

Extracting eViewer 7 Plug-In

To begin, download the eViewer all deliverables (including JAR files). Follow these steps:

Step 1: Locate the package named eViewer v7.0.xxx.zip and extract its contents.

Step 2: Inside the extracted folder, go to the ViewerApp folder and copy all the files.

go to the ViewerApp folder and copy all the files

Step 3: Navigate to the FileNet server where IBM Content Navigator (ICN) is installed.

Step 4: Follow this path: WebSphere > AppServer > profiles > AppSrv01 > installedApps > Node cell folder > navigator.ear > navigator.war > plugins.

Follow the path from WebSphere to plugins

Step 5: Inside the plugins folder, create a new folder named eViewer7.

Step 6: Paste the copied files into this eViewer7 folder.

Step 7: Go back to the extracted folder, navigate to the ICN Files folder, and copy the eViewer7CM8Connector.jsp and eViewer7Plugin.jar files. Then, paste these files into the eViewer7 folder.

paste files into the eViewer7 folder

Deploying eViewer Server on IBM WebSphere

Perform the following steps to deploy the eViewerServer WAR file on IBM WebSphere.

Step 1: Access the URL to log into WebSphere: https://servername:portnumber/ibm/console/logon.jsp

log into WebSphere

Step 2: Select Applications in the left menu of the WebSphere console.

Select Applications

Step 3: Select New Application > New Enterprise Application.

Select New Application then New Enterprise Application

Step 4: Enter the complete file path for the WAR file for eViewer. Navigate to the eViewer v7.0.xxx folder, then go to serverApp > WAR. Copy the WAR file and upload it, for example, eViewerServer.war

Copy the WAR file and upload it

Step 5: Click Next and wait for the application to be loaded.

Click Next and wait for the application to be loaded

Step 6: Click Next to continue using the “Fast Path” option.

Click Next to continue using the Fast Path option

Step 7: Choose the required checkboxes as per your configuration needs.

Choose the required checkboxes

Step 8: Click Next to continue to Step 2.

Step 9: Select the checkbox for the eViewer WAR file, and click Next to continue to Step 3.

Select the checkbox for the eViewer WAR file

Step 10: Make sure the checkbox is selected and click Next to continue to Step 4.

click Next to continue to Step 4

Step 11: Enter the Context Root. For example: /eViewerServer-0.0.75

Enter the Context Root

Step 12: Click Next to continue to Step 5.

Click Next to continue to Step 5

Step 13: Review the Summary, then click Finish and wait for the application to install.

Review Summary then click Finish and wait for the application to install

Step 14: Once it’s installed, click Save to confirm the deployment settings.

Starting the Service on IBM WebSphere

Once the server is deployed, follow these steps to start the service on WebSphere.

Step 1: Click Applications in the left menu of the WebSphere console.

Step 2: Click Application Types > WebSphere enterprise application, and find your installed WAR file in the list.

find installed WAR file in the list

Step 3: Select the checkbox for the eViewer application that is not running.

Select the checkbox for the eViewer application that is not running

Step 4: Click the Start button.

Click the Start button

The application status will turn to a green arrow once eViewer is running. To verify this, open the URL in the browser: https://servername:serverportnumber/eViewerServer-0.0.xx/api/v1/getCurrentTimeStamp

This will display the current date and time of the server.

Deploying eViewer 7 Plug-In

The following steps are for deploying eViewer 7 plug-in in IBM Content Navigator.

Access the URL to log into ICN and enter in your credentials: https://servername:portnumber/navigator/?desktop=admin

Access the URL to log into ICN and enter in your credentials

Load eViewer 7 Plug-In

Once logged into ICN, load the eViewer 7 plug-in by follow these steps:

Step 1: Click Plug-ins from the left menu.

Click Plug-ins

Step 2: Select New Plug-in from the ribbon.

Select New Plug-in

Step 3: Select the JAR file path radio button and enter the path of the plug-in jar: i.e. https://servername:portnumber/navigator/plugins/eViewer7/eViewer7Plugin.jar

Step 4: Click Load.

Click Load

Step 5: Enter the required details for the following fields:

Step 6: Click Save and Close.

The plug-in has been installed successfully.

Mapping the Plug-in

Next, we need to correctly map the plug-in between eViewer and ICN. Follow these steps:

Step 1: Click Viewer Maps from the left menu.

Click Viewer Maps

Step 2: Select New Viewer Map.

Select New Viewer Map

Step 3: Enter the Name and ID for the viewer map. For example: eViewer7.

Enter the Name and ID for the viewer map

Step 4: Click New Mapping.

Step 5: Choose the following fields:

  • Repository type: FileNet Content Navigator
  • Viewer: eViewer7 Plug-in Viewer (Plug-in that was created earlier)

Step 6: Select the All file types checkbox, and then click OK.

Select the All file types checkbox and then click OK

Step 7: Click Save and then Close.

Click Save and then Close

The newly created mapping will be listed in the list of existing viewer maps.

Link Viewer Map to ICN Desktops

Link your existing Desktop with the viewer map by following these steps:

Step 1: Select Desktops from the left menu.

Select Desktops from the left menu

Step 2: Select your desktop and click Edit.

Step 3: Select the Viewer map under the Desktop Configuration section, select the chosen name for the viewer in your application (eViewer 7) from the drop-down list.

Select the Viewer map

Step 4: Click Save and then Close from the top ribbon.

Verifying the Deployment

Step 1: After setting up the ICN Desktop, you can view it by opening the browser and entering the URL in the following format. For example, https://servername:portnumber/navigator/?desktop=QA2. In this example, QA2 refers to the ID of the desktop.

Step 1 of Verifying the Deployment

Step 2: Once you log in, search the document and load it into the viewer.

Step 2 of Verifying the Deployment

Step 3: The document will be rendered successfully.

Step 3 of Verifying the Deployment

SharePoint Online

Azure Deployment

To begin deployment of eViewer for SharePoint Online, navigate to Microsoft Azure and select App Services. The following are the various services provided by eViewer, and detailing step-by-step deployment processes for each service for integrating eViewer with SharePoint Online.
services provided by eViewer

eViewer 7

  • Purpose: The primary frontend service required for advanced document viewing, editing, and collaboration features. It allows users to view, edit, fill out PDF form fields, add watermarks, annotations, save documents, and more.
  • Deployment: Runs in a Linux-based Docker container.
  • Docker Image: For instance, the Docker image can be referenced as: index.docker.io/mstechinc/eviewer7:<version_tag>

Deployment Steps:

Step 1: Deploy the eviewer7 service on Linux via a Docker container.

Step 2: Once deployed, verify the URL in the Default domain field.
verify the URL in the Default domain field

Step 3: Open the URL to ensure the viewer is rendered correctly.
viewer is rendered correctly

eViewer Server

  • Purpose: The viewer’s backend service requires the eViewer server to support advanced functionalities such as MS Office document rendering, redaction, document comparison, digital signature, and other advanced functions.
  • Deployment: This service is optional and will be deployed using a Linux-based Docker container.
  • Docker Image: For instance, the Docker image can be referenced as: index.docker.io/mstechinc/eviewer-server:<version_tag>

Deployment Steps:

Step 1: Deploy the eViewer Server service on Linux.

Step 2: Once the deployment is complete, you have the option to configure the variables securely in Azure Vault or add them as Environment Variables. If you decide to store them in Azure Vault, then you will only need to add the environment variable keyvault.url and set its value to the URI of your Azure Vault.
add the environment variable

Steps for adding environment variables in Azure Vault:

  • Open Windows PowerShell and run as Administrator.
  • Log in to your tenant by running the following command:
          az login --tenant “<Tenant_ID>”
        
  • Run the following command to configure the variable:
          az keyvault secret set --value-name “VAULT_NAME” --name “ev7LicenceKey” --value “encrypted key”
        

Windows PowerShell

Step 3: If you decide not to use Azure Vault and simply store the configuration variables as environment variables, then navigate to Settings > Environment variables and add the necessary environment variables.
navigate to Settings then Environment variables and add environment variables

The list of environment variables is shown below:

NameValueExample
WEBSITES_PORT8086WEBSITES PORT
evSrvrLicenseKeyProvided by MSTevSrvrLicenseKey

Note: WEBSITES_PORT will always be added as an environment variable, while evSrvrLicenseKey can be added in either Azure Vault or as an Environment Variable.

Step 4: Click Apply.

Step 5: Once the variables are added, navigate to the Overview section.

Step 6: Refresh the service by clicking Stop, and then click Start to restart the service to activate environment variables.
activate environment variables

Step 7: Once environment variables are activated, verify the Default domain URL.

Step 8: Open the URL in the browser with /api/v1/getCurrentTimeStamp. This will display the current date and time of the server.

Permission Setup:

To establish a connection between eViewer Server and SharePoint, the appropriate permissions will need to be granted using the following steps:

Step 1: Navigate to the eviewerserver app service > Overview > Settings > Identity > System assigned.

Step 2: Turn On the Status option.
Turn On the Status option

Step 3: To add a role assignment, click on Azure role assignments > Add role assignment.
add a role assignment

Step 4: Enter the following fields:

  • Scope: Key Vault
  • Subscription: Enter the name of your subscription
  • Resource: Choose the appropriate key vault
  • Role: Select the Key Vault Secrets User

enter values to add role assignment

Step 5: Click Save to complete the role assignment. This will grant the eViewer Server read permissions to read the license key from the vault.

eViewer7AddInWeb

  • Purpose: This is the required service, and it is a SharePoint provider-hosted web app designed for managing document retrieval, rendering, and saving.
  • Deployment: The application will be deployed in a Windows-based Docker container.
  • Docker Image: The Docker image to use is: index.docker.io/mstechinc/eviewer7AddInWeb:<version_tag>

Deploy the eViewer7AddInWeb service. Once the deployment is completed, proceed to

Permission Setup:

To establish a connection between eViewer7AddInWeb and SharePoint, the appropriate permissions will need to be granted using the following steps:

Step 1: In Azure, navigate to Microsoft Entra ID and open your tenant configuration page.
tenant configuration page

Step 2: Go to App Registrations to register the eViewer7AddInWeb application.
register the eViewer7AddInWeb application

Steps to Add an Application:

Step 1: Access the New registration page.
Access the New registration page

Step 2: Enter the name of the new app registration, for example, eViewer7AddInWeb.

Step 3: Based on your configuration, set up the access permissions for this application to SharePoint:

  • The application can access only users within the organization. (Single tenant)
  • This setting allows our application to access users from other organizational directories. (Multitenant)
  • The application can access both users within the organization and users with personal Microsoft accounts.
  • The application can also be configured to access only personal Microsoft accounts.

access permissions

Note: By default, the application is registered as a single tenant.

Step 4: Click Register, and the eViewer7AddInWeb application will be registered.

Step 5: Once the application is registered, go to App registrations > eviewer7AddInWeb > Manage > Authentication.

Step 6: Click Add a platform.
Add a platform

Step 7: Select Web, and enter the Redirect URI (the default domain URL of the deployed eviewer7AddInWeb service, followed by eViewer7).
Select Web and enter the Redirect URI

Step 8: Ensure that both Access Tokens (App-based tokens) and ID Tokens (User-based tokens) are allowed. And click Configure.

Step 9: Proceed to Certificates & Secrets.
Proceed to Certificates and Secrets

Step 10: Create a new client secret by entering the description eViewer7SPAddInWeb and setting the expiration time.
Create a new client secret

Step 11: After clicking Add, a secret ID and value will be generated; document this secret ID and value.
secret ID and value

Step 12: Access the Token Configuration to add two claims to specify the information needed when generating a token, specifically the user’s email ID and username. To do this, click Add Optional Claim.
Add Optional Claim

Step 13: Select the token type as Access and choose the email and given name.
Select the token type as Access and choose the email and given name

Then, add these claims. (This step can only be performed when the token type is set to App-based token.)
add claims

Step 14: Navigate to the API permissions.
Navigate to the API permissions

Step 15: Click on “Add a permission” and select SharePoint.
Click on Add a permission and select SharePoint

Then choose the permissions:

Permissions NameType
Microsoft Graph
emailDelegated
Group.Read.AllApplication
GroupMember.Read.AllApplication
offline_accessDelegated
openidDelegated
profileDelegated
User.ReadDelegated
User.Read.AllApplication
User.ReadBasic.AllApplication
SharePoint
AllSites.ReadDelegated
AllSites.WriteDelegated

Step 16: Click on the permissions you just selected, and then click Grant admin consent.

After adding the permissions, go to the Overview section to view all the details based on the information provided.
Overview section

Environment Variables:

To add an environment variable using Azure Vault, you first need to add the KEYVAULT_URL environment variable and set its value to the URI of your Azure Vault.

Steps for adding environment variables in Azure Vault:

Step 1: Open Windows PowerShell and run it as Administrator.

Step 2: Run the command:

  az login --tenant “<Tenant_ID>”

adding environment variables in Azure Vault Windows PowerShell

Step 3: Before adding any secrets to the Azure Vault, ensure that the user has the necessary rights. To check the role assignment, navigate to the tenant and select Access control.

Step 4: Click Add role assignment.
Click Add role assignment

Step 5: Select Key Vault Secrets Officer and click Next.
Select Key Vault Secrets Officer and click Next

Step 6: Click Select members and add the members who will have permission. Typically, this should be the admin responsible for managing, adding, or storing keys in the vault. Access will only be granted to this user.
Click Select members

Step 7: Click Review + assign to complete the role assignment.

Step 8: To assign another role, select Key Vault Secret User and click Next.
select Key Vault Secret User

Step 9: Click Select members and add those users who will have read-only access to it.
add users who will have read-only access to it

Step 10: Click Review + assign to finalize the role assignment.

Step 11: Now, add the following Environment Variables:

  • ev7LiceneceKey
    Open Windows PowerShell and run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name 
          “ev7LicenceKey” --value “encrypted key”
        

    ev7LiceneceKey
    This will successfully add the ev7LicenceKey environment variable to the vault.

  • ev7SiteUrl
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “ev7SiteUrl” --value 
          “The site URL obtained from the eViewer7 service after deployment”
        

    ev7SiteUrl
    This will successfully add the ev7SiteUrl environment variable to the vault.

  • eViewerServerUrl
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “eViewerServerUrl” --value 
          “The server component’s URL if it has been deployed then include the URL followed by /api/v1”
        

    eViewerServerUrl
    This will successfully add the eViewerServerUrl environment variable to the vault.

  • evSharepointDomain
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “evSharepointDomain” --value 
          “root domain of the SharePoint Online”
        

    evSharepointDomain
    This will successfully add the evSharepointDomain environment variable to the vault.

  • evSPAddInWebClientID
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “evSPAddInWebClientID” --value 
          “clientID of the app registered under your tenant with the name eViewer7AddInWeb”
        

    evSPAddInWebClientID
    This will successfully add the evSPAddInWebClientID environment variable to the vault.

  • evSPAddInWebClientSecret
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “evSPAddInWebClientSecret” --value 
          “value of secret created in eViewer7AddInWeb app registered under your tenant”
        

    evSPAddInWebClientSecret
    This will successfully add the evSPAddInWebClientSecret environment variable to the vault.

  • evSPAddInWebTenantID
    Run the command:

          az keyvault secret set --value-name “VAULT_NAME” --name “evSPAddInWebTenantID” --value 
          “ID of your tenant under Microsoft Entra”
        

    evSPAddInWebTenantID
    This will successfully add the evSPAddInWebTenantID environment variable to the vault.

Permissions Setup:

To setup the permissions for the users, follow the steps below:

  1. Run the command:
            az webapps identity show --name eViewer7AddInWeb --resource-group 
            <resource group name> --query principalId –o tsv 
          

    setup the permissions for the users
    This command retrieves the object ID of your App Service’s managed identity.

  2. Grant access to Key Vault Secret User (providing read-only access to secrets) by running the command:
            az role assignment create --assignee “object ID” --role “Key Vault Secrets User” 
            --scope “/subscriptions/<subscription ID of key vault>/resourceGroups/<name of vault resource group>
            /providers/Microsoft.KeyVault/vaults/<vault name>”
          

    Grant access to Key Vault Secret

  3. Once this command runs successfully, the user will have permission to read data from the vault.

Step 17: If you are not using Azure Vault, then navigate to the homepage of eViewer7AddinWeb, and go to App Services to add environment variables.

Step 18: Go to Settings > Environment variables.
Environment variables

Step 19: Click on the Add option and add the necessary environment variables:

NameValueExample
ev7LicenceKeyEncrypted License Key for eViewer 7.ev7LicenceKey
evSPAddInWebClientSecretThe client secret Value is found in the Certificates and Secrets (under “App registrations”) section.evSPAddInWebClientSecret
evSPAddInWebTenantIDThe tenant ID is found under the app registration page, which is also the directory ID.evSPAddInWebTenantID
ev7SiteUrlThe site URL obtained from the eViewer7 service after deployment.ev7SiteUrl
eViewerServerUrlThe server component’s URL if it has been deployed then include the URL followed by /api/v1eViewerServerUrl

Step 20: After adding these variables, Click Apply & Confirm.

Step 21: Navigate back to the Overview section, click Stop, and then click Start to activate the new environment variables.
activate the new environment variables

By completing these steps, you can successfully integrate eViewer into your SharePoint environment, unlocking powerful document viewing and editing capabilities.

Setting Up User Access

Creating a Security Group

To enable access to eViewer7 for a specific group of users, you need to create a security group in your tenant. After creating the group, you can add members or other user groups to this security group. Any group or user added will automatically gain access to eViewer7, while those not included will not have access.

Here are the steps to create the security group:

Step 1: Navigate to Home > Tenant > Overview > Groups.
Navigate to Home then Tenant then Overview then Groups

Step 2: Click on New Group.
Click on New Group

Step 3: Enter the following fields:

  • Group type: Security
  • Group name: eViewer7-Access
    enter group type and group name

Step 4: Click Create to finalize the setup.

Step 5: Once the group is created, assign members who have access to eViewer 7 to this group.

Step 6: To do this, navigate to Group > Members > Add members, and then add the desired members to the group.
add members to the group

How eViewer is Integrated with SharePoint Online

Integrating eViewer with SharePoint Online enables users to view and interact with a broad range of document types directly within SharePoint, improving accessibility and enhancing the overall document viewing experience. The integration process is straightforward and can be completed by following these steps:

Steps to Integrate eViewer7 with SharePoint Online

Setup eViewrAppConfig List:

Step 1: Create a new list in the root site of SharePoint, name it eViewerAppConfig.

  • Open the root website and navigate to Site contents.
    navigate to Site contents
  • Click New > List.
    Click New then List
  • Choose List, and name it: eViewerAppConfig.
    Choose List

    eViewerAppConfig

  • Click Create.
  • Click on Add column and select type Text, and click Next.
    Click on Add column and select type Text and click Next
  • Name the column “Value” and click Save.
    Name the column Value and click Save

Step 2: Now add the following two parameters:

Click Add new item. Provide Title as key and value as value.

KeyValue
eViewerSPAddInWebUrlURL of eViewerSPAddInWeb app service
eViewerSPAddInWebClientIdClient ID of eViewerSPAddInWeb App Registration

eViewerSPAddInWebUrl

eViewerSPAddInWebClientId

Step 3: Click Save.

Steps to Access eViewer7

Step 1: Access the Admin Center:

  • Log in to the SharePoint admin center.
    SharePoint admin center
  • Navigate to More Features > Apps.
    Navigate to More Features then Apps

Step 2: Upload the eViewer extension:

  • In the Manage Apps section, click Upload.
    click Upload
  • Select the eViewer package file.
    Select the eViewer package file

Step 3: Enable the eViewer App:

  • Once uploaded, select Add to All Sites to deploy eViewer across all SharePoint sites automatically.
    select Add to All Sites

Step 4: Open and Edit Documents:

  • Navigate to a document library in your SharePoint site.
  • Select a document to render and click the Open with eViewer button added to the ribbon.
    Open and Edit Documents

    • Open with eViewer: Render the file in a new tab. Use the eViewer interface to view, annotate, edit, and save changes. Saved changes are uploaded as a new version in SharePoint automatically.
    • Version History: View the document’s version history, including annotation revisions.

Version History

Step 5: Support for Media Files:

  • Open media files directly in eViewer from the Media List.
  • Edit, review, and save changes seamlessly back to SharePoint.