Novidades na API JavaScript do Excel 1.16

  • Artigo

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 de número formatados que mantêm seu formato em todos os 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 cartão na interface do usuário do Excel quando selecionada. 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 API 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. 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 API

A tabela a seguir lista as APIs no conjunto de requisitos da API JavaScript do Excel 1.16. Para exibir a documentação de referência da API para todas as APIs com suporte no conjunto de requisitos de 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Elementos Representa os elementos da matriz.
referencedValues Representa os valores de célula que são referenciados em ArrayCellValue.elements.
type Representa o tipo desse valor de célula.
BlockedErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de BlockedErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
BooleanCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de BusyErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
CalcErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de CalcErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
Functionname Representa o nome da função que causa o erro.
type Representa o tipo desse valor de célula.
CardLayoutListSection Layout Representa o tipo de layout para esta seção.
CardLayoutPropertyReference property Representa o nome da propriedade referenciada pelo layout do cartão.
CardLayoutSectionStandardProperties Recolhido Representa se essa seção do cartão foi inicialmente recolhida.
Recolhível Representa se essa seção do cartão é dobrável.
properties Representa os nomes das propriedades nesta seção.
title Representa o título desta seção do cartão.
CardLayoutStandardProperties mainImage Especifica uma propriedade que será usada como a imagem principal do cartão.
sections Representa as seções do cartão.
Legendas Representa uma especificação de qual propriedade contém a legenda do cartão.
title Representa o título do cartão ou a especificação de qual propriedade contém o título do cartão.
CardLayoutTableSection Layout Representa o tipo de layout para esta 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.
sourceAddress 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 por que CellValue.writable é especificado como falso.
CellValuePropertyMetadata attribution Representa informações de atribuição para descrever os requisitos de origem e licença para usar essa propriedade.
excludeFrom Representa de quais recursos essa propriedade é excluída.
sub-rótulo Representa o sub-rótulo dessa propriedade mostrado no modo de exibição de cartão.
CellValuePropertyMetadataExclusions Autocomplete True representa que a propriedade é excluída das propriedades mostradas pela conclusão automática.
calcCompare True representa que a propriedade é excluída das propriedades usadas para comparar valores de célula durante o recalc.
cardView True representa que a propriedade é excluída das propriedades mostradas pelo modo de exibição de cartão.
dotNotation 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 cartão 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 cartão.
logoTargetAddress Representa uma URL que é o destino de navegação se o usuário clicar no elemento do logotipo no modo de exibição do cartão.
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 de gráfico.
ConnectErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de ConnectErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
Div0ErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
DoubleCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
type Representa o tipo desse valor de célula.
EntityCardLayout Layout Representa o tipo desse layout.
EntityCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Layouts Representa informações de layout para exibições dessa entidade.
properties Representa as propriedades dessa entidade e seus metadados.
Provedor Representa informações que descrevem o serviço que forneceu os dados neste EntityCellValue.
referencedValues Representa os valores de célula que são 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 que é usado para abrir o cartão.
EntityPropertyExtraProperties Propertymetadata Representa metadados sobre a propriedade.
EntityViewLayouts Cartão Representa o layout dessa entidade no modo de exibição de cartão.
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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de ExternalErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
FieldErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de FieldErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
Fieldname Representa o campo que não foi encontrado pelo FIELDVALUE.
type Representa o tipo desse valor de célula.
FormattedNumberCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
LinkedEntityCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
cardLayout Representa o layout dessa entidade vinculada no modo de exibição de cartão.
id Representa a fonte de serviço que forneceu as informações nesse valor.
properties Representa as propriedades dessa entidade vinculada e seus metadados.
Provedor Representa informações que descrevem o serviço que forneceu dados neste LinkedEntityCellValue.
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 de idioma foi usada para criar este CellValue.
domainId Representa um domínio específico para um serviço usado para criar o CellValue.
Entityid Representa um identificador específico para um serviço usado para criar o CellValue.
serviceId Representa qual serviço foi usado para criar o CellValue.
NameErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
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 itens nomeada.
valuesAsJsonLocal Uma representação JSON dos valores nesta matriz de itens nomeada.
NotAvailableErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
NullErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
NumErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de NumErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
Functionname Representa o nome da função que causa o erro.
type Representa o tipo desse valor de célula.
PlaceholderErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errortype Representa o tipo de ErrorCellValue.
target PlaceholderErrorCellValue é usado 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 nesse intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células nesse intervalo.
RangeView valuesAsJson Uma representação JSON dos valores nas células nesse intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células nesse intervalo.
RefErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de RefErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
ReferenceCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
columnCount Representa o número de colunas que seriam derramadas se não houvesse #SPILL! .
Errorsubtype Representa o tipo de SpillErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
Rowcount Representa o número de linhas que seriam derramadas 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 para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para 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 nesta coluna de tabela.
valuesAsJsonLocal Uma representação JSON dos valores nas células nesta coluna de 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 de tabela.
valuesAsJsonLocal Uma representação JSON dos valores nas células nesta linha de tabela.
TableRowCollection addAsJson(index?: número, valores?: CellValue[][], alwaysInsert?: booleano) Adiciona uma ou mais linhas à tabela.
ValueErrorCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Errorsubtype Representa o tipo de ValueErrorCellValue.
Errortype Representa o tipo de ErrorCellValue.
type Representa o tipo desse valor de célula.
ValueTypeNotAvailableCellValue basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
type Representa o tipo desse valor de célula.
WebImageCellValue address Representa a URL 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 origem e licença para usar essa imagem.
basicType Representa o valor que seria retornado por Range.valueTypes para uma célula com esse valor.
basicValue Representa o valor que seria retornado por Range.values para uma célula com esse valor.
Provedor Representa informações que descrevem a entidade ou o 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 fornecido LinkedEntityId.

Confira também