Office.LoadedMessageRead interface

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.

Representa un mensaje en modo de lectura que está cargado actualmente. Se devuelve un LoadedMessageRead objeto cuando Office.context.mailbox.loadItemByIdAsync se llama a en un mensaje en modo de lectura.

Comentarios

[ Conjunto de API: versión preliminar del buzón ]

Nivel mínimo de permiso: elemento de lectura y escritura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Al implementar la característica de selección múltiple de elementos, determine si ya puede acceder a las propiedades necesarias del elemento seleccionado a través de la Office.context.mailbox.getSelectedItemsAsync llamada. Si puede, no es necesario llamar loadItemByIdAsynca .

• Solo se puede cargar un elemento de correo a la vez. Al implementar loadItemByIdAsync, debe llamar a unloadAsync después de procesar el elemento. Esto debe hacerse antes de llamar a loadItemByIdAsync en otro elemento.

Propiedades

attachments	Obtiene los datos adjuntos del elemento como una matriz.
body	Obtiene el cuerpo del elemento y su formato.
categories	Obtiene un objeto que proporciona métodos para administrar las categorías del elemento.
cc	Obtiene los destinatarios de la línea Cc (copia de carbono) de un mensaje. La cc propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada destinatario que aparece en la línea Cc del mensaje. El número máximo de destinatarios devueltos varía según el cliente de Outlook. Windows clásico: 500 destinatarios Explorador web, nueva Outlook: 20 destinatarios (vista contraída), 500 destinatarios (vista expandida)
conversationId	Obtiene un identificador de la conversación de correo electrónico que contiene un mensaje determinado. Puede obtener un entero para esta propiedad si la aplicación de correo se activa en respuestas o formularios de lectura o en formularios de redacción. Si, después, el usuario cambia el asunto del mensaje de respuesta, al enviar dicha respuesta, el Id. de conversación de ese mensaje cambiará y el valor que se obtuvo anteriormente ya no será de aplicación.
dateTimeCreated	Obtiene la fecha y hora de creación de un elemento.
dateTimeModified	Obtiene la fecha y hora en que se modificó por última vez un elemento.
end	Obtiene la fecha y hora de finalización de la cita. La end propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor de propiedad end en la fecha y hora locales del cliente. Si usa el método Time.setAsync para establecer la hora de finalización, use el método convertToUtcClientTime para convertir la hora local del cliente en un valor UTC para el servidor.
from	Obtiene la dirección de correo electrónico del remitente de un mensaje. La from propiedad devuelve un EmailAddressDetails objeto .
internetMessageId	Obtiene el identificador de mensaje de Internet de un mensaje.
itemClass	Obtiene la clase de elemento servicios web de Exchange del mensaje seleccionado.
itemId	Obtiene el identificador de elemento de Exchange Web Services para el elemento actual.
itemType	Obtiene el tipo de elemento que representa una instancia. La itemType propiedad devuelve uno de los ItemType valores de enumeración, que indica si la instancia del objeto item es un mensaje o una cita.
location	Obtiene la ubicación de una convocatoria de reunión. La propiedad location devuelve una cadena que contiene la ubicación de la cita.
normalizedSubject	Obtiene el asunto de un elemento, con todos los prefijos quitados (incluidos RE: y FWD:). La normalizedSubject propiedad obtiene el asunto del elemento, con los prefijos estándar (como RE: y FW:) que se agregan mediante los programas de correo electrónico. Para obtener el asunto del elemento con los prefijos intactos, use la propiedad subject.
notificationMessages	Obtiene los mensajes de notificación del elemento.
recurrence	Obtiene el patrón de periodicidad de una cita. Obtiene el patrón de periodicidad de una convocatoria de reunión. Modos de lectura y redacción para elementos de cita. Modo de lectura para elementos de convocatoria de reunión. La recurrence propiedad devuelve un Recurrence objeto para citas periódicas o convocatorias de reuniones si un elemento es una serie o una instancia de una serie. null se devuelve para citas únicas y convocatorias de reunión de citas únicas. undefined se devuelve para los mensajes que no son convocatorias de reunión.
sender	Obtiene la dirección de correo electrónico del remitente de un mensaje de correo electrónico.
seriesId	Obtiene el identificador de la serie a la que pertenece una instancia. En Outlook en la Web y en Windows (nuevo y clásico), seriesId devuelve el identificador de Exchange Web Services (EWS) del elemento primario (serie) al que pertenece este elemento.
start	Obtiene la fecha y hora en que se va a comenzar la cita. La start propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor en la fecha y hora locales del cliente.
subject	Obtiene la descripción que aparece en el campo asunto de un elemento. La subject propiedad obtiene todo el asunto del elemento, tal como lo envía el servidor de correo electrónico. La propiedad subject devuelve una cadena. Use la normalizedSubject propiedad para obtener el asunto menos los prefijos iniciales, como RE: y FW:.
to	Obtiene los destinatarios de la línea Para de un mensaje. Proporciona acceso a los destinatarios en la línea Para de un mensaje. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual. La to propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada destinatario que aparece en la línea To del mensaje. El número máximo de destinatarios devueltos varía según el cliente de Outlook. Windows clásico: 500 destinatarios Explorador web, nueva Outlook: 20 destinatarios (vista contraída), 500 destinatarios (vista expandida)

