Depurar suplementos no Office na Web
Este artigo descreve como utilizar o Office na Web para depurar os seus suplementos. Utilize esta técnica:
- Para depurar suplementos num computador que não esteja a executar o Windows ou o cliente de ambiente de trabalho do Office, por exemplo, se estiver a desenvolver num Mac ou Linux.
- Como um processo de depuração alternativo se não conseguir, ou não quiser, depurar num IDE, como o Visual Studio ou o Visual Studio Code.
Este artigo pressupõe que tem um projeto de suplemento que precisa de ser depurado. Se apenas quiser praticar a depuração na Web, crie um novo projeto com um dos inícios rápidos para aplicações específicas do Office, como este guia de introdução para o Word.
Depurar o suplemento
Para depurar seu suplemento usando o Office na Web:
Execute o projeto no localhost e carregue-o em sideload para um documento no Office na Web. Para obter instruções detalhadas sobre o sideload, consulte Sideload manualmente suplementos do Office na Web.
Abra as ferramentas de programador do browser. Normalmente, isto é feito ao premir F12. Abra a ferramenta de depurador e utilize-a para definir pontos de interrupção e ver variáveis. Para obter ajuda detalhada na utilização da ferramenta do browser, consulte uma das seguintes opções:
- Firefox
- Safari
- Depurar suplementos usando ferramentas de desenvolvedor no Microsoft Edge (baseado em Chromium)
- Depurar suplementos usando ferramentas de desenvolvedor para Edge Legacy
Observação
- O Office na Web não abre no Internet Explorer.
- O novo cliente de ambiente de trabalho do Outlook no Windows (pré-visualização) não suporta o menu de contexto ou o atalho de teclado para aceder às ferramentas de programador do Microsoft Edge. Em vez disso, tem de executar
olk.exe --devtoolsa partir de uma linha de comandos. Para obter mais informações, consulte a secção "Depurar o seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows.
Possíveis problemas
Seguem-se alguns problemas que poderá encontrar à medida que depura.
- Alguns erros de JavaScript que você vê podem vir do Office na Web.
- O browser pode mostrar um erro de certificado inválido que terá de ignorar. O processo para fazer isso varia com o navegador e as interfaces de usuário dos vários navegadores para fazer essa alteração periodicamente. Você deve pesquisar na ajuda do navegador ou pesquisar online para obter instruções. (Por exemplo, procure por "Aviso de certificado inválido do Microsoft Edge".) A maioria dos navegadores terá um link na página de aviso que permite que você clique na página do suplemento. Por exemplo, o Microsoft Edge tem uma ligação "Aceder à página Web (Não recomendado)". No entanto, normalmente terá de percorrer esta ligação sempre que o suplemento for recarregar. Para um bypass mais duradouro, consulte a ajuda, como sugerido.
- Se definir pontos de interrupção no seu código, o Office na Web poderá gerar um erro a indicar que não consegue guardar.