Office.SpamReportingEventCompletedOptions interface

  • Referencia
Paquete:
outlook

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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 (a partir de la versión 2308 (compilación 16724.10000)), en Mac y en la nueva Outlook en Windows (versión preliminar). Si usa una compilación anterior en Outlook 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

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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

Modo de Outlook aplicable: Lectura de mensajes

postProcessingAction

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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 (versión preliminar). 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

Nota

Esta API se ofrece a los desarrolladores como versión preliminar y puede cambiar en función de los comentarios que recibamos. No utilice esta API en un entorno de producción.

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: versión preliminar del buzón ]

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

Modo de Outlook aplicable: Lectura de mensajes

Importante: En Outlook en la Web o en el nuevo Outlook en Windows (versión preliminar), no se muestra un cuadro de diálogo posterior al procesamiento una vez que el complemento completa el procesamiento de un mensaje notificado. Esto se aplica incluso si showPostProcessingDialog está configurado. Sin embargo, en función de cómo haya configurado la moveItemTo propiedad en la event.completed llamada, se muestra una notificación para indicar cuándo se elimina o mueve el mensaje notificado a otra carpeta del buzón. Para obtener más información, consulte la sección "Revisar el comportamiento y las limitaciones de las características" de Implementación de un complemento integrado de informes de correo no deseado (versión preliminar).