Carregar suplementos do Office para Office na Web

  • Artigo

Ao carregar um suplemento, você poderá instalar o suplemento sem colocá-lo primeiro em um catálogo de suplementos. Isso é útil ao testar e desenvolver seu suplemento, pois você pode ver como seu suplemento aparecerá e funcionará.

Quando você carrega um suplemento na Web, o manifesto do suplemento é armazenado no armazenamento local do navegador, portanto, se você limpar o cache do navegador ou mudar para um navegador diferente, precisará carregar o suplemento novamente.

As etapas para sideload de um suplemento na Web variam de acordo com os fatores a seguir.

  • O aplicativo host (por exemplo, Excel, Word, Outlook)
  • Qual ferramenta criou o projeto de suplemento (por exemplo, Visual Studio, gerador Yeoman para Suplementos do Office ou nenhum deles)
  • Se você está com sideload para Office na Web com uma conta Microsoft ou com uma conta em um locatário do Microsoft 365

Na lista a seguir, vá para a seção ou artigo que corresponda ao seu cenário. Observe que o primeiro cenário na lista se aplica aos suplementos do Outlook. Os cenários restantes se aplicam a suplementos que não são do Outlook.

Carregar lateralmente um suplemento criado pelo Yeoman para Office na Web

Esse processo tem suporte apenas para Excel, OneNote, PowerPoint e Word. Este projeto de exemplo pressupõe que você esteja usando um projeto criado com o gerador Yeoman para suplementos do Office.

  1. Abra Office na Web ou OneDrive. Usando a opção Criar, faça um documento no Excel, OneNote, PowerPoint ou Word. Neste novo documento, selecione Compartilhar, selecione Copiar Link e copie a URL.

  2. Abra um Prompt de Comando como administrador. Na linha de comando que começa no diretório raiz do seu projeto, execute o comando a seguir. Substitua "{url}" pela URL copiada.

    Observação

    Se você estiver desenvolvendo em um Mac, inclua as {url} aspas em um único. Não faça isso no Windows.

    npm run start:web -- --document {url}

    Eis alguns exemplos.

    • npm run start:web -- --document https://contoso.sharepoint.com/:t:/g/EZGxP7ksiE5DuxvY638G798BpuhwluxCMfF1WZQj3VYhYQ?e=F4QM1R
    • npm run start:web -- --document https://1drv.ms/x/s!jkcH7spkM4EGgcZUgqthk4IK3NOypVw?e=Z6G1qp
    • npm run start:web -- --document https://contoso-my.sharepoint-df.com/:t:/p/user/EQda453DNTpFnl1bFPhOVR0BwlrzetbXvnaRYii2lDr_oQ?e=RSccmNP

    Se o suplemento não carregar de lado no documento, o carregará manualmente seguindo as instruções em suplementos de sideload manualmente para Office na Web.

  3. Na primeira vez que você usar esse método para sideload de um suplemento na Web, você verá uma caixa de diálogo solicitando que você habilite o modo de desenvolvedor. Selecione a caixa de seleção habilitar o Modo de Desenvolvedor agora e selecione OK.

  4. Você verá uma segunda caixa de diálogo, perguntando se deseja registrar um manifesto do Suplemento do Office no computador. Selecione Sim.

  5. Seu suplemento está instalado. Se ele tiver um comando de suplemento, ele deverá aparecer na faixa de opções ou no menu de contexto. Se for um suplemento de painel de tarefas sem comandos de suplemento, o painel de tarefas deverá ser exibido.

Carregar um suplemento na Web ao usar o Visual Studio

Se você estiver usando o Visual Studio para desenvolver seu suplemento, pressione F5 para abrir um documento do Office na área de trabalho , criar um documento em branco e carregar o suplemento. Quando você deseja sideload para Office na Web, o processo para sideload é semelhante ao sideload manual para a Web. A única diferença é que você deve atualizar o valor do elemento SourceURL e, possivelmente, outros elementos, em seu manifesto para incluir a URL completa em que o suplemento é implantado.

  1. No Visual Studio, escolha Exibir>Janela Propriedades.

  2. No Gerenciador de Soluções, selecione o projeto Web. Isso exibe propriedades para o projeto na janela Propriedades .

  3. Na janela Propriedades, copie a URL de SSL.

  4. No projeto de suplemento, abra o arquivo XML do manifesto. Certifique-se de que você está editando o XML de origem. Para alguns tipos de projeto, o Visual Studio abrirá uma exibição visual do XML que não funcionará para a próxima etapa.

  5. Pesquisar e substituir todas as instâncias de ~remoteAppUrl/ pela URL de SSL que você copiou. Você verá várias substituições dependendo do tipo de projeto e as novas URLs serão semelhantes a https://localhost:44300/Home.html.

  6. Salve o arquivo XML.

  7. No Gerenciador de Soluções, abra o menu de contexto do projeto Web (por exemplo, clicando com o botão direito do mouse nele) e escolha Depurar>Iniciar nova instância. Isso executa o projeto Web sem iniciar o Office.

  8. De Office na Web, faça sideload do suplemento usando as etapas descritas em Carregar manualmente um suplemento para Office na Web.

Carregar manualmente um suplemento para Office na Web

Esse método não usa a linha de comando e pode ser realizado usando comandos somente no aplicativo host (como o Excel).

  1. Abra Office na Web. Abra um documento no Excel, OneNote, PowerPoint ou Word.

  2. >SelecioneSuplementos Internos e, em seguida, selecione Mais Suplementos.

  3. Na caixa de diálogo Suplementos do Office , selecione a guia MY ADD-INS , escolha Gerenciar Meus Suplementos e, em seguida, Carregar Meu Suplemento.

    A caixa de diálogo Suplementos do Office com uma lista suspensa na leitura superior direita

  4. Navegue até o arquivo de manifesto do suplemento e selecione Carregar.

    A caixa de diálogo Carregar suplemento com botões para pesquisar, carregar e cancelar.

  5. Verifique se o suplemento está instalado. Por exemplo, se ele tiver um comando de suplemento, ele deverá aparecer na faixa de opções ou no menu de contexto. Se for um suplemento de painel de tarefas que não tem comandos de suplemento, o painel de tarefas deverá ser exibido.

Observação

Para testar o suplemento do Office com o EdgeHTML (Versão Prévia do Microsoft Edge), é necessária uma etapa de configuração adicional. Em um Prompt de Comando do Windows, execute a seguinte linha: npx office-addin-dev-settings appcontainer EdgeWebView --loopback --yes. Isso não é necessário quando o Office está usando o Edge WebView2 baseado em Chromium. Para obter mais informações, consulte Navegadores e controles de visão da Web usados pelos Suplementos do Office.

Importante

A ferramenta office-addin-dev-settings não tem suporte no Mac.

Carregar um suplemento no Microsoft 365

  1. Entre em sua conta do Microsoft 365.

  2. Abra o Iniciador de Aplicativos na extremidade esquerda da barra de ferramentas e selecione Excel, OneNote, PowerPoint ou Word e crie um novo documento.

  3. Siga as etapas 2 a 5 da seção Carregar manualmente um suplemento para Office na Web.

Remover um suplemento sideload

Para remover um side-in carregado para Office na Web, basta limpar o cache do navegador. Se você fizer alterações no manifesto do suplemento (por exemplo, atualizar nomes de arquivo de ícones ou texto de comandos de suplemento), talvez seja necessário limpar o cache do navegador e recarregar o suplemento usando o manifesto atualizado. Isso permite que Office na Web renderize o suplemento conforme é descrito pelo manifesto atualizado.

Confira também