Versões do Office e conjuntos de requisitos

  • Artigo

Há várias versões do Office em várias plataformas, e nem todas dão suporte a cada API na API JavaScript para Office (Office.js). O Office 2013 no Windows foi a versão mais antiga do Office com suporte para suplementos do Office. Talvez nem sempre você tenha controle sobre a versão do Office que seus usuários instalaram. Para lidar com essa situação, fornecemos um sistema chamado conjuntos de requisitos para ajudá-lo a determinar se um aplicativo do Office dá suporte aos recursos necessários no suplemento do Office.

Observação

  • O Office pode ser executado em várias plataformas, incluindo o Windows, navegadores, Mac e iPad.
  • Exemplos de aplicativos do Office são produtos do Office: Excel, Word, PowerPoint, Outlook, OneNote e assim por diante.
  • O Office está disponível por uma assinatura do Microsoft 365 ou uma licença perpétua. A versão perpétua está disponível por contrato de licenciamento de volume ou varejo.
  • Um conjunto de requisitos é um grupo nomeado de membros da API, por exemplo, ExcelApi 1.5, WordApi 1.3e assim por diante.

Como verificar sua versão do Office

Para identificar a versão do Office que você está usando, em um aplicativo do Office, selecione o menu Arquivo e escolha Conta. A versão do Office é exibida na seção Informações do Produto . Por exemplo, a captura de tela a seguir indica a Versão 1802 do Office (Build 9026.1000).

Verificar sua versão do Office.

Observação

Se sua versão do Office for diferente disso, consulte Qual versão do Outlook eu tenho? ou Sobre o Office: qual versão do Office estou usando? para entender como obter essas informações para sua versão.

Implantação

Como o suplemento é implantado pode afetar a disponibilidade do suplemento nas várias plataformas e clientes. Para saber mais sobre as opções de implantação, consulte Implantar e publicar suplementos do Office.

Disponibilidade dos conjuntos de requisitos do Office

Os suplementos do Office podem usar conjuntos de requisitos de API para determinar se o aplicativo do Office dá suporte aos membros da API que ele precisa usar. O suporte ao conjunto de requisitos varia de acordo com o aplicativo do Office e a versão do aplicativo do Office (consulte seção anterior Como marcar sua versão do Office).

Alguns aplicativos do Office têm seus próprios conjuntos de requisitos de API. Por exemplo, o primeiro conjunto de requisitos para a API do Excel foi ExcelApi 1.1, e o primeiro conjunto de requisitos para a API do Word foi WordApi 1.1. Desde então, vários conjuntos de requisitos novos de ExcelApi e WordApi foram adicionados para fornecer mais funcionalidades de API.

Além disso, outras funcionalidades como comandos de suplemento (extensibilidade da faixa de opções) e a capacidade de iniciar caixas de diálogo (API de Diálogo) foram adicionadas a API comum. Os comandos de suplemento e os conjuntos de requisitos da API de Diálogo são exemplos de conjuntos de API que vários aplicativos do Office compartilham em comum.

Um suplemento só pode usar APIs em conjuntos de requisitos compatíveis com a versão do aplicativo do Office em que o suplemento está em execução. Para saber exatamente quais conjuntos de requisitos estão disponíveis para uma versão específica do aplicativo do Office, consulte os seguintes artigos do conjunto de requisitos específicos do aplicativo.

Alguns conjuntos de requisitos contêm APIs que podem ser usadas por vários aplicativos do Office. Para obter informações sobre esses conjuntos de requisitos, consulte os artigos a seguir.

O número de versão de um conjunto de requisitos, como o "1.1" em ExcelApi 1.1, é relativo ao aplicativo do Office. O número de versão de um determinado conjunto de requisitos (por exemplo, ExcelApi 1.1) não corresponde ao número de versão de Office.js ou aos conjuntos de requisitos para outros aplicativos do Office (por exemplo, Word, Outlook etc.). Os conjuntos de requisitos para os diferentes aplicativos do Office são lançados a taxas diferentes. Por exemplo, ExcelApi 1.5 foi lançado antes do conjunto de requisitos WordApi 1.3.

A biblioteca da API JavaScript do Office (Office.js) inclui todos os conjuntos de requisitos disponíveis no momento. Embora exista algo como conjuntos de requisitos ExcelApi 1.3 e WordApi 1.3, há nenhum conjunto de requisitos Office.js 1.3. A versão mais recente do Office.js é mantida como um único ponto de extremidade do Office fornecida por meio da CDN (rede de distribuição de conteúdo). Para obter mais detalhes sobre a CDN do Office.js, incluindo como a versão e a compatibilidade com versões anteriores são tratadas, consulte Noções básicas sobre a API JavaScript do Office.

Especificar aplicativos do Office e conjuntos de requisitos

Há várias maneiras de especificar quais aplicativos do Office e conjuntos de requisitos são necessários por um suplemento. Para obter informações detalhadas, consulte Especificar aplicativos do Office e requisitos de API

Confira também