Метод ЖУРНАЛ.НАБОР_КОРТЕЖЕЙ
Метод НАБОР_КОРТЕЖЕЙ позволяет получить набор всех комбинаций значений (кортежей) указанных признаков или фиксированных полей операции. Метод работает со значениями стандартных типов, типа ССЫЛКА и типа ДАТА_ВРЕМЯ. Множество перебираемых операций можно ограничить условиями фильтра.
ФУНКЦИЯ ЛОГИКА: НАБОР_КОРТЕЖЕЙ(КЛЮЧ_СВОЙСТВА[]: cвойства; ФИЛЬТР: фильтр; ПЕРЕМ АЛГ_МАССИВ: список; ЛОГИКА: имена = НЕТ)
Параметры
- cвойства
- :
Список имен и типов признаков, комбинации которых следует искать.
Тип свойства задается константами ТСВ_....
В качестве имени признака может указываться комбинация имени табличного признака и колонки, идентификатор фиксированного поля операции (ФКЛЮЧ_...)
<имя признака> <имя табличного признака>.<имя колонки> ФКЛЮЧ_ДАТА – дата-время операции; ФКЛЮЧ_ДЕБЕТ – дебет в проводках операции; ФКЛЮЧ_КРЕДИТ – кредит в проводках операции; ФКЛЮЧ_ЕДИНИЦЫ – единицы в проводках операции; ФКЛЮЧ_КОЛИЧЕСТВО – количество в проводках операции; ФКЛЮЧ_КОММЕНТАРИЙ – комментарий операции; ФКЛЮЧ_ДОКУМЕНТ – документ операции; ФКЛЮЧ_ВЛАДЕЛЕЦ – числовой идентификатор владельца операции; ФКЛЮЧ_ГРУППА – числовой идентификатор группы доступа операции. - фильтр
- Условия фильтра.
- список
- Выходной параметр. Ссылка на переменную, которой будет присвоен полученный список комбинаций.
- имена
- Необязательный параметр, управляющий тем, в каком виде будут помещены найденные комбинации значений в параметр список:
- НЕТ – комбинация значений представляется объектом типа АЛГ_МАССИВ, в котором позиция значения соответствует порядку в параметре свойства. Это наиболее компактное представления результатов поиска (в смысле занимаемой памяти).
- ДА – комбинация значений представляется объектом типа АЛГ_ПАРАМ, в котором содержатся имена свойств в качестве ключей. Это более удобное представление, т.к. обращаться к значениям каждой комбинации можно по имени.
Возвращаемое значение
ДА – в случае успешного выполнения, НЕТ – в противном случае.
Обрабатывать результат можно с помощью функции ПОСЛ_ОШИБКА.
Замечание: для фиксированных полей операции необходимо задавать правильные типы:
ТСВ_ДАТА | – | для ФКЛЮЧ_ДАТА (но параметр список заполняется значениями типа ДАТА_ВРЕМЯ); |
ТСВ_ССЫЛКА | – | для ФКЛЮЧ_ДЕБЕТ, ФКЛЮЧ_КРЕДИТ и ФКЛЮЧ_ЕДИНИЦЫ; |
ТСВ_ЧИСЛО | – | для ФКЛЮЧ_КОЛИЧЕСТВО; |
ТСВ_ЦЕЛОЕ | – | для ФКЛЮЧ_ВЛАДЕЛЕЦ и ФКЛЮЧ_ГРУППА. |
ТСВ_СТРОКА | – | для ФКЛЮЧ_КОММЕНТАРИЙ и ФКЛЮЧ_ДОКУМЕНТ; |