Edit documentation Edit document
GH-Elements

Table

Table is a gh-element that gathers all certain items and displays them as rows in the table. It also allows to display only the selected fields of items in the columns.

Functional Characteristics

This element is mostly used for displaying certain data from items in several columns. Also, it allows to sort items by columns values and filter them in different ways.

More important thing is selection. Using table you can select items and delete, export, and update them.

Another use case is using tables for printing. This is possible because of some types of element interpretation.

Value Format

This element does not have value.

Element Options

The table element has different groups of settings.

Field/Table Settings And View Template

The following settings are mandatory for working with the table. The field settings contains only standard options, but other are unique for current gh-element.

Settings of field, table and view

Name Description
Application allows select the source application; details...
Table height allows to set the table height; details...
Item action allows to select the action after clicking; details...
Application Send Message allows to select the destination application for sending message; details...
Field Send Message allows to select the destination field for sending message; details...
Selected item allows to configure whether the items can be selected or not; details...
Item order allows to set the items order; details...
View name allows to choose the view that will be opened after opening the item; details...

Application

This is the source application whose items will be displayed in the table.

Table Height

This function configure how many items rows are displayed in the table. There are three possible values:

  • 5 rows
  • 10 rows
  • 15 rows

Item Action

This is the action that will happen after clicking on an item in the table.

  • Open Item
  • Send Message
  • None. This function cannot be selected. Due to it, after clicking nothing will happen.

Application Send Message

This is the application to which the message will be sent.

Field Send Message

After selecting the destination application you have to set the field to which the message will be sent.

Selected Item

This function allows you to set whether items can be selected in the table. For example, before deleting item you have to select it.

Item Order

Select the order in which the items are displayed, in ascending or descending order.

View Name

This is the view that will be opened after clicking on it in the table.

Table Groupe And Filter

With the following settings, you can group items in the table and filter which ones will be displayed.

Table groupe and filter

Table Groupe

With this function, you can group items by the values of any selected field.

Table Filter

Add filters to configure which items will be displayed in the table.

Table Columns

Settings of table columns

Name Description
Column contains name of elements that will be used as table columns; details...
Show allows to configure whether the field will be displayed in the table or not; details...
Width allows to configure the width of the column; details...

Column

This is the column that displays the names of all the fields of the selected application.

Show

With this function you can set whether a certain field will be displayed in the table or not.

Width

Set the width of a particular column. There are only 5 possible values: 50px, 100px, 150px, 200px, 250px.

Element Style

Despite the fact that the table displays all the elements of the application, it is still a gh element, so, just like all the others, it has all standard style settings and its own unique interpretation types.

Style of table element

General Settings

In addition to the standard, there is one unique setting:

General settings of table element

Name Description
Hide Id Column allows to hide the ID column

Hide ID Column

Due to this function you can hide the ID column when document-specific interpretation types are used. Namely, it works only for document generation.

Data Model

You can find all settings in the data model of the table.

{
    "data_model": {
        "app_id": 28793,
        "field_groupe": "679770",
        "filters_list": [],
        "interpretation": [],
        "send_message": {
            "app_id": "27904",
            "field_id": "648760",
        },
        "table_settings": {
            "action": "send_message",
            "columns_to_view": [{
                "field_id": 679453,
                "show": 1, 
                "width": "150px"
            }],
            "items_order": "0",
            "selected_item": "1",
            "sort_table_field": "679453",
            "table_height": "15",
            "view_id": 1529231
        }
    }
}
Name Type Description
app_id number contains ID of the source application
field_groupe string contains ID of the field by which items are grouped
filters_list array contains all filters of the table and its properties
interpretation array contains all element interpretation types
send_message object contains all data about sending message
app_id string contains ID of the destination application for the message
field_id string contains ID of the destination field for sending message
table_settings object contains all main data about table
action string contains name of the action after clicking om item
columns_to_view array contains data about table columns
field_id number contains ID of field that will be taken for column
show boolean shows whether the column will be displayed in the table
width string contains value of the column width
items_order string contains ID of the the value of item order
selected_item string shows whether the items in board can be selected or not
sort_table_field string contains ID of the field by which items in the table will be sorted
table_height string contains value of the table height
view_id number contains ID of the item view that will be opened after clicking

Filtration

Items can be filtered by any available field within the table, but not by the table itself.

Interpretation

The table element has quite different interpretation types:

Types of table interpretation

Input With Name

The first table interpretation type allows element to be displayed as an interactive table of items. It is used in applications and allows user to select items, open items or send messages after clicking on them.

Icon

This is the most simple type that displays element as an icon.

Standard Table For Doc

This is the first of types of interpretation for documents. It displays all items but does not allows to interact with them.

Simple Table For Doc

This type is the same to the previous one but the column titles are underlined.