6.1. Заголовки

Общие положения

В системе JetCalc архитектура документов ориентирована на многократное применение заголовков в однородных документах. Каждый заголовок состоят из одного или нескольких типовых наборов колонок (так называемых колсетов). Такое решение позволяет существенно сократить трудоемкость создания и модификации заголовком и документов. Структуру заголовка документа в JetCalc можно представить условно в виде дерева:
  1. 1.
    Документ
    1. 1.
      Заголовок 1
      1. 1.
        Колсет А
        1. 1.
          Колонка К1
        2. 2.
          Колонка К2
        3. 3.
          Колонка К3
      2. 2.
        Колсет Б
        1. 1.
          Колонка К1
      3. 3.
    2. 2.
      Заголовок 2
      1. 1.
        Колсет А
        1. 1.
          Колонока К1
        2. 2.
          Колонока К2
      2. 2.
        Колсет Б
        1. 1.
          Колонка К3
      3. 3.
        Колсет С
        1. 1.
          Колонка К1
        2. 2.
          Колонка К3
Таким образом, любой заголовок состоит из трех элементов, перечисленный в порядке их настройки в JetCalc:
  • колонка - первичный элемент для хранения или расчета значений, уникальный по всей базе JetCalc;
  • колсет - набор колонок, объединенных с точки зрения функциональности для многократного использования;
  • заголовок - набор колсетов, скомбинированных для применения в документах для ввода данных и вывода отчетов.
Создание и первоначальная настройка заголовков выполняется в административной панели в разделе Колонки, в котором есть три вкладки - Колонки, Колсеты и Заголовки, а затем окончательно настраивается в контексте каждого документа на вкладке Настройка колонок.

Создание и первоначальная настройка колонок

Колонка является одним из ключевых атрибутов ячейки, образующим ее уникальный код, наряду со строкой, годом, периодом и объектом учета.
Все колонки делятся на 2 категории:
  • первичные - предназначенные для хранения первичных значений ячеек в базе данных;
  • формульные - предназначенные для определения формул, на основании которых вычисляются значения ячеек в момент открытия или обновления документа по данным первичных значений ячеек.
Создание и первоначальная настройка колонок выполняется в административной панели в разделе Колонки - Колонки. Для доступа к настройке колонок необходима привилегия Колонки (справочник) - Настройка колонок. Внешний вид панели настройки колонок представлен на следующем рисунке:
Для создания новой колонки необходимо определить следующие обязательные атрибуты:
  • КодКолонки - уникальны код, отражающий назначение хранящихся или вычисляемых по колонке значений;
  • Назв.Колонки - служебное наименование, предназначенное для идентификации колонки;
  • КодВалюты - валюта колонки по умолчанию; обычно выбирается валюта NONE (валюта по умолчанию, определяемая из контекста документа) или NAT (натуральный показатель).
Для формульных колонок следует определить два атрибута, отличающие эти колонки от первичных:
  • Вкл.Формулу - включает формулу колонки, делая первичную колонку формульной;
  • Формула - формула колонки.
Следующие атрибуты являются необязательными:
  • Кр.Назв.Колонки - в случае большой длины полного названия колонки рекомендуется заполнять также ее краткое название для более удобного применения в некоторых элементах интерфейса;
  • Комментарий - необязательный атрибут, предназначенный для комментариев колонок, назначение или функциональность которых не очевидны из их кода и названия;
  • ПриоритетСтроки - устанавливает для текущей колонки приоритет вычислений формул строк; имеет смысл только для формульных колонок (по умолчанию установлен приоритет формул колонок);
  • НеСчитатьСуммы - отменяет для текущей колонки действие атрибута суммы, определенного для строк;
  • ЗапретРасч.Сумм - отменяет для текущей колонки как действие атрибута суммы, так и атрибута принудительного расчета сумм, определенных для строк;
  • Виртуальная - для формульных колонок устанавливает признак виртуальной колонки (подробнее см. раздел 4.1).
Примечание: в связи с отсутствием контекста документа (документ, год, период, объект учета, валюта) в административной панели рекомендуется при первоначальной настройке формульных колонок записывать в них только основную логику выражения, а тонкую настройку производить в контексте документа.

Создание и первоначальная настройка колсетов

