CodeAction class

Pacchetto:

botbuilder-dialogs-adaptive

Classe che rappresenta un'azione di codice dialog.

Extends

Dialog<O>

Costruttori

CodeAction(CodeActionHandler)

Inizializza una nuova istanza della classe CodeAction .

Proprietà

disabled

Proprietà ereditate

EndOfTurn	Ottiene un risultato di fine turno predefinito.
id
telemetryClient

Metodi

beginDialog(DialogContext, O)	Viene chiamato all'avvio della finestra di dialogo ed è stato eseguito il push nello stack di dialoghi.
getConverter(Object)

Metodi ereditati

configure(Record<string, unknown>)	Metodo Fluent per la configurazione dell'oggetto.
continueDialog(DialogContext)	Quando ne viene eseguito l'override in una classe derivata, continua la finestra di dialogo.
endDialog(TurnContext, DialogInstance, DialogReason)	Quando sottoposto a override in una classe derivata, esegue la pulizia per la finestra di dialogo prima che termini.
getVersion()	Stringa codificata usata per facilitare il rilevamento delle modifiche del bot nella ri-distribuzione.
onDialogEvent(DialogContext, DialogEvent)	Chiamato quando è stato generato un evento, utilizzando DialogContext.emitEvent(), dalla finestra di dialogo corrente o da una finestra di dialogo avviata dalla finestra di dialogo corrente.
repromptDialog(TurnContext, DialogInstance)	Quando ne viene eseguito l'override in una classe derivata, reinserito l'utente per l'input.
resumeDialog(DialogContext, DialogReason, any)	Quando ne viene eseguito l'override in una classe derivata, riprende il dialogo al termine del dialogo sopra di esso nello stack.

Dettagli costruttore

CodeAction(CodeActionHandler)

Inizializza una nuova istanza della classe CodeAction .

new CodeAction(codeHandler: CodeActionHandler)

Parametri

codeHandler

CodeActionHandler

(xref:botbuilder-dialogs-adaptive. CodeActionHandler), gestore del codice per l'azione.

Dettagli proprietà

disabled

disabled?: BoolExpression

Valore della proprietà

BoolExpression

Dettagli proprietà ereditate

EndOfTurn

Ottiene un risultato di fine turno predefinito.

static EndOfTurn: DialogTurnResult

Valore della proprietà

DialogTurnResult

Commenti

