feat: Configurable question tags

[dsamojlenko]

Summary | Résumé

#4378 "Machine readable tags or IDs":

• Adds a tag property to the form schema (under properties)
• Defaults this tag to a UUID when adding a new form element in the form-builder
• Adds a configuration component in MoreDialog to configure the tag name
• Modifies transformFormResponses to support tagged responses
• Adds test coverage for tagged responses

About tagged responses

A tagged response has the following structure:

{
  tag: "...",
  answer: [string]
}

The answer string can sometimes be a serialized object - in the cases of FormattedDate and AddressComplete, they will be serialized JSON. Checkboxes also render as a serialized object/array of values.

When responses are downloaded as HTML or CSV they pass through the fetchSubmissions server action, where the response will be extracted and returned without the tag.

When responses are downloaded from the API, they will be returned following the object structure above.

If a form was created before this feature rolls out, but modified after- pre-existing inputs will not have tags, any newly added inputs will have tags. Tags can be added to pre-existing inputs by opening the MoreDialog, editing the tag, and saving.

If a form has a mix of tagged and untagged inputs, the responses to that form will have mixed tagged/untagged responses.

[github-actions]

🧪 Review environment

https://obytdidilnzksu3rs764gwacne0kjhov.lambda-url.ca-central-1.on.aws/

[github-actions]

🧪 Review environment

https://q27nmmlfkmheb4cme7spqbyn2y0jfxna.lambda-url.ca-central-1.on.aws/

[timarney]

Need a proper description here

[timarney]

Need proper i18n here

[timarney]

Tested --- working well

Updated my API test app to use

const getAnswerByTag = (answersObj, tag) => {
  const answers = Object.entries(answersObj );
  const entry = answers.find(([_, value]) => value.tag === tag);
  return entry ? entry[1].answer : null;
};

---

const answers = JSON.parse(formSubmission.answers);
const email = getAnswerByTag(answers, "email");

Note

👉 Any existing partner integrations that aren't published would need to be update to pull from .answer prop on the response.