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.

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

  1. 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.

  2. 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.

  3. Dentro da janela de diálogo Propriedades abra a guia Compartilhamentoe escolha o botão Compartilhar.

    Caixa de diálogo Propriedades da Pasta com a guia Compartilhamento e o botão Compartilhar realçado.

  4. 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 .

  5. 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.

    Caixa de diálogo de acesso à rede com o caminho de compartilhamento realçado.

  6. 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

  1. Abra um novo documento no Excel, no Word, no PowerPoint ou no Project.

  2. Escolha a guia Arquivo e, então, Opções.

  3. Escolha Central de Confiabilidade, e escolha o botão Configurações da Central de Confiabilidade.

  4. Escolha Catálogos de Suplemento Confiáveis.

  5. 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.

    Caixa de diálogo Propriedades da Pasta com a guia Compartilhamento e o caminho de rede realçados.

  6. Depois de inserir o caminho de de rede completo da pasta na caixa Url catálogo, escolha o botão Adicionar Catálogo.

  7. 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.

    Caixa de diálogo Central de Confiança com o catálogo selecionado.

  8. Escolha o botão OK para fechar a janela de diálogo Opções .

  9. Feche e abra novamente o aplicativo do Office para que as alterações tenham efeito.

Configurar a confiança com um script de Registro

  1. Em um editor de texto, crie um arquivo chamado TrustNetworkShareCatalog.reg.

  2. 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
    
  3. 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.)

  4. 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.

    Caixa de diálogo Propriedades da Pasta com a guia Compartilhamento e o caminho de rede realçados.

  5. 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
    
  6. Feche todos os aplicativos do Office.

  7. Execute o TrustNetworkShareCatalog.reg como faria com qualquer arquivo executável, por exemplo, com um clique duplo.

Realizar o sideload do seu suplemento

  1. 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.

  2. 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.

  3. Escolha PASTA COMPARTILHADA na parte superior da caixa de diálogo Suplementos do Office.

  4. 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