Office.Body interface

Referência

Pacote:: outlook

O objeto body fornece métodos para adicionar e atualizar o conteúdo da mensagem ou compromisso. É devolvido na propriedade body do item selecionado.

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

Problema conhecido com as cores de limite da tabela HTML

Outlook no Windows: se estiver a definir vários limites de células para cores diferentes numa tabela HTML no modo Compose, os limites de uma célula poderão não refletir a cor esperada. Para obter o comportamento conhecido, visite OfficeDev/office-js issue #1818.

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

Modo Outlook aplicável: Compose ou Leitura

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/add-inline-base64-image.yaml

const mailItem = Office.context.mailbox.item;
const base64String =
  "iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAMAAADVRocKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAnUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN0S+bUAAAAMdFJOUwAQIDBAUI+fr7/P7yEupu8AAAAJcEhZcwAADsMAAA7DAcdvqGQAAAF8SURBVGhD7dfLdoMwDEVR6Cspzf9/b20QYOthS5Zn0Z2kVdY6O2WULrFYLBaLxd5ur4mDZD14b8ogWS/dtxV+dmx9ysA2QUj9TQRWv5D7HyKwuIW9n0vc8tkpHP0W4BOg3wQ8wtlvA+PC1e8Ao8Ld7wFjQtHvAiNC2e8DdqHqKwCrUPc1gE1AfRVgEXBfB+gF0lcCWoH2tYBOYPpqQCNwfT3QF9i+AegJfN8CtAWhbwJagtS3AbIg9o2AJMh9M5C+SVGBvx6zAfmT0r+Bv8JMwP4kyFPir+cswF5KL3WLv14zAFBCLf56Tw9cparFX4upgaJUtPhrOS1QlY5W+vWTXrGgBFB/b72ev3/0igUdQPppP/nfowfKUUEFcP207y/yxKmgAYQ+PywoAFOfCH3A2MdCFzD3kdADBvq10AGG+pXQBgb7pdAEhvuF0AIc/VtoAK7+JciAs38KIuDugyAC/v4hiMCE/i7IwLRBsh68N2WQjMVisVgs9i5bln8LGScNcCrONQAAAABJRU5ErkJggg==";

// Get the current body of the message or appointment.
mailItem.body.getAsync(Office.CoercionType.Html, (bodyResult) => {
  if (bodyResult.status === Office.AsyncResultStatus.Succeeded) {
    // Insert the Base64-encoded image to the beginning of the body.
    const options = { isInline: true, asyncContext: bodyResult.value };
    mailItem.addFileAttachmentFromBase64Async(base64String, "sample.png", options, (attachResult) => {
      if (attachResult.status === Office.AsyncResultStatus.Succeeded) {
        let body = attachResult.asyncContext;
        body = body.replace("<p class=MsoNormal>", `<p class=MsoNormal><img src="cid:sample.png">`);

        mailItem.body.setAsync(body, { coercionType: Office.CoercionType.Html }, (setResult) => {
          if (setResult.status === Office.AsyncResultStatus.Succeeded) {
            console.log("Inline Base64-encoded image added to the body.");
          } else {
            console.log(setResult.error.message);
          }
        });
      } else {
        console.log(attachResult.error.message);
      }
    });
  } else {
    console.log(bodyResult.error.message);
  }
});

Métodos

