Office.SmartAlertsEventCompletedOptions interface

Paquete:

outlook

Especifica el comportamiento de un complemento alertas inteligentes cuando finaliza el procesamiento de un OnMessageSend evento o OnAppointmentSend .

Comentarios

[ Conjunto de API: Buzón 1.12 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

Ejemplos

// The following example checks whether a location is specified in an appointment before it's sent.
function onAppointmentSendHandler(event) {
    Office.context.mailbox.item.location.getAsync({ asyncContext: event }, asyncResult => {
        const event = asyncResult.asyncContext;
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(asyncResult.error.message);
            // If the add-in is unable to retrieve the appointment's location, the appointment isn't sent.
            event.completed({ allowEvent: false, errorMessage: "Failed to get the appointment's location." });
            return;
        }

        if (asyncResult.value === "") {
            // If no location is specified, the appointment isn't sent and the user is alerted to include a location.
            event.completed(
                {
                    allowEvent: false,
                    cancelLabel: "Add a location",
                    commandId: "msgComposeOpenPaneButton",
                    contextData: JSON.stringify({ a: "aValue", b: "bValue" }),
                    errorMessage: "Don't forget to add a meeting location.",
                    errorMessageMarkdown: `
                        Don't forget to add a meeting location.\n\n
                        **Tip**: For a list of locations,
                        see [Meeting Locations]("https://www.contoso.com/meeting-locations).`,
                    sendModeOverride: Office.MailboxEnums.SendModeOverride.PromptUser
                }
            );
        } else {
            // If a location is specified, the appointment is sent.
            event.completed({ allowEvent: true });
        }
    });
}

Propiedades

allowEvent	Cuando se usa el método completado para indicar la finalización de un controlador de eventos, este valor indica si el evento controlado debe continuar la ejecución o cancelarse. Por ejemplo, un complemento que controla el OnMessageSend evento o OnAppointmentSend puede establecerse allowEventfalse en para cancelar el envío de un elemento. Para obtener un ejemplo completo, consulte el tutorial alertas inteligentes.
cancelLabel	Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad personaliza el texto del botón No enviar en el cuadro de diálogo Alertas inteligentes. El texto personalizado debe tener 20 caracteres o menos. Para obtener un ejemplo, consulte el tutorial alertas inteligentes.
commandId	Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad especifica el identificador del panel de tareas o la función que se ejecuta cuando el botón No enviar está seleccionado en el cuadro de diálogo Alertas inteligentes. Para obtener un ejemplo, consulte el tutorial alertas inteligentes.
contextData	Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad especifica los datos JSON pasados al complemento para su procesamiento cuando el botón No enviar está seleccionado en el cuadro de diálogo Alertas inteligentes.
errorMessage	Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad establece el mensaje de error que se mostrará al usuario. Para obtener un ejemplo, consulte el tutorial alertas inteligentes.
sendModeOverride	Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad invalida la opción de modo de envío especificada en el manifiesto en tiempo de ejecución. Para obtener un ejemplo, consulte el tutorial alertas inteligentes.

Detalles de las propiedades

allowEvent

Cuando se usa el método completado para indicar la finalización de un controlador de eventos, este valor indica si el evento controlado debe continuar la ejecución o cancelarse. Por ejemplo, un complemento que controla el OnMessageSend evento o OnAppointmentSend puede establecerse allowEventfalse en para cancelar el envío de un elemento. Para obtener un ejemplo completo, consulte el tutorial alertas inteligentes.

allowEvent?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: Buzón 1.12 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

cancelLabel

Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad personaliza el texto del botón No enviar en el cuadro de diálogo Alertas inteligentes. El texto personalizado debe tener 20 caracteres o menos.

Para obtener un ejemplo, consulte el tutorial alertas inteligentes.

cancelLabel?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

commandId

Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad especifica el identificador del panel de tareas o la función que se ejecuta cuando el botón No enviar está seleccionado en el cuadro de diálogo Alertas inteligentes.

Para obtener un ejemplo, consulte el tutorial alertas inteligentes.

commandId?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

Importante:

El commandId valor debe coincidir con el panel de tareas o el identificador de función especificado en el manifiesto del complemento. El marcado depende del tipo de manifiesto que use el complemento.

• Manifiesto de solo complemento: id atributo del elemento Control que representa el panel de tareas o la función.

• Manifiesto unificado para Microsoft 365: la propiedad "id" del panel de tareas o el comando de función de la matriz "controls".

Si especifica la opción en event.completed la contextData llamada, también debe asignar un panel de tareas o un identificador de función a la commandId opción. De lo contrario, se omiten los datos JSON asignados a contextData .

contextData

Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad especifica los datos JSON pasados al complemento para su procesamiento cuando el botón No enviar está seleccionado en el cuadro de diálogo Alertas inteligentes.

contextData?: any;

Valor de propiedad

any

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

Importante:

• En Outlook en Windows, el tipo se admite a partir de la any versión 2402 (compilación 17308.20000). En versiones anteriores de Outlook en Windows, solo se admite el string tipo .

• Si especifica la opción en event.completed la contextData llamada, también debe asignar un identificador de panel de tareas a la commandId opción. De lo contrario, se omiten los datos JSON asignados a contextData .

• Para recuperar el valor de la contextData propiedad, debe llamar a Office.context.mailbox.item.getInitializationContextAsync en la implementación de JavaScript del panel de tareas. Si crea una cadena JSON mediante JSON.stringify() y la asigna a la contextData propiedad , debe analizar la cadena mediante JSON.parse() una vez que la recupere.

errorMessage

Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad establece el mensaje de error que se mostrará al usuario. Para obtener un ejemplo, consulte el tutorial alertas inteligentes.

errorMessage?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.12 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

sendModeOverride

Cuando se usa el método completado para indicar la finalización de un controlador de eventos y establecer su allowEvent propiedad falseen , esta propiedad invalida la opción de modo de envío especificada en el manifiesto en tiempo de ejecución.

Para obtener un ejemplo, consulte el tutorial alertas inteligentes.

sendModeOverride?: MailboxEnums.SendModeOverride | string;

Valor de propiedad

Office.MailboxEnums.SendModeOverride | string

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):restringido

Modo de Outlook aplicable: Compose

Importante: Actualmente, sendModeOverride solo se puede establecer en la opción preguntar al usuario .