Каждый начинающий разработчик в среде 1С:Предприятие рано или поздно сталкивается с ситуацией, когда конфигуратор внезапно «забывает» доступные методы объекта. Вы ставите точку после имени переменной, ожидая увидеть привычный список доступных функций и свойств (например, метод Найти() или Количество() для массива), но всплывающее меню контекстной подсказки так и не появляется.
В этой статье мы подробно разберем, почему возникает эта проблема, как устроена динамическая типизация во встроенном языке 1С, и рассмотрим профессиональные приемы (лайфхаки), которые заставят конфигуратор стабильно показывать автодополнение в любых процедурах и функциях.
Для начала проанализируем ситуацию, с которой столкнулся автор темы на форуме. Разработчик создал процедуру получения дат и попытался передать полученный массив в другую процедуру для поиска выходных дней. При написании кода внутри второй процедуры после ввода точки у переменной не появлялся метод Найти(). Автор предположил, что метод «не вызывается» или «не работает».
На самом деле, как справедливо отметили участники обсуждения, сам метод прекрасно вызывался и выполнялся платформой без ошибок. Проблема заключалась исключительно в отсутствии контекстной подсказки в редакторе кода.
Причина этого кроется в фундаментальном свойстве встроенного языка 1С — динамической типизации. В отличие от языков со строгой статической типизацией (таких как C# или Java), в 1С тип переменной определяется не в момент написания кода (компиляции), а непосредственно в момент выполнения программы (в рантайме).
Когда вы передаете переменную в качестве параметра процедуры:
Процедура ПолучитьВыходные(ВсеДаты_2021Года)
// Здесь конфигуратор не знает, что находится внутри ВсеДаты_2021Года
// Это может быть Число, Строка, СправочникСсылка или Массив
КонецПроцедуры
Парсер конфигуратора, анализирующий текст модуля, видит лишь имя переменной ВсеДаты_2021Года. Поскольку тип этой переменной явно нигде в рамках данной процедуры не объявлен, редактор кода не может «догадаться», список каких именно методов вам предложить. Соответственно, контекстное автодополнение отключается.
На форумах часто предлагают сомнительные решения. Например, сделать переменную глобальной (экспортной) на уровне модуля или инициализировать её во внепроцедурном пространстве. Рассмотрим, почему так делать не стоит, и разберем профессиональные стандарты разработки.
Антипаттерн: Глобальные переменные
Использование экспортных переменных модуля (объявляемых с ключевым словом Экспорт в начале модуля) засоряет оперативную память и нарушает важнейший принцип программирования — модульность. Код становится запутанным, его сложно тестировать и поддерживать. Конфигуратор может начать выдавать подсказки, но качество вашего кода сильно пострадает.
Правильный подход: Помочь конфигуратору распознать тип
Существует несколько абсолютно безопасных и соответствующих стандартам разработки 1С способов вернуть контекстную подсказку в процедурах.
Начиная с современных версий платформы 8.3, конфигуратор умеет выполнять статический анализ типов на основе специальных документирующих комментариев, расположенных перед объявлением процедуры или функции. Если вы правильно опишете входящие параметры, автодополнение внутри процедуры заработает автоматически.
Рассмотрим пример правильного оформления процедуры:
// Находит и выводит выходные дни за определенный период.
//
// Параметры:
// ВсеДаты_2021Года - Массив - список дат для анализа.
//
Процедура ПолучитьВыходные(ВсеДаты_2021Года)
// Теперь здесь, если написать "ВсеДаты_2021Года.",
// конфигуратор отобразит весь список методов класса Массив, включая Найти()
Индекс = ВсеДаты_2021Года.Найти(ТекущаяДата());
КонецПроцедуры
Чтобы не писать такие комментарии вручную, в конфигураторе предусмотрен удобный инструмент автоматизации. Нажмите правой кнопкой мыши на имя процедуры (в строке объявления) и выберите в контекстном меню Рефакторинг -> Создать описание процедуры. Платформа сама сформирует шаблон комментария, вам останется лишь указать тип данных (в нашем примере — Массив) через дефис после имени параметра.
Если по каким-то причинам вы не хотите писать документирующие комментарии, или переменная создается динамически внутри сложного алгоритма без передачи через параметры, можно использовать классический «хак» разработчиков 1С.
Мы можем временно или постоянно прописать явную инициализацию переменной внутри блока, который заведомо никогда не будет выполнен на этапе работы программы:
Если Ложь Тогда
ВсеДаты_2021Года = Новый Массив; // Подсказка для парсера конфигуратора
КонецЕсли;
// Дальнейший рабочий код процедуры...
// Теперь конфигуратор считает, что ВсеДаты_2021Года имеет тип "Массив"
При выполнении программы этот блок Если Ложь Тогда... будет полностью проигнорирован процессором платформы, что гарантирует отсутствие просадок производительности. Однако синтаксический анализатор редактора кода прочитает эту строку, запомнит тип переменной и начнет без проблем выдавать контекстное меню автодополнения во всем нижеследующем коде процедуры.
Этот способ аналогичен предыдущему «хаку», но выглядит более профессионально и эстетично. Мы используем директиву препроцессора, которая отсекает код еще на этапе компиляции модуля:
#Если Неопределено Тогда
ВсеДаты_2021Года = Новый Массив;
#КонецЕсли
Этот фрагмент кода физически не попадет в скомпилированный бинарный исполняемый код ни на сервере, ни на клиенте. Он существует исключительно для парсера среды разработки (Конфигуратора), помогая ему восстановить типы данных ваших переменных.
Если вы хотите навсегда забыть о проблемах с типизацией и отсутствием подсказок, рассмотрите возможность перехода с классического конфигуратора на современную среду разработки 1C:EDT (Enterprise Development Tools), созданную на базе Eclipse.
1C:EDT обладает на порядок более мощным механизмом статического анализа кода. В этой среде реализована поддержка аннотаций JSDoc-like прямо в комментариях кода, а также поддерживается строгая типизация с помощью директивы //@strict-types в начале модуля. В EDT вам практически никогда не придется использовать искусственные «хаки» вроде блока Если Ложь.
Разбирая задачу поиска элементов в массиве, новичкам крайне важно понимать внутреннюю логику работы самого метода Найти() во избежание логических ошибок в коде.
Проанализируем ключевые особенности этого метода:
Массив.Найти(<ЗначениеПоиска>) возвращает числовой индекс найденного элемента (индексация элементов в массиве 1С начинается с 0). Если элемент в массиве отсутствует, метод возвращает системное значение Неопределено.Давайте посмотрим на пример некорректного кода:
// ПРИМЕР С ОШИБКОЙ!
ИскомаяДата = НачалоДня(ТекущаяДата());
Если ВсеДаты_2021Года.Найти(ИскомаяДата) Тогда
// Данный код отработает неверно или вызовет ошибку приведения типов
КонецЕсли;
Выясним причину ошибки: предположим, искомая дата находится в самом начале нашего массива. В этом случае метод Найти() вернет число 0 (индекс первого элемента). Платформа попытается вычислить условие Если 0 Тогда. В отличие от некоторых других языков программирования, в 1С число 0 не приводится к логическому значению Ложь автоматически во всех контекстах, что приведет к ошибке выполнения "Преобразование значения к типу Булево не может быть выполнено".
Чтобы написать этот код правильно и надежно, всегда сравнивайте результат работы метода с Неопределено:
// ПРАВИЛЬНЫЙ ВАРИАНТ
ИскомаяДата = НачалоДня(ТекущаяДата());
Если ВсеДаты_2021Года.Найти(ИскомаяДата) <> Неопределено Тогда
// Элемент гарантированно найден в массиве
// Можно безопасно выполнять алгоритм обработки
КонецЕсли;
В современных версиях платформы 1С:Предприятие 8.3 у объекта типа Массив появился гораздо более удобный и лаконичный метод — Содержит().
Этот метод избавляет разработчика от необходимости писать конструкции сравнения с Неопределено. Метод сразу возвращает логическое значение Истина, если переданный элемент присутствует в коллекции, и Ложь в противном случае.
Рассмотрим пример использования:
// СОВРЕМЕННЫЙ И БЕЗОПАСНЫЙ ВАРИАНТ
ИскомаяДата = НачалоДня(ТекущаяДата());
Если ВсеДаты_2021Года.Содержит(ИскомаяДата) Тогда
// Лаконично, понятно и исключает любые ошибки приведения типов
КонецЕсли;
Использование метода Содержит() делает ваш код более читаемым, чистым и современным, полностью соответствуя актуальным стандартам разработки фирмы "1С".
Подведем итоги нашего разбора. Если у вас в конфигураторе пропало автодополнение при работе с коллекциями (массивами, соответствиями, таблицами значений):
Если Ложь Тогда ... КонецЕсли.Содержит() вместо старого метода Найти(), чтобы избежать скрытых багов с нулевым индексом.