$Id: README.html,v 1.1 2006/06/29 19:12:18 aleko Exp $

    TblEdit - CGI скрипт редактирования таблицы БД

    Описание
    ~~~~~~~~
    Программа предназначена для просмотра таблиц БД (или других данных,
    возвращаемых по запросу SELECT...) и их построчного просмотра и
    редактирования.
    Доступ к БД осуществляется посредством perl модуля DBI.

    В программе реализовано три основных режима работы с таблицей БД:
      1. Просмотр заданных полей всех строк таблицы
      2. Детальный просмотр полей одной строки таблицы
      3. Редактирование полей одной строки таблицы

    Также реализовано добавление новой строки, удаление строки и т.п.

    Настройки программы разделены на три группы -
      1. Данные для доступа к БД и настройкам второй группы.
      Задаются в .htaccess или аналогичном месте.
      Описание - см. ниже "Конфигурация" файл html/.htaccess.
      2. Индивидуальные настройки для работы с таблицей БД.
      Задаются строкой в таблице БД, структура которой описана в 
      документации к TblEdit.pm. Включают SQL запрос для доступа к
      настройкам группы 3.
      3. Настройки полей для режима просмотра/редактирования строки
      таблицы. Хранятся в таблице, где для каждого поля редактируемой
      таблицы заданы такие данные, как тип, порядок в списке, значение 
      по умолчанию и т.п.

      Подробное описание настроек групп 2 и 3 есть в документации пакета
      TblEdit и комментариях полей создаваемых при генерации схемы данных
      таблиц.

    Сохранение изменений в БД производится посредством вызова хранимой
    процедуры (в списке ее аргументов - тип операции insert/update),
    которая при ошибках возвращает таблицу вида "имя поля - текст ошибки".
    Этот метод выбран как первичный по следующим причинам:
      1. Если пользователь при вводе сделал несколько ошибок, то
      в случае триггера их коды придется зашивать в текстовую
      строку, возвращаемую RAISE EXCEPTION (в PostgreSQL)
      1. SELECT позволяет получить выборку из нескольких таблиц и
      редактирование его результатов не всегда может быть реализовано
      тривиально, что легко может быть решено с помощью хранимой процедуры.
    Вместе с тем, возможность использовать просто запросы вида INSERT.. и
    UPDATE.. также реализована.

    Конфигурация
    ~~~~~~~~~~~~
    Для работы скрипта необходимы следующие параметры, которые
    задаются в httpd.conf, .htaccess или иным способом помещаются в %ENV:

	    Параметры для модуля DBI:
        TBLEDIT_DSN	  - строка соединения с БД
        TBLEDIT_USER	- Пользователь БД
        TBLEDIT_AUTH	- Пароль

	    Собственные параметры:
        TBLEDIT_SQL_INIT  - SQL запрос настройки БД после соединения с ней
        TBLEDIT_SQL       - SQL запрос для получения конфигурации tableConfig
        TBLEDIT_LOG_LEVEL - уровень отладки. Сумма кодов желаемых отладочных
          данных. В программе используются следующие коды:
            1  - агрументы SQL, изменивших данные БД
            2  - аргументы SQL и ошибки неудачных попыток
            4  - вызовы методов
            8  - значения важных переменных
            16 - дампы разных структур
        Технология протоколирования описана в документации к TblEdit::Request.


    Лицензия
    ~~~~~~~~
    Данная программа является свободной (free software) и вы можете распространять
    и/или изменять ее на тех же условиях, что и perl.

    Дополнительная информация
    ~~~~~~~~~~~~~~~~~~~~~~~~~
    Скачать последнюю версию дистрибутива программы и поолучить дополнительную 
    информацию Вы можете на сайте программы - http://dev.jast.ru/tbledit.

    Связаться с автором можно по электронной почте - jean@jast.ru