IBM Daeja ViewONE, 5.0.4 iFix 6 Readme

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

Readme for: IBM Daeja ViewONE

Product or component release: Version 5.0.4

Update name: iFix 6

Prerequisites before installing IBM Daeja ViewONE, Version 5.0.4 iFix 6

You must have IBM Daeja ViewONE, Version 5.0.4 installed.

Before you install IBM Daeja ViewONE, Version 5.0.4 iFix 6:

Installing IBM Daeja ViewONE, 5.0.4 iFix 6

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

To install this package:

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

    There are platform specific jar files:

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

  4. Copy the client and server files into the relevant places in your web application and ensure that the application is deployed as per your web app server specific requirements.
  5. Verify that the correct version of IBM Daeja ViewONE is deployed to the web application server. This can be done by displaying the About Box in Daeja ViewONE (Standard, Professional and Virtual) by clicking on the ViewONE logo in the bottom right corner. Verify that the version number 5.0.4 iFix 6 is listed at the bottom of the About Box. To check the version of the Server Module, display the Image Properties dialog in Daeja ViewONE Professional when displaying a PDF or TIFF image and the Server property should be 13033. The Image Properties dialog can be displayed by pressing Shift-i.

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

Removing IBM Daeja ViewONE, 5.0.4 iFix 6

If you want to remove the iFix 6 from your installation and revert back to the original 5.0.4 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.4 uninstallation program to remove IBM Daeja ViewONE 5.0.4 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.

Configuring the Viewer

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

IBM Daeja ViewONE 5.0.4 Virtual Developer's Guide

Fixes included in IBM Daeja ViewONE, 5.0.4 iFix 6

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:


IO25754 TIFF CONVERSION FAILS TO TAKE IN TO ACCOUNT TIFFORIENTATION TAGS DURING DOCUMENT BUILDING

When the orientation tags are applied to TIFF images, the document building process generates an image with incorrect rotations.

Affected users: IBM Daeja ViewONE Virtual users


** Logging slows down the server

When many trace parameters are enabled, the server slows down and may become unusable. A performance improvement has been made that reduces the time taken to log messages when the system is heavily loaded.

Affected users: IBM Daeja ViewONE Virtual users


IO26538 IMAGE CAN FAIL TO DISPLAY IF A NONE ENGLISH LOCALE MACHINE OPENS A DOCUMENT

When a document is requested from a client locale that uses non-ASCII characters a document may fail to be displayed. This error is caused by invalid characters being added to an HTTP header and may be reported in an HTTP error log.

Affected users: IBM Daeja ViewONE Virtual users


** Improvements to scrolling performance when using Document Builder

Performance decreases and the viewer potentially hangs when scrolling through pages of large documents in Document Builder mode.

Affected users: IBM Daeja ViewONE Virtual users of Document Builder


** Some German characters do not display in some PDF documents

Some German characters, including "ß", do not display in some PDF documents.

Affected users: IBM Daeja ViewONE Virtual users


IO26468 PDF DOCUMENTS WITH SPECIFIC FONT SHADING METHODS FAIL TO RENDER

Some PDF documents that contain text that is drawn with certain shading methods may fail to display with a Null Pointer Exception.

Affected users: IBM Daeja ViewONE Virtual users


IO26545 WORD DOCUMENT WITH DEFAULT TAB WIDTH VALUE SET TO ZERO FAIL TO RENDER AND CAUSE A HUNG THREAD

Opening a Word document with a default tab width of zero causes a hung thread. A user opening this type of document will be left with 'Waiting for document...' message and the server will show two threads using a large amount of CPU. If this type of document is requested several times the server will become unusable and the application server will need to be restarted.

Affected users: IBM Daeja ViewONE Virtual users


IO26455 PAGE NAVIGATION BUTTONS WOULD INTERMITTENTLY DISABLE WHEN RENDERING SOME DOCUMENTS

The page navigation buttons on the top tool bar would gray out intermittently for some documents. The problem is seen more often for bigger files. The problem would likely show when the file is first loaded, but it's intermittent.

Affected users: IBM Daeja ViewONE Virtual users


IO26521 NUMBER OF PAGES ON A SECOND LOADED DOCUMENT IS INCORRECT IN INTERNET EXPLORER

