Visão geral da plataforma de Suplementos do Office

  • Artigo

Você pode usar a plataforma de suplementos do Office para criar soluções que estendem os aplicativos do Office e interagem com conteúdo nos documentos do Office. Com suplementos do Office, você pode usar tecnologias web familiares, como HTML, CSS e JavaScript para estender e interagir com Outlook, Excel, Word, PowerPoint, OneNote e Project. Sua solução pode ser executada no Office em várias plataformas, incluindo Windows, Mac, iPad e em um navegador.

O aplicativo do Office mais um site inserido (suplemento) tornam infinitas possibilidades de extensibilidade.

Os suplementos do Office podem fazer quase tudo que uma página da Web pode fazer dentro do navegador. Use a plataforma de suplementos do Office para:

  • Adicionar novas funcionalidades aos clientes do Office – traga dados externos para o Office, automatize documentos do Office, exponha a funcionalidade da Microsoft e de outros clientes do Office e muito mais. Por exemplo, use a API do Microsoft Graph para se conectar aos dados que orientam a produtividade.

  • Crie novos objetos avançados e interativos que podem ser integrados em documentos do Office ‒ Mapas, gráficos e visualizações interativas integrados que os usuários podem adicionar a suas próprias planilhas do Excel e apresentações do PowerPoint.

Quais são as diferenças entre os suplementos do Office e os suplementos de COM e VSTO?

Os suplementos COM e VSTO são soluções anteriores de integração do Office que são executadas apenas no Office no Windows. Ao contrário dos suplementos COM e VSTO, os suplementos do Office são suplementos web: o aplicativo (por exemplo, Excel), lê o manifesto de suplemento e conecta os botões de faixa de opções personalizados do suplemento e os comandos de menu na interface do usuário. Quando necessário, ele carrega o código JavaScript e HTML do suplemento, que é executado no contexto de um controle de navegador ou webview em uma área restrita.

Um diagrama de quatro quadrantes mostrando as áreas de foco para diferentes soluções de extensibilidade do Office. Os suplementos COM e VSTO do Office Web têm como destino desenvolvedores profissionais, enquanto o VBA tem como destino usuários finais. Os suplementos web do Office são focados em experiências entre plataformas e colaboração, enquanto suplementos COM e VSTO e VBA atendem à experiência do indivíduo no Windows.

Os Suplementos do Office oferecem as seguintes vantagens em relação aos suplementos criados usando VBA, COM ou VSTO.

  • Suporte entre plataformas: suplementos do Office são executados em Office na Web, Windows, Mac e iPad.

  • Implantação e distribuição centralizadas: os administradores podem implantar suplementos do Office centralmente em uma organização.

  • Fácil acesso via AppSource: você pode disponibilizar sua solução para um público amplo enviando-a ao AppSource.

  • Com base na tecnologia web padrão: você pode usar qualquer biblioteca que quiser para criar suplementos do Office.

Os motivos para usar os Suplementos do Office: multiplataforma, implantação centralizada, acesso fácil por meio do AppSource e baseado em tecnologias Web padrão.

Importante

Suplementos COM e VSTO não têm suporte no novo Outlook no Windows que está atualmente em versão prévia. Esses suplementos ainda têm suporte no cliente clássico do Outlook na área de trabalho do Windows. Para saber mais, confira Desenvolver suplementos do Outlook para novo Outlook no Windows (versão prévia).

Componentes de um suplemento do Office

Um suplemento do Office inclui dois componentes básicos: um arquivo de manifesto XML e seu próprio aplicativo Web. O manifesto define várias configurações, incluindo como o suplemento é integrado a clientes do Office. O aplicativo Web deve ser hospedado em um servidor Web ou serviço de hospedagem na Web, como o Microsoft Azure.

Manifesto

O manifesto é um arquivo XML que especifica configurações e recursos do suplemento, como os seguintes:

  • O nome de exibição, a descrição, a ID, a versão e a localidade padrão do suplemento.

  • Como o suplemento se integra ao Office.  

  • O nível de permissão e os requisitos de acesso a dados para o suplemento.

Aplicativo Web