appendOnSendAsync(data, options, callback)	Acrescenta ao enviar o conteúdo especificado para o final do corpo do item, após qualquer assinatura. Para utilizar `appendOnSendAsync`o , tem de especificar uma permissão suplementar no manifesto. Os detalhes variam com o tipo de manifesto. Veja Compreender as permissões de suplementos do Outlook. Para saber mais sobre o acréscimo no envio e a respetiva configuração, consulte Implementar o acréscimo no seu suplemento do Outlook.
appendOnSendAsync(data, callback)	Acrescenta ao enviar o conteúdo especificado para o final do corpo do item, após qualquer assinatura. Para utilizar `appendOnSendAsync`o , tem de especificar uma permissão suplementar no manifesto. Os detalhes variam com o tipo de manifesto. Veja Compreender as permissões de suplementos do Outlook. Para saber mais sobre o acréscimo no envio e a respetiva configuração, consulte Implementar o acréscimo no seu suplemento do Outlook.
getAsync(coercionType, options, callback)	Retorna o corpo atual em um formato especificado. Este método devolve todo o corpo atual no formato especificado por `coercionType`.
getAsync(coercionType, callback)	Retorna o corpo atual em um formato especificado. Este método devolve todo o corpo atual no formato especificado por `coercionType`.
getTypeAsync(options, callback)	Obtém um valor que indica se o conteúdo está em formato HTML ou texto.
getTypeAsync(callback)	Obtém um valor que indica se o conteúdo está em formato HTML ou texto.
prependAsync(data, options, callback)	Adiciona o conteúdo especificado ao início do corpo do item.
prependAsync(data, callback)	Adiciona o conteúdo especificado ao início do corpo do item.
setAsync(data, options, callback)	Substitui todo o corpo com o texto especificado.
setAsync(data, callback)	Substitui todo o corpo com o texto especificado.
setSelectedDataAsync(data, options, callback)	Substitui a seleção no corpo pelo texto especificado. O método `setSelectedDataAsync` insere a cadeia de caracteres especificada no local do cursor no corpo do item ou, se o texto estiver selecionado no editor, substitui o texto selecionado. Se o cursor nunca esteve no corpo do item, ou se o corpo do item perdeu o destaque na interface de usuário, a cadeia de caracteres será inserida na parte superior do conteúdo do corpo. Após a inserção, o cursor é colocado no final do conteúdo inserido.
setSelectedDataAsync(data, callback)	Substitui a seleção no corpo pelo texto especificado. O método `setSelectedDataAsync` insere a cadeia de caracteres especificada no local do cursor no corpo do item ou, se o texto estiver selecionado no editor, substitui o texto selecionado. Se o cursor nunca esteve no corpo do item, ou se o corpo do item perdeu o destaque na interface de usuário, a cadeia de caracteres será inserida na parte superior do conteúdo do corpo. Após a inserção, o cursor é colocado no final do conteúdo inserido.

Detalhes do método

appendOnSendAsync(data, options, callback)

Acrescenta ao enviar o conteúdo especificado para o final do corpo do item, após qualquer assinatura.

Para utilizar appendOnSendAsynco , tem de especificar uma permissão suplementar no manifesto. Os detalhes variam com o tipo de manifesto. Veja Compreender as permissões de suplementos do Outlook. Para saber mais sobre o acréscimo no envio e a respetiva configuração, consulte Implementar o acréscimo no seu suplemento do Outlook.

appendOnSendAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia a ser adicionada à extremidade do corpo. A cadeia está limitada a 5000 carateres.

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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 : o formato pretendido para que os dados sejam acrescentados. A cadeia de caracteres no parâmetro data será convertida para este formato.

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. Quaisquer erros encontrados serão fornecidos na propriedade asyncResult.error.

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.9 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o respetivo valor devolvido para o options.coercionType parâmetro .

Importante:

Se o utilizador estiver a executar suplementos que implementam a funcionalidadeItemSend no envio através do manifesto, o acréscimo no envio é executado antes da funcionalidade de envio.
Se o suplemento implementar a funcionalidade de envio e as chamadas appendOnSendAsync no ItemSend processador, a appendOnSendAsync chamada devolve um erro, uma vez que este cenário não é suportado.
Para limpar dados de uma chamada anterior appendOnSendAsync , pode chamá-lo novamente com o data parâmetro definido como null.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O appendOnSendAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o data parâmetro tem mais de 5000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html mas o corpo da mensagem está em texto simples.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/append-text-on-send.yaml

// This snippet appends text to the end of the message or appointment's body once it's sent.
const text = $("#text-field").val();

// It's recommended to call getTypeAsync and pass its returned value to the options.coercionType parameter of the appendOnSendAsync call.
Office.context.mailbox.item.body.getTypeAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log("Action failed with error: " + asyncResult.error.message);
    return;
  }

  const bodyFormat = asyncResult.value;
  Office.context.mailbox.item.body.appendOnSendAsync(text, { coercionType: bodyFormat }, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log("Action failed with error: " + asyncResult.error.message);
      return;
    }

    console.log(`"${text}" will be appended to the body once the message or appointment is sent. Send the mail item to test this feature.`);
  });
});

