Applying layouts adds new placeholder recipient

0 votes



I'm having trouble with the functionality behind saving/applying layouts in the integrated designer iframe.

Here is the flow of what is happening:

1. The REST API is used to creaete a package with one recipient that has role/id "test"

2. A user drags a signature for the "test" recipient onto the document using the designer iframe

3. The user saves this layout as "L1"

4. A second package is created with no recipients

5. The user applies the layout "L1"

6. Here is where the problem occurs. When the layout is applied, Onespan creates a new placeholder recipient with role "test", and adds in the signature for this recipient into the document. 

For our case, it makes much more sense to ignore the "test" signature and recipient since that recipient isn't already in the package. I was wondering if there is a setting to change the "Apply Layout" functionality to work like this?

In addition, it seems that I cannot send this package for signing once the new placeholder recipient gets added to the document. I receive the following error:
{"messageKey":"error.validation.packageActivation.unassignedRole","message":"There is a role with no signer.","code":400,"name":"Validation Error"}



Approved Answer

Reply to: Applying layouts adds new placeholder recipient

0 votes

Hi Riccardo,


Thanks for your post and background information!

Unfortunately "Apply Layout" will always add recipients/placeholders who have signatures even though they are not yet added to the current transaction. And I doubt there's a way to modify its functionality.

Another thing to notice is that you can't delete recipients/placeholders in designer page directly.

Just wondering if your use case is ad-hoc or integrated? If UI only, you have to navigate back to the transaction detail page, delete the placeholder from the signer list, then send the transaction. If integrated, loop through the recipient list and delete placeholder signers (whose "signers" node is an empty array) before you send the transaction.




Duo Liang OneSpan Evangelism and Partner Integrations Developer

Reply to: Applying layouts adds new placeholder recipient

0 votes

Hey Duo,

Yes I have done an integration.

I think the best way to move forward would be to hide the save/apply layout buttons from the designer, and create my own buttons which automatically delete placeholders after the layout is applied.


Hello! Looks like you're enjoying the discussion, but haven't signed up for an account.

When you create an account, we remember exactly what you've read, so you always come right back where you left off