Troubleshoot Document Manager

 

+
Search Tips   |   Advanced Search

 

  1. A blank window remains after file download
  2. Import large documents in Portal Document may fail with a RollBackException error
  3. Use Apple Safari browser, unable to exit Document Manager
  4. Document Manager table list is incomplete during initial access
  5. Unable to link to Document Manager from Personalization preview or the Personalized List portlet
  6. Unable to download and install plug-in using Mozilla or Firefox on Linux
  7. Missing buttons and file tree view
  8. Installation of Document Manager plug-in prevented when using an IPv6 (Internet Protocol v6) Web address
  9. Previewing 100MB file might result in an error
  10. Use the timeout feature in DCS for Stellent conversions
  11. Unable to upload large file (10MB to 500MB) to Document Manager
  12. Javascript errors occur when Document Manager plug-in is not installed
  13. Unable to remove documents from Private Drafts or Locked Documents views
  14. An error occurs when importing large files using the Cloudscape database
  15. Error condition 12030 occurs when importing large files using Domino WebServer 6.5.5
  16. Slow Document Manager response time, especially when using workflow
  17. Set the JVM max heap size to enable file importing
  18. Preview of large documents fails in Document Manager
  19. Unable to open an Excel document using Internet Explorer 6.0 SP1
  20. Loss of unsupported features upon conversion
  21. Problems viewing documents as HTML
  22. Problems with searching specific language documents
  23. Problems with Document Conversion Services
  24. Problems with SearchML
  25. Known limitations of Rich Text Editor
  26. Known limitations of HTML preview
  27. Stellent 8.0.1 compatible platforms
  28. Known limitations for Document Manager
  29. Known limitations for Document Libraries
  30. Known limitations for desktop components

 

A blank window remains after file download

When choosing the action to "Download" a document in WebSphere Portal Document Manager (PDM), a blank window remains after the download has finished. It can be closed without any consequence manually; however, this blank window should not appear for every download.

Solution:

Install Portal fix APAR PK18629.

 

Import large documents in Portal Document may fail with a RollBackException error

Problem:

Importing large documents in Document Manager may fail with the following errors in the logs: 

javax.transaction.RollbackException  at com.ibm.ws.Transaction.JTA.TransactionImpl.stage3CommitProcessing(TransactionImpl.java(Compiled Code))
 at com.ibm.ws.Transaction.JTA.TransactionImpl.processCommit(TransactionImpl.java(Compiled Code))
 at com.ibm.ws.Transaction.JTA.TransactionImpl.commit(TransactionImpl.java(Compiled Code))
 at com.ibm.ws.Transaction.JTA.TranManagerImpl.commit(TranManagerImpl.java(Compiled Code))
 at com.ibm.ws.Transaction.JTA.TranManagerSet.commit(TranManagerSet.java(Compiled Code))
 at com.ibm.ws.Transaction.JTA.UserTransactionImpl.commit(UserTransactionImpl.java(Compiled Code))
 at com.ibm.icm.ci.JCRUserTransaction.commit(JCRUserTransaction.java(Compiled Code))
 at com.ibm.icm.ci.JTATransaction.commit(JTATransaction.java:176)
 at com.ibm.icm.jcr.NodeImpl.save(NodeImpl.java:2479)

Solution:

Rollback exceptions may be caused by a slow network. Less distance between servers, and more bandwidth between the database and the server, can reduce errors, particularly when dealing with large files in Document Manager.

 

Use Apple Safari browser, unable to exit Document Manager

Problem:

If you navigate to Document Manager using the Safari browser, then click Cancel when prompted to install the plug-in, you will not be able to use the contextual menus (Launch button) to exit Document Manager. The menu is displayed up but no items can be selected.

Solution:

A workaround is to click Go instead of Cancel when prompted to install the plug-in.

The plug-in installation page opens. Now we can close the plug-in installation and exit Document Manager. Apple Safari browser support for WebSphere Portal is limited.

Document Manager does not work at all with Safari.

See Supported Web browsers.

 

Document Manager table list is incomplete during initial access

Problem:

When Document Manager is initially installed, and you view the document library table list of contents, the table might display only icons and no text, or only the document titles with no icons.

Solution:

Restart the Document Manager Web application or the WebSphere Portal server.

 

Unable to link to Document Manager from Personalization preview or the Personalized List portlet

Problem:

Using...

  • Personalization preview
  • Personalized List portlet

...we might be unable to generate links to Document Manager documents

  • No Document Manager portlet has ever been visited by any user on that portal. In this situation, one of the following messages is output to the error logs:

    The specified document library has not been registered

    ...or...

    PDM Category is not registered

  • The document library to which the document belongs is not configured on any Document Manager portlet, or that Document Manager portlet has never been visited by any user on the portal.

Solution:

Register the document library to a portlet and visit the portlet using an account with the appropriate permissions.

 

Unable to download and install plug-in using Mozilla or Firefox on Linux

Problem:

When accessing Document Manager using a Mozilla or Firefox browser on a Linux system, you are prompted to download and install a plug-in. However, when you click the OK button to proceed with the download, nothing happens. This occurs because Java is required to use Document Manager on a Linux system. A Java applet is used to communicate with the local file system. This applet gives you the ability to edit files using the local document editors, as well as to import multiple files and directories from the computer. By default, the Mozilla and Firefox browsers are not configured to use Java.

Solution:

Download and install Java on the Linux system

After installing Java, navigate to the plug-in directory for the browser, For example, /usr/local/mozilla/plugins. Create a symbolic link to the Java plug-in.

ln -s /usr/java/jre1.5.0_06/plugin/i386/ns7/libjavaplugin_oji.so /usr/local/mozilla/plugins

 

Missing buttons and file tree view

Problem:

If you use the XML configuration interface to transfer a portal configuration that includes Document Manager, buttons and the file tree view might be missing from the user interface panels in Document Manager.

Solution:

When the Document Manager Web module is redeployed, its groups must be mapped to the group...

All Authenticated

...in WebSphere Application Server...

  1. Log in to the WAS administrative console.

  2. Select the Document Manager application, click to...

    Applications | Enterprise Applications

    ...and select the application that starts with Document Manager.

  3. Click...

    Map Security Roles to Users/Groups

  4. Assign the Authenticated role to the All Authenticated group.

  5. Save the changes.

  6. Restart the portal.

 

Installation of Document Manager plug-in prevented when using an IPv6 (Internet Protocol v6) Web address

Problem:

Many Document Manager functions depend on the installation of the Document Manager plug-in on the local system. If you use a Netscape or Firefox browser, and try to access a portal server using an IPv6 URL (Web address), the URL is not accepted correctly, and this prevents installation of the plug-in. An IPv6 URL looks like this: http://[2002:92a:8f7a:20:9:42:81:231]:10038/wps/portal.

A Web site must be accepted as valid or trusted by the browser before installation of the plug-in can be completed. Firefox and Netscape browsers do not accept IPv6 Web sites addresses as valid or trusted. This is due to a bug in these browsers.

Solution:

