Obter e definir dados de item em um formulário de redação no Outlook

  • Artigo

Saiba como obter ou definir várias propriedades de um item em um suplemento do Outlook em um cenário de composição, incluindo seus destinatários, o assunto, o corpo e o local e a hora do compromisso.

Obter e definir propriedades de item de um suplemento de redação

Em um formulário de composição, é possível obter a maioria das propriedades que estão expostas no mesmo tipo de item de um formulário de leitura (por exemplo, participantes, destinatários, assunto e corpo) e acessar algumas propriedades adicionais que são relevantes somente no formulário de composição, mas não de leitura (corpo, cco).

Para a maioria dessas propriedades, como é possível que um suplemento do Outlook e o usuário estejam modificando a mesma propriedade na interface de usuário ao mesmo tempo, os métodos para obtê-las e defini-las é assíncrono. A Tabela 1 lista as propriedades no nível do item e os métodos assíncronos correspondentes para obtê-los e defini-los em um formulário de composição. As propriedades item.itemType e item.conversationId são exceções porque os usuários não podem modificá-las. Você pode obtê-las via programação da mesma maneira em um formulário de composição e em um formulário de leitura, diretamente do objeto pai.

Além de acessar propriedades de item na API JavaScript do Office, você pode acessar propriedades no nível do item usando o EWS (Exchange Web Services). Com a permissão de caixa de correio de leitura/gravação , você pode usar o método mailbox.makeEwsRequestAsync para acessar operações do EWS, GetItem e UpdateItem, para obter e definir mais propriedades de um item ou itens na caixa de correio do usuário.

O makeEwsRequestAsync método está disponível em formulários de composição e leitura. Para obter mais informações sobre a permissão de caixa de correio de leitura/gravação e acessar o EWS por meio da plataforma de Suplementos do Office, consulte Entender as permissões de suplemento do Outlook e chamar serviços Web de um suplemento do Outlook.

Tabela 1. Métodos assíncronos para obter ou definir propriedades do item em um formulário de composição

Propriedade Tipo de propriedade Método assíncrono para obter Métodos assíncronos a serem definidos
bcc Destinatários Recipients.getAsync Recipients.addAsync, Recipients.setAsync
body Body Body.getAsync Body.prependAsync, Body.setAsync, Body.setSelectedDataAsync
cc Destinatários Recipients.getAsync Recipients.addAsync Recipients.setAsync
end Time Time.getAsync Time.setAsync
location Location Location.getAsync Location.setAsync
optionalAttendees Destinatários Recipients.getAsync Recipients.addAsync Recipients.setAsync
requiredAttendees Destinatários Recipients.getAsync Recipients.addAsync Recipients.setAsync
start Hora Time.getAsync Time.setAsync
subject Subject Subject.getAsync Subject.setAsync
to Destinatários Recipients.getAsync Recipients.addAsync Recipients.setAsync

Confira também