Руководство разработчика

Метод ОТЧЕТ.СОРТИРОВКА

Метод СОРТИРОВКА позволяет отсортировать данные текущего уровня отчета по тексту в указанных столбцах или по значениям дополнительных атрибутов сортировки. Возможна также сортировка по именам строк – в этом случае в качестве имени столбца необходимо указать пустую строку.

Выбор способа сортировки выполняется методом УСТ_СТАБ_СОРТ. Стабильная сортировка сохраняет относительный порядок строк, равно удовлетворяющих условию сортировки. Нестабильная сортировка более быстрая, но порядок эквивалентных строк не определен.

ФУНКЦИЯ ЛОГИКА: СОРТИРОВКА(СОРТ_ОТЧЕТ: столбцы)

Параметры

столбцы
Условия сортировки по указанным столбцам.

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

ДА – в случае успешной сортировки, НЕТ – в случае ошибки.

Метод не производит обновления данных отчета, соответственно, для отображения результатов необходимо вызвать метод ОБНОВИТЬ.

Пример

// сортировка по возрастанию в столбце со значениям цен
ТИП Отчет(ОТЧЕТ)
[
  ...
  ФУНКЦИЯ Сортировка
    парам_сорт.столбцы[5].столбец = "цена"
    парам_сорт.столбцы[5].убыв = НЕТ
    СОРТИРОВКА(парам_сорт)
  КОНЕЦ_ФУНКЦИИ
  ...
]

При наличии межстрочных (вертикальных) объединений в сортировке участвуют только верхние строки объединенного блока. Значения в столбцах и дополнительных атрибутах для подстрок игнорируются. Это позволяет сохранить структуру вертикальных объединений при сортировке.


См. также: