Prompt class

Paket:

botbuilder-dialogs

Kelas dasar untuk semua perintah.

Memperluas

Dialog

Properti

id	ID unik dialog. Mengatur ID unik dialog.
telemetryClient	Mendapatkan klien telemetri untuk dialog ini. Mengatur klien telemetri untuk dialog ini.

Properti yang Diwariskan

EndOfTurn

Mendapatkan hasil akhir giliran default.

Metode

beginDialog(DialogContext, PromptOptions)	Dipanggil saat dialog perintah didorong ke tumpukan dialog dan sedang diaktifkan.
continueDialog(DialogContext)	Dipanggil saat dialog perintah adalah dialog aktif dan pengguna membalas dengan aktivitas baru.
repromptDialog(TurnContext, DialogInstance)	Dipanggil ketika dialog perintah telah diminta untuk meminta kembali input kepada pengguna.
resumeDialog(DialogContext, DialogReason, any)	Dipanggil saat dialog perintah dilanjutkan menjadi dialog aktif pada tumpukan dialog, seperti ketika dialog aktif sebelumnya pada tumpukan selesai.

Metode yang Diwarisi

configure(Record<string, unknown>)	Metode fasih untuk mengonfigurasi objek.
endDialog(TurnContext, DialogInstance, DialogReason)	Saat ditimpa di kelas turunan, lakukan pembersihan untuk dialog sebelum berakhir.
getConverter(string)
getVersion()	String yang dikodekan yang digunakan untuk membantu dalam deteksi perubahan bot pada penyebaran ulang.
onDialogEvent(DialogContext, DialogEvent)	Dipanggil ketika peristiwa telah dinaikkan, menggunakan DialogContext.emitEvent(), dengan dialog saat ini atau dialog yang dimulai dialog saat ini.

Detail Properti

id

ID unik dialog. Mengatur ID unik dialog.

string id

Nilai Properti

string

Id untuk dialog.

Keterangan

Ini akan dibuat secara otomatis jika tidak ditentukan.

telemetryClient

Mendapatkan klien telemetri untuk dialog ini. Mengatur klien telemetri untuk dialog ini.

BotTelemetryClient telemetryClient

Nilai Properti

BotTelemetryClient

BotTelemetryClient digunakan untuk pengelogan.

Detail Properti yang Diwariskan

EndOfTurn

Mendapatkan hasil akhir giliran default.

static EndOfTurn: DialogTurnResult

Nilai Properti

DialogTurnResult

Keterangan

Hasil ini menunjukkan bahwa dialog (atau langkah logis dalam dialog) telah menyelesaikan pemrosesan untuk giliran saat ini, masih aktif, dan menunggu lebih banyak input.

Diwariskan Dari dialog.EndOfTurn

Detail Metode

beginDialog(DialogContext, PromptOptions)

Dipanggil saat dialog perintah didorong ke tumpukan dialog dan sedang diaktifkan.

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

Parameter

dc

DialogContext

DialogContext untuk pergantian percakapan saat ini.

options

PromptOptions

Fakultatif. PromptOptions, informasi tambahan untuk diteruskan ke perintah yang sedang dimulai.

Mengembalikan

Promise<DialogTurnResult>

Promise yang mewakili operasi asinkron.

Keterangan

Jika tugas berhasil, hasilnya menunjukkan apakah perintah masih aktif setelah giliran diproses oleh perintah.

continueDialog(DialogContext)

Dipanggil saat dialog perintah adalah dialog aktif dan pengguna membalas dengan aktivitas baru.

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

Parameter

dc

DialogContext

Dialog Konteks untuk pergantian percakapan saat ini.

Mengembalikan

Promise<DialogTurnResult>

Promise yang mewakili operasi asinkron.

Keterangan

Jika tugas berhasil, hasilnya menunjukkan apakah dialog masih aktif setelah giliran diproses oleh dialog. Perintah umumnya terus menerima balasan pengguna sampai menerima balasan pengguna sebagai input yang valid untuk permintaan tersebut.

repromptDialog(TurnContext, DialogInstance)

Dipanggil ketika dialog perintah telah diminta untuk meminta kembali input kepada pengguna.

function repromptDialog(context: TurnContext, instance: DialogInstance): Promise<void>

Parameter

context

TurnContext

(xref:botbuilder-core. TurnContext), konteks untuk pergantian percakapan saat ini dengan pengguna.

instance

DialogInstance

(xref:botbuilder-dialogs. DialogInstance), instans dialog pada tumpukan.

Mengembalikan

Promise<void>

Promise yang mewakili operasi asinkron.

resumeDialog(DialogContext, DialogReason, any)

Dipanggil saat dialog perintah dilanjutkan menjadi dialog aktif pada tumpukan dialog, seperti ketika dialog aktif sebelumnya pada tumpukan selesai.

function resumeDialog(dc: DialogContext, _reason: DialogReason, _result?: any): Promise<DialogTurnResult>

Parameter

dc

DialogContext

DialogContext untuk pergantian percakapan saat ini.

_reason

DialogReason

Enum yang menunjukkan mengapa dialog dilanjutkan.

_result

any

Opsional, nilai yang dikembalikan dari dialog sebelumnya pada tumpukan. Jenis nilai yang dikembalikan tergantung pada dialog sebelumnya.

Mengembalikan

Promise<DialogTurnResult>

Janji yang mewakili operasi asinkron.

Keterangan

Jika tugas berhasil, hasilnya menunjukkan apakah dialog masih aktif setelah giliran diproses oleh dialog.

Detail Metode yang Diwarisi

configure(Record<string, unknown>)

Metode fasih untuk mengonfigurasi objek.

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

Parameter

config

Record<string, unknown>

Pengaturan konfigurasi yang akan diterapkan.

Mengembalikan

this

yang dapat dikonfigurasi setelah operasi selesai.

Diwariskan DariConfigurable.configure

endDialog(TurnContext, DialogInstance, DialogReason)

Saat ditimpa di kelas turunan, lakukan pembersihan untuk dialog sebelum berakhir.

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

Parameter

_context

TurnContext

Objek konteks untuk giliran.

_instance

DialogInstance

Informasi status saat ini untuk dialog ini.

_reason

DialogReason

Alasan dialog berakhir.

Mengembalikan

Promise<void>

Keterangan

Dialog turunan yang perlu melakukan pengelogan atau pembersihan sebelum berakhir harus mengambil alih metode ini. Secara default, metode ini tidak berpengaruh.

DialogContext memanggil metode ini ketika dialog saat ini berakhir.

Lihat juga

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

Diwariskan Dari Dialog.endDialog

getConverter(string)

function getConverter(_property: string): Converter | ConverterFactory

Parameter

_property

string

Kunci konfigurasi pemilih bersyarah.

Mengembalikan

Converter | ConverterFactory

Pengonversi untuk konfigurasi pemilih.

Diwarisi DariConfigurable.getConverter

getVersion()

String yang dikodekan yang digunakan untuk membantu dalam deteksi perubahan bot pada penyebaran ulang.

function getVersion(): string

Mengembalikan

string

String unik yang seharusnya hanya berubah ketika dialog telah berubah dengan cara yang harus menghidupkan ulang dialog.

Keterangan

Ini default untuk mengembalikan dialog id tetapi dapat ditimpa untuk memberikan logika deteksi perubahan yang lebih tepat. Setiap dialog pada tumpukan yang memiliki perubahan versinya akan mengakibatkan peristiwa versionChanged akan dinaikkan. Jika kejadian ini tidak ditangani oleh bot, kesalahan akan dilemparkan yang mengakibatkan logika handler kesalahan bot dijalankan.

Mengembalikan string kosong akan menonaktifkan pelacakan versi untuk komponen bersama-sama.

Diwariskan Dari Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

Dipanggil ketika peristiwa telah dinaikkan, menggunakan DialogContext.emitEvent(), dengan dialog saat ini atau dialog yang dimulai dialog saat ini.

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

Parameter

dc

DialogContext

Konteks dialog untuk pergantian percakapan saat ini.

e

DialogEvent

Peristiwa yang sedang dinaikkan.

Mengembalikan

Promise<boolean>

True jika peristiwa ditangani oleh dialog saat ini dan gelembung harus berhenti.

Diwarisi Dari dialog.onDialogEvent