Office.AppointmentCompose interface

リファレンス

パッケージ:: outlook

重要: これは内部 Outlook オブジェクトであり、既存のインターフェイスを介して直接公開されることはありません。これは、 Office.context.mailbox.itemのモードとして扱う必要があります。詳細については、「オブジェクトモデル」ページを参照してください。

親インターフェイス:

Extends: Office.Appointment

プロパティ

body	アイテムの本文を操作するメソッドを提供するオブジェクトを取得します。
end	予定が終了する日時を取得または設定します。 `end` プロパティは、協定世界時 (UTC) の日付と時刻の値として表される Time オブジェクトです。 `convertToLocalClientTime` メソッドを使用して、`end` プロパティの値をクライアントのローカルの日付と時刻に変換できます。 `Time.setAsync` メソッドを使用して終了時刻を設定する場合、`convertToUtcClientTime` メソッドを使用して、クライアント上のローカルの時刻をサーバーの UTC に変換する必要があります。重要: Windows クライアントでは、このプロパティを使用して繰り返しの終了を更新することはできません。
itemType	インスタンスが表しているアイテムの種類を取得します。 `itemType` プロパティは、`ItemType` 列挙値の 1 つを返します。これは `item` オブジェクトインスタンスがメッセージと予定のどちらであるかを示すものです。
location	予定の場所を取得または設定します。 `location` プロパティは、予定の場所を取得および設定するために使用されるメソッドを提供する Location オブジェクトを返します。
optionalAttendees	イベントの任意出席者へのアクセスを提供します。オブジェクトの種類とアクセスレベルは、現在の項目のモードによって異なります。 `optionalAttendees` プロパティは会議への任意出席者を取得または更新するためのメソッドを提供する `Recipients` オブジェクトを返します。ただし、クライアント/プラットフォーム (Windows、Mac など) によっては、取得または更新できる受信者の数に制限が適用される場合があります。詳細については、 Recipients オブジェクトを参照してください。
requiredAttendees	イベントの必須出席者へのアクセスを提供します。オブジェクトの種類とアクセスレベルは、現在の項目のモードによって異なります。 `requiredAttendees` プロパティは会議への必須出席者を取得または更新するためのメソッドを提供する `Recipients` オブジェクトを返します。ただし、クライアント/プラットフォーム (Windows、Mac など) によっては、取得または更新できる受信者の数に制限が適用される場合があります。詳細については、 Recipients オブジェクトを参照してください。
start	予定を開始する日時を取得または設定します。 `start` プロパティは、協定世界時 (UTC) の日付と時刻の値として表される Time オブジェクトです。 `convertToLocalClientTime` メソッドを使用して、値をクライアントのローカルの日付と時刻に変換できます。 `Time.setAsync` メソッドを使用して開始時刻を設定する場合、`convertToUtcClientTime` メソッドを使用して、クライアント上のローカルの時刻をサーバーの UTC に変換する必要があります。重要: Windows クライアントでは、このプロパティを使用して繰り返しの開始を更新することはできません。
subject	アイテムの件名フィールドに示される説明を取得または設定します。 `subject` プロパティは、電子メールサーバーによって送信されたアイテムの件名全体を取得または設定します。 `subject` プロパティは件名を取得および設定するためのメソッドを提供する `Subject` オブジェクトを返します。

メソッド

