Загрузка...

4.14. Поле Таблица

Это поле, которое позволяет создать таблицу, состоящую из столбцов. Для каждого столбца администратор указывает его заголовок и поле (тип столбца, который соответствует типам полей, установленным в системе). В зависимости от типа столбца появляются настройки соответствующего типа поля. На вкладке "Дополнительное" можно для каждого столбца настроить отображение / скрытие в шаблоне, а для шаблона формы установить признак обязательности заполнения данного столбца при создании новой строки таблицы пользователем.

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

Методы поля для записи данных

  • Изменить строку. Метод имеет два параметра: "Номер  строки" (здесь и далее - нумерация строк начинается с 1), которая изменяется (можно получить из како-го либо поля или ввести вручную), и "Значения столбцов" (таблица с двумя столбцами Столбец табличного поля, строка которого изменяется при помощи данного метода и поле текущего документа, откуда будет получено новое значение для выбранного столбца).
  • Добавить строку. Строку можно добавить в конец таблицы либо вставить перед строкой с заданным порядковым номером (параметр "Вставить перед"; если этот параметр не задавать, строка будет вставлена в конец таблицы). Сама вставляемая строка задается при помощи табличного параметра "Значения столбцов", в котором определяются значения столбцов табличного поля, а значения вводятся вручную либо указывается поля, откуда они будут получены в процессе работы документа.
  • Удалить строку. У метода есть один параметр - порядковый "Номер строки" для удаления.

Методы поля для чтения данных

  • Получить количество строк. Возвращает число, соответствующее количеству строк в таблице.
  • Получить значение ячейки. Метод возвращает значение ячейки, находящейся на пересечении передаваемого номера строки (нумерация с 1) и столбца.

Внутри самой таблицы данные хранятся в формате JSON-массива. Если, например, в Табличное поле из двух строковых столбцов записать  [["row1:col1","row1:col2"],["row2:col1","row2:col2"]], то в этом поле появятся две строки: 

row1:col1       row1:col2

row2:col1       row2:col2

Поле может быть использовано в ходе работы. В этом случае таблица должна содержать 4 поля строкового типа. Первое поле может иметь тип Время с форматом отображения даты ДД.ММ.ГГГГ ЧЧ:ММ:СС.


4.18. Поле Таблица документов