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 5
Readme for: IBM Daeja ViewONE
Product or component release: Version 5.0.7
Update name: iFix 5
You must have IBM Daeja ViewONE, Version 5.0.7 installed.
Before you install IBM Daeja ViewONE, Version 5.0.7 iFix 5:
IBM Daeja ViewONE, 5.0.7 iFix 5 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:
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:
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.
Note: To upgrade to iFix 5, please ensure that both the client and the server are updated.
If you want to remove the iFix 5 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 5 from your system, then some of the files may be left on your file system and you will need to remove them manually.
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
IBM Daeja ViewONE, Version 5.0.7, provides the following new features:
See release notes for more information:
New Export Document API
This new API allows users to export a document as a PDF.
exportDocument(documentURL, annotationURL, callback)
documentURL is a full URL string to the document and can be null if exporting the current document opened in the viewer.annotationUrl is a full URL string to the annotations and can be null if exporting the current document opened in the viewer or if no annotations exist for the document.documentURL is null annotationUrl is ignored.callback is an object that needs to have three methods which can be called by the export process:onSuccess(downloadLocation) - The export process will call this method on export success, passing the download URL string to the exported documentonError(errorMsg) - This export process will call this method if it finished with an error, and will pass the error messageonStatusUpdate(message, error, pagesProcessed) - The export process will call this method periodically as it checks for export status. message is the progress status or is empty, error is a boolean indicating whether there was an error, pagesProcessed is the number of pages that has been exported.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.
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:
IO27123 SINGLE PAGE .PNG FILE GETS RENDERED AS BLACKSCREEN.
When a PNG file containing data chunks of length 0, is opened in Daeja, it gets rendered as blackscreen.
Affected users: IBM Daeja ViewONE Virtual users
IO27453 UNABLE TO READ MULTI-PART DOCUMENT WHEN VIEWMODE IS SET TO THUMBSRIGHT OR THUMBSLEFT WHILE CLIENT SIDE RENDERING IS TURNED ON
A pageN array with varied page sizes is not displayed correctly when: the viewer is displayed with thumbs left or right, and client-side rendering is used. For example, where the document is composed of a PDF, for page one, and a small PNG file for page 2, page one is displayed too small and the PNG file is displayed much larger than it actually is.
Affected users: IBM Daeja ViewONE Virtual users
IO27521 EMAIL DOCUMENT FAILS TO RENDER DUE TO INVALID XML CHARACTERS.
Email MSG document failing to render due to invalid XML Characters (0x12 - Device Control 2, 0x13 - Device Control 3, 0x14 - Device Control 4).
Affected users: IBM Daeja ViewONE Virtual users
IO27535 EXCEL CELLS SHOWS 'XX' RATHER THAN ACTUAL DATA
Excel sheets with the cells having Hijri calendar data is rendered as 'XX' rather than actual data.
Affected users: IBM Daeja ViewONE Virtual users
IO27573 WHEN VIEWING A SPECIFIC EMAIL WITH LARGE TABLES HEADER IS RENDERED BUT EMAIL BODY IS MISSING
When viewing specific emails with large tables, an email header is displayed, but the email body is missing.
Affected users: IBM Daeja ViewONE Virtual users
IO27582 EMAIL FAILS TO RENDER DUE TO DUPLICATE STYLE ATTRIBUTE
Email fails to render due to duplicate style attribute values within HTML attribute.
Affected users: IBM Daeja ViewONE Virtual users
IO27618 EMAILS ARE DISPLAYED WITH INVERTED COLORS
Emails are displayed with Inverted Colors.
Affected users: IBM Daeja ViewONE Virtual users
IO27645 EMAIL BODY IS RENDERED WHEN EMAIL ATTACHMENT IS SELECTED USING DAEJA VIRTUAL EMBEDDED IN CONTENT NAVIGATOR
When an email attachment is selected to view from the attachments panel in the viewer, instead of the email attachment being rendered, the main body of the email is displayed. This issue was introduced in version 5.0.6 iFix2 of the viewer and exists in all versions of Content Navigator prior to version 3.0.7.
Affected users: IBM Daeja ViewONE Virtual users
IO27579 SOME VALUES IN VIEWBUTTONSDETAIL HTML PARAMETER ARE IGNORED
The HTML parameter ViewButtonsDetail should accept a comma separate subset of the following values 'page, thumbs, left, right, top, bottom'. The only values in that list that are accepted are 'page' and 'thumbs'
Affected users: IBM Daeja ViewONE Virtual users
Improve accuracy of Text Annotation positioning during print
Text annotations containing text with tails or accents may be slightly clipped by the bounding box if the bounding box was not drawn during creation.
Affected users: IBM Daeja ViewONE Virtual users
An invalid Auto Redaction configuration prevents some documents from displaying.
An invalid Auto Redaction configuration, 'annotationSuppressEmptyMessages', prevents some documents from displaying. This configuration is now prevented from being sent to the server.
Affected users: IBM Daeja ViewONE Virtual users
IO26982 WHEN VIEWING AN EMAIL NUMBERED LISTS CONTAINED WITHIN THE MESSAGE ARE NOT DISPLAYED CORRECTLY
Numbered lists contained within the email message are not displayed correctly.
Affected users: IBM Daeja ViewONE Virtual users
IO27110 MS WORD 2000 DOCUMENTS WITH NO WIDTH VALUE FOR SECTION FAILS RENDER
Opening MS Word 2000 documents with no width value for section fails to render. Would display a blank page and the page count number on the top tool bar would count up until it passes 1000.
Affected users: IBM Daeja ViewONE Virtual users
IO27185 MS WORD 2000 DOCUMENTS WITH NO SECTION DATA FAILS WITH ERROR THIS DOCUMENT HAS BEEN TRUNCATED
Opening MS Word 2000 documents with no section data fail with following error 'This document has been truncated because the of an error that occurred while retrieving the requested page'.
Affected users: IBM Daeja ViewONE Virtual users
IO27327 EMAIL FAILS TO RENDER DUE TO ANGLE BRACKETS WITHIN HTML ATTRIBUTE VALUES
Email of EML type fails to render in the viewer due to angle brackets in HTML attribute values. Attribute 'data-id' includes "<" ">" within its string causing the issue.
Affected users: IBM Daeja ViewONE Virtual users
IO27401 Exceptions seen in Java logs "java.io.FileNotFoundException: /cache/docstore ..pngXXXX.tmp (A file or directory in the path name does not exist.)"
Additional path checking has been added and the logging has been updated to provide clearer messaging. Unnecessary stack trace information has also been removed.
Affected users: IBM Daeja ViewONE Virtual users
IO27426 VIEWONE.SETANNOTATEEDIT(TRUE/FALSE); IS NOT WORKING
Viewone.setAnnotateEdit(false) greys out the toolbar rather than removing it, and Viewone.setAnnotateEdit(true) does not show the toolbar.
Affected users: IBM Daeja ViewONE Virtual users
IO27483 EMAIL FAILS TO RENDER DUE TO UNIT VALUE IN WIDTH AND HEIGHT WITHIN HTML ATTRIBUTE VALUES
Email fails to render due to units in width and height within HTML attribute.
Affected users: IBM Daeja ViewONE Virtual users
IO27572 SAVED FILE NAME IS TRUNCATED
When saving a file with more than one dot in the name, the saved output file name may have the middle section removed between the second to last and the last dot.
Affected users: IBM Daeja ViewONE Virtual users
IO27583 KEYPRESS EVENT (37) GETS INCORRECTLY THROWN TWICE PER SINGLE KEYPRESS
When pressing ctrl + c, and some other keyboard shortcuts, the keypress event (37) is fired twice.
Affected users: IBM Daeja ViewONE Virtual users
IO27614 PRINTING A DOCUMENT WITH TEXT ANNOTATIONS CLOSE TO PAGE BOUNDARY CAN CAUSE HIGH JVM HEAP USAGE
Printing a document that contains text annotations close to the page boundary can cause high JVM heap usage.
Affected users: IBM Daeja ViewONE Virtual users
A number of changes have taken place to the Carbon Design Package. These are listed here:
At ViewONE version 5.0.7 iFix 1, each edit mode in the viewer maintains its own view mode and the default view for 'Merge and Split' mode is 'thumbs only' view.
If the ViewONE viewer in IBM Content Navigator 3.0.7 is updated to version 5.0.7 iFix 1 or later, then IBM Content Navigator 3.0.7 also needs to be updated to version 3.0.7 iFix 1 or later.
IBM Content Navigator 3.0.7 iFix 1 fixed an issue where the viewer may be showing the incorrect view when switching between 'Merge and Split' and 'View' modes.
The following new JavaScript APIs are added:
setEnabled(String controlType, String actionType, Boolean value)
This method enables or disables certain actions within the viewer. The action is determined by the controlType and actionType parameters.
The current available controlType is 'shortcutKey'. This controls the enablement of keyboard shortcuts for operations identified by 'actionType'.
The available actionTypes are: 'printKeys', 'imageKeys', 'viewKeys', 'pageKeys', 'fileKeys', 'selectKeys', 'allKeys'.
For more information on the actionTypes see "Accessibility features of IBM Daeja ViewONE" page in the IBM Knowledge Center.
isEnabled(String controlType, String actionType)
This method returns a Boolean value of 'true' if the state of certain action is enabled within the viewer. The action is determined by the controlType and actionType parameters.
The current available controlType is 'shortcutKey'. This controls the enablement of keyboard shortcuts for operations identified by 'actionType'.
The available actionTypes are: 'printKeys', 'imageKeys', 'viewKeys', 'pageKeys', 'fileKeys', 'selectKeys', 'allKeys'.
For more information on the actionTypes see "Accessibility features of IBM Daeja ViewONE" page in the IBM Knowledge Center.
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
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
A number of changes have taken place to the Carbon Design Package. These are listed here:
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
A number of changes have taken place to the Carbon Design Package. These are listed here:
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
This version of the viewer introduces a significant improvement to the Excel rendering experience:
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:
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.
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.
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.
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.
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.
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.
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.
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 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.
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.
Go to the page at Software Product Compatibility Reports to create a high-level report for operating systems, hypervisors and prerequisites.
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.
The optimized PDF print does not occur in the following circumstances:
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.
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.
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:
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.
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.
When in document builder mode, the option to restore annotations is not supported. The following scenario explains the effects of this behavior:
Scenario 1:
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:
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.
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.
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
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.
For additional information on IE/Edge limitations, refer to the following tech notes:
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.
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.
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:
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.
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 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.
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.
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.
http://www.ibm.com/legal/copytrade.shtml
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.
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: