5️⃣
Cinchy Platform Documentation
Cinchy v5.8
Cinchy v5.8
  • Data Collaboration Overview
  • Release notes
    • Release notes
      • 5.9 release notes
      • 5.8 Release Notes
      • 5.7 Release Notes
      • 5.6 Release Notes
      • 5.5 Release Notes
      • 5.4 Release Notes
      • 5.3 Release Notes
      • 5.2 Release Notes
      • 5.1 Release Notes
      • 5.0 Release Notes
  • Support
  • Glossary
  • FAQ
  • Deployment guide
    • Deploying Cinchy
      • Plan your deployment
        • Deployment architecture
          • Kubernetes architecture
          • IIS architecture
        • Deployment prerequisites
          • Single Sign-On (SSO) integration
            • Enable TLS 1.2
            • Configure ADFS
            • AD Group Integration
      • Kubernetes
        • Disable your Kubernetes applications
        • Change your file storage configuration
        • Configure AWS IAM for Connections
        • Use Self-Signed SSL Certs (Kubernetes)
        • Deploy the CLI (Kubernetes)
      • IIS
  • Upgrade guide
    • Upgrade Cinchy
      • Cinchy Upgrade Utility
      • Kubernetes upgrades
        • v5.1 (Kubernetes)
        • v5.2 (Kubernetes)
        • v5.3 (Kubernetes)
        • v5.4 (Kubernetes)
        • v5.5 (Kubernetes)
        • v5.6 (Kubernetes)
        • v5.7 (Kubernetes)
        • v5.8 (Kubernetes)
        • Upgrade AWS EKS Kubernetes version
        • Update the Kubernetes Image Registry
        • Upgrade Azure Kubernetes Service (AKS)
      • IIS upgrades
        • v4.21 (IIS)
        • v4.x to v5.x (IIS)
        • v5.1 (IIS)
        • v5.2 (IIS)
        • v5.3 (IIS)
        • v5.4 (IIS)
        • v5.5 (IIS)
        • v5.6 (IIS)
        • v5.7 (IIS)
        • v5.8 (IIS)
      • Upgrading from v4 to v5
  • Guides for using Cinchy
    • User Guide
      • Data Browser overview
      • The Admin panel
      • User preferences
        • Personal access tokens
      • Table features
      • Data management
      • Queries
      • Version management
        • Versioning best practices
      • Commentary
    • Builder Guide
      • Best practices
      • Create tables
        • Attach files
        • Columns
        • Data controls
          • Data entitlements
          • Data erasure
          • Data compression
        • Formatting rules
        • Indexing & partitioning
        • Linking data
        • Table and column GUIDs
        • System tables
      • Delete tables
        • Restore tables, columns, and rows
      • Saved queries
      • CinchyDXD
        • Overview
        • DXD workflow
        • Package the data experience
        • Install the data experience
        • Release package
        • Changelog
        • References
          • Cinchy DXD CLI reference
          • Data Experience Definitions table
          • Data Experience Reference table
      • Multilingual support
      • Integration guides
    • Administrator Guide
    • Additional guides
      • Monitor and Log on Kubernetes
        • Grafana
        • OpenSearch dashboards
          • Set up Alerts
        • Monitor via ArgoCD
      • Maintenance
      • Cinchy Secrets Manager
      • GraphQL (Beta)
      • System properties
      • Enable Data At Rest Encryption (DARE)
      • Application experiences
        • Network map
          • Custom node results
          • Custom results in the Network Map
        • Set up experiences
  • API Guide
    • API overview
      • API authentication
      • API saved queries
      • ExecuteCQL
      • Webhook ingestion
  • CQL
    • Overview
      • CQL examples
      • CQL statements overview
        • Cinchy DML statements
        • Cinchy DDL statements
      • Cinchy supported functions
        • Cinchy functions
        • Cinchy system values
        • Cinchy User Defined Functions (UDFs)
          • Table-valued functions
          • Scalar-valued functions
        • Conversion functions
        • Date and Time types and functions
          • Return System Date and Time values
          • Return Date and Time parts
          • Return Date and Time values from their parts
          • Return Date and Time difference values
          • Modify Date and Time values
          • Validate Date and Time values
        • Logical functions
        • Math functions
        • String functions
        • Geometry and Geography data type and functions
          • OGC methods on Geometry & Geography instances
          • Extended methods on Geometry & Geography instances
        • Full Text Search functions
        • Connections functions
        • JSON functions
    • CQL functions reference list
  • Meta-Forms
    • Introduction
    • Install Meta-Forms
      • Deploy Meta-Forms (Kubernetes)
      • Deploy Meta-Forms (IIS)
    • Forms data types
    • Meta-Forms Builder Guide
      • Create a dynamic meta-form with tables
      • Create a dynamic meta-form example with Form Designer
      • Add links to a form
      • Rich text editing in forms
  • Data syncs
    • Get started with data syncs
    • IIS installation
      • Install Connections
      • Install the Worker/Listener
      • Install the Connections CLI
    • Build data syncs
      • Data sync types
      • Design patterns
      • Sync actions
      • Columns and mappings
        • Calculated column examples
      • Advanced settings
        • Filters
        • Variables
        • Auth requests
        • Request headers
        • Post sync scripts
        • Pagination
      • Batch data sync example
      • Real-time sync example
      • Schedule a data sync
      • Connection functions
    • Data sync sources
      • Cinchy Event Broker/CDC
        • Cinchy Event Broker/CDC XML config example
      • Cinchy Table
        • Cinchy Table XML config example
      • Cinchy Query
        • Cinchy Query XML config example
      • Copper
      • DB2 (query and table)
      • Dynamics 2015
      • Dynamics
      • DynamoDB
      • File-based sources
        • Binary file
        • Delimited file
        • Excel
        • Fixed width file
        • Parquet
      • Kafka Topic
        • Kafka Topic example config
        • Apache AVRO data format
      • LDAP
      • MongoDB collection
        • MongoDB collection source example
      • Mongo event
      • MongoDB collection (Cinchy event)
      • MS SQL Server (query and table)
      • ODBC Query
      • Oracle (query and table)
      • Polling event
        • Polling event example config
      • REST API
      • REST API (Cinchy event)
      • SAP SuccessFactors
      • Salesforce Object (Bulk API)
      • Salesforce platform event
      • Salesforce push topic
      • Snowflake
        • Snowflake source example config
      • SOAP 1.2 web service
      • SOAP 1.2 web service (Cinchy Event Triggered)
    • Data sync destinations
      • Cinchy Table
      • DB2 table
      • Dynamics
      • Kafka Topic
      • MongoDB collection
      • MS SQL Server table
      • Oracle table
      • REST API
      • Salesforce
      • Snowflake table
      • SOAP 1.2 web service
    • Real-time sync stream sources
      • The Listener Config table
      • Cinchy Event Broker/CDC
      • Data Polling
      • Kafka Topic
      • MongoDB
      • Salesforce Push Topic
      • Salesforce Platform Event
    • CLI commands list
    • Troubleshooting
  • Other Resources
    • Angular SDK
    • JavaScript SQK
