Nouveautés de l’API JavaScript Excel 1.16

  • Article

ExcelApi 1.16 a ajouté les API de types de données. Avec les API de types de données, les cellules Excel peuvent contenir des images provenant du web, des valeurs numériques mises en forme qui conservent leur format tout au long des calculs, et plus particulièrement des cartes d’entité. Les cartes d’entité étendent le potentiel des compléments Excel au-delà d’une grille 2 dimensions. Elles affichent une icône dans une cellule qui ouvre une fenêtre modale carte dans l’interface utilisateur Excel lorsqu’elle est sélectionnée. Pour plus d’informations, consultez Utiliser des cartes avec des types de données de valeur d’entité.

Le tableau suivant fournit un résumé concis des API, tandis que le tableau de liste d’API suivant fournit une liste détaillée.

Fonctionnalité Description Objets pertinents
Types de données Extension des types de données Excel existants, y compris la prise en charge des nombres mis en forme et des images web. ArrayCellValue, BooleanCellValue, CellValueAttributionAttributes, CellValueProviderAttributes, DoubleCellValue, EmptyCellValue, EntityCellValue, FormattedNumberCellValue, RootReferenceCellValue, StringCellValue, ValueTypeNotAvailableCellValue, WebImageCellValue
Erreurs de types de données Objets d’erreur qui prennent en charge les types de données développés. BlockedErrorCellValue, BusyErrorCellValue, CalcErrorCellValue, ConnectErrorCellValue, Div0ErrorCellValue, FieldErrorCellValue, GettingDataErrorCellValue, NotAvailableErrorCellValue, NameErrorCellValue, NullErrorCellValue, NumErrorCellValue, PlaceholderErrorCellValue, RefErrorCellValue, SpillErrorCellValue, ValueErrorCellValue
Types de donnéesd’entité et cartes d’entité Une entité est un conteneur pour les types de données. Les objets de disposition de carte gèrent l’affichage des cartes d’entité. EntityCellValue, EntityCardLayout, EntityPropertyExtraProperties, EntityViewLayouts, CardLayoutListSection, CardLayoutPropertyReference, CardLayoutSectionStandardProperties, CardLayoutStandardProperties, CardLayoutTableSection

Liste des API

Le tableau suivant répertorie les API dans l’ensemble de conditions requises de l’API JavaScript Excel 1.16. Pour afficher la documentation de référence des API pour toutes les API prises en charge par l’ensemble de conditions requises de l’API JavaScript Excel 1.16 ou antérieure, consultez API Excel dans l’ensemble de conditions requises 1.16 ou antérieur.

Classe Champs Description
ArrayCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
Éléments Représente les éléments du tableau.
referencedValues Représente les valeurs de cellule référencées dans ArrayCellValue.elements.
type Représente le type de cette valeur de cellule.
BlockedErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de BlockedErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
BooleanCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
BusyErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de BusyErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
CalcErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de CalcErrorCellValue.
errorType Représente le type de ErrorCellValue.
functionName Représente le nom de la fonction à l’origine de l’erreur.
type Représente le type de cette valeur de cellule.
CardLayoutListSection disposition Représente le type de disposition de cette section.
CardLayoutPropertyReference property Représente le nom de la propriété référencée par la disposition carte.
CardLayoutSectionStandardProperties Effondré Indique si cette section du carte est initialement réduite.
pliable Indique si cette section du carte est réductible.
properties Représente les noms des propriétés de cette section.
title Représente le titre de cette section du carte.
CardLayoutStandardProperties mainImage Spécifie une propriété qui sera utilisée comme image main du carte.
sections Représente les sections du carte.
sous-titre Représente une spécification de la propriété qui contient le sous-titre du carte.
title Représente le titre du carte ou la spécification de la propriété qui contient le titre du carte.
CardLayoutTableSection disposition Représente le type de disposition de cette section.
CellValueAttributionAttributes licenseAddress Représente une URL vers une licence ou une source qui décrit comment cette propriété peut être utilisée.
licenseText Représente un nom pour la licence qui régit cette propriété.
sourceAddress Représente une URL vers la source du CellValue.
sourceText Représente un nom pour la source du CellValue.
CellValueExtraProperties Inscriptible Indique si elle CellValue sera utilisée pour remplacer une cellule.
writableNote Représente une explication sur la raison pour CellValue.writable laquelle est spécifié comme false.
CellValuePropertyMetadata attribution Représente les informations d’attribution pour décrire la source et la licence requise pour l’utilisation de cette propriété.
excludeFrom Représente les fonctionnalités dont cette propriété est exclue.
sous-étiquette Représente la sous-étiquette de cette propriété affichée dans carte vue.
CellValuePropertyMetadataExclusions saisie semi-automatique True représente que la propriété est exclue des propriétés affichées par saisie semi-automatique.
calcCompare True représente que la propriété est exclue des propriétés utilisées pour comparer les valeurs de cellule pendant le calcul.
cardView True représente que la propriété est exclue des propriétés affichées par carte vue.
dotNotation True représente que la propriété est exclue des propriétés accessibles via la fonction FIELDVALUE.
CellValueProviderAttributes description Représente la propriété de description du fournisseur utilisée dans carte vue si aucun logo n’est spécifié.
logoSourceAddress Représente une URL utilisée pour télécharger une image qui sera utilisée comme logo dans carte affichage.
logoTargetAddress Représente une URL qui est la cible de navigation si l’utilisateur clique sur l’élément logo dans carte vue.
ChangedEventDetail valueAsJsonAfter Représente le type de valeur après la modification.
valueAsJsonBefore Représente le type de valeur avant la modification.
ChartFill getSolidColor() Obtient la mise en forme de remplissage de couleur uniforme d’un élément de graphique.
ConnectErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de ConnectErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
Div0ErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
DoubleCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
EmptyCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
EntityCardLayout disposition Représente le type de cette disposition.
EntityCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
Dispositions Représente des informations de disposition pour les vues de cette entité.
properties Représente les propriétés de cette entité et leurs métadonnées.
fournisseur Représente des informations qui décrivent le service qui a fourni les données dans ce EntityCellValue.
referencedValues Représente les valeurs de cellule référencées dans EntityCellValue.properties.
text Représente le texte affiché lorsqu’une cellule avec cette valeur est affichée.
type Représente le type de cette valeur de cellule.
EntityCompactLayout icon Spécifie le nom de l’icône utilisée pour ouvrir le carte.
EntityPropertyExtraProperties propertyMetadata Représente les métadonnées relatives à la propriété .
EntityViewLayouts carte Représente la disposition de cette entité dans carte vue.
compact Représente la disposition utilisée lorsque l’espace pour représenter l’entité est limité.
ExternalErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de ExternalErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
FieldErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de FieldErrorCellValue.
errorType Représente le type de ErrorCellValue.
fieldName Représente le champ introuvable par FIELDVALUE.
type Représente le type de cette valeur de cellule.
FormattedNumberCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
numberFormat Retourne la chaîne de format numérique utilisée pour afficher cette valeur.
type Représente le type de cette valeur de cellule.
GettingDataErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
LinkedEntityCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
id Représente la source de service qui a fourni les informations dans cette valeur.
Dispositions Représente des informations de disposition pour les vues de cette entité liée.
properties Représente les propriétés de cette entité liée et leurs métadonnées.
fournisseur Représente des informations qui décrivent le service qui a fourni des données dans ce LinkedEntityCellValue.
text Représente le texte affiché lorsqu’une cellule avec cette valeur est affichée.
type Représente le type de cette valeur de cellule.
LinkedEntityId culture Représente la culture de langue utilisée pour créer ce CellValue.
domainId Représente un domaine spécifique à un service utilisé pour créer le CellValue.
entityId Représente un identificateur spécifique à un service utilisé pour créer le CellValue.
serviceId Représente le service utilisé pour créer le CellValue.
NameErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
NamedItem valueAsJson Représentation JSON des valeurs de cet élément nommé.
valueAsJsonLocal Représentation JSON des valeurs de cet élément nommé.
NamedItemArrayValues valuesAsJson Représentation JSON des valeurs de ce tableau d’éléments nommés.
valuesAsJsonLocal Représentation JSON des valeurs de ce tableau d’éléments nommés.
NotAvailableErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
NullErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
NumErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de NumErrorCellValue.
errorType Représente le type de ErrorCellValue.
functionName Représente le nom de la fonction à l’origine de l’erreur.
type Représente le type de cette valeur de cellule.
PlaceholderErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorType Représente le type de ErrorCellValue.
target PlaceholderErrorCellValue est utilisé pendant le traitement, tandis que les données sont téléchargées.
type Représente le type de cette valeur de cellule.
Range valuesAsJson Représentation JSON des valeurs dans les cellules de cette plage.
valuesAsJsonLocal Représentation JSON des valeurs dans les cellules de cette plage.
RangeView valuesAsJson Représentation JSON des valeurs dans les cellules de cette plage.
valuesAsJsonLocal Représentation JSON des valeurs dans les cellules de cette plage.
RefErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de RefErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
ReferenceCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
reference Représente l’index dans les referencedValues propriétés des valeurs de cellule telles que EntityCellValue et ArrayCellValue.
type Représente le type de cette valeur de cellule.
RootReferenceCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
SpillErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
columnCount Représente le nombre de colonnes qui se renverseraient s’il n’y avait pas de #SPILL ! erreur.
errorSubType Représente le type de SpillErrorCellValue.
errorType Représente le type de ErrorCellValue.
rowCount Représente le nombre de lignes qui seraient renversées s’il n’y avait pas de #SPILL ! erreur.
type Représente le type de cette valeur de cellule.
StringCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
TableColumn valuesAsJson Représentation JSON des valeurs dans les cellules de cette colonne de tableau.
valuesAsJsonLocal Représentation JSON des valeurs dans les cellules de cette colonne de tableau.
TableColumnCollection addAsJson(index ?: number, values ?: CellValue[][], name ?: string) Ajoute une nouvelle colonne au tableau.
TableRow valuesAsJson Représentation JSON des valeurs dans les cellules de cette ligne de tableau.
valuesAsJsonLocal Représentation JSON des valeurs dans les cellules de cette ligne de tableau.
TableRowCollection addAsJson(index ?: number, values ?: CellValue[][], alwaysInsert ?: boolean) Ajoute une ou plusieurs lignes dans le tableau.
ValueErrorCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
errorSubType Représente le type de ValueErrorCellValue.
errorType Représente le type de ErrorCellValue.
type Représente le type de cette valeur de cellule.
ValueTypeNotAvailableCellValue basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
type Représente le type de cette valeur de cellule.
WebImageCellValue adresse Représente l’URL à partir de laquelle l’image sera téléchargée.
altText Représente le texte de remplacement qui peut être utilisé dans les scénarios d’accessibilité pour décrire ce que l’image représente.
attribution Représente les informations d’attribution pour décrire la source et les licences requises pour l’utilisation de cette image.
basicType Représente la valeur qui serait retournée par Range.valueTypes pour une cellule avec cette valeur.
basicValue Représente la valeur qui serait retournée par Range.values pour une cellule avec cette valeur.
fournisseur Représente des informations qui décrivent l’entité ou la personne qui a fourni l’image.
relatedImagesAddress Représente l’URL d’une page web avec des images qui sont considérées comme liées à ce WebImageCellValue.
type Représente le type de cette valeur de cellule.
Classeur getLinkedEntityCellValue(linkedEntityCellValueId : LinkedEntityId) Retourne un LinkedEntityCellValue en fonction du fourni LinkedEntityId.

Voir aussi