Novidades na API JavaScript 1.16 do Excel

  • Artigo

O ExcelApi 1.16 adicionou as APIs de tipos de dados. Com os tipos de APIs de dados, as células do Excel podem conter imagens da Web, valores numéricos formatados que mantêm o formato ao longo dos cálculos e, mais notavelmente, cartões de entidade. Os cartões de entidade expandem o potencial dos suplementos do Excel para além de uma grelha bidimensional. Apresentam um ícone dentro de uma célula que abre uma janela modal card na IU do Excel quando selecionada. Para saber mais, confira Usar cartões com tipos de dados de valor de entidade.

A tabela seguinte fornece um resumo conciso das APIs, enquanto a tabela da lista de API subsequente apresenta 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 Web. ArrayCellValue, BooleanCellValue, CellValueAttributionAttributes, CellValueProviderAttributes, DoubleCellValue, EmptyCellValue, EntityCellValue, FormattedNumberCellValue, RootReferenceCellValue, StringCellValue, ValueTypeNotAvailableCellValue, WebImageCellValue
Erros de tipos de dados Objetos de erro que suportam 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 contentor para tipos de dados. Os objetos de esquema de cartão gerem a apresentação de cartões de entidade. EntityCellValue, EntityCardLayout, EntityPropertyExtraProperties, EntityViewLayouts, CardLayoutListSection, CardLayoutPropertyReference, CardLayoutSectionStandardProperties, CardLayoutStandardProperties, CardLayoutTableSection

Lista de API

A tabela seguinte lista as APIs no excel JavaScript API requirement set 1.16. Para ver a documentação de referência da API para todas as APIs suportadas pelo conjunto de requisitos da API JavaScript do Excel definido como 1.16 ou anterior, veja APIs do Excel no conjunto de requisitos 1.16 ou anterior.

