Neuerungen in Excel JavaScript API 1.16

ExcelApi 1.16 hat die Datentypen-APIs hinzugefügt. Mit den Datentypen-APIs können Excel-Zellen Bilder aus dem Web, formatierte Zahlenwerte , die ihr Format bei Berechnungen beibehalten, und vor allem Entitätskarten enthalten. Entitätskarten erweitern das Potenzial von Excel-Add-Ins über ein zweidimensionales Raster hinaus. Sie zeigen ein Symbol in einer Zelle an, das bei Auswahl ein modales Kartenfenster in der Excel-Benutzeroberfläche öffnet. Weitere Informationen finden Sie unter Verwenden von Karten mit Entitätswertdatentypen.

Die folgende Tabelle enthält eine kurze Zusammenfassung der APIs, während die folgende API-Listentabelle eine detaillierte Liste enthält.

Funktionsbereich Beschreibung Relevante Objekte
Datentypen Eine Erweiterung vorhandener Excel-Datentypen, einschließlich Unterstützung für formatierte Zahlen und Webbilder. ArrayCellValue, BooleanCellValue, CellValueAttributionAttributes, CellValueProviderAttributes, DoubleCellValue, EmptyCellValue, EntityCellValue, FormattedNumberCellValue, RootReferenceCellValue, StringCellValue, ValueTypeNotAvailableCellValue, WebImageCellValue
Datentypen – Fehler Fehlerobjekte, die erweiterte Datentypen unterstützen. BlockedErrorCellValue, BusyErrorCellValue, CalcErrorCellValue, ConnectErrorCellValue, Div0ErrorCellValue, FieldErrorCellValue, GettingDataErrorCellValue, NotAvailableErrorCellValue, NameErrorCellValue, NullErrorCellValue, NumErrorCellValue, PlaceholderErrorCellValue, RefErrorCellValue, SpillErrorCellValue, ValueErrorCellValue
Entitätsdatentypen und Entitätskarten Eine Entität ist ein Container für Datentypen. Kartenlayoutobjekte verwalten die Anzeige von Entitätskarten. EntityCellValue, EntityCardLayout, EntityPropertyExtraProperties, EntityViewLayouts, CardLayoutListSection, CardLayoutPropertyReference, CardLayoutSectionStandardProperties, CardLayoutStandardProperties, CardLayoutTableSection

API-Liste

In der folgenden Tabelle sind die APIs im Excel-JavaScript-API-Anforderungssatz 1.16 aufgeführt. Die API-Referenzdokumentation für alle APIs, die vom Excel-JavaScript-API-Anforderungssatz 1.16 oder früher unterstützt werden, finden Sie unter Excel-APIs im Anforderungssatz 1.16 oder früher.

