Compartir a través de


OAuthInput class

OAuthInput pide al usuario que inicie sesión.

Extends

Constructores

OAuthInput(string, string, string, number)

Inicializa una nueva instancia de la clase de OAuthInput

Propiedades

$kind
connectionName

Nombre de la conexión de OAuth que se usa.

text

(Opcional) texto adicional que se va a incluir en la tarjeta de inicio de sesión.

timeout

(Opcional) número de milisegundos que el mensaje esperará a que el usuario se autentique. El valor predeterminado es un valor 900,000 (15 minutos).

title

Título del botón de inicio de sesión de tarjetas.

Propiedades heredadas

allowInterruptions

Directiva de interrupción.

alwaysPrompt

Valor que indica si la entrada siempre debe preguntar al usuario independientemente de que haya un valor o no.

defaultValue

Valor predeterminado del cuadro de diálogo de entrada cuando se supera maxTurnCount.

defaultValueResponse

Plantilla de actividad que se va a enviar cuando se ha alcanzado maxTurnCount y se usa el valor predeterminado.

disabled

Una expresión opcional que, si es true, deshabilitará esta acción.

EndOfTurn

Obtiene un resultado predeterminado de fin de turno.

id
invalidPrompt

Plantilla de actividad que se va a enviar al usuario siempre que el valor proporcionado no sea válido o no.

maxTurnCount

Número máximo de veces que se le pide al usuario este valor antes de que se despiese el cuadro de diálogo.

OPTIONS_PROPERTY
prompt

Actividad que se va a enviar al usuario.

property

Expresión de valor a la que se enlazará la entrada.

telemetryClient
TURN_COUNT_PROPERTY
unrecognizedPrompt

Plantilla de actividad para volver a intentar la solicitud.

validations

Expresiones que se van a ejecutar para validar la entrada.

value

Expresión de valor que se puede usar para inicializar el símbolo del sistema de entrada.

VALUE_PROPERTY

Métodos

beginDialog(DialogContext, PromptOptions)

Se llama cuando se inserta una solicitud cuadro de diálogo en la pila de diálogos y se activa.

continueDialog(DialogContext)

Se llama cuando un mensaje Dialog es el diálogo activo y el usuario respondió con una nueva actividad.

getConverter(Object)
getUserToken(DialogContext, string)

Intenta recuperar el token almacenado para el usuario actual.

signOutUser(DialogContext)

Cierra la sesión del usuario del servicio.

Métodos heredados

configure(Record<string, unknown>)

Método Fluent para configurar el objeto.

endDialog(TurnContext, DialogInstance, DialogReason)

Cuando se invalida en una clase derivada, realiza la limpieza del cuadro de diálogo antes de que finalice.

getVersion()

Cadena codificada que se usa para ayudar a detectar los cambios del bot en la reimplempleción.

onDialogEvent(DialogContext, DialogEvent)

Se llama cuando se ha generado un evento, mediante DialogContext.emitEvent(), mediante el cuadro de diálogo actual o un diálogo que inició el diálogo actual.

repromptDialog(TurnContext, DialogInstance)

Cuando se invalida en una clase derivada, reprote el usuario para la entrada.

resumeDialog(DialogContext, DialogReason, any)

Se llama cuando un cuadro de diálogo secundario completa su turno, devolviendo el control a este cuadro de diálogo.

Detalles del constructor

OAuthInput(string, string, string, number)

Inicializa una nueva instancia de la clase de OAuthInput

new OAuthInput(connectionName?: string, title?: string, text?: string, timeout?: number)

Parámetros

connectionName

string

Opcional. Nombre de la conexión de OAuth que se usa.

title

string

Opcional. Título del botón de inicio de sesión de tarjetas.

text

string

Opcional. Texto adicional que se incluirá en la tarjeta de inicio de sesión.

timeout

number

Opcional. Número de milisegundos que esperará a que el usuario se autentique.

Detalles de las propiedades

$kind

static $kind: string

Valor de propiedad

string

connectionName

Nombre de la conexión de OAuth que se usa.

connectionName: StringExpression

Valor de propiedad

StringExpression

text

(Opcional) texto adicional que se va a incluir en la tarjeta de inicio de sesión.

text?: StringExpression

Valor de propiedad

StringExpression

timeout

(Opcional) número de milisegundos que el mensaje esperará a que el usuario se autentique. El valor predeterminado es un valor 900,000 (15 minutos).

timeout?: IntExpression

Valor de propiedad

IntExpression

title

Título del botón de inicio de sesión de tarjetas.

title: StringExpression

Valor de propiedad

StringExpression

Detalles de las propiedades heredadas

allowInterruptions

Directiva de interrupción.

allowInterruptions: BoolExpression

Valor de propiedad

BoolExpression

Heredado deInputDialog.allowInterruptions

alwaysPrompt

Valor que indica si la entrada siempre debe preguntar al usuario independientemente de que haya un valor o no.

alwaysPrompt: BoolExpression

Valor de propiedad

BoolExpression

Heredado deInputDialog.alwaysPrompt

defaultValue

Valor predeterminado del cuadro de diálogo de entrada cuando se supera maxTurnCount.

defaultValue?: ValueExpression

Valor de propiedad

ValueExpression

heredado deinputDialog.defaultValue

defaultValueResponse

Plantilla de actividad que se va a enviar cuando se ha alcanzado maxTurnCount y se usa el valor predeterminado.

defaultValueResponse: TemplateInterface<Partial<Activity>, DialogStateManager>

Valor de propiedad

TemplateInterface<Partial<Activity>, DialogStateManager>

heredado deinputDialog.defaultValueResponse

disabled

Una expresión opcional que, si es true, deshabilitará esta acción.

disabled?: BoolExpression

Valor de propiedad

BoolExpression

heredado deinputDialog.disabled

EndOfTurn

Obtiene un resultado predeterminado de fin de turno.

static EndOfTurn: DialogTurnResult

Valor de propiedad

DialogTurnResult

Comentarios

Este resultado indica que un cuadro de diálogo (o un paso lógico dentro de un diálogo) ha completado el procesamiento del turno actual, sigue activo y está esperando más entradas.

heredado de dialog.EndOfTurn

id

id: string

Valor de propiedad

string

heredado de Dialog.id

invalidPrompt

Plantilla de actividad que se va a enviar al usuario siempre que el valor proporcionado no sea válido o no.

invalidPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>

Valor de propiedad

TemplateInterface<Partial<Activity>, DialogStateManager>

heredado deinputDialog.invalidPrompt

maxTurnCount

Número máximo de veces que se le pide al usuario este valor antes de que se despiese el cuadro de diálogo.

maxTurnCount?: IntExpression

Valor de propiedad

IntExpression

Heredado deInputDialog.maxTurnCount

OPTIONS_PROPERTY

static OPTIONS_PROPERTY: string

Valor de propiedad

string

heredado deInputDialog.OPTIONS_PROPERTY

prompt

Actividad que se va a enviar al usuario.

prompt: TemplateInterface<Partial<Activity>, DialogStateManager>

Valor de propiedad

TemplateInterface<Partial<Activity>, DialogStateManager>

heredado deinputDialog.prompt

property

Expresión de valor a la que se enlazará la entrada.

property: StringExpression

Valor de propiedad

StringExpression

heredado deinputDialog.property

telemetryClient

telemetryClient: BotTelemetryClient

Valor de propiedad

BotTelemetryClient

Heredado de Dialog.telemetryClient

TURN_COUNT_PROPERTY

static TURN_COUNT_PROPERTY: string

Valor de propiedad

string

heredado deInputDialog.TURN_COUNT_PROPERTY

unrecognizedPrompt

Plantilla de actividad para volver a intentar la solicitud.

unrecognizedPrompt: TemplateInterface<Partial<Activity>, DialogStateManager>

Valor de propiedad

TemplateInterface<Partial<Activity>, DialogStateManager>

Heredado deInputDialog.unrecognizedPrompt

validations

Expresiones que se van a ejecutar para validar la entrada.

validations: string[]

Valor de propiedad

string[]

heredado deinputDialog.validations

value

Expresión de valor que se puede usar para inicializar el símbolo del sistema de entrada.

value: ValueExpression

Valor de propiedad

ValueExpression

se hereda deinputDialog.value

VALUE_PROPERTY

static VALUE_PROPERTY: string

Valor de propiedad

string

heredado deInputDialog.VALUE_PROPERTY

Detalles del método

beginDialog(DialogContext, PromptOptions)

Se llama cuando se inserta una solicitud cuadro de diálogo en la pila de diálogos y se activa.

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

Parámetros

dc

DialogContext

dialogContext para el turno actual de conversación.

options

PromptOptions

Opcional. Información adicional para pasar al símbolo del sistema que se está iniciando.

Devoluciones

Promise<DialogTurnResult>

Un DialogTurnResultPromise que representa la operación asincrónica.

continueDialog(DialogContext)

Se llama cuando un mensaje Dialog es el diálogo activo y el usuario respondió con una nueva actividad.

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

Parámetros

dc

DialogContext

dialogContext para el turno actual de conversación.

Devoluciones

Promise<DialogTurnResult>

Un DialogTurnResultPromise que representa la operación asincrónica.

getConverter(Object)

function getConverter(property: Object): Converter | ConverterFactory

Parámetros

property

Object

Clave de la configuración del selector condicional.

Devoluciones

Converter | ConverterFactory

Convertidor para la configuración del selector.

getUserToken(DialogContext, string)