Subsequent documents in Internet Explorer can show up blank or missing pages during the same browser session. This issue is due to the response caching policy configured in the browser.

Affected users: IBM Daeja ViewONE Virtual users


ER165631 EVENT 37 DOES NOT FIRE ON A SHORTCUT KEYPRESS

When using keyboard shortcuts event 37 was not fired. With this fix users will be able to track shortcut keypresses via the javascript bridge output. This feature allows users to track and extract data from use of the system regarding keypresses. Users can track when keyboard shortcuts are activated and how frequently they are activated. An example of usage could be an office wanting to track usage of the print shortcut to be audited and reported on. This event output will allow users to dynamically configure the viewer to operate under a set of key presses.

Affected users: IBM Daeja ViewONE Virtual users


ER165631 MISSING KEYBOARD SHORTCUTS FOR NAVIGATING ON A ZOOMED PAGE

There is missing functionality with shortcuts to navigate around on a zoomed page. This functionality was missing because the viewer does not use scrollbars for each part of the page unless you are zoomed in to an extent that the browser generates them for the user. The missing shortcuts were to navigate to the top, bottom, left, right and middle of a page either vertically or horizontally. Below are the newly added keyboard shortcuts:
Go to top of current page: CTRL + HOME
Go to end of current page: CTRL + END
Go to far left of current page: SHIFT + HOME
Go to far right of current page: SHIFT + END
Go to vertical center of current page: CTRL + SHIFT + HOME
Go to horizontal center of current page: CTRL + SHIFT + END

Affected users: IBM Daeja ViewONE Virtual users


** PRINT RANGE AVAILABLE VIA KEYBOARD SHORTCUT

It is now possible to print a range of pages using a keyboard shortcut. Press 'CTRL+P' to open the Print Dialog with the Print Range Option selected.

Affected users: IBM Daeja ViewONE Virtual users


** UNABLE TO CHANGE PRINT OPTIONS WHEN USING PRINT KEYBOARD SHORTCUT KEYS

When the print is activated using the shortcut keys 'P' or 'SHIFT+P', none of the options on the Print Dialog are enabled.

Affected users: IBM Daeja ViewONE Virtual users


Fixes released in previous versions



IBM Daeja ViewONE Virtual 5.0.4 iFix 5


** Memory usage on the server increased

The document expiry time for server side document rendering is configured using the wrong parameter name and default value. The default value should be 120 seconds, but was modified to be 30 minutes. This could potentially cause memory issues for some users due to the document being retained in memory for the longer period than is necessary. The ability to customise the value is also compromised as the name used to retrieve a custom value is incorrect.

Affected users: IBM Daeja ViewONE Virtual users of release 5.0.4 iFix 4 only

Recommended actions: Upgrade to 5.0.4 iFix 5



IBM Daeja ViewONE Virtual 5.0.4 iFix 4


IO26074 ANNOTATION SAVE BUTTON IS NOT CORRECTLY ENABLED ON TEXT ANNOTATION CREATION WHEN ANNOTATIONS ARE ALREADY PRESENT ON THE DOCUMENT

If a text annotation is added to a document, the annotation save button should be enabled as soon as the first text character has been entered into the annotation bounding box. However, if there are already annotations present on the document, the behavior changes and depending on the value of the HTML parameter allowTextRubberband you will see that the save button either gets enabled directly before any text has been entered or does not get enabled until you complete text entry and click on the document away from the annotation.

Affected users: IBM Daeja ViewONE Virtual users


** ANNOTATION TOOLBAR DISABLED AFTER PASTE TO EMPTY DOCUMENT

The annotation toolbar may not become enabled when pasting a page in to an empty document. This occurs in Document Builder mode with the HTML parameter 'annotateEdit' set to true.

Affected users: IBM Daeja ViewONE Virtual users


IO26469 SOME PDF DOCUMENTS DISPLAY WITH SQUARES INSTEAD OF HEBREW CHARACTERS

Some PDF files display with squares in place of Hebrew Characters.

Affected users: IBM Daeja ViewONE Virtual users


IO25025 PDFS CREATED BY CERTAIN PRODUCERS DISPLAY INVERTED WHEN DISPLAY USING THE PLATFORM INDEPENDENT PDF MODULE

