Office.RoamingSettings interface
オブジェクトの RoamingSettings
メソッドを使用して作成された設定は、アドインごと、およびユーザーごとに保存されます。 つまり、それらが作成されたアドインでのみ使用でき、保存されているユーザーのメールボックスからのみ使用できます。
Outlook アドイン API では、これらの設定へのアクセスは、それらの設定を作成したアドインのみに制限しますが、これらの設定はセキュリティで保護されたストレージと見なすべきではありません。 これらの設定は、Exchange Web サービスや拡張 MAPI からアクセスできます。 ユーザー資格情報やセキュリティ トークンなどの機密情報を格納するために使用しないでください。
設定の名前は String ですが、値は String、Number、Boolean、null、Object、Array のいずれかになります。
オブジェクトにはRoamingSettings
、名前空間の Office.context
プロパティをroamingSettings
使用してアクセスできます。
の詳細RoamingSettings
については、「Outlook アドインのアドイン メタデータを取得して設定する」を参照してください。
注釈
重要:
オブジェクトは
RoamingSettings
、アドインが最初に読み込まれたときにのみ、永続化されたストレージから初期化されます。 作業ウィンドウの場合、これは作業ウィンドウが最初に開いたときにのみ初期化されることを意味します。 作業ウィンドウが別のページに移動するか、現在のページを再読み込みした場合、アドインが変更を永続化した場合でも、メモリ内オブジェクトは初期値にリセットされます。 永続化された変更は、作業ウィンドウ (または UI レス アドインの場合はアイテム) が閉じられ、再度開くまで使用できません。Outlook on Windows または Mac で設定して保存すると、これらの設定はブラウザーの更新後にのみOutlook on the webに反映されます。
最小アクセス許可レベル: 制限
適用できる Outlook モード: 新規作成または読み取り
メソッド
get(name) | 指定された設定を取得します。 |
remove(name) | 指定された設定を削除します。 |
save |
設定を保存します。 以前にアドインによって保存された設定は初期化時に読み込まれるので、セッションの有効期間中に set メソッドと get メソッドを使用して、settings プロパティ バッグのメモリ内コピーを操作できます。 次回アドインを使用するときに使用できるように設定を保持する場合は、 メソッドを使用します |
set(name, value) | 指定された設定を行うかまたは作成します。 メソッドは 各アドインの設定には、最大 32 KB を使用できます。 コード 9057 のエラーは、そのサイズ制限を超えるとスローされます。 メソッドを使用して |
メソッドの詳細
get(name)
指定された設定を取得します。
get(name: string): any;
パラメーター
- name
-
string
The case-sensitive name of the setting to retrieve.
戻り値
any
型: String |数値 |Boolean |オブジェクト |配列
注釈
最小アクセス許可レベル: 制限
適用できる Outlook モード: 新規作成または読み取り
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/10-roaming-settings/roaming-settings.yaml
const settingName = $("#settingName").val();
const settingValue = Office.context.roamingSettings.get(settingName);
$("#settingValue").val(settingValue);
console.log(`The value of setting "${settingName}" is "${settingValue}".`);
remove(name)
指定された設定を削除します。
remove(name: string): void;
パラメーター
- name
-
string
The case-sensitive name of the setting to remove.
戻り値
void
注釈
最小アクセス許可レベル: 制限
適用できる Outlook モード: 新規作成または読み取り
saveAsync(callback)
設定を保存します。
以前にアドインによって保存された設定は初期化時に読み込まれるので、セッションの有効期間中に set メソッドと get メソッドを使用して、settings プロパティ バッグのメモリ内コピーを操作できます。 次回アドインを使用するときに使用できるように設定を保持する場合は、 メソッドを使用します saveAsync
。
saveAsync(callback?: (asyncResult: Office.AsyncResult<void>) => void): void;
パラメーター
- callback
-
(asyncResult: Office.AsyncResult<void>) => void
省略可能です。 メソッドが完了すると、 パラメーターで callback
渡された関数が、 型 Office.AsyncResult
の 1 つのパラメーターで呼び出されます。
戻り値
void
注釈
最小アクセス許可レベル: 制限
適用できる Outlook モード: 新規作成または読み取り
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/10-roaming-settings/roaming-settings.yaml
// Save settings in the mailbox to make it available in future sessions.
Office.context.roamingSettings.saveAsync(function(result) {
if (result.status !== Office.AsyncResultStatus.Succeeded) {
console.error(`Action failed with message ${result.error.message}`);
} else {
console.log(`Settings saved with status: ${result.status}`);
}
});
set(name, value)
指定された設定を行うかまたは作成します。
メソッドは set
、指定した名前がまだ存在しない場合は新しい設定を作成するか、指定した名前の既存の設定を設定します。 値は、そのデータ型のシリアル化された JSON 表現としてドキュメントに格納されます。
各アドインの設定には、最大 32 KB を使用できます。 コード 9057 のエラーは、そのサイズ制限を超えるとスローされます。
メソッドを使用して set
設定に加えられた変更は、メソッドが呼び出されるまでサーバーに saveAsync
保存されません。
set(name: string, value: any): void;
パラメーター
- name
-
string
The case-sensitive name of the setting to set or create.
- value
-
any
Specifies the value to be stored.
戻り値
void
注釈
最小アクセス許可レベル: 制限
適用できる Outlook モード: 新規作成または読み取り
例
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/10-roaming-settings/roaming-settings.yaml
const settingName = $("#settingName").val();
const settingValue = $("#settingValue").val();
Office.context.roamingSettings.set(settingName, settingValue);
console.log(`Setting "${settingName}" set to value "${settingValue}".`);
Office Add-ins
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示