Guia do programador do suplemento VSTO para Suplementos Web do Office

  • Artigo

Por isso, criou alguns suplementos VSTO para aplicações do Office que são executados no Windows e agora está a explorar a nova forma de expandir o Office que será executado no Windows, Mac e na versão do browser do conjunto de aplicações do Office: Suplementos Web do Office.

Importante

Os suplementos COM e VSTO não são suportados no novo Outlook no Windows que está atualmente em pré-visualização. Estes suplementos ainda são suportados no cliente de ambiente de trabalho clássico do Outlook no Windows. Para saber mais, consulte Desenvolver suplementos do Outlook para o novo Outlook no Windows.

Sua compreensão sobre os modelos de objeto para Excel, Word e outros aplicativos do Office será uma grande ajuda, pois os modelos de objeto nos suplementos Web do Office seguem padrões semelhantes. Mas haverá alguns desafios:

  • Irá trabalhar com uma linguagem diferente (JavaScript ou TypeScript) em vez de C# ou Visual Basic .NET. (Existe também uma forma, descrita posteriormente, de reutilizar alguns dos seus códigos existentes num suplemento Web.)
  • Os suplementos Web do Office são implantados de forma diferente dos suplementos do VSTO.
  • Os Suplementos Web do Office são aplicações Web que são executadas num controlo de webview simplificado incorporado na aplicação do Office, pelo que tem de obter uma compreensão básica das aplicações Web e como são alojadas em servidores Web ou contas na nuvem.

Por estas razões, grande parte deste artigo duplica o nosso guia de Principiantes para extensões do Office. O que adicionámos são alguns recursos de aprendizagem para ajudar os programadores de suplementos VSTO a tirar partido da sua experiência e também para os ajudar a reutilizar o código existente.

Etapa 0: Pré-requisitos

  • Os suplementos Web do Office (também chamados de suplementos do Office) são essencialmente aplicativos Web incorporados no Office. Por isso, primeiro deve ter uma compreensão básica das aplicações Web e como são alojadas na Web. Há uma quantidade enorme de informações sobre isso na Internet, em livros e em cursos online. Uma boa forma de começar se não tiver conhecimento prévio de aplicações Web é procurar "O que é uma aplicação Web?" no seu motor de busca.
  • A principal linguagem de programação que você usará na criação de suplementos do Office é o JavaScript ou o TypeScript. Se não estiver familiarizado com nenhum destes idiomas, mas tiver experiência com o VBA, VB.NET, C#, provavelmente irá achar o TypeScript mais fácil de aprender. Novamente, há muitas informações sobre essas linguagens de programação na Internet, em livros e em cursos online.

Etapa 1: Comece com os fundamentos

Sabemos que você está ansioso para começar a codificar, mas há algumas coisas sobre os Suplementos do Office que você deve ler antes de abrir o IDE ou o editor de código.

  • Visão Geral da Plataforma de Suplementos do Office: Descubra o que são os suplementos da Web do Office e como eles diferem das formas mais antigas de estender o Office, como os suplementos do VSTO.
  • Desenvolva Suplementos do Office: Obtenha uma visão geral do desenvolvimento e ciclo de vida do Suplemento do Office, incluindo as ferramentas, criando um suplemento na Interface do Usuário e usando APIs de JavaScript para interagir com o documento do Office.

Existem muitos links nesses artigos, mas se você estiver migrando para os suplementos Web do Office, recomendamos que você volte aqui quando os tiver lido e continue na próxima seção.

Etapa 2: Instale ferramentas e crie o seu primeiro suplemento

Agora você tem uma visão geral, então comece com um de nossos inícios rápidos. Para fins de aprendizado da plataforma, recomendamos o início rápido do Excel. Há uma versão baseada no Visual Studio e outra baseada em Node.js e Visual Studio Code. Se você estiver migrando de suplementos do VSTO, provavelmente encontrará a versão do Visual Studio mais fácil de trabalhar.

Etapa 3: Codifique

Não se pode aprender a dirigir lendo o manual do proprietário, então comece a codificar com este tutorial do Excel. Você usará a biblioteca JavaScript do Office e um pouco de XML no manifesto dos suplementos. Não é necessário memorizar nada, porque você terá mais informações sobre ambos em etapas posteriores.

Etapa 4: Entenda a biblioteca JavaScript

Obtenha a imagem geral da biblioteca javaScript do Office com o tutorial Compreender as APIs JavaScript do Office da formação do Microsoft Learn.

Em seguida, explore as APIs JavaScript do Office com a ferramenta Script Lab , um sandbox para executar e explorar as APIs.

Um recurso especial para desenvolvedores de suplemento do VSTO

Esse seria um bom lugar para dar uma olhada no exemplo de suplemento, Suplemento do Excel JavaScript SalesTracker. Ele foi criado para destacar as semelhanças e diferenças entre suplementos do VSTO e suplementos Web do Office, e o leiame do exemplo indica os pontos importantes da comparação.

Etapa 5: Entenda o manifesto

Compreenda as finalidades do manifesto do suplemento Web e uma introdução à marcação XML ou JSON no manifesto de Suplementos do Office.

Etapa 6 (somente para desenvolvedores do VSTO): Reutilize seu código de VSTO

Você pode reutilizar alguns dos códigos de suplemento do VSTO em um suplemento Web do Office, movendo-os para o back-end do seu aplicativo Web no servidor e disponibilizando-o para o JavaScript ou TypeScript como uma API da Web. Para obter instruções, confira Tutorial: compartilhar código entre um Suplemento do VSTO e um Suplemento do Office usando uma biblioteca de códigos compartilhados.

Próximas etapas

Parabéns por concluir o roteiro de aprendizagem para desenvolvedores de suplementos VSTO para suplementos Web do Office! Veja algumas sugestões para explorar ainda mais a documentação: