Compartir a través de

Obtener los datos adjuntos de un elemento de Outlook de Exchange

  • Artículo

La API de JavaScript de Office incluye API para obtener datos adjuntos y su contenido de mensajes y citas en Outlook. En la tabla siguiente se enumeran estas API de datos adjuntos, los modos de Outlook en los que operan y el conjunto mínimo de requisitos de buzón que necesitan para funcionar.

API Modos de Outlook admitidos Conjunto de requisitos mínimos
Office.context.mailbox.item.attachments Lectura 1.1
Office.context.mailbox.item.getAttachmentsAsync Redacción 1.8
Office.context.mailbox.item.getAttachmentContentAsync Leer
Redacción		 1.8

Si el cliente de Outlook en el que se ejecuta el complemento no admite el conjunto de requisitos mínimos necesario, puede obtener los datos adjuntos y su contenido directamente desde Exchange. Seleccione la pestaña para el entorno de Exchange aplicable.

En Exchange Online entornos, el complemento debe realizar los pasos siguientes para obtener datos adjuntos directamente desde Exchange.

  1. Obtenga un token de acceso a Microsoft Graph.
  2. Obtenga el identificador de elemento del mensaje o cita aplicable.
  3. Use Microsoft Graph para obtener los datos adjuntos y sus propiedades.

Cada paso se describe en las secciones siguientes.

Obtener un token de acceso

Microsoft Graph proporciona acceso a los datos de correo de Outlook de los usuarios. Antes de que el complemento pueda obtener datos de Microsoft Graph, primero debe obtener un token de acceso para la autorización. Para obtener un token de acceso, use la autenticación de aplicaciones anidadas (NAA). Para obtener más información sobre NAA, consulte Habilitación del inicio de sesión único en un complemento de Office mediante la autenticación de aplicaciones anidadas (versión preliminar).

Obtener el identificador de elemento del elemento de correo

Para obtener información sobre los datos adjuntos mediante Microsoft Graph, necesita el identificador de elemento del mensaje o cita que incluye los datos adjuntos. Use la API de JavaScript de Office aplicable para obtener el identificador de elemento.

  • Modo de lectura: llame a Office.context.mailbox.item.itemId. En clientes de Outlook que no son móviles, dado que esta propiedad devuelve un identificador con formato para Exchange Web Services (EWS), debe usar el método Office.context.mailbox.convertToRestId para convertir el identificador en un formato REST que Microsoft Graph puede usar.

    // Get the item ID of the current mail item in read mode and convert it into a REST format.
const itemId = Office.context.mailbox.item.itemId;
const restId = Office.context.mailbox.convertToRestId(itemId, Office.MailboxEnums.RestVersion.v2_0);

  • modo Compose: el método para obtener el identificador de elemento varía en función de si el elemento de correo se ha guardado como borrador.

    • Si el elemento se ha guardado, llame a Office.context.mailbox.item.getItemIdAsync.

      // Get the item ID of the current mail item being composed.
Office.context.mailbox.item.getItemIdAsync((result) => {
    if (result.status === Office.AsyncResultStatus.Failed) {
        console.error(result.error.message);
        return;
    }

    const itemId = result.value;
});

      Sugerencia

      El getItemIdAsync método se introdujo en el conjunto de requisitos de buzón 1.8. Si el cliente de Outlook en el que se ejecuta el complemento no admite el buzón 1.8, use Office.context.mailbox.item.saveAsync en su lugar como este método se introdujo en el buzón 1.3.

    • Si el elemento aún no se ha guardado, llame a Office.context.mailbox.item.saveAsync para iniciar el guardado y obtener el identificador de elemento.

      // Save the current mail item being composed to get its ID.
Office.context.mailbox.item.saveAsync((result) => {
    if (result.status === Office.AsyncResultStatus.Failed) {
        console.error(result.error.message);
        return;
    }

    const itemId = result.value;
});

      Nota:

      Si el cliente de Outlook está en modo almacenado en caché, el elemento guardado puede tardar algún tiempo en sincronizarse con el servidor. Hasta que se sincronice el elemento, el uso del identificador de elemento devolverá un error.

Usar Microsoft Graph

Una vez que haya obtenido un token de acceso y el identificador de elemento del elemento de correo que contiene los datos adjuntos, ahora puede realizar una solicitud de Microsoft Graph. Para obtener información y ejemplos sobre cómo obtener datos adjuntos mediante Microsoft Graph, consulte Obtención de datos adjuntos.

Vea también