After patching to RSA Identity Governance & Lifecycle 7.0.2 P03+, emails are not generated and sent due to the error 'Illegal hex characters in escape (%) pattern'

[#1]

Article Number

000036165

Applies To

RSA Product Set: RSA Identity Governance & Lifecycle
RSA Version/Condition: 7.0.2 P03+, 7.1.0
 

Issue

Prior to RSA Identity Governance & Lifecycle 7.0.2 P03, emails with % on their email content were being generated and sent.
 

Image description
 

After patching to RSA Identity Governance & Lifecycle 7.0.2 P03 or higher patch versions, emails are neither generated nor sent, due to the following error: 

Illegal hex characters in escape (%) pattern

 

You will find the error below in the aveksaServer.log, which can be downloaded by navigating to Admin > System > Server Nodes > aveksaServer.log :

03/12/2018 17:01:11.643 ERROR (Worker_actionq#Script Queue - Normal#WPDS_7057) [com.aveksa.server.workflow.scripts.nodes.SendEmailThread] Couldn't Send Email to due to: 
java.lang.IllegalArgumentException: URLDecoder: Illegal hex characters in escape (%) pattern - For input string: "; " 
at java.net.URLDecoder.decode(URLDecoder.java:192) 
at com.aveksa.server.workflow.scripts.nodes.SendEmailThread.getBody(SendEmailThread.java:109) 
at com.aveksa.server.workflow.scripts.nodes.SendEmailThread.sendEmail(SendEmailThread.java:146) 
at com.aveksa.server.workflow.scripts.nodes.SendEmailThread.sendEmail(SendEmailThread.java:66) 
at com.aveksa.server.workflow.scripts.nodes.SendEmailNode.nodeAvailableAsynchronous(SendEmailNode.java:34) 
at com.aveksa.server.workflow.scripts.nodes.WorkflowNodeHandler.nodeAvailableAsynchronous(WorkflowNodeHandler.java:52

Cause

The emails are neither generated nor sent if the email content has a percent sign (%). This occurs when the message content was not encoded and saved for the Send Email node. 
 

Resolution

Resolved in RSA Identity Governance & Lifecycle 7.0.2 P07+ and 7.1.0 P01.

If you're using ONLY email nodes in the workflows, you may apply 7.0.2 P07. If you're using approval, etc. with email in the workflows, apply 7.0.2 P08, as it contains fixes for all other nodes.

Workaround

The workaround is to either:

• Replace the % character with %25, or
• Remove the percent sugn completely in the email content of the Send Email node.

You will find email will send sent correctly and there will be no errors in the logs.
 

Image description
 

Note that this workaround only affects change requests created after the edit to the workflows is made.  Existing change requests are not corrected.