Novedades de la API de JavaScript de Excel 1.16

  • Artículo

ExcelApi 1.16 agregó las API de tipos de datos. Con las API de tipos de datos, las celdas de Excel pueden contener imágenes de la web, valores de número con formato que conservan su formato a lo largo de los cálculos y, en particular, tarjetas de entidad. Las tarjetas de entidad amplían el potencial de los complementos de Excel más allá de una cuadrícula bidimensional. Muestran un icono dentro de una celda que abre una ventana modal de tarjeta en la interfaz de usuario de Excel cuando se selecciona. Para obtener más información, consulte Usar tarjetas con tipos de datos de valor de entidad.

En la tabla siguiente se proporciona un resumen conciso de las API, mientras que la tabla de lista de API posterior proporciona una lista detallada.

Área de característica Descripción Objetos relevantes
Tipos de datos Una extensión de los tipos de datos de Excel existentes, incluida la compatibilidad con números con formato e imágenes web. ArrayCellValue, BooleanCellValue, CellValueAttributionAttributes, CellValueProviderAttributes, DoubleCellValue, EmptyCellValue, EntityCellValue, FormattedNumberCellValue, RootReferenceCellValue, StringCellValue, ValueTypeNotAvailableCellValue, WebImageCellValue
Errores de tipos de datos Objetos de error que admiten tipos de datos expandidos. BlockedErrorCellValue, BusyErrorCellValue, CalcErrorCellValue, ConnectErrorCellValue, Div0ErrorCellValue, FieldErrorCellValue, GettingDataErrorCellValue, NotAvailableErrorCellValue, NameErrorCellValue, NullErrorCellValue, NumErrorCellValue, PlaceholderErrorCellValue, RefErrorCellValue, SpillErrorCellValue, ValueErrorCellValue
Tipos de datos de entidad y tarjetas de entidad Una entidad es un contenedor para tipos de datos. Los objetos de diseño de tarjeta administran la visualización de tarjetas de entidad. EntityCellValue, EntityCardLayout, EntityPropertyExtraProperties, EntityViewLayouts, CardLayoutListSection, CardLayoutPropertyReference, CardLayoutSectionStandardProperties, CardLayoutStandardProperties, CardLayoutTableSection

Lista de API

En la tabla siguiente se enumeran las API del conjunto de requisitos de la API de JavaScript de Excel 1.16. Para ver la documentación de referencia de API para todas las API admitidas por el conjunto de requisitos de la API de JavaScript de Excel 1.16 o anterior, consulte Api de Excel en el conjunto de requisitos 1.16 o anterior.