To install the Document Manager plug-in, use an IPv4 URL instead (example: http://yourserver.yourco.com:10038/wps/portal/.

 

Previewing 100MB file might result in an error

Problem:

If we attempt to preview a 100MB file in Document Manager, we might see this error message on the preview page: 

The document contents could not be previewed. You must download 
    the document to view the contents.

Solution:

Download the document to the local system to preview.

 

Use the timeout feature in DCS for Stellent conversions

Problem:

Viewing large-ized files of 100 MB or more in the HTML preview may cause Document Manager to hang.

Solution:

The timeout feature can be used to terminate the conversion process so that Document Manager doesn't hang. To enable the timeout feature, go to...

portal_server_root/shared/app/converters.xml

and change the TIMEOUT parameter value to 'x' where x is the time in seconds after which the conversion process should terminate.

 

Unable to upload large file (10MB to 500MB) to Document Manager

Problem:

Document Manager has the ability to store documents up to 500MB in size. However, there are several factors that limit actually uploading documents this large.

Solution:

 

Maximum File Size

To maximize the ability of Document Manager to upload large documents set...

PostSizeLimit

...in...

\AppServer\config\cells\plugin-cfg.xml

...to allow documents larger than 10MB to be uploaded into Document Manager.

If an HTTP server is being used in front of the portal server modify the PostSizeLimit to upload documents larger than 10MB. The PostSizeLimit value determines the maximum size document that can be uploaded. The default value for PostSizeLimit is...

10000000 (10MB)

Increase this value to...

500000000 (500MB)

This is the maximum file size supported by Document Manager.

 

Transaction Timeout

The transaction timeout value is the maximum duration (in seconds) for transactions to run on the server before an automatic rollback is issued. This could also be an issue when uploading larger files under load. The default value for this setting is 2 minutes. Increasing the value of this timeout will allow larger files to be uploaded. Experiment with different values for this setting to get it right for the configuration. If the transaction timeout value is a problem you will see a message similar to the following in the SystemOut.log: 

WTRN0066W: Transaction (2633625) 
    0001bba9:00000001e0282f991485e7d9a33267078cf208da52b2bc4bd3055b3adf[] 
    has timed out after 120 seconds.
To modify the value for the transaction timeout value go to the adminisrtative console and execute...

  1. Select...

    Servers | Application Servers | WebSphere_Portal | Container Services | Transaction Service

  2. Set the Total Transaction lifetime timeout.

Database drivers can read large portions of binaries into memory depending on setup and capabilities. Increasing the maximum JVM heap size on the portal server is recommended to work around this problem.

 

Browser timeouts

Uploading documents to Document Manager is done via the browser. Depending on the speed of the network connection to the server, and the size of the document, the upload could take a long time. During this time the browser session might time out, resulting in a file upload failure.

 

Portal server load

The more load the target portal server is under, the more likely it is that timeouts will occur when trying to upload large files. Uploading large documents during off-peak usage hours can help limit this impact.

 

Javascript errors occur when Document Manager plug-in is not installed

Problem:

If the Document Manager plug-in is not installed, Document Manager pages are displayed with Javascript errors. Document libraries can be configured to enable or disable installation of the Document Manager plug-in.

If you do not want to be prompted to install the Document Manager plug-in in the browser, we can configure the document library to disable the plug-in installation. However, if you choose not to install the plug-in when prompted, there will be Javascript errors on the Document Manager page.

Solution:

To disable the installation of the Document Manager plug-in for a document library...

  1. Log in to Document Manager and navigate to the document library where you want to disable the plug-in installation.

  2. Click on the right-hand drop-down menu and click Configure.

  3. Click to deselect Enable browser plug-in.

  4. Click Save to save the document library configuration.

 

Unable to remove documents from Private Drafts or Locked Documents views

Problem:

When a portal user is deleted, then a user with the same name is added to the portal, draft or locked documents created by the deleted user appear in the new user's Private Drafts or Locked Documents view. Because the permissions assigned to the newer user do not apply to the documents created under the deleted user account, the newer user is unable to remove these documents. Details of the document behavior are:

  • If User1 is deleted, then:

    • drafts submitted by User1 cannot be accepted.

    • drafts submitted by User1 can be rejected.

    • private drafts authored by User1 are no longer available.

    • published documents that have a private draft authored by User1 cannot be deleted.

  • If User1 is re-added, then:

    • submitted drafts that were rejected now appear in User1's Private Drafts view.

    • private drafts that were authored by the previous User1 cannot be deleted or modified.

    • published documents that have private drafts authored by the previous User1 cannot be deleted.

    • even if locking is disabled in the document library, any documents locked by the previous User1 remain locked.

      This locking scenario always occurs when locking is enabled for a document library, and a user locks a document, and then locking is disabled. The document remains locked.

 

An error occurs when importing large files using the Cloudscape database

Problem:

When importing a file greater than 100 MB in size, using Document Manager and the Cloudscape database, an error occurs and the import process fails.

This is a known limitation of the Cloudscape database.

 

Error condition 12030 occurs when importing large files using Domino WebServer 6.5.5

Problem:

When importing a file greater than 10 MB in size, using Document Manager and Domino WebServer 6.5.5, the error condition 12030 occurs and the import process fails.

Solution:

By default, the Domino Webserver limits the post request size to 10 MB. When importing larger files, the HTTP configuration parameter needs to be modified as follows:

  • Maximum Post Data Size must be modified to the size of the file to be downloaded

  • Request Content Size should be set to zero (0) to allow unlimited content size

 

Slow Document Manager response time, especially when using workflow

Problem:

In a heavily concurrent environment, Document Manager may experience slow response time. This is particularly a problem associated with Document Manager workflow.

Solution:

Set the Oracle initialization parameter...

session_cached_cursors

...to 100 for the JCR (DB2 Content Manager Runtime Edition) database.

 

Set the JVM max heap size to enable file importing

Problem:

When importing files into a document library while running indexing at the same time, or when importing large documents, an out of memory error might appear, or a portal crash might occur.

Solution:

During text indexing of imported documents, the binary conversion routine might run out of memory writing out the converted string buffer. This problem is encountered with very large text files, or large files stored in a zip file format such as Word documents or PowerPoint presentations. The file size limit is determined by the size of the JVM heapsize. For example, the typical JVM heapsize is 512MB. A 75MB zip file may expand into over 300MB in size and cause the out of memory error, depending on how much of the heap is being used by other parts of the application. Avoid importing extremely large files into Portal Document Manager.

If importing large files, the out of memory error can be avoided by tuning the portal for performance.

  • Set the JVM heap size using the administrative console...

    Servers | Application Servers | WebSphere_Portal | Server Infrastructure | Java and Process Management | Process Definition | Java Virtual Machine | Maximum Heap Size

  • Verify that the system has enough physical memory for all of the processes to fit into physical memory, plus enough for the operating system. When more memory is allocated than the physical memory in the system, paging will occur, and this can result in very poor performance.

  • After doing any tuning of heap sizes, monitor the system to make sure that paging is not occurring.

  • 32-bit operating systems have an address space limit of 4 GB, regardless of the amount of physical memory in the system. This limits the maximum size of each individual process in the system. In addition, some operating systems restrict the size of processes to even less than this limit:

    • Many Windows operating systems have a 2 GB limit.

    • Many 32-bit Linux kernels default to a 2 GB limit for processes.

  • The address space limit further restricts the size of the JVM process. If the process grows larger than the limit imposed by the operating system, it may terminate unexpectedly.

    Refer to the Portal Tuning Guide for recommended values.

 

Preview of large documents fails in Document Manager

Problem:

When previewing a large document, such as a 10MB or larger document, Document Manager might display out of memory errors, or might stop working.

Solution:

Increase the JVM heap size

In addition, you should consult the WebSphere Portal Performance Tuning Guide to ensure that the capacity of the entire portal environment is greater than the intended use. Tuning guides for various versions of WebSphere Portal are available on the Product Documentation Web site.

 

Unable to open an Excel document using Internet Explorer 6.0 SP1

Problem:

When you download an Excel document stored in Document Manager and select Open, the second time the document is downloaded, the open command might fail. This occurs only in Internet Explorer 6.0 SP1, the version that is included in Windows 2000 and Windows XP prior to SP2. A cache problem in Internet Explorer 6.0 SP1 prevents the call to Document Manager to re-send the Excel document.

Solution:

A workaround can resolve the problem temporarily. In Internet Explorer, click on...

Tools | Internet Options | Delete Files | Delete all offline content

Restart the browser.

 

Loss of unsupported features upon conversion

Document Conversion Services, Document Manager can view and edit many document formats via the document conversion framework. As with any document conversion, however, some loss of formatting and features is expected.

The following list details some reasons why documents viewed using Document Conversion Services do not retain all of the features of the program they were created in:

  • The source document uses features not available in the default Rich Text Editor.

  • Conversion from the source document to the target document requires a lossy conversion. For example: vector graphics might be converted to bitmaps on the server.

  • The source application has more formatting and styling options than the default Rich Text Editor.

 

Document Viewer

The viewer makes a read-only HTML rendering of the source document. The business information of the source document should be preserved, though the styles and formatting might diverge from the original. In particular, graphical file formats, such as Freelance Graphics or PowerPoint, render as JPEGs, one per slide. This conversion relies on the graphical capabilities and settings on the server, including:

  • available fonts
  • resolution
  • color depth

For best results, users should ensure that the server has the same fonts available as used in the source documents, and that the color depth of the server matches that of the majority of the clients.

 

Rich Text Editor

The Rich Text Editor uses HTML as its document format. The following features are lost in conversion:

  • Page-level constructs, such as...

    • headers
    • footers
    • page numbers
    • hard page breaks

    ...are not part of HTML. So page breaks will be lost and repeating page-level text, such as headers and footers, will be inline on each page.

  • Graphics within text blocks can change position, since the ability to position graphics within text blocks is more constrained in HTML than in full-functioned word processors.

  • Text control depends on which client browser you use. These controls differ in the details of text layout, especially with regards to complex tables.

  • Client differences, especially across a heterogeneous client platform base, can affect fidelity, especially with regards to available fonts.

 

Problems viewing documents as HTML

Certain file types can be viewed as HTML in Document Manager. If you are having problems viewing a document as HTML, refer to the Viewing documents in HTML topic for a list of supported file types.

 

HTML view is displayed in black and white

The HTML view of color files in Powerpoint,, Freelance and Word, displays grayscale. In Microsoft Word, images are displayed in black and white, while text is displayed in color.

Solution:

The problem lies in starting portal from an XWindows session exported to a Microsoft Terminal Services session. If the portal is started from an XWindows session exported to the Windows box directly, full-color images and text are displayed.

 

Stellent image conversions not working in Linux for Stellent 8.0.1

Stellent image conversions, HTML view of...

  • PowerPoint
  • Presentation documents
  • Excel
  • Word

...is not working in Linux for Stellent versions 8.0.1.

Solution:

On some Linux installations, particularly newer ones, the Motif libraries that are installed are not compatible with the libraries that are used to build the HTML Export technology. This is known to be the case with most SuSE installations. For example, problems can also be seen when using HTML Export and trying to convert graphics files. For example, zero byte graphics files will be generated if the technology cannot find the proper Motif library.

To see if this, execute...

cd portal_server_root/shared/app/oiexport
ldd libsc_du.so

This command prints a list of the Motif library dependencies If the line for the Motif library looks like the following...

libXm.so.1 => not found

...our system may not have a compatible Motif library installed. The proper solution to this problem is to install a compatible Motif library and use it to build the application. Often, the installation discs for the particular Linux platform will have the proper libraries.

Remember that if you are doing development, you will also need the proper header files, as well.

The following is a list of the Motif library versions used by Stellent when building and testing the outside In binaries:

  • x86 Linux lesstif v. 0.89.0
  • zSeries Linux lesstif v. 0.92.0
  • Itanium Linux OpenMotif version 2.1.30

The installation discs for the Linux platform should provide the proper libraries. If the installation discs do not contain the libraries, download a binary RPM.

 

Stellent conversion is not working in Linux for Stellent 8.0.1

During Stellent conversion, the following exception is displayed...

java.util.MissingResourceException: Can't find resource for bundle com.stellent.scd.ExportResources, key 127."

Solution:

Ensure that the file...

libstdc++-libc6.1-1.so.2

...is in...

/usr/X11R6/lib

Alternatively, we can select the compat-libstdc++-296 while installing the RedHat Linux AS 4.0.

 

Stellent does not support comments in Word documents

If the user creates a Word document with comments and then uses the document conversion feature to view an HTML version of the document in Document Manager, text content is visible but comments are not.

This is known limitation of Stellent, which is used in the conversion from Word to the HTML view format.

 

Stellent does not support customized bullet styles

A Word document is created with multiple lines of content, each line using a different custom bullet style, such as telephone or diamond. The document is imported into Document Manager and viewed in HTML format. The custom bullet styles are not preserved in the HTML view.

This is a known limitation of Stellent, which is used in the conversion from Word to the HTML view format.

Limitations viewing documents as HTML
The following issues are expected in the HTML preview of Word and RTF files:

  • Random alignment of text boxes.

  • Preview does not display the following font effects found in Word Shadow...

    • Emboss
    • Engrave
    • Double-Strike-Through
    • Shimmer
    • Marching Red Ants

  • Word text effects not displayed include...

    • blinking background
    • dotted underlines
    • sparkling text

  • The symbols such as omega, zeta and so on are not displayed.

  • Multi-column text will be displayed in a single column.

  • Preview does not display...

    • table borders
    • table border colors
    • styles
    • page breaks
    • agates for DBCS characters
    • page background colors

  • Preview does not display paragraph shading or graphical page borders.

  • Vertical text is displayed as horizontal text.

  • Diagrams and tables may not be displayed in the same order as in Word file.

  • Preview displays a paragraph border as individual borders for each line of the paragraph.

  • Text wrapped around a picture in Word is displayed below the picture.

  • Strike-through with small caps may be rendered unevenly.

The following behavior is expected in the HTML preview of a PowerPoint file:

  • Word art text is displayed as plain text.

The following issues can be expected in the HTML preview of an Excel file:

  • Different cell borders not displayed.

  • Preview doesn't work for an empty Excel sheet.

  • Wrapped text in an Excel file looks different in the HTML preview.

The following problems are expected in the HTML preview of a Lotus WordPro file:

  • On all non-Windows platforms, the HTML preview displays only the text content in the WordPro file. Not displayed...

    • Font formats
    • tables
    • images
    • DBCS characters
    • paragraph styles
    • hyperlinks
    • Bitmap images
    • equations
    • page breaks
    • comments
    • table of authorities
    • table of contents

  • Charts are corrupted in the HTML preview.

The following behavior is expected in the HTML preview of a Lotus 1-2-3 file:

  • Diagrams, including...

    • ellipses
    • rectangles
    • free lines

    ...are not displayed.

 

Problems with searching specific language documents

Problem:

A user cannot search a specific language document in Document Manager. When searching for a specific language document, you may encounter several problems.

Solution:

  1. Create the document with the desired language option. Use the basic search on the same language enabled browser.

  2. You do not have to use the same language version browser. Specify the same language in browser language option or log into a Portal with a user ID that has the same a preferred language.

We can also use the advanced search with the same language option. For example, if you search Japanese documents, you have to create the documents with Japanese language option. Then, you have to search in basic search on a Japanese enabled browser. We can also use the advanced search with the Japanese language option selected.

 

Problems with Document Conversion Services

Some of the limitations require us to perform workarounds. The limitations are related to the IBM proprietary formats being converted to different types of files. The conversion of different types of files that are currently supported by DCS are given below:

  • IBM proprietary formats...

    • Rich Text Editor
    • SpreadSheet
    • Presentation

    ...to...

    • Microsoft
    • Lotus

    ...equivalents.

  • Microsoft and Lotus equivalents to IBM proprietary formats...

    • Rich Text Editor
    • SpreadSheet
    • Presentation

  • IBM proprietary formats...

    • Rich Text Editor
    • Spreadsheet
    • Presentation

    ...to HTML/SearchML.

  • Open office formats and PDF to SearchML.

  • Rich Text Editor to PDF.

  • Conversion of over 250 file formats including...

    • Microsoft
    • Lotus
    • OpenOffice

    ...formats to...

    • HTML
    • SearchML

 

Problem:

After adding a document type to the...

content-type.properties

...file, have to re-import existing documents

Solution:

If you find that every time you preview a document in a specific format, you are prompted to download the file, then we need to add or modify the file types in...

content-type.properties

However, for files that already exist in the document library, you will not be able to preview or convert the documents until you import them again.

 

Problem:

Double-byte (DBCS) characters in a document object or diagram display as XXX when a Microsoft Word document is uploaded to Document Manager and viewed as HTML.

Solution:

This is a known limitation that will be fixed in the next portal release.

 

Problem:

You might receive the following warning when attempting to use WinZip to open remotedcs.zip:

Warning: the size of the extracted file (28509) does not match the uncompressed size (0) recorded in the zip file.

Solution:

Use an archiving utility other than WinZip.

  • Windows: pkzip
  • AIX: unzip
  • Solaris: unzip
  • zLinux: unzip

 

Problem:

After adding Open Office file types to the content-types.properties file, and importing Open Office Writer files, cannot preview these files in Document Manager.

Limitation: Document Conversion Services only supports indexing of Open Office documents. Previewing in Document Manager is not supported.

 

Problem:

Correct version of Stellent must be present for Document Conversion Services to work.

Solution:

The following table shows the correct version of the viewer for the product:

Portal Stellent
WebSphere Portal, versions 5.0.2_hp, 5.0.3 7.7
WebSphere Portal, versions 5.0.2.3, 5.1.0, 5.1.0.1, 5.1.0.2 7.75
WebSphere Portal version 6.0 8.0.1

To check the Stellent version, look in the file...

portal_server_root/shared/app/oiexport/common/verbuild.h.

The fileversion property shows the version of Stellent being used.

 

Problem:

When a PDF file is imported or converted from a Rich Text Editor file and viewed in PDM, it doesn't open in the Portal Documentation Manager (PDM).

Solution:

Install the latest version of Adobe Acrobat Reader at client side to view the PDF files in the Portal Documentation Manager (PDM).

 

Problems with SearchML

Limitations in SearchML
Page number in the Open Office will not be reflected correctly in SearchML, after conversion.
Double Byte Code Set characters in SearchML are illegible after they are converted from Open Office-Calc format.
Currency format of financial function in Open Office will not be reflected correctly in SearchML after conversion.
Header and footer in Open Office will be lost in SearchML after conversion.
Earlier versions of.doc files created with older applications, such as previous versions of Abiword, may not be converted to SearchML.
PDF files with Chinese characters cannot be converted to SearchML.

 

Known limitations of Rich Text Editor

This section describes known limitations for the default Rich Text Editor. Some limitations require that you perform workarounds.

 

Pop-up blocker prevents saving documents in the Rich Text Editor

If you have enabled a pop-up blocker in the browser, you will not be able to save an edited document when you click the close button (X ) in the Rich Text Editor.

Solution:

To avoid this problem, add the portal host site to the list of sites where pop-ups are allowed before you open the document in the rich text editor.

 

Images copied from the clipboard into the Rich Text Editor are not visible from another computer

When creating or editing a document using the Rich Text Editor, if you copy images from a local application, going through the system clipboard, the images do not appear if you view the document from another computer. The images are only visible from the local machine where the copy and paste occurred. This problem happens because the images are saved with the local URL, and are not saved to the portal server. When the same document is opened on another computer, the images are missing since they are not in the location which is stored in the Rich Text Editor document. This is a known limitation of the Rich Text Editor.

 

Spell Checker fails to start in a cluster environment after the version upgrade

The SpellCheck functionality is not working after installing or uninstalling WebSphere Portal, and the SystemOut.log shows the exception 

448aeb8f ContainerImpl E WSVR0501E: Error creating component null 
    [class com.ibm.ws.runtime.component.ApplicationMgrImpl] 
com.ibm.ws.exception. 
RuntimeWarning: Failed to open  
/opt/WebSphere/AppServer/config/cells/pvcent44Network/applications/
    SpellCheckService.ear/deployments/SpellCheckService at 
com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:246).

