IBM Support

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

Troubleshooting


Problem

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".

[{"Product":{"code":"SSZRWV","label":"IBM Datacap"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF033","label":"Windows"}],"Version":"8.1.0","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21700131