3.4.  Запросы и отчеты СОД "ВЕЖА"



     Запросы к базе данных в СОД "ВЕЖА" называется фильтрами.

     Фильтр может быть задан в любой табличной форме СОД "ВЕЖА",
посредством формулирования ограничений на  значения  в  колонках
данной  табличной  формы.  Формулировать  ограничения  можно   с
использованием специального (упрощенного)  языка  фильтров  (СОД
"ВЕЖА" FL) либо  с  использованием  языка  SQL.  СОД  "ВЕЖА"  FL
описывается  ниже  в  соответствующем  пункте.  SQL   в   данном
документе не описывается. С этим  языком  можно  познакомится  в
[6], [3].

     После выполнения  запроса  и  изменения  ширины  и  порядка
расположения колонок "на лету", содержимое любой табличной формы
может  быть  выведено  на  принтер.  Также,   содержимое   любой
табличной формы может быть экспортировано в файл,  заданного  (в
файле инициализации приложения) формата, например, файл  формата
Microsoft Excel. Далее твердую  копию  отчета,  можно  получить,
распечатывая данный файл другой программой, например,  Microsoft
Excel.

                               76
                    UA.ITV.MLC-2.0/1.02 13 01

     
     3.4.1.  Язык фильтров СОД "ВЕЖА"


     Язык фильтров позволяет достаточно гибко задавать различные
ограничения на  значения  в  колонках  данной  табличной  формы,
извлекаемые из БД.
     
     
     3.4.1.1.  Примеры использования языка фильтров


     пример #1 - для ускорения чтения табличной формы событий  в
системе. показать события в системе после 10.10.99 в форме  View
-> Log -> FILTER:

ИМЯ поля             КРИТЕРИЙ

when                 > 10.10.99

В указанную форму НЕ будут читаться строчки, созданные ранее  10
октября 1999 года, это приведет к общему уменьшению  извлекаемой
и отображаемой информации. Следовательно запрос будет выполнятся
быстрее.

     пример #2 -  демонстрация  задания  нескольких  ограничений
(условий выбора) в одном  запросе.  Необходимо  получить  список
событий связанных с заданными заданными пользователями  системы,
между 1 и 10 октября 1999 на двери door2.

ИМЯ поля                   КРИТЕРИЙ

Tm                         01.10.1999 .. 10.10.1999
Fio                        'Piskunov'  | @ '%Scott%'
Drnm                       door2


     Первая  строчка  задает  интервал   времени,   за   который
необходимо извлечь строчки.

     Вторая  строчка  читается  на  русском  языке  так:  покажи
строчки с фамилией пользователей либо Piskunov, либо содержащего
слово Scott, где
% - означает любую строчку;
| - операция ИЛИ    (OR);
@ - операция похоже (LIKE).

     Третья строчка задает название двери.

     Кроме того нужно отметить, что в поле название двери (Drnm)
или фамилия (FIO), текстовая константа может заключатся, а может
не заключаться в одинарные  кавычки  (Piskunov  или  'Piskunov',
door2 или 'door2'). Опускать кавычки можно только в ограниченном
количестве простых  случаев.  Для  уточнения  смотри  формальное
описание языка фильтров (использование препроцессора).
     
     
     3.4.1.2.  Формальное описание языка фильтров


     В комплект поставки входит  утилита  тестирования  запросов
TMkSql32.exe.  Она  может  быть  использована  для  тестирования
ограничений (условий выбора). Если запрос преобразуется в SQL  -
оператор, то он  сформулирован  правильно,  в  противном  случае
допущена ошибка.

тип      тип               допустимая последовательность
                               77
                    UA.ITV.MLC-2.0/1.02 13 01

языка    поля              символов (терм) в этом поле
фильтров базы данных

 cтроки  char              все в одинарных кавычках
         long              '[символы]',  символ != 0
         long varchar
         longraw
         raw
         varchar

 числа   dec               [-|+] цифра[цифры].[цифры][{E|e} \
                                             [+|-]цифра[цифры]]
         decimal                или
         double precision  [-|+] цифра[цифры] [K|M]
         float
         int
         integer
         number
         numeric
         real
         smallint

 дата1   date
                         любой допустимый вид
         цц.цц.цц        окружить кавычками
         цц/цц/цц        порядок YMD или DMY задается
         цц-цц-цц        приложением при инициализации и
                         для интерпретатора не имеет значения
время   цц:цц:цц         время
        дата1 [время]    дата время

         NULL - спец значение

         логические            кол-во
         операции              операндов
выражение ==
        x & y     AND          2
        x | y     OR           2
        ^ x       NOT          1      или ! x
        ( x )     смена приор. 1
где x - выражение и
    y - выражения

        операции
        числовые и дат

выражение ==
        =  x      РАВНО        1 сокращенный вариант x
        <> x      НЕ РАВНО     1
        =  NULL                0
        <> NULL                0
        >  x      БОЛЬШЕ ЧЕМ   1
        >= x      БОЛЬШЕ РАВНО 1
        <  x      МЕНЬШЕ ЧЕМ   1
        <= x      МЕНЬШЕ       1
        x .. y  == <= x & >= y 2
          .. y    == >= y      1
        x ..      == <= x      1
где x - числовой терм и
    y - числовой терм

        операции над
        строками
выражение ==
        =  x      РАВНО        1 сокращенный вариант  x
        =  NULL                0
        #  x  LIKE&МATCH CASE  1
                               78
                    UA.ITV.MLC-2.0/1.02 13 01

        <> x      НЕ РАВНО     1
        <> NULL                0
        @  x      LIKE         1

где x - строчный терм

      список примеров - тестов языка запросов

    1..
    ..1
    1..2
    1 ...2          ошибка - число начинается с цифры
    =1
    <>1.1
    <+1.
    <=        -        1.
    > 1234567890.1234567890
    >= 1.e1
    = 1.E1 & = 1.e+1 & = 1.E-1
    1..10 | -5.. | ..             20
    ^(=1 & =2 & =3)
    =1K
    =1M
    =NULL
    <>NULL
    xyz
    ='xyz' | ( = 'xyz') правильно
    ='xyz' | xyz
    #'qwertyuioplkjhgfdsazxзхъэждлорпавыфячсмитьбю.-0981238'
    @'xyz'
    <> 'xyz'
    <> xyz
    'xyz'
    = 01.01.01
    01.01.01 .. 02.02.02
    11:22:33.333       ошибка - части секунды не поддерживаются
    +11:22:33          ошибка
    (=11:22:33 | =22:33:44 | = 33:44:55)
    <> 11.22.33 11:22:33 | (= 11.22.33 11:22:33)
    (((((((=1)))))))&((((((=2))))))
    (((<>1)&((<>2))&(((<>3)))))|((-5..7)&(12..17)&      \
            (.. 200))|(=+123.456789E-1234567890)& <> NULL

     
     
     3.4.1.2.1.  Использование препроцессора


     В поле строкового типа  (char  и  т.д.)  перед  выполнением
преобразования выполняется препроцессор. Препроцессор  выполняет
преобразование  строки,  введенной   пользователем,   в   строку
допустимую для языка  запросов,  по  следующему  правилу:  любая
последовательность символов xyz, которая начинается  НЕ  c  '(',
''', '!', '^', '@', '<', '#', '=', '  ',  '\t'  преобразуется  в
последовательность @ 'xyz'.