При разработке отчетов на базе системы компоновки данных (СКД) разработчики часто сталкиваются с необходимостью использовать встроенные функции выражений, например агрегатную функцию СоединитьСтроки. Однако попытка найти описание этой функции через привычный Синтакс-помощник (по сочетанию клавиш Ctrl + F1) или через его индексный поиск не дает результатов. Разберем, почему так происходит, где именно искать документацию в стандартной справке Конфигуратора и какие инструменты упрощают написание выражений.
Выясним причину такого поведения платформы. Синтакс-помощник 1С предназначен исключительно для документирования конструкций встроенного языка платформы и языка запросов. Язык выражений системы компоновки данных является отдельным специализированным языком со своим синтаксисом и набором встроенных операторов. По этой причине его элементы и агрегатные функции принципиально не включены в индекс Синтакс-помощника.
Рассмотрим, как добраться до нужного раздела встроенной документации. Описание функций доступно через стандартное дерево справки, вызываемое клавишей F1 (без клавиши Ctrl).
Разберем пошаговый путь по оглавлению справки:
В данном разделе подробно описаны две ключевые группы функций: Функции языка выражений (базовые логические, строковые, математические операции) и Агрегатные функции (такие как Сумма, КоличествоРазличных, Массив, СоединитьСтроки).
Также можно воспользоваться контекстным вызовом: если открыть схему компоновки данных, перейти на вкладку вычисляемых полей или ресурсов и нажать F1, откроется справка по текущему элементу схемы, содержащая прямые гиперссылки на синтаксис языка выражений.
Проанализируем работу популярной функции СоединитьСтроки, которую часто ищут в документации. Данная функция относится к группе агрегатных функций и служит для объединения набора строковых значений в одну строку с использованием разделителей.
Синтаксис функции выглядит следующим образом:
СоединитьСтроки(Значение, [РазделительЭлементов], [РазделителиКолонок])
Рассмотрим основные правила её использования:
Массив()). Второй параметр задает разделитель между элементами (по умолчанию — символ перевода строки).Если возможностей встроенных функций СКД недостаточно для реализации алгоритма, платформа позволяет обращаться к собственным методам конфигурации напрямую из полей выражений по следующему шаблону:
ИмяМодуля.ИмяФункции(Параметры)
При реализации таких вызовов важно учитывать следующие платформенные ограничения:
Экспорт.В стандартном Конфигураторе для выражений СКД контекстная подсказка (автодополнение синтаксиса) не предусмотрена. Для ускорения написания сложных выражений разработчики используют альтернативные решения: