Office. Loaded Message Read interface

Office.EmailAddressDetails[]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante: apenas os getAsync métodos e getTypeAsync do objeto Corpo são suportados.

cc

Obtém destinatários na linha Cc (cópia de carbono) de uma mensagem.

A cc propriedade devolve uma matriz que contém um objeto EmailAddressDetails para cada destinatário listado na linha Cc da mensagem. O número máximo de destinatários devolvidos varia de acordo com o cliente do Outlook.

Windows (clássico): 500 destinatários
Windows (clássico - em pré-visualização a partir da Versão 2511 (Compilação 19426.20000)): 1000 destinatários
Browser, Windows (novo): 20 destinatários (vista fechada), 500 destinatários (vista expandida)

cc: EmailAddressDetails[];

Valor da propriedade

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

conversationId

Obtém um identificador da conversa de email que contém uma mensagem específica.

Você pode obter um número inteiro para esta propriedade se o aplicativo de email estiver ativado nos formulários de leitura ou nas respostas em formulários de composição. Se, posteriormente, o usuário alterar o assunto da mensagem de resposta, ao enviar a resposta, a ID da conversa daquela mensagem será alterada e o valor obtido anteriormente não mais se aplicará.

conversationId: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

dateTimeCreated

Obtém a data e a hora em que um item foi criado.

dateTimeCreated: Date;

Valor da propriedade

Date

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

dateTimeModified

Obtém a data e a hora em que um item foi alterado pela última vez.

dateTimeModified: Date;

Valor da propriedade

Date

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Participante do Compromisso

Importante: esta propriedade não é suportada no Outlook para Android ou iOS. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.

end

Obtém a data e hora em que o compromisso está para terminar.

A end propriedade é um Date objeto expresso como um valor de data e hora Universal Coordenada (UTC). Pode utilizar o convertToLocalClientTime método para converter o valor da end propriedade para a data e hora locais do cliente.

Ao usar o método Time.setAsync para definir a hora de término, deve-se usar o método convertToUtcClientTime para converter a hora local no cliente para UTC para o servidor.

end: Date;

Valor da propriedade

Date

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

from

Obtém o endereço de email do remetente de uma mensagem.

A from propriedade devolve um EmailAddressDetails objeto.

from: EmailAddressDetails;

Valor da propriedade

Office.EmailAddressDetails

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

As from propriedades e sender representam a mesma pessoa, a menos que a mensagem seja enviada por um delegado com permissões Enviar em nome . Neste caso, a from propriedade devolve o endereço de e-mail do delegante e a sender propriedade devolve o endereço do delegado. Para obter informações sobre a delegação de caixas de correio, consulte Gerir permissões para destinatários no Exchange Online.
A recipientType propriedade do EmailAddressDetails objeto na from propriedade não está definida.

internetMessageId

Obtém o identificador de mensagem da Internet de uma mensagem.

internetMessageId: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante: na pasta Itens Enviados , o internetMessageId pode ainda não estar disponível em itens enviados recentemente. Nesse caso, considere utilizar os Serviços Web exchange para obter esta propriedade do servidor.

itemClass

Obtém a classe de item exchange Web Services da mensagem selecionada.

itemClass: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

A tabela seguinte lista as classes de itens predefinidas para mensagens.

Classe item	Descrição
O IPM. Nota	Novas mensagens e respostas a mensagens
IPM.Schedule.Meeting.Request	Solicitações de reunião
IPM.Schedule.Meeting.Canceled	Cancelamentos de reunião
O IPM. Schedule.Meeting.Resp.Neg	Respostas para recusar solicitações de reunião
O IPM. Schedule.Meeting.Resp.Pos	Respostas para aceitar pedidos de reunião
O IPM. Schedule.Meeting.Resp.Tent	Respostas para aceitar provisoriamente solicitações de reunião

Pode criar classes personalizadas que expandem uma classe de itens predefinida. Por exemplo, IPM.Note.Contoso.

itemId

Obtém o identificador de item dos Serviços Web do Exchange para o item atual.

itemId: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