appendOnSendAsync(data, callback)

Acrescenta ao enviar o conteúdo especificado para o final do corpo do item, após qualquer assinatura.

appendOnSendAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia a ser adicionada à extremidade do corpo. A cadeia está limitada a 5000 carateres.

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.9 ]

Nível mínimo de permissão: item de leitura/escrita

Modo Outlook aplicável: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o respetivo valor devolvido para o options.coercionType parâmetro .

Importante:

Se o utilizador estiver a executar suplementos que implementam a funcionalidadeItemSend no envio através do manifesto, o acréscimo no envio é executado antes da funcionalidade de envio.
Se o suplemento implementar a funcionalidade de envio e as chamadas appendOnSendAsync no ItemSend processador, a appendOnSendAsync chamada devolve um erro, uma vez que este cenário não é suportado.
Para limpar dados de uma chamada anterior appendOnSendAsync , pode chamá-lo novamente com o data parâmetro definido como null.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O appendOnSendAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o data parâmetro tem mais de 5000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html mas o corpo da mensagem está em texto simples.

getAsync(coercionType, options, callback)

Retorna o corpo atual em um formato especificado.

Este método devolve todo o corpo atual no formato especificado por coercionType.

getAsync(coercionType: Office.CoercionType | string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Parâmetros

coercionType: Office.CoercionType | string

O formato do corpo retornado.

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. O corpo é fornecido no formato pedido na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante:

Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o valor devolvido pelo Body.getAsync método não será necessariamente o mesmo valor que foi transmitido anteriormente no Body.setAsync método . O cliente pode modificar o valor transmitido para setAsync para torná-lo composto de forma eficiente com o respetivo motor de composição.
No Outlook na Web e no novo Outlook no Windows, se o corpo contiver elementos formatados, como tabelas, listas e ligações, especifique Office.CoercionType.Html na getAsync chamada. Caso contrário, poderá receber um valor inesperado, como uma cadeia vazia.

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"
}

getAsync(coercionType, callback)

Retorna o corpo atual em um formato especificado.

Este método devolve todo o corpo atual no formato especificado por coercionType.

getAsync(coercionType: Office.CoercionType | string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

Parâmetros

coercionType: Office.CoercionType | string

O formato do corpo retornado.

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.3 ]

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

Modo Outlook aplicável: Compose ou Leitura

Importante:

Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o valor devolvido pelo Body.getAsync método não será necessariamente o mesmo valor que foi transmitido anteriormente no Body.setAsync método . O cliente pode modificar o valor transmitido para setAsync para torná-lo composto de forma eficiente com o respetivo motor de composição.
No Outlook na Web e no novo Outlook no Windows, se o corpo contiver elementos formatados, como tabelas, listas e ligações, especifique Office.CoercionType.Html na getAsync chamada. Caso contrário, poderá receber um valor inesperado, como uma cadeia vazia.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/add-inline-base64-image.yaml

const mailItem = Office.context.mailbox.item;
const base64String =
  "iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAMAAADVRocKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAnUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN0S+bUAAAAMdFJOUwAQIDBAUI+fr7/P7yEupu8AAAAJcEhZcwAADsMAAA7DAcdvqGQAAAF8SURBVGhD7dfLdoMwDEVR6Cspzf9/b20QYOthS5Zn0Z2kVdY6O2WULrFYLBaLxd5ur4mDZD14b8ogWS/dtxV+dmx9ysA2QUj9TQRWv5D7HyKwuIW9n0vc8tkpHP0W4BOg3wQ8wtlvA+PC1e8Ao8Ld7wFjQtHvAiNC2e8DdqHqKwCrUPc1gE1AfRVgEXBfB+gF0lcCWoH2tYBOYPpqQCNwfT3QF9i+AegJfN8CtAWhbwJagtS3AbIg9o2AJMh9M5C+SVGBvx6zAfmT0r+Bv8JMwP4kyFPir+cswF5KL3WLv14zAFBCLf56Tw9cparFX4upgaJUtPhrOS1QlY5W+vWTXrGgBFB/b72ev3/0igUdQPppP/nfowfKUUEFcP207y/yxKmgAYQ+PywoAFOfCH3A2MdCFzD3kdADBvq10AGG+pXQBgb7pdAEhvuF0AIc/VtoAK7+JciAs38KIuDugyAC/v4hiMCE/i7IwLRBsh68N2WQjMVisVgs9i5bln8LGScNcCrONQAAAABJRU5ErkJggg==";

