Custom Forms & Application Workflows
Menu Path: Communication > Custom Forms
The Custom Forms module is a comprehensive form-building and application-processing engine. Beyond basic surveys and feedback collection, it serves as the operational gateway for Vendor Onboarding, Brand Registration, and Organization Applications.
1. Defining Form Purpose & Actions
When creating a new form, select its functional Purpose:
- Standard / General (
STANDARD): Ideal for customer feedback, contact inquiries, and lead generation. - Merchant Onboarding (
MERCHANT_APPLICATION): Enables prospective vendors to apply for storefront seller accounts. Upon approval, automatically creates aMerchantrecord, binds the applicant user, and triggersMERCHANT_ONBOARDING_SETUP. - Brand Registration (
BRAND_APPLICATION): Collects trademark and manufacturer data. Upon approval, automatically provisions theBrandand triggersBRAND_SETUP. - Organization Application (
ORGANIZATION_APPLICATION): Designed for cooperative, chamber, and association applications, provisioning anOrganizationupon approval. - Survey / Research (
SURVEY): Tracks submission metrics, response frequencies, and conversion statistics.
2. Dynamic Field Builder & Smart Attribute Mapping
Build your form schema by adding dynamic input fields:
- Standard Inputs: Single-line text, number, email, phone, textarea, date picker, file upload.
- Option Selectors: Dropdown select, radio buttons, multi-select checkboxes.
- Nested Groups (
OBJECT): Group related fields into reusable sub-objects (e.g., Authorized Representative, Company Address).
Smart Entity Attribute Mapping (mappedAttributeId)
When a form purpose is linked to an entity (e.g., MERCHANT_APPLICATION), each form field can be mapped directly to an existing attribute from the Common Attribute catalog.
- Selecting an attribute automatically binds its slug and data type.
- When the application is approved, responses for mapped fields automatically transfer into the entity's normalized EAV
attributesarray.
3. Submissions & Application Review Workspace
Submissions do not simply generate emails; they enter a structured review pipeline:
- Submission Queue: View incoming entries filtered by state (
PENDING,UNDER_REVIEW,APPROVED,REJECTED,CANCELLED). - 2-Column Review Workspace:
- Left Column: Displays all submitted answers, structured sections, file downloads, and mapped attribute previews.
- Right Column: Contains the submission lifecycle status changer, internal team comments, and immutable audit logs.
- One-Click Approval:
- Approving an application triggers the automated entity creation engine.
- The new entity (Merchant, Brand, or Organization) is immediately created, the applicant's role is updated, and onboarding setup tasks are assigned.
- Data Export: Export submission logs and responses to CSV or Excel for compliance audits.