Como desenvolver suplementos para Office 2016, Office Online e Office Mobile

Os suplementos do Office 2016 permitem que você estenda a capacidade, a funcionalidade e os recursos dos clientes do Office, como Word , Excel , PowerPoint e Outlook , usando tecnologias da web como HTML, CSS e JavaScript. Os suplementos do Office podem ser usados ​​para fazer o seguinte:

• Adicione nova funcionalidade aos clientes do Office - por exemplo, aumente o Word, Excel, PowerPoint e Outlook interagindo com documentos do Office e itens de correio, trazendo dados externos para o Office, processando documentos do Office, expondo funcionalidades de terceiros em clientes do Office e muito mais .
• Crie novos objetos ricos e interativos que podem ser incorporados em documentos do Office - por exemplo, mapas, gráficos e visualizações interativas que os usuários podem adicionar às suas próprias planilhas do Excel e apresentações do PowerPoint.

Os suplementos do Office podem ser executados em uma variedade de plataformas, incluindo Office para Windows 10, Office Online, Office 2016 para Windows, Office 2016 para Mac e Office para iPad. Os suplementos do Office ainda não estão disponíveis para Windows 10 Mobile ou Android, mas a equipe do Office está trabalhando nisso (consulte o host do suplemento do Office e disponibilidade de plataforma para obter mais detalhes). Para executar os suplementos do Office, existem certos requisitos de sistema necessários para o seu dispositivo, e  você pode encontrar esses requisitos aqui .

Como um suplemento do Office pode me ajudar?

Os suplementos do Office podem ajudá-lo a fazer quase tudo que um site pode fazer em um navegador. Os recursos do Office Add-in incluem:

• Estenda a IU nativa do Office criando botões e guias da faixa de opções personalizados.
• Fornece uma IU interativa e lógica personalizada por meio de HTML e JavaScript.
• Use estruturas de JavaScript como jQuery, Angular e muitas outras.
• Conecte-se a terminais REST e serviços da web via HTTP e AJAX.
• Execute código ou lógica do lado do servidor, se a página for implementada usando uma linguagem de script do lado do servidor, como ASP ou PHP.

A infraestrutura de suplementos do Office permite a interação com o aplicativo do Office e o conteúdo do usuário por meio de uma API JavaScript .

Tipos de suplementos do Office 

No momento, existem alguns tipos de Suplementos do Office disponíveis:

Suplementos do Word, Excel e PowerPoint que estendem a funcionalidade

Suplementos do Excel e do PowerPoint que criam novos objetos

Suplementos do Outlook que estendem a funcionalidade

Suplementos do Word, Excel e PowerPoint que estendem a funcionalidade

Adicionar novas funcionalidades ao Word, Excel ou PowerPoint é relativamente simples. Tudo que você precisa fazer é registrar seu suplemento usando o manifesto do suplemento do painel de tarefas. Este manifesto de suplemento permite dois modos de integração; comandos de suplemento e painéis de tarefas inseríveis.

Comandos de suplemento

Você pode usar comandos de suplemento para expandir a interface do usuário do Office para Windows 10 e Office Online. Com comandos add-in, você tem a capacidade de adicionar botões para seus add-ins na faixa de opções ou dentro de menus contextuais selecionados, fornecendo acesso fácil aos seus add-ins dentro do Office. Os botões de comando do add-in podem ser usados ​​para iniciar ações diferentes, como mostrar um painel de tarefas com um HTML personalizado ou executar uma função Javascript específica.

Você também pode definir seus comandos em seu manifesto de comando add-in usando VersionOverrides. Para começar, dê uma olhada nestes  exemplos no GitHub , ou você também pode verificar os  comandos de suplemento para Excel, Word e PowerPoint .

Comandos de suplemento no excel

Comandos add-in no excel online

Além disso, há um vídeo do Canal 9 que aprofunda os comandos de suplemento, chamado " Comandos de suplemento na faixa de opções do Office ".

Painéis de Tarefas que Podem ser Inseridos

Caso você tenha um cliente que ainda não oferece suporte a comandos de suplemento (Office 2013, Office para Mac e Office para iPad), você precisará executar seus comandos de suplemento como um painel de tarefas inserível usando DefaultURL fornecido no manifesto. A partir daí, você pode iniciar seu suplemento no menu "Meus suplementos" na guia Inserir.

