This Readme document contains information about the installation of this package and about restrictions in support of IBM Daeja ViewONE, Version 5.0.6 iFix 6
Readme for: IBM Daeja ViewONE
Product or component release: Version 5.0.6
Update name: iFix 6
You must have IBM Daeja ViewONE, Version 5.0.6 installed.
Before you install IBM Daeja ViewONE, Version 5.0.6 iFix 6:
IBM Daeja ViewONE, 5.0.6 iFix 6 is provided as a compressed file containing the files that are needed to update Version 5.0.6 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.6 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 6, please ensure that both the client and the server are updated.
If you want to remove the iFix 6 from your installation and revert back to the original 5.0.6 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.6 uninstallation program to remove IBM Daeja ViewONE 5.0.6 and the iFix 6 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.6 Virtual Developer's Guide
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:
Improve efficiency of Print and Save operations for mixed mimetype PageN documents containing PDFs.
When saving or printing mixed mimtype PageN documents that contain PDFs via the Embedded Print process, the efficiency of the PDF generation is improved.
Affected users: IBM Daeja ViewONE Virtual users
Improve PageN Print and Save efficiency.
When saving or printing PageN documents via the Embedded Print process, the efficiency of the PDF generation is improved.
Affected users: IBM Daeja ViewONE Virtual users
Server memory usage increases gradually
A memory leak, which causes memory usage to increase over time, is present in versions 5.0.6 iFix 4 and 5.0.6 iFix 5.
Affected users: IBM Daeja ViewONE Virtual 5.0.6 iFix 4 and iFix 5 users
Some thumbnails do not display
In some environments the thumbnails do not display as the mime-type is not returned in the response headers.
When the response header Content-Type does not have the type image/png the thumbnail image
is not displayed.
Affected users: IBM Daeja ViewONE Virtual users 5.0.6 iFix 5
Page or tile from a previously viewed document displayed
The displayed document page or tile is from a previously viewed document.
Where a document page, or an individual tile, being displayed has the same dimensions, page location
and display properties as a previously viewed item, the previous item is displayed from the browser cache.
Affected users: IBM Daeja ViewONE Virtual 5.0.6 iFix 4 users
Security Fix: Daeja ViewONE Virtual may expose internal IP addresses
During certain operation Daeja ViewONE transmits the internal IP address to the client. Please refer to security bulletin https://www.ibm.com/support/pages/node/884380 for additional information.
Affected users: IBM Daeja ViewONE Virtual users
Added Mac keyboard shortcuts
All keyboard shortcuts with ctrl keys now also work with cmd, with a limitation that the information and settings dialog must be opened with ctrl-shift-t.
Affected users: IBM Daeja ViewONE Virtual users
Document images are not updated when a document is modified
When a document is modified on the server the images used to display it are not refreshed. The image data retrieval mechanism in the browser has been changed so that the browser cached data can be removed on closing the displayed document.
Affected users: IBM Daeja ViewONE Virtual users
IO27317 HIGHLIGHT POLYGON ANNOTATION STORED IN FILENET REPOSITORY IS NOT TRANSPARENT WHEN PRINTED
By definition, a highlight is transparent and renders as such on screen but when the document+annotation is printed, the highlight appears on printout as opaque and obscures any text or images beneath it. The issue only seems to occur where a FileNet repository is in use since the issue does not exist when using a 'standalone' viewer using the Daeja annotation format.
Affected users: IBM Daeja ViewONE Virtual users
Repeated output of configuration setting to log file
The repeated output of the list of parameters used to configure the ViewONE to the logfile has been removed.
Affected users: IBM Daeja ViewONE Virtual users
IO26913 EMAIL WITH PLUS SIGN BETWEEN < and > IN BODY CONTENT FAILS TO RENDER
Emails with a plus sign in body content and 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
IO27218 WORD DOCUMENT FAILS TO RENDER WHEN KEEPLINES HAS INVALID VALUE SET FOR A PARAGRAPH
Word document fails to render when keepLines are set to an invalid value for a paragraph. The error message displayed is 'This document has been truncated because of an error that occurred while retrieving the requested page'.
Affected users: IBM Daeja ViewONE Virtual users
IO27273 EMAILS WITH SPECIAL CHARACTERS IN STYLESHEET FAIL TO RENDER
Emails that have special characters defined in the stylesheet 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
IO27296 ENHANCE MODES SHOULD NOT BE AVAILABLE WHEN USING PDF CLIENT-SIDE RENDERING
When client side rendering is used for displaying PDF files the enhance mode button still present and active. However, clicking on the enhance mode button does not have any effect. This is because enhance mode is not supported for PDF client side rendering.
Affected users: IBM Daeja ViewONE Virtual users
IO27302 EMAIL SUBJECT LINE IS TRUNCATED WHEN VIEWING AN EMAIL WITH SPECIAL CHARACTERS
Email Subject line comes up truncated when you open an email file which contains special characters.
Affected users: IBM Daeja ViewONE Virtual users
IO27334 PDF FILES THAT CONTAIN CHINESE, JAPANESE OR KOREAN CHARACTERS WHICH REQUIRE CMAPS DO NOT DISPLAY THE CHARACTERS
Chinese, Japanese, or Korean (CJK) characters in a PDF file that uses predefined CMaps require the corresponding CMap files for mapping the CJK encoded characters to the required encoding.
If these files are not available, blank spaces are seen in place of the characters.
Two HTML parameters, cmapLocation and cmapPacked allow configuring of CMaps:
cmapLocation
This parameter should be set to the location containing the CMaps files.
The location can be a path to the CMaps, or a HTTP(S) URL to the location. E.g. /myapp/cmaps or http://host:port/myapp/cmaps
The CMap files should be downloadable via a HTTP GET request to that location. E.g. http://host:port/myapp/cmaps/Adobe-Japan1-UCS2 would return the content of this CMap file.
cmapPacked
This parameter determines if the CMap files are compressed 'bcmap' files or standard text files.
If the CMap files are compressed files with the .bcmap extension then the parameter should be set to true. The default value is false.
Affected users: IBM Daeja ViewONE Virtual users
IO27338 TIFF IMAGE WITH DEFAULT COMPRESSION DOES NOT DISPLAY
When a TIFF image does not have a compression type defined
explicitly in the TIFF tags, the image is unable to display.
When there is no compression type defined in the TIFF tags,
the default is uncompressed data.
The symptoms of this issue are the following message
appearing in the server-side log file, 'Compression 0
decompression is not available' and the following generic
message appearing on the client, 'Unable to
display document: Failed to load document status: An error
occurred while retrieving the requested page'.
Affected users: IBM Daeja ViewONE Virtual users
IO27349 UNABLE TO PRINT DOCUMENT IN CHROME 77
When a document print is done from Chrome version 77 and later, the progress dialog is displayed but the print dialog is not shown when the file preparation has completed.
Affected users: IBM Daeja ViewONE Virtual users
Reduce the number of filesystem writes during Embedded Print
When printing via the Embedded Print process, the number of writes to the filesystem has been significantly reduced.
Affected users: IBM Daeja ViewONE Virtual users
Removed unsupported print parameters
The following html parameters have been removed as they no longer affect printing:
printAcceleratorReverseMono, printAcceleratorForgetSettings, forcePrintsPerPage, resolutionPrintAdjustment, printLabelBorder, printingFontSelectionEnabled, printingColorHeader, printingNotesStandardFont, disablePrintCopies, java1NTBackgroundPrinting, useOldPrintTextAnnotationTest, printAcceleratorExtraLandscapeSizeChecks, printRangeExtraErrorMessages, printAcceleratorDisableThreading, printingNotesStandardFontBidiAlign, printDialogWin2kOnTop, printingNotesTextPageTitle, printingNotesTextTitle, printer, allowPrinting, preserveJVMPrintSettings
Affected users: IBM Daeja ViewONE Virtual users
In Page N mode, local save of the current page array is now supported. Upon save, a PDF document is created representing the structure
of the Page N document.
Limitations:
Currently local save will only produce a PDF document as the output.
Added HTML parameter, thumbsPrefetchSize. This parameter can be used to configure the amount of thumbnails that will be retrieved in the background. The actual number of thumbnails retrieved is calculated based on the zoom level.
The valid values for this parameter are the numbers zero (0) to seven (7), where a value of 0 means no thumbnails are retrieved in the background. The default is 2.
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.
Streamlined the caching of documents into the ViewONE cache for PDF client side rendering.
When the viewer is determining if it is opening a PDF document, ensure that the request to the repository to get the mime type is a HEAD request.
When the viewer pulls the document from the repository into the server cache, do not extract the PDF metadata as it is no longer required.
Affected users: IBM Daeja ViewONE Virtual users
Removed unsupported parameters, allowHeaderTags and allowHeaderTagsOnPrint
The html parameters allowHeaderTags and allowHeaderTagsOnPrint no longer have any impact on the display, print and permanent redaction of documents.
Please note: When using mixed deployment of Daeja ViewONE Professional and Daeja ViewONE Virtual as supported in IBM Content Navigator, the parameter allowHeaderTags will no longer have an impact when redacting documents in Daeja ViewONE Professional.
Affected users: IBM Daeja ViewONE Virtual users
Removed unsupported parameters, textFilterWrapping, textFilterPageHeight, textFilterPageWidth, allowTextFilterDisplayAnyFile, textFilterLocalFileExtensions
The html parameters, textFilterWrapping, textFilterPageHeight, textFilterPageWidth, allowTextFilterDisplayAnyFile, textFilterLocalFileExtensions, no longer have any impact on the display, print and permanent redaction of documents.
Please note: When using mixed deployment of Daeja ViewONE Professional and Daeja ViewONE Virtual as supported in IBM Content Navigator, the parameters textFilterWrapping, textFilterPageHeight, textFilterPageWidth, allowTextFilterDisplayAnyFile, textFilterLocalFileExtensions, will no longer have an impact when redacting documents in Daeja ViewONE Professional.
Affected users: IBM Daeja ViewONE Virtual users
IO27160 AREA ZOOMED IS NOT ACCURATE WHEN USING ZOOM AREA BUTTON AND VARIES WITH SIZE OF SELECTION
When a zoom area is selected where the width is longer than the height, then the image viewer does not show correctly.
Affected users: IBM Daeja ViewONE Virtual users
IO27186 SCROLL BAR ISN'T FUNCTIONING PROPERLY WHEN VIEWING LARGE NUMBER OF CUSTOM ANNOTATION STAMPS FROM CONTENT NAVIGATOR
Scroll Bar isn't functioning properly when viewing more than 30 custom annotation stamps in Daeja Virtual ViewONE. The scroll bar shows up when there are more annotation stamps but it does not function properly as we cannot see all the custom annotations stamps defined.
Affected users: IBM Daeja ViewONE Virtual users
IO27201 JAVASCRIPT CALL initializePageArray() DOESN'T CLEAR THE ARRAY
When opening a second page
Affected users: IBM Daeja ViewONE Virtual users
IO27220 EMAIL RENDERING WITH BANNER AT THE BOTTOM OF THE EMAIL
Email rendering with Banner at the bottom of the email.
Affected users: IBM Daeja ViewONE Virtual users
IO27269 TEXT ANNOTATIONS WITH SPECIAL CHARACTERS ADDED TO PDFS PRINT INCORRECTLY
Text annotations with special characters added to PDF documents print incorrectly when using embedded print.
Affected users: IBM Daeja ViewONE Virtual users
IO27274 THE 'FILE PREPARATION COMPLETE' PRINT DIALOG DOES NOT AUTOMATICALLY CLOSE ON FIREFOX
When printing, a dialog is displayed showing the document's print status. In Firefox this print status dialog was not closing automatically after a document was ready and is still displayed after the user has chosen an action.
Affected users: IBM Daeja ViewONE Virtual users
IndexOutOfBoundsException stacktrace printed when a page is cut
An IndexOutOfBoundsException stacktrace can be printed in the logs when a page is successfully cut in Merge and Split mode.
Affected users: IBM Daeja ViewONE Virtual users
Viewing wrong page after a cut operation
After a page is cut in Merge and Split mode occurs, the wrong page can be selected.
Affected users: IBM Daeja ViewONE Virtual users
IO27295 ZOOMING IN SHOWS THE ORIGINAL UNZOOMED IMAGE IN THE PAGE BEFORE THE RESIZED IMAGE IS DISPLAYED
When zooming in, the original unzoomed image is shown with a grey background area around it, which makes it look like the image is shifting during the transition to the new resized image.
Affected users: IBM Daeja ViewONE Virtual users
The new Embedded Printing process now applies to PDF documents that have image stamp annotations.
Limitations: unlike all other annotation types, image stamps are not applied on a separate layer in the PDF.
As a results, all other annotations will appear on top of image stamps
The new Embedded Printing process now applies to Page N documents that contain just PDF documents.
Embedded Printing is only applied if 'Print Original Size' is selected.
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.
Security Fix: It is possible to download arbitrary server files via ViewONE server (CVE-2019-4260)
Using a specially crafted URL it may be possible to download arbitrary server files
via the ViewONE platform service.
Please refer to security bulletin http://www.ibm.com/support/docview.wss?uid=ibm10884382 for additional information.
Affected users: IBM Daeja ViewONE Virtual users
Security Fix: ViewONE is vulnerable to XXE attack via HTTP payload (CVE-2019-4456)
A specially crafted XML payload to the ViewONE service can result in a denial of service attack. Please refer to security bulletin http://www.ibm.com/support/docview.wss?uid=ibm10959177 for additional information.
Affected users: IBM Daeja ViewONE Virtual users
IO27076 VIEWONE VIRTUAL CACHING ONLY WORKS FOR SAME USER IN THE SAMEBROWSER SESSION WHEN USED IN CONTENT NAVIGATOR
Loading large documents should be quicker for a second user viewing the same document (within the cache timeout period) as a cached version of it should be used. Evidence that the cache is not being used: the document takes just as long to load for each user, and the ViewONE server retrieves the document from the repository for each user accessing it. This will occur where the docIdPrototype parameter is set to ${originalDocURL}, which is the default value, and the document URL contains a session token or any other user unique value.
Affected users: IBM Daeja ViewONE Virtual users
IO27104 A 2-POINTS FREEHAND ANNOTATION WOULD STOP THE DOCUMENT FROM BEING REOPENED
When user creates a free hand annotation that consists of only two points (X1Y1,X2Y2) and save the change an error will occur when user tries to open the document the next time. The error says, 'Unable to display document.Annotation failed to load: freehand shapes need at least 3 points'.
Affected users: IBM Daeja ViewONE Virtual users
IO27122 TEXT IN MS WORD DOCUMENTS WHICH WAS ADDED USING A DYNAMIC ENTRY MENU IS DISPLAYING TWICE
When viewing Microsoft Word documents that have content added using Prompts, fill in fields, the selected value is displaying twice.
Affected users: IBM Daeja ViewONE Virtual users
Editing printed text annotations may cause the whole annotation to change to the text colour.
When editing a native text annotation in a PDF document that was produced using the embedded print process. The entire text annotation may change to the same colour as the text. This results in the text in the annotation being hidden.
Affected users: IBM Daeja ViewONE Virtual users
The Embedded Print Process now supports empty P8 Annotation Data.
The Embedded Print process now supports P8 annotation data associated with documents with no annotations.
Affected users: IBM Daeja ViewONE Virtual users
Native PDF Sticky Note annotations now appear as a single annotation when printed using the embedded print process
Sticky note annotations, when printed via the embedded print process, result in a single native annotation being embdedded into the resultant PDF document. The annotation now contains the sticky note ID within the single annotation and is consistant in appearance between PDF viewers.
Affected users: IBM Daeja ViewONE Virtual users
Page Number Indicator does not display fully after a viewer minimisation and restoration
When the viewer is resized, the Page Number Indicator is not displayed fully and is hidden behind the First Page Button.
Affected users: IBM Daeja ViewONE Virtual users
The new Embedded Printing process now applies to PDF documents that contain rotated pages with text annotations that contain rotated text. Embedded Printing is only applied if 'Print Original Size' is selected.
PRINTING DOCUMENTS CONSTRUCTED WITH PAGE<N> CAN RESULT IN THE WRONG PAGES BEING PRINTED
When 2 definitions of PageN share source files, printing the documents can produce the wrong pages from the file. The following example demonstrates the issue: Document 1: page1=mydoc1.pdf#2, page2=thisdoc.pdf#3 Document 2: page1=mydoc1.pdf#5, page2=thisdoc.pdf#2 When Document 1 is printed, it will correctly print the second page from mydoc1.pdf and the third page from thisdoc.pdf. When Document 2 is printed after Document 1, it will erroneously print the second page from mydoc.pdf and third page from thisdoc.pdf. This issue is now fixed.
Affected users: IBM Daeja ViewONE Virtual users
EXTRA EXCEPTIONS LOGGED IN SERVER LOG FILE WHEN PRINTING PAGE<N> DOCUMENTS
When page<N> documents are printed, a large number of extra exceptions are added to the server side log file. This has now been fixed.
Affected users: IBM Daeja ViewONE Virtual users
Non-Latin characters within the annotations are printed incorrectly
When printing a document with annotations, the non-Latin characters within the annotations are printed incorrectly for some locales.
Affected users: IBM Daeja ViewONE Virtual users
Saving a multi-source (pageN) document produces the wrong content
When viewing any multi-source document, the save functionality produces an incorrect output.
The save button will be disabled for multi-source documents to prevent the incorrect output being produced.
Affected users: IBM Daeja ViewONE Virtual users
Arbitrary file download is possible via ViewONE service
Using a specially crafted URL it may be possible to download arbitrary server files
via the ViewONE platform service. This is fixed from versions 5.0.6 and 5.0.5 iFix 13.
Please refer to security bulletin http://www.ibm.com/support/docview.wss?uid=ibm10884382 for additional information.
Affected users: IBM Daeja ViewONE Virtual users
Printing in Safari using Optimised Printing doesn't display the print preview dialog
When printing in Safari using Optimised Printing, the browser will not display the print preview dialog. This may prevent the user from printing in Safari. This issue is now fixed.
Affected users: IBM Daeja ViewONE Virtual users
FileNet annotation Z Order not taken into account for embedded printing
When printing using embedded print in FileNet, the order of annotations was not taken into account and thus displaying annotations in an incorrect state at print. This issue has now been fixed.
Affected users: IBM Daeja ViewONE Virtual users
IO27062 PDF documents may fail to open in IE due to font initialization
When a PDF document is rendered on the client, it may fail to open in IE when the renderer is loading fonts. An exception is shown in the browser development tools console stating 'Error: Object doesn't support property or method 'Symbol(Symbol.iterator)'
Affected users: IBM Daeja ViewONE Virtual users
Improved performance of PDF document open time.
Improved the time to display the first page of a PDF document with many pages containing heavy text content. When a document is opened, the text content is formatted before the first page is displayed. This could take some time when lots of text needs to be processed. This processing has been changed to be done on demand when the viewer functionality needs it. The processing delay was noticeable in IE. It had a small overhead on other browsers.
Affected users: IBM Daeja ViewONE Virtual users
IO26989 EML WITH ANIMATED GIF IS NOT DISPLAYED PROPERLY
EML with animated GIF is not displayed properly.
Affected users: IBM Daeja ViewONE Virtual users
IO27030 SOME THUMBNAILS ARE NOT RENDERED WHEN VIEWING A MACRO ENABLED WORD DOCUMENT
When viewing a macro enabled word document some thumbnails are not rendered.
Affected users: IBM Daeja ViewONE Virtual users
IO27075 WHEN VIEWING A WORD DOCUMENT IN THE VIEWER A CHECK BOX IS SHOWN DIFFERENT IN SIZE TO OTHERS AND/OR IS UNCHECKED
When viewing a word document in the viewer a check box is shown smaller in size to others and is unchecked.
Affected users: IBM Daeja ViewONE Virtual users
IO27094 IMAGE STAMP STORED IN A LOCATION REQUIRING AUTHENTICATED ACCESS IS NOT OUTPUT ON REDACTED DOCUMENT
An image stamp stored in a secure location requiring a user login is added to a document and seen in the viewer, but it is not added to the document when a redaction is performed. The output may contain HTML from a login page or not be present. The ViewONE log may show errors indicating that the request for the image was rejected with a 40x HTTP error code.
Affected users: IBM Daeja ViewONE Virtual users
IO27108 WHEN VIEWING A SPECIFIC WORD DOCUMENT HEADER AND FOOTER ARE RENDERED BUT MAIN BODY IS MISSING
A 1997 - 2003 Word document is displayed with header and footer, but no main body content. The log file contains no errors related to this failure.
Affected users: IBM Daeja ViewONE Virtual users
IO27053 PRINTING OF MULTI CONTENT IMAGES THAT HAVE BEEN FEDERATED FROM IMAGE SERVICES TO FILENET P8 FAILS
When printing multi content images, an Error Print Aborted dialog is shown.
Affected users: IBM Daeja ViewONE Virtual users
IO27023 CHECKIN AND ADD ACTION ON A DOCUMENT FAILS WHEN YOU MERGE AND SPLIT ON IT USING A LOAD BALANCED URL
Checkin and Add action on a document fails when you merge and split on it using a load balanced URL. The web container transport port of the application server node gets appended to the doc builder URL which makes it invalid and causes the failure
Affected users: IBM Daeja ViewONE Virtual users
IO27044 PRINTING A DIGITALLY SIGNED PDF DOCUMENT AND PRINT ORIGINAL SIZE OPTION IS SELECTED CAN CAUSE THE IE BROWSER TO HANG
Selecting the 'Print Original Size' option allows the viewer to print the PDF document directly without rendering the pages,
but additional header/footer information and JavaScript is included in the printable PDF.
For some digitally signed documents this can invalidate the embedded eSignatures.
When the printable PDF document is delivered back to the browser for printing, the plugin used to load the document fails which in turn causes the IE browser to be unresponsive.
Affected users: IBM Daeja ViewONE Virtual users
The new Embedded Printing process now applies to PDF documents that contain rotated pages with annotations applied. Embedded Printing is only applied if 'Print Original Size' is selected. Limitations: If a rotated page contains a text annotation then the print will follow the render based print process. - Supported from 5.0.6 iFix002
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.
The new Embedded Printing process now applies to PDF documents that contain Arrow annotation types.
Embedded Printing is only applied if 'Print Original Size' is selected and a PDF document is being printed.
The new Embedded Printing process now applies to PDF documents that contain Text annotation types that have text rotation appplied.
Embedded Printing is only applied if 'Print Original Size' is selected and a PDF document is being printed.
PDF documents are rendered on the client by default
In version 5.0.5, the HTML parameter clientPDFTileGeneration needed to be set to true for the viewer to render PDF documents on the client.
From this release, rendering of PDF documents on the client (clientPDFTileGeneration=true) is the default.
The ability to render PDF documents on the server (clientPDFTileGeneration=false) has been deprecated and will be
removed in a future release. It is now only supported as-is with no fixes or other changes made.
For more information on client rendering of PDF documents see :
https://www-01.ibm.com/support/docview.wss?uid=ibm10885518
NOTE If clientPDFTileGeneration is set to false the following features will be unavailable:
- ER152961 Text searching in PDF documents
- PDF Text Selection Mode for client side rendered documents.
- PDF Text Copy for client side rendered documents.
- ER178608 Support for password protected PDF documents
When printing a document, the option Print Original Size is now the default.
This feature adds the ability to highlight and copy text in PDF documents.
To highlight and copy text, click the 'Toggle text selection' button on the main toolbar.
When this button is selected, annotations on the pages will be hidden. Selecting an annotation in the annotations toolbar will make annotations reappear and deselect the text selection button.
NOTE: In 5.0.6 iFix001 and earlier, the annotation toolbar is disabled when text selection is enabled
Text can be highlighted using the mouse to click and drag across the text on the page.
To copy the highlighted text, press Ctrl+C (Windows) or Cmd+C (Mac) on the keyboard, or use the browser copy context menu by right clicking on the selected text.
To exit text selection, which will re-enable the annotations toolbar and redraw annotations on the page, click the 'Toggle text selection' button on the main toolbar.
Limitations:
Dragging the mouse across different ViewONE viewers to select text on multiple viewers is not supported.
This feature is not available when viewed in Internet Explorer and Edge.
This feature is not available if the viewer is configured to use the deprecated functionality to render PDF documents on the server.
A document page displayed in ViewONE is composed of several smaller images (tiles).
The default size of these tiles has been changed from 256 by 256 pixels to 3000 by 3000 pixels
to reduce the number of network calls required to display a page.
A typical document will have a page pixel size of approximately 2000 by 2600 pixels and so will
now be displayed as one tile per page. Very large or high resolution document pages and zooming in
may increase the number of tiles required to display a page.
The size of a tile used may be overridden using tileXSize and tileYSize parameters.
The tileXSize and tileYSize parameters can be configured from a minimum of 100 to an unlimited size.
Where no value is given the default value of 3000 is used.
Where the maximum size is larger than the number of pixels represented by the page, the page width at the
current zoom level in pixels is used. For example, if tileXSize and tileYSize are both set to 9000, but the
page is represented by 100x100 pixels, the requested tile will only be 100x100 pixels. NOTE: This parameter has
no effect on PDFs when the HTML parameter clientPDFTileGeneration is set to true, but is applicable to
all other supported MIME types.
When printing PDF documents with annotations, the annotations are now embedded into the
downloaded PDF document as native PDF annotations. This greatly improves 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
the print process will follow the previous behavior.
The time it takes to prepare a PDF with annotations for print, now 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.
When the print output is saved as PDF, any annotations created by ViewONE are now
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 PDFs. If
this document is subsequently viewed by ViewONE, any annotations will be treated as
static content following previous behavior, where loading a document with pre-applied
native annotations and cannot be edited in ViewONE.
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
Sticky Note's ID will appear next to the top left of the Sticky note, rather than on top of the Sticky Note icon. - *Sticky Note ID's now appear on the note itself from iFix002 *
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.
Limitations
The above behavior does not apply to the following cases:
The following APARs are resolved by this feature:
* IO25707 - DAEJA VIRTUAL VIEWONE PRINT BAND CUTS OFF PART OF TEXT.
PDF Documents that contain native PDF annotations that were created outside of ViewONE now display in the viewer. Previous support for highlight and sticky note annotations has been extended to all standard native PDF annotations. Native annotations created as part of ViewONE's print process also display if the printed PDF is loaded into the viewer.
When viewing an email with embedded images wider than the text body, the images are scaled to avoid truncation of any of the content. All embedded images are now listed in the attachment tree from where they may be viewed full size.
When viewing an email with embedded tables wider than the text body, the whole email now gets scaled to avoid truncating any content of the table, while the text in the body remains at the same size.
The page notification pop-up, that appears when a page is changed, can be turned on/off using the pageNotification HTML parameter. The default value is true, which displays the page notification pop-up.
filenetZOrderEnabled parameter in ViewONE Virtual
When saving and loading annotations with a P8 Content Engine back end via ViewONE Virtual
the layering of the annotations in the user interface is maintained.
Existing annotations are ordered in the interface from the item with the lowest F_ORDINAL
value to the highest, with the highest value overlaying the other annotations.
After changing the document, the page selection will be set to 'All Pages'. The viewer no longer stores previous selections from prior documents.
When the users move from one page to another within the viewer, the magnifier preferences
such as the magnification factor, magnification size, and the location of the magnifier
will be retained across all the pages within a document.
Note:
Password-protected PDF documents can be opened and viewed when the viewer is configured to render PDF documents on the client: A dialog prompt will appear allowing for the password to be input. The viewing of password-protected PDF documents is not supported in PageN mode. A password dialog prompt is open for each page that uses a password protected PDF. If there is more than one page that uses a password-protected PDF document, there is no way to determine which document's password the viewer is asking for. The printing, redacting, and document-building of password-protected PDF documents are not supported.
When the option to render PDF documents on the client is enabled, the ability to invert
the colors of pages in the viewer is now supported. The state of the invert is retained
when changing the edit modes. For more information on client rendering of PDF documents see :
https://www-01.ibm.com/support/docview.wss?uid=ibm10885518.
Limitations: This feature is unavailable in browsers that do not support image filters.
Internet Explorer from version 9 through version 11 has no support for image filters.
This feature adds the ability to search PDF document text and display the search results visually. Search is only available when the PDF document is rendered on the client. The search feature is not available in PageN, Document Builder mode, or when viewed in Internet Explorer and Edge. Limitations: If a word is split across different div elements then it is not regarded as a single word, and will not be in the search result. For more information on client rendering of PDF documents see : https://www-01.ibm.com/support/docview.wss?uid=ibm10885518
When user double right clicks on a text annotation the text edit dialog comes up allowing the user to copy the text. Pressing a CTRL+V on an active text annotation allows the text edit dialog to come up and also pastes the content that is copied.
When annotation sticky mode is enabled (via right-clicking an annotation in the annotation toolbar), this sticky mode is now persisted across pages in a document. The sticky mode is not persisted when a new document is opened.
When the option to render PDF documents on the client is enabled, electronic signatures included in PDFs are now displayed. For more information on client rendering of PDF documents see : https://www-01.ibm.com/support/docview.wss?uid=ibm10885518
This javascript method will allow users to activate an annotation type to be used. The type of annotation is determined
by the 'type' parameter. The following values can be used for the 'type' parameter:
The text search functionality for PDF documents has been enabled for the Virtual viewer integrated within IBM Content Navigator
A javaScript API has been added to get annotations from the viewer based upon their status.
getAnnotations(String json) - gets the annotations based on the status specified in the 'json' string
provided. If the json entry is empty or null, all annotations present in the document will be returned.
Deleted annotations will not be included
The Json format is as follows:
{"status":"
'all' - gets all annotations currently present in the document. Deleted annotations will not be included
'new' - gets any annotations that have been newly added to the document since a save/load of annotations
last occurred.
'modified' - gets any annotations that have been modified in the document since a save/load of annotations
last occurred.
'deleted' - gets any annotations that have deleted in the document since a save/load of annotations last
occurred.
'unchanged' - gets all annotations that are not new, modified, or deleted.
Should status be null or empty, this method will return all annotations currently present in the document.
Deleted annotations will not be included.
Should status be an invalid entry, an exception will be logged (if the traceException parameter is set to
true) and this method will return undefined.
Add support for disabling Individual Document Builder buttons
Users can now have more control over the north toolbar. The following new HTML parameters enable users to be able to individually disable specific Document Builder buttons:
The new HTML parameter docBuilderButtons can be used to determine whether the toolbar includes Document Builder buttons or not when the edit mode is set to 'docbuilder'. When set to false the viewer will hide the Document Builder buttons. By default it is set to true.
The Permanent Redaction Java API (also known as the jiBurner API) has been removed. This was deprecated at IBM Daeja ViewONE Virtual Version 5.0.4.
When all the JavaScript Libraries required for ViewONE are finished loading, VIEWONE_JSLIB_LOADCOMPLETE event is thrown.
Customers can listen to this event by adding a listener as below :
window.addEventListener("VIEWONE_JSLIB_LOADCOMPLETE", myViewoneLibraryListener);
where myViewoneLibraryListener would be the implementation of the listener.
Using the event listener will prevent errors caused by calling viewer functionality before the libraries have completed loading.
Go to the page at Software Product Compatibility Reports to create a high-level report for operating systems, hypervisors and prerequisites.
The size of the Linux specific resource jar, jiserver-resource-linux.jar, has reduced by approximately 50MB.
Published Technote: http://www.ibm.com/support/docview.wss?uid=ibm10733815
Resolved in release: IBM Daeja ViewONE Virtual 5.0.4 iFix 6, all future iFixes on 5.0.4 and IBM Daeja ViewONE Virtual 5.0.5
As of IBM Daeja ViewONE Virtual Version 5.0.6 the following annotation types are deprecated:
*Ruler
*Angle
*Transparent Highlight
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.6 as a component inside IBM Content Navigator, the minimum supported version of ICN is 3.0.6, 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: