Nouveautés de l’API JavaScript Excel 1.16
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 de 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.
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 sur les 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 de carte. |
CardLayoutSectionStandardProperties | Effondré | Indique si cette section de la carte est initialement réduite. |
Pliable | Représente si cette section de la carte est réductible. | |
properties | Représente les noms des propriétés de cette section. | |
title | Représente le titre de cette section de la carte. | |
CardLayoutStandardProperties | mainImage | Spécifie une propriété qui sera utilisée comme image principale de la carte. |
sections | Représente les sections de la carte. | |
Sous-titre | Représente une spécification de la propriété qui contient le sous-titre de la carte. | |
title | Représente le titre de la carte ou la spécification de la propriété qui contient le titre de la 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 les conditions de licence 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 en mode Carte. | |
CellValuePropertyMetadataExclusions | Autocomplete | 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 la vue carte. | |
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 en mode Carte 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 en mode carte. | |
logoTargetAddress | Représente une URL qui est la cible de navigation si l’utilisateur clique sur l’élément logo en mode Carte. | |
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 la carte. |
EntityPropertyExtraProperties | Propertymetadata | Représente les métadonnées relatives à la propriété . |
EntityViewLayouts | Carte | Représente la disposition de cette entité en mode Carte. |
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. |
|
cardLayout | Représente la disposition de cette entité liée en mode Carte. | |
id | Représente la source de service qui a fourni les informations dans cette valeur. | |
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 . |