Visão geral da plataforma de Suplementos do Office

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 ou VSTO são soluções anteriores de integração do Office que são executadas apenas no Office no Windows. Ao contrário de suplementos de COM, os suplementos do Office não envolvem código executado no dispositivo do usuário ou no cliente do Office. Para um Suplemento do Office, o aplicativo (por exemplo, Excel), lê o manifesto de suplemento e conecta os botões e comandos de menu personalizados do suplemento na interface do usuário. Quando necessário, ele carrega o código de HTML e o JavaScript, que são executados no contexto de um navegador em uma área restrita.

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.

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

  • Suporte à plataforma cruzada. Os suplementos do Office são executados em Office na Web, Windows, Mac e iPad.

  • Implantação e distribuição centralizada. Os administradores podem implantar suplementos do Office centralmente em uma organização.

  • Acesso fácil através da AppSource. Você pode disponibilizar sua solução para um público amplo ao enviá-la para o AppSource.

  • Com base na tecnologia de Internet padrão. Você pode usar qualquer biblioteca que gosta para criar suplementos do Office.

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 e comandos de menu personalizados (coletivamente chamados "comandos de suplemento")

  • Painéis de tarefas inseríveis

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 2013 e Office no iPad) executam seu suplemento como um painel de tarefas. Os usuários iniciam os suplementos do painel de tarefas através do botão Meus suplementos na guia Inserir.

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 que é 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 host 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