Power PDF Connector SDK
How to test a connector

To test the functionality of a connector, use this quick checklist as a reference:

  • Verify that the connector is loaded in Power PDF.
    - Verify whether the connector exists under the Open from DMS button in the File > Open dialog box.
    - Verify whether "[Power PDF install folder]\resource\Kofax\PDF\UILayout\Publish Mode.xml" contains correct references to the buttons of the connector and "%appdata%\Kofax\PDF\KofaxPDF\UILayout\Publish.xml" is deleted.
  • Verify whether the button or menu item contains the correct strings (depending on the localization language).
  • Verify whether the button or menu item states (enabled/disabled) change appropriately depending on whether no document is opened, a local document is opened, or a document is opened from the connector.
  • Verify whether it is possible to open a document with the connector (and whether the document state on the server is changed if required).
  • Verify whether it is possible to save the open document (as the same version, a new revision, a new version, depending on the connector).
  • Open a local PDF document and verify whether you can save it to the connector.
  • Verify whether the document state on the server updates correctly after closing the document.
  • Update a document that was opened from the connector, and then close it first before saving the changes. Verify that the user was asked whether the changes should be saved first, and also that the document is properly closed (and saved) depending on the user choice.

Logging

Logging

Turn on logging by replacing recdiag_log.ini in the Power PDF installation folder (for example, "c:\Program Files (x86)\Kofax\Power PDF\") with the recdiag_log.in_ file which is also located in the installation folder. You can specify the log file name and path in the .ini file in the LogFileName parameter.

The logfile not only contains connector related entries, but many other modules also produce the log into the same file. You can find the list of connectors enumerated from the registry, and whether the application could successfully instantiate and initialize them. All calls to the connectors are also logged.

Note
The calls on the IPropertyPageHandler interface are not logged yet.

About debugging connectors

To debug your connector with Microsoft Visual Studio, you need to change the Command in the Debugging section of your project properties to Power PDF. (For example "c:\Program Files (x86)\Kofax\Power PDF\bin\PowerPDF.exe").

If you are debugging a managed connector, you also need to change the Debugger Type at the same place to Mixed or Managed only.