// Get the current body of the message or appointment.
mailItem.body.getAsync(Office.CoercionType.Html, (bodyResult) => {
  if (bodyResult.status === Office.AsyncResultStatus.Succeeded) {
    // Insert the Base64-encoded image to the beginning of the body.
    const options = { isInline: true, asyncContext: bodyResult.value };
    mailItem.addFileAttachmentFromBase64Async(base64String, "sample.png", options, (attachResult) => {
      if (attachResult.status === Office.AsyncResultStatus.Succeeded) {
        let body = attachResult.asyncContext;
        body = body.replace("<p class=MsoNormal>", `<p class=MsoNormal><img src="cid:sample.png">`);

        mailItem.body.setAsync(body, { coercionType: Office.CoercionType.Html }, (setResult) => {
          if (setResult.status === Office.AsyncResultStatus.Succeeded) {
            console.log("Inline Base64-encoded image added to the body.");
          } else {
            console.log(setResult.error.message);
          }
        });
      } else {
        console.log(attachResult.error.message);
      }
    });
  } else {
    console.log(bodyResult.error.message);
  }
});

getTypeAsync(options, callback)

Obtém um valor que indica se o conteúdo está em formato HTML ou texto.

getTypeAsync(options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<Office.CoercionType>) => 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.CoercionType>) => 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. O tipo de conteúdo é devolvido como um dos CoercionType valores na asyncResult.value propriedade .

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

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

Modo Outlook aplicável: Compose

Importante: no Outlook para Android e no iOS, este método não é suportado no modo Compose mensagens. Apenas o modo Organizador de Compromissos é suportado. 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/20-item-body/get-body-format.yaml

// Get the mail item's body format (plain text or HTML) and log it to the console.
Office.context.mailbox.item.body.getTypeAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log("Action failed with error: " + asyncResult.error.message);
    return;
  }

  console.log("Body format: " + asyncResult.value);
});

getTypeAsync(callback)

Obtém um valor que indica se o conteúdo está em formato HTML ou texto.

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

Parâmetros

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

Retornos

void

Comentários

[ Conjunto de API: Caixa de Correio 1.1 ]

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

Modo Outlook aplicável: Compose

prependAsync(data, options, callback)

Adiciona o conteúdo especificado ao início do corpo do item.

prependAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia de caracteres a ser inserida no início do corpo. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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 : o formato pretendido para o corpo. A cadeia de caracteres no parâmetro data será convertida para este formato.

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

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: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

Importante:

Depois de o conteúdo ser pré-anexado, a posição do cursor depende do cliente em que o suplemento está em execução. No Outlook na Web e no Windows (novo e clássico), a posição do cursor permanece a mesma no conteúdo pré-existente do corpo. Por exemplo, se o cursor tiver sido posicionado no início do corpo antes prependAsync da chamada, será apresentado entre o conteúdo pré-anexado e o conteúdo pré-existente do corpo após a chamada. No Outlook para Mac, a posição do cursor não é preservada. O cursor desaparece após a prependAsync chamada e só volta a aparecer quando o utilizador seleciona algo no corpo do item de correio.
Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o cliente pode modificar o valor transmitido para prependAsync o tornar eficiente com o motor de composição. Isto significa que o valor devolvido de uma chamada subsequente ao Body.getAsync método (introduzido na Caixa de Correio 1.3) não conterá necessariamente o valor exato que foi transmitido na chamada anterior prependAsync .
Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
No Outlook para Android e no iOS, este método não é suportado no modo de Compose mensagens. Apenas o modo Organizador de Compromissos é suportado. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O prependAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o parâmetro de dados tem mais de 1000 000 carateres.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/prepend-text-to-item-body.yaml

/* This snippet adds text to the beginning of the message or appointment's body. 
  
  When prepending a link in HTML markup to the body, you can disable the online link preview by setting the anchor tag's id attribute to "LPNoLP". For example, '<a id="LPNoLP" href="https://www.contoso.com">Click here!</a>'.
*/
const text = $("#text-field").val().toString();