Klasse Felder Beschreibung
ArrayCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
Elemente Stellt die Elemente des Arrays dar.
referencedValues Stellt die Zellwerte dar, auf die innerhalb ArrayCellValue.elementsverwiesen wird.
type Stellt den Typ dieses Zellwerts dar.
BlockedErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von BlockedErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
BooleanCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
BusyErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von BusyErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
CalcErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von CalcErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
functionName Stellt den Namen der Funktion dar, die den Fehler verursacht.
type Stellt den Typ dieses Zellwerts dar.
CardLayoutListSection Aufteilung Stellt den Layouttyp für diesen Abschnitt dar.
CardLayoutPropertyReference property Stellt den Namen der Eigenschaft dar, auf die vom Kartenlayout verwiesen wird.
CardLayoutSectionStandardProperties eingeklappt Gibt an, ob dieser Abschnitt der Karte anfänglich reduziert ist.
zusammenklappbar Gibt an, ob dieser Abschnitt der Karte zusammenklappbar ist.
properties Stellt die Namen der Eigenschaften in diesem Abschnitt dar.
title Stellt den Titel dieses Abschnitts der Karte dar.
CardLayoutStandardProperties mainImage Gibt eine Eigenschaft an, die als Hauptbild der Karte verwendet wird.
sections Stellt die Abschnitte der Karte dar.
subTitle Stellt eine Spezifikation dar, welche Eigenschaft den Untertitel der Karte enthält.
title Stellt den Titel der Karte oder die Spezifikation dar, welche Eigenschaft den Titel der Karte enthält.
CardLayoutTableSection Aufteilung Stellt den Layouttyp für diesen Abschnitt dar.
CellValueAttributionAttributes licenseAddress Stellt eine URL zu einer Lizenz oder Quelle dar, die beschreibt, wie diese Eigenschaft verwendet werden kann.
licenseText Stellt einen Namen für die Lizenz dar, die diese Eigenschaft verwaltet.
sourceAddress Stellt eine URL zur Quelle der CellValuedar.
sourceText Stellt einen Namen für die Quelle der CellValue.
CellValueExtraProperties Beschreibbar Gibt an, ob dies CellValue zum Überschreiben einer Zelle verwendet wird.
schreibbare Notiz Stellt eine Erklärung dazu dar, warum CellValue.writable als "false" angegeben wird.
CellValuePropertyMetadata Namensnennung Stellt Zuordnungsinformationen dar, um die Quellen- und Lizenzanforderungen für die Verwendung dieser Eigenschaft zu beschreiben.
excludeFrom Gibt an, von welchen Features diese Eigenschaft ausgeschlossen ist.
Unterbezeichnung Stellt die Unterbezeichnung für diese Eigenschaft dar, die in der Kartenansicht angezeigt wird.
CellValuePropertyMetadataExclusions AutoVervollständigen Wahr bedeutet, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, die von der automatischen Vervollständigung angezeigt werden.
calcCompare Wahr bedeutet, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, die zum Vergleichen von Zellwerten beim Neuberechnen verwendet werden.
cardView Wahr bedeutet, dass die Unterkunft von den in der Kartenansicht angezeigten Eigenschaften ausgeschlossen wird.
dotNotation Wahr bedeutet, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, auf die über die Funktion FELDWERT zugegriffen werden kann.
CellValueProviderAttributes description Stellt die Eigenschaft "Anbieterbeschreibung" dar, die in der Kartenansicht verwendet wird, wenn kein Logo angegeben ist.
logoSourceAddress Stellt eine URL dar, die zum Herunterladen eines Bilds verwendet wird, das als Logo in der Kartenansicht verwendet wird.
logoTargetAddress Stellt eine URL dar, die das Navigationsziel ist, wenn der Benutzer auf das Logoelement in der Kartenansicht klickt.
ChangedEventDetail valueAsJsonAfter Stellt den Werttyp nach der Änderung dar.
valueAsJsonBefore Stellt den Werttyp vor der Änderung dar.
ChartFill getSolidColor() Ruft die einheitliche Farbfüllformatierung eines Diagrammelements ab.
ConnectErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von ConnectErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
Div0ErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
DoubleCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
EmptyCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
EntityCardLayout Aufteilung Stellt den Typ dieses Layouts dar.
EntityCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
Grundrisse Stellt Layoutinformationen für Ansichten dieses Objekts dar.
properties Stellt die Eigenschaften dieser Entität und ihrer Metadaten dar.
Anbieter Stellt Informationen dar, die den Dienst beschreiben, der die Daten in diesem EntityCellValuebereitgestellt hat.
referencedValues Stellt die Zellwerte dar, auf die innerhalb EntityCellValue.propertiesverwiesen wird.
text Stellt den Text dar, der angezeigt wird, wenn eine Zelle mit diesem Wert gerendert wird.
type Stellt den Typ dieses Zellwerts dar.
EntityCompactLayout icon Gibt den Namen des Symbols an, das zum Öffnen der Karte verwendet wird.
EntityPropertyExtraProperties propertyMetadata Stellt Metadaten über die Eigenschaft dar.
EntityViewLayouts Karte Stellt das Layout dieses Objekts in der Kartenansicht dar.
kompakt Stellt das Layout dar, das verwendet wird, wenn nur wenig Platz für die Darstellung des Objekts vorhanden ist.
ExternalErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von ExternalErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
FieldErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von FieldErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
fieldName Stellt das Feld dar, das von FELDWERT nicht gefunden wurde.
type Stellt den Typ dieses Zellwerts dar.
FormattedNumberCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
numberFormat Gibt die Zahlenformatzeichenfolge zurück, die zum Anzeigen dieses Werts verwendet wird.
type Stellt den Typ dieses Zellwerts dar.
GettingDataErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
LinkedEntityCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
id Stellt die Dienstquelle dar, die die Informationen in diesem Wert bereitgestellt hat.
Grundrisse Stellt Layoutinformationen für Ansichten dieser verknüpften Entität dar.
properties Stellt die Eigenschaften dieser verknüpften Entität und ihrer Metadaten dar.
Anbieter Stellt Informationen dar, die den Dienst beschreiben, der Daten in diesem LinkedEntityCellValue.
text Stellt den Text dar, der angezeigt wird, wenn eine Zelle mit diesem Wert gerendert wird.
type Stellt den Typ dieses Zellwerts dar.
LinkedEntityId Kultur Stellt dar, welche Sprachkultur verwendet wurde, um dies CellValuezu erstellen.
domainId Stellt eine Domäne dar, die für einen Dienst spezifisch ist, der zum Erstellen der CellValue.
entityId Stellt einen Bezeichner dar, der für einen Dienst spezifisch ist, der zum Erstellen der CellValue.
ServiceID Gibt an, welcher Dienst zum Erstellen der CellValue.
NameErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
NamedItem valueAsJson Eine JSON-Darstellung der Werte in diesem benannten Element.
valueAsJsonLocal Eine JSON-Darstellung der Werte in diesem benannten Element.
NamedItemArrayValues valuesAsJson Eine JSON-Darstellung der Werte in diesem benannten Elementarray.
valuesAsJsonLocal Eine JSON-Darstellung der Werte in diesem benannten Elementarray.
NotAvailableErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
NullErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
NumErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von NumErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
functionName Stellt den Namen der Funktion dar, die den Fehler verursacht.
type Stellt den Typ dieses Zellwerts dar.
PlaceholderErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorType Stellt den Typ von ErrorCellValuedar.
target PlaceholderErrorCellValue wird während der Verarbeitung verwendet, während Daten heruntergeladen werden.
type Stellt den Typ dieses Zellwerts dar.
Range valuesAsJson Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich.
valuesAsJsonLocal Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich.
RangeView valuesAsJson Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich.
valuesAsJsonLocal Eine JSON-Darstellung der Werte in den Zellen in diesem Bereich.
RefErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von RefErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
ReferenceCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
reference Stellt den Index in den referencedValues Eigenschaften von Zellwerten dar, wie EntityCellValue z. B. und ArrayCellValue.
type Stellt den Typ dieses Zellwerts dar.
RootReferenceCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
SpillErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
columnCount Stellt die Anzahl der Spalten dar, die überlaufen würden, wenn es keine #SPILL gäbe. zurück.
errorSubType Stellt den Typ von SpillErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
rowCount Stellt die Anzahl der Zeilen dar, die überlaufen würden, wenn es keine #SPILL gäbe. zurück.
type Stellt den Typ dieses Zellwerts dar.
StringCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
TableColumn valuesAsJson Eine JSON-Darstellung der Werte in den Zellen in dieser Tabellenspalte.
valuesAsJsonLocal Eine JSON-Darstellung der Werte in den Zellen in dieser Tabellenspalte.
TableColumnCollection addAsJson(index?: Zahl, Werte?: CellValue[][], name?: Zeichenfolge) Fügt der Tabelle eine neue Spalte hinzu.
TableRow valuesAsJson Eine JSON-Darstellung der Werte in den Zellen in dieser Tabellenzeile.
valuesAsJsonLocal Eine JSON-Darstellung der Werte in den Zellen in dieser Tabellenzeile.
TableRowCollection addAsJson(index?: Zahl, Werte?: CellValue[][], alwaysInsert?: boolescher Wert) Fügt der Tabelle mindestens eine Zeile hinzu.
ValueErrorCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
errorSubType Stellt den Typ von ValueErrorCellValuedar.
errorType Stellt den Typ von ErrorCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
ValueTypeNotAvailableCellValue basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
type Stellt den Typ dieses Zellwerts dar.
WebImageCellValue address Stellt die URL dar, von der das Bild heruntergeladen wird.
altText Stellt den Alternativtext dar, der in Barrierefreiheitsszenarien verwendet werden kann, um zu beschreiben, was das Bild darstellt.
Namensnennung Stellt Zuordnungsinformationen dar, um die Quelle und die Lizenzanforderungen für die Verwendung dieses Bilds zu beschreiben.
basicType Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.valueTypes würde.
basicValue Stellt den Wert dar, der für eine Zelle mit diesem Wert zurückgegeben Range.values würde.
Anbieter Stellt Informationen dar, die die Entität oder Person beschreiben, die das Bild bereitgestellt hat.
relatedImagesAddress Stellt die URL einer Webseite mit Bildern dar, die als damit WebImageCellValuezusammenhängend betrachtet werden.
type Stellt den Typ dieses Zellwerts dar.
Workbook getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) Gibt ein Ergebnis LinkedEntityCellValue basierend auf dem angegebenen LinkedEntityIdzurück.

Siehe auch