IBM Daeja ViewONE, 5.0.7 iFix 3 Readme

This Readme document contains information about the installation of this package and about restrictions in support of IBM Daeja ViewONE, Version 5.0.7 iFix 3

Readme for: IBM Daeja ViewONE

Product or component release: Version 5.0.7

Update name: iFix 3

Prerequisites before installing IBM Daeja ViewONE, Version 5.0.7 iFix 3

You must have IBM Daeja ViewONE, Version 5.0.7 installed.

Before you install IBM Daeja ViewONE, Version 5.0.7 iFix 3:

Installing IBM Daeja ViewONE, 5.0.7 iFix 3

IBM Daeja ViewONE, 5.0.7 iFix 3 is provided as a compressed file containing the files that are needed to update Version 5.0.7 for all supported platforms.

To install this package:

  1. Unzip the compressed file into the directory where IBM Daeja ViewONE, Version 5.0.7 was installed. This action overwrites all the files that need updates in the client/v1files directory and the server/WEB-INF/lib directory.
  2. As this package contains all the files required for all platforms, you can remove the files that are included for platforms that are not relevant to your environment. Change to the server/WEB-INF/lib directory under the Daeja ViewONE installation directory and delete the platform specific jars that are not relevant.

    There are platform specific jar files:

  3. Make a backup of the Daeja ViewONE 5.0.7 files in the relevant locations in your web application server. For the server files that will be the web application's WEB-INF/lib directory. For the client, it will be where the package client files were copied to. For example v1files directory in the web application.

  4. Copy the client and server files into the relevant places in your web application and ensure that the application is deployed as per your web app server specific requirements.
  5. Verify that the correct version of IBM Daeja ViewONE is deployed to the web application server. This can be done by displaying the About Box in Daeja ViewONE Virtual by clicking on the ViewONE logo in the bottom right corner. Verify that the version number 5.0.7 iFix 3 is listed at the bottom of the About Box.

Note: To upgrade to iFix 3, please ensure that both the client and the server are updated.

Removing IBM Daeja ViewONE, 5.0.7 iFix 3

If you want to remove the iFix 3 from your installation and revert back to the original 5.0.7 version, you need to replace the files in you installation directories with the backed up files, then copy the files into the correct places in your web application server.

If you use the IBM Daeja ViewONE Version 5.0.7 uninstallation program to remove IBM Daeja ViewONE 5.0.7 and the iFix 3 from your system, then some of the files may be left on your file system and you will need to remove them manually.

Configuring the Viewer

IBM Daeja ViewONE comes with a Toolkit rich in capabilities that enables advanced integration and customization of the viewer by using HTML parameters and JavaScript API methods. For more information on the developer’s guide refer to:

IBM Daeja ViewONE 5.0.7 Virtual Developer's Guide

New features in IBM Daeja ViewONE, 5.0.7 iFix 3

IBM Daeja ViewONE, Version 5.0.7, provides the following new features:

See release notes for more information:


Carbon Design Package Updates

A number of changes have taken place to the Carbon Design Package. These are listed here:



For online documentation, see the IBM Daeja ViewONE knowledge center.

Fixes in IBM Daeja ViewONE, 5.0.7 iFix 3

The following APARs are fixed in this product release for customers who have direct entitlement to IBM Daeja ViewONE. If you are using IBM Daeja ViewONE made available to you as part of another IBM product, these fixes might not be available immediately. Contact IBM Support for information about IBM products that integrate IBM Daeja ViewONE.

See release notes for more information:


IO27404 EML FILE FAILS TO RENDER DUE TO HTML ATTRIBUTE VALUE IN REM UNITS

Eml file fails to render with generic "Unable to display document" error in the viewer due to REM units in HTML attribute values. The log throws a generic error (not explicit to this issue): "Document page count error ji.streamer.splitter.jiSplitPageGenerationException: Document page count error"

Affected users: IBM Daeja ViewONE Virtual users


The Document Build Spec for a document initially opened as about:blank should not include initial load action.

The document build specification for a document that was initially opened as about:blank must not send the initial document load event for about:blank as part of the burnspec.

Affected users: IBM Daeja ViewONE Virtual users



Fixes and Features released in previous iFixes and Fix Packs

IBM Daeja ViewONE 5.0.7 iFix 2