addFileAttachmentAsync(uri, attachmentName, options, callback)	ファイルを添付ファイルとしてメッセージまたは予定に追加します。 `addFileAttachmentAsync` メソッドは、指定した URI にあるファイルをアップロードし、新規作成フォーム内のアイテムに添付します。
addFileAttachmentAsync(uri, attachmentName, callback)	ファイルを添付ファイルとしてメッセージまたは予定に追加します。 `addFileAttachmentAsync` メソッドは、指定した URI にあるファイルをアップロードし、新規作成フォーム内のアイテムに添付します。
addItemAttachmentAsync(itemId, attachmentName, options, callback)	メッセージなどの Exchange アイテムを添付ファイルとして、メッセージまたは予定に追加します。 `addItemAttachmentAsync` メソッドは、指定された Exchange 識別子を持つアイテムを新規作成フォームのアイテムにアタッチします。コールバック関数を指定した場合、メソッドは、添付ファイル識別子または項目の添付中に発生したエラーを示すコードを含む 1 つのパラメーター `asyncResult` で呼び出されます。 `options` パラメーターを使用して、必要に応じて状態情報をコールバック関数に渡すことができます。その後、`removeAttachmentAsync` メソッドで識別子を使用して同じセッションの添付ファイルを削除できます。 Office アドインがOutlook on the webおよび新しい Outlook on Windows で実行されている場合、`addItemAttachmentAsync` メソッドは、編集中のアイテム以外のアイテムにアイテムを添付できます。ただし、これはサポートされていないため、推奨されません。
addItemAttachmentAsync(itemId, attachmentName, callback)	メッセージなどの Exchange アイテムを添付ファイルとして、メッセージまたは予定に追加します。 `addItemAttachmentAsync` メソッドは、指定された Exchange 識別子を持つアイテムを新規作成フォームのアイテムにアタッチします。コールバック関数を指定した場合、メソッドは、添付ファイル識別子または項目の添付中に発生したエラーを示すコードを含む 1 つのパラメーター `asyncResult` で呼び出されます。 `options` パラメーターを使用して、必要に応じて状態情報をコールバック関数に渡すことができます。その後、`removeAttachmentAsync` メソッドで識別子を使用して同じセッションの添付ファイルを削除できます。 Office アドインがOutlook on the webおよび新しい Outlook on Windows で実行されている場合、`addItemAttachmentAsync` メソッドは、編集中のアイテム以外のアイテムにアイテムを添付できます。ただし、これはサポートされていないため、推奨されません。
getSelectedDataAsync(coercionType, options, callback)	メッセージの件名または本文から非同期的に選択したデータを返します。選択範囲がないのにカーソルが本文または件名にある場合、メソッドは選択したデータの空の文字列を返します。本文または件名以外のフィールドが選択されている場合、`InvalidSelection` エラーが返されます。コールバック関数から選択したデータにアクセスするには、 `asyncResult.value.data`を呼び出します。選択範囲の`source` プロパティにアクセスするには、`body`または`subjectasyncResult.value.sourceProperty`を呼び出します。
getSelectedDataAsync(coercionType, callback)	メッセージの件名または本文から非同期的に選択したデータを返します。選択範囲がないのにカーソルが本文または件名にある場合、メソッドは選択したデータの空の文字列を返します。本文または件名以外のフィールドが選択されている場合、`InvalidSelection` エラーが返されます。コールバック関数から選択したデータにアクセスするには、 `asyncResult.value.data`を呼び出します。選択範囲の`source` プロパティにアクセスするには、`body`または`subjectasyncResult.value.sourceProperty`を呼び出します。
loadCustomPropertiesAsync(callback, userContext)	選択されたアイテムのこのアドインのカスタムプロパティを非同期に読み込みます。カスタムプロパティは、アプリごとに項目ごとにキーと値のペアとして格納されます。このメソッドはコールバックで CustomProperties オブジェクトを返します。これにより、現在のアイテムと現在のアドインに固有のカスタムプロパティにアクセスするメソッドが提供されます。カスタムプロパティはアイテムで暗号化されないため、セキュリティで保護されたストレージとして使用しないでください。カスタムプロパティは `asyncResult.value` プロパティの `CustomProperties` オブジェクトとして指定されます。このオブジェクトを使用して、メールアイテムのカスタムプロパティを取得、設定、保存、および削除できます。
removeAttachmentAsync(attachmentId, options, callback)	メッセージまたは予定から添付ファイルを削除します。 `removeAttachmentAsync` メソッドは、指定した識別子の添付ファイルをアイテムから削除します。ベストプラクティスとして、同じメールアプリが同じセッションで添付ファイルを追加した場合にのみ、その添付ファイルの識別子を使用して添付ファイルを削除することをお勧めします。 Outlook on the web、モバイルデバイス、および新しい Outlook on Windows では添付ファイル識別子は同じセッション内でのみ有効です。ユーザーがアプリを閉じると、またはユーザーがインラインフォームの作成を開始すると、その後フォームがポップアップ表示され、別のウィンドウで続行されます。
removeAttachmentAsync(attachmentId, callback)	メッセージまたは予定から添付ファイルを削除します。 `removeAttachmentAsync` メソッドは、指定した識別子の添付ファイルをアイテムから削除します。ベストプラクティスとして、同じメールアプリが同じセッションで添付ファイルを追加した場合にのみ、その添付ファイルの識別子を使用して添付ファイルを削除することをお勧めします。 Outlook on the web、モバイルデバイス、および新しい Outlook on Windows では添付ファイル識別子は同じセッション内でのみ有効です。ユーザーがアプリを閉じると、またはユーザーがインラインフォームの作成を開始すると、その後フォームがポップアップ表示され、別のウィンドウで続行されます。
setSelectedDataAsync(data, options, callback)	メッセージの本文または件名に非同期的にデータを挿入します。 `setSelectedDataAsync` メソッドは、指定した文字列を項目の件名または本文のカーソル位置に挿入するか、エディターでテキストが選択されている場合は、選択したテキストを置き換えます。カーソルが本文または件名フィールドにない場合は、エラーが返されます。挿入後、カーソルは挿入されたコンテンツの末尾に配置されます。
setSelectedDataAsync(data, callback)	メッセージの本文または件名に非同期的にデータを挿入します。 `setSelectedDataAsync` メソッドは、指定した文字列を項目の件名または本文のカーソル位置に挿入するか、エディターでテキストが選択されている場合は、選択したテキストを置き換えます。カーソルが本文または件名フィールドにない場合は、エラーが返されます。挿入後、カーソルは挿入されたコンテンツの末尾に配置されます。

プロパティの詳細

body

アイテムの本文を操作するメソッドを提供するオブジェクトを取得します。

body: Body;

プロパティ値

Office.Body

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

例

// 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 an object that is passed as the result parameter to the callback function.
{
    "value": "TEXT of whole body (including threads below)",
    "status": "succeeded",
    "asyncContext": "This is passed to the callback"
}

end

予定が終了する日時を取得または設定します。

end プロパティは、協定世界時 (UTC) の日付と時刻の値として表される Time オブジェクトです。 convertToLocalClientTime メソッドを使用して、end プロパティの値をクライアントのローカルの日付と時刻に変換できます。

Time.setAsync メソッドを使用して終了時刻を設定する場合、convertToUtcClientTime メソッドを使用して、クライアント上のローカルの時刻をサーバーの UTC に変換する必要があります。

重要: Windows クライアントでは、このプロパティを使用して繰り返しの終了を更新することはできません。

end: Time;

プロパティ値

Office.Time

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

// The following example sets the end time of an appointment in compose mode by
// using the `setAsync` method of the `Time` object.
const endTime = new Date("3/14/2015");
const options = {
    // Pass information that can be used in the callback.
    asyncContext: {verb: "Set"}
};
Office.context.mailbox.item.end.setAsync(endTime, options, function(result) {
    if (result.error) {
        console.debug(result.error);
    } else {
        // Access the asyncContext that was passed to the setAsync method.
        console.debug("End Time " + result.asyncContext.verb);
    }
});

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-end-appointment-organizer.yaml

Office.context.mailbox.item.end.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Appointment ends: ${result.value}`);
});

...

Office.context.mailbox.item.start.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Get start date failed with message ${result.error.message}`);
    return;
  }

  const end = result.value; // Set end to current start date and time.
  end.setDate(end.getDate() + 1); // Set end as 1 day later than start date.
  Office.context.mailbox.item.end.setAsync(end, (result) => {
    if (result.status !== Office.AsyncResultStatus.Succeeded) {
      console.error(`Set end date failed with message ${result.error.message}`);
      return;
    }
    console.log(`Successfully set end date and time to ${end}`);
  });
});

itemType

インスタンスが表しているアイテムの種類を取得します。

itemType プロパティは、ItemType 列挙値の 1 つを返します。これは item オブジェクトインスタンスがメッセージと予定のどちらであるかを示すものです。

itemType: MailboxEnums.ItemType | string;

プロパティ値

Office.MailboxEnums.ItemType | string

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

// 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;
}

location

予定の場所を取得または設定します。 location プロパティは、予定の場所を取得および設定するために使用されるメソッドを提供する Location オブジェクトを返します。

location: Location;

プロパティ値

Office.Location

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

const userContext = { value : 1 };
Office.context.mailbox.item.location.getAsync( { context: userContext}, callback);

function callback(asyncResult) {
    const context = asyncResult.context;
    const location = asyncResult.value;
}

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-location-appointment-organizer.yaml

Office.context.mailbox.item.location.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Appointment location: ${result.value}`);
});

...

const location = "my office";
Office.context.mailbox.item.location.setAsync(location, (result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Successfully set location to ${location}`);
});

optionalAttendees

イベントの任意出席者へのアクセスを提供します。オブジェクトの種類とアクセスレベルは、現在の項目のモードによって異なります。

optionalAttendees プロパティは会議への任意出席者を取得または更新するためのメソッドを提供する Recipients オブジェクトを返します。ただし、クライアント/プラットフォーム (Windows、Mac など) によっては、取得または更新できる受信者の数に制限が適用される場合があります。詳細については、 Recipients オブジェクトを参照してください。

optionalAttendees: Recipients;

プロパティ値

Office.Recipients

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

Office.context.mailbox.item.optionalAttendees.setAsync( ['alice@contoso.com', 'bob@contoso.com'] );
Office.context.mailbox.item.optionalAttendees.addAsync( ['jason@contoso.com'] );
Office.context.mailbox.item.optionalAttendees.getAsync(callback);

function callback(asyncResult) {
    const arrayOfOptionalAttendeesRecipients = asyncResult.value;
}

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-optional-attendees-appointment-organizer.yaml

Office.context.mailbox.item.optionalAttendees.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const apptOptionalAttendees = asyncResult.value;
    for (let i = 0; i < apptOptionalAttendees.length; i++) {
      console.log(
        "Optional attendees: " +
          apptOptionalAttendees[i].displayName +
          " (" +
          apptOptionalAttendees[i].emailAddress +
          ") - response: " +
          apptOptionalAttendees[i].appointmentResponse
      );
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailOptional")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.optionalAttendees.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting optional attendees field.");
  } else {
    console.error(asyncResult.error);
  }
});

requiredAttendees

イベントの必須出席者へのアクセスを提供します。オブジェクトの種類とアクセスレベルは、現在の項目のモードによって異なります。

requiredAttendees プロパティは会議への必須出席者を取得または更新するためのメソッドを提供する Recipients オブジェクトを返します。ただし、クライアント/プラットフォーム (Windows、Mac など) によっては、取得または更新できる受信者の数に制限が適用される場合があります。詳細については、 Recipients オブジェクトを参照してください。

requiredAttendees: Recipients;

プロパティ値

Office.Recipients

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

Office.context.mailbox.item.requiredAttendees.setAsync( ['alice@contoso.com', 'bob@contoso.com'] );
Office.context.mailbox.item.requiredAttendees.addAsync( ['jason@contoso.com'] );
Office.context.mailbox.item.requiredAttendees.getAsync(callback);

function callback(asyncResult) {
    const arrayOfRequiredAttendeesRecipients = asyncResult.value;
    console.log(JSON.stringify(arrayOfRequiredAttendeesRecipients));
}

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/30-recipients-and-attendees/get-set-required-attendees-appointment-organizer.yaml

Office.context.mailbox.item.requiredAttendees.getAsync(function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    const apptRequiredAttendees = asyncResult.value;
    for (let i = 0; i < apptRequiredAttendees.length; i++) {
      console.log(
        "Required attendees: " +
          apptRequiredAttendees[i].displayName +
          " (" +
          apptRequiredAttendees[i].emailAddress +
          ") - response: " +
          apptRequiredAttendees[i].appointmentResponse
      );
    }
  } else {
    console.error(asyncResult.error);
  }
});

...

const email = $("#emailRequired")
  .val()
  .toString();
const emailArray = [email];
Office.context.mailbox.item.requiredAttendees.setAsync(emailArray, function(asyncResult) {
  if (asyncResult.status === Office.AsyncResultStatus.Succeeded) {
    console.log("Succeeded in setting required attendees field.");
  } else {
    console.error(asyncResult.error);
  }
});

start

予定を開始する日時を取得または設定します。

start プロパティは、協定世界時 (UTC) の日付と時刻の値として表される Time オブジェクトです。 convertToLocalClientTime メソッドを使用して、値をクライアントのローカルの日付と時刻に変換できます。

Time.setAsync メソッドを使用して開始時刻を設定する場合、convertToUtcClientTime メソッドを使用して、クライアント上のローカルの時刻をサーバーの UTC に変換する必要があります。

重要: Windows クライアントでは、このプロパティを使用して繰り返しの開始を更新することはできません。

start: Time;

プロパティ値

Office.Time

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/90-other-item-apis/get-set-start-appointment-organizer.yaml

Office.context.mailbox.item.start.getAsync((result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Appointment starts: ${result.value}`);
});

...

const start = new Date(); // Represents current date and time.
start.setDate(start.getDate() + 2); // Add 2 days to current date.
Office.context.mailbox.item.start.setAsync(start, (result) => {
  if (result.status !== Office.AsyncResultStatus.Succeeded) {
    console.error(`Action failed with message ${result.error.message}`);
    return;
  }
  console.log(`Successfully set start date and time to ${start}`);
});

subject

アイテムの件名フィールドに示される説明を取得または設定します。

subject プロパティは、電子メールサーバーによって送信されたアイテムの件名全体を取得または設定します。

subject プロパティは件名を取得および設定するためのメソッドを提供する Subject オブジェクトを返します。

subject: Subject;

プロパティ値

Office.Subject

注釈

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

適用される Outlook モード: 予定オーガナイザー

例

// 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}`);
});

メソッドの詳細

addFileAttachmentAsync(uri, attachmentName, options, callback)

ファイルを添付ファイルとしてメッセージまたは予定に追加します。

addFileAttachmentAsync メソッドは、指定した URI にあるファイルをアップロードし、新規作成フォーム内のアイテムに添付します。

addFileAttachmentAsync(uri: string, attachmentName: string, options: Office.AsyncContextOptions & { isInline: boolean }, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

パラメーター

uri: string

メッセージまたは予定に添付するファイルの場所を示す URI。最大長は 2048 文字です。

attachmentName: string

添付ファイルのアップロード時に表示される添付ファイルの名前。最大の長さは、255 文字です。

options: Office.AsyncContextOptions & { isInline: boolean }

次のプロパティの 1 つ以上を含むオブジェクトリテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。 isInline : true の場合、添付ファイルはメッセージ本文の画像としてインラインで表示され、添付ファイルの一覧には表示されません。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。成功すると、添付ファイルの識別子が asyncResult.value プロパティに設定されます。添付ファイルのアップロードに失敗した場合、asyncResult オブジェクトには、エラーの説明を提供する Error オブジェクトが含まれます。

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

重要:

Windows 上の従来の Outlook の最近のビルドでは、このアクションに Authorization: Bearer ヘッダーを誤って追加するバグが導入されました (この API を使用するか、Outlook UI を使用するか)。この問題を回避するには、要件セット 1.8 で導入された addFileAttachmentFromBase64 API の使用を試すことができます。
添付するファイルの URI は、運用環境でのキャッシュをサポートしている必要があります。イメージをホストしているサーバーは、HTTP 応答でno-cache、no-store、または同様のオプションを指定するCache-Control ヘッダーを返すべきではありません。ただし、アドインを開発し、ファイルに変更を加えると、キャッシュによって変更が表示されない可能性があります。開発中に Cache-Control ヘッダーを使用することをお勧めします。
removeAttachmentAsync メソッドで同じ URI を使用して、同じセッション内の添付ファイルを削除できます。

エラー:

AttachmentSizeExceeded : 添付ファイルが許可されているよりも大きい。
FileTypeNotSupported : 添付ファイルには、許可されていない拡張機能があります。
NumberOfAttachmentsExceeded : メッセージまたは予定に添付ファイルが多すぎます。

例

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

ファイルを添付ファイルとしてメッセージまたは予定に追加します。

addFileAttachmentAsync メソッドは、指定した URI にあるファイルをアップロードし、新規作成フォーム内のアイテムに添付します。

addFileAttachmentAsync(uri: string, attachmentName: string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

パラメーター

uri: string

メッセージまたは予定に添付するファイルの場所を示す URI。最大長は 2048 文字です。

attachmentName: string

添付ファイルのアップロード時に表示される添付ファイルの名前。最大の長さは、255 文字です。

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

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

重要:

Windows 上の従来の Outlook の最近のビルドでは、このアクションに Authorization: Bearer ヘッダーを誤って追加するバグが導入されました (この API を使用するか、Outlook UI を使用するか)。この問題を回避するには、要件セット 1.8 で導入された addFileAttachmentFromBase64 API の使用を試すことができます。
添付するファイルの URI は、運用環境でのキャッシュをサポートしている必要があります。イメージをホストしているサーバーは、HTTP 応答でno-cache、no-store、または同様のオプションを指定するCache-Control ヘッダーを返すべきではありません。ただし、アドインを開発し、ファイルに変更を加えると、キャッシュによって変更が表示されない可能性があります。開発中に Cache-Control ヘッダーを使用することをお勧めします。
removeAttachmentAsync メソッドで同じ URI を使用して、同じセッション内の添付ファイルを削除できます。

エラー:

AttachmentSizeExceeded : 添付ファイルが許可されているよりも大きい。
FileTypeNotSupported : 添付ファイルには、許可されていない拡張機能があります。
NumberOfAttachmentsExceeded : メッセージまたは予定に添付ファイルが多すぎます。

addItemAttachmentAsync(itemId, attachmentName, options, callback)

メッセージなどの Exchange アイテムを添付ファイルとして、メッセージまたは予定に追加します。

addItemAttachmentAsync メソッドは、指定された Exchange 識別子を持つアイテムを新規作成フォームのアイテムにアタッチします。コールバック関数を指定した場合、メソッドは、添付ファイル識別子または項目の添付中に発生したエラーを示すコードを含む 1 つのパラメーター asyncResult で呼び出されます。 options パラメーターを使用して、必要に応じて状態情報をコールバック関数に渡すことができます。

その後、removeAttachmentAsync メソッドで識別子を使用して同じセッションの添付ファイルを削除できます。

Office アドインがOutlook on the webおよび新しい Outlook on Windows で実行されている場合、addItemAttachmentAsync メソッドは、編集中のアイテム以外のアイテムにアイテムを添付できます。ただし、これはサポートされていないため、推奨されません。

addItemAttachmentAsync(itemId: any, attachmentName: string, options: Office.AsyncContextOptions, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

パラメーター

itemId: any

添付するアイテムの Exchange 識別子。最大長は 100 文字です。

attachmentName: string

添付ファイルのアップロード時に表示される添付ファイルの名前。最大の長さは、255 文字です。

options: Office.AsyncContextOptions

次のプロパティの 1 つ以上を含むオブジェクトリテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。

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

省略可能。メソッドが完了すると、コールバックパラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。成功すると、添付ファイルの識別子が asyncResult.value プロパティに設定されます。添付ファイルの追加に失敗した場合、asyncResult オブジェクトには、エラーの説明を提供する Error オブジェクトが含まれます。

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

エラー:

NumberOfAttachmentsExceeded : メッセージまたは予定に添付ファイルが多すぎます。

例

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

メッセージなどの Exchange アイテムを添付ファイルとして、メッセージまたは予定に追加します。

その後、removeAttachmentAsync メソッドで識別子を使用して同じセッションの添付ファイルを削除できます。

addItemAttachmentAsync(itemId: any, attachmentName: string, callback?: (asyncResult: Office.AsyncResult<string>) => void): void;

パラメーター

itemId: any

添付するアイテムの Exchange 識別子。最大長は 100 文字です。

attachmentName: string

添付ファイルのアップロード時に表示される添付ファイルの名前。最大の長さは、255 文字です。

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

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

エラー:

NumberOfAttachmentsExceeded : メッセージまたは予定に添付ファイルが多すぎます。

getSelectedDataAsync(coercionType, options, callback)

メッセージの件名または本文から非同期的に選択したデータを返します。

選択範囲がないのにカーソルが本文または件名にある場合、メソッドは選択したデータの空の文字列を返します。本文または件名以外のフィールドが選択されている場合、InvalidSelection エラーが返されます。

コールバック関数から選択したデータにアクセスするには、 asyncResult.value.dataを呼び出します。選択範囲のsource プロパティにアクセスするには、bodyまたはsubjectasyncResult.value.sourcePropertyを呼び出します。

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

パラメーター

coercionType: Office.CoercionType | string

データの形式を要求します。 Text 場合、メソッドはプレーンテキストを文字列として返し、存在するすべての HTML タグを削除します。 HTML 場合、メソッドは選択したテキスト (プレーンテキストまたは HTML) を返します。

options: Office.AsyncContextOptions

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

メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。

戻り値

void

coercionType によって決定される形式の文字列として選択されたデータ。

注釈

[ API セット: メールボックス 1.2 ]

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

適用される Outlook モード: 予定オーガナイザー

例

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

メッセージの件名または本文から非同期的に選択したデータを返します。

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

パラメーター

coercionType: Office.CoercionType | string

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

メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。

戻り値

void

coercionType によって決定される形式の文字列として選択されたデータ。

注釈

[ API セット: メールボックス 1.2 ]

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

適用される Outlook モード: 予定オーガナイザー

例

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

loadCustomPropertiesAsync(callback, userContext)

選択されたアイテムのこのアドインのカスタムプロパティを非同期に読み込みます。

カスタムプロパティは、アプリごとに項目ごとにキーと値のペアとして格納されます。このメソッドはコールバックで CustomProperties オブジェクトを返します。これにより、現在のアイテムと現在のアドインに固有のカスタムプロパティにアクセスするメソッドが提供されます。カスタムプロパティはアイテムで暗号化されないため、セキュリティで保護されたストレージとして使用しないでください。

カスタムプロパティは asyncResult.value プロパティの CustomProperties オブジェクトとして指定されます。このオブジェクトを使用して、メールアイテムのカスタムプロパティを取得、設定、保存、および削除できます。

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

パラメーター

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

メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。

userContext: any

省略可能。開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。このオブジェクトには、コールバック関数の asyncResult.asyncContext プロパティによってアクセスすることができます。

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

カスタムプロパティの詳細については、「 Outlook アドインのアドインメタデータを取得して設定する」を参照してください。

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

適用される Outlook モード: 予定オーガナイザー

例

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

メッセージまたは予定から添付ファイルを削除します。

removeAttachmentAsync メソッドは、指定した識別子の添付ファイルをアイテムから削除します。ベストプラクティスとして、同じメールアプリが同じセッションで添付ファイルを追加した場合にのみ、その添付ファイルの識別子を使用して添付ファイルを削除することをお勧めします。 Outlook on the web、モバイルデバイス、および新しい Outlook on Windows では添付ファイル識別子は同じセッション内でのみ有効です。ユーザーがアプリを閉じると、またはユーザーがインラインフォームの作成を開始すると、その後フォームがポップアップ表示され、別のウィンドウで続行されます。

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

パラメーター

attachmentId: string

削除する添付ファイルの識別子。 attachmentIdの最大文字列長は、Outlook on the webおよび Windows (新規およびクラシック) では 200 文字です。

options: Office.AsyncContextOptions

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。添付ファイルの削除に失敗すると、asyncResult.error プロパティにはエラーコードとエラーの理由が含まれます。

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

重要*: removeAttachmentAsync メソッドは、メールアイテムからインライン添付ファイルを削除しません。インライン添付ファイルを削除するには、まずアイテムの本文を取得し、その内容から添付ファイルの参照を削除します。 Office.Body API を使用して、アイテムの本文を取得および設定します。

エラー:

InvalidAttachmentId : 添付ファイル識別子が存在しません。

例

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

メッセージまたは予定から添付ファイルを削除します。

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

パラメーター

attachmentId: string

削除する添付ファイルの識別子。 attachmentIdの最大文字列長は、Outlook on the webおよび Windows (新規およびクラシック) では 200 文字です。

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

戻り値

void

注釈

[ API セット: メールボックス 1.1 ]

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

適用される Outlook モード: 予定オーガナイザー

エラー:

InvalidAttachmentId : 添付ファイル識別子が存在しません。

setSelectedDataAsync(data, options, callback)

メッセージの本文または件名に非同期的にデータを挿入します。

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

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

パラメーター

data: string

挿入されるデータ。データの最大の長さは 1,000,000 文字です。 1,000,000 文字を超えるデータが渡されると、ArgumentOutOfRange 例外がスローされます。

options: Office.AsyncContextOptions & Office.CoercionTypeOptions

次のプロパティの 1 つ以上を含むオブジェクトリテラル:- asyncContext: 開発者は、コールバック関数でアクセスする任意のオブジェクトを指定できます。 coercionType : テキストの場合、現在のスタイルは、Outlook on the web、Windows (新規およびクラシック)、および Mac で適用されます。フィールドが HTML エディターの場合、データが HTML の場合でもテキストデータのみが挿入されます。データが HTML で、フィールドが HTML をサポートしている場合 (件名はサポートされていません)、現在のスタイルはOutlook on the webおよび新しい Outlook on Windows に適用されます。既定のスタイルは、Outlook on Windows (クラシック) と Mac で適用されます。フィールドがテキストフィールドの場合、InvalidDataFormat エラーが返されます。 coercionType が設定されていない場合、結果はフィールドによって変わります。フィールドが HTML の場合は HTML が使用されます。フィールドがテキストの場合はプレーンテキストが使用されます。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。

戻り値

void

注釈

[ API セット: メールボックス 1.2 ]

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

適用される Outlook モード: 予定オーガナイザー

エラー:

InvalidAttachmentId : 添付ファイル識別子が存在しません。

例

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)

メッセージの本文または件名に非同期的にデータを挿入します。

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

パラメーター

data: string

挿入されるデータ。データの最大の長さは 1,000,000 文字です。 1,000,000 文字を超えるデータが渡されると、ArgumentOutOfRange 例外がスローされます。

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

省略可能。メソッドが完了すると、 callback パラメーターで渡された関数が、 Office.AsyncResult型の 1 つのパラメーターで呼び出されます。

戻り値

void

注釈

[ API セット: メールボックス 1.2 ]

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

適用される Outlook モード: 予定オーガナイザー

エラー:

InvalidAttachmentId : 添付ファイル識別子が存在しません。

次の方法で共有

Office.AppointmentCompose interface

プロパティ

メソッド

プロパティの詳細

body

プロパティ値

注釈

例

end

プロパティ値

注釈

例

itemType

プロパティ値

注釈

例

location

プロパティ値

注釈

例

optionalAttendees

プロパティ値

注釈

例

requiredAttendees

プロパティ値

注釈

例

start

プロパティ値

注釈

例

subject

プロパティ値

注釈

例

メソッドの詳細

addFileAttachmentAsync(uri, attachmentName, options, callback)

パラメーター

戻り値

注釈

例

addFileAttachmentAsync(uri, attachmentName, callback)

パラメーター

戻り値

注釈

addItemAttachmentAsync(itemId, attachmentName, options, callback)

パラメーター

戻り値

注釈

例

addItemAttachmentAsync(itemId, attachmentName, callback)

パラメーター

戻り値

注釈

getSelectedDataAsync(coercionType, options, callback)

パラメーター

戻り値

注釈

例

getSelectedDataAsync(coercionType, callback)

パラメーター

戻り値

注釈

例

loadCustomPropertiesAsync(callback, userContext)

パラメーター

戻り値

注釈

例

removeAttachmentAsync(attachmentId, options, callback)

パラメーター

戻り値

注釈

例

removeAttachmentAsync(attachmentId, callback)

パラメーター

戻り値

注釈