Conjuntos de requisitos da API JavaScript do Excel

  • Artigo

Os conjuntos de requisitos são grupos nomeados de membros da API. Os Suplementos do Office usam conjuntos de requisitos especificados no manifesto ou usam uma verificação de tempo de execução para determinar se um aplicativo do Office oferece suporte para as APIs necessárias para um suplemento. Para obter mais informações, confira Versões do Office e conjuntos de requisitos.

Disponibilidade do conjunto de requisitos

Os suplementos do Excel são executados em várias versões do Office, incluindo o Office 2016 ou posterior no Windows, Office na Web, Mac e iPad. A tabela a seguir lista os conjuntos de requisitos do Excel, os aplicativos cliente do Office com suporte e os builds ou versões mínimas para esses aplicativos quando aplicável.

Observação

Para usar APIs em qualquer um dos conjuntos de requisitos numerados ou ExcelApiOnline, você deve fazer referência à biblioteca de produçãona rede de distribuição de conteúdo (CDN) do Office.js.

Para obter informações sobre o uso de APIs de visualização, confira o artigo APIs de visualização do JavaScript para Excel.

Conjunto de requisitos Office no Windows
– Assinatura do Microsoft 365
– varejo perpétuo Office 2016 e posterior		 Office no Windows
(perpétuo licenciado por volume)		 Office no Mac Office no iPad Office na Web
Visualização Use a versão mais recente do Office para tentar visualizar APIs (talvez seja necessário ingressar no programa Do Microsoft 365 Insider).
ExcelApiOnline Não aplicável Não aplicável Não aplicável Não aplicável Mais recente (confira a página conjunto de requisitos)
ExcelApi 1.17 Versão 2302 (Build 16130.20332) Não disponível 16.70 16.70 Com suporte
ExcelApi 1.16 Versão 2208 (Build 15601.20148) Não disponível 16.64 16.66 Com suporte
ExcelApi 1.15 Versão 2202 (Build 14931.20132) Não disponível 16.58 16.59 Com suporte
ExcelApi 1.14 Versão 2108 (Build 14326.20508) Office 2021: Versão 2108 (Build 14326.20508) 16.52 16.53 Com suporte
ExcelApi 1.13 Versão 2102 (Build 13801.20738) Office 2021: Versão 2102 (Build 13801.20738) 16.50 16.50 Com suporte
ExcelApi 1.12 Versão 2008 (Build 13127.20408) Office 2021: Versão 2008 (Build 13127.20408) 16.40 16.40 Com suporte
ExcelApi 1.11 Versão 2002 (Build 12527.20470) Office 2021: Versão 2002 (Build 12527.20470) 16.33 16.35 Com suporte
ExcelApi 1.10 Versão 1907 (Build 11929.20306) Office 2021: Versão 1907 (Build 11929.20306) 16.30 16.0 Com suporte
ExcelApi 1.9 Versão 1903 (Build 11425.20204) Office 2021: Versão 1903 (Build 11425.20204) 16.24 16.0 Com suporte
ExcelApi 1.8 Versão 1808 (build 10730.20102) Office 2021: Versão 1808 (Build 10730.20102) 16.17 16.0 Com suporte
ExcelApi 1.7 Versão 1801 (build 9001.2171) Office 2019: Versão 1801 (Build 9001.2171) 16.9 16.0 Com suporte
ExcelApi 1.6 Versão 1704 (Build 8201.2001) Office 2019: Versão 1704 (Build 8201.2001) 15.36 15.0 Com suporte
ExcelApi 1.5 Versão 1703 (Build 8067.2070) Office 2019: Versão 1703 (Build 8067.2070) 15.36 15.0 Com suporte
ExcelApi 1.4 Versão 1701 (Build 7870.2024) Office 2019: Versão 1701 (Build 7870.2024) 15.36 15.0 Com suporte
ExcelApi 1.3 Versão 1608 (Build 7369.2055) Office 2019: Versão 1608 (Build 7369.2055) 15.27 15.0 Com suporte
ExcelApi 1.2 Versão 1601 (Build 6741.2088) Office 2019: Versão 1601 (Build 6741.2088) 15.22 15.0 Com suporte
ExcelApi 1.1 Versão 1509 (Build 4266.1001) Office 2016: Versão 1509 (Build 4266.1001) 15.20 15.0 Com suporte

Versões do Office e números de build

Para saber mais sobre as versões do Office e os números de build, confira:

Como usar os conjuntos de requisitos do Excel no tempo de execução e no manifesto

Observação

Esta seção pressupõe que você esteja familiarizado com a visão geral dos conjuntos de requisitos em Versões e conjuntos de requisitos do Office e Especificar aplicativos do Office e requisitos de API.

Os conjuntos de requisitos são grupos nomeados de membros da API. Um Suplemento do Office pode executar uma verificação de tempo de execução ou usar conjuntos de requisitos especificados no manifesto para determinar se um aplicativo do Office dá suporte às APIs necessárias ao suplemento.

Verificando o suporte ao conjunto de requisitos no tempo de execução

O exemplo de código a seguir mostra como determinar se o aplicativo do Office, onde o suplemento está em execução, dá suporte ao conjunto de requisitos da API especificado.

if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
  // Perform actions.
}
else {
  // Provide alternate flow/logic.
}

Definindo o suporte ao conjunto de requisitos no manifesto

Você pode usar o elemento Requirements no manifesto do suplemento para especificar os conjuntos de requisitos mínimos e/ou os métodos de API exigidos pelo suplemento para ser ativado. Se a plataforma ou o aplicativo do Office não for compatível com os conjuntos de requisitos ou métodos de API especificados no Requirements elemento do manifesto, o suplemento não será executado nesse aplicativo ou plataforma, e não será exibido na lista de suplementos mostrados no Meus suplementos. Se o seu suplemento exige um conjunto específico de requisitos para funcionalidade total, mas pode fornecer um valor mesmo para os usuários nas plataformas que não têm suporte para o conjunto de requisitos, recomendamos verificar o suporte a requisitos no tempo de execução conforme descrito acima, em vez de definir o suporte ao conjunto de requisitos no manifesto.

O exemplo de código a seguir mostra o elemento Requirements em um manifesto de suplemento que especifica se o suplemento deve ser carregado em todos os aplicativos cliente do Office que dão suporte ao conjunto de requisitos ExcelApi, versão 1.3 ou superior.

<Requirements>
   <Sets DefaultMinVersion="1.3">
      <Set Name="ExcelApi" MinVersion="1.3"/>
   </Sets>
</Requirements>

Confira também