Cinchy Platform Documentation
Cinchy v5.0 - v5.5
Cinchy v5.0 - v5.5
  • Data Collaboration Overview
  • Other Wiki Spaces
    • Cinchy Data Sync
    • Angular SDK
    • JavaScript SQK
  • Release Notes
    • Release Notes
      • 5.0 Release Notes
      • 5.1 Release Notes
      • 5.2 Release Notes
      • 5.3 Release Notes
      • 5.4 Release Notes
      • 5.5 Release Notes
      • 5.6 Release Notes
  • Getting Help
  • Frequently Asked Questions
  • Deployment Guide
    • Deployment Installation Guides
      • Deployment Planning Overview and Checklist
        • Deployment Architecture Overview
          • Kubernetes Deployment Architecture
          • IIS Deployment Architecture
        • Deployment Prerequisites
          • Single Sign-On (SSO) Integration
            • Enabling TLS 1.2
            • Configuring ADFS
            • AD Group Integration
      • Kubernetes Deployment Installation
        • Disabling your Kubernetes Applications
        • Changing your File Storage Configuration
        • Using Self-Signed SSL Certs (Kubernetes Deployments)
        • Deploying the CLI (Kubernetes)
      • IIS Deployment Platform Installation
        • Deploying Connections and the CLI (IIS)
        • Deploying the Event Listener/Worker (IIS)
    • Upgrade Guides
      • Upgrading Cinchy Versions
        • Cinchy Upgrade Utility
        • Kubernetes Upgrades
          • v5.1 (Kubernetes)
          • v5.2 (Kubernetes)
          • v5.3 (Kubernetes)
          • v5.4 (Kubernetes)
          • v5.5 (Kubernetes)
          • v5.6 (Kubernetes)
          • Updating the Kubernetes Image Registry
          • Upgrading AWS EKS Kubernetes Version
          • Upgrading AKS (Azure Kubernetes Service)
        • 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)
      • Upgrading from v4 to v5
  • Guides for Using Cinchy
    • User Guides
      • Overview of the Data Browser
      • The Admin Panel
      • User Preferences
        • Personal Access Tokens
      • Table Features
      • Data Management
      • Queries
      • Version Management
        • Versioning Best Practices
      • Commentary
    • Builder Guides
      • Best Practices
      • Creating Tables
        • Attaching Files
        • Columns
        • Data Controls
          • Data Entitlements
          • Data Erasure
          • Data Compression
        • Restoring Tables, Columns, and Rows
        • Formatting Rules
        • Indexing and Partitioning
        • Linking Data
        • Table and Column GUIDs
        • System Tables
      • Saved Queries
      • CinchyDXD Utility
        • Building the Data Experience (CinchyDXD)
        • Packaging the Data Experience (CinchyDXD)
        • Installing the Data Experience (CinchyDXD)
        • Updating the Data Experience (CinchyDXD)
        • Repackaging the Data Experience (CinchyDXD)
        • Reinstalling the Data Experience (CinchyDXD)
      • Multi-Lingual Support
      • Integration Guides
    • Administrator Guide
    • Additional Guides
      • Monitoring and Logging on Kubernetes
        • Grafana
        • Opensearch Dashboards
          • Setting up Alerts
        • Monitoring via ArgoCD
      • Maintenance
      • GraphQL (Beta)
      • System Properties
      • Enable Data At Rest Encryption
      • MDQE
      • Application Experiences
        • Network Map
          • Custom Node Results
          • Custom Results in the Network Map
        • Setting Up Experiences
  • API Guide
    • API Overview
      • API Authentication
      • API Saved Queries
      • ExecuteCQL
      • Webhook Ingestion
  • CQL
    • The Basics of CQL
      • CQL Examples
      • CQL Functions Master List
      • CQL Statements Overview
        • Cinchy DML Statements
        • Cinchy DDL Statements
      • Cinchy Supported Functions
        • Cinchy Functions
        • Cinchy System Values
        • Cinchy User Defined Functions
          • 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
        • Mathematical 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
  • Meta Forms
    • Introduction to Meta-Forms
    • Meta-Forms Deployment Installation Guide
      • Deploying Meta-Forms (Kubernetes)
      • Deploying Meta-Forms (IIS)
    • Creating a Dynamic Meta-Form (Using Tables)
    • Creating a Dynamic Meta-Form Example (Using Form Designer)
    • Forms Data Types
    • Adding Links to a Form
    • Rich Text Editing in Forms
