Статья была опубликована в Технологии клиент-сервер, #4-1998

Поддержка макросов целевым сервером

В шаблонах, создаваемых для триггеров, хранимых процедур, pre- (предварительных) и post-скриптов генерации схем, можно использовать макросы ERwin в случае, если эти возможности поддерживаются целевой СУБД.

Все макросы, за исключением тех, которые особо определены, могут использоваться для всех целевых серверов, поддерживаемых ERwin. Поддержка вашим сервером RI (Referential Integrity) - триггеров, хранимых процедур и/или сценариев - описана в документации сервера.

Использование справочника по макросам

Справочник макросов организован в алфавитном порядке по именам макросов. Информация по каждому макросу включает его описание, синтаксис, область видимости (например, операторы или фрагменты кода, где он может использоваться), возвращаемое значение; и, как правило, пример текста шаблона макроса (шаблона) и соответствующий ему "раскрываемый текст" (рис.1). Рассмотрим каждый элемент:

• Синтаксис макроса. Описывает синтаксис каждого макроса ERwin, включая ключевые слова, переменные, определяемые пользователем, и необходимую пунктуацию.
• Область видимости. Для каждого макроса этот элемент перечисляет:
  • Команды "%ForEach", в которые может быть вставлен данный макрос.
  • Возможность видимости макроса как предиката в условном операторе "%If".
  • Типы шаблонов, в которые может вставляться данный макрос. Возможные значения: RI или Rel Override (переопределение отношений), Trigger Override (Триггер.) и Global (Глобальный). Отдельные шаблоны каждого типа перечислены в следующей таблице.
• Return Value (Возвращаемое значение). Поясняет, что (какой SQL-код) возвращает макрос при генерации.
• Example (Пример). Содержит пример синтаксиса шаблона и соответствующий результат выполнения. Все примеры с результатом выполнения основаны на использовании подмножества таблиц в модели ERwin MOVIE (целевой SQL-сервер), показанной в наборе инструментов шаблона ERwin. Пример не приводится, если макрос возвращает значение TRUE или FALSE.

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

Синтаксис команд макросов ERwin состоит из ключевых слов, пунктуации и переменных.

• Ключевые слова всегда предваряются знаком процента (%) и должны вводиться в точности, как указано в таблице (например, %AttFieldName).
• В синтаксис должны быть включены фигурные скобки {} и простые скобки (); запятые необходимы, если вы включаете в команду более одной переменной.
• Переменные обозначаются угловыми скобками (например, <macro code1>). При включении своей макрокоманды в триггер, хранимую процедуру или сценарий, вы заменяете переменные определенным вами текстом, числом или другим макросом.

Следующий список определяет общие переменные, используемые в синтаксисе макросов:

• <default value>, <value> и <initial value> представляют определенные пользователем текст или числа, которые задаются так, как вы хотите видеть их после раскрытия макроса ERWin'ом.
• <action> представляет корректное SQL-действие (например, INSERT, UPDATE или DELETE.).
• <macro code>, <macro code1>...<macro coden> представляют любую макропоследовательность, являющуюся корректной в текущей области видимости. При последовательном включении в данную команду нескольких макросов, они нумеруются от 1 до n.
• <predicate> представляет любое корректное булево выражение, которое имеет значение TRUE или FALSE, включая выражения, поддерживаемые макросами ERwin (например, %AttIsFK) и создаваемые поддерживаемыми булевыми операторами (например, %!= и другие операторы сравнения - %And, %Or и %Not).
• <prefix> <old prefix> и <new prefix> представляют текстовое или числовое значение (например - @ins) или раскрытый макрос (напр., %Parent), которые добавляются к началу имени таблицы или столбца при раскрытии макроса. Если определены и <old prefix> и <new prefix>, то список, создаваемый макросом, имеет два раздела: первый раздел объявляет <old prefix> <element>, а второй - <new prefix> <element>.
• <separator> представляет один или более символов, используемых для разделения списка, создаваемого макросом. Разделители задаются при помощи кавычек (напр., "OR").
• <table name>, <default name>, <domain name>, <validation> заменяются именем таблицы, именем по умолчанию, именем ERwin домена, правилом контроля целостности или соответствующим макросом (напр., %TableName, %Child, %DefaultName, %DomainName, %ValidationName).
• <variable> представляет имя переменной, используемой в триггере, хранимой процедуре или скрипте.

Булев предикат, возвращающий "true", если значение <macro code1> не эквивалентно значению <macro code2>.

