Skip to main content

This content has been archived and is no longer being updated. Links may not function; however, this content may be relevant to outdated versions of the product.

Support Article

IllegalArgumentException: A blank handle has been specified



When configuring a case to be processed through an incoming email, the email attachments are not attached prior to the initialization of the first step in the case. As a result, the incoming email is not processed.

Error Messages

java.lang.IllegalArgumentException: A blank handle has been specified.

Steps to Reproduce

  1. Define a new case type to invoke an activity which performs an Obj-Open-by-Handle using the Primary.pyAttachments(1).pxLinkedRefTo.

  2. Run the Email wizard.
  3. Configure the case to be created upon receipt of an email.
  4. Send an email with an attachment, to the monitored inbox.
Additional Steps or Configuration details:

Use the Service wizard to create an email service rule. The rule is configured with the standard out-of-the-box pyCreateAndManageWorkFromEmail service activity which invokes the CreateWorkFromMail (standard) activity.

Step 5 in this activity creates the work object and a sub activity. The case is initialized by running the pyStartCase, which attempts to process the first step in the case.

Step 6 adds the attachment from the inbound email to the case. This occurs only after Step 5 has attempted to execute the first step in the case. This generates an error because the first step is an activity which processes attachments.

Root Cause

A defect or configuration issue in the operating environment.
The email was not attached to the case because an assignment in the flow was not added. Additionally, the resume flow step in the pyCreateAndManageWorkFromEmail failed because the lock was not held on the pyWorkPage.


Perform either of the following local-changes:
  1. Define TempCurrentPage of Work- in pages and classes.
  2. Update the pyCreateAndMangeWorkFromEmail to include an Obj-Refresh-And-Lock step on the pyWorkPage before the ResumeFlow step.

Alternatively, add a Wait shape with a 1 minute timer for the Flow.

Published April 4, 2019 - Updated December 2, 2021

Was this useful?

0% found this useful

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us