Métodos

displayReplyAllFormAsync(formData, options, callback)	Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.
displayReplyAllFormAsync(formData, callback)	Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.
displayReplyFormAsync(formData, options, callback)	Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.
displayReplyFormAsync(formData, callback)	Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.
getAllInternetHeadersAsync(options, callback)	Obtiene todos los encabezados de Internet del mensaje como una cadena. Para obtener más información, vea Obtener y establecer encabezados de Internet en un mensaje en un complemento de Outlook.
getAllInternetHeadersAsync(callback)	Obtiene todos los encabezados de Internet del mensaje como una cadena. Para obtener más información, vea Obtener y establecer encabezados de Internet en un mensaje en un complemento de Outlook.
getAsFileAsync(options, callback)	Obtiene el mensaje actual en formato EML codificado en Base64.
getAsFileAsync(callback)	Obtiene el mensaje actual en formato EML codificado en Base64.
getAttachmentContentAsync(attachmentId, options, callback)	Obtiene datos adjuntos de un mensaje o cita y lo devuelve como un AttachmentContent objeto. El getAttachmentContentAsync método obtiene los datos adjuntos con el identificador especificado del elemento. Como procedimiento recomendado, debe obtener el identificador de los datos adjuntos de una llamada item.attachments y, a continuación, en la misma sesión, usar ese identificador para recuperar los datos adjuntos. En Outlook en la Web y nueva Outlook en Windows, el identificador de datos adjuntos solo es válido dentro de la misma sesión. Una sesión termina cuando el usuario cierra la aplicación, o si el usuario comienza a redactar un formulario insertado, a continuación, extrae el formulario para continuar en una ventana independiente.
getAttachmentContentAsync(attachmentId, callback)	Obtiene datos adjuntos de un mensaje o cita y lo devuelve como un AttachmentContent objeto. El getAttachmentContentAsync método obtiene los datos adjuntos con el identificador especificado del elemento. Como procedimiento recomendado, debe obtener el identificador de los datos adjuntos de una llamada item.attachments y, a continuación, en la misma sesión, usar ese identificador para recuperar los datos adjuntos. En Outlook en la Web y nueva Outlook en Windows, el identificador de datos adjuntos solo es válido dentro de la misma sesión. Una sesión termina cuando el usuario cierra la aplicación, o si el usuario comienza a redactar un formulario insertado, a continuación, extrae el formulario para continuar en una ventana independiente.
getInitializationContextAsync(options, callback)	Obtiene los datos de inicialización pasados cuando un mensaje accionable activa el complemento.
getInitializationContextAsync(callback)	Obtiene los datos de inicialización pasados cuando un mensaje accionable activa el complemento.
getRegExMatches()	Devuelve los valores de cadena del elemento seleccionado que coinciden con las expresiones regulares definidas en un archivo de manifiesto XML.
getRegExMatchesByName(name)	Devuelve valores de cadena en el elemento seleccionado que coinciden con la expresión regular con nombre definida en un archivo de manifiesto XML.
getSelectedRegExMatches()	Devuelve valores de cadena en una coincidencia resaltada que coinciden con las expresiones regulares definidas en un archivo de manifiesto XML. Las coincidencias resaltadas se aplican a complementos contextuales.
getSharedPropertiesAsync(options, callback)	Obtiene las propiedades de una cita o mensaje en una carpeta compartida o un buzón compartido. Para obtener más información sobre el uso de esta API, vea Habilitar carpetas compartidas y escenarios de buzón compartido en un complemento de Outlook.
getSharedPropertiesAsync(callback)	Obtiene las propiedades de una cita o mensaje en una carpeta compartida o un buzón compartido. Para obtener más información sobre el uso de esta API, vea Habilitar carpetas compartidas y escenarios de buzón compartido en un complemento de Outlook.
loadCustomPropertiesAsync(callback, userContext)	Carga de forma asincrónica las propiedades personalizadas de este complemento en el elemento seleccionado. Las propiedades personalizadas se almacenan como pares clave-valor por aplicación y por elemento. Este método devuelve un objeto CustomProperties en la devolución de llamada, que proporciona métodos para acceder a las propiedades personalizadas específicas del elemento actual y del complemento actual. Las propiedades personalizadas no se cifran en el elemento, por lo que no se debe usar como almacenamiento seguro. Las propiedades personalizadas se proporcionan como un objeto CustomProperties en la propiedad asyncResult.value. Este objeto se puede usar para obtener propiedades personalizadas del elemento de correo.
unloadAsync(options, callback)	Cuando se seleccionan varios elementos de correo, cierra el elemento cargado actualmente para que se pueda cargar otro elemento de correo seleccionado para su procesamiento.
unloadAsync(callback)	Cuando se seleccionan varios elementos de correo, cierra el elemento cargado actualmente para que se pueda cargar otro elemento de correo seleccionado para su procesamiento.

