Добавить отбор построителя

Возвращает новый элемент отбора построителя

// Возвращает новый элемент отбора построителя
// Источник: https://github.com/SeiOkami/CollectionMethodsOneS/issues/17
// 
// Параметры:
//  Построитель    - ПостроительЗапроса, ПостроительОтчета - Построитель, в которой необходимо добавить элемент отбора
//  ПолеОтбора     - Строка - Имя поля отбора
//  ЗначениеОтбора - Произвольный
//                 - Массив из Произвольный
//                 - ФиксированныйМассив из Произвольный
//  ВидОтбора      - Строка, ВидСравнения - Вид сравнения отбор в виде строки
//                 Если Неопределено, то для списков будет ВСписке, а для остальных Равно
//
// Возвращаемое значение:
//   ЭлементОтбора
//   
// Пример:
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Код", "123");
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Номер", 1, "Больше");
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Ссылка", МассивСсылок);
//   
Функция Построитель_ДобавитьОтбор(Знач Построитель, Знач ПолеОтбора, Знач ЗначениеОтбора, Знач ВидОтбора = Неопределено) Экспорт
	
    ЭлементОтбора = Построитель.Отбор.Добавить(ПолеОтбора);
    ЭлементОтбора.Использование = Истина;
	
	Если ТипЗнч(ЗначениеОтбора) = Тип("Массив") 
		ИЛИ ТипЗнч(ЗначениеОтбора) = Тип("ФиксированныйМассив") Тогда
		УстанавливаемоеЗначение = Новый СписокЗначений; //СписокЗначений из Неопределено
		Для Каждого Значение Из ЗначениеОтбора Цикл
			УстанавливаемоеЗначение.Добавить(Значение);
		КонецЦикла;
		ЭтоСписок = Истина;
	Иначе
		 УстанавливаемоеЗначение = ЗначениеОтбора; //@skip-check statement-type-change
		 ЭтоСписок = (ТипЗнч(ЗначениеОтбора) = Тип("СписокЗначений"));
	КонецЕсли;
	
	Если ВидОтбора = Неопределено Тогда
		ЭлементОтбора.ВидСравнения = ?(ЭтоСписок, ВидСравнения.ВСписке, ВидСравнения.Равно);
	ИначеЕсли ТипЗнч(ВидОтбора) = Тип("ВидСравнения") Тогда
		ЭлементОтбора.ВидСравнения = ВидОтбора;
	Иначе
		ЭлементОтбора.ВидСравнения = ВидСравнения[Строка(ВидОтбора)]; //@skip-check statement-type-change
	КонецЕсли;
	
	ЭлементОтбора.Значение = УстанавливаемоеЗначение;
	
	Возврат ЭлементОтбора;
	
КонецФункции

// Возвращает новый элемент отбора построителя
// Источник: https://github.com/SeiOkami/CollectionMethodsOneS/issues/17
// 
// Параметры:
//  Построитель    - ПостроительЗапроса, ПостроительОтчета - Построитель, в которой необходимо добавить элемент отбора
//  ПолеОтбора     - Строка - Имя поля отбора
//  ЗначениеОтбора - Произвольный
//                 - Массив из Произвольный
//                 - ФиксированныйМассив из Произвольный
//  ВидОтбора      - Строка, ВидСравнения - Вид сравнения отбор в виде строки
//                 Если Неопределено, то для списков будет ВСписке, а для остальных Равно
//
// Возвращаемое значение:
//   ЭлементОтбора
//   
// Пример:
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Код", "123");
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Номер", 1, "Больше");
// 	ЭлементОтбора = Построитель_ДобавитьОтбор(Построитель, "Ссылка", МассивСсылок);
//   
Функция Построитель_ДобавитьОтбор(Знач Построитель, Знач ПолеОтбора, Знач ЗначениеОтбора, Знач ВидОтбора = Неопределено) Экспорт
	
    ЭлементОтбора = Построитель.Отбор.Добавить(ПолеОтбора);
    ЭлементОтбора.Использование = Истина;
	
	Если ТипЗнч(ЗначениеОтбора) = Тип("Массив") 
		ИЛИ ТипЗнч(ЗначениеОтбора) = Тип("ФиксированныйМассив") Тогда
		УстанавливаемоеЗначение = Новый СписокЗначений; //СписокЗначений из Неопределено
		Для Каждого Значение Из ЗначениеОтбора Цикл
			УстанавливаемоеЗначение.Добавить(Значение);
		КонецЦикла;
		ЭтоСписок = Истина;
	Иначе
		 УстанавливаемоеЗначение = ЗначениеОтбора; //@skip-check statement-type-change
		 ЭтоСписок = (ТипЗнч(ЗначениеОтбора) = Тип("СписокЗначений"));
	КонецЕсли;
	
	Если ВидОтбора = Неопределено Тогда
		ЭлементОтбора.ВидСравнения = ?(ЭтоСписок, ВидСравнения.ВСписке, ВидСравнения.Равно);
	ИначеЕсли ТипЗнч(ВидОтбора) = Тип("ВидСравнения") Тогда
		ЭлементОтбора.ВидСравнения = ВидОтбора;
	Иначе
		ЭлементОтбора.ВидСравнения = ВидСравнения[Строка(ВидОтбора)]; //@skip-check statement-type-change
	КонецЕсли;
	
	ЭлементОтбора.Значение = УстанавливаемоеЗначение;
	
	Возврат ЭлементОтбора;
	
КонецФункции