Excel JavaScript API 1.16 の新機能

  • [アーティクル]

ExcelApi 1.16 では、データ型 API が追加されました。 データ型 API を使用すると、Excel セルには 、Web からの画像、計算全体で形式を保持する 書式設定された数値値 、特にエンティティ カードを含めることができます。 エンティティ カードは、2 次元グリッドを超えて Excel アドインの可能性を拡張します。 セル内にアイコンが表示され、選択すると Excel UI でカード モーダル ウィンドウが開きます。 詳細については、「エンティティ値データ型でカードを使用する」を参照してください。

次の表は API の簡潔な概要を示し、後続の API リスト テーブルでは詳細な一覧を示します。

機能領域 説明 関連オブジェクト
データ型 書式設定された数値と Web イメージのサポートを含む、既存の Excel データ型の拡張機能。 ArrayCellValue、 BooleanCellValue、 CellValueAttributionAttributes、 CellValueProviderAttributes、 DoubleCellValue、 EmptyCellValue、 EntityCellValue、 FormattedNumberCellValue、 RootReferenceCellValue、 StringCellValue、 ValueTypeNotAvailableCellValue、 WebImageCellValue
データ型エラー 拡張されたデータ型をサポートするエラー オブジェクト。 BlockedErrorCellValue、 BusyErrorCellValue、 CalcErrorCellValue、 ConnectErrorCellValue、 Div0ErrorCellValue、 FieldErrorCellValue、 GettingDataErrorCellValue、 NotAvailableErrorCellValue、 NameErrorCellValue、 NullErrorCellValue、 NumErrorCellValue、 PlaceholderErrorCellValue、 RefErrorCellValue、 SpillErrorCellValue、 ValueErrorCellValue
エンティティ データ型 と エンティティ カード エンティティは、データ型のコンテナーです。 カード レイアウト オブジェクトは、エンティティ カードの表示を管理します。 EntityCellValue、 EntityCardLayout、 EntityPropertyExtraProperties、 EntityViewLayouts、 CardLayoutListSection、 CardLayoutPropertyReference、 CardLayoutSectionStandardProperties、 CardLayoutStandardProperties、 CardLayoutTableSection

API リスト

次の表に、Excel JavaScript API 要件セット 1.16 の API を示します。 Excel JavaScript API 要件セット 1.16 以前でサポートされているすべての API の API リファレンス ドキュメントを表示するには、 要件セット 1.16 以前の Excel API に関するページを参照してください。

