Sideload Suplementos do Office para testes de um compartilhamento de rede
Você pode testar um Suplemento do Office em um cliente do Office que está no Windows publicando o manifesto em um compartilhamento de arquivo de rede (instruções a seguir). Essa opção de implantação destina-se a ser usada quando você concluir o desenvolvimento e o teste em um localhost e quiser testar o suplemento de um servidor não local ou conta de nuvem.
Importante
Não há suporte para implantação por compartilhamento de rede para suplementos de produção. Esse método tem as seguintes limitações.
- O suplemento só pode ser instalado em computadores Windows.
- Se uma nova versão de um suplemento alterar a faixa de opções, como adicionar uma guia personalizada ou um botão personalizado a ela, cada usuário terá que reinstalar o suplemento.
Observação
Se o projeto de suplemento tiver sido criado com uma versão suficientemente recente do Gerador Yeoman para Suplementos do Office, o suplemento realizará sideload automaticamente no cliente de desktop do Office ao executar o npm start
.
Este artigo se aplica apenas aos suplementos de teste Word, Excel, PowerPoint e Project e somente no Windows. Se você quiser testar em outra plataforma ou quiser testar um suplemento do Outlook, confira um dos tópicos a seguir para sideload do suplemento.
- Realizar sideload de suplementos do Office no Office na Web para teste
- Sideload Suplementos do Office no Mac para teste
- Sideload Suplementos do Office no iPad para teste
- Realizar sideload de suplementos do Outlook para teste
O vídeo a seguir oferece orientações para a realização do processo de sideload no suplemento do Office na Web ou para área de trabalho usando um catálogo de pasta compartilhada.
Compartilhar uma pasta
No computador do Windows, onde você deseja hospedar seu suplemento, acesse a pasta pai ou letra da unidade da pasta que você deseja usar como seu catálogo de pasta compartilhada.
Abra o menu de contexto da pasta que você deseja usar como catálogo de pastas compartilhadas (por exemplo, clique com o botão direito do mouse na pasta) e escolha Propriedades.
Dentro da janela de diálogo Propriedades abra a guia Compartilhamentoe escolha o botão Compartilhar.
Dentro a janela de diálogo Acesso à rede adicione você mesmo e quaisquer outros usuários e/ou grupos com quem você deseja compartilhar o suplemento. Você precisará, pelo menos, de permissão de leitura/gravação para a pasta. Depois de terminar de escolher pessoas para compartilhar, escolha o botão Compartilhar .
Quando você vir a confirmação compartilhada da pasta, anote o caminho de rede completo exibido imediatamente após o nome da pasta. (Você precisará inserir esse valor como a Url do Catálogo quando especificar a pasta compartilhada como um catálogo confiável, conforme descrito na próxima seção deste artigo.) Escolha o botão Concluído para fechar a janela de diálogo Acesso à rede.
Escolha o botão Fechar para fechar a caixa de diálogo Propriedades.
Especifique a pasta compartilhada como um catálogo confiável
Há duas opções para como você especifica essa confiança. Siga as instruções para a opção que funciona melhor para sua configuração.
Configure a confiança manualmente
Abra um novo documento no Excel, no Word, no PowerPoint ou no Project.
Escolha a guia Arquivo e, então, Opções.
Escolha Central de Confiabilidade, e escolha o botão Configurações da Central de Confiabilidade.
Escolha Catálogos de Suplemento Confiáveis.
Na caixaUrl catálogo, digite o caminho completo da rede para a pasta que você compartilhou anteriormente. Se você não conseguiu anotar todo o caminho de rede da pasta ao compartilhar a pasta, você pode obtê-lo na janela de diálogo Propriedades, conforme mostrado na captura de tela a seguir.
Depois de inserir o caminho de de rede completo da pasta na caixa Url catálogo, escolha o botão Adicionar Catálogo.
Selecione a caixa de seleção Mostrar no Menu no novo item adicionado e, em seguida, escolha o botão Ok para fechar a janela de diálogo Central de Confiabilidade.
Escolha o botão OK para fechar a janela de diálogo Opções .
Feche e abra novamente o aplicativo do Office para que as alterações tenham efeito.
Configurar a confiança com um script de Registro
Em um editor de texto, crie um arquivo chamado TrustNetworkShareCatalog.reg.
Adicione o conteúdo a seguir ao arquivo.
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{-random-GUID-here-}] "Id"="{-random-GUID-here-}" "Url"="\\\\-share-\\-folder-" "Flags"=dword:00000001
Use uma das várias ferramentas de geração de GUID online, como o Gerador de GUIDs, para gerar um GUID aleatório e, no arquivo TrustNetworkShareCatalog.reg, substitua a cadeia de caracteres "-random-GUID-here-" nos dois locais pelo GUID. (Os símbolos
{}
de delimitação devem permanecer.)Substitua o valor
Url
pelo caminho completo da rede para a pasta que você compartilhou anteriormente. (Observe que quaisquer caracteres\
na URL devem ser duplicados.) Se você não conseguiu anotar todo o caminho de rede da pasta ao compartilhar a pasta, você pode obtê-lo na janela de diálogo Propriedades, conforme mostrado na captura de tela a seguir.Agora o arquivo deve ter a aparência a seguir. Salve-o.
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{01234567-89ab-cedf-0123-456789abcedf}] "Id"="{01234567-89ab-cedf-0123-456789abcedf}" "Url"="\\\\TestServer\\OfficeAddinManifests" "Flags"=dword:00000001
Feche todos os aplicativos do Office.
Execute o TrustNetworkShareCatalog.reg como faria com qualquer arquivo executável, por exemplo, com um clique duplo.
Realizar o sideload do seu suplemento
Coloque o arquivo XML de manifesto de qualquer suplemento que você esteja testando no catálogo de pastas compartilhadas. Observe que você implanta o próprio aplicativo Web em um servidor Web. Especifique a URL no <elemento SourceLocation> do arquivo de manifesto.
Importante
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 AppSource, ele deve estar 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.
Observação
Para projetos do Visual Studio, use o manifesto criado pelo projeto na
{projectfolder}\bin\Debug\OfficeAppManifests
pasta.No Excel, Word ou PowerPoint, selecione>Suplementos Internos na faixa de opções e selecione Obter Suplementos. No Project, selecione Meus Suplementos na guia Projeto da faixa de opções.
Escolha PASTA COMPARTILHADA na parte superior da caixa de diálogo Suplementos do Office.
Selecione o nome do suplemento e escolha Adicionar para inseri-lo.
Remover um suplemento sideload
Você pode remover um suplemento carregado anteriormente limpando o cache do Office em seu computador. Detalhes sobre como limpar o cache no Windows podem ser encontrados no artigo Limpar o cache do Office.
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: ao longo de 2024, vamos eliminar problemas do GitHub como o mecanismo de comentários para conteúdo e substituí-lo por um novo sistema de comentários. Para obter mais informações, consulte:Enviar e exibir comentários de