Fazer sideload de suplementos do Office para o Office na Web

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

Quando você faz sideload de um suplemento na Web, o manifesto do suplemento é armazenado no armazenamento local do navegador, portanto, se você limpar o cache do navegador ou alternar para um navegador diferente, precisará fazer o sideload do suplemento novamente.

As etapas para fazer sideload de um suplemento na Web variam com base nos fatores a seguir.

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

Na lista a seguir, vá para a seção ou artigo que corresponde 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.

• Se você estiver fazendo sideload de um suplemento do Outlook, consulte o artigo Fazer sideload de suplementos do Outlook para teste.

• Se você criou o suplemento usando o gerador Yeoman para Suplementos do Office, consulte Fazer sideload de um suplemento criado pelo Yeoman para o Office na Web.

• Se você criou o suplemento usando o Visual Studio, consulte Sideload de um suplemento na Web ao usar o Visual Studio.

• Para todos os outros casos, consulte uma das seções a seguir.

  • Se você estiver fazendo sideload para o Office na Web com uma conta da Microsoft, consulte Fazer sideload manual de um suplemento para o Office na Web.
  • Se você estiver fazendo sideload para o Office na Web com uma conta em um locatário do Microsoft 365, consulte Fazer sideload de um suplemento para o Microsoft 365.

Fazer sideload de um suplemento criado pelo Yeoman para o Office na Web

Este processo tem suporte apenas no 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 o Office na Web ou o OneDrive. Usando a opção Criar, crie 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 que você copiou.

   Observação

   Se você estiver desenvolvendo em um Mac, coloque entre {url} aspas simples. 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 fizer sideload no documento, faça o sideload manualmente seguindo as instruções em Fazer sideload manual de suplementos para o Office na Web.

3. Na primeira vez que usar esse método para fazer sideload de um suplemento na Web, você verá uma caixa de diálogo solicitando que você habilite o modo de desenvolvedor. Marque a caixa de seleção Ativar 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 seu computador. Selecione Sim.

5. Seu suplemento está instalado. Se 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 nenhum comando de suplemento, o painel de tarefas deverá aparecer.

Fazer sideload de 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 fazer o sideload do suplemento. Quando você deseja fazer sideload para o Office na Web, o processo de 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 de Propriedades.

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

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

4. No projeto de suplemento, abra o arquivo XML do manifesto. Verifique se 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 exibidas 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 da Web (por exemplo, clicando com o botão direito nele) e escolha Depurar>Iniciar nova instância. Isso executa o projeto Web sem iniciar o Office.

8. No Office na Web, faça o sideload do suplemento usando as etapas descritas em Fazer o sideload manual de um suplemento para o Office no Office na Web.

Fazer sideload manual de um suplemento para o 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 o Office na Web. Abra um documento no Excel, OneNote, PowerPoint ou Word.

2. Selecione Suplementos da Página Inicial> e,em seguida, selecione Mais Configurações.

3. Na caixa de diálogo Suplementos do Office , selecione Carregar Meu Suplemento.

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

   

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 do painel de tarefas que não tem comandos de suplemento, o painel de tarefas deverá aparecer.

Fazer sideload de um suplemento para o Microsoft 365

1. Entre na sua conta do Microsoft 365.

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

3. Siga as etapas 2 a 5 da seção Fazer sideload manual de um suplemento para o Office na Web.

Remover um suplemento com sideload

Se você executou o npm start comando e seu suplemento foi automaticamente carregado com sideload, execute npm stop quando estiver pronto para interromper o servidor de desenvolvimento e desinstalar seu suplemento.

Caso contrário, para remover um suplemento sideload, consulte Desinstalar suplementos em desenvolvimento.

Confira também

• Sideload de suplementos do Office no Mac
• Sideload de suplementos do Office no iPad
• Realizar sideload de suplementos do Outlook para teste
• Limpar o cache do Office