Powered by GitBook
On this page
  • Table of Contents
  • 1. Creating a Table from Scratch
  • 2. Creating a Table by Importing a CSV
  • 3. Table Views
  • From Scratch:
  • From Existing:
  • Updating a View
  • 4. Bookmarks and the Homepage

Was this helpful?

Export as PDF
  1. Guides for Using Cinchy
  2. Builder Guides

Creating Tables

This page guides you through creating table in Cinchy.

PreviousBest PracticesNextAttaching Files

Last updated 1 year ago

Was this helpful?

Table of Contents

Table of Contents

1. Creating a Table from Scratch

  1. Navigate to the Cinchy homepage. In the upper left-hand corner, click on Create to get started. (Image 1)

2. Select either a Standard or a Spatial Table (Image 2), per the descriptions below.

  • Spatial Table: A spatial table allows you to create geography and geometry column types, as well as geospatial indexes. You will not be able to create partitions on a spatial table.

  • Standard Table: You cannot create geography or geometry columns in a standard table.

You cannot convert from one type to another and will have to either recreate your table or link to another table with geospatial columns.

Any existing tables created before installing Cinchy Platform v4.19.0 are standard tables.

3. Select From Scratch (Image 3).

4. A new page will open with the Table Info tab (Image 4). Input the following information:

  • Table Name: This is a mandatory field, and must be unique to the domain you select.

  • Icon: You can pick an icon and colour to differentiate your table on thee home screen.

  • Domain: This is a mandatory field. Select the domain that this table will reside under. If you are have administrative privileges, you can also create new domains from this screen.

  • Description: You can give your table a description, which will be displayed on the homepage.

6. A new page will open with the Columns tab (Image 6). Every table in Cinchy must have at least one column. Input the following information:

  • Column Name: Input a unique column name.

  • Data Type: You can select from the following:

    • Text: All data in this column must be input as text

    • Number: All data in this column must be input numerically

    • Date: All data in this column must be in date format. The default is yyyy-mm-dd however you can change that.

    • Yes/No: All data in this column must be in Yes/No format

    • Choice: Data entered in this column must be selected from a set of choice answers that you provide

    • Link: Data in a link column is pulled from elsewhere on Cinchy

  • Description: Enter a description of your column

  • Data Security Classification: You can select from Public, Internal, Confidential, or Restricted. Additional options can be created in the [Cinchy].[Data Security Classifications] table by an Administrator.

    • Restricted: Restricted data is what we can call "high stakes". If compromised or accessed without authorization, it could lead to criminal charges, massive legal fines, or cause irreparable damage to the company. This is the most sensitive data, so you would have to treat it extra carefully. Examples include intellectual property, proprietary information or data protected by state and federal regulations.

    • Confidential: Often, access to confidential data requires additional authorization and explanation of why access to the data is needed. Examples of confidential data include social security numbers, credit card details, phone numbers or medical records. Depending on the industry, confidential data is protected by laws like GDPR, HIPAA, CASL and others.

    • Internal: This type of data is strictly accessible to internal company personnel or employees who are granted access. This might include internal-only memos, business performance, customer surveys or website analytics.

    • Public: This type of data is freely accessible to all employees and company personnel. It can be freely used, reused, and redistributed without repercussions. An example might be job descriptions, press releases or links to articles.

Currently there is no functionality tied directly to Data Security Classification - the tagging is just for internal auditing purposes. Future security settings will be tied to Data Security Classifications, rather than simply done at a column level.

You may have further mandatory or optional data to input depending on your selected Data Type.

8. Click Save to finalize your table.

9. You may return to change the structure of the existing table (i.e. Rename columns, add new columns, change data type) by clicking on the Design Table button on the left-hand navigation (Image 8).

2. Creating a Table by Importing a CSV

  1. Navigate to the Cinchy homepage. In the upper left-hand corner, click on Create to get started (Image 9).

2. Select either a Standard or a Spatial Table (Image 10), per the descriptions below.

  • Spatial Table: A spatial table allows you to create geography and geometry column types, as well as geospatial indexes. You will not be able to create partitions on a spatial table.

  • Standard Table: You cannot create geography or geometry columns in a standard table.

