Документация

README.md

@@ -26,6 +26,7 @@
   * <a href="#entity-create">Создание и сохранение сущностей</a>
   * <a href="#entity-read">Чтение и поиск объектов</a>
     * <a href="#entity-complex-find">Поиск сущностей со сложными отборами</a>
+    * <a href="#entity-sort">Сортировка результатов</a>
   * <a href="#entity-delete">Удаление сущностей</a>
   * <a href="#entity-active-record">Активная запись</a>
   * <a href="#entity-repository">Работа через ХранилищеСущностей</a>
@@ -190,12 +191,11 @@
 
 Метод `ПолучитьОдно()` возвращает одну (первую попавшуюся) сущность или `Неопределено`, если найти сущность не удалось.
 
-Оба метода в качестве второго параметра могут принимать в себя условия отбора в следующих видах:
+Оба метода в качестве второго параметра могут принимать в себя условия поиска в следующих видах:
 
 * `Неопределено` (параметр не заполнен) - поиск без отборов;
 * `Соответствие` - пары ИмяПоля-ЗначениеПоля, используемые как отбор по "равно";
-* `ЭлементОтбора` - объект типа "ЭлементОтбора", позволяющий использовать более сложные условия, например, с видом сравнения "БольшеИлиРавно";
-* `Массив` - массив с элементами типа "ЭлементОтбора", позволяющий использовать сложные условия отбора, соединяемые через логическое `И`.
+* `ОпцииПоиска` - объект типа "ОпцииПоиска", позволяющий использовать сложные условия отбора и сортировки.
 
 ### Поиск сущностей с простыми отборами
 
@@ -235,15 +235,34 @@
 
 ```bsl
 // Найдем всех физических лиц, у которых дата рождения больше, чем 01.01.1990.
-ЭлементОтбора = Новый ЭлементОтбора("ДатаРождения", ВидСравнения.БольшеИлиРавно, Дата(1990, 1, 1));
-НайденныеФизЛица = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ЭлементОтбора);
+ОпцииПоиска = Новый ОпцииПоиска;
+ОпцииПоиска.Отбор("ДатаРождения", ВидСравнения.БольшеИлиРавно, Дата(1990, 1, 1));
+
+НайденныеФизЛица = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ОпцииПоиска);
 
 // Найдем всех физических лиц, рожденных в 90-ые.
-МассивОтборов = Новый Массив;
-МассивОтборов.Добавить(Новый ЭлементОтбора("ДатаРождения", ВидСравнения.БольшеИлиРавно, Дата(1990, 1, 1)));
-МассивОтборов.Добавить(Новый ЭлементОтбора("ДатаРождения", ВидСравнения.Меньше, Дата(2000, 1, 1)));
+ОпцииПоиска = Новый ОпцииПоиска()
+  .Отбор("ДатаРождения", ВидСравнения.БольшеИлиРавно, Дата(1990, 1, 1))
+  .Отбор("ДатаРождения", ВидСравнения.Меньше, Дата(2000, 1, 1));
+
+ДетиДевяностых = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ОпцииПоиска);
+```
+
+<a id="entity-sort" />
+
+### Сортировка результатов
+
+```bsl
+
+// Найдем всех физических лиц, у которых дата рождения больше, чем 01.01.1990
+// и отсортируем результат по дате рождения в порядке убывания.
+
+ОпцииПоиска = Новый ОпцииПоиска()
+  .Отбор("ДатаРождения", ВидСравнения.БольшеИлиРавно, Дата(1990, 1, 1))
+  .СортироватьПо("ДатаРождения", НаправлениеСортировки.ПоУбыванию);
+
+ДетиДевяностыхПоВозрасту = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), ОпцииПоиска);
 
-ДетиДевяностых = МенеджерСущностей.Получить(Тип("ФизическоеЛицо"), МассивОтборов);
 ```
 
 <a id="entity-delete" />
@@ -558,6 +577,7 @@
     * [`МодельДанных`](src/Классы/МодельДанных.os),
     * [`ОбъектМодели`](src/Классы/ОбъектМодели.os),
     * [`ЭлементОтбора`](src/Классы/ЭлементОтбора.os);
+    * [`ЭлементПорядка`](src/Классы/ЭлементПорядка.os);
   * значения модулей-перечислений:
     * [`ТипыКолонок`](src/Модули/ТипыКолонок.os),
     * [`ТипыПодчиненныхТаблиц`](src/Модули/ТипыПодчиненныхТаблиц.os),
@@ -570,6 +590,7 @@
     * [`МодельДанных`](src/Классы/МодельДанных.os),
     * [`ОбъектМодели`](src/Классы/ОбъектМодели.os),
     * [`ЭлементОтбора`](src/Классы/ЭлементОтбора.os);
+    * [`ЭлементПорядка`](src/Классы/ЭлементПорядка.os);
   * значения модулей-перечислений:
     * [`ТипыКолонок`](src/Модули/ТипыКолонок.os),
     * [`ТипыПодчиненныхТаблиц`](src/Модули/ТипыПодчиненныхТаблиц.os),

docs/README.md

@@ -9,6 +9,8 @@
 * [КоннекторJSON](КоннекторJSON.md)
 * [МодельДанных](МодельДанных.md)
 * [ОбъектМодели](ОбъектМодели.md)
+* [ЭлементОтбора](ЭлементОтбора.md)
+* [ЭлементПорядка](ЭлементПорядка.md)
 
 ### Перечисления