Skip to main content

Processing batch is failing. The specified MarkView instance does not exist.

Question / Problem: 

After importing batch classes from Production into my testing environment, I encounter the following error in Capture when attempting to process and export a batch.

Export Error: Script #1 (Markview Document EC) [0 Kofax.MarkViewExport.MarkViewApi+InvalidInstanceException: The specified MarkView instance, 'SUFPRD' does not exist. Run MVImportAPIConfig to configure instances. at Kofax.MarkViewExport.MarkVi...

The above error indicates that the MarkView Invoice batch class is configured to use the “'SUFPRD” MVImportAPI instance to export invoices to MarkView but the MVImportAPI instance itself is not set up.

Caused by:

1. In Capture, Export Connector does not have a correct instance name for export setting for MarkView API Configuration. It is either blank or wrong.

2. 32-bit version of ODBC is not configured correctly.

3. TNSNAMES.ora has a wrong TNS alias name.

4. MarkView Import API Configuration instance does not exist or is configured incorrectly.

Answer / Solution: 

1. Change the reference to the MVImportAPIConfig instance in the affected batch class(es). you would need to follow the steps below:  

a. In the Kofax Capture Administration console, expand the affected batch class

b. Right-click on the corresponding document class and select "Export Connectors..."

c. Select the Kofax MarkView Export Connector in the Assigned Export Connectors list.

d. Click on "Setup"

e. In the "Export Settings" section, select the correct MVImportAPIConfig instance name.

f. Click "OK"

2. Re-publish the batch class. The re-publishing process checks the integrity of the settings in your batch class and makes the batch class available for use.

a. Start the Kofax Capture Administration module.

b. Select the Batch class tab.

c. Right-click the batch class and select Publish from the Context menu.

The Publish window opens.

d. Select your batch class and click Publish. Kofax Capture checks all of your batch class settings and displays the results in the Results box.

         ▪ If no problems exist, the message "Publishing successful" appears.

▪ If problems exist, error and warning messages appear along with the recommended actions to resolve the problems.

3. The oracle ODBC, ODAC driver / TNSNAMES.ora is not setup correctly.

a. Check 32-bit ODBC is setup and configured correctly by navigating to C:\Windows\system32\odbcad32.exe

b. Check TNS alias name in TNSNAMES.ora has been configured correctly by navigating to C:\app\Administrator\product\11.2.0\client_1\Network\Admin

4. Check MVImportAPIConfig tool on all Kofax Capture machines and confirm if there is a MarkView Invoice instance listed. There should be a shortcut to that MVImportAPIConfig on the desktop, so it is easy to find.

· If the instance does not exist, go ahead and create it:

a. Run MVImportAPIConfig.exe. The Import API Configuration window opens.

b. Click New to create a new instance.

c. Enter the name of the new instance, such as MarkView Doc or MarkView Invoice.

d. Select the MarkView tab and enter the appropriate information.

e. Click OK.

· If the instance exists, check the database connection:

a. Run MVImportAPIConfig.exe. The Import API Configuration window opens.

b. Select the affected instance (as used by the "MarkView Document" document class) and click on "Preferences..."

c. On the MarkView tab, click on "Test DB"

d. If “Test DB” fails, check the 3 “Database” fields (User, Password and Host).

Please also look at Export Connect Troubleshooting Guide:

Applies to:  

Product Version Category
MarkView         8, 9, 10                 
Kofax Capture 10, 11                    


Author:  Shawn Abedi

5/29/2019 – Article Created