Solucionar erros de usuários com suplementos do Office
Às vezes, seus usuários podem encontrar problemas com suplementos do Office desenvolvidos por você. Por exemplo, um suplemento falha ao carregar ou está inacessível. Use as informações neste artigo para ajudar a resolver problemas comuns que os usuários têm com o seu suplemento do Office.
Também pode utilizar ferramentas para intercetar mensagens HTTP para identificar e depurar problemas com os seus suplementos. As escolhas populares incluem Fiddler, Charles e Requestly.
Erros comuns e etapas de solução de problemas
A tabela a seguir lista as mensagens de erro comuns que os usuários podem receber e as etapas que os usuários podem seguir para resolver os erros.
| Mensagem de erro | Resolução |
|---|---|
| Erro do aplicativo: catálogo não pôde ser alcançado | Verifique as definições da firewall." Catálogo" refere-se ao AppSource. Esta mensagem indica que o utilizador não consegue aceder ao AppSource. |
| ERRO DO APLICATIVO: este aplicativo não pôde ser iniciado. Feche essa caixa de diálogo para ignorar o problema ou clique em "Reiniciar"para tentar novamente. | Verifique se as atualizações mais recentes do Office estão instaladas ou atualize com o Windows Installer. |
| Erro: objeto não dá suporte à propriedade ou ao método 'defineProperty' | Confirme se o Internet Explorer não está sendo executado no modo de compatibilidade. Aceda a Ferramentas Definições> daVista de Compatibilidade. |
| Não foi possível carregar o aplicativo porque não há suporte para sua versão do navegador. Clique aqui para obter uma lista de versões do navegador compatíveis. | Verifique se o navegador dá suporte a armazenamento local HTML5 ou redefina as configurações do Internet Explorer. Para saber mais sobre os navegadores compatíveis, confira Requisitos para a execução de suplementos do Office. |
Ao instalar um suplemento, verá "Erro ao carregar suplementos" na barra de estado
- Feche o Office.
- Verifique se a hora e a data estão definidas corretamente no seu computador. Uma data e hora incorretas podem causar problemas ao verificar o manifesto do suplemento.
- Verifique se o manifesto é válido. Consulte Validar o manifesto de um Suplemento do Office.
- Reiniciar o suplemento.
- Instale o suplemento novamente.
Se o pacote de suplemento tiver sido adulterado antes da instalação, este erro ocorrerá. Transfira o suplemento novamente e tente reinstalá-lo. Em alternativa, contacte o editor do suplemento para obter ajuda.
Também pode dar-nos feedback: se utilizar o Office no Windows ou Mac, pode comunicar comentários à equipa de extensibilidade do Office diretamente a partir do Office. Para tal, selecione Ajuda>Feedback>Comunicar um problema. O envio de um relatório fornece as informações necessárias para compreender o problema.
O suplemento do Outlook não funciona corretamente
Se um suplemento do Outlook executado no Windows e usando o Internet Explorer não está funcionando corretamente, tente ativar a depuração de scripts no Internet Explorer.
- Aceda a Ferramentas Opções>da> InternetAvançadas.
- Em Navegação, desmarque Desativar depuração de scripts (Internet Explorer) e Desativar depuração de scripts (Outro).
Recomendamos que você desmarque essas configurações somente para solucionar o problema. Se você deixar desmarcado, receberá prompts durante a navegação. Depois de resolver o problema, verifique Desativar a depuração de scripts (Internet Explorer) e Desativar novamente a depuração do script (Outro ).
O suplemento não é ativado no Office
Se o suplemento não for ativado quando o utilizador executar os seguintes passos.
Inicie sessão com a respetiva conta Microsoft na aplicação do Office.
Habilitar a verificação de duas etapas para a conta da Microsoft.
Verificar a identidade ao ser solicitado quando tentar inserir um suplemento.
Verifique se as atualizações mais recentes do Office estão instaladas ou atualize com o Windows Installer.
Não é possível exibir a caixa de diálogo do suplemento
Quando o usuário usa um suplemento do Office, ele é solicitado a permitir a exibição de uma caixa de diálogo. O utilizador seleciona Permitir e ocorre a seguinte mensagem de erro.
"As configurações de segurança do navegador nos impedem de criar uma caixa de diálogo. Tente outro navegador ou configure o navegador para que a 'URL' e o domínio mostrado na barra de endereço estejam na mesma zona de segurança".
| Navegadores afetados | Plataformas afetadas |
|---|---|
| Microsoft Edge | Office na Web |
Para resolver o problema, os utilizadores finais ou administradores podem adicionar o domínio do suplemento à lista de sites fidedignos no browser Microsoft Edge.
Importante
Caso não confie no suplemento, não adicione a respectiva URL à lista de sites confiáveis.
Para adicionar uma URL à lista de sites confiáveis:
- No Painel de Controle, abra Opções da Internet>Security.
- Escolha a zona de Sites confiáveis e escolha Sites.
- Insira a URL exibida na mensagem de erro e escolha Adicionar.
- Tente usar o suplemento novamente. Se o problema persistir, verifique as configurações de outras zonas de segurança e confira se o domínio do suplemento está na mesma zona que a URL exibida na barra de endereços do aplicativo do Office.
Esse problema ocorre quando a API da caixa de diálogo é usada no modo pop-up. Para evitar esse problema, use o sinalizador displayInFrame. Isso requer que a página tenha suporte para exibição dentro de um iframe. O exemplo a seguir mostra como usar o sinalizador.
Office.context.ui.displayDialogAsync(startAddress, {displayInIFrame:true}, callback);
O suplemento não atualizará
Poderá ver o seguinte erro ao implementar um manifesto atualizado para o seu suplemento: ADD-IN WARNING: This add-in is currently upgrading. Please close the current message or appointment, and re-open in a few moments.
Quando adiciona funcionalidades ou corrige erros no suplemento, terá de implementar as atualizações. Se o suplemento for implementado por um ou mais administradores nas respetivas organizações, algumas alterações de manifesto exigirão que o administrador consoante as atualizações. Os utilizadores serão bloqueados do suplemento até que o consentimento seja concedido. As seguintes alterações de manifesto exigirão que o administrador consinta novamente.
- Alterações às permissões pedidas. Veja Requesting permissions for API use in add-ins and Understanding Outlook add-in permissions (Pedir permissões para utilização de API em suplementos ) e Understanding Outlook add-in permissions (Compreender as permissões de suplementos do Outlook).
- Âmbitos adicionais ou alterados. (Não aplicável se o suplemento utilizar o manifesto unificado para o Microsoft 365.)
- Eventos adicionais ou alterados do Outlook.
Observação
Sempre que fizer uma alteração ao manifesto, tem de aumentar o número da versão do manifesto.
- Se o suplemento utilizar o manifesto apenas do suplemento, veja Elemento de versão.
- Se o suplemento utilizar o manifesto unificado, veja a propriedade da versão.