Detalles de las propiedades

attachments

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.

Obtiene los datos adjuntos del elemento como una matriz.

attachments: AttachmentDetails[];

Valor de propiedad

Office.AttachmentDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Nota: Outlook bloquea determinados tipos de archivos debido a posibles problemas de seguridad y, por lo tanto, no se devuelven. Para obtener más información, vea Archivos adjuntos bloqueados en Outlook.

body

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.

Obtiene el cuerpo del elemento y su formato.

body: Body;

Valor de propiedad

Office.Body

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante: solo se admiten los getAsync métodos y getTypeAsync del objeto Body.

categories

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.

Obtiene un objeto que proporciona métodos para administrar las categorías del elemento.

categories: Categories;

Valor de propiedad

Office.Categories

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

cc

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.

Obtiene los destinatarios de la línea Cc (copia de carbono) de un mensaje.

La cc propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada destinatario que aparece en la línea Cc del mensaje. El número máximo de destinatarios devueltos varía según el cliente de Outlook.

• Windows clásico: 500 destinatarios

• Explorador web, nueva Outlook: 20 destinatarios (vista contraída), 500 destinatarios (vista expandida)

cc: EmailAddressDetails[];

Valor de propiedad

Office.EmailAddressDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

conversationId

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.

Obtiene un identificador de la conversación de correo electrónico que contiene un mensaje determinado.

Puede obtener un entero para esta propiedad si la aplicación de correo se activa en respuestas o formularios de lectura o en formularios de redacción. Si, después, el usuario cambia el asunto del mensaje de respuesta, al enviar dicha respuesta, el Id. de conversación de ese mensaje cambiará y el valor que se obtuvo anteriormente ya no será de aplicación.

conversationId: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

dateTimeCreated

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.

Obtiene la fecha y hora de creación de un elemento.

dateTimeCreated: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

dateTimeModified

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.

Obtiene la fecha y hora en que se modificó por última vez un elemento.

dateTimeModified: Date;

Valor de propiedad

Date

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante: Esta propiedad no se admite en Outlook en Android o en iOS. Para obtener más información sobre las API admitidas en Outlook mobile, vea API de JavaScript de Outlook compatibles con Outlook en dispositivos móviles.

end

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.

Obtiene la fecha y hora de finalización de la cita.

La end propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor de propiedad end en la fecha y hora locales del cliente.

Si usa el método Time.setAsync para establecer la hora de finalización, use el método convertToUtcClientTime para convertir la hora local del cliente en un valor UTC para el servidor.

end: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

from

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.

Obtiene la dirección de correo electrónico del remitente de un mensaje.

La from propiedad devuelve un EmailAddressDetails objeto .

from: EmailAddressDetails;

Valor de propiedad

Office.EmailAddressDetails

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Las propiedades from y sender representan a la misma persona, a menos que un delegado envíe el mensaje. En ese caso, la from propiedad representa al delegado y la sender propiedad representa al delegado.

• La recipientType propiedad del EmailAddressDetails objeto de la from propiedad no está definida.

internetMessageId

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.

Obtiene el identificador de mensaje de Internet de un mensaje.

internetMessageId: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante: En la carpeta Elementos enviados , internetMessageId es posible que todavía no esté disponible en los elementos enviados recientemente. En ese caso, considere la posibilidad de usar servicios web de Exchange para obtener esta propiedad del servidor.

itemClass

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.

Obtiene la clase de elemento servicios web de Exchange del mensaje seleccionado.

itemClass: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

En la tabla siguiente se enumeran las clases de elementos predeterminadas para los mensajes.

Clase Item	Descripción
IPM.Note	Nuevos mensajes y respuestas de mensajes
IPM. Note.SMIME	Mensajes cifrados que también se pueden firmar
IPM. Note.SMIME.MultipartSigned	Mensajes con firma clara
IPM.Schedule.Meeting.Request	Convocatorias de reunión
IPM.Schedule.Meeting.Canceled	Cancelaciones de reunión
IPM.Schedule.Meeting.Resp.Neg	Respuesta negativa a una convocatoria de reunión.
IPM.Schedule.Meeting.Resp.Pos	Respuesta afirmativa a una convocatoria de reunión.
IPM. Schedule.Meeting.Resp.Tent	Respuesta provisional a una convocatoria de reunión.