Some PDF documents, created by certain PDF producers, display areas of the page inverted.

Affected users: IBM Daeja ViewONE Virtual users


** Setting the logging parameter traceServerInit to false can still output some log messages

Setting the traceServerInit server-side parameter to false should prevent all non-critical logging messages from being output to the 'standard output stream' log file. When the 'logFile' parameter was not set, there were circumstances where some log messages were still being output to the 'standard output stream' log file.

Affected users: IBM Daeja ViewONE Virtual users


IO26408 EMAILS WITH & CHARACTERS IN THE BODY TEXT FAIL TO DISPLAY WITH ERROR MESSAGE, INCORRECT PAGE COUNT

When an email contains the character '&', the error message 'Incorrect Page Count' is shown and the email fails to be displayed.

Affected users: IBM Daeja ViewONE Virtual users


** Improved rendering of PDF documents with specific font shading methods

Improved the rendering of some PDF documents that contain text that is drawn in a certain way that may result in failure to render with a Null Pointer exception.

Affected users: IBM Daeja ViewONE Virtual users


** Unable to paste pages into a document when all pages have been deleted/cut

An error, "The Page number specified is invalid", is displayed in Document Builder Mode when selecting all pages of the document, cutting and attempting to paste back to the empty document.

Affected users: IBM Daeja ViewONE Virtual users of Document Builder


IO26103 ANNOTATIONS DO NOT ROTATE AND DISPLAYED CORRECTLY AFTER CREATE, SAVE AND RELOAD ANNOTATIONS

Annotations can show incorrectly rotated when saved and reloaded on tiff files with rotation tags.

Affected users: IBM Daeja ViewONE Virtual users


** New setPageSelection API Call for Document Builder Mode

New API call, setPageSelection allows for the ability to select multiple pages via JavaScript Call.
setPageSelection(activePage, pageSelection)
will select the pages specified by pageSelection and will set the active page to activePage.
pageSelection is a JSON input in the form;
{"selectedPages":[1,3,5,10]}
For example;
setPageSelection(3,{"selectedPages":[1,3,5,10]})
will result in pages 1,3,5 and 10 being selected with page 3 being the active page.
If setPageSelection(3,{"selectedPages":[1,3,"5-10"]}) is called then;
pages 1,3,5,6,7,8,9 and 10 would be selected with page 3 being the active page.

Affected users: IBM Daeja ViewONE Virtual users of Document Builder


IO26356 MEMORY LEAK CAUSED BY CONFIGURATION REGISTRATIONS NOT BEING CLEARED

Rendering configurations stored on the server by the viewer during the course of a session are not removed causing a memory leak.

Affected users: IBM Daeja ViewONE Virtual users


** REDUCED NUMBER OF REQUESTS FROM CLIENT TO SERVER

When viewing a page, extra requests were being made for lower resolution images of the page. These lower resolution images of the page were not being displayed. They were just requested and then ignored.

Affected users: IBM Daeja ViewONE Virtual users


** IMAGE NETWORK REQUESTS NOT PRIORITIZED

When viewing a document, network requests for each tile in the prefetch area are all sent at once, regardless of which page is currently being displayed.

Affected users: IBM Daeja ViewONE Virtual users


** New deleteDocumentPages() API call for Document Builder Mode.

New API call that allows multipage deletions in one operation.
deleteDocumentPages(firstPageToBeDeleted, lastPageToBeDeleted)
will delete the pages between and including, those specified by firstPageToBeDeleted lastPageToBeDeleted.

Affected users: IBM Daeja ViewONE Virtual users of Document Builder


** Page selection updated event (87) now contains pages selected in a JSON payload.

The page selection updated event (87) now contains a JSON payload listing the pages currently selected and whether the pipe is selected. If the pipe is true then any insertions will occur prior to the page number of the selection.
For example, if pages 1,3 and 10 are selected in the viewer, event 87 would contain the following JSON;
{"selectedPages":[{"page":{"pageNumber":1, "pipe":false}},{"page":{"pageNumber":3, "pipe":false}},{"page":{"pageNumber":10, "pipe":false}}]}
If the pipe before page 1 is selected in the viewer, the event payload would be;
{"selectedPages":[{"page":{"pageNumber":1, "pipe":true}}]}
If a page was added with this selection, the new page would be number 1, if the pipe was false, it would be page number 2.

