Compartir a través de

Office.SpamReportingEventCompletedOptions interface

  • Referencia
Paquete:
outlook

Especifica el comportamiento de un complemento integrado de informes de correo no deseado después de completar el procesamiento de un evento SpamReporting .

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Ejemplos

// The following example handles a SpamReporting event to process a reported spam or phishing message.
function onSpamReport(event) {
    // Gets the Base64-encoded EML format of a reported message.
    Office.context.mailbox.item.getAsFileAsync({ asyncContext: event }, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(`Error encountered during message processing: ${asyncResult.error.message}`);
            return;
        }

        // Run additional processing operations here.

        /**
        * Signals that the spam-reporting event has completed processing.
        * It then moves the reported message to a custom mailbox folder named "Reported Messages"
        * and shows a post-processing dialog to the user.
        * If an error occurs while the message is being processed, the `onErrorDeleteItem`
        * property determines whether the message will be deleted.
        */
        const event = asyncResult.asyncContext;
        event.completed({
            moveItemTo: Office.MailboxEnums.MoveSpamItemTo.CustomFolder,
            folderName: "Reported Messages",
            onErrorDeleteItem: true,
            showPostProcessingDialog: {
                title: "Contoso Spam Reporting",
                description: "Thank you for reporting this message.",
            },
        });
    });
}

Propiedades

folderName

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica la carpeta de buzón de Outlook a la que se moverá el mensaje.
moveItemTo

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica si el mensaje se mueve a una carpeta diferente en el buzón.
onErrorDeleteItem

Cuando se establece en true, elimina un mensaje notificado si se produce un error mientras se procesa el mensaje. Si esta propiedad se establece false en o no se especifica en el método completado, el mensaje notificado permanece en su carpeta de buzón actual.
postProcessingAction

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica si el mensaje se mueve a una carpeta diferente en el buzón. Están disponibles las siguientes acciones posteriores al procesamiento.

  • delete : mueve el mensaje notificado a la carpeta Elementos eliminados del buzón.

  • moveToCustomFolder : mueve el mensaje notificado a una carpeta especificada. Debe especificar el nombre de la carpeta en la folderName propiedad .

  • moveToSpamFolder: mueve el mensaje notificado a la carpeta junk Email del buzón.

  • noMove : deja el mensaje notificado en su carpeta actual.
showPostProcessingDialog

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad indica si se muestra al usuario un cuadro de diálogo posterior al procesamiento. El objeto JSON asignado a esta propiedad debe contener un título y una descripción. Si no se especifica esta propiedad, no se muestra un cuadro de diálogo al usuario una vez que se procesa el mensaje notificado.

Detalles de las propiedades

folderName

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica la carpeta de buzón de Outlook a la que se moverá el mensaje.

folderName?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

  • Si la carpeta especificada no existe todavía, se creará antes de mover el mensaje.

  • Si la postProcessingAction propiedad está establecida en moveToCustomFolder, se debe especificar la folderName propiedad . De lo contrario, el mensaje notificado se mueve a la carpeta junk Email del buzón. Si postProcessingAction se establece en otra acción distinta moveToCustomFolderde , se omite la folderName propiedad .

moveItemTo

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica si el mensaje se mueve a una carpeta diferente en el buzón.

moveItemTo?: MailboxEnums.MoveSpamItemTo;

Valor de propiedad

Office.MailboxEnums.MoveSpamItemTo

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

  • Solo puede usar esta propiedad en un complemento de informes de correo no deseado en Outlook en la Web, en Windows (nuevo y clásico (a partir de la versión 2308, compilación 16724.10000)) y en Mac. Si usa una compilación anterior de Outlook clásico en Windows que admite la característica integrada de informes de correo no deseado, use la postProcessingAction propiedad en su lugar.

  • Si la propiedad está establecida en Office.MailboxEnums.MoveSpamItemTo.CustomFolder, debe especificar el nombre de la carpeta a la que se moverá el mensaje en la folderName propiedad de la event.completed llamada. De lo contrario, la propiedad tendrá como moveItemTo valor predeterminado Office.MailboxEnums.MoveSpamItemTo.JunkFolder y moverá el mensaje notificado a la carpeta junk Email.

onErrorDeleteItem

Cuando se establece en true, elimina un mensaje notificado si se produce un error mientras se procesa el mensaje. Si esta propiedad se establece false en o no se especifica en el método completado, el mensaje notificado permanece en su carpeta de buzón actual.

onErrorDeleteItem?: boolean;

Valor de propiedad

boolean

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

postProcessingAction

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad especifica si el mensaje se mueve a una carpeta diferente en el buzón. Están disponibles las siguientes acciones posteriores al procesamiento.

  • delete : mueve el mensaje notificado a la carpeta Elementos eliminados del buzón.

  • moveToCustomFolder : mueve el mensaje notificado a una carpeta especificada. Debe especificar el nombre de la carpeta en la folderName propiedad .

  • moveToSpamFolder: mueve el mensaje notificado a la carpeta junk Email del buzón.

  • noMove : deja el mensaje notificado en su carpeta actual.

postProcessingAction?: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

  • En Outlook en Windows, solo puede usar esta propiedad en compilaciones anteriores que admitan la característica integrada de informes de correo no deseado. Si está en la versión 2308 (compilación 16724.10000) o posterior, use la moveItemTo propiedad en su lugar.

  • Esta propiedad no se admite en Outlook en la Web, en Mac o en el nuevo Outlook en Windows. Use la moveItemTo propiedad en su lugar.

  • Si la propiedad está establecida en moveToCustomFolder, debe especificar el nombre de la carpeta a la que se moverá el mensaje en la folderName propiedad de la event.completed llamada. De lo contrario, la propiedad tendrá como postProcessingAction valor predeterminado moveToSpamFolder y moverá el mensaje notificado a la carpeta junk Email.

Ejemplos

// The following example handles a SpamReporting event to process a reported spam or phishing message.
function onSpamReport(event) {
    // Gets the Base64-encoded EML format of a reported message.
    Office.context.mailbox.item.getAsFileAsync({ asyncContext: event }, (asyncResult) => {
        if (asyncResult.status === Office.AsyncResultStatus.Failed) {
            console.log(`Error encountered during message processing: ${asyncResult.error.message}`);
            return;
        }

        // Run additional processing operations here.

        /**
        * Signals that the spam-reporting event has completed processing.
        * It then moves the reported message to the Junk Email folder of the mailbox and shows a
        * post-processing dialog to the user.
        */
        const event = asyncResult.asyncContext;
        event.completed({
            postProcessingAction: "moveToSpamFolder",
            showPostProcessingDialog: {
                title: "Contoso Spam Reporting",
                description: "Thank you for reporting this message.",
            },
        });
    });
}

showPostProcessingDialog

Cuando se usa el método completado para indicar que un mensaje notificado ha terminado de procesarse, esta propiedad indica si se muestra al usuario un cuadro de diálogo posterior al procesamiento. El objeto JSON asignado a esta propiedad debe contener un título y una descripción. Si no se especifica esta propiedad, no se muestra un cuadro de diálogo al usuario una vez que se procesa el mensaje notificado.

showPostProcessingDialog?: object;

Valor de propiedad

object

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso (Outlook):elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes