Guia do desenvolvedor do suplemento VSTO para Suplementos da Web do Office

Você criou suplementos VSTO para o Office no Windows e agora está explorando os Suplementos do Office, que são executados no Windows, Mac e no Office na Web.

Importante

Não há suporte para suplementos COM e VSTO no novo Outlook no Windows. Esses suplementos ainda têm suporte no cliente de desktop clássico do Outlook no Windows. Para saber mais, confira Desenvolver suplementos do Outlook para o novo Outlook no Windows.

Sua compreensão dos modelos de objeto para Excel, Word e outros aplicativos do Office ajudará porque os Suplementos do Office seguem padrões semelhantes. Mas existem algumas diferenças importantes:

  • Você trabalhará com uma linguagem diferente (JavaScript ou TypeScript) em vez de C# ou Visual Basic .NET. (Também há uma maneira, descrita posteriormente, de reutilizar parte do código existente em um suplemento da Web.)
  • Os suplementos Web do Office são implantados de forma diferente dos suplementos do VSTO.
  • Os Suplementos da Web do Office são aplicativos Web executados em um controle de modo de exibição da Web simplificado que é incorporado ao aplicativo do Office, portanto, você precisa obter uma compreensão básica dos aplicativos Web e de como eles são hospedados em servidores Web ou contas de nuvem.

Por esses motivos, grande parte deste artigo se sobrepõe ao nosso Guia para iniciantes sobre extensões do Office. Esta versão adiciona recursos para desenvolvedores de suplemento VSTO para ajudá-lo a aproveitar sua experiência e 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. Portanto, primeiro você deve ter uma compreensão básica dos aplicativos da web e como eles são hospedados na web. Há uma quantidade enorme de informações sobre isso na Internet, em livros e em cursos online. Uma boa maneira de começar se você não tiver nenhum conhecimento prévio de aplicativos da web é pesquisar "O que é um aplicativo da web?" em seu mecanismo de pesquisa.
  • A principal linguagem de programação que você usará na criação de suplementos do Office é o JavaScript ou o TypeScript. Se você não estiver familiarizado com nenhuma dessas linguagens, mas tiver experiência com VBA, VB.NET, C#, provavelmente 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. Se estiver fazendo a transição para os Suplementos da Web do Office, volte aqui depois de lê-los 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 PowerPoint para Visual Studio.

Etapa 3: Codifique

Você não pode aprender a dirigir lendo o manual do proprietário, então comece a codificar com este tutorial do PowerPoint. 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 uma visão geral da biblioteca JavaScript do Office com o artigo Desenvolver suplementos do Office.

Em seguida, explore as APIs JavaScript do Office com a ferramenta Script Lab, uma área restrita 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

Entenda as finalidades do manifesto do Suplemento do Office e obtenha uma introdução à sua marcação XML ou JSON no manifesto dos Suplementos do Office.

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

Você pode reutilizar parte do código do suplemento VSTO em um suplemento do Office movendo-o para o back-end do aplicativo Web no servidor e disponibilizando-o para JavaScript ou TypeScript como uma API 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.

Etapa 7: Criar uma conta do Partner Center

Se você planeja publicar seu suplemento no Microsoft Marketplace, crie uma conta no Partner Center. Isso pode levar algum tempo. Comece esse processo o mais rápido possível para evitar atrasos no lançamento.

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:

Tutoriais ou inícios rápidos para outros aplicativos do Office

Observação

Esses tutoriais usam o Yo Office como sua infraestrutura de ferramentas, em vez do Visual Studio e dos modelos de desenvolvimento do Office.

Outros assuntos importantes

  • Last updated on