Справочник встроенных подпрограмм и функций ORACLE FORMS DEVELOPER

EDIT_TEXTITEM - запускает редактор для текущего элемента текста, а также переводит формы в режим редактирования.

Параметры:

• x - определяет координату "х" на экране относительно левого края элемента.
• Y - определяет координату "у" на экране относительно левого края элемента.
• Width - определяет ширину редактора, включая кнопки. Height - определяет высоту редактора, включая кнопки.

ENFORCE_COLUMN_SECURITY - обеспечивает по умолчанию проверку столбца. Данная процедура ограничения действительна только в соответствующем триггере On-Column-Security.

ENTER - тестирует данные в текущем проверяемом модуле.

ENTER_QUERY [ ( { ALL_RECORDS [ , FOR_UPDATE [ , NOWAIT ] ] | FOR_UPDATE [ , NOWAIT ] } ) ] Поведение ENTER_QUERY меняется в зависимости от используемых параметров:

• ENTER_QUERY - завершает работу с текущим блоком и переводит форму в режим Enter Query. Если в этом блоке есть изменения, которые нужно сохранить, Forms предлагает оператору сделать это во время события ENTER_QUERY.
• ENTER_QUERY(ALL_RECORDS) - выполняет те же действия, что и ENTER_QUERY, за исключением того, что когда вызывается EXECUTE_QUERY, Forms вызывает все выбранные записи.
• ENTER_QUERY(FOR_UPDATE) - выполняет те же действия, что и ENTER_QUERY, за исключением того, что когда вызывается EXECUTE_QUERY, Forms пытается немедленно заблокировать все выбранные записи.
• ENTER_QUERY(ALL_RECORDS,FOR_UPDATE) - выполняет те же действия, что и ENTER_QUERY, за исключением того, что когда вызывается EXECUTE_QUERY, Forms пытается немедленно заблокировать все выбранные записи и вызывает их.
  Примечание: рекомендуется использовать параметры ALL_RECORDS и FOR_UPDATE очень осторожно. Вызов очень большого числа строк может потребовать большой задержки. Одновременная блокировка большого числа строк требует много ресурсов.

ERASE ( global_variable_name ) - удаляет указанную глобальную переменную так, что она больше не существует, и освобождает память, связанную с глобальной переменной.

Параметры:

• global_variable_name - имя глобальной переменной, предназначенной для удаления.
  • ERROR_CODE - возвращает код ошибки Form Builder.
  • ERROR_TEXT - возвращает текст ошибки Form Builder.
  • ERROR_TYPE - возвращает тип ошибки Form Builder. Тип ошибки - ORA или FRM.

EXECUTE_QUERY [ ( { ALL_RECORDS [ , FOR_UPDATE [ , NOWAIT ] ] | FOR_UPDATE [ , NOWAIT ] } ) ] - меняется в зависимости от используемых параметров:

• EXECUTE_QUERY - завершает работу с текущим блоком, открывает запрос и выводит некоторое число выбранных записей. Если в этом блоке есть изменения, которые нужно сохранить, Forms предлагает оператору сделать это во время обработки EXECUTE_QUERY.
• EXECUTE_QUERY(ALL_RECORDS) - выполняет те же действия, что и EXECUTE_QUERY, за исключением того, что SQL*Forms вызывает все выбранные записи.
• EXECUTE_QUERY(FOR _UPDATE) - выполняет те же действия, что и EXECUTE_QUERY, за исключением того, что Forms пытается немедленно заблокировать все выбранные записи.
• EXECUTE_QUERY(ALL_RECORDS, FOR_UPDATE) - выполняет те же действия, что EXECUTE_QUERY, за исключением того, что Forms пытается немедленно заблокировать все выбранные записи и вызывает их. Примечание: рекомендуется использовать параметры ALL_RECORDS и FOR_UPDATE очень осторожно. Вызов очень большого числа строк может потребовать большой задержки. Одновременная блокировка большого числа строк требует много ресурсов.

ERASE (global_variable_name) - удаляет указанную глобальную переменную так, что она больше не существует, и освобождает память, связанную с глобальной переменной.

Параметры:

• global_variable_name - имя глобальной переменной, предназначенной для удаления.
  • ERROR_CODE - возвращает код ошибки Form Builder.
  • ERROR_TEXT - возвращает текст ошибки Form Builder.
  • ERROR_TYPE - возвращает тип ошибки Form Builder. Тип ошибки - ORA или FRM.

