Uma ferramenta fundamental na utilização de qualquer aplicação é o mecanismo de logging que a mesma faculta. No caso da plataforma Windows SharePoint Windows Services 3.0, este torna-se especialmente útil para despistar erros em são obtidas mensagens como “Unknown Error” ou “An unexpected error has occured”. O WSS utiliza um mecanismo de logging, designado por
Diagnostics Logging, que guarda por omissão os logs em ficheiro na directoria C:\Program
Files\Common Files\Microsoft Shared\web server extensions\12\LOGS. Este
mecanismo de logging é configurável, sendo possível alterar as
definições no SharePoint Central Administration, através da opção Diagnostic
logging (SharePoint Central Administration, Operations, Logging and Reporting, Diagnostic logging), sendo possível definir, entre outros, quais os eventos a escrever
para log, quer para o Event Log, quer para o Trace Log (log para ficheiro). Para
saberem mais sobre como configurar o Diagnostic Logging, cliquem aqui.
Os utilizadores preferenciais deste mecanismo de logging são todos os serviços de base que correm sobre a plataforma WSS (do próprio WSS e do MOSS, se instalado). No entanto, qualquer
aplicação executada no contexto do SharePoint, seja ela uma aplicação web
composta por um conjunto de páginas .aspx, um workflow ou um event handler pode igualmente utilizar os logs de SharePoint usando a API do WSS. Para tal, encontra-se
disponível na assembly Microsoft.Office.Server.dll, presente na directoria C:\Program
Files\Common Files\Microsoft Shared\web server extensions\12\ISAPI, a classe
PortalLog. Esta classe disponibiliza o método LogString que permite escrever
para os logs de SharePoint. Para utilizar esta classe, basta adicionar a referência
para a assembly Microsoft.Office.Server.dll e incluir a referência ao namespace
Microsoft.Office.Server.Diagnostics. O exemplo seguinte ilustra a utilização do
método atrás referido:
using Microsoft.Office.Server.Diagnostics;
private void Page_Load(object sender, EventArgs e)
{
PortalLog.LogString("Ocorreu um erro!");
}
Uma nota final: a plataforma WSS deixa de escrever para o trace log se o espaço em disco for inferior a 220MB.