// It's recommended to call getTypeAsync and pass its returned value to the options.coercionType parameter of the prependAsync call.
Office.context.mailbox.item.body.getTypeAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log("Action failed with error: " + asyncResult.error.message);
    return;
  }

  const bodyFormat = asyncResult.value;
  Office.context.mailbox.item.body.prependAsync(text, { coercionType: bodyFormat }, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log("Action failed with error: " + asyncResult.error.message);
      return;
    }

    console.log(`"${text}" prepended to the body.`);
  });
});

prependAsync(data, callback)

Adiciona o conteúdo especificado ao início do corpo do item.

prependAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia de caracteres a ser inserida no início do corpo. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

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

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: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

Importante:

Depois de o conteúdo ser pré-anexado, a posição do cursor depende do cliente em que o suplemento está em execução. No Outlook na Web e no Windows (novo e clássico), a posição do cursor permanece a mesma no conteúdo pré-existente do corpo. Por exemplo, se o cursor tiver sido posicionado no início do corpo antes prependAsync da chamada, será apresentado entre o conteúdo pré-anexado e o conteúdo pré-existente do corpo após a chamada. No Outlook para Mac, a posição do cursor não é preservada. O cursor desaparece após a prependAsync chamada e só volta a aparecer quando o utilizador seleciona algo no corpo do item de correio.
Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o cliente pode modificar o valor transmitido para prependAsync o tornar eficiente com o motor de composição. Isto significa que o valor devolvido de uma chamada subsequente ao Body.getAsync método (introduzido na Caixa de Correio 1.3) não conterá necessariamente o valor exato que foi transmitido na chamada anterior prependAsync .
Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
No Outlook para Android e no iOS, este método não é suportado no modo de Compose mensagens. Apenas o modo Organizador de Compromissos é suportado. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O prependAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o parâmetro de dados tem mais de 1000 000 carateres.

setAsync(data, options, callback)

Substitui todo o corpo com o texto especificado.