Affected users: IBM Daeja ViewONE Virtual users


IO25607 ON AIX/LINUX SERVERS, OFFICE MODULE FONT REPLACEMENT MESSAGES APPEAR IN STDOUT

Opening office documents on AIX/Linux server, for each document opened there are many Font:xxx substituted with:serif messages displayed in the standard output stream. On IBM WebSphere Application Server, the standard output stream is redirected to SystemOut.log.

Affected users: IBM Daeja ViewONE Virtual users


IO26371 WORD DOCUMENT CONTAINING EMBEDDED PICTURE WHICH IS PARTIALLY OUT OF PAGE BOUNDARIES CAN CAUSE OUT OF MEMORY ERROR

Word documents with a table row containing a picture which is positioned in a place that is outside the page boundaries will cause the renderer to enter an infinite loop while trying to place the picture. One will see the page X of Y counter keep counting up without stopping. The server will see out of memory errors eventually.

Affected users: IBM Daeja ViewONE Virtual users


IO26401 WORD DOCUMENT WITH INCOMPLETE STYLE SPECIFICATION THROWS EXCEPTION

When opening a word document with extension .docx an exception 'This document has been truncated because of an error that occurred while retrieving the requested page'. is thrown while loading the document and the document is not rendered.The error is caused by the absence of word/styles.xml part which defines the styles used by a word document.

Affected users: IBM Daeja ViewONE Virtual users



IBM Daeja ViewONE Virtual 5.0.4 iFix 3


** Extra page selection updated (87) instances are fired

Extra page selection updated events are fired when in Document Builder mode.

Affected users: IBM Daeja ViewONE Virtual users


** Total page count not updated when changed by an action in Document Builder.

When adding or removing pages in Document Builder mode, the total page count is not updated to reflect new document size.

Affected users: IBM Daeja ViewONE Virtual users


** Error dialog for failed document load does not display

When a document fails to load the error dialog is not displayed.

Affected users: IBM Daeja ViewONE Virtual users


** Page added event (81) not fired

The JavaScript event 81, for page added, is not fired when a page is added in Document Builder Mode.

Affected users: IBM Daeja ViewONE Virtual users


** Print Stickynote Summary checkbox is disabled when annotationAllowHideAll is set to true

Print Stickynote Summary checkbox is disabled when annotationAllowHideAll parameter is set to true. So users cannot print the sticky note summary when annotationAllowHideAll is set.

Affected users: IBM Daeja ViewONE Virtual users


IO25444 USING SHIFT KEY AND MOUSEWHEEL TO ZOOM OUT OF A DOCUMENT CAUSES PAGE RELOAD

When holding down the Shift key and using the mousewheel to zoom in and out of a document, zoom in works correctly (mousewheel forward) but zoom out (mousewheeel backward) causes a reload of the entire HTML page.

Affected users: IBM Daeja ViewONE Virtual users


** ROTATION NOT HONOURED WHEN USING MOVEPAGE() API

The rotation of pages are not honoured when using the MovePage() API in Document Builder Mode.

Affected users: IBM Daeja ViewONE Virtual users


IO26185 TABLES IN SOME PDF DOCUMENTS RENDER INCORRECTLY

Tables in some PDF documents render with black squares and has a 'smeared' effect such that none of the text in the table can be read.

Affected users: IBM Daeja ViewONE Virtual users


IO26228 SOME PDF DOCUMENTS WITH FLATE ENCODED IMAGES MAY RENDER AS BLANK.

Some PDF documents that contain flate encoded images may not render correctly and may give the appearance of blank pages.

Affected users: IBM Daeja ViewONE Virtual users


IO26198 SOME PDF DOCUMENTS RENDER WITH MISSING SECTIONS.

Some PDF documents containing vector graphics may render with sections of the PDF missing completely.

Affected users: IBM Daeja ViewONE Virtual users



IBM Daeja ViewONE Virtual 5.0.4 iFix 2


IO26419 UNABLE TO VIEW TIFF IMAGE WITH INVALID PAGE_NUMBER TIFF TAG