Clase Campos Descripción
ArrayCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
Elementos Representa los elementos de la matriz.
referencedValues Representa los valores de celda a los que se hace referencia dentro de ArrayCellValue.elements.
type Representa el tipo de este valor de celda.
BlockedErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de BlockedErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
BooleanCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
BusyErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de BusyErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
CalcErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de CalcErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
functionName Representa el nombre de la función que provoca el error.
type Representa el tipo de este valor de celda.
CardLayoutListSection diseño Representa el tipo de diseño de esta sección.
CardLayoutPropertyReference property Representa el nombre de la propiedad a la que hace referencia el diseño de la tarjeta.
CardLayoutSectionStandardProperties colapsado Representa si esta sección de la tarjeta está contraída inicialmente.
plegable Representa si esta sección de la tarjeta es contraíble.
properties Representa los nombres de las propiedades de esta sección.
title Representa el título de esta sección de la tarjeta.
CardLayoutStandardProperties mainImage Especifica una propiedad que se usará como imagen principal de la tarjeta.
sections Representa las secciones de la tarjeta.
subtítulo Representa una especificación de qué propiedad contiene el subtítulo de la tarjeta.
title Representa el título de la tarjeta o la especificación de qué propiedad contiene el título de la tarjeta.
CardLayoutTableSection diseño Representa el tipo de diseño de esta sección.
CellValueAttributionAttributes licenseAddress Representa una dirección URL a una licencia o un origen que describe cómo se puede usar esta propiedad.
licenseText Representa un nombre para la licencia que rige esta propiedad.
sourceAddress Representa una dirección URL al origen de CellValue.
sourceText Representa un nombre para el origen de CellValue.
CellValueExtraProperties Escritura Representa si se CellValue usará para sobrescribir una celda.
writableNote Representa una explicación sobre por qué CellValue.writable se especifica como false.
CellValuePropertyMetadata atribución Representa información de atribución para describir los requisitos de origen y licencia para usar esta propiedad.
excludeFrom Representa de qué características se excluye esta propiedad.
subetiqueta Representa la subetiqueta de esta propiedad que se muestra en la vista de tarjeta.
CellValuePropertyMetadataExclusions autocompletar True representa que la propiedad se excluye de las propiedades mostradas por autocompletar.
calcCompare True representa que la propiedad se excluye de las propiedades usadas para comparar los valores de celda durante la recalcación.
cardView True representa que la propiedad se excluye de las propiedades mostradas por la vista de tarjeta.
dotNotation True representa que la propiedad se excluye de las propiedades a las que se puede acceder a través de la función FIELDVALUE.
CellValueProviderAttributes description Representa la propiedad de descripción del proveedor que se usa en la vista de tarjeta si no se especifica ningún logotipo.
logoSourceAddress Representa una dirección URL que se usa para descargar una imagen que se usará como logotipo en la vista de tarjeta.
logoTargetAddress Representa una dirección URL que es el destino de navegación si el usuario hace clic en el elemento del logotipo en la vista de tarjeta.
ChangedEventDetail valueAsJsonAfter Representa el tipo de valor después del cambio.
valueAsJsonBefore Representa el tipo de valor antes del cambio.
ChartFill getSolidColor() Obtiene el formato uniforme de relleno de color de un elemento de gráfico.
ConnectErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de ConnectErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
Div0ErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
DoubleCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
EmptyCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
EntityCardLayout diseño Representa el tipo de este diseño.
EntityCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
Diseños Representa la información de diseño de las vistas de esta entidad.
properties Representa las propiedades de esta entidad y sus metadatos.
proveedor Representa información que describe el servicio que proporcionó los datos de este EntityCellValue.
referencedValues Representa los valores de celda a los que se hace referencia dentro de EntityCellValue.properties.
text Representa el texto que se muestra cuando se representa una celda con este valor.
type Representa el tipo de este valor de celda.
EntityCompactLayout icon Especifica el nombre del icono que se usa para abrir la tarjeta.
EntityPropertyExtraProperties propertyMetadata Representa metadatos sobre la propiedad .
EntityViewLayouts tarjeta Representa el diseño de esta entidad en la vista de tarjeta.
compacto Representa el diseño que se usa cuando hay espacio limitado para representar la entidad.
ExternalErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de ExternalErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
FieldErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de FieldErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
fieldName Representa el campo que fieldvalue no encontró.
type Representa el tipo de este valor de celda.
FormattedNumberCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
numberFormat Devuelve la cadena de formato de número que se usa para mostrar este valor.
type Representa el tipo de este valor de celda.
GettingDataErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
LinkedEntityCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
id Representa el origen del servicio que proporcionó la información en este valor.
Diseños Representa la información de diseño de las vistas de esta entidad vinculada.
properties Representa las propiedades de esta entidad vinculada y sus metadatos.
proveedor Representa información que describe el servicio que proporcionó datos en este LinkedEntityCellValue.
text Representa el texto que se muestra cuando se representa una celda con este valor.
type Representa el tipo de este valor de celda.
LinkedEntityId cultura Representa qué referencia cultural del lenguaje se usó para crear este CellValue.
domainId Representa un dominio específico de un servicio que se usa para crear CellValue.
entityId Representa un identificador específico de un servicio que se usa para crear CellValue.
serviceId Representa qué servicio se usó para crear CellValue.
NameErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
NamedItem valueAsJson Representación JSON de los valores de este elemento con nombre.
valueAsJsonLocal Representación JSON de los valores de este elemento con nombre.
NamedItemArrayValues valuesAsJson Representación JSON de los valores de esta matriz de elementos con nombre.
valuesAsJsonLocal Representación JSON de los valores de esta matriz de elementos con nombre.
NotAvailableErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
NullErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
NumErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de NumErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
functionName Representa el nombre de la función que provoca el error.
type Representa el tipo de este valor de celda.
PlaceholderErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorType Representa el tipo de ErrorCellValue.
target PlaceholderErrorCellValue se usa durante el procesamiento, mientras se descargan los datos.
type Representa el tipo de este valor de celda.
Rango valuesAsJson Representación JSON de los valores de las celdas de este rango.
valuesAsJsonLocal Representación JSON de los valores de las celdas de este rango.
RangeView valuesAsJson Representación JSON de los valores de las celdas de este rango.
valuesAsJsonLocal Representación JSON de los valores de las celdas de este rango.
RefErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de RefErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
ReferenceCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
reference Representa el índice en las referencedValues propiedades de los valores de celda como EntityCellValue y ArrayCellValue.
type Representa el tipo de este valor de celda.
RootReferenceCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
SpillErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
columnCount Representa el número de columnas que se vertían si no hubiera #SPILL. error.
errorSubType Representa el tipo de SpillErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
rowCount Representa el número de filas que se vertían si no hubiera #SPILL. error.
type Representa el tipo de este valor de celda.
StringCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
TableColumn valuesAsJson Representación JSON de los valores de las celdas de esta columna de tabla.
valuesAsJsonLocal Representación JSON de los valores de las celdas de esta columna de tabla.
TableColumnCollection addAsJson(index?: number, values?: CellValue[][], name?: string) Agrega una nueva columna a la tabla.
TableRow valuesAsJson Representación JSON de los valores de las celdas de esta fila de tabla.
valuesAsJsonLocal Representación JSON de los valores de las celdas de esta fila de tabla.
TableRowCollection addAsJson(index?: number, values?: CellValue[][], alwaysInsert?: boolean) Agrega una o más filas a la tabla.
ValueErrorCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
errorSubType Representa el tipo de ValueErrorCellValue.
errorType Representa el tipo de ErrorCellValue.
type Representa el tipo de este valor de celda.
ValueTypeNotAvailableCellValue basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
type Representa el tipo de este valor de celda.
WebImageCellValue address Representa la dirección URL desde la que se descargará la imagen.
altText Representa el texto alternativo que se puede usar en escenarios de accesibilidad para describir lo que representa la imagen.
atribución Representa información de atribución para describir los requisitos de origen y licencia para usar esta imagen.
basicType Representa el valor que devolvería Range.valueTypes para una celda con este valor.
basicValue Representa el valor que devolvería Range.values para una celda con este valor.
proveedor Representa información que describe la entidad o la persona que proporcionó la imagen.
relatedImagesAddress Representa la dirección URL de una página web con imágenes que se consideran relacionadas con este WebImageCellValue.
type Representa el tipo de este valor de celda.
Workbook getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) Devuelve un LinkedEntityCellValue objeto basado en el proporcionado LinkedEntityId.

Vea también