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'
Originally Published: 2018-03-21
Last Modified: 2023-12-01
Article Number
000041952
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.
 
Email content with %
 

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.
 
Character encoding
 

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

Related Articles

Trending Articles

Don't see what you're looking for?