Visão geral da plataforma de Suplementos do OfficeOffice Add-ins platform overview

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, você pode usar tecnologias de web conhecidas, como HTML, CSS e JavaScript, para estender e interagir com o Word, Excel, PowerPoint, OneNote, Project e Outlook. Sua solução pode ser executada no Office através de várias plataformas, incluindo Windows, Mac, iPad e em um navegador.You can use the Office Add-ins platform to build solutions that extend Office applications and interact with content in Office documents. With Office Add-ins, you can use familiar web technologies such as HTML, CSS, and JavaScript to extend and interact with Word, Excel, PowerPoint, OneNote, Project, and Outlook. Your solution can run in Office across multiple platforms, including Office on Windows, Office Online, Office for Mac, and Office for iPad.

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:Office Add-ins can do almost anything a webpage can do inside a browser. Use the Office Add-ins platform to:

  • Adicionar novas funcionalidades para os clientes do Office – trazer dados externos para o Office, automatizar documentos do Office, expor a funcionalidade de terceiros em clientes do Office e muito mais. Por exemplo, use a API do Microsoft Graph para se conectar aos dados que orientam a produtividade.Add new functionality to Office clients - Bring external data into Office, automate Office documents, expose third-party functionality in Office clients, and more. For example, use Microsoft Graph API to connect to data that drives productivity.

  • 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.Create new rich, interactive objects that can be embedded in Office documents - Embed maps, charts, and interactive visualizations that users can add to their own Excel spreadsheets and PowerPoint presentations.

Quais são as diferenças entre os suplementos do Office e os suplementos de COM e VSTO?How are Office Add-ins different from COM and VSTO add-ins?

Os suplementos de COM ou VSTO são soluções de integração anteriores 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 Office, o aplicativo do host, por exemplo, o Excel, lê o manifesto do suplemento e conecta os comandos do menu e os botões da faixa de opções personalizada do suplemento à interface de 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.COM or VSTO add-ins are earlier Office integration solutions that run only on Office on Windows. Unlike COM add-ins, Office Add-ins don't involve code that runs on the user's device or in the Office client. For an Office Add-in, the host application, for example Excel, reads the add-in manifest and hooks up the add-in’s custom ribbon buttons and menu commands in the UI. When needed, it loads the add-in's JavaScript and HTML code, which executes in the context of a browser in a sandbox.

Os suplementos do Office fornecem as seguintes vantagens em relação aos suplementos criados usando o VBA, COM ou VSTO:Office Add-ins provide the following advantages over add-ins built using VBA, COM, or VSTO:

  • Suporte à plataforma cruzada. Os suplementos do Office podem ser executados no Office na Web, Windows, Mac e iPad.Cross-platform support. Office Add-ins run in Office on Windows, Mac, iOS, and Office Online.

  • Implantação e distribuição centralizadas. Os administradores podem implantar suplementos do Office centralmente em uma organização.Centralized deployment and distribution. Admins can deploy Office Add-ins centrally across an organization.

  • Acesso fácil através da AppSource. Você pode disponibilizar sua solução para um público amplo ao enviá-la para o AppSource.Easy access via AppSource. You can make your solution available to a broad audience by submitting it to AppSource.

  • Com base na tecnologia de Internet padrão. Você pode usar qualquer biblioteca que gosta para criar suplementos do Office.Based on standard web technology. You can use any library you like to build Office Add-ins.

Componentes de um suplemento do OfficeComponents of an Office Add-in

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.An Office Add-in includes two basic components: an XML manifest file, and your own web application. The manifest defines various settings, including how your add-in integrates with Office clients. Your web application needs to be hosted on a web server, or web hosting service, such as Microsoft Azure.

Figura 1. Manifesto de suplemento (XML) + página da Web (HTML, JS) = um Suplemento do OfficeFigure 1. Add-in manifest (XML) + webpage (HTML, JS) = an Office Add-in

Manifesto mais página da Web é igual a Suplemento do Office

ManifestoManifest

O manifesto é um arquivo XML que especifica configurações e recursos do suplemento, como os seguintes:The manifest is an XML file that specifies settings and capabilities of the add-in, such as:

  • O nome de exibição, a descrição, a ID, a versão e a localidade padrão do suplemento.The add-in's display name, description, ID, version, and default locale.

  • Como o suplemento se integra ao Office.How the add-in integrates with Office.  

  • O nível de permissão e os requisitos de acesso a dados para o suplemento.The permission level and data access requirements for the add-in.

Aplicativo WebWeb app

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 os documentos do Office ou permita que o usuário interaja com os recursos online de um aplicativo de host do Office, você pode usar qualquer tecnologia, tanto do lado do cliente como do servidor, a qual seu provedor de hospedagem dá suporte (como ASP.NET, PHP ou Nó.js). Para interagir com clientes e documentos do Office, você usa as APIs Office.js e JavaScript.The most basic Office Add-in consists of a static HTML page that is displayed inside an Office application, but that doesn't interact with either the Office document or any other Internet resource. However, to create an experience that interacts with Office documents or allows the user to interact with online resources from an Office host application, you can use any technologies, both client and server side, that your hosting provider supports (such as ASP.NET, PHP, or Node.js). To interact with Office clients and documents, you use the Office.js JavaScript APIs.

Figura 2. Componentes de um suplemento Hello World do OfficeFigure 2. Components of a Hello World Office Add-in

