EditActions class

Пакет:

botbuilder-dialogs-adaptive

Класс, который позволяет изменять текущие действия.

Extends

Dialog<O>

Конструкторы

EditActions()	Инициализирует новый экземпляр класса EditActions .
EditActions(ActionChangeType, Dialog[])	Инициализирует новый экземпляр класса EditActions .

Свойства

$kind
actions	Действия для обновления диалогового окна.
changeType	Тип изменения, внося в список действий диалоговых окон.
disabled	Необязательное выражение, если имеет значение true, отключает это действие.

Унаследованные свойства

EndOfTurn	Возвращает результат окончания поворота по умолчанию.
id
telemetryClient

Методы

beginDialog(DialogContext, O)	Запускает новый диалог и помещает его в стек диалогов.
getConverter(Object)
getDependencies()	Возвращает дочерние зависимости диалогового окна , чтобы их можно было добавить в набор диалоговых окон контейнеров.

Наследуемые методы

configure(Record<string, unknown>)	Метод Fluent для настройки объекта .
continueDialog(DialogContext)	При переопределении в производном классе продолжает диалоговое окно.
endDialog(TurnContext, DialogInstance, DialogReason)	При переопределении в производном классе выполняет очистку диалога до его завершения.
getVersion()	Закодированная строка, используемая для обнаружения изменений бота при повторном развертывании.
onDialogEvent(DialogContext, DialogEvent)	Вызывается при возникновении события с помощью DialogContext.emitEvent(), текущим диалогом или диалогом, запущенным текущим диалогом.
repromptDialog(TurnContext, DialogInstance)	При переопределении в производном классе повторно запрашивает пользователя для ввода данных.
resumeDialog(DialogContext, DialogReason, any)	При переопределении в производном классе возобновляет диалог после завершения диалога над ним в стеке.

Сведения о конструкторе

EditActions()

Инициализирует новый экземпляр класса EditActions .

new EditActions()

EditActions(ActionChangeType, Dialog[])

Инициализирует новый экземпляр класса EditActions .

new EditActions(changeType: ActionChangeType, actions?: Dialog[])

Параметры

changeType

ActionChangeType

(xref:botbuilder-dialogs-adaptive. ActionChangeType), тип изменения, применяемого к активным действиям.

actions

Dialog[]

Необязательный элемент. Зависимости дочерних диалогов , чтобы их можно было добавить в набор диалоговых окон контейнеров.

Сведения о свойстве

$kind

static $kind: string

Значение свойства

string

actions

Действия для обновления диалогового окна.

actions: Dialog[]

Значение свойства

Dialog[]

changeType

Тип изменения, внося в список действий диалоговых окон.

changeType: EnumExpression<ActionChangeType>

Значение свойства

EnumExpression<ActionChangeType>

disabled

Необязательное выражение, если имеет значение true, отключает это действие.

disabled?: BoolExpression

Значение свойства

BoolExpression

Сведения об унаследованном свойстве

EndOfTurn

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

static EndOfTurn: DialogTurnResult

Значение свойства

DialogTurnResult

Комментарии

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

Наследуется от Dialog.EndOfTurn

id

id: string

Значение свойства

string

Наследуется от Dialog.id

telemetryClient

telemetryClient: BotTelemetryClient

Значение свойства

BotTelemetryClient

Наследуется от Dialog.telemetryClient

Сведения о методе

beginDialog(DialogContext, O)

Запускает новый диалог и помещает его в стек диалогов.

function beginDialog(dc: DialogContext, options?: O): Promise<DialogTurnResult>

Параметры

dc

DialogContext

DialogContext для текущего диалога.

options

O

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

Возвращаемое значение

Promise<DialogTurnResult>

Promise, представляющий асинхронную операцию.

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

Параметры

property

Object

Ключ конфигурации условного селектора.

Возвращаемое значение

Converter | ConverterFactory

Преобразователь для конфигурации селектора.

getDependencies()

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