TIFF fails to render with a generic error on page:
Unable to display document: An error occurred whilst retrieving the requested page. TIFF images that have the wrong TIFF tag type cannot be viewed.
In the server-side log file, the following messages will be seen:
TIFFFilter: Problem reading the TIFF tags. Current Count :0
TIFFFilter: java.lang.NullPointerException
Filter jiFilterTIFF is valid but failed to load.

Affected users: IBM Daeja ViewONE Virtual users


** KEEP SCROLL INNACCURATE FOR ROTATED PAGES

With keep scroll enabled, changing page to a page with a different orientation does not maintain the relative position on the page.

Affected users: IBM Daeja ViewONE Virtual users


** EXCESSIVE SERVER IMAGE REQUESTS

When a page is rendered, extra image requests are being made to the server.

Affected users: IBM Daeja ViewONE Virtual users


IO26297 DELETEALLANNOTATIONS JS METHOD TAKES A LONG TIME.

When user tries to delete large number of annotations using deleteAllAnnotations JS method time taken to delete these annotations is very long.

Affected users: IBM Daeja ViewONE Virtual users


IO26403 LARGE PDF FILES CAN ENCOUNTER OUT-OF-MEMORY ERRORS WHEN PRINTING THE FILE

Large PDF files made up of many images can cause a large memory overhead. This problem would be exacerbated when the PDF file is handled as part of the print operation where Daeja ViewONE Virtual needs to process the entire document and annotations.

Affected users: IBM Daeja ViewONE Virtual users


IO26260 OPENING A LARGE LOCAL TIF FILE RESULTS IN AN ERROR

Failed to open a large local TIF file on the client. Error: 'Unable to display document. An error occurred while retrieving the requested page'

Affected users: IBM Daeja ViewONE Virtual users


IO26081 LZW TIFF IMAGE WITH MULTIPLE STRIPS FAILS TO DISPLAY CORRECTLY

A TIFF Image with LZW encoding that has multiple strips adds extra data at the end of each strip causing it to be displayed incorrectly.

Affected users: IBM Daeja ViewONE Virtual users


IO26350 TEMPORARY FILES IN WORKING DIRECTORY ARE NOT REMOVED

When using the grabImage API within ViewONE Virtual the working directory is not cleaned up. Files that are left behind have a file suffix and extension of b64.tmp

Affected users: IBM Daeja ViewONE Virtual users


** SCROLLING SPORADICALLY CAN RESULT IN A BLANK GREY SCREEN

When scrolling rapidly through a document with many pages, the scroll position of the scrollbar can point to the wrong place in the document. This leads to the current page not being displayed so the user sees a blank gray screen.

Affected users: IBM Daeja ViewONE Virtual users


** ROTATION ISSUES WITH ORIENTED TIFF DOCUMENTS

When the orientation tags are applied to tiff images, the rotation actions can be performed incorrectly.

Affected users: IBM Daeja ViewONE Virtual users


** Prevent the parameters 'allowAnnotationRotationOnTags' and 'rotateAnnotationsWithView' from erroneously impacting TIFF document

The parameter 'allowAnnotationRotationOnTags' that is supported in Daeja ViewONE Professional and Daeja ViewONE Standard and the parameter 'rotateAnnotationWithView' that can be used by Daeja ViewONE Professional and Daeja ViewONE Standard when embedded in a FileNet or Content Navigator system are not supported in Daeja ViewONE Virtual. This fixes the issue where those parameters impacted the display, printing and redaction

Affected users: IBM Daeja ViewONE Virtual users



IBM Daeja ViewONE Virtual 5.0.4 iFix 1


** Performance is slow on a zoomed in document

At high zoom levels, the performance when scrolling through a document is slow and memory usage increases noticeably.
Performance optimizations have been applied to resolve the above.

Affected users: IBM Daeja ViewONE Virtual users


IO26349 EMAIL RENDERING WITHOUT ATTACHMENT

An email (EML) with an attachment marked as inline, but with no reference to the image in the email, does not show the image in the email or in the list of attachments.

Affected users: IBM Daeja ViewONE Virtual users


IO26330 RENDERING BECOMING PROGRESSIVELY SLOWER

