beautypg.com

Kofax DOKuStar Validation User Manual

Page 77

background image

DOKuStar Validation for Ascent Capture

Page

73

Validation now comes up with the last changes you made in the workspace. Play a little around to get a feeling. You
could remove the call to

storeDefault

and check that changes of workspace will no longer take effect.

To write it to a file is probably not the best method to save a workspace. Therefore it is also possible to store the
workspace information in the registry. The corresponding commands are

workspaceSink.LoadWorkspaceFromRegistry

and

workspaceSink.SaveWorkspaceToRegistry

.

The registry path that is used is

HKEY_CURRENT_USER\Software\\Workspaces\

.

The base path is controlled by

RegistryKey

. If

RegistryKey

is an empty string, which is its default value,

Validation uses the standard base path

DOKuStar Validation\

for

base path

. If it is a single

key, Validation appends the standard base path to the specified key. If it contains a hierarchy, Validation uses the
value as it is.

RegistryKey

must be specified in the function

IAddIn_Initalize

, otherwise it will take no effect.

The sub-key has to be specified in the load and save functions.

In our example we use the single key

ValiTour

for

RegistryKey

. Therefore Validation will append its

standard base path. We will have to take that into account when we check the registry key for our workspace later.
To be able to set

RegistryKey

we will have to provide the workspace service also in the function

IAddIn_Initalize

and to delete the corresponding statement in

dsValApp_OnFinalInitialized

. In the load

and save functions we will use the sub-key

Default

. Therefore Validation will use the following registry path (for

version 3.2; for later versions replace this string):

HKEY_CURRENT_USER\Software\ValiTour\DOKuStar Validation\3.2\Workspaces\Default