Os desenvolvedores do SharePoint frequentemente encontram bugs e erros ao criar soluções personalizadas, aplicativos ou componentes para o SharePoint. Para solucionar e resolver esses problemas de forma eficaz, é importante ser capaz de rastrear, registrar e depurar o código. No entanto, o SharePoint oculta mensagens de erro detalhadas e informações de depuração/rastreamento por padrão. Neste artigo, discutiremos como habilitar informações de depuração e rastreamento sobre bugs e exceções em aplicativos do SharePoint usando o SQL Server.

Habilitando informações de depuração e rastreamento no SharePoint 2007

No SharePoint 2007, existem várias abordagens para habilitar a depuração e o rastreamento:

1. Depuração com VSEWSS (Visual Studio Extensions For Windows SharePoint Services)

Para habilitar a depuração com VSEWSS, siga estas etapas:

1. Localize e abra o arquivo “Web.Config” do aplicativo do SharePoint de destino. Este arquivo geralmente está localizado em: “C:\Inetpub\wwwroot\wss\VirtualDirectories\“.
2. Procure a seguinte linha de código e altere o atributo “debug” para “true”:

<compilation batch="false" debug="false">

para

<compilation batch="false" debug="true">

3. Procure a seguinte linha de código e altere o atributo “CallStack” para “true”:

<SafeMode MaxControls="200" CallStack="false" ...>

para

<SafeMode MaxControls="200" CallStack="true" ...>

4. Procure a seguinte linha de código e altere o atributo “mode” para “Off”:

<customErrors mode="On" />

para

<customErrors mode="Off" />

5. No Visual Studio, clique com o botão direito no Projeto do SharePoint e clique em “Propriedades”.
6. Clique na guia “Depurar” e digite a URL do SharePoint de destino na caixa ‘iniciar navegador com URL’.
7. Coloque um ponto de interrupção clicando na linha de código ou pressionando F9 na linha de código selecionada.
8. Pressione “F5” para iniciar a depuração.

2. Depuração Manual (w3wp.exe Anexar ao Processo)

Para depurar aplicativos do SharePoint sem usar o VSEWSS, siga estas etapas:

1. Verifique se o aplicativo do SharePoint está usando o código-fonte compilado mais recente. Recompile o código-fonte e instale os assemblies no GAC (Global Assembly Cache), geralmente localizado em: “C:\Windows\assembly”. Alternativamente, copie os assemblies para a pasta bin do diretório virtual do SharePoint, geralmente localizado em: “C:\Intepub\wwwroot\wss\VirtualDirectories\\bin”.
2. Execute o utilitário de linha de comando do Microsoft Internet Information Services (IIS) “iisreset.exe” abrindo um prompt de comando e digitando “iisreset”.
3. Coloque um ponto de interrupção no código que você deseja depurar.
4. Clique no menu “Depurar” e depois em “Anexar ao Processo”.
5. Na lista de processos disponíveis, encontre o processo W3wp.exe. Se não estiver listado, verifique se as caixas de seleção “Mostrar processos de todos os usuários” e “Mostrar processos em todas as sessões” estão selecionadas. Se ainda não estiver listado, abra um navegador da web e acesse o site do SharePoint, em seguida, retorne ao Visual Studio e clique no botão de atualização para localizar o processo W3wp.exe.
6. Clique no botão “Anexar”.

3. Depuração Remota (W3wp.exe Anexar Remotamente ao Processo)

Para depurar um aplicativo do SharePoint em execução em um computador remoto, siga estas etapas:

1. Repita as etapas 1-4 da seção “Depuração Manual”.
2. Verifique se o depurador remoto do Visual Studio está instalado no computador remoto e inicie o monitor do depurador remoto.
3. Abra o Visual Studio no computador local e abra a solução.
4. Defina os pontos de interrupção.
5. Clique no menu “Depurar” e depois em “Anexar ao Processo”.
6. No campo de texto “Qualifier”, digite o nome do computador remoto e clique em “Atualizar”.
7. Na lista de Processos Disponíveis, encontre o processo W3wp.exe e repita a etapa 4 da seção “Depuração Manual”.

Ao seguir essas etapas, os desenvolvedores do SharePoint podem rastrear, registrar e depurar efetivamente seu código, permitindo que eles identifiquem e resolvam rapidamente bugs e erros em suas soluções personalizadas, aplicativos ou componentes para o SharePoint.