Office. Body interface

最小アクセス許可レベル: 読み取り項目

適用できる Outlook モード: Composeまたは読み取り

重要:

HTML 形式の本文を操作する場合は、 Body.getAsync メソッドによって返される値が、必ずしも Body.setAsync メソッドで以前に渡された値とまったく同じとは限らないことに注意してください。クライアントは、 setAsync に渡される値を変更して、レンダリングエンジンを使用して効率的にレンダリングできます。
Outlook on the webおよび新しい Outlook on Windows で本文にテーブル、リスト、リンクなどの書式設定された要素が含まれている場合は、getAsync呼び出しでOffice.CoercionType.Htmlを指定します。それ以外の場合は、空の文字列などの予期しない値を受け取る可能性があります。

例

// 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)

現在の本文を指定された形式で返します。

このメソッドは、現在の本文全体を、 coercionTypeで指定された形式で返します。

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

パラメーター

coercionType: Office.CoercionType | string

返される本文の形式です。

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

戻り値

void

注釈

最小アクセス許可レベル: 読み取り項目

適用できる Outlook モード: Composeまたは読み取り

重要:

HTML 形式の本文を操作する場合は、 Body.getAsync メソッドによって返される値が、必ずしも Body.setAsync メソッドで以前に渡された値とまったく同じとは限らないことに注意してください。クライアントは、 setAsync に渡される値を変更して、レンダリングエンジンを使用して効率的にレンダリングできます。
Outlook on the webおよび新しい Outlook on Windows で本文にテーブル、リスト、リンクなどの書式設定された要素が含まれている場合は、getAsync呼び出しでOffice.CoercionType.Htmlを指定します。それ以外の場合は、空の文字列などの予期しない値を受け取る可能性があります。

例

// 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)

コンテンツの形式が HTML とテキストのどちらであるかを示す値を取得します。

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

パラメーター

options: Office.AsyncContextOptions

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。コンテンツタイプは、asyncResult.value プロパティのCoercionType値の 1 つとして返されます。

戻り値

void

注釈

最小アクセス許可レベル: 読み取り項目

重要: Outlook on Android および iOS では、このメソッドはメッセージ Compose モードではサポートされていません。予定オーガナイザーモードのみがサポートされています。 Outlook モバイルでサポートされている API の詳細については、「モバイルデバイスで Outlook でサポートされている Outlook JavaScript API」を参照してください。

例

// 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)

コンテンツの形式が HTML とテキストのどちらであるかを示す値を取得します。

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

パラメーター

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

戻り値

void

注釈

最小アクセス許可レベル: 読み取り項目

prependAsync(data, options, callback)

アイテム本文の先頭に指定の内容を追加します。

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

パラメーター

data: string

本文の先頭に挿入する文字列。文字列の最大長は 1,000,000 文字です。

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

次のプロパティの 1 つ以上を含むオブジェクトリテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。 coercionType : 本文に必要な形式。パラメーター内の文字列は、この形式に変換されます。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。検出されたすべてのエラーは asyncResult.error プロパティに表示されます。

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み

推奨: getTypeAsyncを呼び出し、返された値を options.coercionType パラメーターに渡します。

重要:

コンテンツの先頭が追加された後、カーソルの位置は、アドインが実行されているクライアントによって異なります。 Outlook on the webと Windows (新規およびクラシック) では、カーソル位置は本文の既存のコンテンツでも同じままです。たとえば、カーソルが prependAsync 呼び出しの前に本文の先頭に配置された場合、前に追加されたコンテンツと、呼び出し後の本文の既存のコンテンツの間にカーソルが表示されます。 Outlook on Mac では、カーソル位置は保持されません。 prependAsync呼び出し後にカーソルが消え、ユーザーがメールアイテムの本文で何かを選択した場合にのみ再表示されます。
HTML 形式の本文を操作する場合は、クライアントがレンダリングエンジンで効率的にレンダリングできるように、 prependAsync に渡される値を変更する可能性があることに注意することが重要です。つまり、(メールボックス 1.3 で導入された) Body.getAsync メソッドの後続の呼び出しから返された値には、前の prependAsync 呼び出しで渡された正確な値が必ずしも含まれていないことを意味します。
HTML マークアップにリンクを含める場合は、アンカー (<a>) の id 属性を "LPNoLP" に設定することで、オンラインリンクプレビューを無効にすることができます (サンプルについては、「例」セクションを参照してください)。
Outlook on Android および iOS では、このメソッドはメッセージ Compose モードではサポートされていません。予定オーガナイザーモードのみがサポートされています。 Outlook モバイルでサポートされている API の詳細については、「モバイルデバイスで Outlook でサポートされている Outlook JavaScript API」を参照してください。
SVG ファイルはサポートされていません。代わりに JPG または PNG ファイルを使用します。
prependAsync メソッドでは、インライン CSS はサポートされていません。代わりに、内部 CSS または外部 CSS を使用します。

エラー:

DataExceedsMaximumSize : データパラメーターが 1,000,000 文字を超えています。

例

// 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)

アイテム本文の先頭に指定の内容を追加します。

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

パラメーター

data: string

本文の先頭に挿入する文字列。文字列の最大長は 1,000,000 文字です。

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

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み

推奨: getTypeAsyncを呼び出し、返された値を options.coercionType パラメーターに渡します。

重要:

コンテンツの先頭が追加された後、カーソルの位置は、アドインが実行されているクライアントによって異なります。 Outlook on the webと Windows (新規およびクラシック) では、カーソル位置は本文の既存のコンテンツでも同じままです。たとえば、カーソルが prependAsync 呼び出しの前に本文の先頭に配置された場合、前に追加されたコンテンツと、呼び出し後の本文の既存のコンテンツの間にカーソルが表示されます。 Outlook on Mac では、カーソル位置は保持されません。 prependAsync呼び出し後にカーソルが消え、ユーザーがメールアイテムの本文で何かを選択した場合にのみ再表示されます。
HTML 形式の本文を操作する場合は、クライアントがレンダリングエンジンで効率的にレンダリングできるように、 prependAsync に渡される値を変更する可能性があることに注意することが重要です。つまり、(メールボックス 1.3 で導入された) Body.getAsync メソッドの後続の呼び出しから返された値には、前の prependAsync 呼び出しで渡された正確な値が必ずしも含まれていないことを意味します。
HTML マークアップにリンクを含める場合は、アンカー (<a>) の id 属性を "LPNoLP" に設定することで、オンラインリンクプレビューを無効にすることができます (サンプルについては、「例」セクションを参照してください)。
Outlook on Android および iOS では、このメソッドはメッセージ Compose モードではサポートされていません。予定オーガナイザーモードのみがサポートされています。 Outlook モバイルでサポートされている API の詳細については、「モバイルデバイスで Outlook でサポートされている Outlook JavaScript API」を参照してください。
SVG ファイルはサポートされていません。代わりに JPG または PNG ファイルを使用します。
prependAsync メソッドでは、インライン CSS はサポートされていません。代わりに、内部 CSS または外部 CSS を使用します。

エラー:

DataExceedsMaximumSize : データパラメーターが 1,000,000 文字を超えています。

setAsync(data, options, callback)

本文全体を指定されたテキストに置換します。

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

パラメーター

data: string

既存の本文を置換する文字列。文字列の長さは 1,000,000 文字までに制限されています。

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、Office.AsyncResult 型の 1 つのパラメーターで呼び出されます。検出されたすべてのエラーは asyncResult.error プロパティに表示されます。

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み

推奨: getTypeAsyncを呼び出し、返された値を options.coercionType パラメーターに渡します。

重要:

本文が指定されたコンテンツに置き換えられた後、カーソルの位置は、アドインが実行されているクライアントによって異なります。従来の Outlook on Windows では、メールアイテムの本文の先頭にカーソルが表示されます。 Outlook on the webおよび新しい Outlook on Windows では、メールアイテムの本文の末尾にカーソルが表示されます。 Outlook on Mac では、カーソル位置は保持されません。 prependAsync呼び出し後にカーソルが消え、ユーザーがメールアイテムの本文で何かを選択した場合にのみ再表示されます。
HTML 形式の本文を操作する場合は、 Body.getAsync メソッドによって返される値が、必ずしも Body.setAsync メソッドで以前に渡された値とまったく同じとは限らないことに注意してください。クライアントは、 setAsync に渡される値を変更して、レンダリングエンジンを使用して効率的にレンダリングできます。
HTML マークアップにリンクを含める場合は、アンカー (<a>) の id 属性を "LPNoLP" に設定することで、オンラインリンクプレビューを無効にすることができます (サンプルについては、「例」セクションを参照してください)。
Outlook on Windows (クラシック) と Mac では、アドインユーザーは [元に戻す] コマンドを使用してこの操作を元に戻すことができません。
Outlook on Android および iOS では、このメソッドはメッセージ Compose モードではサポートされていません。予定オーガナイザーモードのみがサポートされています。 Outlook モバイルでサポートされている API の詳細については、「モバイルデバイスで Outlook でサポートされている Outlook JavaScript API」を参照してください。
SVG ファイルはサポートされていません。代わりに JPG または PNG ファイルを使用します。
setAsync メソッドでは、インライン CSS はサポートされていません。代わりに、内部 CSS または外部 CSS を使用します。

エラー:

DataExceedsMaximumSize : データパラメーターが 1,000,000 文字を超えています。
InvalidFormatError : options.coercionType パラメーターは Office.CoercionType.Html に設定され、メッセージ本文はプレーンテキストです。

例

// 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)

本文全体を指定されたテキストに置換します。

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

パラメーター

data: string

既存の本文を置換する文字列。文字列の長さは 1,000,000 文字までに制限されています。

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

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み

推奨: getTypeAsyncを呼び出し、返された値を options.coercionType パラメーターに渡します。

重要:

本文が指定されたコンテンツに置き換えられた後、カーソルの位置は、アドインが実行されているクライアントによって異なります。従来の Outlook on Windows では、メールアイテムの本文の先頭にカーソルが表示されます。 Outlook on the webおよび新しい Outlook on Windows では、メールアイテムの本文の末尾にカーソルが表示されます。 Outlook on Mac では、カーソル位置は保持されません。 prependAsync呼び出し後にカーソルが消え、ユーザーがメールアイテムの本文で何かを選択した場合にのみ再表示されます。
HTML 形式の本文を操作する場合は、 Body.getAsync メソッドによって返される値が、必ずしも Body.setAsync メソッドで以前に渡された値とまったく同じとは限らないことに注意してください。クライアントは、 setAsync に渡される値を変更して、レンダリングエンジンを使用して効率的にレンダリングできます。
HTML マークアップにリンクを含める場合は、アンカー (<a>) の id 属性を "LPNoLP" に設定することで、オンラインリンクプレビューを無効にすることができます (サンプルについては、「例」セクションを参照してください)。
Outlook on Windows (クラシック) と Mac では、アドインユーザーは [元に戻す] コマンドを使用してこの操作を元に戻すことができません。
Outlook on Android および iOS では、このメソッドはメッセージ Compose モードではサポートされていません。予定オーガナイザーモードのみがサポートされています。 Outlook モバイルでサポートされている API の詳細については、「モバイルデバイスで Outlook でサポートされている Outlook JavaScript API」を参照してください。
SVG ファイルはサポートされていません。代わりに JPG または PNG ファイルを使用します。
setAsync メソッドでは、インライン CSS はサポートされていません。代わりに、内部 CSS または外部 CSS を使用します。

エラー:

DataExceedsMaximumSize : データパラメーターが 1,000,000 文字を超えています。
InvalidFormatError : options.coercionType パラメーターは Office.CoercionType.Html に設定され、メッセージ本文はプレーンテキストです。

setSelectedDataAsync(data, options, callback)

本文の選択部分を、指定のテキストに置き換えます。

setSelectedDataAsync メソッドは、指定した文字列を項目の本文のカーソル位置に挿入するか、エディターでテキストが選択されている場合は、選択したテキストを置き換えます。カーソルが項目の本文に含まれなかった場合、または項目の本文が UI でフォーカスを失った場合は、本文コンテンツの先頭に文字列が挿入されます。挿入後、カーソルは挿入されたコンテンツの末尾に配置されます。

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

パラメーター

data: string

既存の本文を置換する文字列。文字列の長さは 1,000,000 文字までに制限されています。

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

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

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み

推奨: getTypeAsync を呼び出し、返された値を options.coercionType パラメーターに渡します。

* 重要:

HTML マークアップにリンクを含める場合は、アンカー (<a>) の id 属性を "LPNoLP" に設定することで、オンラインリンクプレビューを無効にすることができます (サンプルについては、「例」セクションを参照してください)。
SVG ファイルはサポートされていません。代わりに JPG または PNG ファイルを使用します。
setSelectedDataAsync メソッドでは、インライン CSS はサポートされていません。代わりに、内部 CSS または外部 CSS を使用します。

エラー:

DataExceedsMaximumSize : data パラメーターが 1,000,000 文字を超えています。
InvalidFormatError : options.coercionType パラメーターは Office.CoercionType.Html に設定され、メッセージ本文はプレーンテキストです。

例

// 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)

本文の選択部分を、指定のテキストに置き換えます。

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

パラメーター

data: string

既存の本文を置換する文字列。文字列の長さは 1,000,000 文字までに制限されています。

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

戻り値

void

注釈

最小アクセス許可レベル: 項目の読み取り/書き込み