A itemId propriedade não está disponível no modo de composição. Se for obrigatório o identificador de um item, pode ser usado o método Office.context.mailbox.item.saveAsync para salvar o item no servidor, o que retornará o identificador do item no parâmetro asyncResult.value na função de retorno de chamada. Se o item já estiver guardado, pode chamar o Office.context.mailbox.item.getItemIdAsync método.
O identificador devolvido pela itemId propriedade é o mesmo que o identificador de item dos Serviços Web exchange. A itemId propriedade não é idêntica ao ID de Entrada do Outlook ou ao ID utilizado pela API REST do Outlook. Antes de efetuar chamadas à API REST com este valor, deve ser convertida com Office.context.mailbox.convertToRestId.

itemType

Obtém o tipo de item que representa uma instância.

A itemType propriedade devolve um dos valores de ItemType enumeração, indicando se a instância do objeto de item é uma mensagem ou um compromisso.

itemType: MailboxEnums.ItemType | string;

Valor da propriedade

Office.MailboxEnums.ItemType | string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

location

Obtém a localização de um pedido de reunião.

A propriedade location retorna uma cadeia de caracteres que contém o local do compromisso.

location: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

normalizedSubject

Obtém o assunto de um item, com todos os prefixos removidos (incluindo RE: e FWD:).

A normalizedSubject propriedade obtém o assunto do item, com quaisquer prefixos padrão (como RE: e FW:) que são adicionados por programas de e-mail. Para obter o assunto do item com os prefixos intactos, use a propriedade subject.

normalizedSubject: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

notificationMessages

Obtém as mensagens de notificação do item.

notificationMessages: NotificationMessages;

Valor da propriedade

Office.NotificationMessages

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

Para saber mais sobre os diferentes tipos de mensagens de notificação que pode implementar, consulte Criar notificações para o seu suplemento do Outlook.
Apenas o getAllAsync método do objeto NotificationMessages é suportado.

recurrence

Obtém o padrão de periodicidade de um compromisso. Obtém o padrão de periodicidade de um pedido de reunião. Modos de leitura e composição para itens de compromisso. Modo de leitura para itens de pedido de reunião.

A recurrence propriedade devolve um Recurrence objeto para compromissos periódicos ou pedidos de reuniões se um item for uma série ou uma instância numa série. null é devolvido para compromissos únicos e pedidos de reunião de compromissos únicos. undefined é devolvido para mensagens que não são pedidos de reunião.

recurrence: Recurrence;

Valor da propriedade

Office.Recurrence

Comentários

