CS21002 – Criando um tipo de Custom Field no WSS 3.0 | Thiago Silva - Especialista SharePoint
Home > Artigo, SharePoint Technologies	> CS21002 – Criando um tipo de Custom Field no WSS 3.0
CS21002 – Criando um tipo de Custom Field no WSS 3.0
August 16, 2009 Thiago Silva	Leave a comment Go to comments
Quando armazenando informações de negócios no SharePoint, você certamente vai encontrar cenários nos quais informações de negócios importantes não são conformes ao tipo de campo incluído no SharePoint, ou situações nas quais você precisa customizar os tipos de campos. O SharePoint oferece a capacidade para você criar tipos de campos customizados, baseado num set de tipos de campos robusto que ele oferece. Estes campos customizados podem incluir validação de dados customizados, renderização de campo customizado, renderização e processamento de propriedades de campo cusmotizado.
Microsoft Visual Studio 2008 Extensions for Windows SharePoint Services 3.0 dá novo suporte na criação de tipos de campos customizados para SharePoint. Este artigo mostra o que você precisa para construir um tipo de campo customizado para WSS usando Visual Studio Extensions for WSS. O tipo de campo criado aqui fornece a capacidade de escolher imagens dentro de uma caixa de lista.
· Visual Studio 2008 with Extensions for Windows SharePoint Services (http://www.microsoft.com/downloads/details.aspx?familyid=7BF65B28-06E2-4E87-9BAD-086E32185E68&displaylang=en).
Para mostrar como criar um tipo de campo customizado, este artigo passa por quatro passos-chave:
1. Criando um novo projeto de aplicação para Windows SharePoint Services vazio no Visual Studio 2008;
2. Adicionando um SharePoint filed control ao projeto;
3. Adicionando uma funcionalidade ao field control;
4. Construindo e implantando o tipo de campo customizado no site SharePoint.
Então, vamos por a mão na massa!
1. Criando um SharePoint application vazio no Visual Studio 2008
1.1. Inicie o Visual Studio, depois clique no menu File, clique em New, e então clique em Project;
1.2. No painel Project Types do novo projeto, selecione e expanda Visual C#, e selecione a categoria SharePoint;
1.3. No painel Templates, clique Empty. Especifique o nome e a localização do projeto, e então clique em Ok. O Visual Studio criará uma solução que contém um projeto vazio;
2. Adicionando um Field Control ao projeto
2.1. No Visual Studio Solution Explorer, clique com o botão direito no projeto vazio criado nos passos anteriores, clique Add, e então clique em New Item;
2.2. No painel Categories na caixa de diálogo, expanda o nó Visual C# Project Itens, e selecione a categoria SharePoint;
2.3. No painel Templates, clique em Field Control. Especifique LogoField para o nome do Field Control, e cliquem em Add;
3. Adicionando funcionalidade ao Field Control
Visual Studio adiciona dois arquivos de código Microsoft Visual C# ao projeto: LogoField.FieldControl.cs e LogoField.Field.cs. O arquivo LogoField.Field.cs contém o código que define a classe que, por padrão, é derivada da classe SPFieldText e que sobrepõe a propriedade FieldRenderingControl. A implamentação gerada deste projeto retorna uma instância da classe LogoFieldFieldControl field control que é definida em LogoField.FieldControl.cs. A classe LogoFieldFieldControl implementa o suporte a renderização, validação, e processamento fornecido pelo field control.
3.1. No Visual Studio Solution Explorer, abra o arquivo LogoField.FieldControl.cs;
3.2. Adicione os seguintes using stataments ao topo do arquivo, logo após aos using statements gerados pelo Visual Studio:
3.3. Adicione o seguinte código dentro da definição da classe LogoFieldFieldControl:
// Cria um listbox seletor de imagens
// Pega a lista de imagens de logo na picture library
// e adiciona-as ao listbox
// Pega o valor atual do campo
// Adiciona script que atualiza a visualização da imagen quando um novo
// item é selecionado na listbox
3.4. Salve as mudanças no arquivo LogoField.FieldControl.cs.
O código acima assume que haja uma picture library no site de nível superior da coleção de sites chamada Logos que contenha arquivos de imagem. Para que o field control busque e mostre a lista de imagens, esta biblioteca deve existir e conter imagens.
4. Construindo e implantando o tipo de conteúdo customizado
4.1. No menu Build do Visual Studio, clique em Deploy Solution.
4.2. Abra o prompt de comando, e execute o comando iisreset.
Você pode agora testar o novo tipo de campo no WSS associando o tipo de campo a uma lista. Para isso vamos adicionar uma coluna a uma lista existente que utilize este campo criado. Para informações adicionais de como associar um tipo de campo com uma lista, veja Adicionando uma coluna em uma lista.
Nesse artigo nós mostramos como construir um tipo de campo customizado no Windows SharePoint Services 3.0 usando o Microsoft Visual Studio 2008 with Extensions for Windows SharePoint Services 3.0. os passos-chave inclusos são:
1. Criando um novo projeto de aplicação para Windows SharePoint Services vazio no Vistual Studio 2008;
Categories: Artigo, SharePoint Technologies Tags: Custom Field, MOSS 2007
Tweets that mention CS21002 – Criando um tipo de Custom Field no WSS 3.0 « Thiago Silva -- Topsy.com