Блокировка периода (постановка)

Изначально, блокировка периода распространялась на все документы и всех пользователей системы. Позже, была добавлена возможность исключить некоторые группы пользователей из блокировки и, наконец, мы добавили возможность исключать некоторые типы документов. Но, период, а точнее дата, до которой запрещается изменять записи в БД, остается фиксированной константой.

Существующий механизм блокировки периода

За определение: подпадает конкретный тип документа под блокировку или нет, отвечает процедура gd_p_exclude_block_dt, которая возвращает 1, если переданный идентификатор типа документа не блокируется и 0 в противном случае. Процедура формируется в окне Tgd_dlgOptions при выборе типов документов исключаемых из блокировки. Системными составляющими механизма блокировки периода являются генераторы gd_g_block и gd_g_block_group. Первый хранит дату, до которой документы считаются заблокированными, а второй -- битовую маску групп пользователей, на которых распространяется блокировка. Механизм реализуется с помощью 12-ти триггеров, по три на каждую из четырех таблиц: gd_document, ac_entry, ac_record и inv_movement. Существующий триггер блокировки периода выглядит следующим образом. В случае нарушения условия блокировки вызывается исключение gd_e_block.

Данный механизм имеет следующие ограничения:

• Нельзя устанавливать разные периоды для разных типов документов;
• Нельзя устанавливать разные периоды для разных групп пользователей;
• Дата блокировки задается фиксированной константой.

Предлагается модифицировать механизм блокировки периода следующим образом:

Интерфейс пользователя

Изменение параметров блокировки осуществляется в диалоговом окне Опции системы на вкладке Блокировка. Изменение возможно только под учетной записью Administrator (данное требование проистекает из необходимости формирования хранимой процедуры). Если зашли под другой учетной записью, то на вкладке скрываем все визуальные контролы и пишем пояснительное сообщение.

Вверху вкладки предусмотрим чек-бокс "Блокировка включена". Если он выключен, то больше в разделе ничего не показывается. Если включен, то появляется таблица с четырьмя колонками. Высота строк таблицы не фиксирована и зависит от содержимого первой, третей и четвертой колонок.

Колонки таблицы

• Тип документа. Вверху клетки находится чек бокс Для всех типов документов. Если он установлен, то список типов документов и кнопка выбора не отображаются. Если снят, то под ним отображается список наименований типов документов через запятую. В правой части ячейки находится кнопка "..." для выбора типов документов (изменения списка).

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

Допускается использование арифметических операций + и -. Например, такое выражение:

Месяц + 20

Означает 20-е число текущего месяца.

• Включить группы. Вверху клетки находится чек-бокс Для всех групп пользователей. Если он установлен, то больше ничего в клетке не отображается. Если снят, то выводится строкой, через запятую список групп пользователей, на которых не распространяется блокировка. Справа выводится кнопка "...", которая позволяет открыть окно для изменения списка.

• Исключить группы. Вверху клетки находится чек-бокс Для всех групп пользователей. Если он установлен, то больше ничего в клетке не отображается. Если снят, то выводится строкой, через запятую список групп пользователей, на которых не распространяется блокировка. Справа выводится кнопка "...", которая позволяет открыть окно для изменения списка.

Возможно, для отображения таблицы стоит использовать компонент TScrollBox, на котором в зависимости от выбора пользователя динамически располагать компоненты.

Метапеременные

Для работы с метапеременными в хранимых процедурах сопоставим каждой целочисленную константу:

• Месяц = -200;
• ПредМесяц = -210;
• Квартал = -220;
• ПредКвартал = -230;
• Год = -240;
• ПредГод = -250.

Метаданные

 CREATE PROCEDURE gd_p_block (DocDate DATE, DocType INTEGER)
 AS
   DECLARE VARIABLE IG INTEGER;
 BEGIN

   ...
   
   // такой блок кода повторяется для каждой группы типов документов
   IF (DocType IN (12345, 67890, ...)) THEN
   BEGIN
     // если блокировка распространяется на все группы
     // пользователей без исключений, то проверим дату
     // и, при нарушении, вызовем исключение
     IF (DocDate < date `01.01.2001`) THEN
       EXCEPTION gd_e_block;

     // если указаны группы, на которые не распространяется блокировка, 
     // сначала проверяем дату, а затем не попадает ли пользователь
     // в список исключенных групп
     IF (DocDate < date `01.01.2001`) THEN
     BEGIN
       SELECT ingroup FROM gd_user WHERE ibname = CURRENT_USER
         INTO :IG;
       IF (BIN_AND(12345, :IG) = 0) THEN
         EXCEPTION gd_e_block;
     END

     // для ФБ 2.0 можно попробовать избежать лишних чтений из таблицы
     // и кэшировать значение битовой маски в контекстной переменной
     IF (DocDate < date `01.01.2001`) THEN
     BEGIN
       IF (RDB$GET_CONTEXT(`USER_SESSION`, `INGROUP`) = ``) THEN
       BEGIN
         SELECT ingroup FROM gd_user WHERE ibname = CURRENT_USER
           INTO :IG;
         RDB$SET_CONTEXT(`USER_SESSION`, `INGROUP`, :IG);
       END ELSE        
         IG = RDB$GET_CONTEXT(`USER_SESSION`, `INGROUP`);

       IF (BIN_AND(12345, :IG) = 0) THEN
         EXCEPTION gd_e_block;
     END

     // если при задании условия блокировки использовались метапеременные
     // то вычисляем соответствующую им дату. Например, задана переменная
     // ПредМесяц
     M = EXTRACT(MONTH FROM CURRENT_DATE) - 1;
     IF (M = 0) THEN M = 12;
     IF (DocDate < CAST('01.' || M || '.' || EXTRACT(YEAR FROM CURRENT_DATE) AS DATE)) THEN
       EXCEPTION gd_e_block;

   END

   ...
 END