EXECUTE_QUERY [ ( { ALL_RECORDS [ , FOR_UPDATE [ , NOWAIT ] ] | FOR_UPDATE [ , NOWAIT ] } ) ] - меняется в зависимости от используемых параметров:

• EXECUTE_QUERY - завершает работу с текущим блоком, открывает запрос и выводит некоторое число выбранных записей. Если в этом блоке есть изменения, которые нужно сохранить, Forms предлагает оператору сделать это во время обработки EXECUTE_QUERY.
• EXECUTE_QUERY(ALL_RECORDS) - выполняет те же действия, что и EXECUTE_QUERY, за исключением того, что SQL*Forms вызывает все выбранные записи.
• EXECUTE_QUERY(FOR_UPDATE) - выполняет те же действия, что и EXECUTE_QUERY, за исключением того, что Forms пытается немедленно заблокировать все выбранные записи.
• EXECUTE_QUERY(ALL_RECORDS, FOR_UPDATE) - выполняет те же действия, что EXECUTE_QUERY, за исключением того, что Forms пытается немедленно заблокировать все выбранные записи и вызывает их. Примечание: рекомендуется использовать параметры ALL_RECORDS и FOR_UPDATE очень осторожно. Вызов очень большого числа строк может потребовать большой задержки. Одновременная блокировка большого числа строк требует много ресурсов.

По умолчанию же, если вы напишите просто execute_query, Forms извлечет все записи из текущего блока

EXECUTE_TRIGGER - выполняет указанный триггер, обычно это именованный триггер, то есть триггер, созданный пользователем.

Параметры:

• trigger_name - определяет имя пользовательского (именованного) триггера.

EXIT_FORM [ ( ASK_COMMIT | DO_COMMIT | NO_COMMIT | NO_VALIDATE ) ] - завершает функцию CALL_INPUT во время ее работы. Во всех других контекстах EXIT_FORM передает управление "за" форму. Если в текущей форме есть изменения, которые не были посланы на сохранение ( posted ) или сохранены ( committed ), то поведение EXIT_ FORM зависит от параметров:

• нетпараметров - Forms предложит оператору сохранить изменения при работе с EXIT_FORM.
• ASK_COMMIT - Forms предложит оператору сохранить изменения при работе с EXIT_FORM.
• DO_COMMIT - Forms протестирует изменения, выполнит сохранение изменений и выйдет из текущей формы без вопроса оператору.
• NO_COMMIT - Forms протестирует изменения и выйдет из текущей формы без выполнения сохранения или вопроса оператору.
• NO_VALIDATE - Forms выйдет из текущей формы без тестирования изменений и их сохранения или вопроса оператору.

FETCH_RECORDS - вызванная из триггера On-Fetch, инициирует по умолчанию процесс для извлечения набора данных, определяя его как выборку (select).

FIND_ALERT - это функция поиска идентификатора "Предупреждения" ( Alert ). Возвращает тип - Alert.

Параметры:

• alert_name - имя "Предупреждения". Тип данных - VARCHAR2.

FIND_BLOCK - это функция поиска идентификатора "Блока" (Block). Возвращает тип Block.

Параметры:

• block_name - имя "Блока". Тип данных - VARCHAR2.

FIND_CANVAS - это функция поиска идентификатора "Вид-картинки" ( Canvas ). Возвращает тип Canvas.

Параметры:

• canvas_name - имя "Вид-картинки" ( Canvas ). Тип данных - VARCHAR2.

FIND_COLUMN - это функция поиска идентификатора "столбца" (Column) группы записей. Возвращает тип GroupColumn.

Параметры:

• recordgroup _name.column_name - имя "столбца" (Column). Тип данных - VARCHAR2.

FIND_EDITOR - это функция поиска идентификатора "Редактора" ( Editor ). Возвращает тип Editor.

Параметры:

• canvas_name - имя "Редактор" ( Editor ). Тип данных - VARCHAR2.

FIND_FORM - это функция поиска идентификатора "Формы" (Form). Возвращает тип FORMMODULE.

Параметры:

• canvas_name - имя модуля формы. Тип данных - VARCHAR2.

FIND_GROUP - это функция поиска идентификатора "Группы записей" ( RecordGroup ). Возвращает тип RecordGroup.

Параметры:

• group_name - имя группы записей. Тип данных - VARCHAR2.

FIND_ITEM - это функция поиска идентификатора элемента ( ITEM ). Возвращает тип ITEM.

Параметры:

• block_name.item_name - имя элемента ( Item ). Тип данных - VARCHAR2.