Suplementos do Excel e do PowerPoint que criam novos objetos

Você também pode inserir suplementos no Excel ou PowerPoint para criar novos objetos baseados na web ou conteúdo que pode ser incorporado em documentos ou apresentações. Os comandos de suplemento de conteúdo permitem mídia incorporada, como uma galeria de fotos ou vídeo do YouTube, bem como visualizações de dados baseadas na web e outros conteúdos externos.

Exemplo de suplemento de conteúdo do Excel 2013

Para testar este suplemento de conteúdo com o Excel 2013 ou Excel Online, instale o suplemento Bing Maps .

Suplementos do Outlook que estendem a funcionalidade

Os suplementos do Outlook apresentam uma oportunidade de estender a Faixa de Opções do Office e fornecer conteúdo de exibição adicional próximo a um item do Outlook quando você está criando ou exibindo uma mensagem de e-mail. Os suplementos podem funcionar com uma mensagem de e-mail, solicitação de reunião, resposta ou cancelamento, bem como compromissos.

Suplemento do Outlook com botões de comando na faixa de opções

Os suplementos do Outlook podem usar as informações contextuais de um item, como um endereço ou ID de rastreamento de pacote e, em seguida, usar esses dados para acessar informações adicionais de serviços da web para criar interações completas do usuário. Na maioria das vezes, os suplementos do Outlook podem ser executados sem problemas com o Outlook, Outlook para Mac, Outlook Web App e OWA para Dispositivos, para fornecer uma experiência unificada na área de trabalho, online, tablets ou dispositivos móveis.

Suplemento de perspectiva contextual

Você pode instalar o suplemento Package Tracker no Outlook, Outlook para Mac ou Outlook Web App. Confira mais suplementos do Outlook .

O que constitui um suplemento do Office?

Um suplemento do Office é composto de um arquivo de manifesto XML e seu próprio aplicativo da web. O arquivo de manifesto XML cria regras para várias configurações, incluindo como seu suplemento se integra com seus clientes do Office. Por outro lado, seu aplicativo da web precisa ser hospedado em um servidor da web ou você pode usar um serviço de hospedagem na web, como o Azure.

Arquivo de manifesto Xml + aplicativo da web = suplemento do escritório

O arquivo XML Manifest indica configurações e recursos específicos do suplemento do Office, especificamente:

• O nome de exibição do add-in, descrição, ID, versão e localidade padrão.
• Como o add-in se integra ao Office:
  • Para suplementos que estendem Word / Excel / PowerPoint / Outlook: A extensão nativa aponta que o suplemento usa para expor funcionalidades, como botões na faixa de opções.
  • Para suplementos que criam novos objetos incorporáveis: O URL da página padrão que é carregada para o objeto.
• O nível de permissão e os requisitos de acesso a dados para o suplemento.

Se precisar de mais informações, dê uma olhada no  manifesto XML de suplementos do Office .

A versão mais básica de um aplicativo da web é uma página HTML estática exibida em um aplicativo do Office, mas a página não interage com o documento do Office ou com a Internet. A página precisa ser hospedada em um servidor web ou um serviço de hospedagem web, como o Azure; depende do serviço que você acha que mais lhe convém.

Exemplo de suplemento hello world office

Por ser um aplicativo da web, você pode usar qualquer tecnologia de cliente e servidor compatível com seu provedor de hospedagem (como ASP.net, PHP ou Node.js). Para interagir com clientes e documentos do Office, você precisa usar a API JavaScript office.js que o Office 2016 fornece.

As APIs JavaScript para Word e Excel fornecem modelos de objetos específicos do host que podem ser usados ​​em um suplemento do Office. Essas APIs oferecem suporte ao acesso a parágrafos e pastas de trabalho, o que fornece uma maneira mais fácil de criar um suplemento para Word ou Excel. Veja Word Add-ins e Excel Add-ins para mais informações.

Para obter mais informações e informações técnicas sobre APIs Javascript para Office 2016, consulte Compreendendo a API JavaScript para Office , API JavaScript para Office e  Diretrizes de design para suplementos do Office .