Form Field Mapping

Key

Precursors

• Fetched map, stored as formMap

  Type	Key	Value	Key Example	Value Example
  Text	Tab Label	Form field ID	Text2	question_3qe0r5
  Checkbox	Tab Label	Option ID (field key)	Check Box29	question_meGQQl_ef9b807f-08ea-47fd-8ced-3797a1f83a2e
  Radio	Group Name + index position	Option ID	Check Box1-1	2197d4a8-355e-44e0-8da6-06ef5b170826

  <aside> 📝 The DocuSign form field’s structure determines the format of the key because the value needs to be mapped to the tab.

  The Tally form field’s structure determines the format of the value because the value needs to be fetched from the form submission content.

  </aside>

• Stored form fields as formFieldValues

  Type	Key	Value	Key Example	Value Example
  All	key	value	question_3qe0r5	Alex

• Fetched template tabs, if creating a new envelope or fetched recipient tabs, if updating an envelope, as tabGroups

Processing

• Loop through tabGroups e.g. textTabs

  • Get the name of the group, stored as type
  • Loop through the group’s tabs
    • Check whether the tab has a tab label (text and checkbox tabs will, radio buttons won’t)

      • Get tab label, stored as label

      • Sample label: Text2

        Text & Checkbox tabs

        • Check whether label is included in the formMap
          • Get form field key from map, stored as key
          • Sample text: question_3qe0r5
            • Check whether key is included in formFieldValues
              • Get value from form fields, stored as value
              • Sample text: Alex
                • Create tab and add to array

        Radio Button tabs

        • Get name of group, stored as groupName
          • Create tab and add to array

• Add array to tabs