Руководство администратора

Компоненты  Артефакта

Для работы Артефакта необходимы следующие основные компоненты: загрузчик баз данных, программа-администратор и сам Артефакт-сервер.

Организация работы Артефакт-сервера должна начаться с генерации баз, с которыми будет работать Артефакт. Затем необходимо вызвать программу-администратор, которая находится в директории iaadmin и называется UserList.exe.

Назначение программы UserList

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

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

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

Запуск прогаммы UserList

Программа UserList написана на Visial Basic и представляет диалоговое приложение с графическим интерфейсом, предназначенное для администратора системы Артефакт.

При первом запуске UserList попросит указать путь к тому каталогу, в котором находится файл ia_price.lst (находящийся внутри каталога ia внутри домашнего каталога Aртефакт-сервера). В результате этого UserList, запомнит расположение файлов с учетной информацией в файле UserList.ini в том же каталоге, где находится файл UserList.exe.

Если впоследствии расположение домашнего каталога Артефакт-сервера изменится, файл UserList.ini следует уничтожить, в результате чего UserList вновь запросит путь к ia_price.lst.

Базы и темы

Предполагается, что все базы, которые сгенерированы загрузчиком баз данных и должны быть включены в Артефакт, разбиваются по тематическим группам(темам). Каждая тема должна иметь собственное имя (уникальное). Первый раз в начале работы UserList надо выбрать закладку  Темы и базы и затем зарегистрировать   придуманные вами темы, нажав кнопку Новая тема. При этом раскрывается диалог, в котором вам предлагается ввести русское имя темы, а также имя темы по-английски. (Английский вариант имени не обязателен, однако, если он есть, те пользователи, которые захотят работать в режиме английского языка, будут видеть в качестве имен тем  английские варианты). Введя имя темы, нажмите кнопку OK и тема зарегистрируется. Список баз данной темы пока будет пустой. Повторите эту процедуру для каждой темы.

Замечание:при работе с Артефактом списки тем на сгенерированных HTML-страницах расположены в алфавитном порядке по именам, списки баз внутри тем и в окошке выбора баз также в алфавитном порядке. Если вы хотите расположить темы   на страницах в ином порядке, к имени темы впереди можно добавить 2 цифры числового префикса и точку. Этот префикс влияет на порядок сортировки тем, но не будет показан в имени темы.

Регистрация базы данных

После этого надо начать процесс регистрации баз. На той же закладке (Темы и базы) нажмите кнопку Новая база и перед вами откроется диалог для регистрации новой базы.

Каждая база должна иметь уникальное русское имя и необязательный английский вариант имени(см. выше). Кроме того, каждая новая база получает   двухбуквенный идентификатор, который программма генерирует сама  при регистрации новой базы, и который не следует менять произвольно. Кроме того, необходимо задать путь к базе (полный путь к  одному из файлов базы без расширения). Лучше всего нажать кнопку Путь , после чего отыскать базу в дереве директорий (программа ищет файл базы с расширением  ._in).

Внимание! При описании пути необходимо указывать сетевое имя диска (начинается с \\), а не имя дисковода (букву с двоеточием). Поэтому, возможно, придется это поправить вручную после того, как будет выбрана база при помощи кнопки Путь и поиска базы в директориях.

Ниже вы увидите список зарегистрированных вами тем(они же группы баз). Необходимо выбрать тему, к которой относится база, кликнув по одной из тем.

Таблица цен и констант

Затем задаются условия оплаты информации для этой базы. Цены задаются обычно в символическом виде - названием констант, значение же константы можно установить( или посмотреть), нажав кнопку Таблица цен и констант.  Способ подсчета стоимости работ будет описан позднее. Пока же рекомендуем выбрать значения d_СТАНДАРТ и k_СТАНДАРТ для стоимости в центах документа и килобайта базы соответственно.

Список пользователей базы пока пуст, в дальнейшем при работе с любой базой (старой или новой) можно определить список пользователей этой базы, нажав кнопку Список пользователей.