Solution:

The error occurs because in WebSphere Application Server, during the installation of an application, there is no way to determine if an application has been fully expanded and is ready to be started. The APAR PQ97212 solves this problem. The users can restart the portal server after waiting for 15 minutes. The exceptions will no longer appear since the application is now been fully expanded and ready to be started.

 

Recovering a file from the temporary storage space

While working in a Rich Text Editor file, if the portal session is closed prematurely, or the browser is closed accidentally before we can publish the file into Document Manager, it might appear that the file was not saved. However, the file is available in a temporary storage space, which is located in a path similar to this: 

app_server_root \profiles\Profile_Name\temp\WAS_Cell_Name\WebSphere_Portal\odc\
RichTextEditor.war\cds\Session_Id\Filename.ort

We can recover the file from the temporary space.

The document in temporary storage will contain the unpublished content only if it is has previously been saved by clicking the Save button, or clicking the close window X in the upper-right corner and then clicking Save.

 

Use Mozilla, Firefox, or Netscape browsers

 

Focus in editor window instead of Find/Replace window when using Mozilla

When you are editing a Rich Text Editor file using the Mozilla browser, and use the Find/Replace feature, the focus moves to the editor window after you click the Find or Replace button. To continue using Find/Replace, manually click on the find/replace window to return the focus to that window.