O Suplemento do Office mais básico consiste em uma página HTML estática que é exibida dentro de um aplicativo do Office, mas não interage com o documento do Office nem com qualquer outro recurso de Internet. No entanto, para criar uma experiência que interaja com documentos do Office ou permita que o usuário interaja com recursos online de um aplicativo cliente do Office, você pode usar todas as tecnologias, tanto do lado do cliente quanto do servidor, que o provedor de hospedagem dá suporte (como ASP.NET, PHP ou Node.js). Para interagir com clientes e documentos do Office, você usa as APIs Office.js e JavaScript.

Componentes de um suplemento Hello World.

Estender os clientes do Office e interagir com eles

Os Suplementos do Office podem fazer o seguinte em um aplicativo cliente do Office.

  • Estender a funcionalidade (qualquer aplicativo do Office)

  • Criar novos objetos (Excel ou PowerPoint)

Estender a funcionalidade do Office

Você pode adicionar novas funcionalidades a aplicativos do Office por meio do seguinte:

  • Botões de faixa de opções personalizados e comandos de menu (chamados coletivamente de "comandos de suplemento").

  • Painéis de tarefa inseriveis.

Painéis personalizados de interface do usuário e de tarefa são especificados no manifesto do suplemento.  

Botões e comandos de menu personalizados

Você pode adicionar botões e itens de menu personalizados à faixa de opções no Office na Web e no Windows. Isso facilita aos usuários o acesso ao suplemento diretamente do aplicativo do Office. Botões de comando podem iniciar diferentes ações, como mostrar um painel de tarefas com código HTML personalizado ou executar uma função JavaScript.  

Botões personalizados e comandos de menu.

Painéis de tarefas

Você pode usar painéis de tarefas, além dos comandos de suplemento, para permitir que os usuários interajam com sua solução. Os clientes que não dão suporte a comandos de suplemento (Office no iPad) executam seu suplemento como um painel de tarefas. No Excel, Word e PowerPoint, os usuários iniciam suplementos do painel de tarefas por meio do> botãoSuplementos Internos. No Outlook, os usuários iniciam suplementos do painel de tarefas por meio do botão suplemento ou por meio do botão Todos os Aplicativos na faixa de opções.

Usar painéis de tarefas, além dos comandos do suplemento.

Estender a funcionalidade do Outlook

Os suplementos do Outlook podem estender a faixa de opções do aplicativo do Office e também exibir contextualmente ao lado de um item do Outlook quando você estiver exibindo ou compondo-o. Eles podem trabalhar com uma mensagem de email, uma solicitação de reunião, uma resposta de reunião, um cancelamento de reunião ou um compromisso quando um usuário está visualizando um item recebido, ou respondendo ou criando um novo item.

Os suplementos do Outlook podem acessar informação contextual do item, como o endereço ou a ID de rastreamento, e, em seguida, usar estes dados para acessarem informações adicionais sobre o servidor e de serviços da Web para criar experiências do usuário envolventes. Na maioria dos casos, um suplemento do Outlook é executado sem modificação no aplicativo outlook para fornecer uma experiência contínua na área de trabalho, web e tablet e dispositivos móveis.

Confira a visão geral dos suplementos do Outlook em Visão geral dos suplementos do Outlook.

Criar novos objetos nos documentos do Office

Você pode inserir objetos baseados na web, chamados de suplementos de conteúdo, em documentos do Excel e PowerPoint. Com os suplementos de conteúdo, você pode integrar visualizações de dados avançadas e baseadas na Web, mídia (como um player de vídeo do YouTube ou uma galeria de imagens) e outros tipos de conteúdo externo.

Inserir objetos baseados na Web chamados suplementos de conteúdo.

APIs JavaScript para Office

As APIs JavaScript para Office contêm objetos e membros para a criação de suplementos e a interação com conteúdo do Office e serviços Web. Há um modelo de objeto comum compartilhado pelo Excel, Outlook, Word, PowerPoint, OneNote e Project. Há também modelos de objeto mais extensos específicos do aplicativo para Excel e Word. Essas APIs fornecem acesso a objetos conhecidos, como parágrafos e pastas de trabalho, o que facilita a criação de um suplemento para um aplicativo específico.

Exemplos de código

Saiba como criar o suplemento mais simples do Office com apenas um manifesto, uma página da Web HTML e um logotipo. Os exemplos a seguir ajudarão você a começar a usar o aplicativo do Office no qual você está interessado.

Próximas etapas

Para obter uma introdução mais detalhada sobre o desenvolvimento de Suplementos do Office, confira Desenvolver suplementos do Office.

Confira também