FA Integrations

Features

• Form Convert: takes in a post request as http form-data and makes a post request to a given url as application/json. Built as part of a custom integration between Form Assembly's http post connector and O365 Power automate Post trigger.
• Form Adapter: takes a post request with a defined Json schema and resubmits the form to a FA form. Allows programatic form submission.

Form Convert

A simple NestJs Rest API with a single controller that takes in a post request as http form-data and makes a post request to a given url as application/json. Built as part of a custom integration between Form Assembly's http post connector and O365 Power automate Post trigger.

Setting the repost url

The env variables in the .env file belong to a specific Power Automate Post trigger url. Example: REPOST_TO_TRIGGER_URL_<UNIQUE_NAME>.

Each variable name part should be unique. The name part gets passed with the form submission form-convert.controller.ts

@Post()
  async post(@Body() submission: any): Promise<any> {
    console.log(submission);
    if (!!!submission.triggerUrlId) {
      return new InternalServerErrorException('triggerUrlId is required');
    }
    const triggerUrl = this.configs.get(
      `REPOST_TO_TRIGGER_URL_${submission.triggerUrlId ?? 'BAB'}`,
    );

    // check for correct url pattern
    const validateDynamicTriggerUrl = triggerUrl
      .toString()
      .includes('.azure.com:443');

    if (!validateDynamicTriggerUrl) {
      return new BadRequestException('trigger url invalid');
    }

    Logger.log('request url', triggerUrl);
    Logger.log('payload', JSON.stringify(submission));
    const response = await this.http
      .post(triggerUrl, submission, {
        headers: {
          'Content-Type': 'application/json',
        },
      })
      .toPromise();
  }

---

Form Adapter

Takes a post request with an application/json body payload:

[
	{
		"field": "tfa_1",
		"value": "field value for tfa_1"
	},
	{
		"field": "tfa_3",
		"value": "100"
	},
	{
		"field": "tfa_5",
		"value": "field value for tfa_5"
	}
]

The field properties are found in your form html. All other required dynamic fields will be automatically filled in by this integration and included with the outgoing post request to your form.