This is a known limitation of using the Mozilla browser.

 

Match whole words option not available in Firefox browser

If you edit documents using the Rich Text Editor through the Firefox browser, you will encounter a known limitation when using the Find/Replace function. In the Find/Replace window, the option to Match whole words when searching content is not available.

Solution:

Use a different browser.

 

No progress window shows when creating or loading a file into the Rich Text Editor

When a rich text file or Internet Mail Box e-mail is created or opened for editing using Mozilla 1.3, the file will load in a background window until the loading operation completes. The editor or e-mail window then will appear in the foreground.

This is a focus issue with Mozilla when both the portlet window and the application window are refreshing. The focus does not move to the application window until loading in the portlet window completes.

Solution:

Wait for the file to load and the focus will correctly return to the opened application.

 

Japanese Yen sign does not always display correctly using Mozilla on Linux

The Japanese Yen sign does not always display correctly and a backslash might be displayed instead.

Solution:

Tahoma font works best for the default Rich Text Editor.

 

Symbol fonts are not displayed in Mozilla version 1.4, 1.6, and 1.7 and in Netscape

In the Mozilla browser, versions 1.4, 1.6, and 1.7, and in Netscape, the symbol fonts such as Wingdings, Wings 3, WP Hebrew David, Monotype Sorts, or Marlett and so on are not displayed in the Rich Text Editor file.

 

Symbol fonts are not displayed in Rich Text Editor (Rich Text Editor) for Mozilla, Firefox, or Netscape browsers

Solution:

To display the text in Symbol font, do the following:

  1. In the Rich Text Editor (Rich Text Editor), change the font to Symbol.

  2. Go to the View Mode.

  3. In the View Mode, change the HTML code for the text with Symbol font. For example, change the following: 

    <span style="font-family: symbol,fantasy;">Text with the symbol font</span>
To <span> <font face="symbol,fantasy;">Text with the symbol font</font></span>

  4. Go back to the Normal View Mode. The text is changed to Symbol font.

 

Bullets do not display in Rich Text Editor or HTML view when using Firefox, Netscape or Mozilla browser

By default, the Firefox, Netscape or Mozilla browser does not support the Wingdings font which includes bullet characters.

Solution:

The workaround is to set the following options for the browser.

  1. Edit the file which sets the encoding of fonts for these browsers. The file is called fontEncoding.properties and is located in the [browser]\res\fonts directory. By default the full path is [root drive]:\Program Files\[browser]\res\fonts\fontEncoding.properties.

  2. Add this line to the font encoding file: 

    encoding.symbol.ttf = windows-1252 encoding.wingdings.ttf = windows-1252

  3. Restart the browser.

This workaround may not be possible for older versions of the browser such as Netscape 7.2 and Mozilla 1.7.12 or 1.7.13, because the properties files is not available.

 

Rich Text Editor closes without saving changes in Netscape browser

The X button at the lower right-hand corner of the Rich Text Editor Window in Netscape browser is used to close the window. The window closes without prompting us to save any unsaved changes.

Solution:

Click the X (Close) button given in the first toolbar of the Rich Text Editor Window.

 

Closing the window using the button in the upper right corner

In Mozilla, if you use the Close button in the upper right-hand corner of the window to close, you might receive numerous prompts to save.

Solution:

Click OK to continue until the prompts no longer appear.

 

Must select text first to insert a hypertext link

When inserting a hypertext link into a Rich Text Editor document using Mozilla or FireFox, select some text first, then click on Insert Link to insert the link. The selected text is used as the content for the hypertext link.

 

Text becomes part of a hyperlink

When text is entered after a hyperlink in Rich Text Editor's HTML Toggle view, using FireFox 1.5 or above and latest Netscape browsers, it becomes part of the hyperlink.

 

Alignment doesn't work for the text with headings that are numbered or bulleted lists

When right or center alignment is applied to the text with headings that are numbered or bulleted lists, using Rich Text Editor in Mozilla, FireFox, or Netscape browsers, only the text moves to the selected aligned position whereas the bulleted or the numbered lists remain left aligned.

 

Rich Text Editor

 

Related to Internet Explorer

 

Related to Mozilla

 

Swedish special characters are not converted correctly in PDF output

When a file is created using Rich Text Editor and the file contains Swedish characters, then the file is converted to PDF, some Swedish special characters are unreadable.

This is a known limitation of Rich Text Editor. To support other languages when the Rich Text Editor file is output to PDF, font support is required. This font support is currently not available for Rich Text Editor.

 

Using Format dropdown menu changes all words in a line of text

In the Rich Text Editor, using the Format dropdown menu changes all words in a line of text regardless of what is selected in the line of text. This is by design.

Solution:

If you want to change the text format in part of a line, use the font or size functions instead.

 

Hyperlinks do not work in edit mode

In the Rich Text Editor, when you are editing a document, the hyperlinks do not work.

Solution:

To follow a link, be in view mode.

 

Cannot cut highlighted text across cells in a table

In the Rich Text Editor, if you highlight text and your cursor crosses the cell border, even if there is nothing in that cell, when we try to cut the selection, the highlighted text will not be deleted.

