История страницы

Информация

icon	false

Корневой элемент handler, async-handler. Пространство имен: <ui xmlns="http://www.intertrust.ru/schema/palette/tn-ui">

Информация

icon	false
title	Краткое описание

Используется для подключения JavaBean или написание JavaScript кода

Блок кода

language	xml
title	Структура XML
collapse	true

<?xml version='1.0' encoding='UTF-8'?>
<ui xmlns="http://www.intertrust.ru/schema/palette/tn-ui">
	<!-- Асинхронный обработчик-->
    <async-handler id="{id}" name="{name}" name-process="{process name}">
		<script lang="JavaBean"><![CDATA[...]]></script>
	</async-handler>
	
	<handler  <form>
id="{id}" name="{name}">
        <script lang="JavaScript"><![CDATA[...]]></script>
    </form>handler>
</ui>

handler

attributes

Параметры	Описание
id	Идентификатор
name	Название
use-by-link	Можно ли подписывать обработчик для использования пользователем без прямых прав чтения

script

Параметры	Описание
lang	Язык программирования JavaScript/подключение JavaBean

function

Блок кода

language	js
collapse	true

importClass(Packages.ru.intertrust.cmj.af.core.AFSession);
importClass(Packages.ru.intertrust.cmj.af.exceptions.AFDaoBadParameterException);
importClass(Packages.ru.intertrust.cmj.rest.tunable.object.TunableObjectREST);
importClass(Packages.ru.intertrust.cmj.rest.tunable.object.TunableObjectREST.Resource);
importClass(Packages.ru.intertrust.cmj.rest.tunable.object.action.TunableOperation);
importClass(Packages.ru.intertrust.cmj.tunable.object.AnyTunableObject);
importClass(Packages.ru.intertrust.cmj.tunable.object.TunableObjectApplication);
importClass(Packages.ru.intertrust.cmj.tunable.object.TunableObjectApplication.ClientContextKey);
importClass(Packages.ru.intertrust.cmj.tunable.object.common.TunableObjectHelper);
importClass(Packages.ru.intertrust.cmj.rest.tunable.object.action.OperationJScriptREST);
importClass(Packages.ru.intertrust.cmj.rest.tunable.object.action.OperationJScriptREST.ReturnParamsResource);
importPackage(Packages.java.util);
importPackage(Packages.java.lang);
 
function process(paramsResource, returnResource) {
    if (paramsResource == null) {
        throw new IllegalArgumentException("paramsResource must no be null.");
    }
    var paramPackageId = TunableObjectHelper.getAFInstanceValue(paramsResource.tuning().getValues()
        .get("counter"));
    if (paramPackageId.equals("context")) { // обработка первого пакета данных
        process_context(paramsResource, returnResource);
    } else if (paramPackageId.equals("answer1")) { // обработка данных первого диалога
        process_dialog1(paramsResource, returnResource);
    }
}
/**
 * Обработка первого пакета данных с клиента.
 * @param paramsResource
 * @return ресурс первого диалога сценария
 */
function process_context(paramsResource, returnResource) {
    var appTNObject = AFSession.get().getApplication(TunableObjectApplication.class);
    var ids = appTNObject.getClientContextIds(paramsResource.tuning());
    if (ids.isEmpty()) {
        throw new AFDaoBadParameterException("Не выбраны документы!");
    }
    /* do something */
    /* здесь указывается имя Схемы диалога который нужно показать клиенту */
    var message = appTNObject.composeDialog("TestDialogScheme", null, null, null);
    TunableObjectHelper.putAFInstanceValue(message.tuning(), "ids", ids);
    TunableObjectHelper.putAFInstanceValue(message, "counter", "answer1");
    returnResource.resource = Resource.create(message);
}
 
/**
 * Обработка данных первого диалога сценария.
 * @param paramsResource
 * @return ресурс второго диалога, или, иначе пустой ответ, как сигнал о завершении операции.
 * В случае пустого ответа клиент должен закрыть документ, если контекст - открытый документ.
 */
function process_onePersonDelete_dialog1(paramsResource, returnResource) {
    /* do something */
    returnResource.setResource(null);
}

paramsResource - экземпляр класса TunableObjectREST.Resource, при первом вызове содержит данные о том, сколько и какие документы выделены, при последующий вызовах это ресурс диалога, в котором было произведено действие submit. Также содержит свойство "counter" которое нужно для определения того, на каком шаге сценария операции находимся. При первом вызове свойство counter= "context", при последующих действиях оно определяется вручную(можно кодом положить нужное значение).

returnResource - экземпляр класса TunableObjectREST.ReturnParamsResource, содержит в себе единственное поле - resource, в которое нужно установить либо:

ресурс диалога c mode=dialog(в таком случае клиент покажет диалог), или какого-либо другого объекта, например, РКК(в таком случае клиент откроет объект с mode=read);
null, что будет означать что операция завершена(в таком случае для кнопки на открытой форме документа клиент закроет документ, для кнопки в представлении клиент оставит открытым представление). Это поле обязательно нужно заполнить перед выходом из функции process(paramsResource, returnResource).

Параметры

Описание

process

function process(paramsResource, returnResource) - название функции менять нельзя

Функция вызывается при первом нажатии кнопки и при последующих нажатиях кнопки с action=submit в диалогах операции.

Через параметр returnResource.resource должна передать диалог/null клиенту. В общем случае используется для вызова нужной функции в зависимости от шага сценария.

process_context

function process_context(paramsResource, returnResource)

Функция вызывается из process(paramsResource, returnResource) при первом вызове, в ней формируется ресурс диалога с нужным значением в поле "counter" и кладется в поле returnResource.resource.

process_<dialog_name>

function process_<dialog_name>(paramsResource, returnResource)

Функция вызывается из process(paramsResource, returnResource) при определенном значении поля "counter". Переподбирается один или несколько объектов(по полю ids), в зависимости от того, на основании данных пришедшего диалога, над объектами проводятся определенные действия, включая сохранение. Заполняется поле returnResource.resource.

Создание схем и секций диалогов в соответствии со сценарием операции.

Для добавления диалога создаётся схема и секция с mode=dialog по определённым правилам:

схема должна наследоваться с ClientContextRequest;
в схеме в общем случае должно присутствовать поле, в котором будут храниться и передаваться следующему диалогу id-выбранных документов.
секция должна быть с условием применения "dialog",
в корне секции должна быть как минимум одна кнопка c действием "submit" или "cancel".
можно делать несколько кнопок submit, но тогда они должны быть привязаны к разным свойствам boolean схемы. При нажатии кнопки клиент установит значение true в соответствующем полe.
Если требуется при определенном условии показать пользователю "красиво оформленное" сообщение об ошибке, то можно это сделать также с помощью диалога.

async-handler

attributes

Параметры	Описание
id	Идентификатор
name	Название
use-by-link	Можно ли подписывать обработчик для использования пользователем без прямых прав чтения
name-operation	Название выполняемой операции (для отображения пользователю)
name-process	Название процесса, в котором используется обработчик (для отображения пользователю)

script

Параметры	Описание
lang	Язык программирования JavaScript/подключение JavaBean

Свойства страницы

Статус


colour	GreyGreen
title	ЧерновикГОТОВО

Комментарий

панель

Теги и атрибуты:

Оглавление

Дерево страниц

Сравнение версий

Старая версия 1

Новая версия 2

Ключ

handler

attributes

id

name

use-by-link

script

lang

function

process

process_context

process_<dialog_name>

Создание схем и секций диалогов в соответствии со сценарием операции.

async-handler

attributes

id

name

use-by-link

name-operation

name-process

script

lang