Описав всю необходимую информацию о базе, нажмите кнопку OK. База зарегистрируется и перед вами вновь окажется закладка Темы и базы. Затем аналогичным путем зарегистрируем следующую базу и так далее. Заметим, что запись на диск всей новой информации о темах, базах и пользователях  произойдет только при выходе из программы UserList  с помощью кнопки OK или Обновить все.

Регистрация пользователей

Самой обычной и частой процедурой для UserList является регистрация новых пользователей или изменение информации для уже зарегистрированных. Выберем закладку Пользователи по алфавиту(она удобнее, пока мало или вообще нет пользователей) или закладку Группы пользователей.  Чтобы зарегистрировать пользователя, нажмите кнопку Новый на выбранной закладке. Откроется диалог для определения информации пользователя. Имя пользователя - это то имя, которое используется для входа в Артефакт(это имя  должно быть не длиннее 20 символов и не должно содержать пробелы), комментарий - текст, который поможет  администратору вспомнить что-то о пользователе (появляется в скобках вслед за именем в списках пользователей). Пароль и его подтверждение очевидно должны совпадать.

Далее следуют опции(параметры) пользователя.

Категории пользователей

Платный пользователь:
- означает, что расходы этого пользователя будут учитываться в суммарной статистике (например, для расчетов с поставщиками баз). Расходы бесплатного пользователя в суммарной статистике не учитываются.
Коллективный пользователь:
- разрешается одновременная работа нескольких пользователей с таким именем, статистика расходов всех пользователей с этим именем суммируется, однако корзина(см.описание) не хранится между сеансами. Обычно это бывает, когда  организация или группа подписывается как один пользователь. У всех пользователей с таким именем общий счет.
Администратор:
- устанавливается только для администратора системы. Если установлена эта опция,  в начале HTML-страницы с журналом пользователя появляется дополнительная ссылка Администратор. Пойдя по этой ссылке, администратор системы cможет увидеть список активных пользователей Артефакта в данный момент. Далее идут сведения о размерах памяти под "внутренний кеш" (информация нужна только разработчикам).
Просмотр новостей:
- если вы не купили право на организацию новостной службы, не надо устанавливать эту опцию.
Показ расходов в долларах:
- эта опция не зависит от того, является ли пользователь платным. Если эта опция установлена, при показе пользователю журнала кроме статистики ему показывается стоимость его работ в долларах.
Ограничения:
- пользователь может работать безо всяких ограничений, или быть ограниченным во-времени(подписка до...) или долларовым счетом. При этом не важно, является ли пользователь платным или нет: например, можно предоставить "гостю" работать бесплатно, например, неделю или пока не "истратит" условные 100 долларов. Сотрудники же могут работать бесплатно без ограничений. С другой стороны платные пользователи могут работать безо всяких ограничений, если вы уверены в их кредитоспособности, или могут оплатить подписку вперед на месяц, или могут внести на счет некую сумму и работать, пока она не исчерпается. Конечно же, администратор может в любой момент изменить условия работы любого пользователя или вообще удалить его. Пользователь, который ограничен долларовой суммой, может получить от вас кредит. При этом его счет может стать отрицательным, но он может работать, пока не исчерпает кредит. При отрицательном счете и работе в кредит в журнале будет появляться предупреждение. 
Процент оплаты или расчета:
любое число от 1 до 100. По умолчанию равно 100 процентов. Стоимость работы умножается на этот процент при подсчетах.

Базы данных доступные пользователю