Solution:

Reselect the text making sure you do not cross the cell border.

 

Characters with extended formats might be lost

In the Rich Text Editor, after you convert a Word document, characters with extended formats such as the ruby feature might be lost.

Solution:

All the features of a native application are available so use a native editor instead of Rich Text Editor. Select Native Editor on the Document Manager Edit panel.

 

Double Byte Character Set font specified in WordPro file not reflected

After converting a WordPro document with Document Conversion Services, the Double Byte Character Set font specified in the WordPro file is not reflected in new file. The default Rich Text Editor font is applied to all the Double Byte Character Set characters in the converted file, while font sizes and font styles, such as bold, are reflected.

Solution:

All the features of a native application are available so use a native editor instead of Rich Text Editor.

 

Cannot save files while in source mode

In the Rich Text Editor, if you save a document while in source mode, when you reopen the document, the source code will display.

Solution:

Do not save files while in source mode.

 

Cannot input Chinese (zh_CN and zh_TW) characters using Input Method Editor in Rich Text Editor

When you create a new Rich Text Editor file and open for editing, you are not able to input Chinese characters using Input Method Editor in Rich Text Editor.

Solution:

Click any button or selection in the Rich Text Editor interface before you start the Input Method Editor.

 

Garbage characters appear in Traditional Chinese

Even if you have set title and description for simplified Chinese, garbage characters appear in Traditional Chinese.

Solution:

Perform the following steps to correct this problem.

  1. Login to portal.

  2. Select...

    Administration | Portal Settings | Supported Markups | HTML | Edit Selected Markups | Set locale-specific setting | Traditional Chinese | Edit

  3. Insert UTF-8 as Character Set

  4. Confirm the settings.

 

A javascript warning pops up on saving the Rich Text Editor document

In the Rich Text Editor, while saving Rich Text Editor document using Mozilla browser, a warning window pops up saying Click OK to continue.

Solution:

Click OK to resume the saving activity. The Rich Text Editor Document gets saved. This is the default behavior of the Mozilla browser.

Do not click 'X' on the warning window

 

Quotation marks are not supported in Rich Text Editor

Quotation marks are not supported in Rich Text Editor on...

  • RedHat Linux
  • pLinux
  • zLinux
  • z/OS

...on all browsers.

Solution:

For those operating systems the following characters are not supported in any of the Rich Text Editor supported browsers:

Left single quote '\u2018'
Right single quote '\u2019'
Left double Quote '\u201C'
Right double Quote '\u201D'

 

Mixed mode text direction change is not supported

If the selected text includes both left to right (LTR) text, and right to left (RTL) text, it is called mixed mode text. In Rich Text Editor, mixed mode text direction change (LTR or RTL) is not supported.

Solution:

Select text with only one kind of text direction, and then click Text direction left to right or Text direction right to left button.

 

The 'Tab' function to navigate the cells in a table, is not supported

In Rich Text Editor, if the user presses Tab/Shift+Tab to go to the next cell in a table, it throws a java script error.

Solution:

This function is not supported in Rich Text Editor. Use the mouse to click on the desired cell.

 

The alt text is not displayed for images

Solution:

The users can do one of the following:

  • Using the Toggle HTML View from the Task Toolbar in Rich Text Editor, the alt attribute can be added to the image (<img>) tags.

  • Using the Standard Compliance Check tool in Rich Text Editor, the alt attributes can be inserted and appropriate text can be added to the value of the alt attribute.

Limitations in Rich Text Editor
If you convert a password-protected file into Rich Text Editor file, you will get an error message.

Password-protected file conversion is not supported.
When you create a bulleted list, the list is shifted to the right. If you highlight and press the Remove Indent button for one item, it deletes that bullet.
In some locales, if you select text for a numbered list, a list of numbers will appear in front of the text. These numbers will be in Arabic numerals, such as 1, 2, 3, not in the locale's numbering system.
Only.jpg and.bmp images can be displayed in Rich Text Editor HTML preview page.
When a Rich Text Editor file is converted to Word and viewed in HTML preview, junk characters are appended at the end of the file.
When a Rich Text Editor file is viewed in HTML preview, some of its content are lost.
The special characters which are stored in two bytes in Single Byte Character Set languages can not be converted from Rich Text Editor file to Lotus WordPro.
After converting a password-protected Lotus WordPro file to Rich Text Editor file you will receive an error message.
The contents of a Rich Text Editor file are not read by the Home Page Reader (HPR) tool.
After converting a Lotus WordPro file to a Rich Text Editor file on Unix, the following can occur:

  • The text features of bold, italic, underline, or a combination of bold, italic, or underline with left, right and center alignment are lost

  • The text features of font colors, font size, font styles and background colors are lost

  • Hyperlinks are changed to plain text

  • Bullets with different styles and formats and numbering with different formats are lost

  • Drop capital letter for the beginning of the paragraph do not display in the correct line of the paragraph

  • Table Of Authorities and Table Of Content do not function

  • Inserted lines in a page without any content in the page are not displayed in the output file. The lines will be displayed only if they are entered between two lines of text. Multiple lines are not reflected between the two texts, only one line is displayed. Different line styles are not reflected as it was in input file.

  • Equations are lost.

  • Background color, object, and chart are lost.

  • Comments inserted for any text are lost.

  • Page breaks are lost.

  • Images are lost.

  • Section divisions are lost

  • If there is a table in the WordPro document, the table format is lost and the contents of the table display vertically.

  • Headers and footers are not appended.

After converting a Lotus WordPro file to a Rich Text Editor file on Windows, the following can occur:

  • Bitmap images, equations, page breaks, comments, table of authorities and table of contents are not converted

  • A WordPro file with content in a non-English language, such as Arabic, Hebrew, or Ukranian, displays junk characters in the HTML view and also after conversion to the Rich Text Editor.

  • Headers and footers are not appended.

  • Charts are corrupted.

After converting a Rich Text Editor file to a Lotus WordPro file, the following can occur:

  • Varying text indentions created using "increase indent" or "decrease indent" feature are changed to a single indention setting in the WordPro file.

  • Space between lines and paragraphs is lost.

  • Right-alignment of paragraphs is lost.

  • Some table cell contents are lost.

  • The inserted comments are not displayed.

  • Default bullet style changes.

  • Images are not reflected.

  • Background colors are not reflected.

  • Hyperlinks are not reflected.

  • Table properties change.

  • Double byte character set displays as garbage characters.

  • Double Byte Character Set Rich Text Editor files cannot be converted.

  • The page breaks inserted in the Rich Text Editor file are not appended.

  • The text direction changes are not reflected.

  • The multiple lines with numbering in table cells appear in a single line.

  • The charts are not converted.

  • Water mark conversion does not work.

After converting a Microsoft Word file to a Rich Text Editor file, the following can occur:

  • Diagrams displayed in reverse order.

  • Text direction change is not reflected

  • The Symbol font is not supported.

  • Single border shows as multiple borders.

  • On AIX, symbols are not converted for fonts such as Webdings, Wingdings, Wingdings2, Wings 3, WP Hebrew David, Monotype Sorts, Botanical and Marlett.

  • Table border color and background color is not reflected.

  • On AIX, objects inserted do not show after conversion.

  • Nested tables do not appear.

  • Random alignment of text boxes

  • Font effects in Word such as, Shadow, Emboss, Engrave, Double-Strike-Through, Shimmer and Marching Red Ants are not converted.

  • Page breaks and agates for DBCS characters are not reflected in the Rich Text Editor.

  • Vertical text is displayed as horizontal text.

  • Text wrapped around a picture in Word is displayed below the picture.

  • Comments inserted for any text are lost.

After converting a Rich Text Editor file to a Microsoft Word file, the following can occur:

  • Hyperlinks are lost.

  • Lines are not displayed.

  • Sixteen background colors are converted and the remaining colors are changed to the default white background.

  • Not displayed...

    • bullets
    • numbering
    • table borders

  • Page breaks are not appended.

  • Only the.jpeg and.png images are displayed.

  • A table inserted within another table is removed and it's content is displayed vertically in the outer table (in which the table was inserted).