setAsync(data: string, options: Office.AsyncContextOptions & CoercionTypeOptions, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia de caracteres que substituirá o corpo existente. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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 : o formato pretendido para o corpo. A cadeia de caracteres no parâmetro data será convertida para este formato.

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. Quaisquer erros encontrados serão fornecidos na propriedade asyncResult.error.

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: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

Importante:

Depois de o corpo ser substituído pelo conteúdo especificado, a posição do cursor depende do cliente em que o suplemento está em execução. No Outlook clássico no Windows, o cursor é apresentado no início do corpo do item de correio. No Outlook na Web e no novo Outlook no Windows, o cursor é apresentado no final do corpo do item de correio. No Outlook para Mac, a posição do cursor não é preservada. O cursor desaparece após a prependAsync chamada e só volta a aparecer quando o utilizador seleciona algo no corpo do item de correio.
Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o valor devolvido pelo Body.getAsync método não será necessariamente o mesmo valor que foi transmitido anteriormente no Body.setAsync método . O cliente pode modificar o valor transmitido para setAsync para torná-lo composto de forma eficiente com o respetivo motor de composição.
Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
No Outlook no Windows (clássico) e no Mac, o utilizador do suplemento não consegue reverter esta ação com o comando Anular.
No Outlook para Android e no iOS, este método não é suportado no modo de Compose mensagens. Apenas o modo Organizador de Compromissos é suportado. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O setAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o parâmetro de dados tem mais de 1000 000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html e o corpo da mensagem está em texto simples.

Exemplos

// When including links in HTML markup, you can disable online link preview
// by setting the id attribute on the anchor (<a>) to "LPNoLP".
Office.context.mailbox.item.body.setAsync(
    '<a id="LPNoLP" href="http://www.contoso.com">Click here!</a>',
    { 
        coercionType: Office.CoercionType.Html,
        asyncContext: "This is passed to the callback"
    },
    (result) => {
        // Process the result.
    }
);

// The following is an example of the result parameter passed to the callback function.
{
    "value": null,
    "status": "succeeded",
    "asyncContext": "This is passed to the callback"
}

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/add-inline-base64-image.yaml

const mailItem = Office.context.mailbox.item;
const base64String =
  "iVBORw0KGgoAAAANSUhEUgAAAGAAAABgCAMAAADVRocKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAnUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAN0S+bUAAAAMdFJOUwAQIDBAUI+fr7/P7yEupu8AAAAJcEhZcwAADsMAAA7DAcdvqGQAAAF8SURBVGhD7dfLdoMwDEVR6Cspzf9/b20QYOthS5Zn0Z2kVdY6O2WULrFYLBaLxd5ur4mDZD14b8ogWS/dtxV+dmx9ysA2QUj9TQRWv5D7HyKwuIW9n0vc8tkpHP0W4BOg3wQ8wtlvA+PC1e8Ao8Ld7wFjQtHvAiNC2e8DdqHqKwCrUPc1gE1AfRVgEXBfB+gF0lcCWoH2tYBOYPpqQCNwfT3QF9i+AegJfN8CtAWhbwJagtS3AbIg9o2AJMh9M5C+SVGBvx6zAfmT0r+Bv8JMwP4kyFPir+cswF5KL3WLv14zAFBCLf56Tw9cparFX4upgaJUtPhrOS1QlY5W+vWTXrGgBFB/b72ev3/0igUdQPppP/nfowfKUUEFcP207y/yxKmgAYQ+PywoAFOfCH3A2MdCFzD3kdADBvq10AGG+pXQBgb7pdAEhvuF0AIc/VtoAK7+JciAs38KIuDugyAC/v4hiMCE/i7IwLRBsh68N2WQjMVisVgs9i5bln8LGScNcCrONQAAAABJRU5ErkJggg==";

// Get the current body of the message or appointment.
mailItem.body.getAsync(Office.CoercionType.Html, (bodyResult) => {
  if (bodyResult.status === Office.AsyncResultStatus.Succeeded) {
    // Insert the Base64-encoded image to the beginning of the body.
    const options = { isInline: true, asyncContext: bodyResult.value };
    mailItem.addFileAttachmentFromBase64Async(base64String, "sample.png", options, (attachResult) => {
      if (attachResult.status === Office.AsyncResultStatus.Succeeded) {
        let body = attachResult.asyncContext;
        body = body.replace("<p class=MsoNormal>", `<p class=MsoNormal><img src="cid:sample.png">`);

        mailItem.body.setAsync(body, { coercionType: Office.CoercionType.Html }, (setResult) => {
          if (setResult.status === Office.AsyncResultStatus.Succeeded) {
            console.log("Inline Base64-encoded image added to the body.");
          } else {
            console.log(setResult.error.message);
          }
        });
      } else {
        console.log(attachResult.error.message);
      }
    });
  } else {
    console.log(bodyResult.error.message);
  }
});

setAsync(data, callback)

Substitui todo o corpo com o texto especificado.

setAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia de caracteres que substituirá o corpo existente. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

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

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: Compose

Recomendado: chame getTypeAsynce, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

Importante:

Depois de o corpo ser substituído pelo conteúdo especificado, a posição do cursor depende do cliente em que o suplemento está em execução. No Outlook clássico no Windows, o cursor é apresentado no início do corpo do item de correio. No Outlook na Web e no novo Outlook no Windows, o cursor é apresentado no final do corpo do item de correio. No Outlook para Mac, a posição do cursor não é preservada. O cursor desaparece após a prependAsync chamada e só volta a aparecer quando o utilizador seleciona algo no corpo do item de correio.
Ao trabalhar com corpos formatados em HTML, é importante ter em atenção que o valor devolvido pelo Body.getAsync método não será necessariamente o mesmo valor que foi transmitido anteriormente no Body.setAsync método . O cliente pode modificar o valor transmitido para setAsync para torná-lo composto de forma eficiente com o respetivo motor de composição.
Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
No Outlook no Windows (clássico) e no Mac, o utilizador do suplemento não consegue reverter esta ação com o comando Anular.
No Outlook para Android e no iOS, este método não é suportado no modo de Compose mensagens. Apenas o modo Organizador de Compromissos é suportado. Para obter mais informações sobre as APIs suportadas no Outlook Mobile, consulte ApIs JavaScript do Outlook suportadas no Outlook em dispositivos móveis.
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O setAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o parâmetro de dados tem mais de 1000 000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html e o corpo da mensagem está em texto simples.

setSelectedDataAsync(data, options, callback)

Substitui a seleção no corpo pelo texto especificado.

O método setSelectedDataAsync insere a cadeia de caracteres especificada no local do cursor no corpo do item ou, se o texto estiver selecionado no editor, substitui o texto selecionado. Se o cursor nunca esteve no corpo do item, ou se o corpo do item perdeu o destaque na interface de usuário, a cadeia de caracteres será inserida na parte superior do conteúdo do corpo. 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

A cadeia de caracteres que substituirá o corpo existente. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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 : o formato pretendido para o corpo. A cadeia de caracteres no parâmetro data será convertida para este formato.

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

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: Compose

Recomendado: chame getTypeAsync e, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

* Importante:

Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O setSelectedDataAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o data parâmetro tem mais de 1000 000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html e o corpo da mensagem está em texto simples.

Exemplos

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/20-item-body/replace-selected-text.yaml

/* This snippet replaces selected text in a message or appointment's body with specified text.
  
  If you want to use a link in HTML markup as a value of the setSelectedDataAsync call's data parameter, you can disable online link preview by setting the anchor tag's id attribute to "LPNoLP". For example, '<a id="LPNoLP" href="https://www.contoso.com">Click here!</a>'.
*/
const text = $("#text-field").val().toString();

// It's recommended to call getTypeAsync and pass its returned value to the options.coercionType parameter of the prependAsync call.
Office.context.mailbox.item.body.getTypeAsync((asyncResult) => {
  if (asyncResult.status === Office.AsyncResultStatus.Failed) {
    console.log("Action failed with error: " + asyncResult.error.message);
    return;
  }

  const bodyFormat = asyncResult.value;
  Office.context.mailbox.item.body.setSelectedDataAsync(text, { coercionType: bodyFormat }, (asyncResult) => {
    if (asyncResult.status === Office.AsyncResultStatus.Failed) {
      console.log("Action failed with error: " + asyncResult.error.message);
      return;
    }

    console.log(`Replaced selected text with "${text}".`);
  });
});

setSelectedDataAsync(data, callback)

Substitui a seleção no corpo pelo texto especificado.

setSelectedDataAsync(data: string, callback?: (asyncResult: Office.AsyncResult<void>) => void): void;

Parâmetros

data: string

A cadeia de caracteres que substituirá o corpo existente. A cadeia de caracteres está limitada a 1.000.000 de caracteres.

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

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: Compose

Recomendado: chame getTypeAsync e, em seguida, transmita o valor devolvido para o options.coercionType parâmetro .

* Importante:

Ao incluir ligações na marcação HTML, pode desativar a pré-visualização da ligação online ao definir o id atributo na âncora (<a>) como "LPNoLP" (consulte a secção Exemplos de um exemplo).
Os ficheiros SVG não são suportados. Em alternativa, utilize ficheiros JPG ou PNG.
O setSelectedDataAsync método não suporta CSS inline. Em alternativa, utilize CSS interno ou externo.

Erros:

DataExceedsMaximumSize : o data parâmetro tem mais de 1000 000 carateres.
InvalidFormatError : o options.coercionType parâmetro está definido como Office.CoercionType.Html e o corpo da mensagem está em texto simples.

Compartilhar via

Office.Body interface

Comentários

Exemplos

Métodos

Detalhes do método

appendOnSendAsync(data, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

appendOnSendAsync(data, callback)

Parâmetros

Retornos

Comentários

getAsync(coercionType, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

getAsync(coercionType, callback)

Parâmetros

Retornos

Comentários

Exemplos

getTypeAsync(options, callback)

Parâmetros

Retornos

Comentários

Exemplos

getTypeAsync(callback)

Parâmetros

Retornos

Comentários

prependAsync(data, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

prependAsync(data, callback)

Parâmetros

Retornos

Comentários

setAsync(data, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

setAsync(data, callback)

Parâmetros

Retornos

Comentários

setSelectedDataAsync(data, options, callback)

Parâmetros

Retornos

Comentários

Exemplos

setSelectedDataAsync(data, callback)

Parâmetros

Retornos

Comentários

Recursos adicionais