I'm working with Kofax Capture Workflow Agents. I have installed some WFAs before, but they didn't run on first try and I'm not really sure what I've done to get them working.
Currently, I follow these steps to install my WFA:
- Compile my Source-Files to one DLL
- Remove Workflow Agent from Batch Classes
- Uninstall Workflow Agent over Tools > Workflow Agents
- Copy over to my Test-Environment
- Install Workflow Agent over Tools > Workflow Agents
- Add Workflow Agents to Batch Classes
- Publish Batches
- Close Administration and Run new Batch in Batch Manager
I have installed this particular WFA before and I was able to use it before. This is why I am always using the same AEX-File as none of the Properties change. But somehow, it suddenly stopped working and I can't re-install it properly.
Am I doing something wrong?
Edit:
I tried out a lot of things with the best result when I changed the whole AEX-entry. I'm pretty much giving Kofax another Workflow Agent, as name, progid, file and version is different.
I'll have to find out which of these are really needed, but I got a lot of 429 ActiveX errors and I'm not sure whether I registered the DLL by windows or not.
Okay, I finally managed to install a workflow agent correctly with the following steps:
- Compile source code COM-visibly (add attributes ComVisible, ProgId and ClassInterface)
- Unregister old DLL (if any) via
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe <old DLL> /u
- Register new DLL via
C:\Windows\Microsoft.NET\Framework\v4.0.30319\RegAsm.exe <new DLL> /codebase
- In the workflow agents manager inside the administrator, click Add, choose your new DLL, choose your workflow agent and click Install. You don't have to do this for remote sites, but the DLL has to be registered in COM as well.
As the Kofax DLL's are all x86, it's preferable to change your settings to this architecture as well (instead of Any CPU, for example).
If you're developing a 64-bit library instead, you must use the executable in Framework64 (instead of Framework). If you use .NET <4.0, you also have to use the executable inside v2.0.50727(instead of v4.0.30319).
Even though a warning message is displayed after COM-registration, it is not necessary to use a strong assembly name (it is encuraged though).
For installation in Kofax Capture, you can also use the command line executable %Kofax_Bin%\RegAscEx.exe, which has a pretty useful help page (use -?). You don't have to call this one on remote sites as well.
1st answer clearly explains the procedures when you are installing the WFA for the very first time.
However if you want to change or update the existing WFA, you do not need to follow the uninstall and re-install approach. Just copy and replace the old dll with new dll by keeping old settings AS-IS(.net version, prgid, UID etc...) .
I do this all the time and it works like a champ :)