Componentes de um suplemento Hello World

Estender os clientes do Office e interagir com elesExtending and interacting with Office clients

Os suplementos do Office podem fazer o seguinte em um aplicativo de host do Office:Office Add-ins can do the following within an Office host application:

  • Estender a funcionalidade (qualquer aplicativo do Office)Extend functionality (any Office application)

  • Criar novos objetos (Excel ou PowerPoint)Create new objects (Excel or PowerPoint)  

Estender a funcionalidade do OfficeExtend Office functionality

Você pode adicionar novas funcionalidades a aplicativos do Office por meio do seguinte:You can add new functionality to Office applications via the following:  

  • Botões de faixa de opções e comandos de menu personalizados (coletivamente chamados "comandos de suplemento")Custom ribbon buttons and menu commands (collectively called “add-in commands”)

  • Painéis de tarefas inseríveisInsertable task panes

Painéis personalizados de interface do usuário e de tarefa são especificados no manifesto do suplemento.Custom UI and task panes are specified in the add-in manifest.  

Botões e comandos de menu personalizadosCustom buttons and menu commands  

Você pode adicionar itens de menu e botões da faixa de opções personalizados à faixa de opções, tanto no Office para Área de Trabalho do Windows quanto no Office Online. Isso facilita o acesso dos usuários 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.You can add custom ribbon buttons and menu items to the ribbon in Office on Windows Desktop and Office Online. This makes it easy for users to access your add-in directly from their Office application. Command buttons can launch different actions such as showing a task pane with custom HTML or executing a JavaScript function.  

Figura 3. Comandos do suplemento na faixa de opçõesFigure 3. Add-in commands in the ribbon

Botões e comandos de menu personalizados

Painéis de tarefasTask panes  

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 aos comandos de suplemento (Office 2013 e Office para iPad) executarão 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.You can use task panes in addition to add-in commands to enable users to interact with your solution. Clients that do not support add-in commands (Office 2013 and Office for iPad) run your add-in as a task pane. Users launch task pane add-ins via the My Add-ins button on the Insert tab.

Figura 4. Painel de tarefasFigure 4. Task pane

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

Estender a funcionalidade do OutlookExtend Outlook functionality

Os suplementos do Outlook podem estender a faixa de opções do Office e também ser exibidos contextualmente ao lado de um item do Outlook quando você o exibe ou redige. 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.Outlook add-ins can extend the Office ribbon and also display contextually next to an Outlook item when you're viewing or composing it. They can work with an email message, meeting request, meeting response, meeting cancellation, or appointment when a user is viewing a received item or replying or creating a new item. 

Os suplementos do Outlook podem acessar informações contextuais do item, como o endereço ou a ID de rastreamento, e usar esses dados para acessar informações adicionais no servidor e de serviços Web para criar experiências de usuário envolventes. Na maioria dos casos, um suplemento do Outlook é executado sem modificação no aplicativo host do Outlook para fornecer uma experiência perfeita na área de trabalho, na Web e em dispositivos móveis e tablet.Outlook add-ins can access contextual information from the item, such as an address or tracking ID, and then use that data to access additional information on the server and from web services to create compelling user experiences. In most cases, an Outlook add-in runs without modification on the various supporting host applications, including Outlook, Outlook for Mac, Outlook Web App, and Outlook Web App for devices, to provide a seamless experience on the desktop, web, and tablet and mobile devices.

Confira a visão geral dos suplementos do Outlook em Visão geral dos suplementos do Outlook.For an overview of Outlook add-ins, see Outlook add-ins overview.

Criar novos objetos nos documentos do OfficeCreate new objects in Office documents

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.You can embed web-based objects called content add-ins within Excel and PowerPoint documents. With content add-ins, you can integrate rich, web-based data visualizations, media (such as a YouTube video player or a picture gallery), and other external content.

Figura 5. Suplemento de conteúdoFigure 5. Content add-in

Inserir objetos baseado na Web chamados suplementos de conteúdo

APIs JavaScript para OfficeOffice JavaScript APIs

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 compartilhado pelo Excel, Outlook, Word, PowerPoint, OneNote e Project. Também existem modelos de objeto específicos de host mais extensos para o Excel e o 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 host específico.The Office JavaScript APIs contain objects and members for building add-ins and interacting with Office content and web services. There is a common object model that is shared by Excel, Outlook, Word, PowerPoint, OneNote and Project. There are also more extensive host-specific object models for Excel and Word. These APIs provide access to well-known objects such as paragraphs and workbooks, which makes it easier to create an add-in for a specific host.  

Próximas etapasNext steps

Para criar seu primeiro suplemento do Office em menos de cinco minutos, experimente o início rápido do Excel, do Outlook, do Word, doOneNote, PowerPointou Project.To build your first Office Add-in in less than 5 minutes, try out the quick start for Excel, Outlook, Word, OneNote, PowerPoint, or Project. Você pode começar a criar suplementos imediatamente usando o Visual Studio ou outro editor.You can start building add-ins right away using Visual Studio or any other editor. 

Para começar a planejar soluções que criem experiências de usuário eficazes e atraentes, familiarize-se com as diretrizes de design e as práticas recomendadas para Suplementos do Office.To start planning solutions that create effective and compelling user experiences, get familiar with the design guidelines and best practices for Office Add-ins.

Confira tambémSee also