Creating a Dynamic Meta-Form (Using Tables)

1. Overview

In this example, we will create a form that pulls specific information from a customer contacts table that a user is looking for.

2. Prerequisites

• Before creating a form, you must have the CLI package set up in your environment​

• You must also have installed and configured the Meta-Forms experience​

3. Creating your Form

In this example, we are using a form to pull information about contacts from specific table, to display in the forms experience.You can also use a form to push data to a connected table. See: Step 5, Creating New Records.

1. Navigate to the Forms table by searching for "Forms" on the homepage (Image 1).

Image 1: Navigate to the Forms table

2. Fill out the following sections of a new row (Image 2):

• Table: For a pull request, this will be whichever table you want to be receiving information from. In this example, we have used the Contacts table.

• Name: This will be the name of your form. In this example, we have used Contacts Form (Example Test).

• Display Name: You may enter an alternative display name if you wish

• Brand: Select a branding colour. In this example we have selected light green.

• Is Accordion: Select whether you want your form to appear in accordion format or not.

• Lookup Label: This option will designate how you pull information from your assigned table. We have designated the Contacts.People.Name column from the Contacts table, in order to pull information based on a contact name.

• Owner Groups: Select which groups have ownership of the form. In this example we have used the Product Success group.

• User Groups: Select which user groups have access to the form. In this example we have used the Product Success group.

• Bookmarked Users: If you want this form to appear in your "My Forms" view on the Forms table, enter it here.

Image 2: Filling out the form table

Image 2: Continued

4. Setting Up Your Form Sections

The next step is to set up your various form sections. These act as the headers of the form, and help organize your information.In this example we will create section to pull information from the Profile, Contact Info, and Company sections of the Contacts table.

1. Navigate to the Form Sections table by searching for Form Sections on the homepage (Image 3).

Image 3: Navigate to the Form Sections table

2. You will fill out a new row for each form section you want, filling out the following (Image 4):

• Form: From the drop down, select the name of the form that you just created. In this example, that would be Contacts Form (Example Test).

• Sequence: This section can be used to dictate the order in which your sections appear on your form, with 1 appearing first.

• Name: Enter the name of your field. In this example, we are entering Profile for the first row, Contact Info for the second, and Company for the third form section row.

• Columns in Row: Enter in how many columns you want to appear for this section. In this example we have chosen 1 column for the Profile section, and 2 each for Contact Info and Company.

• Auto Expand: Check this box if you want your sections to auto expand when someone opens the form.

Image 4: Filling out the Form Sections Table

5. Setting Up Your Form Fields

The final step of form creation is to populate the Form Fields section.

1. Navigate to the Form Fields table by searching for Form Fields on the homepage (Image 5).

Image 5: Form Fields table

​​2. Populate the following sections (Image 6):

• Form Section: Populate this column with the fields that you created in step 2 of "Form Sections". For example, here we will populate five columns, Profile, Contact Info, and Company. Note that we populate Contact Info and Company twice in two separate columns since we inserted "2" as the value for our "Columns in Row" variable in step 2.

• Sequence Override: You may input an override to the sequence order here if you desire.

• Tale Column: This is where we link to the column that is storing the information we seek. In this example, we link to the Customer Contacts table, and specifically to the section for Name, Email, Work Phone, Company, and Website.

Image 6: Populate your form fields

6. Test Your Form

1. You can open your form by clicking on your Form Name > Open.

2. To populate our example form, select a record from "Select Existing Record". The information will automatically populate in your form fields (Image 7).

Image 7: Testing your form

7. Creating New Records

Your form can both pull information from an existing table and push information to that same table.

1. On the left-hand navigation pane, click on Create New Record (Image 8). The information that you populate and save into the form here will automatically be reflected on the connected table.

Image 8: Creating a new record

8. Adding Your Form to the Homepage

1. To add your form as an applet that users can quickly bookmark and access, navigate to the Cinchy Applets table.

2. In a new row, fill out the following information:

• Domain: The domain that your form sits in.

• Name: The name of your form/applet. In this example we use "Contacts Form (Example Test)".

• Icon: Select an icon for the widget.

• Icon Colour

• Description: Add a description for your applet.

• Target Window: Select if you want you form to open in a new window or not.

• Application URL: Add in the URL to your form here.

• Users and Groups: Add in which users/groups can access your form in these columns.