Puede crear clases personalizadas que amplíen una clase de elemento predeterminada. Por ejemplo, IPM.Note.Contoso.

itemId

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.

Obtiene el identificador de elemento de Exchange Web Services para el elemento actual.

itemId: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• La itemId propiedad no está disponible en modo de redacción. Si se requiere un identificador de elemento, el método Office.context.mailbox.item.saveAsync puede usarse para guardar el elemento en el servidor, que devolverá el identificador de elemento en el parámetro asyncResult.value de la función de devolución de llamada. Si el elemento ya está guardado, puede llamar al Office.context.mailbox.item.getItemIdAsync método en su lugar.

• El identificador devuelto por la itemId propiedad es el mismo que el identificador de elemento de Exchange Web Services. La itemId propiedad no es idéntica al identificador de entrada de Outlook o al identificador que usa la API REST de Outlook. Antes de realizar llamadas a la API REST con este valor, debe convertirse mediante Office.context.mailbox.convertToRestId.

itemType

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.

Obtiene el tipo de elemento que representa una instancia.

La itemType propiedad devuelve uno de los ItemType valores de enumeración, que indica si la instancia del objeto item es un mensaje o una cita.

itemType: MailboxEnums.ItemType | string;

Valor de propiedad

Office.MailboxEnums.ItemType | string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

location

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.

Obtiene la ubicación de una convocatoria de reunión.

La propiedad location devuelve una cadena que contiene la ubicación de la cita.

location: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

normalizedSubject

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.

Obtiene el asunto de un elemento, con todos los prefijos quitados (incluidos RE: y FWD:).

La normalizedSubject propiedad obtiene el asunto del elemento, con los prefijos estándar (como RE: y FW:) que se agregan mediante los programas de correo electrónico. Para obtener el asunto del elemento con los prefijos intactos, use la propiedad subject.

normalizedSubject: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

notificationMessages

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.

Obtiene los mensajes de notificación del elemento.

notificationMessages: NotificationMessages;

Valor de propiedad

Office.NotificationMessages

Comentarios

