Customizando um SharePoint Web Site com Visual Studio .NET

Com o lançamento do Microsoft Office SharePoint™ Portal Server 2003 e Microsoft Windows® SharePoint Services houve a necessidade de estar customizando os Sharepoint Web Sites.
Com isso a Microsoft® trouxe o Microsoft® Visual. Studio® .NET para realizar esta tarefa.
Neste artigo iremos aprender como customizá-los.

por Maycol Sneider Romelli

Com o lançamento do Microsoft Office SharePoint™ Portal Server 2003 e Microsoft Windows® SharePoint Services houve a necessidade de estar customizando os Sharepoint Web Sites. Com isso a Microsoft® trouxe o Microsoft® Visual. Studio® .NET para realizar esta tarefa. Neste artigo iremos aprender como customizá-los.

IDE do Visual Studio .NET

O Microsoft® Visual. Studio® .NET tem uma IDE que oferece um ambiente propício para personalização e customização de um site baseado em Microsoft Windows® SharePoint™ Services. Você precisa dar certos passos para usar este ambiente para personalizar um SharePoint Web Site. Isto inclui usar um caminho específico para criar uma aplicação Web, adicionar uma referência Microsoft.SharePoint.dll, e poder incluir o tipo Multipurpose Internet Mail Extensions (MIME) no Internet Information Services (IIS).

Adicionando um novo tipo MIME

Uma vez que a versão 6 do IIS bloqueia os request para arquivos .tmp, se você estiver usando o Visual Studio .NET Versão 7 você precisa definir um tipo MIME no IIS antes de você poder criar uma Custom Web Aplication no SharePoint Web Site pela IDE do Visual Studio .NET 7.Para definir o tipo MIME, execute os seguintes passos:

1. Clique no menu Start, Administrative Tools, Internet Information Services (IIS).
2. No painel a esquerda do Microsoft Management Console, expanda a árvore do console.
3. Clique com o botão direito em Web Sites e clique em Properties no atalho que aparece.
4. Dentro do box Web Sites Properties, selecione a tab HTTP Headers, e clique em MIME Types.
5. Dentro do box MIME Types, clique em New.
6. Dentro do box MIME Type, dentro do text box Extension tipo .tmp, e dentro do text box MIME type tipo common/type.
7. Clique OK dentro da caixa de diálogo até que você encerre o Web Sites Properties.

Criando uma Aplicação Web

Criando uma Web Application no Visual Studio .NET de um computador remoto envolve um passo extra no procedimento para criar uma Web Application no Visual Studio .NET quando é instalado no servidor que é Windows SharePoint Services. Para criar uma custom Web Application dentro do contexto de distribuição no SharePoint, execute os seguintes passos:

1. Dentro do menu File, clique em New e clique em Project.

2. Dentro do box New Project, selecione Visual Basic Projects ou Visual C# Projects dentro do box Project Types, dependendo de qual linguagem você preferir.

3. Dentro do box Templates, selecione ASP.NET Web Application.

4. Dento do box Location o path é o seguinte:
   
   http://Server_Name/_layouts/Web_Application_Name

5. Este caminho inclui o nome de seu servidor, o diretório de layouts (_layouts), e o nome de sua custom Web Aplication. Criando a custom application dentro do diretório _layouts o seu projeto é acessível por todos os sites locais no servidor.
   
   Nota: Para criar uma Web application na porta administrativa de distribuição, digite o seguinte: http://Server_Name:Administrative_Port_#/Web_Application_Name

6. Clique OK.
   Neste momento, se você está trabalhando de um computador remoto, e um box aparece mostrando Web Access Failed, o caminho do arquivo não corresponde à URL que você especificou dentro do box New Project. Execute os passos seguintes:

7. Debaixo de What would you like to do?, use o Retry novamente usando um caminho de arquivo diferente, selecione seguindo o tipo do caminho dentro do box Location.
   
   \\Server_Name\Local_Drive$\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\TEMPLATE\LAYOUTS\Web_Application_Name
   
   Nota: Digite o seguinte path para criar uma aplicação dentro da porta administrativa: \\Server_Name:Administrative_Port_#\Local_Drive$\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\TEMPLATE\ADMIN\1033\Web_Application_Name

8. Clique OK.

Setando uma referência ao assembly do Windows SharePoint Services

Depois de criar um projeto novo, acrescente uma referência ao assembly do Windows SharePoint Services para implementar características de Intellisense dentro do Objetct Browser e do Editor de Código. O processo para setar a referência varia dependendo se você está usando o Visual Studio .NET em um computador remoto ou no servidor Windows SharePoint Services.Para acrescentar a referência ao assembly, execute os passos seguintes:

• Dentro de Solution Explorer, clique com o botão direito em References e clique em Add Reference.

  Se você está usando Visual Studio .NET no servidor, execute os seguintes passos:

• Dentro da tab .NET no box Add Reference, selecione Windows SharePoint Services dentro da lista de componentes, clique em Select, e clique em OK.

  Se você está usando Visual Studio .NET em um computador remoto, execute os seguintes passos:

• Clique em Browse, e dentro do box Select Component, navegue para a pasta Local_Drive\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\ISAPI do servidor Windows SharePoint Services. Você pode preferir ao invés de copiar primeiro a Microsoft.SharePoint.dll desta pasta para o drive local no computador remoto e então abrir a cópia local da DLL dentro da caixa de diálogo do Select Component.

• Selecione Microsoft.SharePoint.dll e clique em Open.

• Dentro do box Add Reference, clique em OK.

  Intellisense

  Dentro da IDE do Visual Studio .NET são providas características de Intellisense uma vez para os namespaces no assembly do Windows SharePoint Services e uma referência setada no assembly.O arquivo que provê a informação usada pelo Intellisense para o Windows SharePoint Services é o Microsoft.SharePoint.xml que é instalado na pasta Local_Drive:\\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\ISAPI em cada front-end Web Server na distribuição.Para atualizações deste arquivo, confira o Microsoft SharePoint Products and Technologies Developer Center.

  Conclusão

  Neste artigo, nós vimos como é fácil customizar um Sharepoint Web Site com Visual Studio .NET passo a passo.

  Até o próximo artigo...