Creating your first query
Follow these instructions to create a new query within Cinchy.

1. Creating a Saved Query

  1. 1.
    From the homepage, select Create > Query (Image 1).
Image 1: Step 1, Click Create
2. Fill out the following information:

1.1 The Info Tab

Under the Info tab, you can fill out information on the query if you wish to save it (Image 2):
Image 2: The Info Tab
  • Query Name: ‌Mandatory field. Must be unique within the Domain.‌
  • Icon: ‌You can optionally pick a non-default icon, as well as color for your table. This will be displayed in My Network.
  • Domain: ‌You need to select a Domain your query will reside in. As an admin, you can also create new domains in this screen.
  • Description: ‌You can give your query a description. This description will be displayed on the home screen to users browsing the marketplace. It will also be searchable.
  • Return Type: There are six different return types:
    • Query Results (Approved Data Only)

      This is the default return type, it returns a table from a select query with only approved data for Maker/Checker-enabled tables, or all data for tables without Maker/Checker-enabled. This is generally used for external APIs as you will want to query approved data, rather than drafts.
    • Query Results (Including Draft Data)
      This return type returns a table from a select query with only draft data for Maker/Checker-enabled tables. Use this return type when looking to display results of records that are pending approval.
    • Query Results (Including Version History)
      This return type returns a table from a select query with historical data for all tables, as seen in the Collaboration Log of any record. This data includes all changes that happened to all records within the scope of the select query.
    • Number of Rows Affected
      This return type returns a single string response with the number of rows affected if the last statement in the query is an INSERT, UPDATE, or DELETE statement.
    • Execute DDL Script
      Use this return type when your query contains DDL commands that implement schema changes such as CREATE|ALTER|DROP TABLE, CREATE|ALTER|DROP VIEW, or CREATE|DROP INDEX.
    • Single Value (First Column of First Row)
      This return type returns a result of 1 row x 1 column, irrespective of the underlying result set.

1.2 The Query Tab

In the Query screen, you can modify and run your query.
On the left hand side you have the Object tree, which shows you all the domains, tables, and columns you have access to query within Cinchy. You can search or simply navigate by expanding the domains and tables.
You can drag and drop the columns or table you're looking for into the Query Builder.
Once you are satisfied with your query, you can click save to keep a copy. You can then find your query in the "Saved Queries" table:
You can find saved queries in the Saved Queries table.