IBM Enterprise Records, Версия 5.1.2    

Обработчики событий

IBM® Enterprise Records содержит приведенные ниже примеры событий для базовой модели данных, моделей DoD и PRO.

Примеры можно настраивать, как требуется. Смотрите файл readme в папке События в программном пакете.

Табл. 1. События и описания
События Описание
RMAutoDeclare

Конфигурирует автообъявление записей. Когда пользователь выполняет определенную операцию (такую как регистрация файла в папке) над документом на складе объектов записей (Records Object Store, ROS), IBM Enterprise Records автоматически создает соответствующую электронную запись на складе объектов конкретного плана размещения (file plan object store, FPOS). Можно также сконфигурировать этот пример события, чтобы объявлялись все документы, принадлежащие конкретному классу документов, когда пользователь их активирует.

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

RMAutoSynchronizeProperties

Синхронизирует свойства записей и связанных с ними документов. Например, когда пользователь изменяет значение свойства записи, IBM Enterprise Records обновляет также значение соответствующего свойства в документах, связанных с этой записью.

Этот пример события работает для свойств, которые используют одно и то же символическое имя. Можно синхронизировать либо запись с документом, либо документ с записью, но не в обе стороны одновременно. Если синхронизируется документ с записью, IBM Enterprise Records изменяет документ, когда изменяется соответствующее свойство записи.

Это событие также синхронизирует псевдонимы свойства на разных складах объектов, либо документ с записью, либо запись с документом, но не в обе стороны одновременно.

RMUpdateDateDeclared

RMLastRetrievalOfRecord

Вместе эти примеры событий задают, когда пора утилизировать контейнер. Кроме того, эти примеры событий предотвращают утилизацию по расписанию контейнеров, если в них недавно объявлены или из них недавно получены записи.

Когда пользователь объявляет запись, IBM Enterprise Records применяет этот пример события к классам Volume и Box и задает свойство Дата последнего объявления для родительской папки.

Для модели данных PRO IBM Enterprise Records автоматически подписывает событие RMUpdateDateDeclared на класс Volume или Box, и вы должны разрешить это событие. Для других моделей данных необходимо выполнить сценарий импорта, чтобы создать событие RMUpdateDateDeclared и подписаться на класс Volume или Box.

RMLastRetrievalOfRecord задает дату последнего анализа содержимого записи как значение для свойства LastRetrievalofRecord папки.

RMSecurityPropagation

(Только в PRO) Этот пример события используется только в модели данных PRO, где задает значение пометки свойства Категория защиты для записи, тома и папки записей (но не для категории записей), основываясь на самом высоком из уровней в соответствующем объекте.

Например, при распространении значений из записи в папку IBM Enterprise Records изменяет уровень защиты родительской папки, если у записи он выше. Остальные папки, в которых размещена эта запись, не изменяются.

При распространении значений из папки в запись IBM Enterprise Records понижает уровень защиты записей с самым низким уровнем защиты до самого высокого уровня защиты их родительских папок.

Распространением уровня защиты управляет значение в разделе Конфигурация системы для PRO FPOS. Возможно распространение из папки в запись, из записи в папку, в обе стороны или запрет распространения.

RMSendEmailOnSupercede

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

Ограничение: Это событие не поддерживается в JBoss или WebLogic.

Файлы JAR IBM Enterprise Records примера обработчика событий хранятся как модули программного кода на складе объектов назначения. Преимущества этого в том, что можно добавлять и обновлять обработчики событий, активируя новую версию, без перезапуска сервера прикладных программ. Сконфигурируйте примеры событий IBM Enterprise Records, как описано ниже:

Создать действия для события

Прежде чем выполнить описанный ниже порядок действий, убедитесь, что папка с именем CodeModules существует под корневой папкой склада объектов, где вы собираетесь создать действия для события. Если такая папка не существует, создайте ее, выполнив указания в публикации IBM FileNet P8 Platform Installation and Upgrade Guide.

Чтобы создать действия событий:
  1. Скопируйте папку под корнем CD, ~CDRoot\RecordsManager.<платформа>\События, на сервер, где запускается IBM Administration Console for Content Platform Engine. Эта папка содержит сценарии импорта, файлы JAR и файлы конфигурации.
  2. Создайте нужные вам действия для события, запустив соответствующие сценарии импорта.
    1. Щелкните правой кнопкой мыши по складу объектов назначения IBM Enterprise Records.
    2. Выберите Импортировать все.
    3. В диалоговом окне Помощник по импорту на вкладке Опции импорта в поле Импортировать файл манифеста найдите скопированную вами папку. Выберите сценарий импорта для нужного события. Все файлы названы как события. Например, файл импорта для события RMAutoDeclare назван RMAutoDeclareImport.xml.
    4. В поле Путь внешнего содержимого найдите папку ~\Events\lib.
    5. Нажмите кнопку Импорт.

    По завершении импорта появится сообщение "Импорт завершен успешно". Действие события можно создать под папкой Действие события на складе объектов. Модули программного кода создаются в папке Модуль программного кода.

Настроить файлы конфигурации

У событий RMAutoDeclare и RMSendEmailOnSupercede есть свои файлы конфигурации. Сценарий импорта создает файлы на складе объектов:

Зарезервируйте файл конфигурации либо из Workplace, либо из Workplace XT, либо из IBM Administration Console for Content Platform Engine. Завершив редактирование, активируйте файл снова. Дополнительную информацию смотрите в разделе справки Конфигурирование автообъявления записей. В файле RMSendEmailOnSupercede каждой редактируемой строке предшествует самоописывающий комментарий: хост SMTP, номер порта, электронный адрес отправителя и получателя.

Создать подписки

Для каждого события требуется подписка на один или несколько классов.

Подписка на событие RMAutoDeclare

Чтобы создать подписку:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/ROS/Класс Document или подкласс, где хотите создать подписку.
  2. Щелкните правой кнопкой мыши по классу и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Активация.
  6. На экране Задать действие события выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства выключите переключатель Синхронный, для каждого события включите или выключите как нужно переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на класс Folder или на его подкласс:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/ROS/Класс Folder или подкласс, где хотите создать подписку.
  2. Щелкните правой кнопкой мыши по классу и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Размещение записи в папке.
  6. Выключите переключатель Синхронный, включите или выключите как нужно переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на конкретную папку в ROS:
  1. В IBM Administration Console for Content Platform Engine перейдите к папке, в которой необходимо создать подписку.
  2. Щелкните правой кнопкой мыши по папке и выберите Новая подписка.
  3. Задайте для подписки уникальное имя и описание.
  4. Примите значение по умолчанию.
  5. Выберите триггер события Размещение записи в папке.
  6. На экране Задать действие события выберите события RMAutoDeclare.
  7. На экране Задать дополнительные свойства выключите переключатель Синхронный, примите остальные значения по умолчанию и завершите работу с мастером.

Подписка на событие RMAutoSynchronizeProperties

Подписка на событие RMAutoSynchronizeProperties синхронизирует запись с ее исходным документом или исходный документ с записью.

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

Чтобы задать синхронизацию записи с ее исходным документом:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/ROS/Класс Document или его подкласс.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Изменение.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Синхронный, но выключите переключатель Включить подклассы и завершите работу с мастером.
Чтобы задать синхронизацию исходного документа с его записью:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/ROS/Класс Document или его подкласс.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Изменение.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Синхронный, но выключите переключатель Включить подклассы и завершите работу с мастером.

Подписка на событие RMLastRetrievalOfRecord

Чтобы подписаться на событие RMLastRetrievalOfRecord:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/FPOS/Другие классы/CustomObject/RM System.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Создание.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Включить подклассы, включите переключатель Синхронный и завершите работу с мастером.

Подписка на событие RMSecurityPropagation (только для PRO)

Подписку на это событие можно создать для класса Record Folder (папка записей), Volume (том) или Record (запись).

Чтобы подписаться на событие для класса Record Folder:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/PRO-FPOS/Другие классы/Folder/RM Folder/класс Record Folder.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггеры события Размещение записи в папке и Изменение.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на событие для класса Volume:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/PRO FPOS/Другие классы/Folder/RM Folder/Класс Volume.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггеры события Размещение записи в папке и Изменение.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства выключите переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на событие для класса Record:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/PRO-FPOS/Класс Document/Класс Record.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Изменение.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Включить подклассы и завершите работу с мастером.

Подписка на событие RMSendEmailOnSupercede

Чтобы подписаться на событие RMSendEmailOnSupercede:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/FPOS/Класс Document/Класс Record.
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Изменение и Активация.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства включите переключатель Включить подклассы и завершите работу с мастером.

Подписка на событие RMUpdateDateDeclared

Для модели данных PRO нужно разрешить уже существующее событие. Чтобы разрешить существующее событие:
  • В IBM Administration Console for Content Platform Engine перейдите в папку Склады объектов/FPOS/События/Действие события.
  • Щелкните правой кнопкой мыши по UpdateDateDeclared.
  • Щелкните по Разрешить.

Для моделей DoD и Base после создания события подпишитесь на классы Record Category (категория записи), Volume (том) и Box (ящик).

Чтобы подписаться на событие для класса Record Category:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/<FPOS>/Другие классы/Folder/RM Folder/Record Category
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Размещение записи в папке.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства выключите переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на событие для класса Volume:
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/FPOS/Другие классы/Folder/RM Folder/Volume
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Размещение записи в папке.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства выключите переключатель Включить подклассы и завершите работу с мастером.
Чтобы подписаться на событие для класса Box (ящик):
  1. В IBM Administration Console for Content Platform Engine перейдите в класс Склады объектов/FPOS/Другие классы/Folder/RM Folder/Physical Container/Box
  2. Щелкните правой кнопкой мыши и выберите Добавить подписку.
  3. Задайте для подписки уникальное имя и описание.
  4. Выберите радиокнопку Применить для всех экземпляров.
  5. На экране Задать триггеры выберите триггер события Размещение записи в папке.
  6. Выберите импортированное вами действие события.
  7. На экране Задать дополнительные свойства выключите переключатель Включить подклассы и завершите работу с мастером.

Информацию о настройке событий смотрите в программном пакете FileNet P8.



Отзыв

Последнее обновление: Ноябрь 2013 г.
work_with_event_handlers.htm

© Copyright IBM Corp. 2013