После установки всех опций необходимо отметить базы, с которыми пользователь имеет право работать. Так как баз может быть достаточно много, их список изображен в виде дерева по темам. Можно отметить  сразу все имеющиеся базы, нажав кнопку Отметить все, соответственно снять отметку у всех баз сразу , нажав кнопку Снять отметку. Можно отметить отдельную базу или целую тему, встав на базу или тему и кликнув правой кнопкой мыши.( Кнопки Раскрыть и Свернуть используются для раскрытия и свертывания дерева тем.) Отмеченные базы   помечены в дереве знаком "+", неотмеченные знаком "-", темы, в которых отмечены все базы "+"  в синем квадратике, темы, в которых нет отмеченных баз   "-" в черном квадратике, темы в которых есть и отмеченные и неотмеченные базы - желтым квадратиком с "+" и "-".

После того, как вы отметили базы, с которыми может работать пользователь, нажмите кнопку OK. Пользователь зарегистрирован (окончательно только при выходе из UserList, см. выше).

Разбиение пользователей на группы

Разбиение пользователей на группы происходит автоматически при окончании регистрации информации пользователя (выход по кнопке OK)  в зависимости от установленных  опций. Пользователь, работающий с отрицательным счетом, но не исчерпавший пока  кредит, получает иконку  "!" в белом квадратике, пользователь, исчерпавший кредит или с просроченной подпиской, получает иконку "!" в желтом квадратике(такой пользователь не может работать).

Завершение работы с UserList

После того, как вы произвели регистрацию всех нужных баз и пользователей Артефакта, завершите работу программы UserList, нажав кнопку OK Только после этого можно запускать Артефакт-сервер.

В дальнейшем программу UserList можно запускать, не останавливая сервер. Когда работа UserList   завершается (выход по кнопке ОК), Артефакт проверяет для каждого работающего пользователя, надо ли ему входить заново в Артефакт.  Если изменилась информация о базах, темах или таблица цен и констант, входить заново будет необходимо всем пользователям (это касается всех). Если менялась только информация о конкретных пользователях, то входить заново придется только тем пользователям, которые были затронуты изменениями.

Корректирование информации о темах, базах и пользователях

UserList позволяет не только вводить новые темы, бызы и пользователей, но и удалять и корректировать информацию о них.

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

Для удаления элемента нажмите кнопку Удалить. При этом UserList потребует подтверждения.
Заметим, что удалить тему можно только тогда, когда она не содержит баз. Поэтому вначале перенесите базы из этой темы в другую (или удалите их, если нужно), а только потом можно удалить тему.

Перенести базу/базы из темы в тему можно следующим образом. Выбрать на закладке Темы и базы ту тему, состав которой будет меняться и дважды кликнуть по ней. Откроется диалог для коррекции этой темы. Внизу слева вы увидите список баз данной темы. Справа есть выпадающий список остальных тем. Выбрав одну из них, вы получите список баз выбранной темы. Далее вы можете переносить любые базы или группы баз из одного списка в другой, отмечая базы или группы баз и используя кнопки со стрелочками. Не выходя из этого диалога, вы можете несколько раз менять тему справа и перемещать базы в разные темы. Все перестановки зафиксируются, когда вы выйдете из этого диалога по кнопке ОК.

Просмотр статистики

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

Выход из UserList и общая статистика

Под формой с закладками находятся кнопки общего назначения.

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

Подсчет стоимости работ

Стоимость всех работ пока подсчитывается в долларах и центах. Все константы для подсчета стоимости задаются в символьном виде и принимают конкретные значения в Таблице цен и констант (добраться до этой таблицы можно через любую базу, см.выше).

Следующие работы имеют цену:

Вы можете менять систему оплаты, меняя константы QUERY, LIDS, d_СТАНДАРТ,  k_СТАНДАРТ в таблице цен и констант,  а также вводя новые константы и их значения для цены документа и килобайта. Все константы в таблице должны быть целыми неотрицательными числами.

Заметим, что Артефакт хранит внутри себя в течение  всего сеанса  пользователя информацию об оплаченных работах, чтобы не брать дважды за одно и то же.

Настройка Артефакт-сервера

В Таблице цен и констант есть константы,   относящиеся к настройке Артефакта. Если константы нет в таблице, берем значение по умолчанию.