カスタム関数のための JavaScript 専用ランタイム

共有ランタイムを使用しないカスタム関数では、計算のパフォーマンスを最適化するように設計された JavaScript 専用ランタイム が使用されます。

この JavaScript 専用ランタイムは、カスタム関数と作業ウィンドウ (別のランタイムで実行される) で使用できる名前空間内 OfficeRuntime の API にアクセスして、データを格納します。

外部データを要求する

カスタム関数内では、Fetch などの API や、サーバーとやり取りする HTTP 要求を発行する標準 Web API である XmlHttpRequest (XHR) を使用して、外部データを要求できます。

カスタム関数では、XmlHttpRequests を作成するときに追加のセキュリティ対策を使用する必要があることに注意してください。 同じ配信元ポリシー と単純な CORS が必要です。

単純な CORS 実装では Cookie を使用できず、単純なメソッド (GET、HEAD、POST) のみがサポートされます。 単純な CORS はフィールド名Accept、 Accept-Language、Content-Languageの簡単なヘッダーを受け入れます。 コンテンツ タイプapplication/x-www-form-urlencodedtext/plainが Content-Type 、、または multipart/form-dataである場合は、単純な CORS でヘッダーを使用することもできます。

データの格納とアクセス

共有ランタイムを使用しないカスタム関数内では、 OfficeRuntime.storage オブジェクトを使用してデータを格納およびアクセスできます。 オブジェクトは Storage 、JavaScript 専用ランタイムを使用するカスタム関数では使用できない localStorage の代替手段を提供する、永続的で暗号化されていないキー値ストレージ システムです。 オブジェクトは Storage 、ドメインごとに 10 MB のデータを提供します。 ドメインは、複数のアドインで共有できます。

オブジェクトは Storage 共有ストレージ ソリューションであり、アドインの複数の部分が同じデータにアクセスできることを意味します。 たとえば、ユーザー認証のトークンは、カスタム関数 (JavaScript 専用ランタイムを使用) と作業ウィンドウ (完全な Webview ランタイムを使用) の両方でアクセスできるため、オブジェクトに格納される Storage 場合があります。 同様に、2 つのアドインが同じドメイン (、 などwww.contoso.com/addin1www.contoso.com/addin2) を共有する場合、オブジェクトを介して情報を前後にStorage共有することもできます。 サブドメインが異なるアドインには、 のインスタンスStorageが異なっていることに注意してください (例: 、 subdomain.contoso.com/addin1differentsubdomain.contoso.com/addin2)。

オブジェクトは Storage 共有の場所にできるため、キーと値のペアをオーバーライドできることを認識することが重要です。

オブジェクトでは、次のメソッドを Storage 使用できます。

• getItem
• getItems
• setItem
• setItems
• removeItem
• removeItems
• getKeys

OfficeRuntime.storage の例

次のコード サンプルでは、 メソッドを OfficeRuntime.storage.setItem 呼び出して、キーと値を に storage設定します。

function StoreValue(key, value) {

  return OfficeRuntime.storage.setItem(key, value).then(function (result) {
      return "Success: Item with key '" + key + "' saved to storage.";
  }, function (error) {
      return "Error: Unable to save item with key '" + key + "' to storage. " + error;
  });
}

次の手順

カスタム関数をデバッグする方法について説明します。

関連項目

• 共有ランタイムのないカスタム関数の認証
• Excel でカスタム関数を作成する
• カスタム関数のチュートリアル
• JavaScript 専用ランタイム