Абриаль 2.0 http://www.artint.ru/packin/abrial А.И.Пацкин [mailto:aleksandr@tochka.ru]
README 2.0 ] Абриаль 2.0 ] Введение (1.6) ] Обзор (1.6) ] Публикации ] Глоссарий ] Оглавление ] Руководство ] Выше ] _ operations ] A ] B ] C ] D ] E ] F ] G ] H-I ] L ] M ] N ] O ] P ] [ R ] S ] T-X ]

R


REFER  Полная ссылка на объект или изображение его значения.


Формат:

<#REFER [[M=]method | ACT=action] [{N=object-name C=class-name}| O=object] [D=dbname] [ATAG=atag] [POS=position] [NUM=size] [{parameters}*] [[RET=]reference-image]>

Аргументы/Атрибуты:

method - метод
action - действие
object-name - имя объекта
class-name - идентификатор класса
object - идентификатор объекта
dbname - путь к файлу БД
atag - дополнительные параметры <a>-тега
position - позиция начала сегмента
size - размер сегмента
parameters - любые именованные параметры
reference-image - изображение ссылки

Описание:

Формирует полную ссылку на объект БД или изображение его значения (<a>-тег), в общем виде: 
<a href="ab://ab/[&D=dbname] [&O=object] [&N=object-name&C=class-name] [&M=method] [&ACT=action] [&POS=position] [&NUM=size] [{&parameters}*] "  [atag] > [reference-image] </a>. 

Значение атрибута тега <a href=> формируется аналогично URL / _HREF. С атрибутом "ATAG=" могут быть указаны дополнительные параметры <a>-тега (name=, id=, frame=, title=, methods=, accesskey=). С атрибутом "RET=" или без него последним аргументом, может быть явно указано изображение ссылки reference-image. Если ссылка внутренняя на значение в качестве изображения reference-image устанавливается значение указанного или текущего объекта БД.

Возвращает в случае успеха сформированный таким образом <a>-тег (изображение/ссылку), иначе пусто.

Признаки:

простой, ленивый. 

Использование:  

 

Примечание:

Формирование <a>-тега похоже на HREF, отличие состоит в том что HREF-составной, изображение необходимо задавать явно, а REFER-простой и для внутренней ссылки на значение в качестве изображения выдает значение объекта.  

Пример:

<#REFER M="MyPage" ATAG="title='Переход на мою страницу' " RET="На мою страницу"> 


REM  Комментарий


Формат:

<#REM comment-text

Аргументы/Атрибуты:

comment-text - текст комментария

Описание:

Пропускает текст comment-text, ничего не делает. 

Признаки:

простой, энергичный.  

Использование:  

 

Примечание:

 

Пример:

<#REM Это комментарий> 


RENAME  Переименование объекта-сущности.


Формат:

<#RENAME [{[N=]object-name [C=]class-name}| O=object] TO=new-name

Аргументы/Атрибуты:

object-name - имя объекта
class-name - имя класса объекта 
object - идентификатор объекта
new-name - новое имя объекта

Описание:

Присваивает указанному объекту-сущности текущей БД новое имя new-name

Объект может быть указан числовым идентификатором object или своим именем object-name и именем своего класса class-name, без атрибутов "N= C=" ожидается в качестве первого и второго аргументов. По умолчанию присваивает новое имя текущему объекту, если текущий объект - сущность. 

В случае успешного переименования возвращает непустое значение (символ "пробел"), иначе пусто. 

Признаки:

простой, ленивый. 

Использование:  

 

Примечание:

 

Пример:

<ON N="Иванов ИИ" C="Личность" D=((XBASE)"Test\AIS.ab") RET=(RENAME TO="Петров ПП") > 


RESULT  Получение результата глобального действия.


Формат:

<#RESULT

Аргументы/Атрибуты:

отсутствуют.

Описание:

Возвращает результат глобального действия (в ссылке на метод, формирующий текущую страницу, был указан параметр "&ACT=" - действие, выполняемое перед формированием текущей страницы, результат которого и возвращается данным примитивом). 

Признаки:

простой, энергичный. 

Использование:  

 

Примечание:

 

Пример:

<#COND (RESULT) (RESULT) (ERROR)>


ROOTREF  Получение ссылки на текущую страницу.


Формат:

<#ROOTREF [[POS=]position] [[NUM=]number]> 

Аргументы/Атрибуты:

position - позиция начала сегмента
number - размер сегмента

Описание:

Формирует ссылку на текущую страницу без обрамляющих тегов и без кавычек, добавляя или изменяя в ней параметры "POS" и "NUM", в общем виде:
 "ab://ab/D=dbname&O=object&M=method&POS=position[&NUM=number]" 
где: dbname-полный путь к текущей БД; object-числовой идентификатор текущего объекта текущей БД; method-метод формирующий текущую страницу. 

При переходе по ссылке с параметрами "&POS=" и "&NUM=", внутри метода method текущие установки "POS" и " NUM" заменяются на указанные в ссылке. Внутри метода "POS" и "NUM" сами по себе ничего не значат - просто переменные, но могут использоваться в циклах FORALLOBJ, FORASP/FORLINE для выделения сегмента. Эти обстоятельство можно использовать для формирования с помощью единственного метода связанного списка страниц для листания длинных списков. 

Если указан атрибут "POS=", в ссылку добавляет параметр "&POS=position" со значением абсолютной позиции начала сегмента. Без атрибута "POS=", первым аргументом, ожидается относительное изменение текущей позиции - к текущей позиции прибавляется указанное смещение position, в ссылку добавляет параметр "&POS=" с новым значением позиции начала сегмента.  С атрибутом "NUM=" или без него, вторым аргументом, ожидается размер сегмента number, в ссылку добавляется параметр "&NUM=number". По умолчанию вносит в ссылку параметр "&POS=1", параметр "&NUM=" не добавляется.

Возвращает сформированную таким образом ссылку на текущую страницу.

Признаки:

простой, ленивый. 

Использование:  

 

Примечание:

 

Пример:

<a href=<#ROOTREF 10 NUM=10>>Далее</a>


 

Все права защищены. © 2000-2003 РосНИИ ИИ
http://www.artint.ru
Copyright. © 2000-2003 by RRIAI
Александр Иосифович Пацкин [mailto:aleksandr@tochka.ru].
07 марта, 2004

К началу документа.