|
<html><head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>Автоматизированная библиотечно-информационная система "Руслан-Нео"</title><link rel="stylesheet" type="text/css" href="http://demo.ruslan.ru/doc.css"><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="ru" class="set"><div class="titlepage"><div><div><h1 class="title"><a name="d154e1"></a>Автоматизированная библиотечно-информационная система
|
|
"Руслан-Нео"</h1></div></div><hr></div><div class="set" lang="ru"><div class="titlepage"><div><div><h1 class="title"><a name="d154e7"></a>Модуль <span class="application">"Аудит"</span></h1></div></div><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="d154e15"></a>Руководство системного программиста</h1></div><div><div class="author"><h3 class="author"><span class="orgname">ООО "Открытые библиотечные системы"</span></h3></div></div><div><div class="author"><h3 class="author"><span class="firstname">Рустам</span> <span class="surname">Усманов</span></h3></div></div><div><p class="releaseinfo">
|
|
Версия
|
|
1.3.0
|
|
</p></div><div><p class="copyright">Авторские права © 2017, 2018, 2019, 2020, 2021 ООО "Открытые библиотечные системы"</p></div></div><hr></div><div class="toc"><dl class="toc"><dt><span class="preface"><a href="#preface">Аннотация</a></span></dt><dt><span class="chapter"><a href="#general">1. Общие сведения о программе</a></span></dt><dt><span class="chapter"><a href="#structure">2. Структура программы</a></span></dt><dt><span class="chapter"><a href="#installation-configuration">3. Настройка программы</a></span></dt><dd><dl><dt><span class="section"><a href="#installation">3.1. Установка программы</a></span></dt><dt><span class="section"><a href="#configuration">3.2. Настройка программы</a></span></dt></dl></dd><dt><span class="chapter"><a href="#d154e285">4. Проверка программы</a></span></dt><dt><span class="chapter"><a href="#d154e299">5. Дополнительные возможности</a></span></dt><dt><span class="chapter"><a href="#d154e310">6. Сообщения системному программисту</a></span></dt><dt><span class="glossary"><a href="#abbreviations">Перечень сокращений</a></span></dt></dl></div><div class="preface"><div class="titlepage"><div><div><h1 class="title"><a name="preface"></a>Аннотация</h1></div></div></div><p>
|
|
В данном документе приведены общие сведения о модуле <span class="application">"Аудит"</span>
|
|
<a class="glossterm" href="#ab-abis"><em class="glossterm"><a class="glossterm" href="#ab-abis" title="АБИС">AБИС</a></em></a> <span class="application">"Руслан-Нео"</span>.
|
|
Описаны порядок настройки и проверки, дополнительные возможности.
|
|
</p></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="general"></a>Глава 1. Общие сведения о программе</h1></div></div></div><p>
|
|
Модуль <span class="application">"Аудит"</span>
|
|
<a class="glossterm" href="#ab-abis"><em class="glossterm"><a class="glossterm" href="#ab-abis" title="АБИС">АБИС</a></em></a>
|
|
<span class="application">"Руслан-Нео"</span> предназначен для сбора и сохранения сведений о различных событиях, происходящих в
|
|
<a class="glossterm" href="#ab-abis"><em class="glossterm"><a class="glossterm" href="#ab-abis" title="АБИС">АБИС</a></em></a>
|
|
<span class="application">"Руслан-Нео"</span>. Поддерживается обработка следующих типов событий:
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>События хранилища данных (репозитория контента
|
|
<a class="glossterm" href="#ab-jcr"><em class="glossterm"><a class="glossterm" href="#ab-jcr" title="JCR">JCR</a></em></a>)
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>Создание узла (базы данных или записи)</p></li><li class="listitem"><p>Удаление узла (базы данных или записи)</p></li><li class="listitem"><p>Перемещение узла (базы данных или записи)</p></li><li class="listitem"><p>Создание свойства базы данных или записи</p></li><li class="listitem"><p>Изменение свойства базы данных или записи</p></li><li class="listitem"><p>Удаление свойства базы данных или записи</p></li><li class="listitem"><p>Добавление списка управления доступом (<a class="glossterm" href="#ab-acl"><em class="glossterm"><a class="glossterm" href="#ab-acl" title="ACL">ACL</a></em></a>)</p></li><li class="listitem"><p>Удаление списка управления доступом (<a class="glossterm" href="#ab-acl"><em class="glossterm"><a class="glossterm" href="#ab-acl" title="ACL">ACL</a></em></a>)</p></li><li class="listitem"><p>Выдача пользователю полномочий для работы с базами данных или записями</p></li><li class="listitem"><p>Отзыв у пользователя полномочий для работы с базами данных или записями</p></li></ul></div><p>
|
|
</p></li><li class="listitem"><p>События web-интерфейса ресурсов
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p>Создание сеанса</p></li><li class="listitem"><p>Изменение идентификатора сеанса</p></li><li class="listitem"><p>Завершение сеанса</p></li><li class="listitem"><p>Вызов метода</p></li></ul></div><p>
|
|
</p></li></ul></div><p>
|
|
</p><p>Хранение сведений о событиях осуществляется сервером
|
|
<a class="link" href="http://lucene.apache.org/solr/" target="_top"><span class="application">Solr</span></a>,
|
|
используемым сервером <span class="application">"Руслан-Нео"</span>.</p><p>Модуль <span class="application">"Аудит"</span> может функционировать на любых
|
|
технических средствах под управлением сервера приложений
|
|
<a class="link" href="http://wildfly.org" target="_top"><span class="application">WildFly</span></a> версии 10.*.</p><p>
|
|
Необходимыми условиями для работы модуля <span class="application">"Аудит"</span>
|
|
являются:
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"><p>
|
|
наличие в конфигурации сервера
|
|
<span class="application">WildFly</span> следующих очередей сообщений:
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><code class="literal">java:/jms/topic/ruslan/createUpdateRecord</code> - очередь сообщений хранилища данных</p></li><li class="listitem"><p><code class="literal">java:/jms/topic/ruslan/wsOperations</code> - очередь сообщений web-интерфейса ресурсов</p></li></ul></div><p>
|
|
</p></li><li class="listitem"><p>
|
|
наличие в конфигурации сервера
|
|
<span class="application">WildFly</span> следующих общих параметров базовых сервисов
|
|
<a class="glossterm" href="#ab-abis"><em class="glossterm"><a class="glossterm" href="#ab-abis" title="АБИС">АБИС</a></em></a> <span class="application">"Руслан-Нео"</span>:
|
|
</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"><p><em class="parameter"><code>java:global/ruslan/config/{сигла библиотеки}/solrURL</code></em></p></li><li class="listitem"><p><em class="parameter"><code>java:global/ruslan/config/{сигла библиотеки}/license</code></em></p></li></ul></div><p>
|
|
</p></li><li class="listitem"><p>наличие лицензионного файла с указанием на лицензирование модуля <span class="application">"Аудит"</span>
|
|
в месте, заданном при помощи вышеуказанного параметра <em class="parameter"><code>java:global/ruslan/config/{сигла библиотеки}/license</code></em>
|
|
</p></li><li class="listitem"><p>
|
|
возможность взаимодействия с сервером <span class="application">Solr</span>
|
|
версии
|
|
<a class="link" href="http://archive.apache.org/dist/lucene/solr/6.3.0/" target="_top">6.3.0</a>
|
|
</p></li><li class="listitem"><p>
|
|
наличие коллекции <code class="literal">rneo-audit</code> на сервере <span class="application">Solr</span>
|
|
</p></li></ul></div><p>
|
|
</p></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="structure"></a>Глава 2. Структура программы</h1></div></div></div><p>Модуль <span class="application">"Аудит"</span>
|
|
состоит из следующих компонентов:
|
|
</p><div class="orderedlist"><ol class="orderedlist" type="1"><li class="listitem"><p>
|
|
<code class="filename">rneo-audit*.ear</code>
|
|
- модуль <span class="application">"Аудит"</span>.
|
|
</p></li></ol></div><p>
|
|
</p></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="installation-configuration"></a>Глава 3. Настройка программы</h1></div></div></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="installation"></a>3.1. Установка программы</h2></div></div></div><p>
|
|
Установка программы заключается в
|
|
<a class="link" href="https://docs.jboss.org/author/display/WFLY10/Application+deployment" target="_top">развёртывании
|
|
<code class="filename">rneo-audit*.ear</code> на сервере приложений WildFly.
|
|
</a>
|
|
</p></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="configuration"></a>3.2. Настройка программы</h2></div></div></div><p>Настройка модуля <span class="application">"Аудит"</span> осуществляется при помощи дескриптора развёртывания
|
|
<code class="filename">rneo-audit*.ear/rneo-audit-ejb.jar/META-INF/ejb-jar.xml</code>. В этом дескрипторе значение записи окружения
|
|
<code class="literal">com.ols.ruslan.neo.indexing.solr.JcrEventIndexManager/trackFieldChangeExpression</code> содержит
|
|
XPath-выражение, используемое для отбора тех полей служебных записей, изменение значения которых требуется фиксировать при
|
|
сохранении сведений о событии изменения служебной записи. Например, для отслеживания изменений в полях 105 и 106 можно использовать следующее
|
|
значение записи окружения: <code class="literal">/record[@syntax="1.2.840.10003.5.105"]/tag[@tagValue="105" or @tagValue="106"]</code>.</p></div></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="d154e285"></a>Глава 4. Проверка программы</h1></div></div></div><p>
|
|
Проверка развёртывания модуля <span class="application">"Аудит"</span> осуществляется при помощи
|
|
средств управления <span class="application">WildFly</span>.
|
|
При неуспешном развёртывании указание на причины следует искать в журнале <span class="application">WildFly</span>.
|
|
</p></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="d154e299"></a>Глава 5. Дополнительные возможности</h1></div></div></div><p>Модуль <span class="application">"Аудит"</span> не обладает иными возможностями, помимо указанных в <a class="link" href="#general" title="Глава 1. Общие сведения о программе">Главе 1</a>.</p></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a name="d154e310"></a>Глава 6. Сообщения системному программисту</h1></div></div></div><p>Сообщения системному программисту выводятся в журнал <span class="application">WildFly</span>.</p></div><div class="glossary"><div class="titlepage"><div><div><h1 class="title"><a name="abbreviations"></a>Перечень сокращений</h1></div></div></div><dl><dt><a name="ab-acl"></a><span class="glossterm">ACL</span></dt><dd class="glossdef"><p>Access Control List</p></dd><dt><a name="ab-jcr"></a><span class="glossterm">JCR</span></dt><dd class="glossdef"><p>Java Content Repository</p></dd><dt><a name="ab-abis"></a><span class="glossterm">АБИС</span></dt><dd class="glossdef"><p>Автоматизированная библиотечно-информационная система</p></dd></dl></div></div></div></div></body></html>
|