Просмотр кода страницы Платформа 3V/Отчет/1. Настроить строки/1.4. Дополнительные настройки/Настройка отображения только группировочных элементов по строкам

{{DISPLAYTITLE:Настройка отображения только группировочных элементов по строкам (ранее - Трансформации}}

'''Трансформация''' - это метод группировки с заменой оригинальных справочников боковика на связанные для связанных атрибутов или на временные [[#Временный справочник]] для обычных атрибутов.

Для трансформации достаточно выбрать метод группировки '''GroupingMethod''' при описании справочника боковика.
<syntaxhighlight lang="JSON" line>
{
  ...
  "leftHeader": {
    "dictionaries": [
      {
        ...
        "groupingMethod": "TransformToSeparateDictionaries",
        ...
      }
    ],
    ...
  }
  ...
}
</syntaxhighlight>

== Временный справочник ==
'''Временный справочник''' - это генерируемый на уровне ядра справочник с уникальными значениями атрибута по которому проводится группировка. 

== Виды трансформации ==

# '''TransformToSeparateDictionaries''' - обычная трансформация, заменяет справочник боковика на справочники группировочных атрибутов.
# '''TransformToSeparateDictionariesHierarchically''' - тоже самое только с выстраиванием иерархии.

== Агрегация фактов показателя с трансформируемыми измерениями ==
'''TransformAggregationType''' - тип агрегации группируемых значений фактов при трансформации измерений показателя. </br>

'''TransformAggregationType''' указывается в элементе шапки '''IndicatorOptionsDto'''.

<syntaxhighlight lang="JSON" line>
{
  ...
  "topHeader": {
    "topHeaderItems": [
     ...
      {
        ...
        "TransformAggregationType": "DistinctCount",
        ...
        "discriminator": "IndicatorOptionsDto"
      }
    ],
    ...
  },
  ...
}
</syntaxhighlight>

# По умолчанию используется тип агрегации "Сумма".
# '''TransformAggregationType''' может работать совместно с агрегацией указываемой для фактов показателя в '''IndicatorAggregationOptionsDto''' и они могут быть различны, т.е. агрегация при трансформации может быть "Сумма", а обычная агрегация по факту "Количество".

=== Пример ===
'''Показатель перед трансформацией'''
{| class="wikitable"
|-
! Значение трансформируемого справочника !! Факт
|-
| Статья №1 || 1
|-
| Статья №1 || 2
|-
| Статья №2 || 3
|}
'''Показатель после трансформации (Если TransformAggregationType будет равно сумме)'''

{| class="wikitable"
|-
! Значение справочника !! Факт
|-
| Статья №1 || 3
|-
| Статья №2 || 3
|}

== Агрегация значений атрибутов трансформируемых справочников ==
Свойство отвечающее за тип агрегации значений атрибута трансформируемого справочника, называется '''TransformAggregationType''', аналогично свойству для агрегации фактов показателя при трансформации.

'''TransformAggregationType''' для атрибутов указывается в настройках '''AttributeHeaderItemSettingsDto''' элемента шапки '''AttributeHeaderItemDto'''.

<syntaxhighlight lang="JSON" line>
{
  ...
  "topHeader": {
    "topHeaderItems": [
     ...
      {
        ...
        "settings": {
          ...
          "TransformAggregationType": "Sum"
          ...
        }
        ...
        "discriminator": "AttributeHeaderItemDto"
      }
    ],
    ...
  },
  ...
}
</syntaxhighlight>

#По умолчанию никакой тип агрегации не используется, поэтому если не задать значение для '''TransformAggregationType''', то атрибут трансформируемого справочника будет убран из шапки пивота.
#Если для атрибута будет задан '''TransformAggregationType''', то вместо атрибута будет добавлен виртуальный показатель куда будут записаны агрегаты значений атрибута по указанному типу агрегации.
#'''TransformAggregationType''' может работать совместно с агрегацией '''AggregationType''' указываемой для атрибута в '''AttributeHeaderItemSettingsDto''' и они могут быть различны, т.е. агрегация при трансформации может быть "Сумма", а обычная агрегация "Количество".


=== Пример ===
'''Атрибуты справочника перед трансформацией'''
{| class="wikitable"
|-
! Значение группировочного атрибута (не связанный) !! Значение атрибута выведенного в шапку с указанием TransformAggregationType = Sum
|-
| Статья №1 || 1
|-
| Статья №1 || 2
|-
| Статья №2 || 3
|}
'''Атрибуты справочника после трансформации'''
{| class="wikitable"
|-
! Значение атрибута временного справочника !! Виртуальный показатель с агрегатами атрибута
|-
| Статья №1 || 3
|-
| Статья №2 || 3
|}