Перейти к содержимому

Паттерны СКД (галочка-отбор, заголовок поля внешнего набора)

Рекомендация

#скд #запросы

Рекомендация

Два переиспользуемых приёма для отчётов на СКД.

1. Пользовательский отбор как одиночная галочка

Предустановленные фильтры с понятными именами («Только активные», «Только небезопасные») оформлять как одиночную галочку без поля выбора «Да/Нет». Решение — обернуть условие в FilterItemGroup с userSettingPresentation на уровне группы (не на уровне сравнения). Иначе рядом с галочкой показывается лишний выпадающий «Да/Нет».

<!-- userSettingPresentation на элементе сравнения:
     пользователь видит галочку И выпадающий «Да/Нет» рядом. -->
<dcsset:item xsi:type="dcsset:FilterItemComparison">
  <dcsset:left xsi:type="dcscor:Field">Активен</dcsset:left>
  <dcsset:comparisonType>Equal</dcsset:comparisonType>
  <dcsset:right xsi:type="xs:boolean">true</dcsset:right>
  <dcsset:userSettingID>...</dcsset:userSettingID>
  <dcsset:userSettingPresentation>Только активные</dcsset:userSettingPresentation>
</dcsset:item>

<!-- Условие обёрнуто в группу; презентация и userSettingID — на группе.
     В настройках — одна галочка «Только активные». -->
<dcsset:item xsi:type="dcsset:FilterItemGroup">
  <dcsset:groupType>AndGroup</dcsset:groupType>
  <dcsset:item xsi:type="dcsset:FilterItemComparison">
    <dcsset:left xsi:type="dcscor:Field">Активен</dcsset:left>
    <dcsset:comparisonType>Equal</dcsset:comparisonType>
    <dcsset:right xsi:type="xs:boolean">true</dcsset:right>
  </dcsset:item>
  <dcsset:userSettingID>...</dcsset:userSettingID>
  <dcsset:userSettingPresentation>Только активные</dcsset:userSettingPresentation>
</dcsset:item>

2. Заголовок поля внешнего набора данных

Пользовательский заголовок поля dataSet задавать в <dcsset:title> внутри <dcsset:item xsi:type="dcsset:SelectedItemField"> (в settingsVariant), а не элементом <title> внутри <field xsi:type="DataSetFieldField">.

<!-- title внутри описания поля набора данных: платформа падает
     на чтении Template.xml с XDTO-ошибкой. -->
<field xsi:type="DataSetFieldField">
  <dataPath>Должность</dataPath>
  <field>Должность</field>
  <title xsi:type="v8:LocalStringType">
    <v8:item><v8:lang>ru</v8:lang><v8:content>Должность сотрудника</v8:content></v8:item>
  </title>
</field>

<!-- Поле набора — без title; заголовок задаётся в варианте настроек. -->
<field xsi:type="DataSetFieldField">
  <dataPath>Должность</dataPath>
  <field>Должность</field>
</field>
<!-- ... в settingsVariant: -->
<dcsset:item xsi:type="dcsset:SelectedItemField">
  <dcsset:field>Должность</dcsset:field>
  <dcsset:title>Должность сотрудника</dcsset:title>
</dcsset:item>

Зачем

Неверное место заголовка ломает загрузку: при чтении Template.xml платформа падает с «Ошибка преобразования данных XDTO… НачалоСвойства: title… Тип: anyType…»; после dump в XML заголовок «слетает», а load бросает XDTO-исключение. Галочка без обёртки-группы показывает лишний выпадающий список — мелочь, но раздражает пользователя в каждом отчёте.

Когда не применять

Галочка-группа нужна только для предустановленных отборов с фиксированным значением. Обычные отборы, где пользователь сам выбирает значение (контрагент, период), оформляются штатно.
Если заголовок поля постоянный и совпадает во всех вариантах отчёта — проще задать псевдоним прямо в тексте запроса (КАК ДолжностьСотрудника), приём с dcsset:title нужен для полей внешних наборов данных.

См. также