Manifesto dos suplementos do Office

Cada suplemento do Office tem um manifesto. Existem dois tipos de manifestos:

  • Manifesto somente do suplemento: esse tipo de manifesto pode ser usado para suplementos de produção no Excel, OneNote, Outlook, PowerPoint, Project e Word. Ele não pode ser usado para um aplicativo que combina um suplemento com algum outro tipo de extensão da plataforma Microsoft 365. Seu formato é XML.
  • Manifesto unificado para Microsoft 365: esta é uma versão expandida do manifesto formatado em JSON que tem sido usado há anos como o manifesto para Aplicativos do Teams. Os suplementos que usam esse manifesto podem ser combinados com outros tipos de aplicativos para o Microsoft 365, ou seja, extensões da plataforma do Microsoft 365 em um único aplicativo que pode ser instalado como uma unidade.

Observação

Para obter informações sobre clientes e plataformas que dão suporte a Suplementos do Office que usam o manifesto unificado para Microsoft 365, consulte Suplementos do Office com o manifesto unificado de aplicativo para Microsoft 365.

O restante deste artigo é aplicável a ambos os tipos de manifesto.

Dica

O arquivo de manifesto de um Suplemento do Office descreve como seu suplemento deve ser ativado quando um usuário final o instala e usa com documentos e aplicativos do Office.

Um arquivo de manifesto permite que um Suplemento do Office faça o seguinte:

  • Descreva a si mesmo fornecendo ID, versão, descrição, nome para exibição e local padrão.

  • Especifique as imagens usadas para identidade visual do suplemento e a iconografia usada para os comandos do suplemento na faixa de opções do Aplicativo do Office.

  • Especifique como o suplemento se integra ao Office, incluindo qualquer interface do usuário personalizada, como botões da faixa de opções criados pelo suplemento.

  • Especifique as dimensões padrão solicitadas para suplementos de conteúdo e a altura solicitada para Suplementos do Outlook.

  • Declare permissões exigidas pelo Suplemento do Office, como ler ou gravar no documento.

Observação

Se você planeja publicar seu suplemento no Microsoft Marketplace e disponibilizá-lo na experiência do Office, certifique-se de estar em conformidade com as políticas de certificação do marketplace comercial. Por exemplo, para passar na validação, o suplemento deve funcionar em todas as plataformas com suporte para os métodos definidos (saiba mais na seção 1120.3 e na página de aplicativo e disponibilidade do Suplemento do Office).

Requisitos de hospedagem

Todos os URIs de imagem, como aqueles usados para comandos de suplemento, devem dar suporte ao cache na produção. O servidor que hospeda a imagem não deve retornar um Cache-Control cabeçalho especificando no-cache, no-store, ou opções semelhantes na resposta HTTP.

Todas as URLs para arquivos de código ou conteúdo no suplemento devem ser protegidas por SSL (HTTPS). Embora não seja estritamente obrigatório em todos os cenários de suplemento, é altamente recomendável o uso do ponto de extremidade do HTTPS para o suplemento. Os suplementos que não estiverem protegidos por SSL (HTTPS) geram erros e avisos de conteúdo não seguro durante o uso. Se você planeja executar seu suplemento no Office na Web ou publicar seu suplemento no Microsoft Marketplace, ele deve ser protegido por SSL. Se o suplemento acessar serviços e dados externos, ele deve estar protegido por SSL para proteger os dados em trânsito. Certificados autoassinados podem ser usados para desenvolvimento e teste, desde que sejam aceitos como confiáveis no computador local.

Práticas recomendadas para enviar para o Microsoft Marketplace

Verifique se a identificação do suplemento é um GUID válido e exclusivo. Diversas ferramentas de gerador de GUID estão disponíveis na Web e podem ser usadas para criar um GUID exclusivo.

Os suplementos enviados ao Microsoft Marketplace também devem incluir uma URL de suporte no manifesto. Para obter mais informações, consulte Políticas de validação para aplicativos e suplementos enviados ao Microsoft Marketplace.

Especificar os domínios que você deseja abrir na janela do suplemento

Ao executar no Office na Web ou no novo Outlook no Windows, seu painel de tarefas pode ser navegado para qualquer URL. No entanto, em plataformas de área de trabalho, se o suplemento tentar acessar uma URL em um domínio diferente daquele que hospeda a página inicial (conforme especificado no arquivo de manifesto), essa URL será aberta em uma nova janela do navegador fora do painel de suplemento do aplicativo do Office.

Para substituir esse comportamento (Office da área de trabalho), especifique cada domínio que você deseja abrir na janela do suplemento no manifesto. Se o suplemento tentar ir para uma URL em um domínio que está na lista, ela então abre no painel de tarefas do Office para desktop e no Office Online. Se ele tentar acessar uma URL que não está na lista, no Office para desktop, essa URL abre em uma nova janela do navegador (fora do painel de suplementos).

Observação

Há duas exceções para esse comportamento.

  • Isso se aplica somente ao painel raiz do suplemento. Se houver um iframe inserido na página do suplemento, o iframe poderá ser direcionado para qualquer URL, independentemente de estar listado no manifesto, mesmo no Office da área de trabalho.
  • Quando uma caixa de diálogo é aberta com a API displayDialogAsync , a URL passada para o método deve estar no mesmo domínio que o suplemento, mas a caixa de diálogo pode ser direcionada para qualquer URL, independentemente de estar listada no manifesto, mesmo no Office da área de trabalho.

Especificar domínios a partir dos quais as chamadas da API do Office.js são feitas

Seu suplemento pode fazer chamadas à API de Office.js do domínio do suplemento referenciado no arquivo de manifesto. Se você tiver outros iframes em seu suplemento que precisem acessar APIs Office.js, adicione o domínio dessa URL de origem ao arquivo de manifesto. Se um iframe com uma origem não listada no manifesto tentar fazer uma chamada à API Office.js, o suplemento receberá um erro de permissão negada.

Confira também

  • Last updated on