Alpha.Community

В разделе Документация вы найдете все для уверенного старта и работы с Альфа платформой: от пошаговых инструкций по установке и конфигурированию до подробного описания работы компонентов и подсистем. Для поиска необходимых тем и вопросов в документации, воспользуйтесь поиском и фильтрацией результатов.

Таблица: модель данных

Компонент предназначен для хранения данных в табличном виде и предоставления доступа к ним через API.

Свойства

Свойство

Описание

Вариант обработки событий от источника данных

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

Заморозка

Запрещает/разрешает обновление таблицы данными, поступившими от источника или заданными в скрипте.

Максимальное количество рядов данных

Максимальное число строк таблицы.

Функции

Функция

Описание

AddColumn

Добавляет новый столбец в таблицу модели данных.

AddRow

Добавляет новую строку в конец таблицы модели данных.

AppendContentAsJson

Добавить данные в формате JSON в модель.

BeginReadAsync

Заполняет таблицу модели данными из источника.

CancelReadAsync

Прерывает чтение данных из источника.

Clear

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

GetCellData

Возвращает значение указанной ячейки.

GetColumnCount

Возвращает количество столбцов, существующих в таблице на момент вызова функции.

GetColumnSpecAsJson

Возвращает спецификацию столбцов модели в формате JSON.

Спецификация столбца — это описание столбца модели данных: его идентификатор, заголовок, описание, единицы измерения, тип данных и модификаторы доступа. Набор полей соответствует параметрам функции AddColumn, с помощью которой столбец создаётся.

GetContentAsJson

Запрашивает содержимое модели данных (структуру столбцов и значения всех строк) в формате JSON.

Функция выполняется асинхронно: вызов запускает получение данных, результат обрабатывается в событии GetContentAsJsonFinished (параметр data) либо в событии GetContentAsJsonFailed в случае ошибки.

GetDataAsJson

Возвращает данные модели (значения ячеек в существующих строках, без структуры столбцов) в формате JSON. В отличие от GetContentAsJson, функция выполняется синхронно и не запускает отдельный процесс получения данных — результат возвращается сразу при вызове.

GetRowCount

Возвращает количество строк, существующих в таблице на момент вызова функции.

GetRowDataAsJson

Возвращает значения ячеек указанной строки в формате JSON. Результат представляет собой JSON-массив, где порядок элементов соответствует порядку столбцов модели данных.

GetRowsDataAsJson

Возвращает значения ячеек для диапазона строк в формате JSON. Результат представляет собой JSON-массив объектов, где каждый объект содержит номер строки (row) и массив значений её ячеек (data) в порядке столбцов модели.

InsertRow

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

InsertRows

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

RemoveRow

Удаляет указанную строку из таблицы модели данных.

RemoveRows

Удаляет строки из таблицы модели данных.

Reset

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

SetCellData

Задаёт значение указанной ячейке.

SetContentAsJson

Задаёт содержимое модели данных (структуру столбцов и значения всех строк), полностью заменяя текущее содержимое, в формате JSON.

Функция выполняется асинхронно: вызов функции запускает установку данных, а результат обрабатывается в событиях SetContentAsJsonFinished (успешное завершение) и SetContentAsJsonFailed (ошибка).

SetDataAsJson

Задаёт данные модели (значения ячеек в существующих строках, без изменения структуры столбцов) в формате JSON. Функция выполняется синхронно: данные применяются сразу при вызове функции.

SetRowDataAsJson

Задаёт значения ячеек указанной строки в формате JSON. Значения передаются в виде JSON-массива, где порядок элементов соответствует порядку столбцов модели данных.

SetRowsDataAsJson

Задаёт значения ячеек для диапазона строк в формате JSON. Данные передаются в виде JSON-массива объектов, где каждый объект содержит номер строки (row) и массив значений её ячеек (data) в порядке столбцов модели.

События

Событие

Описание

AppendContentAsJsonFailed

Сигнал об ошибке добавления данных в формате JSON в модель.

AppendContentAsJsonFinished

Сигнал о завершении добавления данных в формате JSON в модель.

DataChanged

Изменение содержимого в таблице модели данных.

GetContentAsJsonFailed

Ошибка получения содержимого модели данных (структуры столбцов и значений всех строк) в формате JSON. Событие срабатывает после вызова функции GetContentAsJson, если получить данные не удалось.

GetContentAsJsonFinished

Завершение получения содержимого модели данных (структуры столбцов и значений всех строк) в формате JSON. Событие срабатывает после вызова функции GetContentAsJson при успешном получении данных.

ReadFinished

Завершение чтения данных моделью.

RowsInserted

Вставка строк в таблицу модели данных.

RowsRemoved

Удаление строк из таблицы модели данных.

SetContentAsJsonFailed

Ошибка установки содержимого модели данных (структуры столбцов и значений всех строк) в формате JSON. Событие срабатывает после вызова функции SetContentAsJson, если установить данные не удалось.

SetContentAsJsonFinished

Завершение установки содержимого модели данных (структуры столбцов и значений всех строк) в формате JSON. Событие срабатывает после вызова функции SetContentAsJson при успешном применении данных.