Powered by GitBook
On this page
  • Overview
  • Prerequisites
  • Create your Form
  • Set up the Form sections
  • Set up the Form fields
  • Test the Form
  • Create new records
  • Add the Form to the home page
  1. Meta-Forms
  2. Meta-Forms Builder Guide

Create a dynamic meta-form with tables

PreviousMeta-Forms Builder GuideNextCreate a dynamic meta-form example with Form Designer

Last updated 1 year ago

Overview

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

Prerequisites

  • Before creating a form, you must have the ​

  • You must also have

Create your Form

This example uses a form to pull information about contacts from specific table and display it 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
  1. 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. This example uses the Contacts table.

  • Name: This will be the name of your form. This example uses Contacts Form (Example Test).

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

  • Brand: Select a branding colour. This example uses light green.

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

  • Lookup Label: This option will select how you pull information from your assigned table. This example selects the Contacts.People.Name column from the Contacts table, to pull information based on a contact name.

  • Owner Groups: Select which groups have ownership of the form. This example uses the Product Success group.

  • User Groups: Select which user groups have access to the form. This example uses 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.

Set up the 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. This example creates a 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).

  1. 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: Use this section to dictate the order in which your sections appear on your form, with 1 appearing first.

  • Name: Enter the name of your field. This example has 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. This example uses 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.

Set up the 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).

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

  • Form Section: Populate this column with the fields that you created in step 2 (Profile, Contact Info, and Company). You must populate Contact Info and Company in two separate columns as this example uses 2 as the value for the "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's 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.

Test the 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).

Create 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.

Add the Form to the home page

  1. To add your form as an applet that users can 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.

Image 2: Filling out the form table
Image 2: Continued
Image 3: Navigate to the Form Sections table
Image 4: Filling out the Form Sections Table
Image 5: Form Fields table
Image 6: Populate your form fields
Image 7: Testing your form
Image 8: Creating a new record
CLI package set up in your environment
installed and configured the Meta-Forms experience​