iOSSDK-DocuSign
commented
5 years ago Please ensure correct templateId is passed along with the tabData.
-- Other relevant details --
Variables such as ‘tabKey_address2’ are used to link tabs in template and apply the default value before kicking off the signing ceremony.
Line from swift sample:
static let tabKey_address2: String = "Text 526bf465-583e-426f-9671-04dadbb16dbc";
Tabs can be assigned a “Data Label” (tabLabel from API perspective).
For e.g. Text 526bf465-583e-426f-9671-04dadbb16dbc is the tabLabel (can be shared by multiple tabs).
Screenshot from DocuSign web with a template loaded and selected tab.
In order to pass a default value for a text-tab, you would need to identify the “Data Label” on the template and template-id, and use that string as the value.
tabData["Text 526bf465-583e-426f-9671-04dadbb16dbc"] = “221 Main St Dallas TX“
^ And this tabData defaults dictionary is used in sample app to invoke following:
// display template via sdk
TemplatesManager.sharedInstance.displayTemplateForSignature(templateId: templateId, controller: self, tabData: tabData, recipientData: recipientData, customFields:customFields, onlineSign: false, attachmentUrl: attachmentUrl)
{ (errMsg) in
// return to client screen
let vcIndex = self.navigationController?.viewControllers.index(where: { (viewController) -> Bool in
if let _ = viewController as? ClientViewController {
return true
}
return false
})
let clientVC = self.navigationController?.viewControllers[vcIndex!] as! ClientViewController
self.navigationController?.popToViewController(clientVC, animated: true)
}
Which in turn invokes sdk function to trigger the signing ceremony:
func displayTemplateForSignature(templateId: String, controller: UIViewController, tabData: Dictionary<String, String>, recipientData: Array<DSMRecipientDefault>, customFields:DSMCustomFields?, onlineSign: Bool, attachmentUrl: URL?, completionHandler: @escaping ((UIViewController?, Error?) -> Void))
{
// load PDF data
var pdfData: Data?
if (attachmentUrl != nil)
{
do {
pdfData = try Data(contentsOf: attachmentUrl!)
}
catch {
NSLog("Error loading PDF data")
}
}
let mDSMEnvelopeDefaults = DSMEnvelopeDefaults()
mDSMEnvelopeDefaults.recipientDefaults = recipientData.count > 0 ? recipientData : nil
mDSMEnvelopeDefaults.tabValueDefaults = tabData
mDSMEnvelopeDefaults.customFields = customFields
self.mDSMTemplatesManager?.presentSendTemplateControllerWithTemplate(withId: templateId, envelopeDefaults: mDSMEnvelopeDefaults, pdfToInsert: pdfData, insertAtPosition: DSMDocumentInsertAtPosition.end, signingMode: onlineSign ? DSMSigningMode.online : DSMSigningMode.offline, presenting: controller, animated: true, completion: completionHandler)
}
mjzandona
ashokds
pushp1010
I have followed the instructions to download the example app code, run the pod install, create template in developer sandbox, rename text box fields in Data Labels and use that name in the Swift code tabKey_* variables. After following all of the instructions, the app is successfully built and running on the simulator. However, all the text fields in the template show "Text" and not the data pre populated in the fields for Tom Woods.
I do see an error in the completionHandler in TemplatesManager.swift for the following call:
presentSendTemplateControllerWithTemplate
I'm wondering if this error is causing the SDK to not properly execute and fill the fields in the call.