function getDependencies(): Dialog[]

Возвращаемое значение

Dialog[]

Дочерние зависимости диалогового окна .

Сведения о наследуемом методе

configure(Record<string, unknown>)

Метод Fluent для настройки объекта .

function configure(config: Record<string, unknown>): this

Параметры

config

Record<string, unknown>

Применяемые параметры конфигурации.

Возвращаемое значение

this

Объект Configurable после завершения операции.

Наследуется от Configurable.configure

continueDialog(DialogContext)

При переопределении в производном классе продолжает диалоговое окно.

function continueDialog(dc: DialogContext): Promise<DialogTurnResult>

Параметры

dc

DialogContext

Контекст для текущего диалогового окна.

Возвращаемое значение

Promise<DialogTurnResult>

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

Комментарии

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

DialogContext вызывает этот метод при продолжении диалога.

Чтобы сообщить контексту диалога о завершении этого диалога, перед выходом из этого метода дождитесь dialogContext.endDialog .

См. также:

• DialogContext.continueDialog

Наследуется от Dialog.continueDialog

endDialog(TurnContext, DialogInstance, DialogReason)

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

function endDialog(_context: TurnContext, _instance: DialogInstance, _reason: DialogReason): Promise<void>

Параметры

_context

TurnContext

Объект контекста для шага.

_instance

DialogInstance

Сведения о текущем состоянии для этого диалогового окна.

_reason

DialogReason

Причина завершения диалога.

Возвращаемое значение

Promise<void>

Комментарии

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

DialogContext вызывает этот метод при завершении текущего диалога.

См. также:

• DialogContext.cancelAllDialogs
• DialogContext.endDialog
• DialogContext.replaceDialog

Наследуется от Dialog.endDialog

getVersion()

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

function getVersion(): string

Возвращаемое значение

string

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

Комментарии

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

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

Наследуется от Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

Вызывается при возникновении события с помощью DialogContext.emitEvent(), текущим диалогом или диалогом, запущенным текущим диалогом.

function onDialogEvent(dc: DialogContext, e: DialogEvent): Promise<boolean>

Параметры

dc

DialogContext

Контекст диалога для текущего диалога.

e

DialogEvent

Создаваемое событие.

Возвращаемое значение

Promise<boolean>

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

Наследуется от Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

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

function repromptDialog(_context: TurnContext, _instance: DialogInstance): Promise<void>

Параметры

_context

TurnContext

Объект контекста для шага.

_instance

DialogInstance

Сведения о текущем состоянии для этого диалогового окна.

Возвращаемое значение

Promise<void>

Комментарии

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

DialogContext вызывает этот метод, когда текущий диалог должен повторно запрашивать входные данные у пользователя. Этот метод реализован для диалоговых окон запроса.

См. также:

• DialogContext.repromptDialog
• Командная строка.

Наследуется от Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

При переопределении в производном классе возобновляет диалог после завершения диалога над ним в стеке.

function resumeDialog(dc: DialogContext, reason: DialogReason, result?: any): Promise<DialogTurnResult>

Параметры

dc

DialogContext

Контекст для текущего диалогового окна.

reason

DialogReason

Причина возобновления диалога. Обычно это DialogReason.endCalled.

result

any

Необязательный элемент. Возвращаемое значение, если таковое имеется, из оконченного диалогового окна.

Возвращаемое значение

Promise<DialogTurnResult>

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

Комментарии

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

DialogContext вызывает этот метод при возобновлении диалога. Если в предыдущем диалоговом окне в стеке возвращалось значение, это значение находится в параметре result .

Чтобы запустить дочерний диалог, используйте DialogContext.beginDialog или DialogContext.prompt; однако этот диалог не обязательно будет запускать дочерний диалог. Чтобы сообщить контексту диалога о завершении этого диалога, перед выходом из этого метода дождитесь dialogContext.endDialog .

См. также:

• DialogContext.endDialog

Наследуется от Dialog.resumeDialog