Depurar o suplemento do Outlook baseado em eventos ou relatórios de spam

Este artigo aborda as principais fases de depuração para ativar e definir pontos de interrupção no seu código à medida que implementa a ativação baseada em eventos ou relatórios de spam integrados no seu suplemento. Antes de continuar, recomendamos que reveja o guia de resolução de problemas para obter passos adicionais sobre como resolve erros de desenvolvimento.

Para começar a depurar, selecione o separador para o cliente aplicável.

Web

Utilize as ferramentas de programador do seu browser preferencial para depurar o suplemento baseado em eventos no Outlook na Web. Para saber mais, confira Depurar suplementos no Office na Web.

Windows (novo)

Para depurar o seu suplemento no novo cliente de ambiente de trabalho do Outlook no Windows (pré-visualização), tem de executar o seguinte comando para abrir o Microsoft Edge DevTools.

olk.exe --devtools

Para obter mais informações, consulte a secção "Depurar o seu suplemento" de Desenvolver suplementos do Outlook para o novo Outlook no Windows.

Windows (clássico)

Se utilizou o gerador Yeoman para suplementos do Office para criar o seu projeto de suplemento (por exemplo, ao concluir instruções de ativação baseadas em eventos), siga a opção Criado com o gerador Yeoman ao longo deste artigo. Caso contrário, siga os Outros passos. Visual Studio Code deve ser, pelo menos, a versão 1.56.1.

Marcar o suplemento para depuração e definir a porta do depurador

1. Obtenha o ID do suplemento a partir do manifesto.

   • Manifesto apenas de suplemento: utilize o valor do <elemento ID subordinado> do <elemento raiz do OfficeApp> .
   • Manifesto unificado para o Microsoft 365: utilize o valor da propriedade "id" do objeto anónimo { ... } de raiz.

2. Crie um valor de DWORD registo com o nome UseDirectDebugger em HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]. Substitua [Add-in ID] pelo ID do suplemento do manifesto.

   Observação

   Se a Developer chave (pasta) ainda não existir HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\em , conclua os seguintes passos para criá-la.

   1. Clique com o botão direito do rato (ou selecione sem soltar) a chave WEF (pasta) e selecione Nova>Chave.
   2. Nomeie a nova chave como Developer.

   Criado com o gerador Yeoman: numa janela de linha de comandos, navegue para a raiz da pasta do suplemento e, em seguida, execute o seguinte comando.

   npm start
   

   Além de criar o código e iniciar o servidor local, este comando define os UseDirectDebugger dados de valor DWORD do registo para este suplemento para 1.

   Outro: no valor DWORD do registo, onde [Add-in ID] está o HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Developer\[Add-in ID]\UseDirectDebugger ID do suplemento do manifesto, defina os dados do valor como 1.

3. Na chave HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]de registo , onde [Add-in ID] está o ID do suplemento do manifesto, crie um novo DWORD valor com a seguinte configuração.

   • Nome do valor: DebuggerPort
   • Dados de valor (hexadecimal): 00002407

   Esta ação define a porta de depurador como 9223.

4. Inicie o Outlook ou reinicie-o se já estiver aberto.

5. Execute a ação para iniciar o evento para o qual está a desenvolver, como criar uma nova mensagem para iniciar o OnNewMessageCompose evento ou comunicar mensagens de spam. A caixa de diálogo Depurar processador baseado em Eventos deve ser apresentada. Ainda não interaja com a caixa de diálogo.

   

Configurar Visual Studio Code

Criado com o gerador Yeoman

1. Novamente na janela da linha de comandos, execute o seguinte para abrir o projeto de suplemento no Visual Studio Code.

   code .
   

2. No Visual Studio Code, abra o ficheiro ./.vscode/launch.json e adicione o seguinte excerto à sua lista de configurações. Salve suas alterações.

   {
     "name": "Direct Debugging",
     "type": "node",
     "request": "attach",
     "port": 9223,
     "timeout": 600000,
     "trace": true
   }
   

Outros

1. Crie uma nova pasta denominada Depuração (talvez na pasta Ambiente de Trabalho ).

2. Abra o Visual Studio Code.

3. Aceda aAbrir Pasta de Ficheiros>, navegue para a pasta que acabou de criar e, em seguida, selecione Selecionar Pasta.

4. Na Barra de Atividade, selecione Executar e Depurar (Ctrl+Shift+D).

   

5. Selecione a ligação criar um ficheiro launch.json .

   

6. Na lista pendente Selecionar Ambiente , selecione Edge: Iniciar para criar um ficheiro launch.json.

7. Adicione o seguinte excerto à sua lista de configurações. Salve suas alterações.

   {
     "name": "Direct Debugging",
     "type": "node",
     "request": "attach",
     "port": 9223,
     "timeout": 600000,
     "trace": true
   }
   

Anexar o depurador

O ficheirobundle.js de um suplemento contém o código JavaScript do seu suplemento. É criado quando o Outlook clássico no Windows é aberto. Quando o Outlook é iniciado, o ficheiro bundle.js de cada suplemento instalado é colocado em cache na pasta Wef do seu computador.

1. Para localizar o ficheiro bundle.js do suplemento, navegue para a seguinte pasta no Explorador de Arquivos. Substitua o texto incluído nas [] suas informações aplicáveis do Outlook e do suplemento.

   %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\{[Outlook profile GUID]}\[Outlook mail account encoding]\Javascript\[Add-in ID]_[Add-in Version]_[locale]
   

   Dica

   Se o ficheiro bundle.js não for apresentado na pasta Wef , experimente o seguinte:

   • Se o seu suplemento estiver instalado ou sideloaded, reinicie o Outlook.
   • Remova o suplemento do Outlook e, em seguida, carregue-o novamente.

2. Abra bundle.js no Visual Studio Code.

3. Coloque pontos de interrupção no bundle.js onde pretende que o depurador pare.

4. Na lista pendente DEPURAÇÃO , selecione Depuração Direta e, em seguida, selecione o ícone Iniciar Depuração .

   

Executar o depurador

1. Depois de confirmar que o depurador está anexado, regresse ao Outlook e, na caixa de diálogo Depurar processador baseado em Eventos , selecione OK .

2. Agora, pode aceder aos pontos de interrupção no Visual Studio Code, permitindo-lhe depurar a ativação baseada em eventos ou o código de relatório de spam.

Parar o depurador

Para parar de depurar o resto da sessão atual do Outlook no Windows, na caixa de diálogo Depurar processador baseado em Eventos , selecione Cancelar. Para reativar a depuração, reinicie o Outlook.

Para impedir que a caixa de diálogo Depurar processador baseado em Eventos apareça e pare a depuração para sessões subsequentes do Outlook, elimine a chave de registo associada ou HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Wef\Developer\[Add-in ID]\UseDirectDebuggerdefina o respetivo valor como 0.

Parar o servidor local

Quando quiser parar o servidor Web local e desinstalar o suplemento, siga as instruções aplicáveis:

• Para parar o servidor, execute o seguinte comando. Se tiver utilizado npm start, o seguinte comando também deve desinstalar o suplemento.

  npm stop
  

• Se tiver carregado manualmente o suplemento em sideload, consulte Remover um suplemento sideloaded.

Mac

Os suplementos baseados em eventos que são executados no Outlook no Mac utilizam o runtime do browser. Por este motivo, pode depurar o suplemento com o Inspetor Web do Safari.

1. Para utilizar o Inspetor Web do Safari no Outlook, siga os passos em Depurar com o Inspetor Web do Safari num Mac.
2. Abra o Outlook e, em seguida, faça sideload do seu suplemento.
3. Execute uma ação que iniciará o evento que o suplemento processa. Por exemplo, crie uma nova mensagem para iniciar o OnNewMessageCompose evento. Esta ação abre uma Janela de Programador vazia. O nome do suplemento é apresentado na barra de título da janela.
4. Clique com o botão direito do rato (ou selecione sem soltar) em qualquer parte da Janela do Programador e, em seguida, selecione Inspecionar Elemento. Esta ação abre o Inspetor, onde pode definir pontos de interrupção e depurar o suplemento.

Confira também

• Configurar o suplemento do Outlook para ativação baseada em eventos
• Implementar um suplemento integrado de relatórios de spam
• Resolver problemas de suplementos baseados em eventos e relatórios de spam
• Depurar seu suplemento com o log do tempo de execução