[ Conjunto de API: Caixa de Correio 1.7 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

Os pedidos de reunião têm um valor itemClass de IPM.Schedule.Meeting.Request.
Se o recurrence objeto for nulo, tal indica que o objeto é um compromisso único ou um pedido de reunião de um único compromisso e não uma parte de uma série.
Apenas são suportados os propeties e o getAsync método do objeto Periodicidade.

sender

Obtém o endereço de email do remetente de uma mensagem de email.

sender: EmailAddressDetails;

Valor da propriedade

Office.EmailAddressDetails

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

As from propriedades e sender representam a mesma pessoa, a menos que a mensagem seja enviada por um delegado com permissões Enviar em nome . Neste caso, a from propriedade devolve o endereço de e-mail do delegante e a sender propriedade devolve o endereço do delegado. Para obter informações sobre a delegação de caixas de correio, consulte Gerir permissões para destinatários no Exchange Online.
A recipientType propriedade do EmailAddressDetails objeto na sender propriedade não está definida.

seriesId

Obtém o ID da série à qual pertence uma instância.

No Outlook na Web e no Windows (novo e clássico), o seriesId devolve o ID dos Serviços Web exchange (EWS) do item principal (série) ao qual este item pertence.

seriesId: string;

Valor da propriedade

string

Comentários

[ Conjunto de API: Caixa de Correio 1.7 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

O identificador retornado pela propriedade seriesId é o mesmo que o identificador do item dos Serviços Web do Exchange. A seriesId propriedade não é idêntica aos IDs do Outlook utilizados pela API REST do Outlook. Antes de efetuar chamadas à API REST com este valor, deve ser convertida com Office.context.mailbox.convertToRestId. Para obter mais detalhes, consulte Utilizar as APIs REST do Outlook a partir de um suplemento do Outlook.
A seriesId propriedade devolve null itens que não têm itens principais, como compromissos individuais, itens de série ou pedidos de reunião e devoluções undefined para quaisquer outros itens que não sejam pedidos de reunião.

start

Obtém a data e hora em que o compromisso deve começar.

A start propriedade é um Date objeto expresso como um valor de data e hora Universal Coordenada (UTC). Pode utilizar o convertToLocalClientTime método para converter o valor para a data e hora locais do cliente.

start: Date;

Valor da propriedade

Date

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

subject

Obtém a descrição que aparece no campo assunto de um item.

A subject propriedade obtém todo o assunto do item, conforme enviado pelo servidor de e-mail.

A propriedade subject retorna uma cadeia de caracteres. Utilize a normalizedSubject propriedade para obter o assunto menos quaisquer prefixos à esquerda, como RE: e FW:.

subject: string;

Valor da propriedade

string

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

to

Obtém os destinatários na linha Para de uma mensagem. Fornece acesso aos destinatários na linha Para de uma mensagem. O tipo de objeto e o nível de acesso dependem do modo do item atual.

A to propriedade devolve uma matriz que contém um objeto EmailAddressDetails para cada destinatário listado na linha Para da mensagem. O número máximo de destinatários devolvidos varia de acordo com o cliente do Outlook.

Windows (clássico): 500 destinatários
Windows (clássico - em pré-visualização a partir da Versão 2511 (Compilação 19426.20000)): 1000 destinatários
Browser, Windows (novo): 20 destinatários (vista fechada), 500 destinatários (vista expandida)

to: EmailAddressDetails[];

Valor da propriedade

Office.EmailAddressDetails[]

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Detalhes do método

displayReplyAllFormAsync(formData, options, callback)

Apresenta um formulário de resposta que inclui o remetente e todos os destinatários da mensagem selecionada ou o organizador e todos os participantes do compromisso selecionado.

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

Parâmetros

formData: string | Office.ReplyFormData

Uma cadeia de caracteres que contém texto e HTML e que representa o corpo do formulário de resposta. A cadeia está limitada a 32 KB OU um objeto ReplyFormData que contém dados do corpo ou do anexo e uma função de chamada de retorno.

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

No Outlook na Web e no novo Outlook no Windows, o formulário de resposta é apresentado como um formulário de destaque na vista de 3 colunas e um formulário de pop-up na vista de 2 colunas ou 1 coluna.
Se qualquer dos parâmetros da cadeia de caracteres exceder seu limite, displayReplyAllFormAsync gera uma exceção.
Quando os anexos são especificados no parâmetro , o formData.attachments Outlook tenta transferir todos os anexos e anexá-los ao formulário de resposta. Se a adição de anexos falhar, será exibido um erro na interface de usuário do formulário. Se isso não for possível, nenhuma mensagem de erro será apresentada.

displayReplyAllFormAsync(formData, callback)

Apresenta um formulário de resposta que inclui o remetente e todos os destinatários da mensagem selecionada ou o organizador e todos os participantes do compromisso selecionado.

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

Parâmetros

formData: string | Office.ReplyFormData

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

No Outlook na Web e no novo Outlook no Windows, o formulário de resposta é apresentado como um formulário de destaque na vista de 3 colunas e um formulário de pop-up na vista de 2 colunas ou 1 coluna.
Se qualquer dos parâmetros da cadeia de caracteres exceder seu limite, displayReplyAllFormAsync gera uma exceção.
Quando os anexos são especificados no parâmetro , o formData.attachments Outlook tenta transferir todos os anexos e anexá-los ao formulário de resposta. Se a adição de anexos falhar, será exibido um erro na interface de usuário do formulário. Se isso não for possível, nenhuma mensagem de erro será apresentada.

displayReplyFormAsync(formData, options, callback)

Exibe um formulário de resposta que inclui o remetente da mensagem selecionada ou o organizador do compromisso selecionado.

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

Parâmetros

formData: string | Office.ReplyFormData

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

No Outlook na Web e no novo Outlook no Windows, o formulário de resposta é apresentado como um formulário de destaque na vista de 3 colunas e um formulário de pop-up na vista de 2 colunas ou 1 coluna.
Se qualquer dos parâmetros da cadeia de caracteres exceder seu limite, displayReplyFormAsync gera uma exceção.
Quando os anexos são especificados no parâmetro , o formData.attachments Outlook tenta transferir todos os anexos e anexá-los ao formulário de resposta. Se a adição de anexos falhar, será exibido um erro na interface de usuário do formulário. Se isso não for possível, nenhuma mensagem de erro será apresentada.

displayReplyFormAsync(formData, callback)

Exibe um formulário de resposta que inclui o remetente da mensagem selecionada ou o organizador do compromisso selecionado.

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

Parâmetros

formData: string | Office.ReplyFormData

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

No Outlook na Web e no novo Outlook no Windows, o formulário de resposta é apresentado como um formulário de destaque na vista de 3 colunas e um formulário de pop-up na vista de 2 colunas ou 1 coluna.
Se qualquer dos parâmetros da cadeia de caracteres exceder seu limite, displayReplyFormAsync gera uma exceção.
Quando os anexos são especificados no parâmetro , o formData.attachments Outlook tenta transferir todos os anexos e anexá-los ao formulário de resposta. Se a adição de anexos falhar, será exibido um erro na interface de usuário do formulário. Se isso não for possível, nenhuma mensagem de erro será apresentada.

getAllInternetHeadersAsync(options, callback)

Obtém todos os cabeçalhos da Internet para a mensagem como uma cadeia.

Para saber mais, consulte Obter e definir cabeçalhos da Internet numa mensagem num suplemento do Outlook.

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

Parâmetros

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. Com êxito, os dados dos cabeçalhos da Internet são fornecidos na asyncResult.value propriedade como uma cadeia. Veja RFC 2183 para obter as informações de formatação do valor de cadeia devolvido. Se a chamada falhar, a asyncResult.error propriedade conterá um código de erro com o motivo da falha.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getAllInternetHeadersAsync(callback)

Obtém todos os cabeçalhos da Internet para a mensagem como uma cadeia.

Para saber mais, consulte Obter e definir cabeçalhos da Internet numa mensagem num suplemento do Outlook.

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

Parâmetros

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.14 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getAsFileAsync(options, callback)

Obtém a mensagem atual no formato EML codificada em Base64.

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

Parâmetros

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Quando o método for concluído, a função transmitida no parâmetro de chamada de retorno é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. O formato EML codificado com Base64 da mensagem é devolvido na asyncResult.value propriedade . Todos os erros encontrados são devolvidos na asyncResult.error propriedade .

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getAsFileAsync(callback)

Obtém a mensagem atual no formato EML codificada em Base64.

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

Parâmetros

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.14 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getAttachmentContentAsync(attachmentId, options, callback)

Obtém um anexo de uma mensagem ou compromisso e devolve-o como um AttachmentContent objeto.

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

Parâmetros

attachmentId: string

O identificador do anexo que pretende obter.

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Opcional. Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. Se a chamada falhar, a asyncResult.error propriedade conterá um código de erro com o motivo da falha.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

O getAttachmentContentAsync método obtém o anexo com o identificador especificado do item. Como melhor prática, deve obter o identificador do anexo a partir de uma chamada item.attachments e, em seguida, na mesma sessão, utilizar esse identificador para obter o anexo.
No Outlook na Web e no novo Outlook no Windows, getAttachmentContentAsync não suporta anexos adicionados através da opção Carregar e partilhar.
No Outlook na Web, em dispositivos móveis e no novo Outlook no Windows, o identificador de anexo só é válido na mesma sessão. Uma sessão termina quando o utilizador fecha a aplicação ou, se o utilizador começar a compor um formulário inline, é posteriormente apresentado o formulário para continuar numa janela separada.

Erros:

AttachmentTypeNotSupported : o tipo de anexo não é suportado. Os tipos não suportados incluem imagens incorporadas no Formato RTF ou tipos de anexos de itens diferentes dos itens de e-mail ou calendário (como um contacto ou item de tarefa).
InvalidAttachmentId : o identificador de anexo não existe.

getAttachmentContentAsync(attachmentId, callback)

Obtém um anexo de uma mensagem ou compromisso e devolve-o como um AttachmentContent objeto.

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

Parâmetros

attachmentId: string

O identificador do anexo que pretende obter.

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

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

O getAttachmentContentAsync método obtém o anexo com o identificador especificado do item. Como melhor prática, deve obter o identificador do anexo a partir de uma chamada item.attachments e, em seguida, na mesma sessão, utilizar esse identificador para obter o anexo.
No Outlook na Web e no novo Outlook no Windows, getAttachmentContentAsync não suporta anexos adicionados através da opção Carregar e partilhar.
No Outlook na Web, em dispositivos móveis e no novo Outlook no Windows, o identificador de anexo só é válido na mesma sessão. Uma sessão termina quando o utilizador fecha a aplicação ou, se o utilizador começar a compor um formulário inline, é posteriormente apresentado o formulário para continuar numa janela separada.

Erros:

AttachmentTypeNotSupported : o tipo de anexo não é suportado. Os tipos não suportados incluem imagens incorporadas no Formato RTF ou tipos de anexos de itens diferentes dos itens de e-mail ou calendário (como um contacto ou item de tarefa).
InvalidAttachmentId : o identificador de anexo não existe.

getInitializationContextAsync(options, callback)

Obtém dados de inicialização transmitidos quando o suplemento é ativado por uma mensagem acionável.

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

Parâmetros

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult. Com êxito, os dados de contexto de inicialização são fornecidos como uma cadeia (ou uma cadeia vazia se não houver contexto de inicialização) na asyncResult.value propriedade.

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getInitializationContextAsync(callback)

Obtém dados de inicialização transmitidos quando o suplemento é ativado por uma mensagem acionável.

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

Parâmetros

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

Retornos

void

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getRegExMatches()

Devolve valores de cadeia no item selecionado que correspondem às expressões regulares definidas num ficheiro de manifesto XML.

getRegExMatches(): any;

Retornos

any

Um objeto que contém matrizes de cadeias de caracteres que correspondem às expressões regulares definidas no arquivo XML do manifesto. O nome de cada matriz é igual ao valor correspondente do atributo RegExName da regra correspondente ItemHasRegularExpressionMatch ou do FilterName atributo da regra correspondente ItemHasKnownEntity . Para uma regra ItemHasRegularExpressionMatch, uma cadeia de caracteres correspondente deve ocorrer na propriedade do item especificada por essa regra. O tipo simples PropertyName define as propriedades compatíveis.

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Participante do Compromisso

Importante:

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.
Este método é utilizado com a funcionalidade de regras de ativação para suplementos do Outlook, que não é suportada pelo manifesto unificado do Microsoft 365.
Se especificar uma ItemHasRegularExpressionMatch regra na propriedade body de um item, a expressão regular deverá filtrar ainda mais o corpo e não deve tentar devolver todo o corpo do item. A utilização de uma expressão regular, como .* para obter todo o corpo de um item, nem sempre devolve os resultados esperados. Em vez disso, use o método Body.getAsync para recuperar todo o corpo.

getRegExMatchesByName(name)

Devolve valores de cadeia no item selecionado que correspondem à expressão regular nomeada definida num ficheiro de manifesto XML.

getRegExMatchesByName(name: string): string[];

Parâmetros

name: string

O nome do elemento de regra ItemHasRegularExpressionMatch que define o filtro a corresponder.

Retornos

string[]

Uma matriz que contém as cadeias que correspondem à expressão regular definida no elemento de ItemHasRegularExpressionMatch regra no ficheiro XML de manifesto, com o valor do elemento especificado RegExName .

Comentários

[ Conjunto de API: Caixa de Correio 1.6 ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Participante do Compromisso

Importante:

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.
Este método é utilizado com a funcionalidade de regras de ativação para suplementos do Outlook, que não é suportada pelo manifesto unificado do Microsoft 365.
Se especificar uma ItemHasRegularExpressionMatch regra na propriedade body de um item, a expressão regular deverá filtrar ainda mais o corpo e não deve tentar devolver todo o corpo do item. A utilização de uma expressão regular, como .* para obter todo o corpo de um item, nem sempre devolve os resultados esperados. Em vez disso, use o método Body.getAsync para recuperar todo o corpo.

getSelectedRegExMatches()

Devolve valores de cadeia numa correspondência realçada que correspondem às expressões regulares definidas num ficheiro de manifesto XML. As correspondências realçadas aplicam-se aos suplementos contextuais.

getSelectedRegExMatches(): any;

Retornos

any

Um objeto que contém matrizes de cadeias de caracteres que correspondem às expressões regulares definidas no arquivo XML do manifesto. O nome de cada matriz é igual ao valor correspondente do atributo RegExName da regra ItemHasRegularExpressionMatch correspondente ou do atributo FilterName da regra ItemHasKnownEntity correspondente. Para uma regra ItemHasRegularExpressionMatch, uma cadeia de caracteres correspondente deve ocorrer na propriedade do item especificada por essa regra. O tipo simples PropertyName define as propriedades compatíveis.

Comentários

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

Importante:

Os suplementos contextuais do Outlook baseados em entidades foram descontinuados. No entanto, as regras de expressão regulares continuam a ser suportadas. Recomendamos que atualize o suplemento contextual para utilizar regras de expressão regulares como uma solução alternativa. Para obter orientações sobre como implementar estas regras, veja Suplementos contextuais do Outlook.
Este método é utilizado com a funcionalidade de regras de ativação para suplementos do Outlook, que não é suportada pelo manifesto unificado do Microsoft 365.
Se especificar uma ItemHasRegularExpressionMatch regra na propriedade body de um item, a expressão regular deverá filtrar ainda mais o corpo e não deve tentar devolver todo o corpo do item. Utilizar uma expressão regular, como .* para obter todo o corpo de um item, nem sempre devolve os resultados esperados. Em vez disso, use o método Body.getAsync para recuperar todo o corpo.

getSharedPropertiesAsync(options, callback)

Obtém as propriedades de um compromisso ou mensagem numa pasta partilhada ou caixa de correio partilhada.

Para obter mais informações sobre como utilizar esta API, consulte Ativar pastas partilhadas e cenários de caixa de correio partilhada num suplemento do Outlook.

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

Parâmetros

options: Office.AsyncContextOptions

Um literal de objeto que contém uma ou mais das seguintes propriedades: asyncContext: os programadores podem fornecer qualquer objeto a que pretendam aceder na função de chamada de retorno.

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

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro, asyncResult, que é um Office.AsyncResult objeto. A asyncResult.value propriedade fornece as propriedades do item partilhado.

Retornos

void

Comentários

[ Conjunto de API: Caixa de correio 1.8 para suporte de pastas partilhadas, Caixa de Correio 1.13 para suporte de caixa de correio partilhada ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

getSharedPropertiesAsync(callback)

Obtém as propriedades de um compromisso ou mensagem numa pasta partilhada ou caixa de correio partilhada.

Para obter mais informações sobre como utilizar esta API, consulte Ativar pastas partilhadas e cenários de caixa de correio partilhada num suplemento do Outlook.

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

Parâmetros

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de correio 1.8 para suporte de pastas partilhadas, Caixa de Correio 1.13 para suporte de caixa de correio partilhada ]

Nível mínimo de permissão: ler item

Modo Outlook aplicável: Leitura da Mensagem

loadCustomPropertiesAsync(callback, userContext)

Carrega de forma assíncrona as propriedades personalizadas para esse suplemento no item selecionado.

As propriedades personalizadas são armazenadas como pares chave-valor numa base por aplicação, por item. Este método devolve um objeto CustomProperties na chamada de retorno, que fornece métodos para aceder às propriedades personalizadas específicas do item atual e do suplemento atual. As propriedades personalizadas não são encriptadas no item, pelo que não deve ser utilizado como armazenamento seguro.

As propriedades personalizadas são fornecidas como um objeto CustomProperties na propriedade asyncResult.value. Este objeto pode ser utilizado para obter propriedades personalizadas do item de correio.

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

Parâmetros

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

Quando o método for concluído, a função transmitida no callback parâmetro é chamada com um único parâmetro do tipo Office.AsyncResult.

userContext: any

Opcional. Os desenvolvedores podem fornecer qualquer objeto que desejarem acessar na função de retorno de chamada. Esse objeto pode ser acessado pela propriedade asyncResult.asyncContext na função de retorno de chamada.

Retornos

void

Comentários