ТаблицаЗначений / ValueTable

Объект для работы с данными в табличном виде. Представляет из себя коллекцию строк с заранее заданной структурой.

Свойства

Колонки / Columns

• Чтение: Да
• Запись: Нет

Тип значения: КоллекцияКолонокТаблицыЗначений

Коллекция колонок

Индексы / Indexes

• Чтение: Да
• Запись: Нет

Тип значения: ИндексыКоллекции

Коллекция индексов

Методы

Количество / Count

Количество строк в Таблице значений

Возвращаемое значение

Число

Добавить / Add

Добавляет строку в конец Таблицы значений

Возвращаемое значение

СтрокаТаблицыЗначений

Вставить / Insert

Вставляет строку в указанную позицию

Параметры

• index: Число - Индекс позиции куда будет произведена вставка. Если индекс вне размера Таблицы значений, строка добавляется в конец

Возвращаемое значение

СтрокаТаблицыЗначений

Удалить / Delete

Удаляет строку

Параметры

• row: СтрокаТаблицыЗначений - Удаляемая строка Число - Индекс удаляемой строки

ЗагрузитьКолонку / LoadColumn

Загружает значения в колонку

Параметры

• values: Массив - Значения для загрузки в колонку
• columnIndex: Строка - Имя колонки для загрузки Число - Индекс колонки для загрузки КолонкаТаблицыЗначений - Колонка для загрузки

ВыгрузитьКолонку / UnloadColumn

Выгружает значения колонки в новый массив

Параметры

• column: Строка - Имя колонки для выгрузки Число - Индекс колонки для выгрузки КолонкаТаблицыЗначений - Колонка для выгрузки

Возвращаемое значение

Массив

ЗаполнитьЗначения / FillValues

Заполнить колонку/колонки указанным значением

Параметры

• value: Произвольный - Устанавливаемое значение
• columnNames: Строка - Список имен колонок для установки значения (разделены запятыми). Если параметр не указан или передана пустая строка, будут заполнены все колонки Необязательный.

Индекс / IndexOf

Получить индекс указанной строки

Параметры

• row: СтрокаТаблицыЗначений - Строка таблицы значений, для которой необходимо определить индекс

Возвращаемое значение

Число - Индекс в коллекции, если не найдено возвращает -1

Итог / Total

Сумма значений всех строк указанной колонки

Параметры

• columnIndex: Строка - Имя колонки для суммирования Число - Индекс колонки для суммирования КолонкаТаблицыЗначений - Колонка для суммирования

Возвращаемое значение

Число

Найти / Find

Осуществляет поиск значения в указанных колонках

Параметры

• value: Произвольный - Искомое значение
• columnNames: Строка - Список имен колонок для поиска значения (разделены запятыми). Если параметр не указан - ищет по всем колонкам. По умолчанию: пустая строка Необязательный.

Возвращаемое значение

СтрокаТаблицыЗначений - если строка найдена, иначе Неопределено

НайтиСтроки / FindRows

Поиск строк по условию

Параметры

• filter: Структура - Условия поиска. Ключ - имя колонки, значение - искомое значение

Возвращаемое значение

Массив - Массив ссылок на строки, удовлетворяющих условию поиска

Очистить / Clear

Удаляет все строки. Структура колонок не меняется.

Получить / Get

Получить строку по индексу

Параметры

• index: Число - Индекс строки

Возвращаемое значение

СтрокаТаблицыЗначений

Свернуть / GroupBy

Сворачиваются (группируются) строки по указанным колонкам измерениям, суммируются колонки ресурсов. Колонки не указанные ни в измерениях ни в ресурсах удаляются.

Параметры

• groupColumnNames: Строка - Имена колонок для сворачивания (изменения), разделены запятыми
• aggregateColumnNames: Строка - Имена колонок для суммирования (ресурсы), разделены запятыми Необязательный.

Сдвинуть / Move

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

Параметры

• row: СтрокаТаблицыЗначений - Строка которую сдвигаем Число - Индекс сдвигаемой строки
• offset: Количество строк, на которое сдвигается строка. Если значение положительное - сдвиг вниз, иначе вверх

СкопироватьКолонки / CopyColumns

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

Параметры

• columnNames: Строка - Имена колонок для копирования, разделены запятыми Если параметр не указан или передана пустая строка, будут скопированы все колонки Необязательный.

Возвращаемое значение

ТаблицаЗначений

Скопировать / Copy

Создает новую таблицу значений с указанными строками и колонками. Если передан отбор - копирует строки удовлетворяющие отбору. Если не указаны строки - будут скопированы все строки. Если не указаны колонки - будут скопированы все колонки. Если не указаны оба параметра - будет создана полная копия таблицы значений.

Параметры

• rows: Массив - Массив строк для отбора Структура - Параметры отбора. Ключ - Колонка, Значение - Значение отбора Необязательный.
• columnNames: Строка - Имена колонок для копирования, разделены запятыми Необязательный.

Возвращаемое значение

ТаблицаЗначений

Сортировать / Sort

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

Параметры

• columns: Строка - Имена колонок для сортировки. После имени колонки, через пробел, можно указать направление сортировки: "Убыв" ("Desc") - по убыванию. Возр" ("Asc") - по возрастанию По умолчанию - по возрастанию.
• comparator: СравнениеЗначений - правила сравнения значений при наличии различных типов данных в колонке. Необязательный.

ВыбратьСтроку / ChooseRow

Не поддерживается

Параметры

• title: Необязательный.
• startRow: Необязательный.

Конструкторы

Основной