クラス フィールド 説明
ArrayCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
要素 配列の要素を表します。
referencedValues 内 ArrayCellValue.elementsで参照されるセル値を表します。
type このセル値の型を表します。
BlockedErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します BlockedErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
BooleanCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
BusyErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します BusyErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
CalcErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します CalcErrorCellValue。
errorType の型を表します ErrorCellValue。
functionName エラーの原因となった関数の名前を表します。
type このセル値の型を表します。
CardLayoutListSection レイアウト このセクションのレイアウトの種類を表します。
CardLayoutPropertyReference property カード レイアウトによって参照されるプロパティの名前を表します。
CardLayoutSectionStandardProperties 崩壊 カードのこのセクションが最初に折りたたまれているかどうかを表します。
折りたたみ カードのこのセクションが折りたたみ可能かどうかを表します。
プロパティ このセクションのプロパティの名前を表します。
title カードのこのセクションのタイトルを表します。
CardLayoutStandardProperties mainImage カードのメイン イメージとして使用されるプロパティを指定します。
sections カードのセクションを表します。
字幕 カードのサブタイトルを含むプロパティの仕様を表します。
title カードのタイトル、またはカードのタイトルを含むプロパティの仕様を表します。
CardLayoutTableSection レイアウト このセクションのレイアウトの種類を表します。
CellValueAttributionAttributes licenseAddress このプロパティの使用方法を説明するライセンスまたはソースの URL を表します。
licenseText このプロパティを管理するライセンスの名前を表します。
sourceAddress のソースへの URL を表します CellValue。
sourceText のソースの名前を表します CellValue。
CellValueExtraProperties 書き込み これを CellValue 使用してセルを上書きするかどうかを表します。
writableNote false として指定された理由 CellValue.writable に関する説明を表します。
CellValuePropertyMetadata 帰属 このプロパティを使用するためのソースとライセンスの要件を説明する属性情報を表します。
excludeFrom このプロパティが除外される機能を表します。
sublabel カード ビューに表示されるこのプロパティのサブラベルを表します。
CellValuePropertyMetadataExclusions オートコンプリート True は、自動完了で表示されるプロパティからプロパティが除外されることを表します。
calcCompare True は、再計算中にセル値を比較するために使用されるプロパティからプロパティが除外されることを表します。
cardView True は、カード ビューで表示されるプロパティからプロパティが除外されることを表します。
dotNotation True は、FIELDVALUE 関数を使用してアクセスできるプロパティからプロパティが除外されることを表します。
CellValueProviderAttributes description ロゴが指定されていない場合にカード ビューで使用されるプロバイダーの説明プロパティを表します。
logoSourceAddress カード ビューでロゴとして使用されるイメージのダウンロードに使用される URL を表します。
logoTargetAddress ユーザーがカード ビューでロゴ要素をクリックした場合のナビゲーション ターゲットである URL を表します。
ChangedEventDetail valueAsJsonAfter 変更後の値の種類を表します。
valueAsJsonBefore 変更前の値の種類を表します。
ChartFill getSolidColor() グラフ要素の均一な色の塗りつぶしの書式設定を取得します。
ConnectErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します ConnectErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
Div0ErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
DoubleCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
EmptyCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
EntityCardLayout レイアウト このレイアウトの種類を表します。
EntityCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
レイアウト このエンティティのビューのレイアウト情報を表します。
プロパティ このエンティティのプロパティとそのメタデータを表します。
プロバイダー この EntityCellValueでデータを提供したサービスを説明する情報を表します。
referencedValues 内 EntityCellValue.propertiesで参照されるセル値を表します。
text この値を持つセルがレンダリングされるときに表示されるテキストを表します。
type このセル値の型を表します。
EntityCompactLayout icon カードを開くために使用するアイコンの名前を指定します。
EntityPropertyExtraProperties propertyMetadata プロパティに関するメタデータを表します。
EntityViewLayouts カード カード ビューでのこのエンティティのレイアウトを表します。
コンパクト エンティティを表すスペースが限られている場合に使用されるレイアウトを表します。
ExternalErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します ExternalErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
FieldErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します FieldErrorCellValue。
errorType の型を表します ErrorCellValue。
Fieldname FIELDVALUE で見つからなかったフィールドを表します。
type このセル値の型を表します。
FormattedNumberCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
numberFormat この値を表示するために使用される数値書式指定文字列を返します。
type このセル値の型を表します。
GettingDataErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
LinkedEntityCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
cardLayout カード ビューでのこのリンクされたエンティティのレイアウトを表します。
id この値の情報を提供したサービス ソースを表します。
プロパティ このリンクされたエンティティのプロパティとそのメタデータを表します。
プロバイダー この LinkedEntityCellValueでデータを提供したサービスを説明する情報を表します。
text この値を持つセルがレンダリングされるときに表示されるテキストを表します。
type このセル値の型を表します。
LinkedEntityId 文化 この CellValueを作成するために使用された言語カルチャを表します。
domainId を作成するために使用されるサービスに固有のドメインを表します CellValue。
entityId を作成するために使用されるサービスに固有の識別子を表します CellValue。
serviceId を作成するために使用されたサービスを表します CellValue。
NameErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
NamedItem valueAsJson この名前付き項目内の値の JSON 表現。
valueAsJsonLocal この名前付き項目内の値の JSON 表現。
NamedItemArrayValues valuesAsJson この名前付き項目配列内の値の JSON 表現。
valuesAsJsonLocal この名前付き項目配列内の値の JSON 表現。
NotAvailableErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
NullErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
NumErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します NumErrorCellValue。
errorType の型を表します ErrorCellValue。
functionName エラーの原因となった関数の名前を表します。
type このセル値の型を表します。
PlaceholderErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorType の型を表します ErrorCellValue。
target PlaceholderErrorCellValue は、データのダウンロード中に使用されます。
type このセル値の型を表します。
Range valuesAsJson この範囲内のセル内の値の JSON 表現。
valuesAsJsonLocal この範囲内のセル内の値の JSON 表現。
RangeView valuesAsJson この範囲内のセル内の値の JSON 表現。
valuesAsJsonLocal この範囲内のセル内の値の JSON 表現。
RefErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します RefErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
ReferenceCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
reference や などのEntityCellValueセル値のreferencedValuesプロパティへのインデックスをArrayCellValue表します。
type このセル値の型を表します。
RootReferenceCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
SpillErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
columnCount #SPILLがない場合にスピルする列の数を表します。 エラーを返します。
errorSubType の型を表します SpillErrorCellValue。
errorType の型を表します ErrorCellValue。
行数 #SPILLがない場合にスピルする行数を表します。 エラーを返します。
type このセル値の型を表します。
StringCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
TableColumn valuesAsJson このテーブル列のセル内の値の JSON 表現。
valuesAsJsonLocal このテーブル列のセル内の値の JSON 表現。
TableColumnCollection addAsJson(index?: number, values?: CellValue[][], name?: string) テーブルに新しい列を追加します。
TableRow valuesAsJson このテーブル行のセル内の値の JSON 表現。
valuesAsJsonLocal このテーブル行のセル内の値の JSON 表現。
TableRowCollection addAsJson(index?: number, values?: CellValue[][], alwaysInsert?: boolean) テーブルに 1 つ以上の行を追加します。
ValueErrorCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
errorSubType の型を表します ValueErrorCellValue。
errorType の型を表します ErrorCellValue。
type このセル値の型を表します。
ValueTypeNotAvailableCellValue basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
type このセル値の型を表します。
WebImageCellValue address イメージのダウンロード元となる URL を表します。
altText アクセシビリティ シナリオで使用できる代替テキストを表し、画像が何を表すのかを表します。
帰属 このイメージを使用するためのソースとライセンスの要件を説明する属性情報を表します。
basicType この値を持つセルの によって Range.valueTypes 返される値を表します。
basicValue この値を持つセルの によって Range.values 返される値を表します。
プロバイダー イメージを提供したエンティティまたは個人を表す情報を表します。
relatedImagesAddress この WebImageCellValueに関連すると見なされる画像を含む Web ページの URL を表します。
type このセル値の型を表します。
ブック getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) 指定した に基づいて を LinkedEntityCellValue 返します LinkedEntityId。

関連項目