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 os Suplementos do Office, pode utilizar tecnologias Web familiares, como HTML, CSS e JavaScript para expandir e interagir com o Outlook, Excel, Word, PowerPoint, OneNote e Project. A sua solução pode ser executada no Office em várias plataformas, incluindo Windows, Mac, iPad e num browser.

A aplicação do Office e um site incorporado (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 a clientes do Office – traga dados externos para o Office, automatize documentos do Office, exponha funcionalidades da Microsoft e de outras pessoas em 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 de integração anteriores 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: a aplicação (por exemplo, o Excel), lê o manifesto do suplemento e liga os botões e comandos de menu personalizados do suplemento na IU. Quando necessário, carrega o código JavaScript e HTML do suplemento, que é executado no contexto de um controlo de browser ou webview num sandbox.

Um diagrama de quatro quadrantes a mostrar as áreas de foco para diferentes soluções de extensibilidade do Office. Os Suplementos Web do Office, juntamente com suplementos COM e VSTO, visam programadores profissionais, enquanto o VBA visa os utilizadores finais. Os Suplementos Web do Office concentram-se em experiências e colaboração entre plataformas, enquanto os suplementos COM e VSTO e VBA atendem à experiência individual no Windows.

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

  • Suporte para várias plataformas: os Suplementos do Office são executados no Office na Web, Windows, Mac e iPad.

  • Implementação e distribuição centralizadas: os administradores podem implementar suplementos do Office centralmente numa organização.

  • Acesso fácil através do AppSource: pode disponibilizar a sua solução a uma audiência alargada ao submetê-la para o AppSource.

  • Com base na tecnologia Web padrão: pode utilizar qualquer biblioteca que pretenda 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

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.

Componentes de um suplemento do Office

Um Suplemento do Office inclui dois componentes básicos: um ficheiro de manifesto e a sua própria aplicação 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 especifica as definições e capacidades do suplemento, tais como:

  • 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 utilizador interaja com recursos online a partir de uma aplicação cliente do Office, pode utilizar quaisquer tecnologias, tanto do lado do cliente como do servidor, que o seu fornecedor de alojamento 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 personalizados do friso e comandos de menu (coletivamente denominados "comandos de suplemento").

  • Painéis de tarefas 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

Pode adicionar botões personalizados do friso e itens de menu ao friso no Office na Web e no Windows. Isso facilita aos usuários o acesso ao suplemento diretamente do aplicativo do Office. Botões personalizados e itens de menu podem iniciar diferentes ações, como mostrar um painel de tarefas com 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 suportam comandos de suplementos (Office no iPad) executam o seu suplemento como um painel de tarefas. No Excel, Word e PowerPoint, os utilizadores iniciam suplementos do painel de tarefas através do> botãoSuplementos Base. No Outlook, os utilizadores iniciam suplementos do painel de tarefas através do botão de suplemento ou através do botão Todas as Aplicações no friso.

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

Estender a funcionalidade do Outlook

Os utilizadores podem executar suplementos do Outlook quando veem, respondem ou criam e-mails, pedidos de reunião, respostas a reuniões, cancelamentos de reuniões ou compromissos. Os suplementos do Outlook podem fazer o seguinte:

  • Expandir o friso da aplicação do Office.
  • Apresentar contextualmente junto a um item do Outlook quando o estiver a ver ou a compor.
  • Execute uma tarefa quando ocorre um evento específico, como quando um utilizador cria uma nova mensagem.

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. Existe um modelo de objeto comum que é partilhado pelo Excel, Outlook, Word, PowerPoint, OneNote e Project. Também existem modelos de objetos específicos de aplicações mais extensos para o Excel, OneNote, PowerPoint e Word. Estas APIs fornecem acesso a objetos conhecidos, como parágrafos e livros, o que facilita a criação de um suplemento para uma aplicação específica.

Exemplos de código

Saiba como criar o Suplemento do Office mais simples apenas com um manifesto, uma página Web HTML e um logótipo. Os exemplos seguintes irão ajudá-lo a começar a utilizar a aplicação do Office que lhe interessa.

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