IBM Support

Single sign-on using Taskmaster Web in IBM Datacap Taskmaster Capture using an aspx page

Question & Answer


Question

How to use automated or single sign-on and page redirection with Taskmaster Web in IBM Datacap Taskmaster Capture using a non-static aspx page

Cause

The Technote Single sign-on using Taskmaster Web in IBM Datacap Taskmaster Capture describes how to create a static html page to enable Single sign-on (SSO), however, attempting to do the same thing from an .aspx page, in order to leverage scripting, requires some additional considerations.

Answer

Any .aspx page that is loaded in the tmweb.net directory will trigger the Global_PreRequestHandlerExecute function in the global.asax file (this is pre-compiled into a DLL and cannot be changed).

This function will first check to see if the current session is logged on yet or not, which will not be true, and then it will check to see if the request came from one of four specific pages: default.aspx, ietest.aspx, utility.asmx or error.aspx.

If the request did not come from one of those four pages, the user will be immediately redirected to the default.aspx page.

To avoid being redirected, the custom logon page must contain default.aspx or ietest.aspx in the title. For instance, if the page is named SSOdefault.aspx or Mydefault.aspx, then you will not be re-directed to the logon page.

Also, in order to prevent viewstate errors, be sure not to include the runat=server declaration in the form tag.

Sample SSOdefault.aspx page:

<%@ Page Title="" Language="C#"%>
<html>
<body>
<script runat="server">
</script>

<form id="frm1" method="post" action="~/default.aspx">
<input type="hidden" id="hdApp" name="hdApp" runat="server" value="APT" />
<input type="hidden" id="hdFuid" name="hdFuid" runat="server" value="admin" />
<input type="hidden" id="hdPwd" name="hdPwd" runat="server" value="admin" />
<input type="hidden" id="hdStn" name="hdStn" value="1"/>
<input type="hidden" id="hdRedir" name="hdRedir" value="jmonitor.aspx"/>
<input type="submit" name="Logon" id="sbmt" runat="server" />
</form>
</body>
</html>

[{"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;8.0.1","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
09 March 2021

UID

swg21638536