Classe Campos Descrição
ArrayCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
elementos Representa os elementos da matriz.
referencedValues Representa os valores das células que são referenciados em ArrayCellValue.elements.
type Representa o tipo deste valor de célula.
BlockedErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de BlockedErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
BooleanCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste valor de célula.
BusyErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de BusyErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
CalcErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de CalcErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
functionName Representa o nome da função que está a causar o erro.
type Representa o tipo deste valor de célula.
CardLayoutListSection esquema Representa o tipo de esquema para esta secção.
CardLayoutPropertyReference property Representa o nome da propriedade referenciada pelo esquema de card.
CardLayoutSectionStandardProperties fechado Representa se esta secção do card está inicialmente fechada.
minimizável Representa se esta secção do card é minimizável.
properties Representa os nomes das propriedades nesta secção.
title Representa o título desta secção do card.
CardLayoutStandardProperties mainImage Especifica uma propriedade que será utilizada como a imagem de main do card.
sections Representa as secções do card.
subTitle Representa uma especificação da propriedade que contém o subtítulo do card.
title Representa o título da card ou a especificação da propriedade que contém o título do card.
CardLayoutTableSection esquema Representa o tipo de esquema para esta secção.
CellValueAttributionAttributes licenseAddress Representa um URL para uma licença ou origem que descreve como esta propriedade pode ser utilizada.
licenseText Representa um nome para a licença que rege esta propriedade.
sourceAddress Representa um URL para a origem do CellValue.
sourceText Representa um nome para a origem do CellValue.
CellValueExtraProperties gravável Representa se será CellValue utilizado 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 utilizar esta propriedade.
excludeFrom Representa as funcionalidades das quais esta propriedade está excluída.
sub-etiqueta Representa a sub-etiqueta para esta propriedade mostrada na vista card.
CellValuePropertyMetadataExclusions Conclusão automática 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 utilizadas para comparar valores de células durante o recalc.
cardView True representa que a propriedade é excluída das propriedades mostradas pela vista card.
dotNotation True representa que a propriedade é excluída das propriedades que podem ser acedidas através da função VALORDOCAMPO.
CellValueProviderAttributes description Representa a propriedade de descrição do fornecedor que é utilizada na vista card se não for especificado nenhum logótipo.
logoSourceAddress Representa um URL utilizado para transferir uma imagem que será utilizada como logótipo na vista card.
logoTargetAddress Representa um URL que é o destino de navegação se o utilizador clicar no elemento de logótipo na vista 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 uniforme de cor de um elemento de gráfico.
ConnectErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de ConnectErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
Div0ErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
DoubleCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste valor de célula.
EmptyCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste valor de célula.
EntityCardLayout esquema Representa o tipo deste esquema.
EntityCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
esquemas Representa informações de esquema para vistas desta entidade.
properties Representa as propriedades desta entidade e os respetivos metadados.
fornecedor Representa informações que descrevem o serviço que forneceu os dados neste EntityCellValue.
referencedValues Representa os valores das células que são referenciados em EntityCellValue.properties.
text Representa o texto apresentado quando uma célula com este valor é composta.
type Representa o tipo deste valor de célula.
EntityCompactLayout icon Especifica o nome do ícone que é utilizado para abrir o card.
EntityPropertyExtraProperties propertyMetadata Representa metadados sobre a propriedade .
EntityViewLayouts card Representa o esquema desta entidade na vista card.
compacto Representa o esquema utilizado quando existe espaço limitado para representar a entidade.
ExternalErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de ExternalErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
FieldErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de FieldErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
fieldName Representa o campo que não foi encontrado por VALORDOCAMPO.
type Representa o tipo deste valor de célula.
FormattedNumberCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
numberFormat Devolve a cadeia de formato de número que é utilizada para apresentar este valor.
type Representa o tipo deste valor de célula.
GettingDataErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
LinkedEntityCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
id Representa a origem do serviço que forneceu as informações neste valor.
esquemas Representa informações de esquema para vistas desta entidade ligada.
properties Representa as propriedades desta entidade ligada e os respetivos metadados.
fornecedor Representa informações que descrevem o serviço que forneceu dados neste LinkedEntityCellValue.
text Representa o texto apresentado quando uma célula com este valor é composta.
type Representa o tipo deste valor de célula.
LinkedEntityId cultura Representa a cultura de idioma utilizada para criar este CellValue.
domainId Representa um domínio específico de um serviço utilizado para criar o CellValue.
entityId Representa um identificador específico de um serviço utilizado para criar o CellValue.
serviceId Representa o serviço utilizado para criar o CellValue.
NameErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
NamedItem valueAsJson Uma representação JSON dos valores neste item com nome.
valueAsJsonLocal Uma representação JSON dos valores neste item com nome.
NamedItemArrayValues valuesAsJson Uma representação JSON dos valores nesta matriz de item nomeado.
valuesAsJsonLocal Uma representação JSON dos valores nesta matriz de item nomeado.
NotAvailableErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
NullErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
NumErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de NumErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
functionName Representa o nome da função que está a causar o erro.
type Representa o tipo deste valor de célula.
PlaceholderErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorType Representa o tipo de ErrorCellValue.
target PlaceholderErrorCellValue é utilizado durante o processamento, enquanto os dados são transferidos.
type Representa o tipo deste valor de célula.
Range valuesAsJson Uma representação JSON dos valores nas células deste intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células deste intervalo.
RangeView valuesAsJson Uma representação JSON dos valores nas células deste intervalo.
valuesAsJsonLocal Uma representação JSON dos valores nas células deste intervalo.
RefErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de RefErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
ReferenceCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
reference Representa o índice nas referencedValues propriedades dos valores das células, como EntityCellValue e ArrayCellValue.
type Representa o tipo deste valor de célula.
RootReferenceCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste valor de célula.
SpillErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
columnCount Representa o número de colunas que transbordam 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 transbordam se não houvesse #SPILL! .
type Representa o tipo deste valor de célula.
StringCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste 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(índice?: número, valores?: CellValue[][], nome?: cadeia) 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(índice?: número, valores?: CellValue[][], alwaysInsert?: booleano) Adiciona uma ou mais linhas à tabela.
ValueErrorCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
errorSubType Representa o tipo de ValueErrorCellValue.
errorType Representa o tipo de ErrorCellValue.
type Representa o tipo deste valor de célula.
ValueTypeNotAvailableCellValue basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
type Representa o tipo deste valor de célula.
WebImageCellValue address Representa o URL a partir do qual a imagem será transferida.
altText Representa o texto alternativo que pode ser utilizado 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 utilizar esta imagem.
basicType Representa o valor que seria devolvido por para Range.valueTypes uma célula com este valor.
basicValue Representa o valor que seria devolvido por para Range.values uma célula com este valor.
fornecedor Representa informações que descrevem a entidade ou indivíduo que forneceu a imagem.
relatedImagesAddress Representa o URL de uma página Web com imagens consideradas relacionadas com esta WebImageCellValue.
type Representa o tipo deste valor de célula.
Pasta de trabalho getLinkedEntityCellValue(linkedEntityCellValueId: LinkedEntityId) Devolve um LinkedEntityCellValue com base no fornecido LinkedEntityId.

Confira também