Настройки таблицы

Настройки таблицы отчета содержатся в свойстве grid элемента settings.

Примечание. В данной спецификации приведены только те настройки, которые применяются на мобильном устройстве.

Свойство Описание Возможные значения
adjust Задает параметры автоподгонки размера ячеек. Значение - элемент со следующими свойствами:

  • mode. Режим автоподгонки:

0 – отключена;

1 – только по высоте;

2 – только по ширине;

3 – сначала по ширине, потом по высоте;

4 – сначала по высоте, потом по ширине;

5 – автоматическая;

6 – упрощенная;

  • maxRowsInCell. Максимальное количество строк в ячейке. Доступно, если для mode установлено 5;

  • minVisibleDataColumns. Минимальное число видимых столбцов. Доступно, если для mode установлено 5.
cols Массив с шириной каждого столбца, начиная с нулевого.

Примечание. Если для свойства adjust установлено значение 0, то на мобильное устройство передаются значения ширины столбцов из настольного приложения.

 
rows Массив с шириной каждой строки, начиная с нулевой.

Примечание. Если для свойства adjust установлено значение 0, то на мобильное устройство передаются значения высоты строк из настольного приложения.

 
eaxtabstyle Стиль таблицы.

Содержит настройки стиля таблицы:

  • type. Значение свойства - элемент перечисления TabTablePredefinedStyle.

  • DefaultStyle. Содержит свойство CustomFormat которое задает пользовательский формат отображения данных.
Expanders Экспандеры.

Содержит массив элементов с настройками экспандеров со следующими свойствами:

  • L и T. Координата ячейки с экспандером;

  • W. Количество столбцов, которые сворачивает/экспандер;

  • H. Количество строк, которые сворачивает/экспандер;

  • IC. Определяет, свернута ли иерархия.
totals Задает параметры расчета итогов.

Значение - элемент со следующими свойствами:

  • emptyValuesAsZero. Если установлено true, пустые значения будут рассчитываться как ноль. Если установлено значение false, пустые значения не берутся в расчет;

  • includeOwner. Если установлено true, итоги будут рассчитываться с учетом значений вершин. Если установлено значение false, значения вершин не берутся в расчет;

  • overallTotal. Если установлено true, будут расчитаны общие итоги. Если установлено значение false, общие итоги расчитываться не будут.

  • hierarchyTotals. Если установлено true, итоги будут рассчитываться по каждому уровню иерархии. Если установлено значение false, итоги по уровням иерархии рассчитываться не будут;

  • levelTotals. Если установлено true, итоговые значения для строк или столбцов будут отображаться после каждого уровня иерархии. Если установлено false, итоги по уровням отображаться не будут.
data Задает параметры агрегации и ранжирования данных.

  • aggregateFixed. Включает/отключает агрегацию и выбирает ее тип:

0 – отключена;

1 – сумма;

2 – из источника.

  • enableRank. Определяет, будут ли значения отображаться как ранги, и выбирает способ ранжирования:

0 – нет;

1 – по возрастанию;

2 – по убыванию.

  • rankArea. Определяет область применения рангов:

0 – по всему набору данных;

1 – по столбцам;

2 – по строкам.
gridFilter Задает параметры фильтрации. Значение - элемент со следующими свойствами:

  • enabled. Если установлено true, фильтрация включена. Если false - отключена;

  • keepParent. Оставлять владельцев нескрытых элементов. Если установлено true - Родители элементов будут отображены, даже если не удовлетворяют условию фильтрации;

  • filterElements. Элементы фильтрации;

  • filterZero. Если установлено true, будут отфильтрованы ячейки таблицы, содержащие только нулевые значения. Если установлено false, ячейки с нулевыми значениями отфильтрованы не будут;

  • filterEmpty. Если установлено true, будут отфильтрованы ячейки таблицы, не содержащие никакой информации. Если установлено false, пустые ячейки отфильтрованы не будут;

  • filterNonNumeric. . Если установлено true, будут отфильтрованы ячейки таблицы, содержащие только нечисловые значения. . Если установлено false, ячейки с нечисловыми значениями отфильтрованы не будут;

  • filterUseCondition. Если установлено true, будет включена фильтрация по условию. Если установлено false, фильтрация по условию применяться не будет;

  • filterCondition. Условие фильтрации:
        0 - нет условия;
        1 - равные А;
        2 - не равные А;
        3 - большие А;
        4 - меньшие А;
        5 - большие или равные А;
        6 - меньшие или равные А;
        7 - между А и В включительно;
        8 - меньшие А или больше В;

  • filterConditionA. Задает число А для условия фильтраци;

  • filterConditionB. Задает число В для условия фильтрации.
gridSort Задает параметры сортировки. Если сортировка в таблице не применяется, то значением свойства является пустой элемент <dict/>.
Если установлена сортировка по столбцам, у элемента <dict> будет свойство columns, значением которого является массив элементов <dict> со свойствами:

  • index. Индекс столбца;

  • direction. Направление сортировки:

2 – по убыванию;