The rendering of document becomes progressively slower during use with the cause of the delay due to blocked URL constructors attempting to locate protocol specific URLStreamHandlers.

Affected users: IBM Daeja ViewONE Virtual users


IO25611 DECREASE LINE WIDTH OPTION FOR ANNOTATIONS ON THE VIRTUAL VIEWER CAUSES THE LINE TO DISAPPEAR

When user tries to decrease the line width on annotations after reaching minimum value the line disappears .

Affected users: IBM Daeja ViewONE Virtual users


** Using Ctrl + A to select all pages does not highlight the thumbnail images

When in document builder mode selecting all pages using the ctrl + a keyboard shortcut selects all pages, but provides no visual indication that they are selected.

Affected users: IBM Daeja ViewONE Virtual users


IO26293 THE STICKY NOTES NUMBERING REPEATS THE FIRST NUMBER.

During creation of Sticky note annotation, the sticky note annotation numbering repeats the first number.

Affected users: IBM Daeja ViewONE Virtual users


IO26259 UNABLE TO VIEW WORD DOCUMENT SHOWING TRUNCATION ERROR ON-SCREEN.

Opening an Word document does not render document and displays the following message on screen 'This document has been truncated because of an error that occurred while retrieving the requested page'.

Affected users: IBM Daeja ViewONE Virtual users


IO26258 VIEWER DOES NOT DISPLAY THE 2ND PAGE OF THE WORD DOCUMENT.

Opening a word document fails to display second page of the document.

Affected users: IBM Daeja ViewONE Virtual users


IO26187 ANNOTATION UPDATE EVENT (32) DOES NOT GET FIRED

Subsequent annotation update event (EventID:32) is not fired after annotations have been saved. The save can also occur from JavaScript which will have the same issue.

Affected users: IBM Daeja ViewONE Virtual users



IBM Daeja ViewONE Virtual 5.0.4


IO26257 EMAIL DOCUMENT DOES NOT RENDER IN VIEWONE VIRTUAL.

Opening an email document containing a invalid xml character(0x1e) causes the error 'An error occurred whilst retrieving the requested page'.

Affected users: IBM Daeja ViewONE Virtual users


** The print dialog has no spacing between the labels and the input fields.

The print dialog has no spacing between the labels and the input fields. This lack of space makes it difficult to distinguish between the borders of the labels and input fields, causing the dialog to appear very crowded.

Affected users: IBM Daeja ViewONE Virtual users


IO26263 VIEWER KEEPS THE SCROLL POSITION WHEN NOT IN KEEP SCROLL MODE

When HTML parameter keepscroll is set to false, navigating to other page after scrolling retains previous page’s scroll information.

Affected users: IBM Daeja ViewONE Virtual users



Additional Release Notes

Deprecation of INVERT feature

The Invert feature is to be deprecated from the next release. This includes all associated parameters, GUI features and API methods. The invert feature is defined in the following articles: https://www.ibm.com/support/knowledgecenter/en/search/invert?scope=SSTPHR_5.0.4

jiBurner API Deprecation notice

As of this release of IBM Daeja ViewONE Virtual, the jiburner API is deprecated. Details of the API can be found in: https://www.ibm.com/support/knowledgecenter/SSTPHR_5.0.4/com.ibm.viewone.developing/dvodv000.htm and https://www.ibm.com/support/knowledgecenter/SSTPHR_5.0.4/com.ibm.viewone.developing/permredact/ji/burn/package-summary.html

Document Builder

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

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

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

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

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

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

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

Restore annotations is not supported in document builder mode

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

Scenario 1:

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

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

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

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

Daeja ViewONE as an Integrated solution

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

Known problems, issues, and limitations

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

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

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

Comparison with native renderers

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

Excel spreadsheet load times

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

Prompt to save redacted documents uses hexidecimal filename

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

No pageN support in document builder mode

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

Scenario 1:

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

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

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

No docN support in document builder mode

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

Document Builder supported file type limitations

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

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

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

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

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

Annotations that have the transparent property set to true and a fill color set to black are not printed transparent .

Copyright and trademark information

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

Notices

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

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

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

THIRD-PARTY LICENSE TERMS AND CONDITIONS, NOTICES AND INFORMATION

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

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