Колсет является вспомогательной конструкцией, предназначенной для повторного использования наборов колонок, объединенных некоторой функциональностью.
Создание колсета выполняется в административной панели в разделе Колонки - Колсеты. Для доступа к настройке колонок необходима привилегия Колонки (справочник) - Настройка колсетов. Внешний вид панели настроек колсета представлен на следующем рисунке:
Создание колсета состоит из двух последовательный шагов:
  1. 1.
    Создание нового колсета с уникальным кодом, а также наименование, описывающим назначение колсета.
  2. 2.
    Добавление к созданному ранее колсету необходимого набора колонок.
При создании кода колсета рекомендуется включать в него обозначение предметной области, группу периодов и указание на форму ввода или отчет. На представленном выше рисунке большинство кодов колсетов сформировано по следующей схеме:
[префикс cs] [категории документов] [плановые или фактические документы] [форма ввода или отчет]
После создания нового пустого колсета необходимо добавить в него колонки, которые будут выходить в заголовке документа. В административной панели при добавлении колонок для каждой из них указываются следующие атрибуты:
  • ЗаголовокКолонки - наименование колонки в том виде, которое от будет выводится в заголовке документа;
  • Индекс - относительный порядковый номер размещения колонки в заголовке слева направо; допускается использовать в качестве индексов целые значения со знаком;
  • Колонка - из выпадающего списка выбирается ранее настроенная колонка;
  • Период - из выпадающего списка выбирается ранее настроенный период; для текущего периода необходимо выбрать период "Текущий период" с кодом 0;
  • Фиксированная - для первичных колонок установка этого атрибута запрещает редактирование значений в формах ввода по текущей колонке;
  • Историческая - установка этого атрибута ограничивает видимость колонки только года, определенного в качестве года начала использования документа; если год начала использования не установлен, то колонка не будет видна в любом годе;
  • ДокументИсточник - экспериментальная колонка.
В любой позиции наименования заголовка колонки можно вставлять специальные коды, вместо которых в отрытом документе будут подставляться значения текущего контекста:
  • {0} - значение года контекста документа
  • {2} - наименование периода контекста документа
  • {5} - дата начала периода контекста документа
  • {6} - дата окончания периода контекста документа
Например, для наименования заголовка в виде "Факт за {2} {0}" при открытии документа в феврале 2018 года будет выведен заголовок "Факт за Февраль 2018".

Создание и первоначальная настройка заголовков

Заголовок документа представляет собой древовидную структуру (в простейшем виде состоящую из одного уровня), на самом нижнем уровне которой находятся один или несколько колсетов.
Настройка заголовка выполняется в административной панели в разделе Колонки - Заголовки. Для доступа к настройке колонок необходима привилегия Колонки (справочник) - Настройка заголовков. Внешний вид панели настройки заголовков представлен на следующем рисунке:
В простейшем случае, когда необходимо создать одноуровневый заголовок, как при создании колсета необходимо выполнить два последовательных шага:
  1. 1.
    Создание нового заголовка с уникальным кодом, а также наименование, описывающим назначение заголовка.
  2. 2.
    Добавление к созданному ранее заголовка необходимого набора колсетов.
При создании кода заголовка рекомендуется включать в него обозначение предметной области, группу периодов и указание на форму ввода или отчет. На представленном выше рисунке большинство кодов заголовков сформировано по следующей схеме:
[префикс h[n]] [категории документов] [плановые или фактические документы] [форма ввода или отчет]
Так как структур заголовка может быть многоуровневой, то в префиксе заголовка рекомендуется указывать уровень заголовка, например, h1_ h2 и т.п., как это делается для оформления уровней заголовков в html-документах.
Помимо кода для каждого уровня заголовка указываются следующие атрибуты:
  • Назв.Заголовка - в зависимости от количества уровней отличается применение названия заголовка - для одноуровневых заголовков название служит только для описания заголовка в административной панели, для многоуровневых заголовков название также выводится заголовок рабочего документа;
  • Индекс - определяет порядок вывод на экран слева направо при наличии нескольких заголовков на одном уровне;
  • Родит.Заголовок - указывает на родительский заголовок; для одноуровневых заголовков атрибут не заполняется.
Следующие атрибуты заголовка предназначены для переопределения соответствующих параметров дочерних заголовков и колонок связанных с заголовками колсетов:
  • Условия - добавляет логическое выражение фильтрации по AND к дочерним заголовкам и колонкам;
  • Смещ.Года - переопределяет смещение года у всех колонок;
  • Фиксированный - переопределяет доступность для редактирования у всех первичных колонок;
  • Период - переопределяет период у всех колонок.
При формировании заголовков применяются следующие правила:
  1. 1.
    Наименование заголовка, у которого нет родительского заголовка, является служебным и не выводится на интерфейсе.
  2. 2.
    Наименование заголовка, у которого есть родительский заголовок, выводится аналогично заголовку колонок в колсете, включая динамические параметры в фигурных скобках, и образует заголовок для дочерних заголовков и связанных с ним колонок колсетов.
  3. 3.
    Параметры родительского заголовка (условия фильтрации, смещение года, период) переопределяют параметры дочерних заголовков и связанных с ними колонок в колсетах.
  4. 4.
    Выражения фильтрации, определенные на уровне родительского заголовка, соединяются с выражениями фильтрации колонок, определенных в дочерних заголовках и колонках колсета по условию AND.
На самом нижнем уровне заголовков (или для одноуровнего заголовка) формируется список колсетов, для каждого из которых указывается индекс, определяющий порядок вывода колонок колсетов на экране слева направо.

Настройка заголовков документа

Добавление ранее настроенных заголовков для каждого документа выполняется на вкладке Настройка документов в разделе Структура, блоке Выбор заголовков, пример которой представлен на следующем рисунке:
Для каждого добавляемого заголовка определяются следующие атрибуты:
  • ФормаВвода - определяет режим отображения заголовка - на вкладке Отчет или Ввод данных;
  • Заголовок - устанавливается заголовок из выпадающего списка;
  • Индекс - определяет порядок вывода заголовок на текущей панели и при отображении содержимого документа слева направо;
  • Группа периодов - определяет видимость заголовка в зависимости от текущего периода контекста отображения документа.
После добавления заголовков для каждого документа выполняется их тонкая настройка на вкладке Настройка колонок, в которой параметры настроек колонок сгруппированы в следующие разделы:
  • Параметры - настройка внешнего вида отдельных колонок;
  • Фильтры - настройка видимости колонок, определяемая контекстом открытого документа и установленных значений параметров фильтрации;
  • Формулы - настройка формул колонок и сопутствующих атрибутов;
Для настройке режима видимости отдельных колонок, определенных в формах ввода или в отчетах, на кнопочной панели предусмотрен переключатель отображения Режим ввода/Режим отчета.
Ниже приведено описание разделов Параметры и Фильтры. Описание раздела Формулы содержится в главе Формулы.

Параметры

Внешний вид раздела Параметры вкладки Настройка колонок представлен на следующем рисунке:
В текущем разделе настраивается внешний вид колонок и отдельных групп посредством следующих атрибутов:
  • Название - конечный вид наименования заголовка, сформированного с учетом текущего контекста документа; доступно только по чтению;
  • Название (шаблон) - определяет текстовый шаблон заголовка документа, окончательно формируемый в контексте открытого документа;
  • Стиль - устанавливается для ячеек колонки стиль, включающий параметры шрифта и фоновый цвет, определяемый отдельно для отрицательных, положительных и нулевых значений; подробнее см. главу Стили оформления;
  • Формат значений - устанавливается для ячеек строки формат числовых значений; подробнее см. главу Форматы чисел;
  • Фиксированная - установленный атрибут, установленный для первичных колонок, делает первичные ячейки недоступными для редактирования;
  • Контрольная точка - признак, устанавливающий признак контрольной точки на уровне колонки; подробнее см. раздел Контрольные точки.

Фильтры

Внешний вид раздела Фильтры вкладки Настройка колонок представлен на следующем рисунке:
В текущем разделе настраиваются следующие колонки:
  • Выражения фильтрации - настраиваются выражения фильтрации для колонок и родительских заголовков; подробнее см. главу Выражения фильтрации;
  • Для объектов учета - атрибут, устанавливающий одну или несколько групп объектов учета, определяющий видимость колонок только для тех объектов учета, которые входят любую из этих групп;
  • Для периодов - атрибут, устанавливающий одну или несколько групп периодов, определяющий видимость колонок только для тех периодов текущего контекста отрытого документа, которые входят любую из этих групп.
Следующие атрибуты выводятся в режиме по чтению и настаиваются на вкладке Настройки документа в разделе Структура:
  • Группа периодов - атрибут, устанавливающий одну группу периодов, определяющий видимость всего заголовка только для тех периодов текущего контекста отрытого документа, которые входят в эту группу.
  • Форма ввода - атрибут, при установке устанавливающий режим использования заголовка в форме ввода, иначе заголовок используется в отчетах.