Search button is not opening search view after opening a new document when 'initialEditMode' is set

When 'initialEditMode' is set to either 'annotate' or 'redact'. If the edit mode is switched to 'docBuilder' and subsequently a new document is opened, the edit mode would be reset to the 'initialEditMode' value but the search button would no longer function in opening up the search view.

Affected users: IBM Daeja ViewONE Virtual users


IO27005 AFTER A MERGE AND SPLIT OPERATION THE NEW VERSION OF THE DOCUMENT IS NOT SHOWN

In Merge and Split mode removing a page in an existing document does not show the latest version after checkin - it displays the original version.

This can occur where the repository being used does not use a unique identity for each version of the document, but re-uses the same parameters to retrieve an updated document, which results in ViewONE returning the previous version of the document that was cached.

NOTE: This fix depends on ICN version 3.0.7

Affected users: IBM Daeja ViewONE Virtual users using ICN Merge and Split


IO27129 WHEN VIEWING A WORD DOCUMENT SOME PARTS OF THE DOCUMENT ARE DISPLAYED AS A BIG RED X

When opening word documents some parts of the document got displayed as a big red X. The other parts of the document appeared normal.

Affected users: IBM Daeja ViewONE Virtual users


IO27451 WHEN USING DAEJA PRINT SERVICE THE PRINT PROCESS CONTINUES TO USE CPU EVEN WHEN CANCELLED

When Print Cancel is clicked, the server print process continues to use CPU and memory resources.

Affected users: IBM Daeja ViewONE Virtual users


IO27469 PRINT BUTTONS WOULD APPEAR/DISAPPEAR WHEN TOGGLING BETWEEN THE VIEW MODES

When 'printButtons' parameter is set to 'false', toggling between different view modes would make the print button visible. This is incorrect behavior as the print should be disabled at all times.

Affected users: IBM Daeja ViewONE Virtual 5.0.6 iFix 2,3,4,5 and 6 users


IO27543 WHEN PRINTING A DOCUMENT ASCII CHARACTERS ARE DISPLAYED IN THE PREVIEW AND THE PRINTED OUTPUT

