Excel アドインのデータ型の概要 (プレビュー)

注意

現在、データ型 API はパブリック プレビューでのみ使用できます。 プレビュー API は変更されることがあります。運用環境での使用は意図されていません。 試用はテスト環境と開発環境に限定することをお勧めします。 運用環境やビジネス上重要なドキュメントでプレビュー API を使用しないでください。

プレビュー API を使用するには:

Windows 版 Office でデータ型を試すには、16.0.14626.10000 以上の Excel ビルド番号が必要です。 Office on Mac でデータ型を試すには、16.55.21102600 以上の Excel ビルド番号が必要です。

Excel JavaScript API のデータ型を使用すると、アドイン開発者は、書式設定された数値、Web イメージ、エンティティ値などのオブジェクトとして複雑なデータ構造を整理できます。

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

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

データ型とカスタム関数

注意

データ型と統合されたカスタム関数は、現在パブリック プレビュー中であり、Windows 版 Office にのみ対応しています。 プレビュー機能は変更されることがあります。運用環境での使用は意図されていません。 試用はテスト環境と開発環境に限定することをお勧めします。 運用環境やビジネス上重要なドキュメントでプレビュー機能を使用しないでください。

Windows 版 Office でデータ型とカスタム関数との統合を試すには、Excel ビルド番号が 16.0.14623.20002 以上である必要があります。 この機能を使用するには、Office Insider プログラムに参加して、ベータ チャネル Insider レベルを選択する必要があります。 詳細については、「Office Insider プログラムに参加する」を参照してください。

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

関連項目