Общие функции

Текущий раздел описывает функции, доступные в компонентах, основанных на компоненте Data Table.

Удалить строку

Удаляет строки из таблицы данных, указанные по индексам, указанным в аргументе Index.

Имя функции: removeRows

Аргументы:

Поле

Тип поля

Описание поля

Index

Data Table

Таблица данных с одним полем Index типа String. В каждой строке указывается индекс строки, которую необходимо удалить из таблицы данных.

Добавить строку

Вставляет таблицу данных, указанную в аргументе Row, в позицию индекса, указанную в аргументе Index.

Имя функции: addRow

Аргументы:

Поле

Тип поля

Описание поля

Index

Integer

Индекс строки, указывающий, куда необходимо добавить новую строку.

Row

Data Table

Таблица данных, содержащая данные для вставки в таблицу данных. Формат таблицы данных Row должен совпадать с форматом таблицы данных, в которую добавляется строка.

Изменить порядок строк

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

Имя функции: reorderRow

Аргументы:

Поле

Тип поля

Описание поля

Reorder Records

Data Table

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

Reorder ID

String

Указывает строку, перед которой выполняется вставка. Может быть UUID или значением, указанным в названии столбца Идентификатор записи. Если значение равно null, записи вставляются в конец

Parent Value

String

Указывает новый идентификатор родительской строки, если используются вложенные данные. Может быть UUID или значением, указанным в имени столбца Идентификатор родительской записи.

Значение Родительская запись представляет собой фактическое значение, хранящееся в столбце, обозначенном как Идентификатор родительской записи в конфигурации редактора таблиц данных. Если значение родительской записи не указано (null), иерархия записей остается неизменной, и изменяется только порядок записей на текущем уровне.

Обновить ячейку

Обновляет ячейку, указанную аргументами Index и Field, значением, указанным аргументом Value.

Имя функции: updateCell

Аргументы:

Поле

Тип поля

Описание поля

Index

String

Индекс строки ячейки, которую необходимо обновить.

Field

String

Имя поля ячейки для обновления.

Value

Data Table

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

Тип данных поля value должен быть таким типом, который может быть приведен к типу обновляемой ячейки.

Следующий пример иллюстрирует один из способов вызова функции updateCell:

  • Рассмотрим компонент Таблица данных с именем dataTableComponent0, имеющий по крайней мере одну существующую строку и поле exampleField

  • Мы хотим обновить значение ячейки в первой строке поля exampleField со строкой “this is the new field value” («это новое значение поля»).

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

{form/dataTableEditorUpdateCell:updateCell("1","exampleField",'array("value", "This is the new field value")')}

Выражение можно разбить на части следующим образом:

  • form/dataTableComponent0 — схема form/ обозначает компонент инструментальной панели, а dataTableComponent0 указывает на конкретный компонент

  • :updateCell Указывает, что функция updateCell вызывается из компонента

  • Функция имеет следующие аргументы:

    • "1" - строка таблицы данных для обновления

    • "exampleField" - поле таблицы данных для обновления

    • 'array("value", "This is the new field value")' Создает таблицу данных с одним полем value типа String и одну строку с данными "This is the new field value"

Выбрать строку

Выбрать или отменить выбор определенной строки в таблице данных на основе Record Index. Индекс записи может быть либо UUID строки, либо значением в поле таблицы данных, указанным в имени столбца идентификатора записи.

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

Имя функции: selectRow

Аргументы:

Поле

Тип поля

Описание поля

Record Index

String

Указывает строку, которую необходимо выбрать в таблице данных на основе UUID или значения, указанного в качестве идентификатора строки (записи) в имени столбца идентификатора записи.

Selection Type

Integer

Указывает тип операции выбора, которая будет применена к строке или таблице. Доступны следующие параметры:

  • 0 — отменить выбор строки, указанной аргументом Record Index. Состояние выбора всех остальных строк не изменится.

  • 1 — выбрать строку, указанную аргументом Record Index. Состояние выбора всех остальных строк не изменится.

  • 2 — отменить выбор всех строк в таблице, аргумент Record Index игнорируется.

  • 3 — выбрать все строки в таблице, аргумент Record Index игнорируется.

  • 4 — изменить состояние выбора всех строк в таблице на противоположное. Выбор всех выбранных строк будет отменен, а все невыбранные будут выбраны. Аргумент Record Index игнорируется.

Получить выбранные строки

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

Имя функции: getSelectedRows

Аргументы:

None

Возвращает:

Поле

Тип поля

Описание поля

Key

String

UUID выбранных строк.

Перезагрузить

При вызове функции reset() для таблицы данных все выбранные строки возвращаются в исходное состояние. Это означает, что все введенные пользователем значения отбрасываются и заменяются исходными значениями. Любая фильтрация или сортировка, примененная к таблице пользователем, возвращается в состояние по умолчанию.

Имя функции: reset

Аргументы:

None

Возвращает:

None

Was this page helpful?