Excel アドインのデータ型の概要

データ型は、複雑なデータ構造をオブジェクトとして編成します。 これには、書式設定された数値、Web イメージ、エンティティが エンティティ カードとして含まれます。

次のスクリーンショットでは、データ型の主な機能の 1 つであるエンティティ カードが強調表示されています。 この場合、エンティティ カードは、食料品店製品の一覧から、Tofu 製品に関する拡張情報を表示します。

注:

データ型の実験をすぐに開始するには、Excel にScript Labをインストールし、サンプル ライブラリの [データ型] セクションをチェックします。 また、OfficeDev/office-js-snippets リポジトリのScript Labサンプルを調べることができます。

データ型を追加する前は、Excel JavaScript API でサポートされていたのは、文字列、数値、ブール値、エラーデータ型でした。 Excel UI 書式設定レイヤーでは、元からある 4 種のデータ型を含むセルに通貨、日付、およびその他の種類の書式を追加できますが、この書式設定レイヤーは Excel UI 上の元のデータ型の表示のみを制御します。 Excel UI のセルが通貨または日付として書式設定されている場合でも、基になる数値は変更されません。 基になる値と Excel UI の書式設定された表示の間のこのギャップにより、アドインの計算中に混乱やエラーが発生する可能性があります。 データ型 API は、このギャップの解決策です。

データ型は、元の 4 つのデータ型 (文字列、数値、ブール値、およびエラー) を超えて Excel JavaScript API のサポートを拡張し、Web イメージ、書式設定された数値、エンティティ、エンティティ内の配列、および改善されたエラー データ型を柔軟なデータ構造として含めます。 これらの型は、多くの linked data types エクスペリエンスを強化し、アドインの計算中の精度と簡易性を実現し、Excel アドインの可能性を 2 次元グリッドを超えて拡張します。

ヒント

次のサンプル ブックで、すべての Excel ユーザーが使用できる リンクされたデータ型の例 を確認linked-data-types-sample-workbook.xlsx。

リソース

次のリソースを使用してデータ型を調べる。

1. データ型の基本については、 Excel データ型のコア概念に関する記事を 参照してください。
2. Excel にScript Labをインストールし、サンプル ライブラリの [データ型] セクションを調べます。
3. エンティティ データ型を使用して 2 次元グリッドを超えて Excel を拡張する方法については、「 エンティティ値データ型でカードを使用する 」の記事を参照してください。
4. OfficeDev/Office-Add-in-samples リポジトリの Excel サンプルでデータ型の作成と探索を試してください。

データ型とカスタム関数

データ型は、カスタム関数の機能を強化します。 カスタム関数は、カスタム関数への入力とカスタム関数の出力の両方としてデータ型を受け取り、カスタム関数は Excel JavaScript API と同じ JSON スキーマをデータ型に使用します。 このデータ型の JSON スキーマは、カスタム関数により計算および評価がされるときに維持されます。 データ型とカスタム関数の統合の詳細については、「カスタム関数とデータ型」を参照してください。