A PDF produced by the viewer for printing is displayed as ASCII characters in the browser preview, and in the printed output, instead of being handled as a PDF document. This can happen when the response Content-Type header is modified in transit to */*.

Affected users: IBM Daeja ViewONE Virtual users


ClassCastException can appear in the client log at startup

When 'traceException' is set to 'true' a ClassCastException appears in the logs.

Affected users: IBM Daeja ViewONE Virtual users


Carbon Design Package Updates

A number of changes have taken place to the Carbon Design Package. These are listed here:


IBM Daeja ViewONE 5.0.7 iFix 1

IO27504 PDF DOCUMENTS WITH LARGE EMBEDDED IMAGES RENDER SLOWLY WHEN PAGING THROUGH DOCUMENT

PDF documents that contain large images which takes time to render, can be slow to display pages in the viewer when scrolling through the document.
Scrolling through the document can cause the viewer to send multiple requests to the renderer for the same page, and as a result slow down the rendering of other pages.

Affected users: IBM Daeja ViewONE Virtual users


IO27050 EVENT 9 (THE USER HAS CHANGED THE PAGE) IS FIRED TWICE AND THE SECOND TIME THE PAGE IS INCORRECT

Event 9 (page changed) is expected to be fired once per page change. This event can be fired twice when a set page occurs, via javascript or the go-to dialog. When this issue occurs, the incorrect page is selected after the second event has fired.

Affected users: IBM Daeja ViewONE Virtual users


IO27409 ANNOTATIONS ARE CUT OFF AND TEXT IS LOST DURING PRINTING OF PDF DOCUMENTS

When printing a PDF containing text annotations, with 'Print Original Size' selected. The text inside a text annotation is slightly shifted in position and letters of the text can be seen to be 'lost' in the printed version of a document when compared to what is viewed on-screen.

Affected users: IBM Daeja ViewONE Virtual users


IO27427 WHEN VIEWING A SPECIFIC EMAIL THE HEADER INFORMATION IS DISPLAYED BUT MAIN BODY IS MISSING

When viewing a specific email the header information is displayed but entire body of text that makes up the main mail is missing.

Affected users: IBM Daeja ViewONE Virtual users


IO27447 PDFS CONTAINING JAVASCRIPT ACTIONS MAY RESULT IN REDUCED QUALITY PRINT OUTPUT

Some PDF documents that contain JavaScript actions may cause the embedded printing process to error and revert back to the inefficient and poor quality rendered print process. This may result in poorer quality print output and longer print times.

Affected users: IBM Daeja ViewONE Virtual users


IO27452 IMAGE STAMP ANNOTATION NOT PRESENT ON DOCUMENT AFTER REDACTION IN LOAD BALANCED ENVIRONMENT

This issue is seen with both printing and redaction processes where an image stamp has been added - the symptom is that the image is simply not included in the redacted or printed document although it can clearly be seen when the original document and stamp are viewed.

The issue specifically occurs in a load balanced environment where the 'internalHost' and 'externalHost' properties have been applied in order to circumnavigate routing issues across the load balancer. Whilst these properties are applied and a correct remapping occurs when it comes to viewing, they are not mapped for the printing and redaction processes, where a re-render requiring the image stamp occurs and this is why it does not get included in the redacted, or printed, document.

Affected users: IBM Daeja ViewONE Virtual users


IO27470 TIFF FILE WITH INVALID TAG T6OPTIONS (GROUP4OPTIONS)==4 DISPLAYS INCORRECTLY

TIFF files with Fax Group 4 (T.6) encoding that set the T6Options (G4Options - 293) to the invalid value 0x04, it is not displayed correctly.

Affected users: IBM Daeja ViewONE Virtual users


IO27505 PERMANENT REDACTION SOMETIMES FAILS WHEN VIEWONE IS DEPLOYED IN A DIRECTORY WHICH HAS VERY LONG PATH NAME

PDF to PDF Permanent Redaction can fail when it has been deployed to a long path. The error that appears in the log is:
ViewONE burner: Platform specific PDF Redaction Engine failed to install.
Error2: <system_specific_path>res/linux26-x8664/33/redaxserver: line 8: 13148 Segmentation fault ${CURDIR}/redaxserverapp ${@+"$@"}, exitcode: 139

Affected users: IBM Daeja ViewONE Virtual users


Large annotation tooltips can be cut off

When an annotation tooltip is too large to be displayed, the right hand side of the tooltip can be outside of browser window.

The position of the tooltip has been adjusted, so it is always visible

Affected users: IBM Daeja ViewONE Virtual users


Printing some PageN documents resulted in content being cut off.

When printing PageN documents with PDF pages that have contents larger than the page size may result in some of the content being cut off from the print output.

Affected users: IBM Daeja ViewONE Virtual users


IO27413 NATIVE PDF HIGHLIGHT ANNOTATION OBSCURING THE TEXT WHEN USING CLIENT SIDE RENDERING IN IE11

Native PDF highlight annotation obscuring the text when using client side rendering in Internet Explorer 11.

Affected users: IBM Daeja ViewONE Virtual users


Carbon Design Package Updates

A number of changes have taken place to the Carbon Design Package. These are listed here:


IBM Daeja ViewONE 5.0.7

The document pages do not display.

When the viewer is used within a CORS browser environment, the document is not displayed.

Using the developer tools to view the console logging will show an error stating SEC7120: Origin 'yourdomain.com' not found in Access-Controll-Allow-Origin header and SCRIPT7002: XMLHttpRequest: Network Error 0x80070005, Access is denied.

Affected users: IBM Daeja ViewONE Virtual 5.0.6 iFix 4,5,6 and 7 users


IO26049 EXCEL REDACTION DUPLICATING ON FOLLOWING PAGES WHEN BURN IN FILENET SYSTEM

When redacting an excel document the redaction is duplicated on at least one of the following pages. This is specific to when the excel document is in Page view mode.

Affected users: IBM Daeja ViewONE Virtual users


IO27212 CALLING JAVASCRIPT SETMAGNIFIERINTERNAL WITH FALSE HAS NO EFFECT

Javascript method call setMagnifierInternal(false) has no effect. This call should hide the internal magnfier.

Affected users: IBM Daeja ViewONE Virtual users


IO27315 EMAIL OPENS BUT WHEN CLICKING ON THE ATTACHMENT THE EMAIL IS SHOWN AGAIN. WORKING IN STAND-ALONE BUT FAILS IN ICN

When clicking on the attachment in the email, the email is shown again. Working in standalone but fails on ICN.

Affected users: IBM Daeja ViewONE Virtual 5.0.6 iFix 2,3,4,5 and 6 users


IO27329 EXCEL DOCUMENTS THAT RENDER TO MANY HUNDREDS OF PAGES CAN CAUSE SERVER RESOURCE ISSUES

If an Excel document contains data in one or more cells that makes the overall size of the sheet huge, the viewer will attempt to render every part of that spreadsheet across a large number of pages. But an Excel spreadsheet that takes up hundreds of pages can use up resources on the server to a point where the render thread shows as hung and other users on the same system may experience a significant performance impact.

Affected users: IBM Daeja ViewONE Virtual users


IO27333 EMAIL DOCUMENT IN ENGLISH RENDERS IN WRONG LANGUAGE (JAPANESE)

An email which renders correctly in any mail client is rendered in the viewer with a lists of non-existent attachments in the mail header and the message text is displayed as a set of Japanese and unrecognized escape characters (square empty boxes).

Affected users: IBM Daeja ViewONE Virtual users


IO27383 EMAIL WITH EMOJIS FAILS TO RENDER

An email containing emoji characters fails to display. These emails will now display, but the emojis are displayed as a ‘?’ characters.

Affected users: IBM Daeja ViewONE Virtual users


IO27358 CONTENT EMBEDDED IN PORTRAIT PAGE CAN BE ROTATED IN MULTICONTENT DOCUMENT

When the problem is seen, the actual content of the page (and not just the page) is rotated inside the page itself - so for example, a content element that is a portrait view remains as portrait view but the content inside it is then incorrectly rotated to be a landscape view. This problem can occur when viewing a multi-content document where there is a mixture of portrait and landscape pages in the different content elements. Whether the issue is seen or not depends on the order in which the multi-content element pages are defined.

Affected users: IBM Daeja ViewONE Virtual users


IO27383 EMAIL WITH SPACE SURROUNDING '=' SIGN IN BETWEEN '<' AND '>' FAILS TO RENDER

Emails with space surrounding equal sign between '<' and '>' fail to render. The following error is displayed; 'Unable to display document: Failed to load document, status: An error occurred while retrieving the requested page'.

Affected users: IBM Daeja ViewONE Virtual users


IO27395 WHEN PRINTING USING KEYS CTRL+P OPTION, WE DO NOT SEE PAGE NUMBERS BY DEFAULT

When the keyboard shortcut, Ctrl + P, is used for printing, the default page numbers are not displayed in the 'Pages to Print' field of the print options dialog.

Affected users: IBM Daeja ViewONE Virtual users


IO27398 FILE HANDLERS ARE NOT CLOSED AND LEFT OPEN WHEN CLOSING DOCUMENT OR EVEN AFTER CLOSING DAEJA

File Handlers are not closed and left open when closing document or even after closing Daeja, Resulting in memory issues as the space occupied by the file handlers are not released.

Affected users: IBM Daeja ViewONE Virtual users


IO27410 MEMORY LEAKAGE OCCURS WHEN THE DAEJA VIEWONE VIRTUAL CLIENT VIEWER EMBEDDED IN IFRAME IS RELOADED

When the user navigates away from the viewer page or reloads the viewer, the amount of memory used by the browser increases. After many reloads the browser needs to be closed in order to recover the used memory.

Affected users: IBM Daeja ViewONE Virtual users


IO27449 Data URIs fail to load when docIdProtype is set

When a docIdPrototype has been set, data image URIs fail to load. The user receives an error message a follows; 'Unable to Load Document ,failed to load document, Status: Unable to register ds with server'

This may be seen in the Datacap Scan workflow.

docIdPrototype will no longer be applied to any data URI.

Affected users: IBM Daeja ViewONE Virtual users


Local Save of mixed source documents produces incorrect file extension on download.

When using local save on mixed source documents, the extension of the resultant file downloaded from the server may be incorrect, causing some files not to be opened.

Affected users: IBM Daeja ViewONE Virtual users


End user can't view RBR TIF document.

When the showprintoptionsdialog parameter is set the user cannot view the document and gets the error message 'Invalid Auto Redaction configuration: showprintoptionsdialog'.

Affected users: IBM Daeja ViewONE Virtual users


Microsoft Office documents do not show correct number of pages

When viewing large Microsoft Office documents that have references near the beginning of the document, to pages near the end of the document, the number of pages identified can be incorrect. This typically happens in documents with a table of contents at the start of the document.

Affected users: IBM Daeja ViewONE Virtual users


Cursor reverts to default when drawing sticky text annotations

When drawing sticky text annotations, a crosshair cursor appears to draw the annotation. After drawing the first annotation, the cursor reverts back to the default cursor instead of the crosshair. At this time the annotation is still 'sticky' and more annotations can be drawn.

Affected users: IBM Daeja ViewONE Virtual users


Annotation transparency is removed when a color is applied

The transparency is removed when a new line or fill color is applied to an annotation that has line or fill transparency.

Affected users: IBM Daeja ViewONE Virtual users


ER187572 New page representation for Excel Mime types

This version of the viewer introduces a significant improvement to the Excel rendering experience:

  1. The page loading logic has been adjusted in order to further prioritise the loading and rendering of the first page so users should be a noticeable improved 'time-to-view' first page.
  2. Updated the pagination logic with more advanced algorithms that speeds up the rendering of pages for viewing when compared to previous versions.
  3. Standardised the pagination in the viewer to reflect what is seen in the Excel Print Preview mode (which also paginates the spreadsheet in an A4 layout) for consistency.
  4. Prevent the generation numbers of blank pages where there is no data. *

The new logic is activated permanently from this version of the viewer going forwards and it is not possible to revert to the previous behavior.
Please note that further to the introduction of the new Excel pagination code where the 'sheet view' feature is now removed, the following HTML parameters are deprecated and no longer applicable:


Excel Documents with pre-existing annotations
Users might experience potential movement of previously saved annotations in Excel documents. The degree of movement could vary based on the complexity of the document's layout. Annotation data can move for one of the following reasons:

  1. Movement on the same page - will occur where a 'sheet' view (landscape) is now a page view (portrait)
  2. Movement to a different page - will occur where we now render an Excel document with a different number of pages to previous pagination - so an annotation on page 1 in sheet view in 'old pagination mode' may well end up on page 2
  3. Disappearing of annotation data completely - will occur where annotations were placed on pages that do not longer exist i.e. Annotation was placed on page 10 of sheet rendered in the 'old pagination mode' but this sheet now only renders to a total of 5 pages. As result any annotations listed for page 6 or higher are effectively 'lost'.


Due to the number of factors involved, it is not possible to provide a solution that can detect and replace annotations back to the original location. The new pagination code will detect and display a warning message to a user for any Excel spreadsheet it encounters that has been annotated using the previous version of the Excel render process.

There is an HTML parameter to control display of the warning message:
suppressExcelAnnotWarning
This parameter is a boolean and can be set to 'true' (warning message is displayed) or 'false' (no warning message is displayed). The default for this parameter is 'true'

* a typical example that causes blank page generation is where, for whatever reason, a single cell way off inside the spreadsheet was populated with data and yet there is no other data in the many columns and rows between the main data set at the beginning of the spreadsheet and the 'rogue' cell in a location far removed from the main data. This situation could prior to this change cause the viewer to generate many blank pages for all cells leading up to the last one causing performance issues and potentially impacting the server itself.


ER187250 A VISUAL INDICATOR IS DISPLAYED DURING THE DOCUMENT LOAD PROCESS

When the document load process takes more than 3/4th of a second, a spinner is shown as a graphical indicator. All available action buttons in the toolbar will be disabled during this phase except for the 'Open File' action button.


IBM Daeja ViewONE Built to Java 8 Version

The version of Java that is targetted is now Java 8. This means that the IBM Daeja ViewONE Server will no longer run on a Java 6 or Java 7 runtime.

Please note that IBM Daeja ViewONE has supported Java 8+ only since Version 5.0.


New configuration parameter 'showPrintOptionsDialog' toggles print dialog options window on/off.

When the new showPrintOptionsDialog parameter is set to false, the options window will be skipped when printing and all pages will be printed in the original size along with any annotations.
The parameter is set to true (displaying the options window) by default.


New parameter to toggle sticky note summary page

When the print options dialog is hidden, a parameter 'includeStickNotesSummary' will determine if sticky note summary page will be included. The sticky note summary page will be included if the document has sticky note annotations and the 'includeStickNotesSummary' is set to true.


Implemented annotationDateStyle html parameter

The annotationDateStyle html parameter now takes 3 values: long, medium, short, and stamps the correct date and time format to the <date> and <dateonly> macros, depending on which value is chosen.
Examples for the 'en' locale with the <date> macro:
Long: August 12, 2019, 15:26:45 UTC+1
Medium: Aug 12, 2019, 15:26:45
Short: 8/12/19, 15:26
By selecting either the medium or short values, the timezone is removed from the annotation stamp.


Local Save of Page N documents is now supported.

Users can now download and save locally, to a single PDF document, the page array constructed via PageN mode. In Page N mode, the ability to save locally could be enabled using parameter fileButtonSave=true. This parameter determines whether the toolbar includes the action button required to allow the download and Save. The button is called "Save document" when DesignPackage=Classic and "Download Document" when DesignPackage=Carbon. Upon save, a PDF document is created representing the structure of the Page N document. The downloaded PDF is named PageNSaved.pdf.


HTML PARAMETER THUMBSPREFETCHSIZE ADDED

Added HTML parameter, thumbsPrefetchSize. This parameter can be used to configure the amount of thumbnail sets that will be retrieved in the background. The actual number of thumbnails in a set depends on the zoom level.

The valid values for this parameter are the numbers zero (0) to seven (7). A value of 0 means no thumbnails are retrieved in the background in addition to those already displayed on the screen. The default is 2 which means that 2 sets of thumbnails will be retrieved in the background, in addition to the set already shown. Those will be ready to be displayed as the user scrolls down in the thumbs panel, making the interaction seamless.


The number of pages to read-ahead for client side rendering is now configurable

The HTML parameter clientPrefetchSize can be used to configure the amount of pages that will be retrieved in the background.
When this parameter is set to any value greater than zero, the specified number of pages before and after the current page are read-ahead (prefetched).
The valid values for this parameter are 0 to 7, where a value of 0 means no pages are prefetched. The default is 7.


Optimized performance of printing PDF documents

In IBM Daeja ViewONE Virtual 5.0.6, an optimized printing was introduced for PDF documents. There were a number of restrictions in the use of this optimized PDF printing that have now been resolved.


Additional Release Notes

System requirements

Go to the page at Software Product Compatibility Reports to create a high-level report for operating systems, hypervisors and prerequisites.

Optimized performance of printing PDF documents

When printing PDF documents with annotations, the annotations are embedded in the downloaded PDF document as native PDF annotations. This reduces the time taken to print documents, especially large documents.

This process currently only applies to printing PDF documents when 'Print Original Size' is selected in the print settings. If this is not selected or the printed document contains other file formats, the print process completely flattens the content of each page.

The time it takes to prepare a PDF with annotations for print using the optimized print depends on the total number of annotations. In most cases you need to have several hundreds of annotations in a single document before the time difference becomes noticeable.

With the optimized print any annotations created in IBM Daeja ViewONE Virtual are embedded into the document as native PDF annotations. Therefore they are recognized as active annotations when the PDF is viewed by tools that support editing of PDF documents. If this document is subsequently viewed by IBM Daeja ViewONE Virtual, any annotations will be treated as static content where loading a document with pre-applied native annotations cannot be edited. To prevent document or annotation modification appropriate security would need to be set via a tool that supports editing or via some PDF printers.

Sticky Notes
Sticky Note annotations will appear on top of other annotations regardless of z-order.

Line Width
The maximum line width of native annotations is 12pt and will be limited to this for print output.

Solid Text
If a solid text annotation is set to be semi-transparent the fill background and the text will become semi-transparent, previous behavior left the text solid and only the fill became semi-transparent.

Image Stamps
Image stamp annotations will appear underneath any other annotation types regardless of the z-order. This is due to the fact that they added to the content of the PDF and not as separate native PDF annotations.

Limitations

The optimized PDF print does not occur in the following circumstances:

Deprecation of Annotation Types

As of IBM Daeja ViewONE Virtual Version 5.0.6 the following annotation types are deprecated:

These annotation types will be removed in a future version of the product.

Deprecation of Email Render = 1

As of IBM Daeja ViewONE Virtual Version 5.0.3, the default value for parameter emailRenderer is set to '2' which represents the email module that allows for paginated output. See more details for this module below. As of IBM Daeja ViewONE Virtual Version 5.0.6, the ability to switch the email module to the alternative value "1" has been deprecated. The value will be removed as a valid setting for the parameter in a future release.

The email module that produces paginated output is now the default setting for the standalone product. This email module supports the display of EML (MIME RFC 822) and MSG (Microsoft Outlook and Exchange) formats as paginated content, and allows for streaming and redaction of emails. It requires the IBM ViewONE Office Module to be licensed. To redact emails, the IBM ViewONE Permanent Redaction module is also required. When opening emails that have annotations saved using the older email rendering mechanism, the HTML parameter 'emailUseAnnotationDefinedModule' defines the behavior.

The 'emailUseAnnotationDefinedModule' parameter can have the following values:

*always: The default behavior is to always attempt to use the renderer that is defined in the annotation.

*never: The renderer that is defined in the annotation is never used. Instead, the email is opened using the renderer specified in the viewer. This may cause the annotations to move. The user will be notified that 'The annotations on this document were saved with a different version of the viewer. Annotation may have moved and will need checking'. The annotation save button will be enabled and user will be prompted to save before they leave the document unless the 'annotationAutoPrompt' HTML parameter has been set. The 'annotationAutoSave' HTML parameter does not work for this annotation change.

*prompt: The user receives a prompt when annotations were created using a different renderer, giving them the option to open using the renderer defined for the viewer (Yes) or attempt to open with the renderer that is specified in the annotation (No). If the user click Yes they will then be notified that 'The annotations on this document were saved with a different version of the viewer. Annotation may have moved and will need checking'. The annotation save button will be enabled and user will be prompted to save before they leave the document, unless the 'annotationAutoPrompt' HTML parameter has been set. The 'annotationAutoSave' HTML parameter does not work for this annotation change.

Document Builder

Document Builder uses repository-document and repository-annotations when the document is created

The document will be built with the source document as it is saved in the repository. The document is also built by using the annotations that are saved in the repository, unless annotations have been edited. The following scenarios explain the effects of this behavior:

Scenario 1:
  1. Two instances of the viewer are opened in document builder mode
  2. A document is loaded from a repository into each viewer window
  3. The document builder user copies a page from the document in viewer window 1 and pastes the page into the document in viewer window 2
  4. While the document builder user is working on the documents, another user or system process alters one or both of the master documents
  5. The document builder user builds the modified document
  6. Because one or both of the master documents were altered during the document builder session, the built document contains the pages from the latest saved version of the master documents

Result: The document currently displayed in the viewer differs from the newly built document in the system. To prevent this issue occurring, the master document should be locked or checked out when it is retrieved for document builder.

Note Versioned documents will not be affected by this issue. This will only affect situations where the document that a URL refers to has changed.

Scenario 2:
  1. Two instances of the viewer are opened in document builder mode
  2. A document with annotations is loaded from a repository into each viewer window
  3. The document builder user copies a page from the document in viewer window 1 and pastes the page into the document in viewer window 2
  4. While the document builder user is working on the document, another user or system process alters one or more of the annotations used in one or both master documents
  5. The document builder user builds the modified document
  6. The built document contains the pages from the latest saved version of the master documents. For pages where the document builder user has not modified annotations in the viewer, the annotations for those pages come from the latest saved annotations version. For pages that the user has modified the annotations in the viewer, those pages will contain annotations as seen in the viewer which may not contain the latest changes

Result: The document currently displayed in the viewer differs from the newly built document in the system. To prevent this issue occurring, the master document should be locked or checked out when it is retrieved for document builder.

Restore annotations is not supported in document builder mode

When in document builder mode, the option to restore annotations is not supported. The following scenario explains the effects of this behavior:

Scenario 1:

  1. Viewer is loaded in document builder mode
  2. A document is loaded from a repository
  3. Annotations are created by the user
  4. Restore annotations button is disabled
  5. Javascript API reloadAnnotations() is disabled

Result: The user cannot reload the annotations from the server. Newly created annotations and edited annotation edits remain.

To restore any newly created annotations, the user must take the following steps:

  1. Remove the page on which annotations are present that you want to restore
  2. Put the page with the original annotations on the clipboard (cut/copy)
  3. Paste the page into the new document location

Daeja ViewONE as an Integrated solution

When running Daeja ViewONE 5.0.7 as a component inside IBM Content Navigator, the minimum supported version of ICN is 3.0.7, unless stated otherwise by the specific ICN release.

Known problems, issues, and limitations

As problems are discovered and resolved, the IBM Support team updates the Support site. By searching the Support site, you can quickly find workarounds or solutions to problems.

The following links open queries for IBM Daeja ViewONE documents on the IBM Support site:

Any restrictions and/or limitations of the base or fix pack release and any subsequent ifixes, still apply to this release unless stated otherwise.

Supported File Formats in ViewONE Virtual

For information on the supported file formats refer to the tech note below. Please note that this is a live document and might get updated frequently. https://www-01.ibm.com/support/docview.wss?uid=ibm10730429

Comparison with native renderers

IBM Daeja ViewONE Virtual is designed to support as many file types as possible. However, the product is not able to render every type of file with the same accuracy as native applications, such as Microsoft Word. The flexibility of the viewer can lead to differences in the way that the documents are displayed between the native application and the viewer. The severity of the differences varies depending on the complexity of the file type. In particular, PDF files and Microsoft Office files are difficult to render with complete accuracy in a universal viewer.

Microsoft browser limitation

For additional information on IE/Edge limitations, refer to the following tech notes:

Excel spreadsheet load times

Excel spreadsheet load times are impacted based on the size and complexity of the Excel document. In order to improve load times, IBM Daeja ViewONE does support tuning capabilities, such as breaking up the Excel document presentation into multiple pages. Please be aware, as this behavior may not be optimal for your end user viewing experience.

Prompt to save redacted documents uses hexadecimal filename

After a document is permanently redacted and the user selects Download, they are normally prompted to save the document with a file name based on the original un-redacted document. For instance, mypresentation.ppt will default to mypresentation.tif. In this version the user might be prompted with a filename such as 41f96b20b97f431ebd4efd85245f1f72.tif instead. The user can still change the name to something more meaningful.

No pageN support in document builder mode

If a pageN document is open in the viewer, the user cannot switch to document builder mode. The user remains in the edit mode in which the document was opened. The following scenario explains the effects of this behavior:

Scenario 1:

  1. Viewer is loaded in either annotation or redaction mode
  2. A pageN document is loaded from a repository
  3. A user attempts to switch to document builder mode
  4. The user receives a message and remains in annotation or redaction mode

Result: This switch is not permitted and the user will stay in their current mode.

To enter document builder mode, the user must close the pageN document and then switch to document builder mode.

No docN support in document builder mode

DocN documents are not supported in conjunction with document builder mode. The combination of these features may result in unusual and/or unexpected behavior.

Document Builder supported file type limitations

Document builder is able to support TIFF and PDF files with the exception of email attachments. TIFF and PDF files that are attached to emails cannot be used as source files for a new document.

PDF files with access control flags set by the owner of the document cannot be used as a source document for document building where they require a password to view the document or where the owner has indicated that the content may not be copied.

Rendering of the semi transparency appears to blend between the outline and the fill

Annotations that have the semi-transparent property set to true, the transparent property set to true and a fill color set can appear to blend the line and fill colors near the edges.

Annotation with fill color set to black and set to transparent are not printed transparent

Annotations that have the transparent property set to true and a fill color set to black are not printed transparent for non PDF documents. When printing PDF documents, with 'Print Original Size' selected, these annotations are printed with transparency applied.

Copyright and trademark information

http://www.ibm.com/legal/copytrade.shtml

Notices

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Other company, product, or service names may be trademarks or service marks of others.

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

The license agreement for this product refers you to this file for details concerning terms and conditions applicable to third party software code included in this product, and for certain notices and other information IBM must provide to you under its license to certain software code. The relevant terms and conditions, notices and other information are provided or referenced below. Please note that any non-English version of the licenses below is unofficial and is provided to you for your convenience only. The English version of the licenses below, provided as part of the English version of this file, is the official version.

Notwithstanding the terms and conditions of any other agreement you may have with IBM or any of its related or affiliated entities (collectively "IBM"), the third party software code identified below are "Excluded Components" and are subject to the following terms and conditions: