Электронная таблица

Компонент Электронная таблица предоставляет интерактивный интерфейс для просмотра и редактирования данных электронной таблицы в инструментальных панелях.

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

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

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

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

Сессия таблицы

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

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

Ячейки и диапазоны

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

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

Структура ячейки

Ячейка электронной таблицы может содержать несколько независимых слоев информации.

Слой

Описание

Значение или Ошибка

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

Выражение

Выражение — это формула электронной таблицы, используемая для вычисления значения ячейки.
Выражения могут ссылаться на другие ячейки (с использованием нотации A1), функции и данные платформы через синтаксис стандартных ссылок.

Формат

Формат, примененный к значению ячейки.

Стиль

Визуальный стиль ячейки.

Комментарии

Пользовательские комментарии, прикрепленные к ячейке.

Различные функции электронной таблицы изменяют разные слои ячейки.

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

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

Пример: sum(A1, B1)

Общие переменные (Свойства)

[?]

Компонент Электронная таблица имеет следующие основные свойства и группы свойств, общие для всех компонентов:

Имя, Дополнительные свойства, Свойства контейнера, Стили, Прелоадер, События, Привязки, Кебаб меню.

Наследуемые переменные (Свойства)

Компонент Электронная таблица внутренне основан на компоненте Таблица данных, поэтому он наследует его общие свойства.

Пользовательские переменные (Свойства)

Электронная таблица

Это свойство определяет параметры электронной таблицы, управляемой данным компонентом.

Название переменной:

spreadsheetParameters

Записи:

1

Формат записи:

Имя поля

Тип поля

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

modelContextPath

String

Путь к контексту модели, в котором хранится таблица.

name

String

Название таблицы.

ranges

Data Table

Определяет диапазоны электронной таблицы.

savingMode

Integer (0 по умолчанию)

Определяет способ сохранения изменений в электронной таблице.

Поддерживаемые значения:

0 — При каждом изменении;

1 — Вручную;

2 — Отключено.

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

evaluateOnOpen

Boolean

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

nameSuffix

String (virtual по умолчанию)

Суффикс, добавляемый к имени электронной таблицы, когда savingMode установлен 2 (Отключено).

concurrentEditing

Boolean

Указывает, могут ли несколько пользователей одновременно редактировать электронную таблицу.

Максимальный уровень прав

Это свойство определяет максимальный уровень прав доступа, доступный в компоненте Электронная таблица. Если у пользователя в системе установлен более высокий уровень прав доступа, то эффективный уровень прав доступа в компоненте Электронная таблица ограничивается этим значением, и доступными остаются только те операции, которые разрешены данным эффективным уровнем.

Название переменной:

maximumPermissionLevel

Записи:

1

Формат записи:

Имя поля

Тип поля

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

maximumPermissionLevel

String

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

Выбранные диапазоны

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

Название переменной:

selectedRanges

Записи:

0…Не ограничено количество

Формат записи:

Имя поля

Тип поля

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

startRowIndex

Integer

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

endRowIndex

Integer

Определяет индекс (с нулевой отсчёткой) последней строки в выбранном диапазоне.

startColumnIndex

Integer

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

endColumnIndex

Integer

Определяет индекс (с нулевой отсчёткой) последнего столбца в выбранном диапазоне.

LazyLoad

Включает режим отложенной загрузки. Когда режим включен, данные электронной таблицы загружаются по запросу, а не все сразу при открытии компонента. Это может повысить производительность при работе с большими таблицами.

Название переменной:

lazyLoad

Записи:

1

Формат записи:

Имя поля

Тип поля

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

lazyLoad

Boolean

Включает или отключает режим отложенной загрузки.

Was this page helpful?