Скд что это такое расшифровка
Расшифровка в 1С в отчете на СКД (системе компоновки данных)
В сформированном отчете 1С на СКД существует возможность двойным кликом мыши на ячейку вызвать всплывающее окно расшифровки с набором определенных действий. К таким действиям относятся:
Наибольший интерес вызывает открытие по расшифровке в 1С другого отчета 1С с параметром, содержащемся в выбранной ячейке. Но и другие действия будут доступны.
Начнем с того, что нужно вызвать событие обработки расшифровки в свойствах управляемой формы СКД. Сейчас те, кто работал на 7-ке, возможно, ужаснутся, так как лично для меня это было жутко нелогично. В 8-ке все гораздо прозаичней. Нужно создать основную форму, затем перейти на нее и открыть свойства реквизита «Результат»:
Обращу внимание, что реквизит «Результат» появляется только после того, как создана «ОсновнаяСхемаКомпоновкиДанных», и при создании формы установлены следующие флажки:
Я сразу приведу текст процедур и функций для организации расшифровок на СКД в 1С, а пояснения буду давать в комментариях. Читать на сайте код достаточно сложно, поэтому Вы можете скачать этот отчет и читать код в конфигураторе 1С 8.3. А результат работы отчета можно увидеть под этим кодом:
Если РасшифрЗначение = Неопределено Тогда Возврат ; КонецЕсли ;
СтандартнаяОбработка = Ложь ;
// Прописываем доступные действия. Если какое-то действие не указать,
//оно не будет доступно пользователю
ДопПункты = Новый СписокЗначений ;
ОбщСтрока = «Открыть отчет Расчеты с поставщиками «
+ «» «» + Строка ( ТипЗнч ( РасшифрЗначение ) )
+ » = « + РасшифрЗначение + «» «» ;
Результат проделанной работы:
Это наш простенький отчет с уже открытой расшифровкой.
После выбора нужной позиции откроется отчет «Ведомость расчетов с поставщиками»:
У меня данных в этом отчете нет, но видно, что параметры формирования передались правильно.
Если Вы начинаете изучать 1С программирование, рекомендуем наш бесплатный курс (не забудьте подписаться на YouTube — регулярно выходят новые видео):
К сожалению, мы физически не можем проконсультировать бесплатно всех желающих, но наша команда будет рада оказать услуги по внедрению и обслуживанию 1С. Более подробно о наших услугах можно узнать на странице Услуги 1С или просто позвоните по телефону +7 (499) 350 29 00. Мы работаем в Москве и области.
Расшифровка в 1С СКД
При разработке отчетов в 1С достаточно часто требуется такая функция как Расшифровка 1С СКД. Обычно под расшифровкой понимается формирование такого же отчета с установленными отборами с дополнительной (более подробной) группировкой.
В том числе такая возможность имеется и в отчетах, созданных с помощью 1С СКД. При этом функционал расшифровки является встроенным и позволяет выполнять пользователю различные действия, без приложения дополнительных усилий со стороны программиста. То есть при создании отчета на СКД программисту достаточно настроить только схему компоновки – без дополнительного кода в модуле отчета и без добавления форм отчета.
Стандартные возможности расшифровки 1С СКД
В пользовательском режиме расшифровку отчета можно вызвать двумя способами:
Какие действия доступны при выполнении расшифровки:
Что еще можно сделать с расшифровкой без программирования? В расшифровку попадают значения полей из наборов данных. Иногда возникает необходимость в отчет вывести одно значение, но в качестве расшифровки должно выступать другое поле. Например, регистратор можно выводить как номер, но необходимо, чтобы при клике по нему открывался документ. Это можно сделать без дополнительного программирования – через установку выражения представления
При такой настройке в расшифровке везде будет использоваться ссылка на документ, но в отчете будет выводиться только его номер.
Дальше мы будем рассматривать все более сложные ситуации при разработке отчета на СКД. Например, вам может понадобиться добавить свою форму в отчет – добавить какие-то дополнительные команды, настроить более сложный интерфейс для пользователя.
При добавлении новой формы отчета система производит сама настройку формы для использования совместно с СКД. В том числе добавляется реквизит «ДанныеРасшифровки» с типом «Строка». И в свойствах формы производится связь атрибута «Данные расшифровки» с созданным реквизитом.
Если вы добавляете форму отчета самостоятельно – например, как произвольную или копируете форму из какого-то другого объекта, для правильной работы расшифровки вам необходимо добавить реквизит и настроить его связь, как описано выше.
Расшифровка при программном выполнении 1С СКД
При разработке отчета на СКД вам иногда может понадобиться выполнять программного выполнения. Например, всегда – при использовании внешних наборов данных. Например, в ситуации, когда в отчете есть больше чем одна схема компоновки.
В этом случае, для правильной работы расшифровки, необходимо в модуле объекта отчета в процедуре ПриКомпоновкеРезультата передавать параметр процедуры «ДанныеРасшифровки» в два места кода программного выполнения СКД:
Макеты и расшифровка 1С СКД
Следующий этап в разработке отчета на СКД, где вы столкнетесь с расшифровкой это использование собственных макетов. Если в схеме не указаны макеты, то платформа генерирует макеты для полей самостоятельно и самостоятельно настраивает их для правильно работы расшифровки. Если вы добавили свой макет, то вы должны дополнительно настроить работу расшифровки в нем.
Рассмотрим настройку простого отчета по регистру оборотов «Продажи»
В схеме добавлено два макета группировки
Если сформировать отчет и навести курсор на группировку «Контрагент», то курсор меняется на «лупу с крестиком» — расшифровка доступна. Если навести курсор на группировки «Номенклатура» или «Детали», расшифровка недоступна.
Макет для группировки «Номенклатура» выглядит следующим образом
Для ячейки макета «Номенклатура» определим свойство «ПараметрРасшифровки»
Назвать параметр расшифровки нужно отлично от свойства «Параметр», тогда в параметрах макета добавится наш параметр расшифровки:
Зайдем здесь в редактирование поля «Выражение», определим основное действие. Например, «Расшифровать»:
Теперь это действие будет выполняться по умолчанию при клике ЛКМ, при клике ПКМ доступно меню всех действий расшифровки. Для остальных ячеек (Количество, Сумма) зададим такое же название параметра расшифровки. В этом случае расшифровка будет действовать одинаково для всех ячеек в группировке.
В окне редактирования параметра расшифровки мы можем также переопределить значения полей набора, которые будут использоваться для расшифровки. Например, для поля «Номенклатуры» можно указать выражение «Контрагент» и при открытии значения будет открываться карточка контрагента:
Мы разобрали уже немало вариантов применения расшифровки в СКД, но до сих пор не написали ни одной (ну или почти ни одной) строчки кода. В следующей главе рассмотрим ситуации, когда для обработки расшифровки необходимо написать программный код.
Произвольная обработка расшифровки 1С СКД
Когда может понадобиться произвольная обработка расшифровки? Например, если результат отчета вам нужно расшифровать этим же отчетом, но с другими настройками, с другим макетом, выполнить расшифровку другим отчетом, выполнить какую-то обработку и т.п.
Для реализации произвольной расшифровки служит событие «ОбработкаРасшифровки» у табличного документа и обработчик «ОбработкаДополнительнойРасшифровки». Первой событие вызывается по ЛКМ, второй при клике ПКМ.
Заголовок обоих обработчиков выглядит одинаково. Здесь и далее будем рассматривать работу расшифровки для управляемых форм:
Нас будут интересовать параметры: «Расшифровка» — в этом параметре указывается идентификатор расшифровки, в параметре «СтандартнаяОбработка» указываем «Истина», если нужно выполнить стандартный алгоритм расшифровки, «Ложь» если мы реализуем произвольную расшифровку.
Здесь используется функция общего модуля «ПолучитьМассивПолейРасшифровки», которая кроме текущего значения параметра расшифровки получается значения родительский полей и значения установленных отборов:
В итоге мы получаем массив элементов с типом «ЭлементОтбораКомпоновкиДанных» или «ЗначениеПоляРасшифровкиКомпоновкиДанных», эти значения мы уже можем передать в другой отчет или в обработку.
В этом нам может помочь объекта с типом «ОбработкаРасшифровкиКомпоновкиДанных». В обработчике «ОбработкаРасшифровки» мы можем написать такой код:
Здесь с помощью реквизита «ДанныеРасшифровки» и источника доступных настроек, полученного из компоновщика настроек нашего отчета мы получаем объект указанного типа. Далее мы вызываем метод объекта «ПоказатьВыборДействия», в который передаем нужные нам типовые действия и список наших действие в виде дополнительных пунктов.
В обработке выбранного действия мы производится собственно действия по расшифровке:
В этом примере видно, что типовые действия такие как расшифровка, упорядочить можно выполнить с помощью объекта типа «ОписаниеОбработкиРасшифровкиКомпоновкиДанных», который мы передаем в новую форму нашего отчета. Можно выполнить расшифровку в текущей форме. Для этого используется метод «ПрименитьНастройки» объекта «ОбработкаРасшифровкиКомпоновкиДанных», который возвращает итоговые настройки. Далее мы загружаем эти настройки в компоновщик и выполняем отчет:
Можно эти настройки получать также с помощью таких методов объекта «ОбработкаРасшифровкиКомпоновкиДанных» как: Упорядочить, Расшифровать, Сгруппировать, Отфильтровать.
10 примеров программной работы с расшифровкой отчетов на СКД
Хороший отчет, который не просто что-то показывает пользователю, но и позволяет сразу что-то с этим сделать – может стать его ключевым рабочим инструментом.
Кликнул в ячейку, сказал “Выровнять” – и 1С сама:
1. нашла или создала документ перемещения
2. добавила в него эту номенклатуру в количестве, достаточном для распределения пропорционально темпам списания
3. обновила отчет с новыми цифрами “как будет”..
Наглядно, удобно, как должно быть…
Это красивая история для любого разработчика/внедренца, когда вся компания с удовольствием пользуется твоей разработкой. Особенно, если ты сам работаешь внутри компании 🙂
Один из механизмов для этого – расшифровки, на которые мы устанавливаем свои дополнительные действия:
В общем, сейчас поговорим об инструментах, которые позволяют создать уникальные и в то же время удобные доработки в отчеты, которые резко повышают их ценность:
Поехали, там красивое 🙂
И всего 45 минут, как в школе…
Видео № 1. Что такое расшифровка отчетов на СКД и какие объекты встроенного языка для этого используются
Ключевые моменты видео:
0:32 — стандартная расшифровка отчетов на СКД
1:26 — варианты расшифровки отчетов
3:01 — в каких случаях может потребоваться программная расшифровка отчета
3:26 — обязательное условие для работы расшифровки
3:49 — реквизиты формы отчета, необходимые для работы расшифровки
4:51 — событие ОбработкаРасшифровки
5:46 — изучение объектов, необходимых для программной работы с расшифровкой при помощи отладчика
9:09 — схема взаимосвязи объектов, необходимых для программной работы с расшифровкой
Видео № 2. Как обработать щелчок правой кнопки мыши в отчете на СКД
Ключевые моменты видео:
0:21 — как переопределить действия при нажатии правой кнопки мыши на ячейке отчета
0:35 — событие ОбработкаДополнительнойРасшифровки
1:04 — программный код для обработки дополнительной расшифровки
Видео № 3. Как реализовать расшифровку показателя в отчете при помощи другого отчета
Ключевые моменты видео:
0:25 — программный код для расшифровки отчета при помощи другого отчета
0:54 — программное открытие формы отчета с отбором
1:07 — параметры формы, предоставленные расширением формы клиентского приложения для отчета
Видео № 4. Почему может не работать расшифровка при программной компоновке отчета в процедуре ПриКомпоновкеРезультата
Ключевые моменты видео:
0:26 — демонстрация отчета, в котором не работает расшифровка
0:50 — изучение процедуры ПриКомпоновкеРезультата
1:04 — в каких случаях может потребоваться самостоятельная компоновка отчета
1:23 — использование параметра ДанныеРасшифровки
Видео № 5. Как программно сформировать собственное меню для расшифровки показателей отчета
Ключевые моменты видео:
0:12 — демонстрация использования меню
0:49 — создание объекта ОбработкаРасшифровкиКомпоновкиДанных
1:57 — описание процедуры, которая будет вызвана при выборе пользователем действия в меню
2:31 — описание действий, которые будут добавлены в формируемое меню
4:01 — обработка действия, выбранного пользователем в меню
Видео № 6. Как программно сформировать вложенные подменю для расшифровки показателей отчета
Ключевые моменты видео:
0:13 — демонстрация использования подменю при расшифровке отчета
0:36 — программный код для формирования подменю
0:58 — формирование структуры меню, содержащего подменю
Видео № 7. Как программно обработать действие Отфильтровать при работе с расшифровкой
Ключевые моменты видео:
0:10 — детализация отчета по остаткам товаров до складов
0:40 — анализ программного кода
1:58 — программная модификация настроек компоновки, используемых для расшифровки отчета
2:28 — передача параметра Расшифровка в открываемую форму отчета
Видео № 8. Как реализовать расшифровку в форме самого отчета без открытия отдельных окон
Ключевые моменты видео:
0:21 — демонстрация расшифровки отчета в форме этого же отчета
1:27 — обработка выбранного пользователем действия расшифровки
2:21 — обработка настроек компоновки, переданных в качестве параметра при расшифровке
2:52 — компоновка отчета с новыми настройками
Видео № 9. Как программно сформировать разные меню для разных полей отчета
Ключевые моменты видео:
0:15 — демонстрация отчета с разными меню расшифровки для разных полей
0:50 — настройка макетов в схеме компоновки
1:52 — программное формирование различных меню расшифровки для разных полей отчета
2:23 — получение структуры, содержащей поля расшифровки
3:56 — обработка выбранного пользователем действия расшифровки
Скачайте архив со всеми отчетами, показанными в видео, и Вам не придется вручную набирать весь программный код. Можно просто открыть готовый отчет в своей базе, изучить его, отладить:
Видео № 10. Как в расширении для УТ 11.4 реализовать расшифровку ведомости по товарам на складах при помощи прайс-листа
В видео покажем, как выполнить расшифровку отчета при помощи другого отчета в конфигурации 1С:Управление торговлей версии 11.4. За счет того, что она базируется на БСП, а не написана с нуля, есть нюансы. Чтобы конфигурация осталась типовой и могла обновляться автоматически, доработка выполнена при помощи расширения для УТ 11.4.13.136.
Урок будет полезен тем, кто работает с типовыми решениями 1С. В ERP 2 и КА 2 задача будет решаться так же, как в УТ 11. Также код, представленный в видео, можно использовать как образец для конфигураций, в которых внедрена БСП третьей редакции. Естественно, отчеты или процедуры в них будут называться по-другому, но принцип доработки останется тот же.
Ключевые моменты видео:
0:15 — расшифровка ведомости расчетов с клиентами при помощи карточки расчетов в УТ 11
1:25 — работа с общей формой ФормаОтчета, поиск процедуры, выполняющей обработку расшифровки
2:14 — анализ программного кода для расшифровки различных отчетов в УТ
2:53 — образец кода, описывающего параметры расшифровки
4:06 — расширение, при помощи которого выполнена доработка
4:25 — использование аннотации ИзменениеИКонтроль
5:28 — проверка работоспособности расширения в пользовательском режиме
Чтобы быстрее разобраться, как выполнить расшифровку в УТ 11, КА 2 и ERP 2, скачайте расширение из видеоурока:
Не пропустите новый курс (по специальной цене для первого потока)!
Коллеги, запускаем новый курс по EDT и Git, первый курс в серии курсов по DevOps.
Если Вы тимлид / руководитель отдела разработки / работаете в команде из 5+ человек над одним проектом / планируете перейти в ведущие франчайзи не простым разработчиком – рекомендуем внимательно его посмотреть:
Расшифровка СКД. Управляемые формы
Платформа 1С предоставляет возможность расшифровки из коробки, но только в том случае, если мы используем объект “Отчет” и его форму. Если мы выводим отчет на форме обработки – нам придется добавить немного кода.
Для начала создадим обработку, форму обработки и создадим реквизиты формы:
На форме сделаем два элемента:
Пойдем от очень простого к простому.
Код кнопки “Обновить” будет таким:
И добавим процедуру:
Это минимум кода, который нам необходим, чтобы вывести отчет.
Тут-то и появляется вопрос “Куда делась расшифровка?”.
Для того, чтобы появилась расшифровка нам надо изменить нашу процедуру ОбновитьОтчетНаСервере:
Теперь мы добавили данные расшифровки в наш отчет.
Но и это еще не все. Если мы сформируем отчет у нас будет расшифровка. но вместо нее мы будем видеть цифры, как на скриншоте
Эту проблему я встречал достаточно часто на различных форумах. Но и это не проблема.
Достаточно создать событие “ОбработкаРасшифровки” для поля табличного документа со следующим кодом:
И передать данные расшифровки с сервера на клиент. Кстати именно для этого мы сделали два реквизита “АдресРасшифровки” и “АдресХранилищаСКД”.
Для этого опять изменим процедуру ОбновитьОтчетНаСервере и приведем ее вот к такому виду:
Теперь добавим процедуру для обработки вышеуказанного оповещения:
Видим, что мы уже почти все сделали. Отчет работает, выводит меню расшифровки и даже открывает ссылки справочников и документов. Осталось два вопроса:
В отличии от открытия значений расшифровка и фильтрация требует повторного формирования отчета с заданными настройками.
Эти настройки нам нужно получить и вывести отчет уже с новыми настройками.
Конечный результат модуля формы
Для этого приведем процедуру ОбновитьОтчетНаСервере к такому виду:
А процедуру РезультатОбработкаРасшифровки_Продолжение к такому:
Подставляем параметры в отчет СКД
Если выводимый отчет имеет параметры – нам надо об этом тоже позаботиться.
Впрочем ничего сложно тут нет.
Предположим, что нам нужно установить параметр “Период” для отчета.
Перед тем как скомпановать результат нужно добавить одну строку:
Таким образом наша процедура примет следующий вид:
Все что я хотел рассказать и чем поделиться – подробно изложено в этой статье. Если у вас остались вопросы – добро пожаловать в комментарии.
Отчетность в 1С: Система Компоновки Данных (СКД), идея и архитектура
Одна из самых важных областей бизнес-софта – это отчетность. От того, насколько легко настроить под меняющиеся потребности бизнеса (и законодательства) существующий отчет или сделать новый, может зависеть (причем не в переносном смысле!) судьба бизнеса, будь то отчет для налоговой инспекции или диаграмма зависимости спроса на товары от сезона и других факторов. Мощная и гибкая система отчетности, позволяющая легко извлечь из системы нужные данные, представить их в доступном для понимания виде, позволяющая конечному пользователю перенастроить стандартный отчет так, чтобы увидеть данные в новом свете – это идеал, к которому должна стремиться каждая бизнес-система.
В платформе «1С:Предприятие» за построение отчётов отвечает механизм под названием «Система компоновки данных» (сокращенно СКД). В этой статье мы постараемся дать краткое описание идеи и архитектуры механизма СКД и его возможностей.
СКД – это механизм, основанный на декларативном описании отчетов. СКД предназначен для построения отчетов и для вывода информации, имеющей сложную структуру. Кстати, помимо разработки отчетов механизм СКД также используется в «1С:Предприятии» в динамическом списке, средстве показа списочной информации с богатой функциональностью (показ плоских и иерархических списков, условное оформление строк, группировки и т.п.).
Немного истории
В самой первой версии платформы «1С:Предприятие 8», версии 8.0, отчеты делались так:
Одной из идей, легших в основу СКД, была гибкость и настраиваемость отчетов, причем доступная как разработчику, так и конечному пользователю. В идеале хотелось бы дать доступ конечному пользователю к тому же набору инструментов для дизайна отчета, что и разработчику. Логично было бы сделать единый набор инструментов, доступный всем. Ну а раз инструменты предполагают участие конечного пользователя – значит, нужно использование программирования в них убрать до минимума (лучше всего – устранить совсем), и по максимуму использовать визуальные настройки.
Постановка задачи
Задача перед командой разработки стояла такая – сделать систему создания отчетов, основанную не на алгоритмическом (т.е. через написание кода), а на декларативном подходе к созданию отчетов. И мы считаем, что задачу успешно решили. По нашему опыту, около 80% требуемой отчетности может быть реализована с помощью СКД без единой строчки кода (за исключением написания формул вычисляемых полей), по большей части — через визуальные настройки.
Разработка первой версии СКД заняла около 5 человеко-лет.
Два языка
В создании отчетов задействованы два языка. Один – язык запросов, используемый для выборки данных. Второй – язык выражений компоновки данных, предназначен для записи выражений, используемых в различных частях системы, например, в настройках компоновки данных, для описания выражений пользовательских полей.
Язык запросов
Язык запросов основан на SQL и легко осваивается знающими SQL. Пример запроса:
Легко видеть аналоги стандартных для SQL-запроса секций — SELECT, FROM, GROUP BY, ORDER BY.
При этом язык запросов содержит значительное количество расширений, ориентированных на отражение специфики финансово-экономических задач и на максимальное сокращение усилий по разработке прикладных решений:
Есть также специальные расширения языка запросов для СКД. Расширение осуществляется при помощи специальных синтаксических инструкций, заключаемых в фигурные скобки и помещаемых непосредственно в текст запроса. С помощью расширений разработчик определяет, какие операции конечный пользователь сможет проводить, настраивая отчет.