IBM Support

Custom Code Is Unable to Decrypt Encrypted Strings in IBM Datacap Taskmaster Capture

Technote (troubleshooting)


Problem(Abstract)

Custom actions cannot decrypt built-in Taskmaster secure values from the .app file, like database connection strings, passwords, or Advanced Values. For example, MetaWord, when called on @APPVAR(*/lookupdb:cs) returns the secured string [secured]011da7544c0b852139730dd582683b8c82a80466dfcd817[/secured]. Custom actions cannot decrypt the secured string.

Cause

The .NET action template provides access to the dcSmart object. One of the methods available in this class is MetaWord. MetaWord takes a string as a parameter and returns a string. MetaWord allows your custom actions to accept smart parameters. Passing a parameter string to MetaWord resolves any smart parameters in your input string. It also returns the result that can be processed by your C# code. If the input parameter does not contain any smart parameters, it returns the original input string.

Resolving the problem

  1. Open up Taskmaster Application Manager.
  2. Copy <application>.app.lock file to desktop.
  3. Close Taskmaster Application Manager.
  4. Move <application>.app.lock to c:\Datacap\<application>\
  5. Edit c:\Datacap\<application>\<application>.app
    Change custom encrypted strings to plain text values.
  6. Save.
  7. Close file.
  8. Modify <application>.app and <application>.app.lock to only allow modify for Datacap administrators; verify other users and service accounts have only "Read & execute" and "Read".

Document information

More support for: Datacap

Software version: 8.1.0

Operating system(s): Windows

Reference #: 1700131

Modified date: 07 December 2016