Logo
Logo
Managing Interface.en

Interface Control #

Projections #

Creating a Projection #

  1. Go ![Image](https: // gitlab.abris.site/abris-lab/abris/-/wikis/uploads/ff3c20f9b27fa6b35fb3a333d338e6ac/image.png) ** [Menu ] ** ** > ** * [Configuration ] * ** > ** * [Projections ] * (or * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button Image ** [Setup … ] ** ** > ** field * [Entity ] * ** > ** button image ** > ** containerimage ** [Projections ] **).

  2. Click the buttonImage ** [Add … ] ** in tabular form.

  3. Fill in the required fields: * “Projection name” *, * “Entity” *,

  4. Click the button Image ** [Create ] ** to add an entry or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit the add mode without saving data.

Creating a virtual field #

Calculated fields are used to perform mathematical operations on selected data. Age,calculated from static fields elapsed time, distance are. A view is created with therequired fieldsfor the calculation and a column with the result is added. The virtual field does not create a complete view, but only two columns: the primary key and the result field. Then the field is attached to the entity. An additional plus: painless deletion and addition of columns. The view will have to be re-created.

Pre-create an entity with a calculated value, the primary key of which will be> identical to the primary key of the entity for which theis virtual field> created.

  1. Go Image ** [Menu ] ** ** > * * * [Configuration ] * ** > ** * [Projection properties ] * (or * [Selected entity ] * ** > ** button ![Image](https: // abris. site/base-icons/icon_more_sq.png) ** [More ] ** ** > ** button image ** [Setup … ] ** ** > ** * [Projection properties ] *.

  2. Click the buttonImage

      • [Add … ] ** in tabular form
  3. Fill in the required fields: * “Projection name” *, * “Column name” *,

    • “Is virtual” * (in the value “true”), * “Virtual property source” *,
    • “Original column name” *. Description of all fields in Projection properties/Properties.
  4. Click the button ![Image](https: // abris.site/base-icons/icon_save-ok.png) ** [Create ] ** to add an entry or the button image

      • [Cancel ] ** to exit and from the add mode without saving data.

Setting field display options #

  1. Go Image ** [Menu ] ** ** > ** * [Configuration ] * ** > ** * [Projection properties ] * ** > ** * [Selected entity ] * (or * [Selected entity ] * ** > ** button image ** [More ] ** ** > ** button image ** [Setup … ] ** ** > ** container ![image](https://abris.site/ base-icons/icon_table.png) * [Projection properties ] *).

  2. In the detailed form, press the button Image ** [Edit ] ** to switch to edit mode.

  3. Change the field values: * “Order” *, * “Projection name” *, * “Column name” *, * “Title” *, * “Type on display” *, * “Visibility” , * “Read- only mode “, ” Is nullable “, ” Is foreign key “, ” Reference projection “, ” Reference key “, ” Is virtual “, ” Virtual property source “, * “Original column name” *, * “Show in references” *,

    • “Concatenation” *, * “Default value” *, * “Hint” *, * “Pattern” *,
    • “Additional parameters” *. Description of all fields in Projection properties/Properties.
  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Configuring drop-down field options #

An option sets the information that is displayed in the drop-down list.

  1. Navigate in one of the following ways:

    • Method 1: *

    • [Selected entity ] * ** > ** * [Selected entry ] * ** > **

    • [Selected drop-down field ] * * * > ** button image ** > ** button![image](https://abris.site/base -icons/icon_settings.png) ** [Setup … ] ** ** > ** container * [Projection properties ] * ** > **

    • [Selected field ] *).

    image

    imagehttps://gitlab.ablris

    • Method 2: *

    image ** [Menu ] ** ** > ** * [Configuration ] * ** > ** * [Projection properties ] * ** > ** * [Selected field ] *).

  2. In the detailed form, press the button Image ** [Edit ] ** to switch to edit mode.

  3. Change the value of the * “Show in references” * field. Description of the field in Projection properties/Properties.

    image

  4. Click the button image ** [Save ] ** to save changes or click image ** [Cancel ] ** to exit edit mode without saving.

    image

Fields with the * “Show in references” * flag set will be displayed in the dropdown field.

Change field type #

  1. Go Image ** [Menu ] * * ** > ** * [Configuration ] * ** > ** * [Projection properties ] * ** > ** * [Selected entry ] * (or * [Selected entity \ ] * ** > ** button image ** [More ] ** ** > ** button image ** [Setup … ] ** ** > ** container ![image](https://abris.site/base -icons/icon_table.png) * [Projection properties ] * ** > ** * [Selected entry ] *).

  2. In the detailed form, press the button Image ** [Edit ] ** to switch to edit mode.

  3. Change the value of the * “Type on display” * field. Description of values ​​in Field values ​​* “Type on display” *.

  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Setting up automatic field display #

Automatic display and hide fields by condition.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the field * “Additional parameters” *:

    `{.json} { " property_visible ": { " a ": { " field ":" b ", " op ":" EQ ", " value ": "c" }, ... } } `

    Instead of * a *, * b * and * c * enter:

    • instead of ” a “ - the name of the field (not the title), which should be displayed when the corresponding value appears in field “b”;

    • instead of * “b” * - the name of the field, which will serve as an indicator for the field a;

    • instead of * “c” * - the value, when it appears in the field “b”, the field “a” will be displayed.

  4. For one field, you can set several conditions:

    `` {.json} { " property_visible ": { " a ": [{ " field ":" b1 ", " op ":" EQ ", " value ":" c1 " }, { " field ":" b2 ", " op ":" EQ ", " value ":" c2 " } ], ... } } `'

    Conditions are combined with the” AND “operation.

    If there are several fields that need to be hidden/displayed, then the lines are listed separated by commas inside the “property \ _visible” element.

  5. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Setting the automatic display of an empty fieldEmpty #

fields are displayed only when editing.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the * “Additional parameters” * field:

    `{.json} { " hideEmptyFields ":" a " } `

    Replace * “a” * with “true” or “false” to enable or turn off the function accordingly.

    By default, the function is set to “false”.

  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Tabular Forms #

DefaultDefault #

Sort>Column Sort.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the field * “Additional parameters” *:

    `` {.json} { " order ": [ { " field ":" a ", " desc ":" b " }, ... ] }

    Field ” field “ contains the name of the field by whichperformed sorting is.

    The * “desc” * field contains the value “false” if sorted from smallest to largest, and “true” otherwise.

  4. Replace * a * and * b * with values.

    If there are several conditions for sorting, then the lines are listed separated by commas inside the “order” element.

  5. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Filtering by default #

Displaying table rows by condition.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the field * “Additional parameters” *:

    `{.json} { " hardFilter ": [ { " levelup ": false, " operand ": { " field ":" a ", " path ": [ "a"], "op": "b", "value": ["c", ...] } }, ... ] }

    The * “levelup” * field always contains the value “false”. The value “true” is used for more complex queries that contain additional field conditions, and is primarily intended for internal use.

    The * “field” * field contains the name of the field by which theperformed filtering is.

    The * “path” * field contains a value ifto create the multiple tables were usedentity. For simple queries, this field contains the same value as the field “field”.

    The * “op” * field contains the operation to be performed. Values ​​in this field can be:

    • “EQ” - equal;
    • “NEQ” - not equal;
    • “G” - more;
    • “F” - call a function with a name corresponding to the value in the “field” field;
    • “FC” is a special parameter for internal use.in this Not usedmanual;
    • “EQF” - compares the value from the “field” field with the value from thefield “value”;
    • “FEQ” is a special parameter for internal use.in Not usedthis manual;
    • “L” - less;
    • “GEQ” - greater or equal;
    • “LEQ” - less or equal;
    • “C” - occurrence of a substring;
    • “ISN” is equal to 0;
    • “ISNN” - not equal to 0.
    • “DUR” - set for time and dates. Checks if thefalls date or timewithin the last period. The period is indicated in the format Durations.

    The “value” field contains the value at which thewill be executed condition (operation).

  4. Instead of * a *, * b * and * c * enter:

    • instead of * “a” * - the name of the field (not the title) by which you want to filter;
    • instead of * “b” * - operation, when the condition of which thewill be filteringcarried out;
    • instead of * “c” * - a value that will be used by the operation as a boundary.

    If there are several filtering conditions, the lines are listed separated by commas inside the “hardFilter” element.

    If there arevalues ​​that will be used by the operation for several> filtering, then the strings are listed separated by commas inside the “value” element.

  5. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Creating a “Reporting form” #

The “Reporting form” element allows you to use frequentwhen filtering values.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the field

    • “Additional parameters” *: `

      ..
      

      ] } `` `

  4. Instead of * a * and * b *, enter:

    • instead of ” a “ - a frequently occurring value to search for (or several, if necessary);
    • instead of * “b” * - the field by which the search will be carried out;

    If there are several fields, then list them separated by commas inside the “report \ _properties” element, for example:

    `{.json} " report_properties ": [ { " preset ": [ " English ", " Russian " ], " field ":" language " }, { " preset ": [ " Action ", " Drama " ], " field ":" category_name " } ] `

    If the field being searched for is a foreign key: frequent values specify along with the key, for example:

    `` ‘{.json} “report_properties”: [ { “preset”: [ { “key”: 1, “value”: “English” }, { “key”: 2, “value “:” Russian " }, { " key “: 3, " value “:” German " } ], " field “:” language " }, { " preset “: [ " Action “, " Drama " ], " field “:” category_name " }, … ] " "

  5. Click the button image ** [Save ] ** to save changes or the button image ** [Cancel ] ** to exit editing mode without saving.

    The element for filtering is added according to the data type fields.

Number of Visible Rows for ArticleArticle #

Element>Element displays tabular forms as articles.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **

  2. In the detailed form, click the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the * “Additional parameters” * field:

    `` {.json} { " articlePageSize ":" a " } `

    Instead of ” a “, specify the number of articles to display.

  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Entity data refresh interval #

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [ More ] ** ** > ** button Image ** [Setup … ] **

  2. In detailed form press the button image ** [Edit ] ** to switch to edit mode.

  3. Enter in the field

    • “Additional parameters” *: `

    Instead * “ms” * enter the number of the interval (in milliseconds), which will take place refreshing the page.

  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Detailed forms #

Setting a display template #

There are several templates for displaying a detailed form, differing in the set of properties, buttons and general principle of operation.

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button image ** [Setup … ] **.

  2. In the detailed form, press the button Image ** [Edit ] ** to switch to edit mode.

  3. Enter in the * “Additional parameters” * field:

    `` {.json} { " detailView ":" a " } `

    Instead of ” a “, enter the value of the display template. Values ​​in this field can be:

      • “detail” * (used by default);
      • “element” *;
      • “dmsdetail” *.

    Description of templates in Field values ​​* “View template /template Display” *.

  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Setting up a field for storing files #

  1. Navigate to * [Selected entity ] * ** > ** button Image ** [More ] ** ** > ** button Image ** [Setup … ] **.

  2. In the detailed form, press the button Image ** [Edit ] ** to switch to edit mode.

  3. Enter in the * “Additional parameters” * field:

    `` {.json} { " store_mode ":" a " } `

    Instead of ” a “, enter the value of the storage parameter. Values ​​in this field can be:

      • “byte \ _array” * - for a field in the database of the “bytea” type. This type is used by the database and can store only one file (image) without a name. When a new file is loaded, the old one is overwritten.
      • “single \ _file” * - for a field of type “meta.file”. This type duplicates the standard type in the database and stores only one object, but it can store the names of files and images with previews of objects in the form of mini-images.
      • “default” * - for a field of type “meta.file []”. This type can store an unlimited number of objects with previews and names. Used by the program by default.
  4. Press the button Image ** [Save ] ** to save the changes or the button ![Image](https: // abris.site/base-icons/icon_cross.png) ** [Cancel ] ** to exit edit mode without saving.

Trees #

Creating a tree #

A tree is a way of displaying data. It is formed from entities.

image

  1. Create an entity from three fields (see p. Creating a table, [Creating a view](tasks/Create- new-view-new), [Creating a projection](../ tasks/Create-projections-new)):

      • field 1 * - primary key;
      • field 2 * - names of tree elements;
      • field 3 * - element’s parent key.
  2. On * field 3 * set the foreign key from * field 1 * (see p. [Installing a foreign key](../ installing-foreign-key-new).

  3. Fill in the entity data.

  4. Add a menu item for the entity. (See p. Adding a menu item). In the * “Style” * field, specify the value

    • “treedetailed” *.

Creating a tree with classifiers #

In the tree with classifiers, in addition to nesting, criteria andare created classes.

** Criterion ** - a sign for evaluating something. The criterion allows you to select ** classes ** and classify objects by them. Criterion classification “color” can divided into classes: red, blue, yellow.

  1. Create two entities (see p. Creating a table, [Creating a view](tasks/Create-new-view- new), [Creating a projection](../ tasks/Create-projections-new)).

    Entity 1:

      • field 1 * - primary key;
      • field 2 * - names of tree elements;
      • field 3 * - key ancestor of the element;
      • field 4 * - foreign key * of entity 2 * (added after creating ania
        • entities 2 *).

    Entity 2:

      • field 5 * - primary key;
      • field 6 * - names of criteria;
      • field 7 * - foreign key * of entity 1 *.
  2. On * field 3 * set the foreign key from * field 1 * (see p. [Installing a foreign key](../ installing-foreign-key-new).

  3. On * field 4 * set foreign key from * field 5 * (see p. [Installing a foreign key](../ installing-foreign-key-new).

  4. On * field 7 * set the foreign key from * field 1 * (see p. [Installing a foreign key](../ installing-foreign-key-new).

Setting up a tree #

If there are several foreign keys or they are not explicitly specified: specify parent, left and right keys.

  1. Go * [Selected entity ] * ** > ** button image ** [More ] ** ** > ** button  image [Setup…].

  2. В детальной форме нажмите кнопку ![image](https://abris. site/base-icons/icon_edit.png) [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "parent_property": " a",
      "left_key_property": "b",
      "right_key_property": "c"
    }
    

    Параметры можно указы вать выборочно.

    Вместо a, b и c введите:

    • вместо “a” - поле, содержащее родительские ключи;
    • вместо “b” - поле, содержащее левый ключ;
    • вместо “c” - поле, содержащее правый ключ.

    Подробнее о вложенных множествах в Вложенное множество (модель).

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Диаграммы и карты #

Создание карты #

Создание карты и статических объектов на ней.

Для работы с картой рекомендуется использовать представление.

  1. Создайте сущность (см. п. Создание таблицы, Создание представления, Создание проекции). В сущности добавьте колонки с координатами: широта и долгота (см. п. Добавление колонки.

  2. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  3. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  4. Введите в поле “Additional parameters”:

           {
               "longitude_property": "x",
               "latitude_property": "y"
           }
    

    Вместо x, y введите:

    • вместо “x” - поле, содержащее долготу;
    • вместо “y” - поле, содержащее широту.
  5. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Создание диаграммы #

  1. Создайте сущность (см . п. Создание таблицы, Создание представления, Создание проекции). В сущности добавьте колонки числового типа (см. п. Добавление колонки.

  2. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  3. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  4. Введите в поле “Additional parameters”:

          {
              "chartType": "a"
          }
    

    Вместо “a” укажите тип диаграммы: “bar” (столбчатая), “pie” (круговая), “line” (линейная), “area” (аддитивная), “radar” (радар), “doughnut” (пончик) и др. Подробнее в Типы диаграмм.

  5. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактиро вания без сохранения.

    В качестве заголовка диаграммы по умолчанию используется заголовок сущности.

Настройка диаграммы #

Для создаваемых диаграмм задается множество параметров. Если параметр не указан, то используется его значение по умолчанию.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

          {
              "chartType": "doughnut",
              "chartOptions": {
                  "plugins": {
                      "labels": {
                          "render": "value",
                          "fontSize": "14",
                          "fontColor": "#fff"
                      }
                  }
              },
              "s-property": "sensor_id",
          }
    

    Параметр “render” указывает формат отображения значений диаграммы. В данном случае в значении “value” - указывает на отображение числового значения.

    Параметр “fontSize” указывает размер шрифта значений диаграммы. В данном случае размер 14 пикселей.

    Параметр “fontColor” указывает цвет шрифта значений диаграммы. В данном случае “#fff” (HEX) - “красный”.

    Параметр “s-property” содержит столбец, данные которого будут использоваться в качестве легенды. В данном случае “sensor_id”.

    Подробнее о параметрах и их возможных значениях на сайте с документацией Chart.js. Примеры использования на сайте emn178.github.io.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Создание графика #

  1. Создайте сущность (см. п. Создание таблицы, Создание представления, Создание проекции). В сущности добавьте колонки числового типа (см. п. Добавление колонки.

  2. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  3. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  4. Введите в поле “Additional parameters”:

          {
           "chartType": "scatter",
               "x-property": "x", 
               "y-properties": [ "y1", "y2" ]
           }
    

    Вместо “x” укажите наименование столбца (не заголовок!), содержащего значения оси абсцисс, а вместо “y1” и “y2” укажите наименования столбцов, содержащих значения оси ординат. Подробнее в Chart.js.

    Значений оси ординат может быть не менее одного.

  5. Нажмите кнопку image [ Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

    В качестве заголовка графика по умолчанию используется заголовок сущности.

Настройка графика #

Добавление легенды в график #

Легенда содержит условные знаки и их обозначения на графике.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

          {
           ...
          "s-property": "s"
           }
    

    Вместо “s” укажите наименование столбца, содержащего значения, которые необходимо использовать в качестве определения обозначений графика.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Цветовая палитра графика #

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

          {
           ...
          "graphColors": [
             "color1",
             "color2"]
           }
    

    Вместо “color1” и “color2” укажите цвета, например “green”, “yellow” или “#008000”, “#FFFF00” в HEX (шестнадцатиричная система). Количество цветов необходимо указать по количеству графиков.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Переключатель графиков #

Для отображения нескольких графиков используется переключатель графиков: вкладки с графиками.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

          {
           ...
          "graphGroups": [
                       {
                "title": "graph1",
                "items": [
                  "column1"
                ]
              },
              {
                "title": "graph2",
                "items": [
                  "column2"
                ]
              }
            ]
           }
    

    Вместо “graph1” и “graph2” укажите наименования вкладок для графиков. Вкладок может быть минимум две.

    Вместо “column1” и “column2” укажите наименования столбцов, которые будут задавать значения по оси ординат. Количество столбцов должно соответствовать количеству вкладок.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Группировка данных графика #

Данные сущности можно делить на группы, используя значения одного из столбцов.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

          {
           ...
           "g-property": "g"
           }
    

    Вместо “g” укажите наименование столбца, по значениям которого будет осуществляться группировка.

    Этот параметр, в отличие от предыдущих, применяется совместно с переключателем графиков. Таким образом, графики из разных групп отображаются в разных вкладках переключателя.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Пример #

{
  "chartType": "scatter",
  "x-property": "date",
  "y-properties": [
    "temperature"
  ],
  "s-property": "date",
  "graphColors": [
    "green",
    "#FFFF00"
  ],
  "g-property": "group",
  "graphGroups": [
    {
      "title": "Дневная температура",
      "items": [
        "temperature"
      ]
    },
    {
      "title": "Ночная температура",
      "items": [
        "temperature_night"
      ]
    }
  ]
}

Меню #

Добавление корневого пункта #

image

Способ 1:

  1. Перейдите image [Menu] > [Configuration] > [Menu items].

  2. Нажмите кнопку image [Add element] под деревом данных для создания корневого пункта.

  3. Заполните обязательные поля: “Name”, “Title”. Описание всех полей в Menu items/Пункты меню.

    Отображаются только те пути, которые заканчиваются пунктами с установленным значением в поле “Projection”. Например:

    • если создать корневой пункт и не добавить в него “Projection”, то он не отобразится в меню.
    • если создать корневой и дочерний пункты и для дочернего указать “Projection”, то отобразятся оба пункта.
  4. Нажмите кнопку image [Create] для добавления элемента или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

Способ 2:

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. Нажмите кнопку [Push to menu] для создания корневого пункта.

Создает корневой пункт с параметрами по умолчанию.

Добавление дочернего пункта #

image

  1. Перейдите image [Menu] > [Configuration] > [Menu items].

  2. Выделите пункт и нажмите кнопку image [Add child element] под деревом данных для создания дочернего элемента.

  3. Заполните обязательные поля: “Name”, “Title”. Описание всех полей в Menu items/Пункты меню.

    Отображаются только те пути, которые заканчиваются пунктами с установленным значением в поле “Projection”.

    Например: если создать несколько вложенных дочерних пункта и для последнего указать “Projection”, то отобразятся все пункты.

  4. Нажмите кнопку image [Create] для добавления элемента или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

Переход к сущности по ссылке #

Переход к сущности возможен не только при помощи пунктов меню, но и по ссылке в адресной строке.

  1. В адресной строке введите запрос по маске: https://example_site/#view_template/table_name. Например:

    image

    Вместо example_site, view_template и table_name введите:

    В маске для отображения детальной формы записи используется шаблон “list”, а после наименования сущности указывается номер записи. Например: https://abris.site/pagila/#list/customer/2 .

  2. Нажмите кнопку [Enter] на клавиатуре.

Кнопки #

Создание кнопки на детальной форме #

  1. Создайте функцию для обработки кнопки:

    1. Перейдите image [Menu] > [Configuration] > [User defined functions].

    2. Нажмите кнопку image [Add…] в табличной форме.

    3. Заполните обязательные поля: “Schema name”, “Function name”, “Return value data type”, “Function parameters”, “Function code”. Описание всех полей в User definded functions/Пользовательские функции.

      В качестве входного параметра функции используйте объект того же типа, что и таблица.

      Например:

      CREATE OR REPLACE FUNCTION detail_button(address)
        RETURNS text AS
      $BODY$
      BEGIN
        RETURN 'Нажата кнопка на детальной форме';
      END
      $BODY$
        LANGUAGE plpgsql VOLATILE SECURITY DEFINER
        COST 100;
      

      image

    4. Нажмите кнопку image [Create] для добавления записи или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

  2. Создайте кнопку:

    1. Перейдите image [Menu] > [Configuration] > [Buttons] (или [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…] > контейнер image [Buttons]).

    2. Нажмите кнопку image [Add…] в табличной форме.

    3. Заполните обязательные поля: “Identifier”, “Projection name”, “Schema name”, “Function”, “Use in list” в значении “false”. Описание всех полей в Buttons/Кнопки.

      image

    4. Нажмите кнопку image [Create] для добавления записи или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

Создание кнопки в табличной форме #

  1. Создайте функцию для обработки кнопки:

    1. Перейдите image [Menu] > [Configuration] > [User defined functions].

    2. Нажмите кнопку image [Add…] в табличной форме.

    3. Заполните обязательные поля: “Schema name”, “Function name”, “Return value data type”, “Function parameters”, “Function code”. Описание всех полей в User definded functions/Пользовательские функции.

      В качестве входного параметра функции используйте массив того же типа, что и первичный ключ.

      Например:

      CREATE OR REPLACE FUNCTION table_button(text[])
        RETURNS text AS
      $BODY$
      BEGIN
        RETURN 'Нажата кнопка в табличной форме';
      END
      $BODY$
        LANGUAGE plpgsql VOLATILE SECURITY DEFINER
        COST 100;
      

      image

    4. Нажмите кнопку image [Create] для добавления записи или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

  2. Создайте кнопку:

    1. Перейдите image [Menu] > [Configuration] > [Buttons] (или [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…] > контейнер image [Buttons]).

    2. Нажмите кнопку image [Add…] в табличной форме.

    3. Заполните обязательные поля: “Identifier”, “Projection name”, “Schema name”, “Function”, “Use in list” в значении “true”. Описание всех полей в Buttons/Кнопки.

      image

    4. Нажмите кнопку image [Create] для добавления записи или кнопку image [Cancel] для выхода из режима добавления без сохранения данных.

Отображение кнопки на детальной форме по условию #

Сокрытие и отображение кнопок: “Сохранить”, “Добавить”, “Удалить”.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "button_visible": {
        "save": "условие",
        "add": "условие",
        "delete": "условие"
      }
    }
    
  4. Вместо “условие” введите значение/выражение, при котором соответствующая кнопка должна отображаться на детальной форме. Задайте несколько условий для одной кнопки (при необходимости):

    {
      "button_visible": {
        "delete": [
          {
            "field": "b1",
            "op": "EQ",
            "value": "c1"
          },
          {
            "field": "b2",
            "op": "EQ",
            "value": "c2"
          }
        ],
    ...
      }
    }
    

    Условия объединяются операцией “И”.

    Поле “field” содержит название поля, значение которого используется при идентификации положения кнопки.

    Поле “op” содержит операцию, которую необходимо выполнить. Значениями в данном поле могут быть:

    • “EQ” - равно;
    • “NEQ” - не равно;
    • “ISN” - равно 0;
    • “ISNN” - не равно 0;
    • “ANY” - входит в массив значений поля “value”. При этом в поле “value” необходимо перечислить значения, при совпадении с одним из которых условие будет выполняться. Например:
         ...
         "op": "ANY",
               "value": [ 
                 "\"char\"",
                 "character",
                 "character varying",
                 "bit",
                 "bit varying"
               ]
         ...
    

    Ожидается поддержка операторов:

    • “G” - больше;
    • “F” - вызов функции с именем, соответствующем значению в поле “field”;
    • “FC” - специальный параметр для внутреннего применения. В данном руководстве не используется;
    • “EQF” - сравнивает значение из поля “field” со значением из поля “value”;
    • “FEQ” - специальный параметр для внутреннего применения. В данном руководстве не используется;
    • “L” - меньше;
    • “GEQ” - больше или равно;
    • “LEQ” - меньше или равно;
    • “C” - вхождение подстроки;

    Поле “value” содержит значение, при котором будет выполняться условие.

  5. Вместо a, b и c введите:

    • вместо “a” - название поля (не заголовок), по которому необходимо осуществить проверку;
    • вместо “b” - операцию, при выполнении условия которой будет осуществляться отображение кнопки;
    • вместо “c” - значение, которое будет использоваться операцией в качестве границы.

    Если кнопок, которые необходимо скрыть/отобразить несколько, то строки перечисляются через запятую внутри элемента “button_visible”.

  6. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Отображение кнопки на детальной и табличной форме без условия #

Сокрытие и отображение кнопок: “Сохранить”, “Добавить”, “Удалить” на табличной и детальной форме одновременно.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "viewActions": {
        "allowAdd": false,
        "allowDelete": false,
        "allowSave": true
      }
    }
    

    Значение “true” - отобразить кнопку.

    Значение “false” - скрыть кнопку.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Активность кнопки #

Кнопки “Сохранить”, “Добавить”, “Удалить” могут быть активными или неактивными при выполнении определенных условий.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "button_enabled": {
        "save": "условие",
        "add": "условие",
        "delete": "условие"
      }
    }
    
  4. Вместо “условие” введите значение/выражение, при котором соответствующая кнопка будет активна. Задайте несколько условий для одной кнопки (при необходимости):

    {
      "button_enabled": {
        "delete": [
          {
            "field": "b1",
            "op": "EQ",
            "value": "c1"
          },
          {
            "field": "b2",
            "op": "EQ",
            "value": "c2"
          }
        ],
    ...
      }
    }
    

    Условия объединяются операцией “И”.

    Поле “field” содержит название поля, значение которого используется при идентификации статуса кнопки.

    Поле “op” содержит операцию, которую необходимо выполнить. Значениями в данном поле могут быть:

    • “EQ” - равно;
    • “NEQ” - не равно;
    • “G” - больше;
    • “F” - вызов функции с именем, соответствующем значению в поле “field”;
    • “FC” - специальный параметр для внутреннего применения. В данном руководстве не используется;
    • “EQF” - сравнивает значение из поля “field” со значением из поля “value”;
    • “FEQ” - специальный параметр для внутреннего применения. В данном руководстве не используется;
    • “L” - меньше;
    • “GEQ” - больше или равно;
    • “LEQ” - меньше или равно;
    • “C” - вхождение подстроки;
    • “ISN” - равно 0;
    • “ISNN” - не равно 0.

      Поле “value” содержит значение, при котором будет выполняться условие.

  5. Вместо a, b и c введите:

    • вместо “a” - название поля (не заголовок), по которому необходимо осуществить проверку;
    • вместо “b” - операцию, при выполнении условия которой кнопка будет активна;
    • вместо “c” - значение, которое будет использоваться операцией в качестве границы.

    Если кнопок, для которых необходимо задать условия, несколько, то строки перечисляются через запятую внутри элемента “button_enabled”.

  6. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Отображение кнопок-ссылок #

Раскрывающийся список дополняется кнопками-ссылками:

  • кнопка image открывает форму для добавления значений в раскрывающийся список.
  • кнопка image открывает дополнительную форму, связанную с выбранным элементом раскрывающегося списка.
  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "hideRefToDetail": "a"
    }
    
  4. Вместо “а” укажите “true” или “false”, чтобы разрешить или запретить отображение элемента соответственно.

    По умолчанию функция имеет значение “false”.

  5. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Добавление группы радиокнопок #

image

Группа радиокнопок используется для выбора одного варианта из группы взаимоисключающих опций.

  1. Добавьте в сущность новую колонку (см. п.Добавление колонки). В поле “Type on display” выберите значение “radiobutton”.

  2. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  3. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  4. Укажите параметры:

    Способ 1:

    1. Введите в поле “Additional parameters”:

      {
        "source-items": [
          "a1",
          "a2",
         ...
        ],
        "use-enumeration": "true"
      }
      

      Поле “source-items” содержит набор заголовков кнопок.

    2. Вместо a1, a2 введите заголовки кнопок.

    3. Укажите “use-enumeration” (при необходимости). Поле “use-enumeration” в значении “true” сохраняет в базу данных индекс выбранного элемента: 1, 2, 3 и т.д.

    По умолчанию “use-enumeration” имеет значение “false”.

    Способ 2:

    1. Введите в поле “Additional parameters”:

      {
        "source-dictionary": [
          {
            "key": "b1",
            "value": "c1"
          },
          {
            "key": "b2",
            "value": "c2"
          },
         ...
        ]
      }
      

      Поле “source-dictionary” содержит набор ключей и заголовков кнопок.

    2. Вместо b1, b2 и c1 c2 введите:

      • вместо “b1”, “b2” - значения, которые будут вноситься в базу данных;
      • вместо “c1”, “c2” - заголовки кнопок.
  5. Укажите “null-option” (при необходимости):

    {
       ...
       "null-option": "не указано"
       ...
    }
    

    Поле “null-option” содержит заголовок кнопки. Нажатие на кнопку будет присваивать группе радиокнопок значение “null”.

  6. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Расположение кнопок “Контекстных действий” #

image

По умолчанию контекстные действия располагаются на панели “More”. Данная функция позволяет установить для контекстных действий месторасположение в основном окне.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "actionsFilter": {
        "a": "main"
      }
    }
    

    Вместо а укажите для какого контекстного действия изменить местоположение на основное окно:

    Контекстное действие Описание


    showTableFilter image [Filter] showTableSummary image [Summary] exportToHtml image [Export to HTML] exportToPdf image [Export to PDF] exportToExcel image [Export to Excel] report [Report…] reload image [Refresh] showConstructor image [Table designer] openPivot [Analyze. ..] importFromClipboard image [Import from clipboard] editVersions [Export request to console] settings image [Setup]

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Инструменты #

Видимость элемента “Отметка” #

image

Элемент “Отметка” позволяет выделять записи таблицы, чтобы выполнять одинаковые действия над группой.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "multiSelect": "a"
    }
    

    Вместо “а” укажите значение “true” или “false”, чтобы разрешить или запретить отображение элемента соответственно.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

Видимость элемента “Анализ” #

image

Элемент “Анализ” позволяет проводить статистические расчёты для полей таблицы.

  1. Перейдите [Выбранная сущность] > кнопка image [More] > кнопка image [Setup…].

  2. В детальной форме нажмите кнопку image [Edit] для перехода в режим редактирования.

  3. Введите в поле “Additional parameters”:

    {
      "pivotEnable": "a"
    }
    

    Вместо “а” укажите значение “true” или “false”, чтобы разрешить или запретить отображение элемента соответственно.

  4. Нажмите кнопку image [Save] для сохранения изменений или кнопку image [Cancel] для выхода из режима редактирования без сохранения.

    По умолчанию кнопка отображается в панели кнопки image [More].

“Настройки…”.

  1. В поле “Дополнительные параметры” ввести следующее:
    {
        "icon_property": "a"
    }

Вместо “а” необходимо указать наименование поля, в котором хранятся наименования иконок.

  1. Нажать “Сохранить”.

HTML-шаблон для отчетных форм #

Отображать необходимую информацию на странице можно в HTML. Для это необходимо:

  1. Выбрать нужную сущность и перейти в “Контекстные действия” —> “Настройки…”.

  2. В поле “Дополнительные параметры” ввести следующее:

"searchHomeHtml":"a"

Вместо “a” поместить HTML-код страницы, котору ю необходимо отобразить в программе.

Например:

"searchHomeHtml":"<h1>My First Heading</h1>
<p>My first paragraph.</p>"
  1. Нажать “Сохранить”.

Содержимое HTML-страницы всегда помещается внизу страницы в программе.

aggregate - функция в разработке

join_field_distinct - функция в разработке

–>