Novidades no Excel API JavaScript 1.16

O ExcelApi 1.16 adicionou as APIs de tipos de dados. Com as APIs de tipos de dados, as células do Excel podem conter imagens da Web, valores numéricos formatados que mantêm seu formato ao longo de cálculos e, principalmente, cartões de entidade. Os cartões de entidade estendem o potencial dos suplementos do Excel para além de uma grade bidimensional. Eles exibem um ícone dentro de uma célula que abre uma janela modal de card na interface do usuário do Excel quando selecionado. Para saber mais, confira Usar cartões com tipos de dados de valor de entidade.

A tabela a seguir fornece um resumo conciso das APIs, enquanto a tabela de lista de APIs subsequente fornece uma lista detalhada.

Área de recurso Descrição Objetos relevantes
Tipos de dados Uma extensão dos tipos de dados existentes do Excel, incluindo suporte para números formatados e imagens da Web. ArrayCellValue, BooleanCellValue, CellValueAttributionAttributes, CellValueProviderAttributes, DoubleCellValue, EmptyCellValue, EntityCellValue, FormattedNumberCellValue, RootReferenceCellValue, StringCellValue, ValueTypeNotAvailableCellValue, WebImageCellValue
Erros de tipos de dados Objetos de erro que dão suporte a tipos de dados expandidos. BlockedErrorCellValue, BusyErrorCellValue, CalcErrorCellValue, ConnectErrorCellValue, Div0ErrorCellValue, FieldErrorCellValue, GettingDataErrorCellValue, NotAvailableErrorCellValue, NameErrorCellValue, NullErrorCellValue, NumErrorCellValue, PlaceholderErrorCellValue, RefErrorCellValue, SpillErrorCellValue, ValueErrorCellValue
Tipos de dados de entidade e cartões de entidade Uma entidade é um contêiner para tipos de dados. Os objetos de layout de cartão gerenciam a exibição de cartões de entidade. EntityCellValue, EntityCardLayout, EntityPropertyExtraProperties, EntityViewLayouts, CardLayoutListSection, CardLayoutPropertyReference, CardLayoutSectionStandardProperties, CardLayoutStandardProperties, CardLayoutTableSection

Lista de APIs

A tabela a seguir lista as APIs no Excel Conjunto de requisitos da API JavaScript 1.16. Para exibir a documentação de referência da API para todas as APIs compatíveis com o conjunto de requisitos da API JavaScript do Excel 1.16 ou anterior, consulte APIs do Excel no conjunto de requisitos 1.16 ou anterior.

Classe Campos Descrição
ArrayCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
elementos Representa os elementos da matriz.
valores referenciais Representa os valores de célula referenciados em ArrayCellValue.elements.
type Representa o tipo desse valor de célula.
BlockedErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de BlockedErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
BooleanCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
BusyErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de BusyErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
CalcErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de CalcErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
functionName Representa o nome da função que está causando o erro.
type Representa o tipo desse valor de célula.
CardLayoutListSection de dispositivos móveis Representa o tipo de layout desta seção.
CardLayoutPropertyReference property Representa o nome da propriedade referenciada pelo layout do card.
CardLayoutSectionStandardProperties recolhido Representa se esta seção do card foi recolhida inicialmente.
recolhível Representa se esta seção do card é recolhível.
properties Representa os nomes das propriedades nesta seção.
title Representa o título desta seção do card.
CardLayoutStandardProperties mainImage Especifica uma propriedade que será usada como a imagem principal do card.
sections Representa as seções do card.
subTítulo Representa uma especificação de qual propriedade contém o subtítulo do card.
title Representa o título do card ou a especificação de qual propriedade contém o título do card.
CardLayoutTableSection de dispositivos móveis Representa o tipo de layout desta seção.
CellValueAttributionAttributes licenseAddress Representa uma URL para uma licença ou fonte que descreve como essa propriedade pode ser usada.
licenseText Representa um nome para a licença que rege essa propriedade.
endereço de origem Representa uma URL para a origem do CellValue.
sourceText Representa um nome para a origem do CellValue.
CellValueExtraProperties gravável Representa se isso CellValue será usado para substituir uma célula.
writableNote Representa uma explicação sobre o motivo pelo qual CellValue.writable é especificado como falso.
CellValuePropertyMetadata attribution Representa informações de atribuição para descrever os requisitos de origem e licença para usar esta propriedade.
excludeFrom Representa de quais recursos esta propriedade está excluída.
sub-rótulo Representa o sub-rótulo desta propriedade mostrada no modo de exibição de card.
CellValuePropertyMetadataExclusions Preenchimento Automático True afirma que a propriedade foi excluída das propriedades mostradas pelo preenchimento automático.
calcCompare True representa que a propriedade é excluída das propriedades usadas para comparar valores de célula durante o recálculo.
cardView True declara que a propriedade foi excluída das propriedades mostradas pelo modo de exibição de card.
notação de ponto True representa que a propriedade é excluída das propriedades que podem ser acessadas por meio da função FIELDVALUE.
CellValueProviderAttributes description Representa a propriedade de descrição do provedor que é usada no modo de exibição de card se nenhum logotipo for especificado.
logoSourceAddress Representa uma URL usada para baixar uma imagem que será usada como um logotipo no modo de exibição de card.
logoTargetAddress Representa uma URL que é o destino de navegação se o usuário clicar no elemento de logotipo no modo de exibição de card.
ChangedEventDetail valueAsJsonAfter Representa o tipo de valor após a alteração.
valueAsJsonBefore Representa o tipo de valor antes da alteração.
ChartFill getSolidColor() Obtém a formatação de preenchimento de cor uniforme de um elemento do gráfico.
ConnectErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de ConnectErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
Div0ErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
DoubleCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
EmptyCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
EntityCardLayout de dispositivos móveis Representa o tipo desse layout.
EntityCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
layouts Representa informações de layout para exibições desta entidade.
properties Representa as propriedades dessa entidade e seus metadados.
do provedor Representa informações que descrevem o serviço que forneceu os dados neste EntityCellValuearquivo .
valores referenciais Representa os valores de célula referenciados em EntityCellValue.properties.
text Representa o texto mostrado quando uma célula com esse valor é renderizada.
type Representa o tipo desse valor de célula.
EntityCompactLayout icon Especifica o nome do ícone usado para abrir o card.
EntityPropertyExtraProperties propertyMetadata Representa metadados sobre a propriedade.
EntityViewLayouts card Representa o layout dessa entidade na exibição de card.
compacto Representa o layout usado quando há espaço limitado para representar a entidade.
ExternalErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de ExternalErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
FieldErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de FieldErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
nome do campo Representa o campo que não foi encontrado por VALORDOCAMPO.
type Representa o tipo desse valor de célula.
FormattedNumberCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
numberFormat Retorna a cadeia de caracteres de formato de número usada para exibir esse valor.
type Representa o tipo desse valor de célula.
GettingDataErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
LinkedEntityCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
id Representa a fonte de serviço que forneceu as informações nesse valor.
layouts Representa informações de layout para exibições dessa entidade vinculada.
properties Representa as propriedades dessa entidade vinculada e seus metadados.
do provedor Representa informações que descrevem o serviço que forneceu dados neste LinkedEntityCellValuearquivo .
text Representa o texto mostrado quando uma célula com esse valor é renderizada.
type Representa o tipo desse valor de célula.
LinkedEntityId Cultura Representa qual cultura linguística foi usada para criar esse CellValuearquivo .
domainId Representa um domínio específico de um serviço usado para criar o CellValuearquivo .
entityId Representa um identificador específico de um serviço usado para criar o CellValuearquivo .
serviceId Representa qual serviço foi usado para criar o CellValuearquivo .
NameErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
NamedItem valueAsJson Uma representação JSON dos valores neste item nomeado.
valueAsJsonLocal Uma representação JSON dos valores neste item nomeado.
NamedItemArrayValues valuesAsJson Uma representação JSON dos valores nesta matriz de item nomeada.
valuesAsJsonLocal Uma representação JSON dos valores nesta matriz de item nomeada.
NotAvailableErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
NullErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
NumErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de NumErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
functionName Representa o nome da função que está causando o erro.
type Representa o tipo desse valor de célula.
PlaceholderErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorType Representa o tipo de ErrorCellValuearquivo .
target PlaceholderErrorCellValue é usada durante o processamento, enquanto os dados são baixados.
type Representa o tipo desse valor de célula.
Range valuesAsJson Uma representação JSON dos valores nas células desse intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células desse intervalo.
RangeView valuesAsJson Uma representação JSON dos valores nas células desse intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células desse intervalo.
RefErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de RefErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
ReferenceCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
reference Representa o índice nas referencedValues propriedades de valores de célula, como EntityCellValue e ArrayCellValue.
type Representa o tipo desse valor de célula.
RootReferenceCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
SpillErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
columnCount Representa o número de colunas que seriam despejadas se não houvesse #SPILL! .
errorSubType Representa o tipo de SpillErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
rowCount Representa o número de linhas que seriam despejadas se não houvesse #SPILL! .
type Representa o tipo desse valor de célula.
StringCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
TableColumn valuesAsJson Uma representação JSON dos valores nas células desta coluna da tabela.
valuesAsJsonLocal Uma representação JSON dos valores nas células desta coluna da tabela.
TableColumnCollection addAsJson(index?: number, values?: CellValue[][], name?: string) Adiciona uma nova coluna à tabela.
TableRow valuesAsJson Uma representação JSON dos valores nas células nesta linha da tabela.
valuesAsJsonLocal Uma representação JSON dos valores nas células nesta linha da tabela.
TableRowCollection addAsJson(index?: number, values?: CellValue[][], alwaysInsert?: boolean) Adiciona uma ou mais linhas à tabela.
ValueErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
errorSubType Representa o tipo de ValueErrorCellValuearquivo .
errorType Representa o tipo de ErrorCellValuearquivo .
type Representa o tipo desse valor de célula.
ValueTypeNotAvailableCellValue basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
type Representa o tipo desse valor de célula.
WebImageCellValue address Representa a URL a partir da qual a imagem será baixada.
altText Representa o texto alternativo que pode ser usado em cenários de acessibilidade para descrever o que a imagem representa.
attribution Representa informações de atribuição para descrever os requisitos de fonte e licença para usar esta imagem.
basicType Representa o valor que seria retornado por Range.valueTypes uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values uma célula com esse valor.
do provedor Representa informações que descrevem a entidade ou indivíduo que forneceu a imagem.
relatedImagesAddress Representa a URL de uma página da Web com imagens consideradas relacionadas a este WebImageCellValue.
type Representa o tipo desse valor de célula.
Pasta de trabalho getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) Retorna um LinkedEntityCellValue com base no .LinkedEntityId

Confira também