Документация для разработчиков
Темная тема

BX.UI.StepProcessing.Process

Конструктор


Конструктор класса


constructor(options: ProcessOptions)


Поля структуры для инициализации процесса ProcessOptions.

Старт / стоп


start(startStep?: number = 1) – Стартует обработку очереди заданий. Необязательный аргумент – номер позиции в очереди.


stop() – Отмена обработки очереди.


startRequest() – Отправляет запрос текущего задания


stopRequest() – Прерывает запрос текущего задания и отправляет на дефолтный контролер действие cancel. Контроллер должен реализовать действие с таким именем.


finalizeRequest() – отправляет на дефолтный контролер действие finalize, предназначенное для освобождения ресурсов и очистки временных данных. Контроллер должен реализовать действие с таким именем.


Установка заданий очереди


Поля структуры задания очереди – QueueAction.


setQueue(queue: Array) – Установить всю очередь заданий.


addQueueAction(action: QueueAction) – Добавить отдельное задание.


getQueueLength(): number – Длина очереди.


ID процесса


Уникальный код процесса в контексте страницы.


setId(id: string)


getId(): string


Опции процесса


Опции описаны в структуре для инициализации процесса – ProcessOptions.


setOption(name: $Keys, value: any)


getOption(name: $Keys, defaultValue?: any = null): any


Поля для ввода пользователем на стартовой странице


Поля структуры для инициализации полей ввода на диалоге – OptionsField.


setOptionsFields(optionsFields: {[id: string]: OptionsField}) – Установить сразу все поля.


addOptionsField(id: string, field: OptionsField) – Добавить отдельное поле.


storeOptionFieldValues(values: {[name: string]: any}) – Сохранить стартовые значения в sessionStorage.


restoreOptionFieldValues() – Восстановить значения из sessionStorage.


Параметры запроса


setParams(params: {[name: string]: any})


getParams(): {[string]:any}


setParam(key: string, value: any)


getParam(key: string): any | null


Состояние процесса


Описания состояний – ProcessState.


setState(state: $Values, result?: ProcessResult = {}) – Устанавливает новое состояние процесса.


getState(): $Values


Контроллер


Описание контроллера.


setController(controller: string) – Устанавливает контроллер, которому будут отправляться запросы.


getController(): string




setComponent(component: string, componentMode: 'class'|'ajax' = 'class') – Устанавливает контроллер компонента, которому будут отправляться запросы.


getComponent(): string


Действие


Описание действий контроллера.


setAction(action: string)


getAction(): string callAction(action: string)



Функции коллбеки


Типы вызовов – ProcessCallback.


setHandlers(handlers: {[$Keys]: any => {}})


setHandler(type: $Keys, handler: any => {})


hasHandler(type: $Keys)


callHandler(type: $Keys, args: any)


hasActionHandler(type: $Keys)


callActionHandler(type: $Keys, args: any)


Фразы, выводимые на диалог и кнопки


Типы фраз.


setMessages(messages: {[string]: string})


setMessage(id: string, text: string)


getMessage(id: string, placeholders?: {[string]: string} = null): strin



Диалог


getDialog(): Dialog – Получить ссылку на инстанс объекта диалога для текущего процесса Dialog.


showDialog () – Отобразить диалог.


closeDialog () – Скрыть диалог.


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх