Article Details

Id:	15686
Product:	finPOWER Connect
Type:	NEW
Version:	3.01.08
Opened:	17/07/2018
Closed:	12/11/2018
Released:	13/12/2018
Job:	J021020

Breaking Change

Electronic Signatures; add support for Secured Signing "Packages"

Added support for Secured Signing "Packages", i.e. Electronic Signatures with multiple Documents.

Previously Secured Signing "SmartTagSend" requests limited the number of Documents to 1. This has been updated to allow any number of Documents, and now uses the Secured Signed "SmartTagSend2" API which supports Packages.

Here is sample code to add a Secured Signing package of 3 documents to an Account.

Dim AccountLog As finAccountLog
Dim Request As ISElectronicSignatureRequest_SecuredSigning_SmartTagSendEx

Request = finBL.ElectronicSignature.Service_SecuredSigning.CreateRequest_SmartTagSendEx()
With Request
  .PackageName = "[PackageName]"

  .Documents.Add("[Document-FileName1]")
  .Documents.Add("[Document-FileName2]")
  .Documents.Add("[Document-FileName3]")
End With

' Create Associated Log
AccountLog = finBL.CreateAccountLog()
With AccountLog
  .AccountId = "[AccountId]"
  .Subject = "[LogSubject]"

  Success = .Save
End With

' Send Electronic Signature
If Success Then
  Success = finBL.ElectronicSignature.ExecuteSendAccountLog(Request, AccountLog.Pk, Nothing)
End If

Note, there is a new "PackageStatus" request object that can be used to import existing Secured Signing Packages. The following code snippet illustrates how to use:

Dim RequestPackageStatus As ISElectronicSignatureRequest_SecuredSigning_PackageStatus

RequestPackageStatus = finBL.ElectronicSignature.Service_SecuredSigning.CreateRequest_PackageStatus

With RequestPackageStatus
  .CreateFromExternal = True
  .PackageReference = "[ExternallyCreatedPackageReference]"
End With

Success = finBL.ElectronicSignature.Service_SecuredSigning.ExecutePackageStatus(RequestPackageStatus, Nothing)