[ Conjunto de API: Buzón 1.3 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Solo se admite el getAllAsync método del objeto NotificationMessages.

recurrence

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.

Obtiene el patrón de periodicidad de una cita. Obtiene el patrón de periodicidad de una convocatoria de reunión. Modos de lectura y redacción para elementos de cita. Modo de lectura para elementos de convocatoria de reunión.

La recurrence propiedad devuelve un Recurrence objeto para citas periódicas o convocatorias de reuniones si un elemento es una serie o una instancia de una serie. null se devuelve para citas únicas y convocatorias de reunión de citas únicas. undefined se devuelve para los mensajes que no son convocatorias de reunión.

recurrence: Recurrence;

Valor de propiedad

Office.Recurrence

Comentarios

[ Conjunto de API: Buzón 1.7 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Las convocatorias de reunión tienen un valor itemClass de IPM.Schedule.Meeting.Request.

• Si el recurrence objeto es null, esto indica que el objeto es una sola cita o una convocatoria de reunión de una sola cita y no una parte de una serie.

• Solo se admiten los propeties y el getAsync método del objeto Recurrence.

sender

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.

Obtiene la dirección de correo electrónico del remitente de un mensaje de correo electrónico.

sender: EmailAddressDetails;

Valor de propiedad

Office.EmailAddressDetails

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Las propiedades from y sender representan a la misma persona, a menos que un delegado envíe el mensaje. En ese caso, la from propiedad representa al delegado y la sender propiedad representa al delegado.

• La recipientType propiedad del EmailAddressDetails objeto de la sender propiedad no está definida.

seriesId

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.

Obtiene el identificador de la serie a la que pertenece una instancia.

En Outlook en la Web y en Windows (nuevo y clásico), seriesId devuelve el identificador de Exchange Web Services (EWS) del elemento primario (serie) al que pertenece este elemento.

seriesId: string;

Valor de propiedad

string

Comentarios

[ Conjunto de API: Buzón 1.7 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• El identificador que devuelve la propiedad seriesId es el mismo que el identificador de elemento de servicios Web Exchange. La seriesId propiedad no es idéntica a los identificadores de Outlook usados por la API REST de Outlook. Antes de realizar llamadas a la API REST con este valor, debe convertirse mediante Office.context.mailbox.convertToRestId. Para obtener más información, consulte Uso de las API REST de Outlook desde un complemento de Outlook.

• La seriesId propiedad devuelve null para los elementos que no tienen elementos primarios, como citas únicas, elementos de serie o convocatorias de reunión, y devuelve undefined para cualquier otro elemento que no sea convocatoria de reunión.

start

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.

Obtiene la fecha y hora en que se va a comenzar la cita.

La start propiedad es un Date objeto expresado como un valor de fecha y hora de hora universal coordinada (UTC). Puede usar el convertToLocalClientTime método para convertir el valor en la fecha y hora locales del cliente.

start: Date;

Valor de propiedad

Date

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

subject

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.

Obtiene la descripción que aparece en el campo asunto de un elemento.

La subject propiedad obtiene todo el asunto del elemento, tal como lo envía el servidor de correo electrónico.

La propiedad subject devuelve una cadena. Use la normalizedSubject propiedad para obtener el asunto menos los prefijos iniciales, como RE: y FW:.

subject: string;

Valor de propiedad

string

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

to

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.

Obtiene los destinatarios de la línea Para de un mensaje. Proporciona acceso a los destinatarios en la línea Para de un mensaje. El tipo de objeto y el nivel de acceso dependen del modo del elemento actual.

La to propiedad devuelve una matriz que contiene un objeto EmailAddressDetails para cada destinatario que aparece en la línea To del mensaje. El número máximo de destinatarios devueltos varía según el cliente de Outlook.

• Windows clásico: 500 destinatarios

• Explorador web, nueva Outlook: 20 destinatarios (vista contraída), 500 destinatarios (vista expandida)

to: EmailAddressDetails[];

Valor de propiedad

Office.EmailAddressDetails[]

Comentarios

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Detalles del método

displayReplyAllFormAsync(formData, options, callback)

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.

Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.

displayReplyAllFormAsync(formData: string | ReplyFormData, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

formData

string | Office.ReplyFormData

Una cadena que contiene texto y HTML y que representa el cuerpo del formulario de respuestas. La cadena está limitada a 32 KB o a un objeto ReplyFormData que contiene datos de cuerpo o datos adjuntos y una función de devolución de llamada.

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.9 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• En Outlook en la Web y nueva Outlook en Windows, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o 1 columna.

• Si cualquiera de los parámetros de cadena supera sus límites, displayReplyAllFormAsync produce una excepción.

• Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.

displayReplyAllFormAsync(formData, callback)

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.

Muestra un formulario de respuesta que incluye el remitente y todos los destinatarios del mensaje seleccionado o el organizador y todos los asistentes de la cita seleccionada.

displayReplyAllFormAsync(formData: string | ReplyFormData, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

formData

string | Office.ReplyFormData

Una cadena que contiene texto y HTML y que representa el cuerpo del formulario de respuestas. La cadena está limitada a 32 KB o a un objeto ReplyFormData que contiene datos de cuerpo o datos adjuntos y una función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.9 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• En Outlook en la Web y nueva Outlook en Windows, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o 1 columna.

• Si cualquiera de los parámetros de cadena supera sus límites, displayReplyAllFormAsync produce una excepción.

• Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.

displayReplyFormAsync(formData, options, callback)

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.

Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.

displayReplyFormAsync(formData: string | ReplyFormData, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

formData

string | Office.ReplyFormData

Una cadena que contiene texto y HTML y que representa el cuerpo del formulario de respuestas. La cadena está limitada a 32 KB o a un objeto ReplyFormData que contiene datos de cuerpo o datos adjuntos y una función de devolución de llamada.

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.9 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• En Outlook en la Web y nueva Outlook en Windows, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o 1 columna.

• Si cualquiera de los parámetros de cadena supera sus límites, displayReplyFormAsync produce una excepción.

• Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.

displayReplyFormAsync(formData, callback)

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.

Muestra un formulario de respuesta que incluye solo el remitente del mensaje seleccionado o el organizador de la cita seleccionada.

displayReplyFormAsync(formData: string | ReplyFormData, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

formData

string | Office.ReplyFormData

Una cadena que contiene texto y HTML y que representa el cuerpo del formulario de respuestas. La cadena está limitada a 32 KB o a un objeto ReplyFormData que contiene datos de cuerpo o datos adjuntos y una función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.9 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• En Outlook en la Web y nueva Outlook en Windows, el formulario de respuesta se muestra como un formulario emergente en la vista de 3 columnas y un formulario emergente en la vista de 2 columnas o 1 columna.

• Si cualquiera de los parámetros de cadena supera sus límites, displayReplyFormAsync produce una excepción.

• Cuando se especifican datos adjuntos en el formData.attachments parámetro , Outlook intenta descargar todos los datos adjuntos y adjuntarlos al formulario de respuesta. Si se produce un error al agregar los datos adjuntos, se muestra un error en la interfaz de usuario del formulario. Si esto no es posible, no se produce ningún mensaje de error.

getAllInternetHeadersAsync(options, callback)

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.

Obtiene todos los encabezados de Internet del mensaje como una cadena.

Para obtener más información, vea Obtener y establecer encabezados de Internet en un mensaje en un complemento de Outlook.

getAllInternetHeadersAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<string>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . Si se ejecuta correctamente, los datos de encabezados de Internet se proporcionan en la asyncResult.value propiedad como una cadena. Consulte RFC 2183 para obtener la información de formato del valor de cadena devuelto. Si se produce un error en la llamada, la asyncResult.error propiedad contendrá un código de error con el motivo del error.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getAllInternetHeadersAsync(callback)

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.

Obtiene todos los encabezados de Internet del mensaje como una cadena.

Para obtener más información, vea Obtener y establecer encabezados de Internet en un mensaje en un complemento de Outlook.

getAllInternetHeadersAsync(callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<string>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . Si se ejecuta correctamente, los datos de encabezados de Internet se proporcionan en la asyncResult.value propiedad como una cadena. Consulte RFC 2183 para obtener la información de formato del valor de cadena devuelto. Si se produce un error en la llamada, la asyncResult.error propiedad contendrá un código de error con el motivo del error.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getAsFileAsync(options, callback)

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.

Obtiene el mensaje actual en formato EML codificado en Base64.

getAsFileAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<string>) => void

Cuando se completa el método, se llama a la función pasada en el parámetro de devolución de llamada con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . El formato EML codificado en Base64 del mensaje se devuelve en la asyncResult.value propiedad . Los errores detectados se devuelven en la asyncResult.error propiedad .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getAsFileAsync(callback)

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.

Obtiene el mensaje actual en formato EML codificado en Base64.

getAsFileAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<string>) => void

Cuando se completa el método, se llama a la función pasada en el parámetro de devolución de llamada con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . El formato EML codificado en Base64 del mensaje se devuelve en la asyncResult.value propiedad . Los errores detectados se devuelven en la asyncResult.error propiedad .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.14 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getAttachmentContentAsync(attachmentId, options, callback)

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.

Obtiene datos adjuntos de un mensaje o cita y lo devuelve como un AttachmentContent objeto.

El getAttachmentContentAsync método obtiene los datos adjuntos con el identificador especificado del elemento. Como procedimiento recomendado, debe obtener el identificador de los datos adjuntos de una llamada item.attachments y, a continuación, en la misma sesión, usar ese identificador para recuperar los datos adjuntos. En Outlook en la Web y nueva Outlook en Windows, el identificador de datos adjuntos solo es válido dentro de la misma sesión. Una sesión termina cuando el usuario cierra la aplicación, o si el usuario comienza a redactar un formulario insertado, a continuación, extrae el formulario para continuar en una ventana independiente.

getAttachmentContentAsync(attachmentId: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;

Parámetros

attachmentId

string

Identificador de los datos adjuntos que desea obtener.

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . Si se produce un error en la llamada, la asyncResult.error propiedad contendrá un código de error con el motivo del error.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Errores:

• AttachmentTypeNotSupported : no se admite el tipo de datos adjuntos. Entre los tipos no admitidos se incluyen imágenes incrustadas en formato de texto enriquecido o tipos de datos adjuntos de elementos que no sean elementos de correo electrónico o de calendario (como un contacto o elemento de tarea).

• InvalidAttachmentId : el identificador de datos adjuntos no existe.

getAttachmentContentAsync(attachmentId, callback)

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.

Obtiene datos adjuntos de un mensaje o cita y lo devuelve como un AttachmentContent objeto.

El getAttachmentContentAsync método obtiene los datos adjuntos con el identificador especificado del elemento. Como procedimiento recomendado, debe obtener el identificador de los datos adjuntos de una llamada item.attachments y, a continuación, en la misma sesión, usar ese identificador para recuperar los datos adjuntos. En Outlook en la Web y nueva Outlook en Windows, el identificador de datos adjuntos solo es válido dentro de la misma sesión. Una sesión termina cuando el usuario cierra la aplicación, o si el usuario comienza a redactar un formulario insertado, a continuación, extrae el formulario para continuar en una ventana independiente.

getAttachmentContentAsync(attachmentId: string, callback?: (asyncResult: Office.AsyncResult<AttachmentContent>) => void): void;

Parámetros

attachmentId

string

Identificador de los datos adjuntos que desea obtener.

callback

(asyncResult: Office.AsyncResult<Office.AttachmentContent>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . Si se produce un error en la llamada, la asyncResult.error propiedad contendrá un código de error con el motivo del error.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Errores:

• AttachmentTypeNotSupported : no se admite el tipo de datos adjuntos. Entre los tipos no admitidos se incluyen imágenes incrustadas en formato de texto enriquecido o tipos de datos adjuntos de elementos que no sean elementos de correo electrónico o de calendario (como un contacto o elemento de tarea).

• InvalidAttachmentId : el identificador de datos adjuntos no existe.

getInitializationContextAsync(options, callback)

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.

Obtiene los datos de inicialización pasados cuando un mensaje accionable activa el complemento.

getInitializationContextAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<string>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult. Si se realiza correctamente, los datos del contexto de inicialización se proporcionan como una cadena (o una cadena vacía si no hay ningún contexto de inicialización) en la asyncResult.value propiedad .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getInitializationContextAsync(callback)

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.

Obtiene los datos de inicialización pasados cuando un mensaje accionable activa el complemento.

getInitializationContextAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<string>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult. Si se realiza correctamente, los datos del contexto de inicialización se proporcionan como una cadena (o una cadena vacía si no hay ningún contexto de inicialización) en la asyncResult.value propiedad .

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getRegExMatches()

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.

Devuelve los valores de cadena del elemento seleccionado que coinciden con las expresiones regulares definidas en un archivo de manifiesto XML.

getRegExMatches(): any;

Devoluciones

any

Un objeto que contiene matrices de cadenas que coinciden con las expresiones regulares definidas en el archivo XML de manifiesto. El nombre de cada matriz es igual al valor correspondiente del atributo RegExName de la regla coincidente ItemHasRegularExpressionMatch o el FilterName atributo de la regla coincidente ItemHasKnownEntity . Para una regla ItemHasRegularExpressionMatch, tiene que darse una cadena coincidente en la propiedad del elemento especificado por la regla. El tipo simple PropertyName define las propiedades admitidas.

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

• Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.

• Este método se usa con la característica de reglas de activación para complementos de Outlook, que no es compatible con el manifiesto unificado para Microsoft 365.

• Si especifica una ItemHasRegularExpressionMatch regla en la propiedad body de un elemento, la expresión regular debe filtrar aún más el cuerpo y no debe intentar devolver todo el cuerpo del elemento. El uso de una expresión regular como .* para obtener todo el cuerpo de un elemento no siempre devuelve los resultados esperados. En su lugar, use el método Body.getAsync para recuperar todo el cuerpo.

getRegExMatchesByName(name)

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.

Devuelve valores de cadena en el elemento seleccionado que coinciden con la expresión regular con nombre definida en un archivo de manifiesto XML.

getRegExMatchesByName(name: string): string[];

Parámetros

name

string

El nombre del elemento de regla ItemHasRegularExpressionMatch que define el filtro para que coincidan.

Devoluciones

string[]

Matriz que contiene las cadenas que coinciden con la expresión regular definida en el ItemHasRegularExpressionMatch elemento rule del archivo XML de manifiesto, con el valor de elemento especificado RegExName .

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Asistente de cita

Importante:

• Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.

• Este método se usa con la característica de reglas de activación para complementos de Outlook, que no es compatible con el manifiesto unificado para Microsoft 365.

• Si especifica una ItemHasRegularExpressionMatch regla en la propiedad body de un elemento, la expresión regular debe filtrar aún más el cuerpo y no debe intentar devolver todo el cuerpo del elemento. El uso de una expresión regular como .* para obtener todo el cuerpo de un elemento no siempre devuelve los resultados esperados. En su lugar, use el método Body.getAsync para recuperar todo el cuerpo.

getSelectedRegExMatches()

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.

Devuelve valores de cadena en una coincidencia resaltada que coinciden con las expresiones regulares definidas en un archivo de manifiesto XML. Las coincidencias resaltadas se aplican a complementos contextuales.

getSelectedRegExMatches(): any;

Devoluciones

any

Un objeto que contiene matrices de cadenas que coinciden con las expresiones regulares definidas en el archivo XML de manifiesto. El nombre de cada matriz es igual al valor correspondiente del atributo RegExName de la regla ItemHasRegularExpressionMatch coincidente o al atributo FilterName de la regla ItemHasKnownEntity coincidente. Para una regla ItemHasRegularExpressionMatch, tiene que darse una cadena coincidente en la propiedad del elemento especificado por la regla. El tipo simple PropertyName define las propiedades admitidas.

Comentarios

[ Conjunto de API: Buzón 1.6 ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante:

• Ahora se han retirado los complementos contextuales de Outlook basados en entidades. Sin embargo, se siguen admitiendo reglas de expresión regular. Se recomienda actualizar el complemento contextual para usar reglas de expresión regular como solución alternativa. Para obtener instrucciones sobre cómo implementar estas reglas, vea Complementos contextuales de Outlook.

• Este método se usa con la característica de reglas de activación para complementos de Outlook, que no es compatible con el manifiesto unificado para Microsoft 365.

• Si especifica una ItemHasRegularExpressionMatch regla en la propiedad body de un elemento, la expresión regular debe filtrar aún más el cuerpo y no debe intentar devolver todo el cuerpo del elemento. El uso de una expresión regular como .* para obtener todo el cuerpo de un elemento no siempre devuelve los resultados esperados. En su lugar, use el método Body.getAsync para recuperar todo el cuerpo.

getSharedPropertiesAsync(options, callback)

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.

Obtiene las propiedades de una cita o mensaje en una carpeta compartida o un buzón compartido.

Para obtener más información sobre el uso de esta API, vea Habilitar carpetas compartidas y escenarios de buzón compartido en un complemento de Outlook.

getSharedPropertiesAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;

Parámetros

options

Office.AsyncContextOptions

Literal de objeto que contiene una o varias de las siguientes propiedades:- asyncContext: los desarrolladores pueden proporcionar cualquier objeto al que quieran acceder en la función de devolución de llamada.

callback

(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . La asyncResult.value propiedad proporciona las propiedades del elemento compartido.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 para compatibilidad con carpetas compartidas, Buzón 1.13 para compatibilidad con buzones compartidos ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

getSharedPropertiesAsync(callback)

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.

Obtiene las propiedades de una cita o mensaje en una carpeta compartida o un buzón compartido.

Para obtener más información sobre el uso de esta API, vea Habilitar carpetas compartidas y escenarios de buzón compartido en un complemento de Outlook.

getSharedPropertiesAsync(callback: (asyncResult: Office.AsyncResult<SharedProperties>) => void): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<Office.SharedProperties>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro, asyncResult, que es un Office.AsyncResult objeto . La asyncResult.value propiedad proporciona las propiedades del elemento compartido.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.8 para compatibilidad con carpetas compartidas, Buzón 1.13 para compatibilidad con buzones compartidos ]

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

loadCustomPropertiesAsync(callback, userContext)

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.

Carga de forma asincrónica las propiedades personalizadas de este complemento en el elemento seleccionado.

Las propiedades personalizadas se almacenan como pares clave-valor por aplicación y por elemento. Este método devuelve un objeto CustomProperties en la devolución de llamada, que proporciona métodos para acceder a las propiedades personalizadas específicas del elemento actual y del complemento actual. Las propiedades personalizadas no se cifran en el elemento, por lo que no se debe usar como almacenamiento seguro.

Las propiedades personalizadas se proporcionan como un objeto CustomProperties en la propiedad asyncResult.value. Este objeto se puede usar para obtener propiedades personalizadas del elemento de correo.

loadCustomPropertiesAsync(callback: (asyncResult: Office.AsyncResult<CustomProperties>) => void, userContext?: any): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<Office.CustomProperties>) => void

Cuando se completa el método, se llama a la función pasada en el callback parámetro con un único parámetro de tipo Office.AsyncResult.

userContext

any

Opcional. Los desarrolladores pueden proporcionar cualquier objeto al que quieran obtener acceso en la función de devolución de llamada. A este objeto se puede acceder mediante la propiedad asyncResult.asyncContext en la función de devolución de llamada.

Devoluciones

void

Comentarios

[ Conjunto de API: Buzón 1.1 ]

Para obtener más información sobre las propiedades personalizadas, vea Obtener y establecer metadatos de complemento para un complemento de Outlook.

Nivel mínimo de permiso: elemento de lectura

Modo de Outlook aplicable: Lectura de mensajes

Importante: Solo se admiten los get métodos y getAll del objeto CustomProperties.

unloadAsync(options, callback)

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 seleccionan varios elementos de correo, cierra el elemento cargado actualmente para que se pueda cargar otro elemento de correo seleccionado para su procesamiento.

unloadAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

options

Office.AsyncContextOptions

Literal de objeto que contiene la asyncContext propiedad . Asigne a la propiedad cualquier objeto al que desee tener acceso en la función de devolución de asyncContext llamada.

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el parámetro de devolución de llamada con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: versión preliminar del buzón ]

Nivel mínimo de permiso: elemento de lectura y escritura

Modo de Outlook aplicable: Compose de mensajes

Importante:

• Para obtener más información sobre el procesamiento de varios mensajes seleccionados, vea Activar el complemento de Outlook en varios mensajes.

• Cuando se carga un elemento de correo seleccionado mediante loadItemByIdAsync, debe llamar a unloadAsync después de procesarlo. Esto debe realizarse antes de llamar a loadItemByIdAsync en otro elemento seleccionado.

unloadAsync(callback)

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 seleccionan varios elementos de correo, cierra el elemento cargado actualmente para que se pueda cargar otro elemento de correo seleccionado para su procesamiento.

unloadAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parámetros

callback

(asyncResult: Office.AsyncResult<void>) => void

Opcional. Cuando se completa el método, se llama a la función pasada en el parámetro de devolución de llamada con un único parámetro, asyncResult, que es un Office.AsyncResult objeto .

Devoluciones

void

Comentarios

[ Conjunto de API: versión preliminar del buzón ]

Nivel mínimo de permiso: elemento de lectura y escritura

Modo de Outlook aplicable: Compose de mensajes

Importante:

• Para obtener más información sobre el procesamiento de varios mensajes seleccionados, vea Activar el complemento de Outlook en varios mensajes.

• Cuando se carga un elemento de correo seleccionado mediante loadItemByIdAsync, debe llamar a unloadAsync después de procesarlo. Esto debe realizarse antes de llamar a loadItemByIdAsync en otro elemento seleccionado.