FIND_LOV - это функция поиска идентификатора "Списка значений" ( LOV ). Возвращает тип LOV.

Параметры:

• LOV_name - имя "Списка значений" ( LOV ). Тип данных - VARCHAR2.

FIND_MENU_ITEM - это функция поиска идентификатора элемента меню ( MenuItem ). Возвращает тип MenuItem.

Параметры:

• menu_name.menuitem_name - имя элемента меню ( MenuItem ). Тип данных - VARCHAR2.

FIND_RELATION - это функция поиска идентификатора "Связи" ( Relation ). Возвращает тип Relation.

Параметры:

• relation_name - имя "Связи" (Relation). Тип данных - VARCHAR2.

FIND_REPORT_OBJECT - возвращает идентификатор указанного отчета. Возвращаемый тип - Report_Object.

Параметры:

• report_name - имя отчета, идентификатор ( ID ) которого мы собираемся получить.

FIND_TAB_PAGE - это функция возвращает идентификатор вкладки ( Tab ) вложенной вид-картинки ( Tab-Canvas ). Возвращаемый тип - TAB_PAGE.

Параметры:

• tab_ page_name - уникальное имя страницы вкладки. Тип данных - VARCHAR2.
  Примечание: если вложенная вид-картинка имеет страницы с идентичными именами, то в таком случае нужно писать следующим образом: MY_TAB_CVS.TAB_PAGE_1.

FIND_TIMER - это функция возвращает идентификатор таймера. Тип данных - Timer.

Параметры:

• timer_name - принимает в качестве значения имя таймера. Тип данных - VARCHAR2.

FIND_TREE_NODE - это функция возвращает идентификатор узла дерева. Тип данных - Node.

Параметры:

• item_name - специфицирует имя объекта, данное ему на этапе проектирования. Тип данных - VARCHAR2.
• Item_id - уникальный идентификатор, который Forms Builder связывает с элементом при создании. Функция поиска идентификатора - FIND_ITEM.
• search_string - строка поиска. Тип данных - VARCHAR2. search_type - определяет тип поиска (по дочернему элементу или узлу). Возможные значения: FIND_NEXT, FIND_NEXT_CHILD. Тип данных - NUMBER.
• search_by - определяет тип поиска - по метке или значению элемента. Соответственно, принимаемые значения - NODE_LABEL и NODE_VALUE. Тип данных - NUMBER.
• search_root - определяет корневой узел в указанном дереве. Например: FTREE.ROOT_NODE.
• start_point - определяет стартовую точку поиска, к примеру, для поиска с начала дерева - FTREE.ROOT_NODE.

FIND_VA - это функция поиска визуального атрибута блока или элемента. Возвращаемый тип - Visual_Attribute.

Параметры:

• va_name - определяет имя визуального атрибута.

FIND_VIEW - возвращает идентификатор отображения ( View ) вид-картинки ( Canvas ). Тип данных - ViewPort.

• viewcanvas_name - имя вид-картинки. Тип данных - Varchar2.

FIND_WINDOW - эта функция возвращает идентификатор окна. Тип данных - Window.

Параметры:

• window_name - имя окна. Тип данных - Varchar2.

FIRST_RECORD - переходит к первой записи.

FORM_FAILURE - возвращает идентификатор результата выполнения действия ( Action ). Другими словами, она дает вам возможность узнать статус выполнения вашей процедуры или триггера: FORM_FAILURE - возвращает BOOLEAN:

• успешно (succes) FALSE
• неуспешно (failure) TRUE
• фатальная ошибка (fatal) FALSE

Если никакой процедуры не выполнялось во время текущей сессии Forms(RunForm), FORM_FAILURE возвращает FALSE. Существует также процедура FORM_FATAL, которая возвращает true, в случае фатальной ошибки, в остальных случаях - FALSE.

FORM_FATAL - в Runtime-сессии тестирует последнюю процедуру в триггере, стоящую перед FORM_FATAL, на фатальную ошибку, и в случае если:

• успешно (success) FALSE
• неуспешно (failure) FALSE
• фатальная ошибка (fatal error) TRUE

FORM_SUCCESS - проверяет предыдущее событие на успешное выполнение. Если:

• успешно (success) TRUE
• неуспешно (failure) FALSE
• фатальная ошибка (fatal error) FALSE

FORMS_DDL - выполняет команды DDL (язык определения данных: commit, create...), DML (язык описания данных: insert, update...) и PL/SQL в RunTime сессии.

Параметры:

• statement - любая строка, не превышающая 32К. Тип данных - Varchar2.