%!=(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Вставляет один символ процента (%) в раскрытый код триггера.

%%

Глобально

%

Умножает значения <macro code1> и <macro code2>.

%*(<macro code1>, <macro code2>)

Глобально

Число

Складывает значения <macro code1> и <macro code2>.

%+(<macro code1>, <macro code2>)

Глобально

Число

String1="aaaaa"
String2="bbbbbbbbb"
%+(%Len(%:string1), % Len(%:string2))

Вычитает значение <macro code2> из значения <macro code1>.

%-(<macro code1>, <macro code2>)

Глобально

Число

string1="aaaaa"
string2="bbbbbbbbb"
%-(%Len(%:string1), % Len(%:string2))

Делит значение <macro code1> на значение <macro code2>.

%/(<macro code1>, <macro code2>)

Глобально

Число

string1="aaaaa"
string2="bbbbbbbbb"
%/(%Len(%:string1), % Len(%:string2))

Возвращает значение <variable>.

%:<variable>

Глобально

Значение переменной <variable>.

%:@ins_customer_id

Булев предикат, возвращающий значение "true", если значение <macro code1> меньше, чем значение <macro code2>.

%<(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Булев предикат, возвращающий значение "true", если значение <macro code1> меньше или равно значению <macro code2>.

%<=(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Присваивает значение <macro code> объявленной переменной <variable> (См. %Decl). Результатом выражение является присвоение переменной, результат выполнения не проявляется в развернутом коде.

%=(<variable>, <macro code>)

Глобально

Нет

%=(@var, %Tablename)

Булев предикат, возвращающий "true", если значение <macro code1> равно значению <macro code2>.

%==(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Булев предикат, возвращающий "true", если значение <macro code1> больше значения <macro code2>.

%>(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Булев предикат, возвращающий "true", если значение <macro code1> больше или равно значению <macro code2>.

%>=(<macro code1>, <macro code2>)

Глобально, %If

TRUE/FALSE

Возвращает название действия, которое привело к активизации триггера. Зависит от содержания команды. %Action возвращает значение DELETE, INSERT или UPDATE. Например, если триггер активизировался по команде DELETE, %Action вернет значение DELETE.

%Action

Триггер

DELETE, INSERT или UPDATE

%Action

Возвращает список действий, выполненных до или после активизации триггера. Если триггер является многофункциональным (например CREATE TRIGGER trigger_name ON table FOR INSERT, UPDATE, DELETE ...), макрос объявляет все действия.

%Actions(<separator>)

Триггер

DELETE, INSERT и/или UPDATE

%Actions (",")

Позволяет комбинировать булевы выражения для создания более сложных выражений. %And выполняет логическое "И" с булевыми предикатами, определяемыми <macro code1> и <macro code2>. Например, код %If{%And(%AttIsFK,%AttIsRolenamed)...} позволяет выполнять дополнительные действия, если данный атрибут является внешним ключом и имеет ролевое имя. Для того, чтобы удовлетворить требованиям выполнения %And, оба элемента должны иметь значение "TRUE".

%And(<macro code1>,<macro code2>)

Глобально, %If

TRUE/FALSE

Возвращает тип данных текущего атрибута. Примечание: С помощью доменов ERwin возможно присвоение пользовательского типа данных. Если атрибут имеет тип данных, определенный пользователем, этим макросом предусматривается имя для такого типа данных.

%AttDatatype

%ForEachAtt, % ForEachFKAtt

Тип данных атрибута

%ForEachAtt () 
{%AttName -> %AttDatatype}

Возвращает определение атрибута

%AttDef

%ForEachAtt, % ForEachFKAtt

Определение атрибута

/*Если текущий атрибут - master_number, то*/ %AttDef

Возвращает имя, присвоенное атрибуту по умолчанию.

%AttDefault

%ForEachAtt, % ForEachFKAtt

Имя, присвоенное атрибуту по умолчанию.

%AttDefault

Возвращает имя домена, присвоенное атрибуту.

%AttDomain

%ForEachAtt, % ForEachFKAtt

Имя домена

/*Если текущий атрибут cust_phone, то*/

%AttDomain

Возвращает имя столбца, связанного с текущим атрибутом.

%AttFieldName

%ForEachAtt, % ForEachFKAtt

Имя столбца

/*Если текущий атрибут renting-customer, то*/

%AttFieldName

Возвращает длину типа данных атрибута

%AttFieldName

%ForEachAtt, % ForEachFKAtt

Число

/*Для типа данных varchar (50)*/

%AttFieldWidth

Возвращает атрибут ID.

%AttId

%ForEachAtt, % ForEachFKAtt

Целое

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

%AttIsFK

%ForEachAtt, % ForEachFKAtt

TRUE/FALSE

%ForEachAtt() {

%If{%AttIsFK}

%AttName}

Булев предикат, позволяющий вам определить, имеет ли текущий атрибут ролевое имя. Дополнительная информация приведена в "%AttIsFK".

%AttIsRolenamed

%ForEachAtt, % ForEachFKAtt, %If

TRUE/FALSE

Булев предикат, позволяющий вам определить, состоит ли текущий атрибут в первичном ключе. Дополнительная информация приведена в "%AttIsFK".

%AttIsPK

%ForEachAtt, % ForEachFKAtt, %If

TRUE/FALSE

Возвращает логическое имя текущего атрибута.

%AttName

%ForEachAtt, % ForEachFKAtt

Имя атрибута

/*Если текущий атрибут master-number, то*/

%AttName

Возвращает признак NULL/NOT NULL текущего атрибута.

%AttNullOption

%ForEachAtt, % ForEachFKAtt

NULL/NOT NULL

Возвращает физический тип данных текущего атрибута, даже для типов данных, определенных пользователем.

%AttPhysDatatype

%ForEachAtt, % ForEachFKAtt

Тип данных

/*Если текущий атрибут master-number, то*/

%AttPhysDatatype

Перечисляет все атрибуты сущности (таблицы) для которой создается триггер, выполняя определенную функцию для каждого атрибута.

%Atts(<separator>,<action>,<prefix>)

Триггер

Список действий и атрибутов

%Atts (",", update, %Parent)

Возвращает название правила проверки (validation name) данного атрибута.

%AttValidation

%ForEachAtt, % ForEachFKAtt

название правила проверки (validation name).

/*Если текущий атрибут due_date, то*/ %AttValidation

Возвращает тип отношений:

• <nothing> = 1:0,1, или более
• Р = 1:1 или более
• Z = 1:0 или 1
• n = 1:n, где n - целое

%Cardinality

RI или Переопределение отношений

<ничего>, P, Z, <любое целое>

Возвращает физическое имя таблицы дочерней сущности в отношении.

%Child

RI или Переопределение отношений

Имя таблицы.

/*Если текущее отношение <is in stock as>, то*/

%Child 

Перечисляет все атрибуты дочерней сущности в отношении и выполняет над каждым указанные действия.

%ChildAtts(<separator>,<action>, <prefix>)

RI или Переопределение отношений

Названия атрибутов и действия.

/*Если текущее отношение <is in stock as>, то*/

%ChildAtts(" or ", update)

Перечисляет внешние ключи дочерней сущности в отношении и выполняет над каждым указанные действия.

%ChildFK(<separator>,<action>,<prefix>)

RI или Переопределение отношений

Имена атрибутов и действия

/*Если текущее отношение <is in stock as>, то*/

%ChildFK(" or ", update)

Перечисляет внешние ключи дочерней сущности в отношении, а затем их типы данных.

%ChildFKDecl (<old prefix>,<new prefix >, <separator>>,<attribute/type separator>)

RI или Переопределение отношений

Имена атрибутов FK и типы данных

/*Если текущее отношение <is in stock as>, то*/
%ChildFKDecl(,@ins_,", ")

Перечисляет неключевые элементы дочерней сущности и выполняет указанные действия с каждым из них.

%ChildNK(<separator>,<action>,<prefix>)

RI или Переопределение отношений

Имена неключевых атрибутов и действия

/*Если текущее отношение <is in stock as>, то*/
%ChildNK(" or ", update, @)

Перечисляет неключевые элементы дочерней сущности в отношении, а затем их типы данных.

%ChildNKDecl (<old prefix>,<new prefix>, <separator>,<attribute/type separator>)

RI или Переопределение отношений

Имена неключевых атрибутов и типы данных

/*Если текущее отношение <is in stock as>, то*/
%ChildNKDecl(,@ins_,", ")

Перечисляет все атрибуты дочерней сущности в отношении, а затем их типы данных. Это полезно при объявлении параметров хранимых процедур.

%ChildParamDecl (<old prefix>,<new prefix>, <separator>,<attribute/type separator>)

RI или Переопределение отношений

Имена атрибутов и типы данных

/*Если текущее отношение <is in stock as>, то*/
%ChildParamDecl(,@ins_,", ")

Перечисляет элементы первичного ключа дочерней сущности в отношении и выполняет с каждым указанные действия.

%ChildPK(<separator>,<action>, <prefix>)

RI или Переопределение отношений.

Неключевые имена атрибутов и действия.

/*Если текущее отношение <is in stock as>, то*/
%ChildPK(" or ", update,@)

Перечисляет первичные ключевые элементы дочерней сущности в отношении, а затем их типы данных.

%ChildPKDecl (<old prefix>,<new prefix>, <separator>, <attribute/type separator>)

RI или Переопределение отношений

Имена атрибутов PK и типы данных

/*Если текущее отношение <is in stock as>, то*/
%ChildPKDecl(,@ins_,", ")

Добавляет <value 2> в конец <value 1>, результатом является объединенная строка.

%Concat(<value1>, <value2>)

Глобально

Строка

Возвращает имя базы данных, используемой при генерации скрипта (в виде значения вводимого в диалоговом окне Connection <DB>).

%CurrentDatabase

Глобально

Строка

/*При генерации на БД "Testdb"*/
%CurrentDatabase

Возвращает имя ERwin файла, из которого был сгенерирован сценарий.

%CurrentFile

Глобально

Строка

%CurrentFile

Возвращает имя целевого сервера, использованного при генерации скрипта (в виде значения вводимого в диалоговом окне Connection <DB>).

%CurrentServer

Глобально

Строка

%CurrentServer

Возвращает имя пользователя, сгенерировавшего скрипта (в виде значения вводимого в диалоговом окне Connection <DB>).

%CurrentUser

Глобально

Cтрока

%CurrentUser

Вставляет текст из шаблона триггера в триггер в развернутой форме.

%CustomTriggerDefaultBody

Триггер.

Содержимое шаблона CustomTriggerDefaultBody.

Вставляет текст из шаблона нижнего колонтитула в триггер в развернутой форме.

%CustomTriggerDefaultFooter

Триггер.

Содержимое шаблона CustomTriggerDefaultFooter.

Вставляет текст из шаблона заголовка в триггер в развернутой форме.

%CustomTriggerDefaultHeader

Триггер.

Содержимое шаблона CustomTriggerDefaultHeader.

Возвращает имя типа данных

%DatatypeName()

Глобально

Тип данных

%ForEachAtt(%Tablename,", ") {%DatatypeName(%AttPhysDatatype)}

Для десятичных типов данных, %DatatypeScale возвращает число десятичных знаков (значение после десятичной запятой).

%DatatypeScale()

Глобально

Целое

/*Например, для decimal(10,2)*/
%DatatypeScale()

Возвращает ширину поля описанную в типе данных.

%DatatypeWidth()

Глобально

Целое

/* Например, для decimal(10,2)*/
%DatatypeWidth()

Возвращает текущие дату и время.

%Datetime

Глобально

Строка

%Datetime

Возвращает имя базы данных.

%DBMS

Глобально

Строка

%DBMS

Возвращает оператор разделитель для выбранной СУБД.

%DBMSDelim

Глобально

, или ; или другой разделитель.

Объявляет <переменную> и, необязательно, инициализирует ее с помощью <initial value>. Например, если вы использовали оператор %Decl(var1,0), то это значит, что объявляется переменная var1, которая инициализируется значением 0. Возвращаемое значение не генерируется.

%Decl(<variable>,<initial value>)

Глобально

Нет

%Decl(var1,0)

Возвращает имя по умолчанию.

%DefaultName

%ForEachDefault

Имя по умолчанию.

%ForEachDefault(", " ){%DefaultName}

Возвращает значение по умолчанию.

%DefaultValue(<default name> или %DefaultValue

Глобально (при использовании аргумента - <default name>), либо %ForEachDefault (без аргумента).

Значение по умолчанию.

%ForEachDefault(", " ){%DefaultValue}

Возвращает физический тип данных домена.

%DomainDatatype(<domain name>) или %DomainDatatype

Глобально (при использовании аргумента - <domain name>), либо %ForEachDomain.

Значение домена по умолчанию.

%ForEachDomain(", ") {%DomainDatatype}

Возвращает имя, по умолчанию присвоенное домену.

%DomainDef(<domain name>) или %DomainDef

Глобально (при использовании аргумента <domain name>), либо %ForEachDomain.

Значение домена по умолчанию.

%ForEachDomain(", ") { %DomainDef}

Возвращает имя домена.

%DomainName

%ForEachDomain

Имя домена

%ForEachDomain{%DomainName}

Возвращает информацию о том какие NULL атрибуты, будут иметь столбцы созданные с использованием домена <domain name>.

%DomainNullOption (<domain name>) или %DomainNullOption

Глобально (при использовании аргумента <domain name>), либо %ForEachDomain.

NULL, NOT NULL, IDENTITY, WITH NULL или NOT NULL WITH DEFAULT

Возвращает название правила проверки (validation name) присоединенного к домену.

%DomainValidation(<domain name>) или %DomainValidation

Глобально (при использовании аргумента <domain name>), либо %ForEachDomain.

название правила проверки.

%ForEachDomain {%DomainValidation}

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

%EntityId (<entity or tablename>)

RI, Переопределение отношений или

Триггер

Целое

%EntityId(%Parent)

Возвращает имя сущности или таблицы

%EntityName (<entity or tablename>)

RI, Переопределение отношений или Триггер

Строка

%EntityName(%Parent)

Выполняет программу макроса, заключенного в фигурные скобки и записывает результат в данный файл. Этот макрос предусматривает работу с учетом ограничения Windows 3.х на размер строки в 64 кб.

%File (<filename>){<macro code>}

Глобально

Строка

%File (C:\erw\myfile.tst)
{%ForEachAtt(Parent, ", ") (%AttFieldName ...}

Определяет, когда запускается триггер. Доступно только для INFORMIX, ORACLE7 и Rdb.

%Fire

Триггер.

BEFORE или AFTER

%Fire

Раскрывает макрос для каждого атрибута данной таблицы.

%ForEachAtt(<table name>,<separator>) {<macro code>}

Триггер.

Результат <macro code> для каждого атрибута данной таблицы.

%ForEachAtt(%Parent, ", ")
{%AttFieldName}

Раскрывает <relationship code> (код отношений) для каждого отношения в котором триггерная сущность является дочерней.

%ForEachChildRel(<separator>) {<relationship code>}

Триггер.

Результат <macro code> для каждого отношения.

%ForEachChildRel("go") {insert %Parent values(%ParentAtts(", ",,@ins_) }

Раскрывает макрос для всех атрибутов, имеющих default значения.

%ForEachDefault (<separator>) {<macro code>}

Глобально

Результат <macro code> для всех атрибутов имеющих default значения.

%ForEachDefault () {%DefaultName }

Раскрывает макрос для всех доменов, которые реализованы как пользовательские типы данных.

%ForEachDomain(<separator>){<macro code>}

Глобально

Результат <macro code>

%ForEachDomain(","){%DomainName }

Раскрывает макрос для всех сущностей текущей предметной области (subject area).

%ForEachEntity(<separator>) {<macro code>}

Триггер.

Результат <macro code> для каждой сущности.

%ForEachEntity() {%TableName}

Раскрывает макрос для каждого атрибута внешнего ключа.

%ForEachFKAtt(<separator>){<macro code>}

RI или Переопределение отношений.

Результат <macro code> для каждого атрибута FK.

%ForEachFKAtt(", ")
{%AttFieldName}

Раскрывает макрос для всех индексов в текущей предметной области. <table> используется по умолчанию для таблицы в текущей области видимости; может использоваться для присвоения имени другой таблице (%Parent, MOVIE_COPY). <type> фильтрует тип индекса (AK, IE, IF, PK, AK1, IE2 и т.д.). По умолчанию для всех.

%ForEachIndex ([<table>],[<type>],[<name>],[<separator>]){<macro code>}

Триггер.

Результат <macro code> для каждого индекса

%ForEachIndex { %IndexName
%IndexType}

Раскрывает макрос для всех аттрибутов, входящих в индексы текущей предметной области. <sequence> может использоваться для ввода номера, присвоенного определенному члену индекса. По умолчанию для всех членов.

%ForEachIndexMem ([<sequence>],[<separator>]) {<macro code>}

Триггер.

Результат <macro code> для каждого члена индекса.

%ForEachIndex {%ForEachIndexMem() {%AddDatatype }}

Раскрывает макрос для всех альтернативных ключей и неуникальных индексов (IE) в текущей предметной области.

%ForEachKey ([<table>],[<type>],[<separator>]) {<macro code>}

Триггер.

Результат <macro code> для каждого ключа.

%ForEachKey (%Parent,,,) {%KeyName}

Раскрывает макрос для всех членов ключа.

%ForEachKeyMem ([<sequence>],[<separator>]) {<macro code>}

Триггер.

Результат <macro code> для каждого члена индекса.

%ForEachKey {%ForEachKeyMem() {%AttName}}

Раскрывает <relationship code> для каждого отношения, где сущность, для которой создаётся триггер, является родительской.

%ForEachParentRel(<separator>){<relationship code>}

Триггер.

Результат <macro code> для каждого отношения.

%ForEachParentRel () 
{insert %Parent values (%ParentAtts(",",,@ins_)}

Раскрывает макрос для всех допустимых значений текущего правила (validation).

%ForEachValidValue(<separator>) {<macro code>}

Триггер., %ForEachValidation

Результат <macro code> для каждого допустимого значения.

%ForEachValidValue(","{%ValidValue =>%ValidValueDef }

Раскрывает макрос для всех правил.

%ForEachValidation(<separator>){<macro code>}

Триггер.

Результат <macro code> для каждого правила.

%ForEachValidation () {%Validation Name }

Условное выполнение %If<macro code1>, если логическое выражение имеет значение "true", либо %Else<macro code2>, если логическое выражение имеет значение "false". Оператор %Else - необязателен.

%If (<predicate>) {<macro code1>} %Else {<macro code2>}

Глобально

Результат <macro code1> каждый раз, если значение <predicate> = TRUE.

Результат <macro code2> каждый раз, если значение <predicate> = FALSE.

%ForEachAtt() { %If(%AttIsPK) {%AttName -> PK}}

Позволяет вам включить текст макроса при работе с несколькими файлами или шаблонами триггеров.

%Include ("<path name>")

%Include (<trigger template name>)

Глобально

Строка

%Include("<c:\er\trg.tdl")

Возвращает имя индекса.

%IndexName

Триггер, %ForEachIndex, %ForEachIndexMem

Строка

%IndexName

Возвращает тип индекса.

%IndexType

Триггер., %ForEachIndex, %ForEachIndexMem

FK, PK, AK, IE1 и т.д.

%IndexType

Позволяет произвести соединение по внешнему ключу дочерней сущности и первичному ключу родительской сущности исходя из реляционной связи (Join между FK дочерней и PK родительской сущностей).

%JoinFKPK ([<child table>, <parent table>, <comparison op>,<separator>)

RI или Переопределение отношений, оператор WHERE или JOIN

Программа, поддерживаемая сравнением значений PK и FK в отношении.

%JoinFKPK(%Child,deleted,"<>"," or")

Позволяет произвести соединение по первичным ключам двух сущностей.

%JoinPKPK (<table>, <correlation>, <comparison op>,<separator>)

RI, Переопределение отношений, Триггер, условный оператор поиска WHERE

Текст, производящий сравнение значений PK из двух таблиц.

%JoinPKPK(%Child,ins,"<>"," or")

Возвращает имя ключа.

%KeyName

Триггер., %ForEachKey, % ForEachKeyMem

Строка

%KeyName

Возвращает длину <macro code>.

%Len(<macro code>)

Глобально

Целое

string1='12345'
%Len(%:string1)

Преобразует результат <macro code> в нижний регистр.

%Lower (<macro code>}

Глобально

Строка в нижнем регистре.

string1='movie' 
%Lower(%:string1)

Сравнивает <value1> и <value2> и возвращает большее.

%Max(<value1>,<value2>)

Глобально

Большее значение из сравниваемых.

var1=8
var2=5
%Max(var1, var2)

Сравнивает <value1> и <value2> и возвращает меньшее.

%Min(<value1>,<value2>)

Глобально

Меньшее значение из сравниваемых

var1=8
var2=5
%Min(var1, var2)

Перечисляет все неключевые атрибуты триггерной сущности и выполняет определенные действия с каждым.

%NK (<separator>,<action>,<prefix>)

Триггер.

Атрибут и действие

%NK(" or, update,%Parent)

Перечисляет неключевые атрибуты триггерной сущности, а затем их типы данных.

%NKDecl(<old prefix>,<new prefix>,<separator>,<attribute/type separator>)

Триггер.

Имена и типы данных атрибутов

%NKDecl(,@ins_,", ")

В булевом выражении, определяемом в <macro code>, %Not осуществляет "логическое НЕ". Позволяет комбинировать булевы выражения для создания более сложных выражений.

%Not (<macro code>)

Глобально, %If

Результат макроса.

%ForEachAtt() {%If(%Not(%==(%AttDatatype, int)))
{%AttName}}

Сравнивает внешний ключ дочерней сущности <child table> из отношения с <null expression>. Этот макрос выполняется, только если отношение не определяющее и допустимы null значения.

%NotnullFK(<child table>, <not null expression>,<prefix>,<separator>)

RI или Переопределение отношений, оператор WHERE

NULL выражение для каждого FK, допускающего нулевые значения.

where %NotnullFK(,"is null",," or")

В булевых выражениях, определяемых в <macro code1> и <macro code2>, %Or осуществляет "логическое ИЛИ". Позволяет комбинировать булевы выражения для создания более сложных выражений. Например, %If{%Or(%AttisFK,%AttIsRolenamed)...} позволяет выполнять дополнительные действия, если данный атрибут является внешним ключом или имеет ролевое имя. Макрос выполняется, если любой из элементов имеет значение "TRUE".

%Or (<macro code1>,<macro code2>)

Глобально, %If

TRUE/FALSE

%If(%Or(%AttIsFK,%AttIsRolenamed)) {%AttName}

Перечисляет все атрибуты триггерной сущности, а затем их типы данных.

%ParamDecl(<old prefix>,<new prefix>,<separator>,<attribute/type separator>)

Триггер.

Атрибуты и типы данных.

%ParamDecl(@ins_,", ")

Присваивает значения параметрам процедур, определенным в <old prefix> и/или в <new prefix>, для всех атрибутов триггерной сущности. Доступен только для Ingres.

%ParamDecl(<old prefix>,<new prefix>,<param/value separator>,<param separator>)

Триггер.

Список параметров для Ingres.

%ParamPass(,new," = ")

Возвращает физическое имя таблицы родительской сущности из реляционной связи.

%Parent

RI или Переопределение отношений

Строка

%Parent

Раскрывает любой макрос атрибутов (например, %AttFieldName, %AttDatatype) для первичного родительского ключевого атрибута, от которого мигрировал текущий атрибут.

%ParentAtt(<attribute macro>)

%ForEachAtt, %ForEachFKAtt

Результат <attribute macro>

%ForEachAtt() {%ParentAtt%AttFieldName)}

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

%ParentAtts(<separator>,<action>,<prefix>)

RI или Переопределение отношений

Атрибуты и действия

%ParentAtts(" or ",update,%Parent)

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

%ParentNK(<separator>,<action>,<prefix>)

RI или Переопределение отношений

Атрибуты и действия

%ParentNK(" or ",update,%Parent)

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

%ParentNKDecl (<old prefix>,<new prefix>,<separator>,<attribute/type separator>)

RI или Переопределение отношений

Атрибуты и типы данных FK.

/*Если текущее отношение <is in stock as>, то*/
%ParentNKDecl(,@ins_,", ")

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

%ParentParamDecl (<old prefix>,<new prefix>,<separator>,<attribute/type separator>)

RI или Переопределение отношений

Атрибуты и типы данных.

/*Если текущее отношение <is in stock as>, то*/
%ParentParamDecl(,@ins_,", ")

Перечисляет элементы первичного ключа родительской сущности в отношении и выполняет с ними указанные действия.

%ParentPK(<separator>,<action>)

RI или Переопределение отношений

Атрибуты первичных ключей и действия.

%ParentPK

Перечисляет элементы первичного ключа родительской сущности в отношении, а затем - их типы данных.

%ParentPKDecl (<old prefix>,<new prefix>,<separator>,<attribute/type separator>)

RI или Переопределение отношений

Имена атрибутов первичных ключей и типы данных.

/*Если текущее отношение <is in stock as>, то*/
%ParentPKDecl(,@ins_)

Возвращает физическое имя отношения.

%PhysRelName

RI или Переопределение отношений

Строка

%PhysRelName

Перечисляет элементы первичного ключа триггерной сущности и выполняет с ними указанные действия.

%PK(<separator>,<action>,<prefix>)

Триггер.

Первичные ключевые атрибуты и действия.

%PK(,update,%Parent)

Перечисляет элементы первичного ключа сущности, а затем - их типы данных.

%PKDecl (<old prefix>,<new prefix>,<separator>>,<attribute/type separator>))

Триггер.

Имена первичных ключевых атрибутов и типы данных.

%PKDecl(,@ins_)

Создает описание Reference, исходя из информации OLD и NEW, добавленной в Редакторе Триггерного Объекта. Доступен только для INFORMIX, Ingres, ORACLE7 и Rdb.

%RefClause

Триггер.

Оператор ссылки

%RefClause

Возвращает идентификатор отношения.

%RelId

RI или Переопределение отношений

Целое

Проверяет отношения на наличие нулевых выражений и возвращает "true", если null - недопустим, и "false", если допустим.

%RelIsNonull

RI или Переопределение отношений, %If

TRUE/FALSE

Возвращает тип отношения ссылочной целостности ( CASCADE, RESTRICT...) для указанного действия <action> (insert, update, delete) и <RI type> (родительский или дочерний).

%RelRI(<action>,<RI type>)

RI или Переопределение отношений

CASCADE, RESTRICT, SET NULL, SET DEFAULT или NONE

%RelRI(Update, Child)

Раскрывает шаблон, присоединенный к текущему отношению. Если никакой макрос не присвоен, раскрывается шаблон ссылочной целостности диаграммы по умолчанию.

%RelTemplate

RI или Переопределение отношений

Раскрывает фрагмент программы отношения в соответствии с типом триггера.

Возвращает тип отношения. Допустимые значения типа отношения и их определения включают: RT_ID (определено), RT_NI (не определено), RT_SC (субтип) или RT_MM (многие-ко-многим).

%RelType

RI или Переопределение отношений

RT_ID, RT_NI, RT_SC или RT_MM

%RelType

Возвращает определение того, как выполняется триггер. Доступен только для ORACLE7.

%Scope

Триггер.

FOR EACH ROW или FOR EACH TABLE

%Scope

Перечисляет внешние ключевые элементы дочерней сущности в отношении и присваивает каждому члену указанное значение.

%SetFK (<child table>,<value>)

RI или Переопределение отношений

Имя и значение атрибута внешнего ключа

%SetFK(%Child,NULL)

Перечисляет первичные ключевые элементы указанной таблицы и присваивает каждому члену указанное значение.

%SetPK(<table>,<value>)

RI или Переопределение отношений

Имя и значение атрибута первичного ключа.

%SetPK(%Parent,0)

Заменяет строку <pattern> в строке <value> строкой <substitute>.

%Substitute(<value>,<pattern>,<substitute>)

Глобально

Строка

/*Если имя дочерней таблицы movie_copy_number*/
%Substitute(%Child,movie,ins_movie

Возвращает подстроку при раскрытии данного <macro code>. <length> (длина) необязательна.

%Substr(<macro code>,<initial pos>,<length>)

Глобально

Строка

%Substr(macro,1,3)

Сравнивает аргумент с указанной альтернативой. ERwin раскрывает макрос в соответствии с совпавшей альтернативой. Если ни одного совпадения не происходит, ERwin выполняет макрос по умолчанию.

%Switch (<argument>) {%Choose(<choice 1>) {<macro code 1>} %Choose(<choice 2>) {<macro code2>} <etc...> %Default {<default macro code>}}

Глобально

Значение макроса

*/Если %TableName - MOVIE_COPY*/
%Switch (%TableName) {%Choose(MOVIE_COPY) {%FK}
%Choose(MOVIE_RENTAL_RECOR){%PK}
%Default{%PK}}

Возвращает физическое имя таблицы триггерного объекта.

%TableName

Триггер.

Имя таблицы

%TableName

Возвращает имя шаблона триггера, хранимой процедуры или сценария.

%TemplateName

Триггер.

Имя шаблона

%TemplateName

Возвращает физическое имя триггера.

%TriggerName

Триггер.

Имя триггера

%TriggerName

Булево выражение, имеющее значение "true", если данные триггер и отношение соответствуют данному действию <action>(Update/Delete/Insert), <RI type> (Child/Parent) и <integrity> (Cascade/Restrict/Set Null/Set Default).

%TriggerRelRI(<action>,<RI type>,<integrity>)

RI или Переопределение отношений, %If

TRUE/FALSE

%ForEachChildRel() {%If(%TriggerRelRI(Update,Child,Cascade))
{%VerbPhrase Child Update Cascade}}

Перечисляет внешние ключевые элементы дочерней сущности в отношении и выполняет обновление с каждым членом. Доступно только для ORACLE7, SQL Server и SYBASE.

%UpdateChildFK()

RI или Переопределение отношений

Значение и действие внешнего ключа

%UpdateChildFK()

Перечисляет первичные ключевые элементы родительской сущности в отношении и выполняет обновление каждого члена. Доступно только для ORACLE7, SQL Server и SYBASE.

%UpdateParentPK()

RI или Переопределение отношений

Значение и действие первичного ключа

%UpdateParentPK()

Перечисляет первичные ключевые элементы триггерной сущности и выполняет обновление каждого члена. Доступно только для ORACLE7, SQL Server и SYBASE.

%UpdatePK()

Триггер.

Значение и действие первичного ключа

%UpdatePK()

Преобразует раскрытый <macro code> в верхний регистр.

%Upper (<macro code>)

Глобально

Строка

%Upper(%EntityName)

Булево выражение, позволяющее вам определять, имеет ли текущее допущение корректные значения.

% ValidationHasValidValues(<validation name>)

Глобально (с аргументом <validation name>) или %ForEachValidation, %If

TRUE/FALSE

Возвращает название правила проверки допустимости.

%ValidationName

%ForEachValidation

Имя правила проверки допустимости

%ValidationName

Возвращает правило проверки со стороны сервера.

%ValidationRule(<validation name>} или %ValidationRule

Глобально (с аргументом <validation name>) или %ForEachValidation

Строка правила проверки допустимости

%ValidationRule

(Valid CustNumber)

Возвращает допустимые значения данных

%ValidValue

%ForEachValidValue

Строка

%ValidValue

Возвращает определение допустимого значения.

%ValidValueDef

%ForEachValidValue

Строка

/*Если допустимые значения: COMEDY, 
HORROR, DRAMA, NEW RELEASE и CHILDREN, 
определение одного из них может быть:*/

%ValidValueDef

%VerbPhrase

%VerbPhrase