Novedades de Excel API de JavaScript 1.19

ExcelApi 1.19 agrega funcionalidades para gráficos y formas que le ayudan a visualizar mejor los datos en Excel. También se incluyen actualizaciones en la característica de tipos de datos, como la compatibilidad con tipos de datos vinculados, la notación de puntos y opciones ampliadas para los valores básicos de las celdas.

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

Área de característica Descripción Objetos relevantes
Etiquetas de gráficos Controlar la apariencia de las etiquetas del gráfico. ChartDataLabel, ChartDataLabelAnchor, ChartLeaderLines, ChartLeaderLinesFormat
Entidades vinculadas Se agregó compatibilidad con tipos de datos conectados a Excel desde orígenes externos. Para obtener más información, consulte Crear valores de celda de entidad vinculados LinkedEntityDataDomain, LinkedEntityDataDomainCollection, LinkedEntityDataDomainCreateOptions, LinkedEntityIdCulture, LinkedEntityLoadServiceRequest

Lista de API

En la tabla siguiente se enumeran las API en el conjunto de requisitos de API de JavaScript de Excel 1.19. Para ver la documentación de referencia de API para todas las API compatibles con el conjunto de requisitos de API de JavaScript de Excel 1.19 o anterior, consulte API de Excel en el conjunto de requisitos 1.19 o anterior.