After converting a Rich Text Editor file to a PDF file, the following can occur:

  • Loss of background color.

  • Special characters in Swedish, German, Turkish, and Slovak do not render correctly.

  • Double byte character set displays as garbage characters.

  • If there is.bmp image in a Rich Text Editor file, after conversion to PDF, the HTML view of the PDF is blank. The user cannot view or download the converted PDF file.

  • Applied font styles are not reflected exactly as input; instead, all text content is shown in the same font style.

  • Filled circle bullets are displayed instead of numbered bullets.

  • A document created with all reserved characters fails to convert, giving the error message "An error occurred while trying to convert the document"

  • Change in text direction is not reflected.

  • Empty tables and blank lines are lost in PDF output.

  • Comments are lost in the PDF file.

  • The DBCS characters of other languages such as Chinese or Turkish may not be displayed correctly.

 

Related to Internet Explorer

 

Choosing the Normal heading in Format inserts HTML tags around lines

In the Rich Text Editor, if you choose Normal for a heading in the Format box, it will automatically insert HTML tags.

Solution:

Switch to source mode and manually edit the HTML.

 

Pressing Enter does not work with the image dialog box

After creating a new Rich Text document, if you use the keyboard sequence of...

<Ctrl+Shift+p>

...to bring up the insert image dialog box, tab to the Browse button and then press Enter, nothing happens.

Solution:

Invoke the Browse button by pressing the space key, not by pressing Enter.

 

Cannot select a table to delete

In the Rich Text Editor, you might find it difficult to select a table so that we can delete it.

Solution:

To delete a table, highlight the surrounding elements and press Delete or delete the cells one by one.

 

Related to Mozilla

 

Problem with deleting characters in a table

In the Rich Text Editor, if you hold the Backspace key down, it will delete the characters in that cell, then the characters in the adjoining cells and then the cells themselves.

Solution:

To delete the entire table from both the HTML source and the Rich Text Editor, press the delete key again.

 

Cannot remove underlining in a table

In the Rich Text Editor, an underline cannot be removed if a table is created within a table cell. For instance, if you have a table and then create a table within a cell of the original table that has underlining in it, the new table will also have underlining in all the cells.

Solution:

Select the whole cell again and then click the underline button to remove the underlining.

 

Entire list does not bold

In the Rich Text Editor, if you have a list of items, select them all, and select bold, the last item does not bold.

Solution:

Select the next line, even though it is blank and the last item will become bold.

 

Trouble inserting a URL

In the Rich Text Editor, if you try to insert a URL it looks like nothing is inserted.

Solution:

You have to select the text first, then insert the URL. The selected text will then be associated with the link.

 

Difficulty cycling through keyboard accessibility functions

Due to Mozilla's implementation of the tab key while in edit mode, you might have difficulty selecting various keyboard accessible features from the Rich Text editor.

Solution:

If the tab key does not work, try using shift + Tab to select the item you want.

 

Changing text direction does not work

In a Mozilla/Firefox browser, the changing text direction feature may not function properly in Rich Text Editor, if the selection includes multiple content or even the whole content.

Solution:

Select a single line of text, and then click Text direction left to right or Text direction right to left button.

 

Formatting of different paragraph styles in Rich Text Editor is lost when converted to a PDF

In Rich Text Editor, paragraphs with different styles are shown as a single paragraph, when converted to PDF in Mozilla.

Solution:

This is a limitation of Mozilla browser. Conversion to a PDF works fine in Internet Explorer.

Limitations in the Rich Text Editor
On Internet Explorer, if you hit Tab, it does not indent. Instead, the dropdown menus in the toolbar are highlighted.
On Internet Explorer, if you insert a table, we cannot undo that action.
On Mozilla, bold, italic, and underline do not work with CTRL+B, CTRL+I and CTRL+U.
The Cut, Copy, Paste buttons does not appear in the Rich Text Editor tool bar if the editor is opened using Mozilla browser.

 

Related to Mozilla

 

Contents from Rich Text Editor files cannot be copied to Spreadsheet Editor

The contents from Rich Text Editor files cannot be copied to Spreadsheet Editor in Mozilla using the menu selection Paste. When any content is copied from Rich Text Editor documents and pasted on the Spreadsheet Editor in Mozilla, the Paste menu does not work.

Solution:

You need to click on the input bar and press the keys ctrl + v. This pastes the content into Spreadsheet Editor.

 

 

Problem:

Using keyboard sequences for copy and paste causes application failure

If you use Ctrl + C to copy data and Ctrl + V to paste data multiple times, you might see all the rows of data moved to one cell. In Mozilla, this causes the application to crash.

Solution:

Use the drop-down menu to copy and paste instead of the keyboard sequences.

 

Internet Mail Box

 

Viewing as HTML

In Internet Mail Box, there might be some issues with viewing HTML. For instance,

  • Some Double Byte Character Set characters do not display

  • Can show fuzzy images and different font sizes

  • AutoCAD file does not display correctly

  • Some of the text in presentation attachments can overlap

  • Text under pictures moves

Limitations
If you e-mail a presentation or a spreadsheet with color charts or graphs using Internet Mail Box, and then view it as HTML, the colors might change.
In the Korean and other locales, titles that have UTF-8 characters in Notes e-mail, might display garbage after being sent via Internet Mail Box.

 

Known limitations of HTML preview

This section describes the known limitations of HTML preview. Some of the limitations require that you perform workarounds.

  • The nested tables inserted in a Word file are not displayed.

  • An extra line of characters is displayed in the Word file that is converted from the Rich Text Editor format.

  • Table inserted in a Word file is not displayed in HTML view.

  • Preview of a Word file with Hebrew set as language in the Internet Explorer, is displayed with the scroll bar on the right side.

  • The.pcx image type is displayed with an additional header.

  • While viewing a converted Lotus 123 file in a HTML view, the Unicode characters are missing and the hyperlinks are displayed as plain text.

  • Page numbers in Lotus Word Pro file are not appended in HTML view.

  • Some of the Ukrainian characters of a PPT file are not displayed.

  • Numbered, alphabets, and Roman numeric bullet lists of a PPT file are displayed as filled circle bullets.

  • Stars are displayed instead of bullets, if the fonts that are used in a bullet list in a PPT file are not installed on an Unix machine.

  • The Hebrew characters in a PPT file are arranged incorrectly.

  • The chart of an Excel file is displayed as vertical strip in the HTML view.

  • On Solaris platform, an Excel document cannot be previewed without downloading it to view its contents. The error message, "The document contents could not be previewed. You must download the document to view the contents" is displayed.

  • When a Wordpro file with Arabic or Hebrew characters is converted to Rich Text Editor format, junk characters are displayed in the file.

  • The following are some of the known limitations when the Lotus Freelance files are viewed in HTML preview:

    • Different Bullet styles are not reflected.

    • Charts are not displayed.

    • Different shapes such as boxes, pyramids, and so on with text are displayed as rectangles.

    • Different connectors are displayed as straight connectors.

    • Text properties such as shadowing, depth and so are not displayed.

    • On AIX platform, some of the font styles might be missing, inserted objects are not displayed, and strike-through text is displayed as plain text.

  • On iSeries platform, the different font styles used in a PPT file are not displayed in the generated HTML file.

 

Problem:

The Arabic or Chinese fonts of a PPT file are not displayed in the generated HTML file.

The Arabic or Chinese fonts are displayed when the generated HTML file is viewed in a browser on a Windows machine, which has all of the fonts that are specified in the file. However, opening the generated HTML file in a browser on a Solaris system displays the text in fonts different from the ones specified in the generated HTML output.

Solution:

Install the Arabic or Chinese fonts on the Solaris system in order for a HTML with graphics conversion of an Arabic or Chinese PPT file to be correct.

 

Stellent 8.0.1 compatible platforms

The compatible platforms of Stellent 8.0.1 are given in the following table:

Platform Version
Windows (32-bit) Windows NT 4.0 (and above)
Windows 95
Windows 98
Windows 98SE
Windows ME
Windows 2000
Windows 2003
Windows XP
Windows (64-bit) Windows.Net Server 2003 Enterprise Edition
HP/UX (RISC 32) 11.0 and 11.i
HP/UX (Itanium 64) 11i
IBM AIX (32 with iSeries 5.1 - 5.3
iSeries (OS/400 using PASE) V5R2
Red Hat Linux (x86) Advanced Server 2.1, 3.0 and 4.0
Red Hat Linux (Itanium) Advanced Server 2.1, 3.0 and 4.0
Red Hat Linux (zSeries, 31-bit) 7.2
SuSE Linux (x86) 8.x - 9.x and Enterprise Server 9.0
SuSE Linux (Itanium) Enterprise Server 8
SuSE Linux (zSeries, 31-bit) 7 and 8
Sun Solaris (SPARC) 7.x - 10.x
Sun Solaris (x86) 8.x - 10.x

The Stellent 8.0.1 does not support pSeries such as AIX/Linux on POWER5 and z/OS environment.

 

Known limitations for Document Manager

This section describes known limitations for PDMDocument Manager. Some of the limitations have solutions to help you solve or work around the problem.

 

Do not use Display like Internet Explorer option in Netscape 8.1

Using the Display like Internet Explorer option in the Netscape 8.1 browser disables the Document Manager plug-in functions. Netscape 8.1 does not recognize installed Internet Explorer plug-ins.

This is a known limitation.

 

An error message is displayed when first opening a Microsoft PowerPoint file

When a Microsoft PowerPoint file is created or opened for the first time in Document Manager, an error document was not found is displayed. However, the file is opened and the contents are correct. The error message is not shown when the file is opened the second or subsequent times.

This is a known limitation of Document Manager.

 

SQL exception occurs when creating folders deeper than ten levels

An SQL exception occurs when creating folders deeper than ten levels within Document Manager or Personalization with IBM DB2 Universal Database for z/OS version 7.1 The user may get an error when creating the eleventh-level folder, or be unable to create documents underneath the eleventh-level folder. The folders or documents will appear to have been created, but the user will not be able to successfully navigate to or search for the documents. The logged error message is...

SQL0129N The statement contains too many table names. SQLSTATE=54004

Solution:

An attempt should be made to minimize the depth of the hierarchy for managing content. This is a database limitation when using DB2 for z/OS version 7.1.

 

Pagination count of folder content is displayed incorrectly

If more than ten levels of folders are created in Document Manager with IBM DB2 Universal Database for z/OS version 7.1, the pagination count of the folders is not displayed correctly starting with the eleventh-level folder. Instead of reading page 11 of X (where X is the total number of folder levels), the pagination count is 1 of X. The pagination is also incorrect at any folder level beyond the eleventh level. Also, if the user navigates to the root folder and then back to the eleventh-level folder, the folder is not visible.

This is a database limitation when using DB2 for z/OS version 7.1.

 

Search for documents by author returns no results

When executing a search for documents using the author name as the search criteria, or when creating a custom document view using the document author or modifier as view settings, Document Manager returns no search results, even though there are documents in the library that match the criteria.

Solution:

Use lower-case characters when typing the author's name in a document search, or when specifying a document author or modifier while creating a custom document view. If you use the Directory Search Find a Person function to specify an author, and there are upper-case letters in the author name provided by the search results, modify the author name to use lower-case letters.

 

Failure to create a document or folder in Document Manager

In Document Manager, the maximum allowed lengths of string fields such as title and description can vary depending on the language and database. For English values, all of length limits imposed by the user interface correspond to the maximum allowed database lengths. However, for other languages such as Japanese and Chinese that are represented with more than one byte per character when encoded, the limits imposed by the user interface will be larger than the allowable number of characters in the database. If a user enters more Japanese or Chinese characters than allowed by the database, the user will not be able to create a document or folder in Document Manager.

Solution:

To avoid this problem, users might have to enter values shorter than the maximum input allowed by the user interface.

 

While importing a directory in Document Manager , URLs are reversed in a second Mozilla or Firefox browser window

This problem appears if you are using Document Manager and open two Mozilla or Firefox windows while importing a directory. For example, navigate to the Document Libraries portlet and click Import page for a document library, then click Select Directory and Select and Import. In a second Firefox or Mozilla browser window, enter any URL. The URL is reversed (www.yahoo.com becomes moc.oohay.www).

Solution:

This is a known limitation.

 

An SQL exception occurs when navigating or searching within Document Manager or Personalization in i5/OS

An SQL exception occurs when navigating or searching within Document Manager or Personalization in i5/OS. The error message is...

SQL statement too long or complex. SQL0101

Solution:

DB2 in i5/OS has a limit in the number of subselects that can be contained within an SQL query. The limit is 31 subselects. The repository used for Document Manager and Personalization executes SQL queries that use subselects. The two primary contributors to the total number of nested subselects are:

  • the predicates within a query or search (e.g. a = b, a < b, etc.)

  • the depth of the hierarchy

Predicates: The number of subselects per predicate depends on how many datatypes include the property referenced in the predicate condition. Each predicate will use approximately 3 subselects at minimum, but that depends on the number of types having the property. So if there are 3 datatypes containing the property there would be 3*3 = 9 subselects used. In the Document Manager and Personalization query and search scenarios, there is typically one datatype containing the referenced property. Therefore if there are 31 subselects possible and 3 used per predicate there are 31/3=10 predicates possible within a query or search. However, this is assuming 0 depth in the hierarchy.

Depth of Hierarchy: There are 2*depth of hierarchy subselects added to the SQL statement in a query or search. Since there is a limit of 31 subselects, there is a maximum depth of 15 that a query or search can execute over (31/2 = 15). However, this is assuming there are no predicates in the query or search statement.

Assuming an average of four predicates per query or search statement for 4*3=12 subselects, that leaves us with 31-12=19 subselects left for query depth. That means a maximum of 19/2=9 levels deep in the hierarchy. An attempt should be made to minimize the depth of the hierarchy for managing content.

 

Document Manager temporary filespace could fill up server filesystem

The Document Manager temporary filespace gradually fills up with temporary user files. If errors occur and users are not logged out of the portal server during normal operations, the temporary filespace used by Document Manager to hold working files for these users might not be cleaned up. Normally this temporary space is cleaned up when a user logs out of the portal server. The temporary space is located at...

portal_server_root/InstalledApps/Document_Manager_xx.ear/pdm.war/temp

Solution:

If there are no users logged into the portal server, it is safe to delete all subfolders found in the temp directory. These subfolders contain only transient data and are not needed after a user logs out of the system. Do not delete the files found in the temp directory (for example, empty.ope), only delete folders found in the temp directory.

 

Importing more than 5000 documents into a document library produces an error

When importing a large number of documents into a document library, an error may occur when the number of imported documents is greater than 5000.

Solution:

Divide the import process into several steps so that each import contains less than 5000 documents.

 

Executing search may return documents based on the meta-data

Meta-data for documents is also indexed for search and executing a search may return documents that do not appear to match the search criteria. This is because the meta-data matched the search criteria.

Solution:

There is no workaround to this problem.

 

Bulk export of document from Document Manager not supported

Document Manager and Document Libraries do not support exporting multiple documents in one action (bulk export).

Solution:

This is a known limitation.

 

People tag drop-down is cut off by the preview window

Using Document Manager with Internet Explorer, if you click on a movie file, such as an AVI or MPEG file, a document preview is provided using a helper application from the local system. The helper application window pops up to ask to save or open the file. If you click Open, the helper application plays the movie in a preview window. Once this window is displayed, if you click the people tag drop-down to see the Last modified by information, the bottom portion of the people tag drop-down is cut off by the preview window, whether there is a movie playing there or not.

Solution:

This is a known limitation.

 

Preview of large document files (10 MB or larger) using Internet Explorer might take a long time to complete

If we preview a document that is 10 MB in size or larger, the Internet Explorer browser might seem to lock up because the preview operation can take 4 or 5 minutes to complete. This is a known limitation of using Document Manager with Internet Explorer.

 

To initiate plug-in installation, user must click a white, unlabeled button when using Netscape 8.1

When using Document Manager in the Netscape 8.1 browser, the Install Missing plug-in button is shown as a white, unlabeled button. This occurs on Document Manager pages which require the plug-in, such as the document library view, edit a document, or in the Document Libraries portlet.

Solution:

Click the white, unlabeled button to display the Install Missing plug-in button in the toolbar. This is a known limitation of using Document Manager with Netscape 8.1.

 

Creating a custom Document Manager view fails, or takes an excessively long time, when using Cloudscape

When creating a custom view in Document Manager, if you specify a multiple-word title search with the All words option selected, the view creation process might fail, or take an excessively long time to respond. This problem occurs when Cloudscape is the portal database.

Solution:

Use the search function rather than creating a custom view to perform multiple-word title searches for Document Manager content. We can also configure the portal to use a different database, such as DB2 or Oracle.

 

Importing files with path longer than the maximum path length fails in Windows

Windows has restrictions on the maximum path length allowed for a file. This limit is not known to Document Manager ahead of time. When importing files from Document Manager to the local machine, if the file path is longer than the acceptable Windows maximum path length, then the file import will fail with an error such as: 

    Could not download document to file filename. Error code error code.
More explanation of the error codes can be found at the Microsoft Web site.

 

Import or export failure messages reported by the Windows Document Manager plug-in

When using a Windows-based local system to import or export documents from Document Manager, the import or export might fail, and the plug-in will display an error as a result. If the error contains an error code, we can find more information about the exact cause of the error at the Microsoft Web site

 

A script error message appears when previewing large documents using Netscape 8.1 or Mozilla 1.5

When previewing a large document using Document Manager and the Netscape 8.1 or Mozilla 1.5 browser, a script error message window may appear, even though the document is successful previewed.

The problem occurs because the Javascript timeout is set to 5 in Netscape 8.1, which uses Gecko/20060127. The timeout is also set to 5 in Mozilla 1.5, which uses Gecko/20060111. However, Mozilla doesn't seem to obey this option. A workaround is to set the dom.max_script_run_time variable to zero (0) to allow documents larger than 2.5 MB to be downloaded.

 

Error message when trying to create a path (subdirectory), or import a file with a length greater than 180 characters

An error message is displayed when the user tries to create a path (subdirectory) with a length greater than 180 characters in Document Manager. The same error occurs if the user tries to import a file into Document Manager when the name of the file is more than 180 characters.

The workaround is to choose a path (subdirectory) name or file name with a length less than 180 characters.

 

Document does not appear in Submitted Drafts view due to long file path

There are limitations on the overall length of the file path for a document, which includes all folder (directory) names containing the document, plus the file name of the document.

The maximum path length allowed in Document Manager is 1000 characters for documents not involved in workflows and 200 for any documents that are involved in workflows.

For example, if you create a workflow folder path of 180 characters in length, then a document name of 25 characters, the document is placed in the draft folder instead of the submitted folder, indicating that workflow is broken. If the folder path alone exceeds the 200 character limit, you will not be able to create a document within the workflow. There are several additional folder and file name path length limitations imposed by other components.

Due to operating system limitations, creating paths greater than 180 characters in length will cause problems with any operations that interact with the file system, such as roundtrip editing. Also, paths greater than 300 characters (including file name) will cause navigation problems in Internet Explorer as these paths exceed the maximum allowed URL size.

 

Portal administrator (wpsadmin) can not restrict access of the owner of a PDM file or folder

This is working as designed. There is no way to restrict access for an author of a document.

 

Some characters cannot be used when naming documents

We can create document names using non-Latin characters (such as Japanese and Cyrillic). However, some characters are invalid, such as...

  • asterisks (*)
  • question marks (?)
  • greater than and less than signs (< >)
  • percent signs (%)
  • at signs (@)
  • forward and backward slashes (/ \)
  • apostrophes (')
  • double quotes (")
  • pipes (|)
  • colons (:)
  • square brackets ([ or ])

You receive an error message when trying use a name with these characters. Document names can contain spaces but cannot be the same as an existing document name.

 

Lotus 123 chart displays twice in HTML view

If you upload a Lotus 123 document to Document Manager in which you have created a chart of any type (for example, line, area, or pie), we might find the HTML view of the document (viewed by clicking on the file name link) displays the chart twice, once within a cell and again below the sheet area.

Comments: This issue will be fixed in a future release.

 

Colors in charts and graphs change after being e-mailed with Internet Mail Box

If you e-mail a presentation with color charts or graphs, and then view it as HTML, the colors might change.

 

Receive an error when trying to upload a file with Document Manager

If we try to upload a file or create a document and receive an error message similar to: 

Error creating new document! - resourceNotFound,

our Web server might not be configured to receive HTTP PUT requests or if you use a proxy server, that might not be configured to receive HTTP PUT requests.

Solution:

Configure the Web Server to allow HTTP PUT requests. If you use a proxy server, also configure proxy server to allow HTTP PUT requests.

 

WordPro conversion to Rich Text Editor on Unix servers does not convert graphics

Solution:

Configure Portal to use a Remote DCS Server on Windows. On Windows servers, the WordPro import filter is fully-featured, which means that text, character and paragraph attributes, graphics, and other formatting is supported.

 

On Linux, cannot open and edit files using various editing software and cannot import multiple files and directories from a local system.

Solution:

On Linux, a Java Applet is used to communicate with the client file system. This applet gives you the ability to edit files using the native editors and also to import multiple files and directories from the client file system. In order to run the applet, have a supported Java Runtime Environment installed on the browser.

For installation instructions on Mozilla, visit the Mozilla Plug-in Support on Linux (x86) and follow the instructions to install the Java Runtime Environment.

Once the Java Runtime Environment is recognized in the browser, you should be prompted to accept an IBM certificate when you first visit the edit or administrative import pages. You should choose to always accept this certificate for the applet to be able to read and copy files from the local machine.

After you accept the certificate, you might need to refresh the page. The plug-in attempts to read and write the files you are editing to the temporary directory defined in the java.io.tmpdir system property. Users need to have authority to create directories and files in that path (usually /tmp/). Lastly, the plug-in requires that KDE be installed and that the kfmclient be in the path. Visit the KDE Web site for information about installing KDE. The kfmclient exec command is used to open files with the editors registered in KDE.

 

Send a Link is not available when editing a document

When editing a document, the Send a Link option does not appear on the More Actions menu. Save the file and then click on the file name to go to the read view of the document. From the read panel, you will be able to click More Actions and then Send a Link.

 

Document Manager does not support Web Services for Remote Portlets (WSRP)

An exception occurs when trying to use Document Manager through WSRP.

 

Searching for terms not in the JVM's locale does not find indexed.html and.txt documents

HTML and text documents are indexed using the JVM's locale and not according to the encoding of the document. Searching for terms not in the JVM's locale does not find indexed.html and.txt documents. For instance, if the system is running an English locale, a DBCS HTML document will be indexed using an English codepage. Searching with a DBCS term will not find the HTML file.

 

Known limitations for Document Libraries

 

Authentication errors occur for document import tasks that run longer than two hours

Authentication errors occur for document import tasks that run longer than two hours When importing large numbers of documents into a document library using the Document Libraries portlet, if the import takes longer than two hours, authentication errors (HTTP 401 errors) can occur.

Solution:

The LTPA token that is used during the Document Libraries import task has expired before the import task has completed. By default this value is set to two hours. When doing large document imports that can take longer than the value set for the LTPA token timeout, increase the LTPA token timeout to a value that allows the import job to complete. The LTPA token timeout setting can be found and set in the administration console...

LTPA | Authentication Mechanisms | Timeout

 

Import a file using Document Libraries may fail because of an existing file with the same name

Problem:

When importing a file using Document Libraries, if a locked document with the same file name already exists in the target document library, the import fails. While trying to import the file, the portal shows the error...

The following document already exists in this library, do you wish to overwrite?

...but if you click Yes, rather than successfully overwriting the existing file, the import fails with the message...

A document with the same name already exists and you do not have permission to replace it

Solution:

This is a known limitation of this release. We can change the name of the file you wish to import to work around the problem.

 

Create document library fails due to number of groups

Problem:

When creating a document library, if LDAP security is enabled, and there are a large number of users (more than 300), the create document library function might fail with the message...

The number of groups are more than supported

Solution:

To work around this error, edit wmm.xml and change the default setting...

maximumSearchResults="200"

...to...

maximumSearchResults="300"

 

Known limitations for desktop components

 

Do not use an IPv6 (Internet Protocol V6) Web address with desktop components

During desktop component configuration, if you use an IPv6 URL (Web address) in the Document Manager Server URL field, the URL does not work correctly and an error message is displayed. An IPv6 URL looks like this...

http://[2002:92a:8f7a:20:9:42:81:231]:10038/wps/desktop

Solution:

Use an IPv4 URL instead...

http://yourserver.yourco.com:10038/wps/desktop

 

Desktop components does not reflect changed document library settings

When document library settings are changed, such as enabling or disabling workflow or document locking, remove the document library and re-add the library so that desktop components can pick up the new settings. No data is lost when removing and re-adding a document library.

 

Drag a folder from desktop components to a local drive does not work correctly

Dragging a folder from a Document Manager directory in the desktop components section of Windows Explorer to a local system drive (such as C:) does not copy the folder structure correctly.

Solution:

This is a limitation in the design of desktop components. We can copy or drag files directly from Document Manager in the browser to a local directory, so you should use this option instead. Before copying, ensure that a file with the same name does not already exist on the local drive.