Using the Function CaptureAttachment

Metastorm

 

The information in this article applies to:

Product: Metastorm BPM
Version: 7.x

Issue

• When trying to open an attachment that has been added to a clip using %CaptureAttachment, a user observes one of the following:

  1. The file does not open.
  2. The file opens but it contains unintelligible characters.
  3. The file opens but it contains the following error message:
     Unspecified error in URL: ereadattachment.ashx
     Invalid length for a Base-64 char array.

Resolution

• As stated in the Designer User Manual for the function %CaptureAttachment, the attachment data that is passed in must be base64-encoded. For example, the following would write the string "Hello, world" to the file test.txt and attach it to Clip1: %Clip1:= %CaptureAttachment(%folderID, "test.txt", "SGVsbG8sIHdvcmxk")

• NOTE: In Metastorm BPM version 7 SR1 (7.0.1), %CaptureAttachment was incorrectly changed to encode incoming attachment data. This was resolved in release 7.5. A migration utility and readme file are attached for customers who have used %CaptureAttachment in version 7 SR1 and need to migrate their attachments to resolve the problem.