Clase Campos Descripción
BasicCardLayout diseño Representa el tipo de este diseño.
BasicCompactLayout icon Especifica el nombre del icono que se utiliza para abrir la tarjeta.
BasicViewLayouts tarjeta Representa el diseño de este valor y sus propiedades en la vista de tarjeta.
compacto Representa el diseño que se usa cuando el espacio para representar el valor es limitado.
BooleanCellValue diseños Representa la información de diseño de las vistas de este valor booleano.
properties Representa propiedades adicionales de este valor booleano.
proveedor Representa la información que describe el servicio que proporcionó los datos de este BooleanCellValuearchivo .
valores referenciados Representa los valores de celda a los que se hace referencia en .BooleanCellValue.properties
CardLayoutTwoColumnSection diseño Representa el tipo de diseño de esta sección.
ChartDataLabel geometricShapeType Especifica el tipo de forma geométrica de la etiqueta de datos.
getSubstring(start: number, length?: number) Devuelve una subcadena de la etiqueta de datos.
getTailAnchor() Devuelve el delimitador de cola de la etiqueta de datos, que se muestra como una llamada permanente.
setHeight(height: number) Establece la altura de la etiqueta de datos en puntos.
setWidth(width: number) Establece el ancho de la etiqueta de datos en puntos.
showAsStickyCallout Especifica si la etiqueta de datos se muestra como una llamada con el anclaje de cola asociado al punto de datos.
ChartDataLabelAnchor left Especifica la distancia, en puntos, desde el anclaje hasta el borde izquierdo de la etiqueta de datos del gráfico.
top Especifica la distancia, en puntos, desde el anclaje hasta el borde superior de la etiqueta de datos del gráfico.
ChartDataLabels geometricShapeType Especifica el tipo de forma geométrica de las etiquetas de datos.
líneas guía Obtiene un objeto que representa las líneas guía de las etiquetas de datos.
showAsStickyCallout Especifica si las etiquetas de datos se muestran como una llamada con el anclaje de cola asociado al punto de datos.
showLeaderLines Especifica si se muestran líneas guía para las etiquetas de datos.
ChartLeaderLines format Representa el formato de las líneas guía de las etiquetas de datos en una serie.
ChartLeaderLinesFormat line Obtiene un objeto que representa el formato de línea de las líneas guía del gráfico.
DoubleCellValue diseños Representa la información de diseño de las vistas de este valor doble.
numberFormat Devuelve la cadena de formato de número que se usa para mostrar este valor.
properties Representa propiedades adicionales de este valor doble.
proveedor Representa la información que describe el servicio que proporcionó los datos de este DoubleCellValuearchivo .
valores referenciados Representa los valores de celda a los que se hace referencia en .DoubleCellValue.properties
JavaScriptCustomFunctionReferenceCellValue basicType Representa el valor devuelto por Range.valueTypes para una celda con este valor.
Valor básico Representa el valor devuelto por Range.values para una celda con este valor.
functionType Representa el tipo de FunctionCellValue.
id Representa el identificador de la función personalizada.
espacio de nombres Representa el espacio de nombres usado por la función personalizada.
type Representa el tipo de este valor de celda.
LinkedEntityDataDomain dataProvider Obtiene el nombre del proveedor de datos para el dominio de datos de la entidad vinculada.
delete() Elimina este objeto del LinkedEntityDataDomainCollectionarchivo .
id Obtiene el identificador del dominio de datos de la entidad vinculado definido por los complementos de Office.
lastRefreshed Obtiene la fecha y la hora (en la zona horaria local) desde que se abrió el libro y se actualizaron por última vez los LinkedEntityCellValue objetos de este dominio de datos de la entidad vinculada.
loadFunctionId Obtiene el identificador de la función personalizada a la que se llama a petición para resolver o actualizar los objetos del dominio de datos de la entidad vinculada definido por los LinkedEntityCellValue complementos de Office.
name Obtiene el nombre del dominio de datos de la entidad vinculada.
periodicRefreshInterval Obtiene la frecuencia, en segundos, con la que LinkedEntityCellValue los objetos de este dominio de datos de entidad vinculada se actualizan automáticamente.
refresh() Actualiza todos los LinkedEntityCellValue objetos de este dominio de datos de entidad vinculado.
refreshMode Especifica el modo de actualización que define cómo y cuándo se actualizan los LinkedEntityCellValue objetos de este dominio de datos de la entidad vinculada.
serviceId Obtiene el identificador de servicio del dominio de datos de la entidad vinculada.
supportedRefreshModes Obtiene todos los modos de actualización compatibles con el dominio de datos de la entidad vinculada.
LinkedEntityDataDomainAddedEventArgs id Obtiene el identificador del dominio de datos de la entidad vinculada que se acaba de agregar al libro.
serviceId Obtiene el identificador de servicio del dominio de datos de la entidad vinculada que se acaba de agregar al libro.
source Obtiene el origen del evento.
type Obtiene el tipo del evento.
LinkedEntityDataDomainCollection add(options: Excel.LinkedEntityDataDomainCreateOptions) Agrega a la colección un objeto de dominio de datos de entidad vinculada definido por el complemento de Office.
getCount() Obtiene el número de dominios de datos de entidad vinculados de la colección.
getItem(id: string) Obtiene un dominio de datos de entidad vinculada por su id.
getItemAt(index: number) Obtiene un dominio de datos de entidad vinculada por su índice en la colección.
getItemByName(name: string) Obtiene un dominio de datos de entidad vinculada por su name.
getItemByNameOrNullObject(name: string) Obtiene un dominio de datos de entidad vinculada por su name.
getItemOrNullObject(id: string) Obtiene un dominio de datos de entidad vinculada por su id.
items Obtiene los elementos secundarios cargados en esta colección.
onLinkedEntityDataDomainAdded Se produce cuando se agrega un nuevo dominio de datos de entidad vinculada al libro.
onRefreshCompleted Se produce cuando se completa la solicitud para actualizar LinkedEntityCellValue objetos de un dominio de datos de entidad vinculada.
onRefreshModeChanged Se produce cuando se cambia el refreshMode de un dominio de datos de entidad vinculada.
refreshAll() Actualiza todos los LinkedEntityCellValue objetos de todos los dominios de datos de entidades vinculadas de esta colección.
LinkedEntityDataDomainCreateOptions dataProvider Especifica el nombre del proveedor de datos para el dominio de datos de la entidad vinculada.
id Especifica el identificador del dominio de datos de la entidad vinculada.
loadFunctionId Especifica el identificador de la función personalizada a la que se llamará a petición para resolver o actualizar los LinkedEntityCellValue objetos de este dominio de datos de entidad vinculada.
name Especifica el nombre del dominio de datos de la entidad vinculada.
periodicRefreshInterval Especifica la frecuencia, en segundos, con la que LinkedEntityCellValue los objetos de este dominio de datos de entidad vinculada se actualizan automáticamente.
supportedRefreshModes Especifica todos los modos de actualización admitidos por el dominio de datos de la entidad vinculada.
LinkedEntityDataDomainRefreshCompletedEventArgs errors Obtiene los errores encontrados durante la solicitud para actualizar LinkedEntityCellValue los objetos del dominio de datos de la entidad vinculada.
id Obtiene el identificador del dominio de datos de la entidad vinculada cuyos LinkedEntityCellValue objetos se actualizaron.
Actualizado Devuelve true si los LinkedEntityCellValue objetos del dominio de datos de la entidad vinculada se actualizaron correctamente; en caso contrario, devuelve false.
serviceId Obtiene el identificador de servicio del dominio de datos de la entidad vinculada cuyos LinkedEntityCellValue objetos se actualizaron.
source Obtiene el origen del evento.
type Obtiene el tipo del evento.
LinkedEntityDataDomainRefreshModeChangedEventArgs id Obtiene el identificador del dominio de datos de la entidad vinculada cuyo modo de actualización se cambió.
refreshMode Obtiene el nuevo modo de actualización del dominio de datos de la entidad vinculada.
serviceId Obtiene el identificador de servicio del dominio de datos de la entidad vinculada cuyo modo de actualización se cambió.
source Obtiene el origen del evento.
type Obtiene el tipo del evento.
LinkedEntityIdCulture cultura Representa la referencia cultural lingüística usada para crear el LinkedEntityCellValue objeto.
entityId Representa el identificador específico de un servicio utilizado para crear el LinkedEntityCellValue objeto.
LinkedEntityLoadServiceRequest domainId Representa el dominio específico del servicio utilizado para crear los LinkedEntityCellValue objetos.
Entidades Representa los identificadores de entidad y las referencias culturales de los LinkedEntityCellValue objetos que se van a cargar.
LinkedEntityLoadServiceResult Entidades Representa los objetos cargados LinkedEntityCellValue .
Rango getDisplayedCellProperties(cellPropertiesLoadOptions: CellPropertiesLoadOptions) Devuelve una matriz 2D que encapsula los datos de visualización de la fuente, el relleno, los bordes, la alineación y otras propiedades de cada celda.
StringCellValue diseños Representa la información de diseño de las vistas de este valor de cadena.
properties Representa propiedades adicionales de este valor de cadena.
proveedor Representa la información que describe el servicio que proporcionó los datos de este StringCellValuearchivo .
valores referenciados Representa los valores de celda a los que se hace referencia en .StringCellValue.properties
Workbook getActiveShape() Obtiene la forma activa en el libro.
getActiveShapeOrNullObject() Obtiene la forma activa en el libro.
linkedEntityDataDomains Devuelve una colección de dominios de datos de entidades vinculadas que están disponibles en el libro.
Worksheet showDataTypeIcons Especifica si los iconos de tipo de datos están visibles en la hoja de cálculo.

Vea también