1 – по возрастанию.
gridPareto Задает параметры распределения. Содержит два идентичных свойства Rows/Columns определяющие параметры для строк/столбцов. Каждое свойство содержит следующие свойства:

  • Top. Содержит настройки N первых элементов;

  • Bottom. Содержит настройки N последних элементов;

  • ElementIndex. Определяет индекс строки/столбца (Нумерация с нуля, с первой не заголовочной строки/столбца);

  • Enabled. Определяет, применено ли распределение к указанной строке/столбцу.

Свойства Top/Bottom содержат следующие настройки:

  • Threshold. Значение, задаваемое пользователем (проценты задаются через точку, например «0.5»);

  • Kind. Задает тип распределения: 1 - по процентам, 2 - по количеству, 3 - по сумме;

  • Display. При значении true - распределение отображается, при значении false - не отображается.
selection Выделение ячеек таблицы Значение - массив элементов со следующими свойствами:

  • left и top. Координаты левого верхнего угла выделения;

  • right и bottom. Координаты нижнего правого угла выделения;

  • type. Тип выделения:

cells - выделение ячеек;

cols - выделение столбцов;

rows - выделение строк;

table - выделение всей таблицы.

Пример

Настройки таблицы отчета могут выглядеть следующим образом:

<key>grid</key>
<!-- Настройки для таблицы-->
<dict>
  <key>adjust</key>
  <!-- Автоподгонка-->
  <dict>
    <key>mode</key>
    <integer>5</integer>
    <!-- Тип автоподгонки-->
    <key>maxRowsInCell</key>
    <integer>8</integer>
    <!-- Количество ячеек в строке-->
    <key>minVisibleDataColumns</key>
    <!-- Минимальное число видимых столбцов-->
    <integer>3</integer>
  </dict>
  <key>cols</key>
  <array>
    <integer>67</integer>
    <!-- Ширина каждого столбца начиная с 0-го-->
    <integer>44</integer>
    <integer>50</integer>
  </array>
  <key>rows</key>
  <array>
    <integer>46</integer>
    <!-- Ширина каждой строки, начиная с 0-ой-->
    <integer>25</integer>
    <integer>25</integer>
  </array>
  <key>eaxtabstyle</key>
  <dict>
    <key>type</key>
    <integer>10</integer>
    <key>DefaultStyle</key>
    <dict>
      <key>CustomFormat</key>
      <string># ##0,00</string>
    </dict>
  </dict>
  <key>totals</key>
  <key>Expanders</key>
  <array>
  <dict>
    <key>L</key>
    <integer>0</integer>
    <key>T</key>
    <integer>1</integer>
    <key>W</key>
    <integer>0</integer>
    <key>H</key>
    <integer>3</integer>
    <key>IC</key>
    <integer>1</integer>
  </dict>
  <dict>
    <key>L</key>
    <integer>0</integer>
    <key>T</key>
    <integer>8</integer>
    <key>W</key>
    <integer>0</integer>
    <key>H</key>
    <integer>2</integer>
  </dict>
 </array>
  <dict>
    <key>emptyValuesAsZero</key>
    <string>false</string>
    <key>includeOwner</key>
    <string>true</string>
    <key>hierarchyTotals</key>
    <string>true</string>
    <key>levelTotals</key>
    <string>true</string>
  </dict>
  <key>data</key>
  <dict>
    <key>aggregateFixed</key>
    <integer>0</integer>
    <key>enableRank</key>
    <integer>0</integer>
    <key>rankArea</key>
    <integer>0</integer>
  </dict>
  <key>gridFilter</key>
  <dict>
    <key>enabled</key>
    <string>true</string>
    <key>filterElements</key>
    <integer>0</integer>
    <key>filterZero</key>
    <string>false</string>
    <key>filterEmpty</key>
    <string>false</string>
    <key>filterNonNumeric</key>
    <string>false</string>
    <key>filterUseCondition</key>
    <string>false</string>
    <key>filterCondition</key>
    <integer>0</integer>
  </dict>
<key>gridSort</key>
  <key>columns</key>
  <array>
    <dict>
      <key>index</key>
      <integer>0</integer>
      <key>direction</key>
      <integer>2</integer>
    </dict>
  </array>
<key>selection</key>
  <array>
    <dict>
      <key>left</key>
      <integer>0</integer>
      <key>top</key>
      <integer>0</integer>
      <key>right</key>
      <integer>0</integer>
      <key>bottom</key>
      <integer>1</integer> 
      <key>type</key>
      <string>cells</string>
    </dict>
   </array>
<key>gridPareto</key>
 <dict>
  <key>Rows</key>
   <dict>
    <key>Top</key>
      <dict>
       <key>Threshold</key>
       <real>10</real>
       <key>Kind</key>
       <integer>2</integer>
       <key>Display</key>
       <string>true</string>
      </dict>
    <key>Bottom</key>
      <dict>...</dict>
    <key>ElementIndex</key>
    <integer>4</integer>
    <key>Enabled</key>
    <string>false</string>
   </dict>
  <key>Columns</key>
   <dict>...</dict>
</dict>
</dict>

См. также:

Настройки экспресс-отчета