A Troubleshooting

This appendix describes common problems that you might encounter when using the Oracle WebCenter Enterprise Capture client.

This appendix contains the following section:

A.1 Handling batch errors

You may occasionally encounter errors as you work with batches and release them. You may be able to resolve some common errors based on the error explanation provided. In other cases, you may need to contact your Capture workspace manager and provide the batch name and error displayed. This section lists some error examples.

For information on configuring logging, see How do I set batch logging?.

Errors while working on batches

  • If you perform a database lookup and no records are found, the client displays the message, "No results were returned by the Database Lookup".

  • When trying to view a non-image document in an associated application, if there is an error attempting to open the document in the associated application, the client displays the error message: "Failed to open document in an associated application. There may be no application associated to this document type".

Errors after releasing batches

  • If an error occurs for a batch after you release it, such as during a post-processing step, the batch may display again in your batch pane, locked to you. (Note that a post-process may have renamed the batch.) You can right-click the document error icon and choose Display Batch Errors from the menu to view the error details.

    Figure A-1 Viewing Batch Errors

    Description of Figure A-1 follows
    Description of "Figure A-1 Viewing Batch Errors"
  • If you released a batch without completing all required metadata fields in each document, an error occurs if Capture is set to commit the batch as a post-processing step. Typically, Capture commits all documents and removes them from the batch. However, documents that contain errors remain in the batch. To resolve the error, open the batch, complete all required metadata fields in all documents (an asterisk * is displayed to the left of their names), and release the batch again.

    Figure A-2 Viewing Batch Processing Errors

    Description of Figure A-2 follows
    Description of "Figure A-2 Viewing Batch Processing Errors"

A.1.1 How do I set batch logging?

Logging can be useful for tracking or monitoring batches. If a Capture workspace manager requests logging, follow these steps to activate logging or change its detail level.

  1. Click the drop-down list arrow in the upper right corner of the window and select Preferences. The Preferences window displays.
  2. In the Logging Level field, select a new level.

    By default, logging is set to Off. Other values include Severe, Warning, Info, Config, Fine, Finer, Finest, and All.

    Log files are stored locally in the .oracle_capture\Log directory in your home directory. A log file is named as follows: WC{date} where date is in the format of MMddyyyy.

  3. Click Save.