Office.MessageCompose interface
O modo de composição de mensagens de Office.context.mailbox.item.
Importante:
Este é um objeto interno do Outlook, não exposto diretamente através de interfaces existentes. Deve tratar isto como um modo de
Office.context.mailbox.item
. Para obter mais informações, veja a página Modelo de Objeto .Ao chamar
Office.context.mailbox.item
uma mensagem, tenha em atenção que o Painel de Leitura no cliente do Outlook tem de estar ativado. Para obter orientações sobre como configurar o Painel de Leitura, consulte Utilizar e configurar o Painel de Leitura para pré-visualizar mensagens.
Interfaces principais:
- Extends
Propriedades
bcc | Obtém um objeto que fornece métodos para obter ou atualizar os destinatários na linha Bcc (cópia oculta de carbono) de uma mensagem. Consoante o cliente/plataforma (ou seja, Windows, Mac, etc.), podem aplicar-se limites ao número de destinatários que pode obter ou atualizar. Veja o objeto Destinatários para obter mais detalhes. |
body | Obtém um objeto que fornece métodos para manipular o corpo de um item. |
categories | Obtém um objeto que fornece métodos para gerir as categorias do item. |
cc | Fornece acesso aos destinatários na linha Cc (com cópia) de uma mensagem. O tipo de objeto e o nível de acesso dependem do modo do item atual. A propriedade |
conversation |
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á. Você obtém nulo para esta propriedade para um novo item em um formulário de composição. Se o usuário definir um assunto e salvar o item, a propriedade |
delay |
Obtém ou define a data e hora de entrega atrasadas de uma mensagem. A |
from | Obtém o endereço de email do remetente de uma mensagem. A |
in |
Obtém o ID da mensagem original a ser respondida pela mensagem atual. |
internet |
Obtém ou define os cabeçalhos de Internet personalizados de uma mensagem. A Para saber mais, consulte Obter e definir cabeçalhos da Internet numa mensagem num suplemento do Outlook. |
item |
Obtém o tipo de item que representa uma instância. A |
notification |
Obtém as mensagens de notificação de um item. |
sensitivity |
Obtém o objeto para obter ou definir a etiqueta de confidencialidade de uma mensagem. |
series |
Obtém o ID da série à qual pertence uma instância. No Outlook na Web, no Windows (novo e clássico) e no Mac, o |
session |
Gere o SessionData de um item no modo Compose. Importante: todo o objeto SessionData está limitado a 50 000 carateres por suplemento. |
subject | Obtém ou define a descrição que aparece no campo de assunto de um item. A propriedade A propriedade |
to | 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 propriedade |
Métodos
add |
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo. O método |
add |
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo. O método |
add |
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo. O Posteriormente, você poderá usar o identificador com o método |
add |
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo. O Posteriormente, você poderá usar o identificador com o método |
add |
Adiciona um manipulador de eventos a um evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas. Para eventos suportados, veja a secção Eventos do modelo de objeto de item. |
add |
Adiciona um manipulador de eventos a um evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas. Para eventos suportados, veja a secção Eventos do modelo de objeto de item. |
add |
Adiciona um item do Exchange, como uma mensagem, como anexo na mensagem ou no compromisso. O método Posteriormente, você poderá usar o identificador com o método Se o seu Suplemento do Office estiver em execução no Outlook na Web ou no novo Outlook no Windows, o |
add |
Adiciona um item do Exchange, como uma mensagem, como anexo na mensagem ou no compromisso. O método Posteriormente, você poderá usar o identificador com o método Se o seu Suplemento do Office estiver em execução no Outlook na Web ou no novo Outlook no Windows, o |
close() | Fecha o item atual que está sendo composto. O comportamento do método No Outlook no Windows (clássico) e no Mac, o |
close |
Fecha a mensagem atual que está a ser composta com a opção de eliminar alterações não guardadas. A mensagem que está a ser composta pode ser uma nova mensagem, resposta ou um rascunho existente. |
close |
Fecha a nova mensagem atual que está a ser composta. O comportamento de uma nova mensagem a ser composta depende se a mensagem contém alterações não guardadas. Se não tiverem sido efetuadas alterações, a mensagem será fechada sem uma caixa de diálogo guardar. Por outro lado, se a mensagem contiver alterações não guardadas, é apresentada uma caixa de diálogo guardar a pedir ao utilizador para guardar um rascunho, rejeitar alterações ou cancelar a operação. |
disable |
Desativa a assinatura de cliente do Outlook. O comportamento deste método depende do cliente que o suplemento está a executar.
|
disable |
Desativa a assinatura de cliente do Outlook. O comportamento deste método depende do cliente que o suplemento está a executar.
|
get |
Obtém um anexo de uma mensagem ou compromisso e devolve-o como um O |
get |
Obtém um anexo de uma mensagem ou compromisso e devolve-o como um O |
get |
Obtém os anexos do item como uma matriz. |
get |
Obtém os anexos do item como uma matriz. |
get |
Especifica o tipo de composição de mensagens e o respetivo tipo de coação. A mensagem pode ser nova ou responder ou reencaminhar. O tipo de coerção pode ser HTML ou texto simples. |
get |
Especifica o tipo de composição de mensagens e o respetivo tipo de coação. A mensagem pode ser nova ou responder ou reencaminhar. O tipo de coerção pode ser HTML ou texto simples. |
get |
Obtém a posição codificada em Base64 da mensagem atual num tópico de conversação. |
get |
Obtém a posição codificada em Base64 da mensagem atual num tópico de conversação. |
get |
Obtém dados de inicialização transmitidos quando o suplemento é ativado por uma mensagem acionável. |
get |
Obtém dados de inicialização transmitidos quando o suplemento é ativado por uma mensagem acionável. |
get |
Obtém a classe de item exchange Web Services da mensagem selecionada. |
get |
Obtém a classe de item exchange Web Services da mensagem selecionada. |
get |
De forma assíncrona, obtém o identificador de item dos Serviços Web exchange (EWS) de um item guardado. Quando invocado, este método devolve o ID do item através da função de chamada de retorno. |
get |
De forma assíncrona, obtém o identificador de item dos Serviços Web exchange (EWS) de um item guardado. Quando invocado, este método devolve o ID do item através da função de chamada de retorno. |
get |
Retorna de forma assíncrona os dados selecionados do assunto ou do corpo de uma mensagem. Se não houver seleção, mas o cursor estiver no corpo ou assunto, o método devolve uma cadeia vazia para os dados selecionados. Se um campo que não seja o corpo ou o assunto estiver selecionado, o método retorna o erro Para aceder aos dados selecionados a partir da função de chamada de retorno, chame |
get |
Retorna de forma assíncrona os dados selecionados do assunto ou do corpo de uma mensagem. Se não houver seleção, mas o cursor estiver no corpo ou assunto, o método devolve uma cadeia vazia para os dados selecionados. Se um campo que não seja o corpo ou o assunto estiver selecionado, o método retorna o erro Para aceder aos dados selecionados a partir da função de chamada de retorno, chame |
get |
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. |
get |
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. |
is |
Obtém se a assinatura do cliente estiver ativada. No Outlook no Windows (clássico) e no Mac, a chamada à API é devolvida |
is |
Obtém se a assinatura do cliente estiver ativada. No Outlook no Windows (clássico) e no Mac, a chamada à API é devolvida |
load |
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 |
remove |
Remove um anexo de uma mensagem ou de um compromisso. O método |
remove |
Remove um anexo de uma mensagem ou de um compromisso. O método |
remove |
Remove um manipulador de eventos para um tipo de evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas. Para eventos suportados, veja a secção Eventos do modelo de objeto de item. |
remove |
Remove um manipulador de eventos para um tipo de evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas. Para eventos suportados, veja a secção Eventos do modelo de objeto de item. |
save |
Guarda de forma assíncrona a mensagem atual como um rascunho. |
save |
Guarda de forma assíncrona a mensagem atual como um rascunho. |
set |
Insere de forma assíncrona os dados no corpo ou no assunto de uma mensagem. O |
set |
Insere de forma assíncrona os dados no corpo ou no assunto de uma mensagem. O |
Detalhes da propriedade
bcc
Obtém um objeto que fornece métodos para obter ou atualizar os destinatários na linha Bcc (cópia oculta de carbono) de uma mensagem.
Consoante o cliente/plataforma (ou seja, Windows, Mac, etc.), podem aplicar-se limites ao número de destinatários que pode obter ou atualizar. Veja o objeto Destinatários para obter mais detalhes.
bcc: Recipients;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
Office.context.mailbox.item.bcc.setAsync( ['alice@contoso.com', 'bob@contoso.com'] );
Office.context.mailbox.item.bcc.addAsync( ['jason@contoso.com'] );
Office.context.mailbox.item.bcc.getAsync(callback);
function callback(asyncResult) {
const arrayOfBccRecipients = asyncResult.value;
}
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-bcc-message-compose.yaml
Office.context.mailbox.item.bcc.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const msgBcc = asyncResult.value;
console.log("Message being blind-copied to:");
for (let i = 0; i < msgBcc.length; i++) {
console.log(msgBcc[i].displayName + " (" + msgBcc[i].emailAddress + ")");
}
} else {
console.error(asyncResult.error);
}
});
...
const email = $("#emailBcc")
.val()
.toString();
const emailArray = [email];
Office.context.mailbox.item.bcc.setAsync(emailArray, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Succeeded in setting Bcc field.");
} else {
console.error(asyncResult.error);
}
});
body
Obtém um objeto que fornece métodos para manipular o corpo de um item.
body: Body;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// This example gets the body of the item as plain text.
Office.context.mailbox.item.body.getAsync(
"text",
{ asyncContext: "This is passed to the callback" },
function callback(result) {
// Do something with the result.
});
// The following is an example of the result parameter passed to the callback function.
{
"value": "TEXT of whole body (including threads below)",
"status": "succeeded",
"asyncContext": "This is passed to the callback"
}
categories
Obtém um objeto que fornece métodos para gerir as categorias do item.
categories: Categories;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante: no Outlook na Web e no novo Outlook no Windows, não pode utilizar a API para gerir categorias numa mensagem no modo Compose.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/45-categories/work-with-categories.yaml
Office.context.mailbox.item.categories.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const categories = asyncResult.value;
if (categories && categories.length > 0) {
console.log("Categories assigned to this item:");
console.log(JSON.stringify(categories));
} else {
console.log("There are no categories assigned to this item.");
}
} else {
console.error(asyncResult.error);
}
});
...
// Note: In order for you to successfully add a category,
// it must be in the mailbox categories master list.
Office.context.mailbox.masterCategories.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const masterCategories = asyncResult.value;
if (masterCategories && masterCategories.length > 0) {
// Grab the first category from the master list.
const categoryToAdd = [masterCategories[0].displayName];
Office.context.mailbox.item.categories.addAsync(categoryToAdd, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log(`Successfully assigned category '${categoryToAdd}' to item.`);
} else {
console.log("categories.addAsync call failed with error: " + asyncResult.error.message);
}
});
} else {
console.log("There are no categories in the master list on this mailbox. You can add categories using Office.context.mailbox.masterCategories.addAsync.");
}
} else {
console.error(asyncResult.error);
}
});
...
Office.context.mailbox.item.categories.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const categories = asyncResult.value;
if (categories && categories.length > 0) {
// Grab the first category assigned to this item.
const categoryToRemove = [categories[0].displayName];
Office.context.mailbox.item.categories.removeAsync(categoryToRemove, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log(`Successfully unassigned category '${categoryToRemove}' from this item.`);
} else {
console.log("categories.removeAsync call failed with error: " + asyncResult.error.message);
}
});
} else {
console.log("There are no categories assigned to this item.");
}
} else {
console.error(asyncResult.error);
}
});
cc
Fornece acesso aos destinatários na linha Cc (com cópia) de uma mensagem. O tipo de objeto e o nível de acesso dependem do modo do item atual.
A propriedade cc
retorna um objeto Recipients
que fornece métodos para obter ou atualizar os destinatários na linha Cc da mensagem. No entanto, dependendo do cliente/plataforma (ou seja, Windows, Mac, etc.), podem aplicar-se limites ao número de destinatários que pode obter ou atualizar. Veja o objeto Destinatários para obter mais detalhes.
cc: Recipients;
Valor da propriedade
Comentários
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
Office.context.mailbox.item.cc.setAsync( ['alice@contoso.com', 'bob@contoso.com'] );
Office.context.mailbox.item.cc.addAsync( ['jason@contoso.com'] );
Office.context.mailbox.item.cc.getAsync(callback);
function callback(asyncResult) {
const arrayOfCcRecipients = asyncResult.value;
}
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-cc-message-compose.yaml
Office.context.mailbox.item.cc.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const msgCc = asyncResult.value;
console.log("Message being copied to:");
for (let i = 0; i < msgCc.length; i++) {
console.log(msgCc[i].displayName + " (" + msgCc[i].emailAddress + ")");
}
} else {
console.error(asyncResult.error);
}
});
...
const email = $("#emailCc")
.val()
.toString();
const emailArray = [email];
Office.context.mailbox.item.cc.setAsync(emailArray, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Succeeded in setting Cc field.");
} else {
console.error(asyncResult.error);
}
});
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á.
Você obtém nulo para esta propriedade para um novo item em um formulário de composição. Se o usuário definir um assunto e salvar o item, a propriedade conversationId
retornará um valor.
conversationId: string;
Valor da propriedade
string
Comentários
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-conversation-id-message.yaml
console.log(`Conversation ID: ${Office.context.mailbox.item.conversationId}`);
delayDeliveryTime
Obtém ou define a data e hora de entrega atrasadas de uma mensagem.
A delayDeliveryTime
propriedade devolve um DelayDeliveryTime
objeto que fornece métodos para gerir a data e hora de entrega da mensagem.
delayDeliveryTime: DelayDeliveryTime;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.13 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/delay-message-delivery.yaml
function setDeliveryDate(minutes) {
// This snippet sets the delivery date and time of a message.
const currentTime = new Date().getTime();
const milliseconds = totalDelay * 60000;
const timeDelay = new Date(currentTime + milliseconds);
Office.context.mailbox.item.delayDeliveryTime.setAsync(timeDelay, (asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log(asyncResult.error.message);
return;
}
if (minutes === 1440) {
console.log(`Delayed delivery by an additional one day.`);
} else {
console.log(`Delayed delivery by an additional ${minutes} minutes.`);
}
});
}
from
Obtém o endereço de email do remetente de uma mensagem.
A from
propriedade devolve um From
objeto que fornece um método para obter o do valor .
from: From;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.7 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante: esta propriedade é suportada no Outlook para Android e no iOS. Para obter um cenário de exemplo, veja Implementar a ativação baseada em eventos em suplementos móveis do Outlook.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-from-message-compose.yaml
Office.context.mailbox.item.from.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const msgFrom = asyncResult.value;
console.log("Message from: " + msgFrom.displayName + " (" + msgFrom.emailAddress + ")");
} else {
console.error(asyncResult.error);
}
});
inReplyTo
Obtém o ID da mensagem original a ser respondida pela mensagem atual.
inReplyTo: string;
Valor da propriedade
string
Comentários
[ Conjunto de API: Caixa de Correio 1.14 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante:
No Outlook no Windows, o
inReplyTo
valor é mantido em todas as respostas, independentemente das alterações efetuadas pelo utilizador, como alterar o assunto numa resposta.A
inReplyTo
propriedade é devolvidanull
para novas mensagens e convites de reunião que estão a ser reencaminhados por um utilizador que também é o organizador da reunião.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-in-reply-to.yaml
// This snippet gets the ID of the message being replied to by the current message (PR_IN_REPLY_TO_ID).
// The API call is supported on messages being composed and isn't supported on read items.
const inReplyTo = Office.context.mailbox.item.inReplyTo;
if (inReplyTo) {
console.log("ID of the message being replied to: " + inReplyTo);
} else {
console.log("No InReplyTo property available for this message");
}
internetHeaders
Obtém ou define os cabeçalhos de Internet personalizados de uma mensagem.
A internetHeaders
propriedade devolve um InternetHeaders
objeto que fornece métodos para gerir os cabeçalhos da Internet na mensagem.
Para saber mais, consulte Obter e definir cabeçalhos da Internet numa mensagem num suplemento do Outlook.
internetHeaders: InternetHeaders;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante: a API de cabeçalhos da Internet é suportada no Outlook no Android e no iOS a partir da Versão 4.2405.0. Para saber mais sobre as funcionalidades suportadas no Outlook em dispositivos móveis, consulte APIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/70-mime-headers/manage-custom-internet-headers-message-compose.yaml
Office.context.mailbox.item.internetHeaders.getAsync(
["preferred-fruit", "preferred-vegetable", "best-vegetable", "nonexistent-header"],
function (asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Selected headers: " + JSON.stringify(asyncResult.value));
} else {
console.log("Error getting selected headers: " + JSON.stringify(asyncResult.error));
}
}
);
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: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-item-type.yaml
const itemType = Office.context.mailbox.item.itemType;
switch (itemType) {
case Office.MailboxEnums.ItemType.Appointment:
console.log(`Current item is an ${itemType}.`);
break;
case Office.MailboxEnums.ItemType.Message:
console.log(`Current item is a ${itemType}. A message could be an email, meeting request, meeting response, or meeting cancellation.`);
break;
}
notificationMessages
Obtém as mensagens de notificação de um item.
notificationMessages: NotificationMessages;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.3 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml
// Adds a progress indicator to the mail item.
const id = $("#notificationId").val().toString();
const details =
{
type: Office.MailboxEnums.ItemNotificationMessageType.ProgressIndicator,
message: "Progress indicator with id = " + id
};
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);
...
// Adds an informational notification to the mail item.
const id = $("#notificationId").val().toString();
const details =
{
type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
message: "Non-persistent informational notification message with id = " + id,
icon: "icon1",
persistent: false
};
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);
...
// Adds a persistent information notification to the mail item.
const id = $("#notificationId").val().toString();
const details =
{
type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
message: "Persistent informational notification message with id = " + id,
icon: "icon1",
persistent: true
};
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);
...
// Gets all the notification messages and their keys for the current mail item.
Office.context.mailbox.item.notificationMessages.getAllAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log(asyncResult.error.message);
return;
}
console.log(asyncResult.value);
});
...
// Replaces a notification message of a given key with another message.
const id = $("#notificationId").val().toString();
Office.context.mailbox.item.notificationMessages.replaceAsync(
id,
{
type: Office.MailboxEnums.ItemNotificationMessageType.InformationalMessage,
message: "Notification message with id = " + id + " has been replaced with an informational message.",
icon: "icon2",
persistent: false
},
handleResult);
...
// Removes a notification message from the current mail item.
const id = $("#notificationId").val().toString();
Office.context.mailbox.item.notificationMessages.removeAsync(id, handleResult);
sensitivityLabel
Obtém o objeto para obter ou definir a etiqueta de confidencialidade de uma mensagem.
sensitivityLabel: SensitivityLabel;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.13 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante: para utilizar a funcionalidade de etiqueta de confidencialidade no suplemento, tem de ter uma subscrição Microsoft 365 E5.
Para saber mais sobre como gerir etiquetas de confidencialidade no seu suplemento, consulte Gerir a etiqueta de confidencialidade da sua mensagem ou compromisso no modo de composição.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/60-sensitivity-label/sensitivity-label.yaml
// This snippet gets the current mail item's sensitivity label.
Office.context.sensitivityLabelsCatalog.getIsEnabledAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value == true) {
Office.context.mailbox.item.sensitivityLabel.getAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log(asyncResult.value);
} else {
console.log("Action failed with error: " + asyncResult.error.message);
}
});
} else {
console.log("Action failed with error: " + asyncResult.error.message);
}
});
seriesId
Obtém o ID da série à qual pertence uma instância.
No Outlook na Web, no Windows (novo e clássico) e no Mac, o seriesId
devolve o ID dos Serviços Web exchange (EWS) do item principal (série) ao qual este item pertence. No entanto, no iOS e Android, o seriesId devolve o ID REST do item principal.
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: mensagem Compose
Importante: o identificador devolvido pela seriesId
propriedade é o mesmo que o identificador de item dos Serviços Web 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 é devolvida null
para 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 estejam a cumprir pedidos.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/50-recurrence/get-series-id.yaml
const seriesId = Office.context.mailbox.item.seriesId;
if (seriesId === undefined) {
console.log("This is a message that's not a meeting request.");
} else if (seriesId === null) {
console.log("This is a single appointment, a parent series, or a meeting request for a series or single meeting.");
} else {
console.log("This is an instance belonging to series with ID " + seriesId);
}
sessionData
Gere o SessionData de um item no modo Compose.
Importante: todo o objeto SessionData está limitado a 50 000 carateres por suplemento.
sessionData: SessionData;
Valor da propriedade
Comentários
[ Conjunto de API: Caixa de Correio 1.11 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/session-data-apis.yaml
Office.context.mailbox.item.sessionData.getAllAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("The sessionData is " + JSON.stringify(asyncResult.value));
} else {
console.log("Failed to get all sessionData. Error: " + JSON.stringify(asyncResult.error));
}
});
subject
Obtém ou define a descrição que aparece no campo de assunto de um item.
A propriedade subject
obtém ou define o assunto completo do item, conforme enviado pelo servidor de email.
A propriedade subject
retorna um objeto Subject
que fornece métodos para obter e definir o assunto.
subject: Subject;
Valor da propriedade
Comentários
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-subject-compose.yaml
Office.context.mailbox.item.subject.getAsync((result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Action failed with message ${result.error.message}`);
return;
}
console.log(`Subject: ${result.value}`);
});
...
let subject = "Hello World!";
Office.context.mailbox.item.subject.setAsync(subject, (result) => {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Action failed with message ${result.error.message}`);
return;
}
console.log(`Successfully set subject to ${subject}`);
});
to
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 propriedade to
retorna um objeto Recipients
que fornece métodos para obter ou atualizar os destinatários na linha Para da mensagem. No entanto, dependendo do cliente/plataforma (ou seja, Windows, Mac, etc.), podem aplicar-se limites ao número de destinatários que pode obter ou atualizar. Veja o objeto Destinatários para obter mais detalhes.
to: Recipients;
Valor da propriedade
Comentários
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
Office.context.mailbox.item.to.setAsync( ['alice@contoso.com', 'bob@contoso.com'] );
Office.context.mailbox.item.to.addAsync( ['jason@contoso.com'] );
Office.context.mailbox.item.to.getAsync(callback);
function callback(asyncResult) {
const arrayOfToRecipients = asyncResult.value;
}
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-to-message-compose.yaml
Office.context.mailbox.item.to.getAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const msgTo = asyncResult.value;
console.log("Message being sent to:");
for (let i = 0; i < msgTo.length; i++) {
console.log(msgTo[i].displayName + " (" + msgTo[i].emailAddress + ")");
}
} else {
console.error(asyncResult.error);
}
});
...
const email = $("#emailTo")
.val()
.toString();
const emailArray = [email];
Office.context.mailbox.item.to.setAsync(emailArray, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Succeeded in setting To field.");
} else {
console.error(asyncResult.error);
}
});
Detalhes do método
addFileAttachmentAsync(uri, attachmentName, options, callback)
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo.
O método addFileAttachmentAsync
carrega o arquivo no URI especificado e anexa-o ao item no formulário de composição.
addFileAttachmentAsync(uri: string, attachmentName: string, options: Office.AsyncContextOptions & { isInline: boolean }, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- uri
-
string
O URI que fornece o local do arquivo anexado à mensagem ou compromisso. O comprimento máximo é de 2048 caracteres.
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- options
-
Office.AsyncContextOptions & { isInline: boolean }
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.
isInline
: se for verdadeiro, indica que o anexo será apresentado inline como uma imagem no corpo da mensagem e não será apresentado na lista de anexos.
- 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 do tipo Office.AsyncResult
. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao carregar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
Este método não é suportado no Outlook para iOS ou Android. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Nas compilações recentes do Outlook clássico no Windows, foi introduzido um erro que acrescenta incorretamente um
Authorization: Bearer
cabeçalho a esta ação (quer esteja a utilizar esta API ou a IU do Outlook). Para contornar este problema, utilize a API introduzida com oaddFileAttachmentFromBase64
conjunto de requisitos 1.8.O URI do ficheiro a anexar tem de suportar a colocação em cache na produção. O servidor que aloja a imagem não deve devolver um
Cache-Control
cabeçalho que especifiqueno-cache
,no-store
ou opções semelhantes na resposta HTTP. No entanto, quando estiver a desenvolver o suplemento e a fazer alterações aos ficheiros, a colocação em cache pode impedi-lo de ver as suas alterações. Recomendamos a utilização deCache-Control
cabeçalhos durante o desenvolvimento.Pode utilizar o mesmo URI com o
removeAttachmentAsync
método para remover o anexo na mesma sessão.
Erros:
AttachmentSizeExceeded
: o anexo é maior do que o permitido.FileTypeNotSupported
: o anexo tem uma extensão que não é permitida.NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml
const attachmentUrl = $("#attachmentUrl")
.val()
.toString();
Office.context.mailbox.item.addFileAttachmentAsync(
attachmentUrl,
getFileName(attachmentUrl),
{ isInline: false },
(result) => {
console.log(result);
}
);
addFileAttachmentAsync(uri, attachmentName, callback)
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo.
O método addFileAttachmentAsync
carrega o arquivo no URI especificado e anexa-o ao item no formulário de composição.
addFileAttachmentAsync(uri: string, attachmentName: string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- uri
-
string
O URI que fornece o local do arquivo anexado à mensagem ou compromisso. O comprimento máximo é de 2048 caracteres.
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- 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 do tipo Office.AsyncResult
. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao carregar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
Este método não é suportado no Outlook para iOS ou Android. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Nas compilações recentes do Outlook clássico no Windows, foi introduzido um erro que acrescenta incorretamente um
Authorization: Bearer
cabeçalho a esta ação (quer esteja a utilizar esta API ou a IU do Outlook). Para contornar este problema, utilize a API introduzida com oaddFileAttachmentFromBase64
conjunto de requisitos 1.8.O URI do ficheiro a anexar tem de suportar a colocação em cache na produção. O servidor que aloja a imagem não deve devolver um
Cache-Control
cabeçalho que especifiqueno-cache
,no-store
ou opções semelhantes na resposta HTTP. No entanto, quando estiver a desenvolver o suplemento e a fazer alterações aos ficheiros, a colocação em cache pode impedi-lo de ver as suas alterações. Recomendamos a utilização deCache-Control
cabeçalhos durante o desenvolvimento.Pode utilizar o mesmo URI com o
removeAttachmentAsync
método para remover o anexo na mesma sessão.
Erros:
AttachmentSizeExceeded
: o anexo é maior do que o permitido.FileTypeNotSupported
: o anexo tem uma extensão que não é permitida.NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
addFileAttachmentFromBase64Async(base64File, attachmentName, options, callback)
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo.
O addFileAttachmentFromBase64Async
método carrega o ficheiro a partir da codificação Base64 e anexa-o ao item no formulário de composição. Este método devolve o identificador de anexo no asyncResult.value
objeto .
Posteriormente, você poderá usar o identificador com o método removeAttachmentAsync
para remover o anexo na mesma sessão.
addFileAttachmentFromBase64Async(base64File: string, attachmentName: string, options: Office.AsyncContextOptions & { isInline: boolean }, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- base64File
-
string
O conteúdo codificado com Base64 de uma imagem ou ficheiro a adicionar a um e-mail ou evento. O comprimento máximo da cadeia codificada é de 27 892 122 carateres (cerca de 25 MB).
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- options
-
Office.AsyncContextOptions & { isInline: boolean }
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.
isInline
: se for verdadeiro, indica que o anexo será apresentado inline como uma imagem no corpo da mensagem e não será apresentado na lista de anexos.
- 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 do tipo Office.AsyncResult. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao carregar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
A adição de um ficheiro Inline Base64 a uma mensagem no modo de composição é suportada no Outlook no Android e no 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.
Se estiver a utilizar uma API de URL de dados (por exemplo,
readAsDataURL
), terá de retirar o prefixo do URL de dados e, em seguida, enviar o resto da cadeia para esta API. Por exemplo, se a cadeia completa for representada pordata:image/svg+xml;base64,<rest of Base64 string>
, removadata:image/svg+xml;base64,
.Se estiver a adicionar uma imagem base64 inline ao corpo de uma mensagem ou compromisso que está a ser composto, primeiro tem de obter o corpo do item atual com o método Office.context.mailbox.item.body.getAsync antes de inserir a imagem com
addFileAttachmentFromBase64Async
. Caso contrário, a imagem não será composta no corpo depois de ser inserida. Para obter mais orientações, consulte Anexar um ficheiro.
Erros:
AttachmentSizeExceeded
: o anexo é maior do que o permitido.FileTypeNotSupported
: o anexo tem uma extensão que não é permitida.NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml
const base64String =
"iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAACXBIWXMAAAsSAAALEgHS3X78AAACRUlEQVRYw82XzXHbMBCFP2F8tzsQc8Ixyh0zoiuIXIGdCsxUYKqC0B04FdiuwMoM7mGOOIXqQGoAymXhgSX+itJM9kIRFLAP+3YXD5Pdbscx5oxaAIW8Ztr6l2PWmQwF4IyaieP53qdfAqQ8CwBn1JU4vpWhrbxXQA5MZfynANmcDIAzKgcy4FKGXsVJFf3nLgKyBQptfT4KQMRz2N0fcbxqmRMDWXflx0VPnrdArq0vekQ1Dv0UeHZGNebHhwjU8AzwKM43RyZnbAf58Q6ghudeWd0Aus0+5EcMIIRi3beua0D3Nm39BEAx3i7HTK4DEBJn5YxKOnaRA5+ErpMBWMpzDvx1RuXCcxOISlufAjfC7zgAsqsvUvMAD0ApPaEtGi9AIlUzKgJo60tt/SyKRkzLrAXERluf7W1gOICWaMyB386oooOWsIHvXbSoHuUSFovtHqicUVnH3EJoeT0aQEf5/XBGlc6otIOWBXAtPeZkAIJ9Bt6cUU9tZautX2nrk3MACHYr1ZKProKRtDw4o8pzAPjWo+NtpXTTvoteDDg8noDAcwbcRedAkGdFXyk2GEDcegVAFp2gyVDHjRQ4o6q2smoqtR5Hd+qMqtoALCWUUymr1m43QMZfOaMK4C0SrMsDANJ2E5FNcbdbjHC+ENl+H0myJFbLtaq4Rt8dyPBYRQV1E40nMv9rl7xrOw3DGb+Whcqu3i/OM6CUOWvgRlufNmnLYy4m77uJI7AXtdNcTDrU71LEyv7v01/N/ovL6bmu5/8A1tNWZldH0W4AAAAASUVORK5CYII=";
Office.context.mailbox.item.addFileAttachmentFromBase64Async(
base64String,
"logo.png",
{ isInline: false },
(result) => {
console.log(result);
}
);
...
// Set the signature for the current item with inline image.
const modIcon1Base64 = "iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAYAAAByDd+UAAAAGXRFWHRTb2Z0d2FyZQBBZG9iZSBJbWFnZVJlYWR5ccllPAAAA2ZpVFh0WE1MOmNvbS5hZG9iZS54bXAAAAAAADw/eHBhY2tldCBiZWdpbj0i77u/IiBpZD0iVzVNME1wQ2VoaUh6cmVTek5UY3prYzlkIj8+IDx4OnhtcG1ldGEgeG1sbnM6eD0iYWRvYmU6bnM6bWV0YS8iIHg6eG1wdGs9IkFkb2JlIFhNUCBDb3JlIDUuMC1jMDYxIDY0LjE0MDk0OSwgMjAxMC8xMi8wNy0xMDo1NzowMSAgICAgICAgIj4gPHJkZjpSREYgeG1sbnM6cmRmPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5LzAyLzIyLXJkZi1zeW50YXgtbnMjIj4gPHJkZjpEZXNjcmlwdGlvbiByZGY6YWJvdXQ9IiIgeG1sbnM6eG1wTU09Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC9tbS8iIHhtbG5zOnN0UmVmPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvc1R5cGUvUmVzb3VyY2VSZWYjIiB4bWxuczp4bXA9Imh0dHA6Ly9ucy5hZG9iZS5jb20veGFwLzEuMC8iIHhtcE1NOk9yaWdpbmFsRG9jdW1lbnRJRD0ieG1wLmRpZDpDRDMxMDg1MjBCNDZFMTExODE2MkM1RUI2M0M4MDYxRCIgeG1wTU06RG9jdW1lbnRJRD0ieG1wLmRpZDpFMTUxQjgyRjQ2MEQxMUUxODlFMkQwNTYzQ0YwMTUxMiIgeG1wTU06SW5zdGFuY2VJRD0ieG1wLmlpZDpFMTUxQjgyRTQ2MEQxMUUxODlFMkQwNTYzQ0YwMTUxMiIgeG1wOkNyZWF0b3JUb29sPSJBZG9iZSBQaG90b3Nob3AgQ1M1LjEgV2luZG93cyI+IDx4bXBNTTpEZXJpdmVkRnJvbSBzdFJlZjppbnN0YW5jZUlEPSJ4bXAuaWlkOkQxMzEwODUyMEI0NkUxMTE4MTYyQzVFQjYzQzgwNjFEIiBzdFJlZjpkb2N1bWVudElEPSJ4bXAuZGlkOkNEMzEwODUyMEI0NkUxMTE4MTYyQzVFQjYzQzgwNjFEIi8+IDwvcmRmOkRlc2NyaXB0aW9uPiA8L3JkZjpSREY+IDwveDp4bXBtZXRhPiA8P3hwYWNrZXQgZW5kPSJyIj8+uC/WfAAAAehJREFUeNpilCzfwEAEkAbiECA2A2J1IOaHin8E4ptAfBaIVwLxU0IGMRKw0B6IW4DYhoE4cASIK6E0VsCEQ1wUiNcB8QESLGOAqj0MxBuhZhBloS4QnwHiQAbygR/UDF1CFupCXSjHQDmQg5qli8tCUBBsQUoQ1AD8UDNFsVk4n0o+w+bT+egWglKjNymmeGhLkqLcG2oHAwtUoIuQDj5OVgZPLUmwRe5aEmAxqYqNpFgKssOcCeplM0KqdST5GfpDDRm0JfkYrj3/SE7QguyQY4ImYYLgCtAS10kHGMw6dzNsv/qC7OwCClJXYlR++v6b4er3j5QmIFcmaNlIL6AOslCIjhYKMTHQGTBBqxh6gXcgC6/R0cKbIAv30dHCfaAKGJTxHxJSqS3Fz9DkowNmywpyMcgA8fF7b8D8VWcfM6w8+4gYC+VB+RCk8hSh0gaUD4/dewvlvUWRe/z+GzGWgex4BGtiOAHxXhoHpzMoSGHZAhSPW2lo2VZYWkHOh4nEtLrIAE+hZmNUwK+B2BOIv1PRsu9QM1/jatNcBtVZ0IREKXgENesyoVYbzNIdFFi2A5tl+NqlL6BB4QBNzsSCU1A9nlAzMAALAQMOQl0qB23qWwKxIlIrDBQ394H4OBCvISYqAAIMACVibHDqsO7zAAAAAElFTkSuQmCC";
Office.context.mailbox.item.addFileAttachmentFromBase64Async(
modIcon1Base64,
"myImage.png",
{ isInline: true },
function(result) {
if (result.status == Office.AsyncResultStatus.Succeeded) {
const signature = $("#signature").val() + "<img src='cid:myImage.png'>";
console.log(`Setting signature to "${signature}".`);
Office.context.mailbox.item.body.setSignatureAsync(
signature,
{ coercionType: "html" },
function(asyncResult) {
console.log(`setSignatureAsync: ${asyncResult.status}`);
}
);
} else {
console.error(`addFileAttachmentFromBase64Async: ${result.error}`);
}
}
);
addFileAttachmentFromBase64Async(base64File, attachmentName, callback)
Adiciona um arquivo a uma mensagem ou um compromisso como um anexo.
O addFileAttachmentFromBase64Async
método carrega o ficheiro a partir da codificação Base64 e anexa-o ao item no formulário de composição. Este método devolve o identificador de anexo no asyncResult.value
objeto .
Posteriormente, você poderá usar o identificador com o método removeAttachmentAsync
para remover o anexo na mesma sessão.
addFileAttachmentFromBase64Async(base64File: string, attachmentName: string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- base64File
-
string
O conteúdo codificado com Base64 de uma imagem ou ficheiro a adicionar a um e-mail ou evento. O comprimento máximo da cadeia codificada é de 27 892 122 carateres (cerca de 25 MB).
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- 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 do tipo Office.AsyncResult. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao carregar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
A adição de um ficheiro Inline Base64 a uma mensagem no modo de composição é suportada no Outlook no Android e no 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.
Se estiver a utilizar uma API de URL de dados (por exemplo,
readAsDataURL
), terá de retirar o prefixo do URL de dados e, em seguida, enviar o resto da cadeia para esta API. Por exemplo, se a cadeia completa for representada pordata:image/svg+xml;base64,<rest of Base64 string>
, removadata:image/svg+xml;base64,
.Se estiver a adicionar uma imagem base64 inline ao corpo de uma mensagem ou compromisso que está a ser composto, primeiro tem de obter o corpo do item atual com o método Office.context.mailbox.item.body.getAsync antes de inserir a imagem com
addFileAttachmentFromBase64Async
. Caso contrário, a imagem não será composta no corpo depois de ser inserida. Para obter mais orientações, consulte Anexar um ficheiro.
Erros:
AttachmentSizeExceeded
: o anexo é maior do que o permitido.FileTypeNotSupported
: o anexo tem uma extensão que não é permitida.NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
addHandlerAsync(eventType, handler, options, callback)
Adiciona um manipulador de eventos a um evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas.
Para eventos suportados, veja a secção Eventos do modelo de objeto de item.
addHandlerAsync(eventType: Office.EventType | string, handler: any, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- eventType
-
Office.EventType | string
O evento que deve invocar o manipulador.
- handler
-
any
A função para manipular o evento. A função deve aceitar um parâmetro exclusivo, que é um objeto literal. A type
propriedade no parâmetro corresponderá ao eventType
parâmetro transmitido a addHandlerAsync
.
- 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
[ Conjunto de API: Caixa de Correio 1.7 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
function myHandlerFunction(eventarg) {
if (eventarg.attachmentStatus === Office.MailboxEnums.AttachmentStatus.Added) {
const attachment = eventarg.attachmentDetails;
console.log("Event Fired and Attachment Added!");
getAttachmentContentAsync(attachment.id, options, callback);
}
}
Office.context.mailbox.item.addHandlerAsync(Office.EventType.AttachmentsChanged, myHandlerFunction, myCallback);
addHandlerAsync(eventType, handler, callback)
Adiciona um manipulador de eventos a um evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas.
Para eventos suportados, veja a secção Eventos do modelo de objeto de item.
addHandlerAsync(eventType: Office.EventType | string, handler: any, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- eventType
-
Office.EventType | string
O evento que deve invocar o manipulador.
- handler
-
any
A função para manipular o evento. A função deve aceitar um parâmetro exclusivo, que é um objeto literal. A type
propriedade no parâmetro corresponderá ao eventType
parâmetro transmitido a addHandlerAsync
.
- 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
[ Conjunto de API: Caixa de Correio 1.7 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
addItemAttachmentAsync(itemId, attachmentName, options, callback)
Adiciona um item do Exchange, como uma mensagem, como anexo na mensagem ou no compromisso.
O método addItemAttachmentAsync
anexa o item com o identificador do Exchange especificado ao item no formulário de composição. Se especificar uma função de chamada de retorno, o método é chamado com um parâmetro, asyncResult
, que contém o identificador do anexo ou um código que indica qualquer erro que tenha ocorrido ao anexar o item. Pode utilizar o parâmetro de opções para transmitir informações de estado para a função de chamada de retorno, se necessário.
Posteriormente, você poderá usar o identificador com o método removeAttachmentAsync
para remover o anexo na mesma sessão.
Se o seu Suplemento do Office estiver em execução no Outlook na Web ou no novo Outlook no Windows, o addItemAttachmentAsync
método pode anexar itens a itens diferentes do item que está a editar. No entanto, isto não é suportado e não é recomendado.
addItemAttachmentAsync(itemId: any, attachmentName: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- itemId
-
any
O identificador do Exchange do item a anexar. O comprimento máximo é de 100 caracteres.
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- 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 do tipo Office.AsyncResult
. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao adicionar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
-
NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
Exemplos
// The following example adds an existing Outlook item as an attachment
// with the name "My Attachment".
function addAttachment() {
// EWS ID of item to attach (shortened for readability).
const itemId = "AAMkADI1...AAA=";
// The values in asyncContext can be accessed in the callback.
const options = { asyncContext: { var1: 1, var2: 2 } };
Office.context.mailbox.item.addItemAttachmentAsync(itemId, "My Attachment", options, (result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error("Failed to add attachment: " + result.error.message);
return;
}
console.log("Attachment added successfully.");
console.log("var1: " + result.asyncContext.var1);
console.log("var2: " + result.asyncContext.var2);
});
}
addItemAttachmentAsync(itemId, attachmentName, callback)
Adiciona um item do Exchange, como uma mensagem, como anexo na mensagem ou no compromisso.
O método addItemAttachmentAsync
anexa o item com o identificador do Exchange especificado ao item no formulário de composição. Se especificar uma função de chamada de retorno, o método é chamado com um parâmetro, asyncResult
, que contém o identificador do anexo ou um código que indica qualquer erro que tenha ocorrido ao anexar o item. Pode utilizar o parâmetro de opções para transmitir informações de estado para a função de chamada de retorno, se necessário.
Posteriormente, você poderá usar o identificador com o método removeAttachmentAsync
para remover o anexo na mesma sessão.
Se o seu Suplemento do Office estiver em execução no Outlook na Web ou no novo Outlook no Windows, o addItemAttachmentAsync
método pode anexar itens a itens diferentes do item que está a editar. No entanto, isto não é suportado e não é recomendado.
addItemAttachmentAsync(itemId: any, attachmentName: string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- itemId
-
any
O identificador do Exchange do item a anexar. O comprimento máximo é de 100 caracteres.
- attachmentName
-
string
O nome do anexo que é mostrado enquanto o anexo está sendo carregado. O tamanho máximo é de 255 caracteres.
- 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 do tipo Office.AsyncResult
. Em caso de êxito, o identificador do anexo será fornecido na propriedade asyncResult.value
. Se houver falha ao adicionar o anexo, o objeto asyncResult
conterá um objeto Error
que fornece uma descrição do erro.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
-
NumberOfAttachmentsExceeded
: a mensagem ou compromisso tem demasiados anexos.
close()
Fecha o item atual que está sendo composto.
O comportamento do método close
depende do estado atual do item que está sendo redigido. Se o item tiver alterações não guardadas, o cliente pede ao utilizador para guardar, eliminar ou fechar a ação.
No Outlook no Windows (clássico) e no Mac, o close
método não tem qualquer efeito numa resposta no Painel de Leitura.
close(): void;
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.3 ]
Nível mínimo de permissão: restrito
Modo Outlook aplicável: mensagem Compose
Importante: no Outlook na Web e no novo Outlook no Windows, se o item for um compromisso e tiver sido guardado anteriormente com saveAsync
o , é pedido ao utilizador que guarde, elimine ou cancele mesmo que não tenham ocorrido alterações desde a última vez que o item foi guardado.
Sugestão: utilize o método closeAsync em vez do close
método se pretender que o suplemento:
Elimine automaticamente uma mensagem que está a ser composta sem pedir ao utilizador com a caixa de diálogo guardar.
Determinar quando um utilizador cancela a caixa de diálogo guardar item numa mensagem que está a ser composta.
Feche uma resposta no Painel de Leitura ou num rascunho existente.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/25-item-save-and-close/close.yaml
Office.context.mailbox.item.close();
closeAsync(options, callback)
Fecha a mensagem atual que está a ser composta com a opção de eliminar alterações não guardadas. A mensagem que está a ser composta pode ser uma nova mensagem, resposta ou um rascunho existente.
closeAsync(options: Office.AsyncContextOptions & { discardItem: boolean }, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- options
-
Office.AsyncContextOptions & { discardItem: boolean }
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.
discardItem
: se true
, a mensagem atual que está a ser composta for fechada e as alterações não guardadas forem eliminadas. Quando o parâmetro não é declarado ou está definido como false
, é apresentada uma caixa de diálogo guardar a pedir ao utilizador para guardar um rascunho, rejeitar alterações ou cancelar a operação. Este comportamento ocorre para novas mensagens e respostas retiradas do Painel de Leitura. Se quiser fechar uma resposta no Painel de Leitura ou num rascunho existente, tem de definir discardItem
como true
. Caso contrário, a chamada devolverá um erro. Para obter mais informações sobre o erro, consulte a secção Observações.
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Opcional. 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.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.14 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
The operation was cancelled by the user
: o utilizador seleciona Cancelar na caixa de diálogo guardar e adiscardItem
propriedade não está definida ou está definida comofalse
.The operation is not supported
: ocloseAsync
método tenta fechar uma resposta no Painel de Leitura ou num rascunho existente e adiscardItem
propriedade não está definida ou está definida comofalse
.
closeAsync(callback)
Fecha a nova mensagem atual que está a ser composta.
O comportamento de uma nova mensagem a ser composta depende se a mensagem contém alterações não guardadas. Se não tiverem sido efetuadas alterações, a mensagem será fechada sem uma caixa de diálogo guardar. Por outro lado, se a mensagem contiver alterações não guardadas, é apresentada uma caixa de diálogo guardar a pedir ao utilizador para guardar um rascunho, rejeitar alterações ou cancelar a operação.
closeAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Opcional. 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.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.14 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
The operation was cancelled by the user
: o utilizador seleciona Cancelar na caixa de diálogo guardar.The operation is not supported
: ocloseAsync
método tenta fechar uma resposta no Painel de Leitura ou num rascunho existente.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/25-item-save-and-close/close-async.yaml
// This snippet closes the current message being composed and discards any unsaved changes when the optional property, discardItem, is set to true.
// The API call works on a new message being composed, a reply, or an existing draft.
// When discardItem is set to false or isn't defined on a new message with unsaved changes, the user is prompted to save a draft, discard the changes, or cancel the close operation.
Office.context.mailbox.item.closeAsync(
{ discardItem: true },
(asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log("Action failed with error: " + asyncResult.error.message);
return;
}
});
disableClientSignatureAsync(options, callback)
Desativa a assinatura de cliente do Outlook.
O comportamento deste método depende do cliente que o suplemento está a executar.
No Outlook na Web e no novo Outlook no Windows, a opção de assinatura para novos e-mails, respostas e reencaminhamentos está desativada. Uma assinatura selecionada também é desativada pelo método .
No Outlook no Windows (clássico) e no Mac, a assinatura nas secções Novas mensagens e Respostas/reencaminhamentos da conta de envio está definida como (nenhuma).
No Outlook para Android e no iOS, a assinatura guardada no dispositivo móvel é desmarcada.
disableClientSignatureAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => 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<void>) => void
Opcional. 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.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante: este método é suportado no Message Compose no Outlook para Android e no iOS a partir da Versão 4.2352.0. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/work-with-client-signatures.yaml
// Disable the client signature.
Office.context.mailbox.item.disableClientSignatureAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("disableClientSignatureAsync succeeded");
} else {
console.error(asyncResult.error);
}
});
disableClientSignatureAsync(callback)
Desativa a assinatura de cliente do Outlook.
O comportamento deste método depende do cliente que o suplemento está a executar.
No Outlook na Web e no novo Outlook no Windows, a opção de assinatura para novos e-mails, respostas e reencaminhamentos está desativada. Uma assinatura selecionada também é desativada pelo método .
No Outlook no Windows (clássico) e no Mac, a assinatura nas secções Novas mensagens e Respostas/reencaminhamentos da conta de envio está definida como (nenhuma).
No Outlook para Android e no iOS, a assinatura guardada no dispositivo móvel é desmarcada.
disableClientSignatureAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
Opcional. 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.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante: este método é suportado no Message Compose no Outlook para Android e no iOS a partir da Versão 4.2352.0. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
getAttachmentContentAsync(attachmentId, options, callback)
Obtém um anexo de uma mensagem ou compromisso e devolve-o como um AttachmentContent
objeto.
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 getAttachmentsAsync
chamada e, em seguida, na mesma sessão, utilizar esse identificador para obter o anexo. 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.
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
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
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.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/get-attachment-content.yaml
// Gets the attachments of the current message or appointment in compose mode.
const options = { asyncContext: { currentItem: item } };
// The getAttachmentsAsync call can only be used in compose mode.
item.getAttachmentsAsync(options, callback);
function callback(result) {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
if (result.value.length <= 0) {
console.log("Mail item has no attachments.");
return;
}
for (let i = 0; i < result.value.length; i++) {
// Log the attachment type and its contents to the console.
result.asyncContext.currentItem.getAttachmentContentAsync(result.value[i].id, handleAttachmentsCallback);
}
}
getAttachmentContentAsync(attachmentId, callback)
Obtém um anexo de uma mensagem ou compromisso e devolve-o como um AttachmentContent
objeto.
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 getAttachmentsAsync
chamada e, em seguida, na mesma sessão, utilizar esse identificador para obter o anexo. 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.
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
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
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
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.
getAttachmentsAsync(options, callback)
Obtém os anexos do item como uma matriz.
getAttachmentsAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<AttachmentDetailsCompose[]>) => 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.AttachmentDetailsCompose[]>) => void
Opcional. 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
. Se a chamada falhar, a asyncResult.error
propriedade conterá um código de erro com o motivo da falha.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml
Office.context.mailbox.item.getAttachmentsAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error(result.error.message);
return;
}
if (result.value.length > 0) {
for (let i = 0; i < result.value.length; i++) {
const attachment = result.value[i];
let attachmentType;
switch (attachment.attachmentType) {
case Office.MailboxEnums.AttachmentType.Cloud:
attachmentType = "Attachment is stored in a cloud location";
break;
case Office.MailboxEnums.AttachmentType.File:
attachmentType = "Attachment is a file";
break;
case Office.MailboxEnums.AttachmentType.Item:
attachmentType = "Attachment is an Exchange item";
break;
}
console.log(
"ID: " +
attachment.id +
"\n" +
"Type: " +
attachmentType +
"\n" +
"Name: " +
attachment.name +
"\n" +
"Size: " +
attachment.size +
"\n" +
"isInline: " +
attachment.isInline
);
}
} else {
console.log("No attachments on this message.");
}
});
getAttachmentsAsync(callback)
Obtém os anexos do item como uma matriz.
getAttachmentsAsync(callback?: (asyncResult: Office.AsyncResult<AttachmentDetailsCompose[]>) => void): void;
Parâmetros
- callback
-
(asyncResult: Office.AsyncResult<Office.AttachmentDetailsCompose[]>) => void
Opcional. 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
. Se a chamada falhar, a asyncResult.error
propriedade conterá um código de erro com o motivo da falha.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
getComposeTypeAsync(options, callback)
Especifica o tipo de composição de mensagens e o respetivo tipo de coação. A mensagem pode ser nova ou responder ou reencaminhar. O tipo de coerção pode ser HTML ou texto simples.
getComposeTypeAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<any>) => 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<any>) => 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, a asyncResult.value
propriedade contém um objeto com o tipo de composição e o tipo de coação do item.
Retornos
void
Um objeto com ComposeType
e CoercionType
enumerar valores para o item de mensagem.
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante: este método é suportado no Outlook para Android e no iOS a partir da Versão 4.2352.0. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
getComposeTypeAsync(callback)
Especifica o tipo de composição de mensagens e o respetivo tipo de coação. A mensagem pode ser nova ou responder ou reencaminhar. O tipo de coerção pode ser HTML ou texto simples.
getComposeTypeAsync(callback: (asyncResult: Office.AsyncResult<any>) => void): void;
Parâmetros
- callback
-
(asyncResult: Office.AsyncResult<any>) => 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, a asyncResult.value
propriedade contém um objeto com o tipo de composição e o tipo de coação do item.
Retornos
void
Um objeto com ComposeType
e CoercionType
enumerar valores para o item de mensagem.
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante: este método é suportado no Outlook para Android e no iOS a partir da Versão 4.2352.0. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/work-with-client-signatures.yaml
// Get the compose type of the current message.
Office.context.mailbox.item.getComposeTypeAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log(
"getComposeTypeAsync succeeded with composeType: " +
asyncResult.value.composeType +
" and coercionType: " +
asyncResult.value.coercionType
);
} else {
console.error(asyncResult.error);
}
});
getConversationIndexAsync(options, callback)
Obtém a posição codificada em Base64 da mensagem atual num tópico de conversação.
getConversationIndexAsync(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, asyncResult
, que é um Office.AsyncResult
objeto. A posição codificada com Base64 da mensagem atual numa conversação é devolvida na asyncResult.value
propriedade .
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: mensagem Compose
Sugestão: pode utilizar o índice de conversação para localizar uma mensagem num tópico de conversação. Em seguida, utilize o respetivo conteúdo para fornecer contexto para a mensagem atual que está a ser composta.
getConversationIndexAsync(callback)
Obtém a posição codificada em Base64 da mensagem atual num tópico de conversação.
getConversationIndexAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- 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, asyncResult
, que é um Office.AsyncResult
objeto. A posição codificada com Base64 da mensagem atual numa conversação é devolvida na asyncResult.value
propriedade .
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: mensagem Compose
Sugestão: pode utilizar o índice de conversação para localizar uma mensagem num tópico de conversação. Em seguida, utilize o respetivo conteúdo para fornecer contexto para a mensagem atual que está a ser composta.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-conversation-index.yaml
// This snippet returns the Base64-encoded position of the current message in a conversation thread (PR_CONVERSATION_INDEX).
// The API call is supported on a message being composed and isn't supported on read items or appointments.
Office.context.mailbox.item.getConversationIndexAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
const conversationIndex = result.value;
if (conversationIndex) {
console.log("Position in the conversation thread: " + conversationIndex);
} else {
console.log("The current message doesn't belong to a conversation thread.");
}
});
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
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Get the initialization context (if present).
Office.context.mailbox.item.getInitializationContextAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
if (asyncResult.value.length > 0) {
// The value is a string, parse to an object.
const context = JSON.parse(asyncResult.value);
// Do something with context.
} else {
// Empty context, treat as no context.
}
} else {
// Handle the error.
}
});
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
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
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
getItemClassAsync(options, callback)
Obtém a classe de item exchange Web Services da mensagem selecionada.
getItemClassAsync(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, asyncResult
, que é um Office.AsyncResult
objeto. A classe da mensagem é devolvida na asyncResult.value
propriedade .
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: mensagem Compose
Importante:
A tabela seguinte lista as classes de mensagens predefinidas.
Classe item | Descrição |
---|---|
O IPM. Nota | Novas mensagens e respostas a mensagens |
O IPM. Note.SMIME | Mensagens encriptadas que também podem ser assinadas |
O IPM. Note.SMIME.MultipartSigned | Mensagens com assinatura não criptografada |
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 |
getItemClassAsync(callback)
Obtém a classe de item exchange Web Services da mensagem selecionada.
getItemClassAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- 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, asyncResult
, que é um Office.AsyncResult
objeto. A classe da mensagem é devolvida na asyncResult.value
propriedade .
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: mensagem Compose
Importante:
A tabela seguinte lista as classes de mensagens predefinidas.
Classe item | Descrição |
---|---|
O IPM. Nota | Novas mensagens e respostas a mensagens |
O IPM. Note.SMIME | Mensagens encriptadas que também podem ser assinadas |
O IPM. Note.SMIME.MultipartSigned | Mensagens com assinatura não criptografada |
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 |
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-item-class-async.yaml
// This snippet returns the Exchange Web Services item class property (PR_MESSAGE_CLASS) of the current message.
// The API call is only supported on a message being composed.
Office.context.mailbox.item.getItemClassAsync((asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.log("Action failed with error: " + asyncResult.error.message);
return;
}
console.log("Item class of the current message: " + asyncResult.value);
});
getItemIdAsync(options, callback)
De forma assíncrona, obtém o identificador de item dos Serviços Web exchange (EWS) de um item guardado.
Quando invocado, este método devolve o ID do item através da função de chamada de retorno.
getItemIdAsync(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
. O ID do item EWS do item é devolvido na asyncResult.value
propriedade .
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante:
O ID do item devolvido não é idêntico 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
.Se o seu suplemento chamar
getItemIdAsync
(por exemplo, para obter um ID de item para utilizar com o EWS ou a API REST), tenha em atenção que, quando o Outlook está em modo de cache, poderá demorar algum tempo até que o item seja sincronizado com o servidor. Até o item ser sincronizado, o ID do item não é reconhecido e a sua utilização devolve um erro.
Erros:
-
ItemNotSaved
: o ID não pode ser obtido até que o item seja guardado.
getItemIdAsync(callback)
De forma assíncrona, obtém o identificador de item dos Serviços Web exchange (EWS) de um item guardado.
Quando invocado, este método devolve o ID do item através da função de chamada de retorno.
getItemIdAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- 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
. O ID do item EWS do item é devolvido na asyncResult.value
propriedade .
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.8 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Importante:
O ID do item devolvido não é idêntico 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
.Se o seu suplemento chamar
getItemIdAsync
(por exemplo, para obter um ID de item para utilizar com o EWS ou a API REST), tenha em atenção que, quando o Outlook está em modo de cache, poderá demorar algum tempo até que o item seja sincronizado com o servidor. Até o item ser sincronizado, o ID do item não é reconhecido e a sua utilização devolve um erro.
Erros:
-
ItemNotSaved
: o ID não pode ser obtido até que o item seja guardado.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/item-id-compose.yaml
Office.context.mailbox.item.getItemIdAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error(`getItemIdAsync failed with message: ${result.error.message}`);
return;
}
console.log(result.value);
});
getSelectedDataAsync(coercionType, options, callback)
Retorna de forma assíncrona os dados selecionados do assunto ou do corpo de uma mensagem.
Se não houver seleção, mas o cursor estiver no corpo ou assunto, o método devolve uma cadeia vazia para os dados selecionados. Se um campo que não seja o corpo ou o assunto estiver selecionado, o método retorna o erro InvalidSelection
.
Para aceder aos dados selecionados a partir da função de chamada de retorno, chame asyncResult.value.data
. Para aceder à propriedade de origem da qual a seleção provém, chame asyncResult.value.sourceProperty
, que será body
ou subject
.
getSelectedDataAsync(coercionType: Office.CoercionType | string, options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<any>) => void): void;
Parâmetros
- coercionType
-
Office.CoercionType | string
Solicita um formato para os dados. Se Text
, o método devolve o texto simples como uma cadeia, removendo todas as etiquetas HTML presentes. Se Html
, o método devolve o texto selecionado, quer seja texto simples ou HTML.
- 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<any>) => 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
.
Retornos
void
Os dados selecionados como uma cadeia com formato determinado por coercionType
.
Comentários
[ Conjunto de API: Caixa de Correio 1.2 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Get selected data.
Office.context.mailbox.item.getSelectedDataAsync(Office.CoercionType.Text, { option1: "option1"}, getCallback);
function getCallback(asyncResult) {
const text = asyncResult.value.data;
const prop = asyncResult.value.sourceProperty;
console.log(`Selected text in ${prop}: ${text}`);
}
getSelectedDataAsync(coercionType, callback)
Retorna de forma assíncrona os dados selecionados do assunto ou do corpo de uma mensagem.
Se não houver seleção, mas o cursor estiver no corpo ou assunto, o método devolve uma cadeia vazia para os dados selecionados. Se um campo que não seja o corpo ou o assunto estiver selecionado, o método retorna o erro InvalidSelection
.
Para aceder aos dados selecionados a partir da função de chamada de retorno, chame asyncResult.value.data
. Para aceder à propriedade de origem da qual a seleção provém, chame asyncResult.value.sourceProperty
, que será body
ou subject
.
getSelectedDataAsync(coercionType: Office.CoercionType | string, callback: (asyncResult: Office.AsyncResult<any>) => void): void;
Parâmetros
- coercionType
-
Office.CoercionType | string
Solicita um formato para os dados. Se Text
, o método devolve o texto simples como uma cadeia, removendo todas as etiquetas HTML presentes. Se Html
, o método devolve o texto selecionado, quer seja texto simples ou HTML.
- callback
-
(asyncResult: Office.AsyncResult<any>) => 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
.
Retornos
void
Os dados selecionados como uma cadeia com formato determinado por coercionType
.
Comentários
[ Conjunto de API: Caixa de Correio 1.2 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/get-selected-data.yaml
Office.context.mailbox.item.getSelectedDataAsync(Office.CoercionType.Text, function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
const text = asyncResult.value.data;
const prop = asyncResult.value.sourceProperty;
console.log("Selected text in " + prop + ": " + text);
} else {
console.error(asyncResult.error);
}
});
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
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Nota: este método não é suportado no Outlook para iOS ou Android.
Importante: no modo Compose mensagem, esta API não é suportada no Outlook na Web ou no Windows (novo e clássico), a menos que sejam cumpridas as seguintes condições.
a. Delegar acesso/Pastas partilhadas
O proprietário da caixa de correio inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta partilhada com o delegado.
O delegado abre o rascunho a partir da pasta partilhada e, em seguida, continua a compor.
b. Caixa de correio partilhada (aplica-se apenas ao Outlook clássico no Windows)
O utilizador da caixa de correio partilhada inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta na caixa de correio partilhada.
Outro utilizador da caixa de correio partilhada abre o rascunho da caixa de correio partilhada e, em seguida, continua a compor.
A mensagem encontra-se agora num contexto partilhado e os suplementos que suportam estes cenários partilhados podem obter as propriedades partilhadas do item. Depois de a mensagem ter sido enviada, normalmente encontra-se na pasta Itens Enviados do remetente.
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
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
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Nota: este método não é suportado no Outlook para iOS ou Android.
Importante: no modo Compose mensagem, esta API não é suportada no Outlook na Web ou no Windows (novo e clássico), a menos que sejam cumpridas as seguintes condições.
a. Delegar acesso/Pastas partilhadas
O proprietário da caixa de correio inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta partilhada com o delegado.
O delegado abre o rascunho a partir da pasta partilhada e, em seguida, continua a compor.
b. Caixa de correio partilhada (aplica-se apenas ao Outlook clássico no Windows)
O utilizador da caixa de correio partilhada inicia uma mensagem. Pode ser uma nova mensagem, uma resposta ou um reencaminhamento.
Guardam a mensagem e, em seguida, movem-na da sua própria pasta Rascunhos para uma pasta na caixa de correio partilhada.
Outro utilizador da caixa de correio partilhada abre o rascunho da caixa de correio partilhada e, em seguida, continua a compor.
A mensagem encontra-se agora num contexto partilhado e os suplementos que suportam estes cenários partilhados podem obter as propriedades partilhadas do item. Depois de a mensagem ter sido enviada, normalmente encontra-se na pasta Itens Enviados do remetente.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/65-delegates-and-shared-folders/get-shared-properties.yaml
Office.context.mailbox.item.getSharedPropertiesAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error("The current folder or mailbox isn't shared.");
return;
}
const sharedProperties = result.value;
console.log(`Owner: ${sharedProperties.owner}`);
console.log(`Permissions: ${sharedProperties.delegatePermissions}`);
console.log(`Target mailbox: ${sharedProperties.targetMailbox}`);
});
isClientSignatureEnabledAsync(options, callback)
Obtém se a assinatura do cliente estiver ativada.
No Outlook no Windows (clássico) e no Mac, a chamada à API é devolvida true
se a assinatura predefinida para novas mensagens, respostas ou reencaminhamentos estiver definida para um modelo para a conta do Outlook de envio. No Outlook na Web e no novo Outlook no Windows, a chamada à API devolve true
se a assinatura estiver ativada para os tiposnewMail
de composição , reply
ou forward
. Se as definições estiverem definidas como "(none)" no Outlook no Windows (clássico) ou no Mac ou desativadas no Outlook na Web ou no novo Outlook no Windows, a chamada à API devolve false
.
isClientSignatureEnabledAsync(options: Office.AsyncContextOptions, callback: (asyncResult: Office.AsyncResult<boolean>) => 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<boolean>) => 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
.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/work-with-client-signatures.yaml
// Check if the client signature is currently enabled.
Office.context.mailbox.item.isClientSignatureEnabledAsync(function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("isClientSignatureEnabledAsync succeeded with result: " + asyncResult.value);
} else {
console.error(asyncResult.error);
}
});
isClientSignatureEnabledAsync(callback)
Obtém se a assinatura do cliente estiver ativada.
No Outlook no Windows (clássico) e no Mac, a chamada à API é devolvida true
se a assinatura predefinida para novas mensagens, respostas ou reencaminhamentos estiver definida para um modelo para a conta do Outlook de envio. No Outlook na Web e no novo Outlook no Windows, a chamada à API devolve true
se a assinatura estiver ativada para os tiposnewMail
de composição , reply
ou forward
. Se as definições estiverem definidas como "(none)" no Outlook no Windows (clássico) ou no Mac ou desativadas no Outlook na Web ou no novo Outlook no Windows, a chamada à API devolve false
.
isClientSignatureEnabledAsync(callback: (asyncResult: Office.AsyncResult<boolean>) => void): void;
Parâmetros
- callback
-
(asyncResult: Office.AsyncResult<boolean>) => 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
.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.10 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
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, definir, guardar e remover 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
[ Conjunto de API: Caixa de Correio 1.1 ]
Para saber mais sobre as propriedades personalizadas, consulte Obter e definir metadados de suplementos para um suplemento do Outlook.
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/15-item-custom-properties/load-set-get-save.yaml
Office.context.mailbox.item.loadCustomPropertiesAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error(`loadCustomPropertiesAsync failed with message ${result.error.message}`);
return;
}
customProps = result.value;
console.log("Loaded the CustomProperties object.");
});
removeAttachmentAsync(attachmentId, options, callback)
Remove um anexo de uma mensagem ou de um compromisso.
O método removeAttachmentAsync
remove o anexo com o identificador especificado do item. Como prática recomendada, deve-se usar o identificador do anexo para remover um anexo somente se o mesmo aplicativo de email tiver adicionado esse anexo na mesma sessão. 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.
removeAttachmentAsync(attachmentId: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- attachmentId
-
string
O identificador do anexo a remover. O comprimento máximo da cadeia de carateres é de attachmentId
200 carateres em Outlook na Web e no Windows (novo e clássico).
- 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 do tipo Office.AsyncResult
. Se a remoção do anexo falhar, a propriedade asyncResult.error
conterá um código de erro com o motivo da falha.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante*: o removeAttachmentAsync
método não remove anexos inline de um item de correio. Para remover um anexo inline, primeiro obtenha o corpo do item e, em seguida, remova quaisquer referências do anexo do respetivo conteúdo. Utilize as APIs Office.Body para obter e definir o corpo de um item.
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.
Exemplos
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/40-attachments/attachments-compose.yaml
Office.context.mailbox.item.removeAttachmentAsync(
$("#attachmentId")
.val()
.toString(),
(result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error(result.error.message);
return;
}
console.log(`Attachment removed successfully.`);
}
);
removeAttachmentAsync(attachmentId, callback)
Remove um anexo de uma mensagem ou de um compromisso.
O método removeAttachmentAsync
remove o anexo com o identificador especificado do item. Como prática recomendada, deve-se usar o identificador do anexo para remover um anexo somente se o mesmo aplicativo de email tiver adicionado esse anexo na mesma sessão. 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.
removeAttachmentAsync(attachmentId: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- attachmentId
-
string
O identificador do anexo a remover. O comprimento máximo da cadeia de carateres é de attachmentId
200 carateres em Outlook na Web e no Windows (novo e clássico).
- 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 do tipo Office.AsyncResult
. Se a remoção do anexo falhar, a propriedade asyncResult.error
conterá um código de erro com o motivo da falha.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.1 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante*: o removeAttachmentAsync
método não remove anexos inline de um item de correio. Para remover um anexo inline, primeiro obtenha o corpo do item e, em seguida, remova quaisquer referências do anexo do respetivo conteúdo. Utilize as APIs Office.Body para obter e definir o corpo de um item.
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.
removeHandlerAsync(eventType, options, callback)
Remove um manipulador de eventos para um tipo de evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas.
Para eventos suportados, veja a secção Eventos do modelo de objeto de item.
removeHandlerAsync(eventType: Office.EventType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- eventType
-
Office.EventType | string
O evento que deve revogar o manipulador.
- 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
[ Conjunto de API: Caixa de Correio 1.7 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
removeHandlerAsync(eventType, callback)
Remove um manipulador de eventos para um tipo de evento com suporte. Nota: os eventos só estão disponíveis com a implementação do painel de tarefas.
Para eventos suportados, veja a secção Eventos do modelo de objeto de item.
removeHandlerAsync(eventType: Office.EventType | string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- eventType
-
Office.EventType | string
O evento que deve revogar o manipulador.
- 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
[ Conjunto de API: Caixa de Correio 1.7 ]
Nível mínimo de permissão: ler item
Modo Outlook aplicável: mensagem Compose
Exemplos
Office.context.mailbox.item.removeHandlerAsync(Office.EventType.ItemChanged, (asyncResult) => {
if (asyncResult.status === Office.AsyncResultStatus.Failed) {
console.error("Failed to remove event handler: " + asyncResult.error.message);
return;
}
console.log("Event handler removed successfully.");
});
saveAsync(options, callback)
Guarda de forma assíncrona a mensagem atual como um rascunho.
saveAsync(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, asyncResult
, que é um Office.AsyncResult
objeto. O ID da mensagem EWS é devolvido na asyncResult.value
propriedade .
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.3 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
No Outlook na Web, o novo Outlook no Windows ou o Outlook clássico no Windows no modo online (modo não colocado em cache), o item é guardado no servidor. No Outlook no modo cache, o item é salvo no cache local.
Ao trabalhar com conteúdo formatado em HTML, é importante ter em atenção que o cliente do Outlook pode modificar o conteúdo. Isto significa que as chamadas subsequentes para métodos como
Body.getAsync
,Body.setAsync
e até mesmosaveAsync
podem não resultar no mesmo conteúdo.O identificador devolvido é o mesmo que o identificador de item dos Serviços Web exchange (EWS). O ID do item devolvido não é idêntico 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
.Se o seu suplemento chamar
saveAsync
para obter um ID de item para utilizar com o EWS ou a API REST, tenha em atenção que, quando o Outlook está no modo de cache, poderá demorar algum tempo até que o item seja realmente sincronizado com o servidor. Até o item ser sincronizado, a utilização do ID do item devolverá um erro.No Outlook na Web e no novo Outlook no Windows, a conta de caixa de correio para a qual um rascunho é guardado varia quando
saveAsync
é chamado numa mensagem que será enviada a partir de uma conta de caixa de correio partilhada. Se o remetente criar uma nova mensagem a partir da respetiva caixa de correio pessoal e selecionar a conta de caixa de correio partilhada no campo De ,saveAsync
guarda o rascunho na pasta Rascunhos da caixa de correio pessoal do utilizador. Se o remetente abrir a conta de caixa de correio partilhada num separador separador do browser (por exemplo, através da opção Abrir outra caixa de correio ) e criar uma nova mensagem,saveAsync
guarda o rascunho na pasta Rascunhos da caixa de correio partilhada.
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.
saveAsync(callback)
Guarda de forma assíncrona a mensagem atual como um rascunho.
saveAsync(callback: (asyncResult: Office.AsyncResult<string>) => void): void;
Parâmetros
- 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, asyncResult
, que é um Office.AsyncResult
objeto. O ID da mensagem EWS é devolvido na asyncResult.value
propriedade .
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.3 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Importante:
No Outlook na Web, o novo Outlook no Windows ou o Outlook clássico no Windows no modo online (modo não colocado em cache), o item é guardado no servidor. No Outlook no modo cache, o item é salvo no cache local.
Ao trabalhar com conteúdo formatado em HTML, é importante ter em atenção que o cliente do Outlook pode modificar o conteúdo. Isto significa que as chamadas subsequentes para métodos como
Body.getAsync
,Body.setAsync
e até mesmosaveAsync
podem não resultar no mesmo conteúdo.O identificador devolvido é o mesmo que o identificador de item dos Serviços Web exchange (EWS). O ID do item devolvido não é idêntico 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
.Se o seu suplemento chamar
saveAsync
para obter um ID de item para utilizar com o EWS ou a API REST, tenha em atenção que, quando o Outlook está no modo de cache, poderá demorar algum tempo até que o item seja realmente sincronizado com o servidor. Até o item ser sincronizado, a utilização do ID do item devolverá um erro.No Outlook na Web e no novo Outlook no Windows, a conta de caixa de correio para a qual um rascunho é guardado varia quando
saveAsync
é chamado numa mensagem que será enviada a partir de uma conta de caixa de correio partilhada. Se o remetente criar uma nova mensagem a partir da respetiva caixa de correio pessoal e selecionar a conta de caixa de correio partilhada no campo De ,saveAsync
guarda o rascunho na pasta Rascunhos da caixa de correio pessoal do utilizador. Se o remetente abrir a conta de caixa de correio partilhada num separador separador do browser (por exemplo, através da opção Abrir outra caixa de correio ) e criar uma nova mensagem,saveAsync
guarda o rascunho na pasta Rascunhos da caixa de correio partilhada.
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.
Exemplos
Office.context.mailbox.item.saveAsync(
function callback(result) {
// Process the result.
});
// The following is an example of the
// `result` parameter passed to the
// callback function. The `value`
// property contains the item ID of
// the item.
{
"value": "AAMkADI5...AAA=",
"status": "succeeded"
}
setSelectedDataAsync(data, options, callback)
Insere de forma assíncrona os dados no corpo ou no assunto de uma mensagem.
O setSelectedDataAsync
método insere a cadeia especificada na localização do cursor no assunto ou corpo do item ou, se o texto estiver selecionado no editor, substitui o texto selecionado. Se o cursor não estiver no corpo ou no campo do assunto, é devolvido um erro. Após a inserção, o cursor é colocado no final do conteúdo inserido.
setSelectedDataAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- data
-
string
Os dados a serem inseridos. Os dados não devem exceder 1.000.000 de caracteres. Se forem passados mais de 1.000.000 de caracteres, ocorrerá uma exceção ArgumentOutOfRange
.
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.
coercionType
: se for texto, o estilo atual é aplicado no Outlook na Web, no Windows (novo e clássico) e no Mac. Se o campo for um editor de HTML, apenas os dados de texto são inseridos, mesmo se os dados forem HTML. Se os dados forem HTML e o campo suportar HTML (o assunto não o faz), o estilo atual é aplicado no Outlook na Web e no novo Outlook no Windows. O estilo predefinido é aplicado no Outlook no Windows (clássico) e no Mac. Se o campo for um campo de texto, retorna um erro InvalidDataFormat
. Se coercionType
não estiver definido, o resultado depende do campo: se o campo for HTML, HTML será usado; se o campo for texto, texto sem formatação será usado.
- 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 do tipo Office.AsyncResult
.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.2 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.
Exemplos
Office.context.mailbox.item.setSelectedDataAsync("<b>Hello World!</b>", { coercionType : "html" });
Office.context.mailbox.item.setSelectedDataAsync("Hello World!");
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/set-selected-data.yaml
Office.context.mailbox.item.setSelectedDataAsync("Replaced", function(asyncResult) {
if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
console.log("Selected text has been updated successfully.");
} else {
console.error(asyncResult.error);
}
});
setSelectedDataAsync(data, callback)
Insere de forma assíncrona os dados no corpo ou no assunto de uma mensagem.
O setSelectedDataAsync
método insere a cadeia especificada na localização do cursor no assunto ou corpo do item ou, se o texto estiver selecionado no editor, substitui o texto selecionado. Se o cursor não estiver no corpo ou no campo do assunto, é devolvido um erro. Após a inserção, o cursor é colocado no final do conteúdo inserido.
setSelectedDataAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
Parâmetros
- data
-
string
Os dados a serem inseridos. Os dados não devem exceder 1.000.000 de caracteres. Se forem passados mais de 1.000.000 de caracteres, ocorrerá uma exceção ArgumentOutOfRange
.
- 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 do tipo Office.AsyncResult
.
Retornos
void
Comentários
[ Conjunto de API: Caixa de Correio 1.2 ]
Nível mínimo de permissão: item de leitura/escrita
Modo Outlook aplicável: mensagem Compose
Erros:
-
InvalidAttachmentId
: o identificador de anexo não existe.