Intenta recuperar el token almacenado para el usuario actual.

function getUserToken(dc: DialogContext, code?: string): Promise<TokenResponse | undefined>

Parámetros

dc

DialogContext

El contexto hace referencia al usuario que se está buscando.

code

string

(Opcional) código de inicio de sesión recibido del usuario.

Devoluciones

Promise<TokenResponse | undefined>

Promesa que representa la operación asincrónica.

signOutUser(DialogContext)

Cierra la sesión del usuario del servicio.

function signOutUser(dc: DialogContext): Promise<void>

Parámetros

dc

DialogContext

Contexto que hace referencia al usuario que se va a cerrar la sesión.

Devoluciones

Promise<void>

Promesa que representa la operación asincrónica.

Comentarios

En este ejemplo se muestra cómo crear una instancia del símbolo del sistema y, a continuación, cerrar la sesión del usuario.

const prompt = new OAuthPrompt({
    connectionName: 'GitConnection',
    title: 'Login To GitHub'
});
await prompt.signOutUser(context);

Detalles de los métodos heredados

configure(Record<string, unknown>)

Método Fluent para configurar el objeto.

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

Parámetros

config

Record<string, unknown>

Opciones de configuración que se van a aplicar.

Devoluciones

this

configurable una vez completada la operación.

Heredado de Configurable.configure

endDialog(TurnContext, DialogInstance, DialogReason)

Cuando se invalida en una clase derivada, realiza la limpieza del cuadro de diálogo antes de que finalice.

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

Parámetros

_context

TurnContext

Objeto de contexto del turno.

_instance

DialogInstance

Información de estado actual para este cuadro de diálogo.

_reason

DialogReason

Motivo por el que finaliza el cuadro de diálogo.

Devoluciones

Promise<void>

Comentarios

Los diálogos derivados que necesitan realizar el registro o la limpieza antes de finalizar deben invalidar este método. De forma predeterminada, este método no tiene ningún efecto.

El DialogContext llama a este método cuando finaliza el diálogo actual.

Consulte también

Heredado de Dialog.endDialog

getVersion()

Cadena codificada que se usa para ayudar a detectar los cambios del bot en la reimplempleción.

function getVersion(): string

Devoluciones

string

Cadena única que solo debe cambiar cuando el cuadro de diálogo ha cambiado de una manera que debe reiniciar el diálogo.

Comentarios

Este valor predeterminado es devolver los cuadros de diálogo id, pero se puede invalidar para proporcionar lógica de detección de cambios más precisa. Cualquier cuadro de diálogo de la pila que tenga su cambio de versión producirá un evento versionChanged. Si el bot no controla este evento, se producirá un error que dará lugar a la ejecución de la lógica del controlador de errores de bots.

Al devolver una cadena vacía, se deshabilitará el seguimiento de versiones para el componente en conjunto.

Heredado de Dialog.getVersion

onDialogEvent(DialogContext, DialogEvent)

Se llama cuando se ha generado un evento, mediante DialogContext.emitEvent(), mediante el cuadro de diálogo actual o un diálogo que inició el diálogo actual.

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

Parámetros

dc

DialogContext

Contexto del cuadro de diálogo para el turno actual de conversación.

e

DialogEvent

Evento que se está generando.

Devoluciones

Promise<boolean>

True si el diálogo actual controla el evento y se debe detener la propagación.

Heredado de Dialog.onDialogEvent

repromptDialog(TurnContext, DialogInstance)

Cuando se invalida en una clase derivada, reprote el usuario para la entrada.

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

Parámetros

_context

TurnContext

Objeto de contexto del turno.

_instance

DialogInstance

Información de estado actual para este cuadro de diálogo.

Devoluciones

Promise<void>

Comentarios

Los diálogos derivados que admiten la validación y la lógica de nueva solicitud deben invalidar este método. De forma predeterminada, este método no tiene ningún efecto.

El DialogContext llama a este método cuando el diálogo actual debe volver a solicitar la entrada del usuario. Este método se implementa para los cuadros de diálogo de solicitud.

Consulte también

Heredado de Dialog.repromptDialog

resumeDialog(DialogContext, DialogReason, any)

Se llama cuando un cuadro de diálogo secundario completa su turno, devolviendo el control a este cuadro de diálogo.

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

Parámetros

dc

DialogContext

dialogContext para el turno actual de conversación.

_reason

DialogReason

(xref:botbuilder-dialogs. DialogReason), motivo por el que se reanudó el diálogo.

_result

any

Opcional. Valor devuelto del cuadro de diálogo de al que se llamó. El tipo del valor devuelto depende del cuadro de diálogo secundario.

Devoluciones

Promise<DialogTurnResult>

Un DialogTurnResultPromise que representa la operación asincrónica.

heredado deinputDialog.resumeDialog