Questo risultato indica che un dialogo (o un passaggio logico all'interno di una finestra di dialogo) ha completato l'elaborazione per il turno corrente, è ancora attiva ed è in attesa di più input.

ereditato da Dialog.EndOfTurn

id

id: string

Valore della proprietà

string

ereditato da Dialog.id

telemetryClient

telemetryClient: BotTelemetryClient

Valore della proprietà

BotTelemetryClient

ereditato da Dialog.telemetryClient

Dettagli metodo

beginDialog(DialogContext, O)

Viene chiamato all'avvio della finestra di dialogo ed è stato eseguito il push nello stack di dialoghi.

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

Parametri

dc

DialogContext

Il DialogContext per il turno di conversazione corrente.

options

O

Opzionale. Informazioni iniziali da passare alla finestra di dialogo.

Restituisce

Promise<DialogTurnResult>

Oggetto Promise che rappresenta l'operazione asincrona.

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

Parametri

property

Object

Chiave della configurazione del selettore condizionale.

Restituisce

Converter | ConverterFactory

Convertitore per la configurazione del selettore.

Dettagli dei metodi ereditati

configure(Record<string, unknown>)

Metodo Fluent per la configurazione dell'oggetto.

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

Parametri

config

Record<string, unknown>

Impostazioni di configurazione da applicare.

Restituisce

this

Configurabile al termine dell'operazione.

Ereditato da Configurable.configure

continueDialog(DialogContext)

Quando ne viene eseguito l'override in una classe derivata, continua la finestra di dialogo.

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

Parametri

dc

DialogContext

Contesto del turno di dialogo corrente.

Restituisce

Promise<DialogTurnResult>

Promessa che risolve il risultato del turno del dialogo.

Commenti

I dialoghi derivati che supportano conversazioni a più turni devono eseguire l'override di questo metodo. Per impostazione predefinita, questo metodo segnala che il dialogo è completo e restituisce.

Il DialogContext chiama questo metodo quando continua la finestra di dialogo.

Per segnalare al contesto del dialogo che il dialogo è stato completato, attendere DialogContext.endDialog prima di uscire da questo metodo.

Vedere anche

• DialogContext.continueDialog

Ereditato da Dialog.continueDialog

endDialog(TurnContext, DialogInstance, DialogReason)

Quando sottoposto a override in una classe derivata, esegue la pulizia per la finestra di dialogo prima che termini.

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

Parametri

_context

TurnContext

Oggetto di contesto per il turno.

_instance

DialogInstance

Informazioni sullo stato corrente per questa finestra di dialogo.

_reason

DialogReason

Motivo per cui la finestra di dialogo sta terminando.

Restituisce

Promise<void>

Commenti

Le finestre di dialogo derivate che devono eseguire la registrazione o la pulizia prima di terminare devono eseguire l'override di questo metodo. Per impostazione predefinita, questo metodo non ha alcun effetto.

Il DialogContext chiama questo metodo al termine della finestra di dialogo corrente.

Vedere anche

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

Ereditato da Dialog.endDialog

getVersion()

Stringa codificata usata per facilitare il rilevamento delle modifiche del bot nella ri-distribuzione.

function getVersion(): string

Restituisce

string

Stringa univoca che deve cambiare solo quando il dialogo è stato modificato in modo da riavviare la finestra di dialogo.

Commenti

Per impostazione predefinita, la restituzione dei dialoghi id ma può essere sottoposta a override per fornire una logica di rilevamento delle modifiche più precisa. Qualsiasi finestra di dialogo nello stack con la modifica della versione genererà un evento versionChanged verrà generato. Se questo evento non viene gestito dal bot, verrà generato un errore che causa l'esecuzione della logica del gestore errori dei bot.

La restituzione di una stringa vuota disabilita il rilevamento della versione per il componente insieme.

ereditato da Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

Chiamato quando è stato generato un evento, utilizzando DialogContext.emitEvent(), dalla finestra di dialogo corrente o da una finestra di dialogo avviata dalla finestra di dialogo corrente.

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

Parametri

dc

DialogContext

Contesto del dialogo per il turno corrente della conversazione.

e

DialogEvent

Evento generato.

Restituisce

Promise<boolean>

True se l'evento viene gestito dalla finestra di dialogo corrente e il bubbling deve essere arrestato.

ereditato da Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

Quando ne viene eseguito l'override in una classe derivata, reinserito l'utente per l'input.

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

Parametri

_context

TurnContext

Oggetto di contesto per il turno.

_instance

DialogInstance

Informazioni sullo stato corrente per questa finestra di dialogo.

Restituisce

Promise<void>

Commenti

I dialoghi derivati che supportano la convalida e la logica di ripetizione della richiesta devono eseguire l'override di questo metodo. Per impostazione predefinita, questo metodo non ha alcun effetto.

Il DialogContext chiama questo metodo quando la finestra di dialogo corrente deve richiedere nuovamente l'input dell'utente. Questo metodo viene implementato per i dialoghi di richiesta.

Vedere anche

• DialogContext.repromptDialog
• prompt

ereditato da Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

Quando ne viene eseguito l'override in una classe derivata, riprende il dialogo al termine del dialogo sopra di esso nello stack.

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

Parametri

dc

DialogContext

Contesto del turno di dialogo corrente.

reason

DialogReason

Motivo per cui viene ripreso il dialogo. Questo in genere sarà DialogReason.endCalled

result

any

Opzionale. Valore restituito, se presente, dalla finestra di dialogo terminata.

Restituisce

Promise<DialogTurnResult>

Promessa che risolve il risultato del turno del dialogo.

Commenti

I dialoghi derivati che supportano conversazioni a più turni devono eseguire l'override di questo metodo. Per impostazione predefinita, questo metodo segnala che il dialogo è completo e restituisce.

Il DialogContext chiama questo metodo quando riprende la finestra di dialogo. Se la finestra di dialogo precedente sullo stack ha restituito un valore, tale valore si trova nel parametro result.

Per avviare una finestra di dialogo di figlio , usare DialogContext.beginDialog o DialogContext.prompt; Tuttavia, questo dialogo non sarà necessariamente quello che ha avviato il dialogo figlio. Per segnalare al contesto del dialogo che il dialogo è stato completato, attendere DialogContext.endDialog prima di uscire da questo metodo.

Vedere anche

• DialogContext.endDialog

Ereditato da Dialog.resumeDialog