События Типов справочников и ТКЭД. Часть 1.

Цикл статей:

События Типов справочников и ТКЭД. Часть 1.

События Типов справочников и ТКЭД. Часть 2.

События Типов справочников и ТКЭД. Часть 3.

Введение 

Данная статья описывает события, происходящие в Типах справочников (ТС) и Типах карточек документов (ТКЭД), при работе с ними. Описываются  правила ведения качественной разработки для повышения быстродействия системы. Материал предназначен для понимания того, что и в каких событиях рекомендуется делать, а что делать нельзя. Статья будет полезна в первую очередь новичкам, которым только предстоит постичь азы разработки на IS-Builder, а также всем более опытным участникам сообщества для того чтобы освежить знания, и, может быть, узнать что-то новое. Описание событий будет представлено применительно к ТС, т.к. для ТКЭД приведенная информация практически идентична. Но обо всем по порядку.

Статья написана на основе справки.

Общая информация

Для работы с событиями ТС, прежде всего, необходимо понимать, что происходит на уровне платформы. Отталкиваясь от этих данных, можно манипулировать поведением ТС в разные моменты работы с ними.

Вообще, все действия с ТС можно условно разделить на две части:

• Работа с набором данных всего ТС
• Работа с конкретной записью

Набор данных – Открытие

Это событие выполняется до считывания данных с сервера. Поэтому тут все сводится к тому, какие данные необходимо получить с сервера, а какие нет. Это особенно критично для ТС с большим набором данных, таких как: РКК, Поручения, Договоры и т.д. Так же влияние оказывает количество реквизитов в наборе данных, проще говоря – количество полей таблицы MBAnalit. Существуют заказные разработки DIRECTUM, где количество реквизитов справочника в несколько раз больше, чем в самых «толстых» справочниках стандартной версии.

Для ограничения загружаемых данных можно использовать метод AddWhere:

  // Получить код главной НОР
  OurOrgCode = Конст("КОДГЛОРГ") 
  // Получить ИД главной НОР (данная функция доступна с версии IS-Builder 7.9.2)
  ReferenceRequisiteValue('НОР'; OurOrgCode; SYSREQ_ID)
  AddWhereStr = Format("%s.%s = %s"; ArrayOf(
    Object.TableName;
    Object.Requisites(SYSREQ_OUR_FIRM).SQLFieldName;
    OurOrgID))
  // Отфильтровать справочник по Нашей Организации
  AddWhereID = Object.AddWhere(AddWhereStr)
  // Записать AddWhereID в переменную окружения
  Object.Environment.SetVar('ADD_WHERE_ID'; AddWhereID)
  
  // ***Событие Набор Данных – Закрытие***
  // Не забыть удалить заданное ограничение
  Environment = Object.Environment
  // Проверить, что в окружении есть переменная с нужным именем
  if Environment.IndexOfName('ADD_WHERE_ID') > -1
    AddWhereID  = Object.Environment.PopVar('ADD_WHERE_ID')
    // Удалить ограничение 
    Object.DelWhere(AddWhereID)
  endif

Также можно использовать специальную функцию СпрИзмНабДан(): 

  // Получить код главной НОР
  OurOrgCode = Конст("КОДГЛОРГ") 
  // Получить ИД главной НОР 
  OurOrgID = СпрРекв("НОР"; OurOrgCode; SYSREQ_ID)
  AddWhereStr = Format("%s.%s = %s"; ArrayOf(
    Object.TableName;
    Object.Requisites(SYSREQ_OUR_FIRM).SQLFieldName;
    OurOrgID))

  // Отфильтровать справочник по Нашей Организации
  СпрИзмНабДан(;; AddWhereStr)

Так же можно манипулировать загрузкой реквизитов с помощью свойства Preloaded:

  // Не загружать значение реквизита Дополнение
  Object.Requisites('Дополнение').Preloaded = FALSE

В результате, в форме-списке справочника все значения для реквизита Дополнения окажутся пустыми. При открытии конкретной записи данные подгрузятся с сервера.

  // Получить объект типа IRequisite
  AdditionReq = Object.Requisites('Дополнение')
  // Отключить вычисления на реквизите Дополнение
  AdditionReq.Events.Events(reOnChange).Enabled = FALSE
  // Присвоить значение
  AdditionReq Value = <значение>
  // Включить вычисления на реквизите обратно
  AdditionReq.Events.Events(reOnChange).Enabled = TRUE

Также в этом событии, при необходимости, нужно очищать значения реквизитов, если запись была скопирована:

  if Object.Copied
    UncopiedReqArray = ArrayOf("Реквизит1"; "Реквизит2"; "Реквизит3")
    foreach ReqName in CArrayElement(UncopiedReqArray)  
      CurrentRequisite = Object.FindRequisite(ReqName)
      if Assigned(CurrentRequisite)
        CurrentRequisite.Value = NULL
      endif 
    endforeach
  endif

Запись – Открытие

Событие выполняется при открытии карточки существующей записи и при открытии карточки вновь добавляемой записи. В случае ошибки в вычислениях события выводится сообщение об ошибке и  открытие записи отменяется.

Если идет работа с версией IS-Builder (до 7.7.0.1601/7.8.3.1011), в которой еще нет события «Форма-карточка – Показ», то в этом событии можно управлять доступностью реквизитов, кнопок, таблиц и др. элементов формы, перед этим обязательно проверив, что происходит визуальная работа с карточкой.

  if not VarIsNull(Object.View) and InteractiveMode()
    <вычисления>
  endif

Во всех остальных случаях управлять доступностью элементов формы нужно в событии «Форма-карточка – Показ».

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

Не рекомендуется  производить в этом событии автоматическое формирование отчетов и других расчетов, которые могут быть произведены уже после открытия. Это может сильно снизить производительность системы. Если нужен отчет, то следует сделать специальное действие, при активации которого отчет будет выполняться.

Внимание! Событие срабатывает не только при программном или визуальном открытии записи, но и при открытии свойств записи в списке записей (пункт меню Файл/Свойства записи).

  // Определить, открываются ли свойства записи можно таким кодом:
  if Object.Params.IndexOfName(SHOW_RECORD_PROPERTIES_FORM) > -1
    // Открылись свойства записи
  endif

Продолжение следует...