Neuerungen in der Excel-JavaScript-API 1.16

ExcelApi 1.16 hat die Datentyp-APIs hinzugefügt. Mit den Datentyp-APIs können Excel-Zellen Bilder aus dem Web, formatierte Zahlenwerte , die ihr Format in allen 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 nachfolgende 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
Datentypfehler 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. Informationen zum Anzeigen der 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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Elemente Stellt die Elemente des Arrays dar.
referencedValues Stellt die Zellwerte dar, auf die in ArrayCellValue.elementsverwiesen wird.
type Stellt den Typ dieses Zellwerts dar.
BlockedErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar BlockedErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
BooleanCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
type Stellt den Typ dieses Zellwerts dar.
BusyErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar BusyErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
CalcErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar CalcErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
Functionname Stellt den Namen der Funktion dar, die den Fehler verursacht.
type Stellt den Typ dieses Zellwerts dar.
CardLayoutListSection Layout Stellt den Typ des Layouts für diesen Abschnitt dar.
CardLayoutPropertyReference property Stellt den Namen der Eigenschaft dar, auf die vom Kartenlayout verwiesen wird.
CardLayoutSectionStandardProperties Reduziert Gibt an, ob dieser Abschnitt der Karte anfänglich reduziert ist.
Reduzierbaren Gibt an, ob dieser Abschnitt der Karte reduzierbar 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.
Untertitel Stellt eine Spezifikation dar, welche Eigenschaft den Untertitel der Karte enthält.
title Stellt den Titel der Karte oder die Spezifikation dar, deren Eigenschaft den Titel der Karte enthält.
CardLayoutTableSection Layout Stellt den Typ des Layouts 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 steuert.
sourceAddress Stellt eine URL zur Quelle des CellValuedar.
sourceText Stellt einen Namen für die Quelle des CellValuedar.
CellValueExtraProperties Beschreibbaren Gibt an, ob diese CellValue zum Überschreiben einer Zelle verwendet wird.
writableNote Stellt eine Erklärung darüber dar, warum CellValue.writable als false angegeben wird.
CellValuePropertyMetadata Attribution Stellt Zuordnungsinformationen dar, um die Quell- und Lizenzanforderungen für die Verwendung dieser Eigenschaft zu beschreiben.
excludeFrom Stellt dar, 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 True stellt dar, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, die durch automatische Vervollständigung angezeigt werden.
calcCompare True stellt dar, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, die zum Vergleichen von Zellwerten während der Neuberechnung verwendet werden.
cardView True stellt dar, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, die in der Kartenansicht angezeigt werden.
dotNotation True stellt dar, dass die Eigenschaft von den Eigenschaften ausgeschlossen wird, auf die über die FIELDVALUE-Funktion zugegriffen werden kann.
CellValueProviderAttributes description Stellt die Anbieterbeschreibungseigenschaft dar, die in der Kartenansicht verwendet wird, wenn kein Logo angegeben wird.
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 darstellt, wenn der Benutzer in der Kartenansicht auf das Logo-Element 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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar ConnectErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
Div0ErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
DoubleCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
type Stellt den Typ dieses Zellwerts dar.
EmptyCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
type Stellt den Typ dieses Zellwerts dar.
EntityCardLayout Layout Stellt den Typ dieses Layouts dar.
EntityCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Layouts Stellt Layoutinformationen für Ansichten dieser Entität dar.
properties Stellt die Eigenschaften dieser Entität und ihre Metadaten dar.
Anbieter Stellt Informationen dar, die den Dienst beschreiben, der die Daten in diesem EntityCellValuebereitgestellt hat.
referencedValues Stellt die Zellwerte dar, auf die in EntityCellValue.propertiesverwiesen wird.
text Stellt den Text dar, der beim Rendern einer Zelle mit diesem Wert angezeigt 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 zur -Eigenschaft dar.
EntityViewLayouts Karte Stellt das Layout dieser Entität in der Kartenansicht dar.
Kompakte Stellt das Layout dar, das verwendet wird, wenn der Platz zur Darstellung der Entität begrenzt ist.
ExternalErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar ExternalErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
FieldErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar FieldErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
Fieldname Represents the field which was not found by FIELDVALUE.
type Stellt den Typ dieses Zellwerts dar.
FormattedNumberCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
LinkedEntityCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
cardLayout Stellt das Layout dieser verknüpften Entität in der Kartenansicht dar.
id Stellt die Dienstquelle dar, die die Informationen in diesem Wert bereitgestellt hat.
properties Stellt die Eigenschaften dieser verknüpften Entität und deren Metadaten dar.
Anbieter Stellt Informationen dar, die den Dienst beschreiben, der Daten in diesem LinkedEntityCellValuebereitgestellt hat.
text Stellt den Text dar, der beim Rendern einer Zelle mit diesem Wert angezeigt wird.
type Stellt den Typ dieses Zellwerts dar.
LinkedEntityId Kultur Gibt an, welche Sprachkultur zum Erstellen dieses CellValueverwendet wurde.
domainId Stellt eine Domäne dar, die für einen Dienst spezifisch ist, der zum Erstellen von CellValueverwendet wird.
entityId Stellt einen Bezeichner dar, der für einen Dienst spezifisch ist, der zum Erstellen von CellValueverwendet wird.
ServiceID Gibt an, welcher Dienst zum Erstellen von CellValueverwendet wurde.
NameErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
NullErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
NumErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar NumErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Errortype Stellt den Typ von dar ErrorCellValue.
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 von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar RefErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
ReferenceCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
reference Stellt den Index in den referencedValues Eigenschaften von Zellwerten wie EntityCellValue und ArrayCellValuedar.
type Stellt den Typ dieses Zellwerts dar.
RootReferenceCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
type Stellt den Typ dieses Zellwerts dar.
SpillErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
Columncount Stellt die Anzahl der Spalten dar, die überlaufen würden, wenn keine #SPILL! zurück.
errorSubType Stellt den Typ von dar SpillErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
Rowcount Stellt die Anzahl der Zeilen dar, die überlaufen würden, wenn keine #SPILL! zurück.
type Stellt den Typ dieses Zellwerts dar.
StringCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
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?: number, values?: CellValue[][], name?: string) 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?: number, values?: CellValue[][], alwaysInsert?: boolean) Fügt der Tabelle mindestens eine Zeile hinzu.
ValueErrorCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
errorSubType Stellt den Typ von dar ValueErrorCellValue.
Errortype Stellt den Typ von dar ErrorCellValue.
type Stellt den Typ dieses Zellwerts dar.
ValueTypeNotAvailableCellValue basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
type Stellt den Typ dieses Zellwerts dar.
WebImageCellValue address Stellt die URL dar, von der das Bild heruntergeladen wird.
altText Stellt den alternativen Text dar, der in Barrierefreiheitsszenarien verwendet werden kann, um zu beschreiben, was das Bild darstellt.
Attribution Stellt Zuordnungsinformationen dar, um die Quell- und Lizenzanforderungen für die Verwendung dieses Bilds zu beschreiben.
basicType Stellt den Wert dar, der von Range.valueTypes für eine Zelle mit diesem Wert zurückgegeben wird.
basicValue Stellt den Wert dar, der von Range.values für eine Zelle mit diesem Wert zurückgegeben wird.
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 mit dieser WebImageCellValueverknüpft betrachtet werden.
type Stellt den Typ dieses Zellwerts dar.
Workbook getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) Gibt basierend auf dem bereitgestellten LinkedEntityIdzurückLinkedEntityCellValue.

Siehe auch