You cannot convert from one type to another and will have to either recreate your table or link to another table with geospatial columns.

Any existing tables created before installing Cinchy Platform v4.19.0 are standard tables.

3. Select Import a CSV (Image 11).

4. Enter the following information:

  • Domain: Select the domain that you table will reside under. If you are have administrative privileges, you can also create new domains from this screen.

  • File: In order to create the table, you must upload a .csv file.

The column names in your .csv file must not conflict with System Columns.

5. When creating a table via Import a CSV, a few settings will be set by default:

  • Default Table Name: The name of the file will be used as the name of the table (a number will be appended if there is a duplicate - ex. uploading Teams.csv will create a table named Teams 1, then Team 2 if uploaded again). You can always rename the table after it has been created.

  • Default Table Icon: The icon defaults to a green paintbrush.

  • Default Column Types: Columns by default will be created as a text field, with a maximum length of the longest value in the column. If a column has only numeric values in it, it will be created as a numeric column.

6. To update these settings, navigate to the Design Table tab on the left navigation bar (Image 12).

3. Table Views

  1. When you first create a table, a default view called All Data will be created for you, which you can find on the left navigation bar under Manage Data (Image 13).

2. You can create additional views by clicking on "+Create View" (Image 14).

3. You may chose to create a view From Scratch or by Copying an Existing view (Image 15).

From Scratch:

  1. Select "From Scratch".

  2. The Columns tab will open. Create a Name for your View (Image 16).

  3. If you'd like this to become the default view, toggle the default setting to On (Image 16).

4. Select the column(s) that you want to be visible in this view (Image 17). You may rearrange the column order using drag and drop.

5. Click on the Sort tab in the left navigation bar (Image 18).

6. Use this screen to select which columns you'd like to sort your data by, and in which order. You may rearrange the columns using drag and drop (Image 19).

8. Click on the Permission tab in the left navigation bar. Here, you may set permissions for who can use this view. By default, it is set to All Users (Image 21).

9. Select Save to finalize your view.

From Existing:

  1. Select "From Existing".

  2. Select which view you would like to copy (Image 22).

Updating a View

  1. To update any view, including the Add Data view, click on the pencil icon next to the view's name under Manage Data (Image 23).

4. Bookmarks and the Homepage

Once you create a table, it will be added to your bookmarks by default. Other users (or if you un-star the table from your bookmarks) will see it in the Homepage if they have permissions to.

5. When you are finished with the Info page, select Columns from the left-hand navigation bar (Image 5). for additional information about column types.

Calculated: Data is this column is calculated using a expression

Advanced Settings: Select any checkboxes that pertain to your column. for more information about these parameters.

7. Click on Design Controls > Entitlements in the left navigation pane to set your permissions (Image 7). You may set these as granular as you choose. You may also set permissions on a

7. Click on the Filter tab in the left navigation bar. Here, you may use to focus your view (Image 20).

See here
CQL
Watch the Cinchy TV episode on Data Types here.
query language
See here for more about data controls and entitlements.
view by view basis.
1. Creating a Table from Scratch
2. Creating a Table by Importing a CSV
3. Table Views
From Scratch:
Image 1: Step 1, Getting Started
Image 2: Step 2, select either a Standard or Spatial Table
Image 3: Step 3, Select "From Scratch"
Image 4: Step 4, Adding table info.
Image 5: Step 5, Selecting the Columns tab
Image 6: Step 6, defining your column
Image 7: Step 7, setting your permissions
Image 8: Step 9, changing an existing table structure
Image 9: Step 1, Getting Started
Image 10: Step 2, select either a Standard or Spatial Table
Image 11: Step 3, Select "Import a CSV"
Image 12: Step 6, Design Table tab
Image 13: Step 1: The All Data view
Image 14: Step 2, Select "Create View"
Image 15: Step 3, Creating a View
Image 16: Steps 2,3
Image 17: Step 4, Selecting Columns
Image 18: Step 5, Sorting
Image 19: Step 6, Sorting your view
Image 20: Step 7, Using the Filter tab
Image 21: Step 8, setting permissions.
Image 22: Step 2, Importing a view
Image 23: Step 1, Updating a View
See here