Thaila´s Blog: outubro 2010

Custom field nada mais é que um campo customizado para ser adicionado nas listas do sharepoint.

Por exemplo, eu tenho o campo “Pessoas ou grupos” no sharepoint, porém, por padrão, ele não tem uma opção para trazer automaticamente o usuário logado preenchido nesse campo, ao carregar “novo item” . Pesquisando sobre isso achei algumas soluções com java script e outras utilizando o custom field. Na minha opinião as soluções com custom field são melhores, uma vez que vc pode criar um campo específico para o que deseja. Já nas soluções com java script você precisa editar a webpart newform.aspx depois de inserida. Bom não vou entrar em detalhes sobre a solução com java script, a idéia aqui é falar um pouco da solução com o custom field.

Como criar um Custom Field

Inicialmente precisamos criar um XML , esse XML é o responsável por garantir que esse novo tipo de campo aparecerá para o usuário quando for criar uma nova coluna.

Exemplo de xml:

<?xml version="1.0" encoding="utf-8" ?>

<Field Name="TypeName">CurrentUserField</Field>

<Field Name="TypeDisplayName">Current User</Field>

<Field Name="TypeShortDescription">Person or Group (Current user is default)</Field>

<Field Name="FieldTypeClass"> Test.Portal.TEMPLATE.CONTROLTEMPLATES.CurrentUserField.CurrentUserField, Test.Portal, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e4f816fa35933333</Field>

<Field Name="FieldEditorUserControl">/_controltemplates/UserFieldEditor.ascx</Field>

</PropertySchema>

</FieldType>

</FieldTypes>

Explicando um pouco sobre as Tags acima:

· TypeName: Nome do tipo;

· ParentType: Todo custom field criado é baseado em um campo já esxistente;

· TypeDisplayName: Nome que será mostrado ao usuario quando criar uma coluna nova;

· TypeShortDescription: Descrição que será mostrada ao usuario quando criar uma nova coluna;

· FieldTypeClass: indica a dll e a classe para controle do custom field criado.

· FieldEditorUserControl: indica o ascx de edição para o custom field. Obs.: Nesse caso específico usamos um ascx já existente no sharepoint.

Ainda no XML, podemos adicionar recursos prontos do próprio sharepoint, como por exemplo esse custom field que vamos criar. Não muda nada em relação ao ascx que exibe o campo para editar ou visualizar, então podemos adicionar o código ao xml para indicar as paginas já existentes. Ficando dessa forma o XML:

<?xml version="1.0" encoding="utf-8" ?>

<Field Name="TypeName">CurrentUserField</Field>

<Field Name="TypeDisplayName">Current User</Field>

<Field Name="TypeShortDescription">Person or Group (Current user is default)</Field>

<Field Name="FieldTypeClass">Test.Portal.TEMPLATE.CONTROLTEMPLATES.CurrentUserField.CurrentUserField, Test.Portal, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e4f816fa35933333</Field>

<Field Name="FieldEditorUserControl">/_controltemplates/UserFieldEditor.ascx</Field>

</PropertySchema>

<Expr>

</Expr>

<Expr>

</Expr>

</Case>

<Expr>

</Expr>

<Expr>

</Expr>

<HTML>"$Resources:core,501;</HTML>

</ScriptQuote>

</Case>

</Switch>

</Default>

</Switch>

<Expr>

</Expr>

</Case>

<Expr>

</Expr>

</Case>

<HTML>"$Resources:core,500;</HTML>

<HTML>$Resources:OpenMenuKeyAccessible;</HTML>

<Expr>

</Expr>

<HTML>$Resources:core,150;</HTML>

</Case>

<HTML>$Resources:core,151;</HTML>

</Case>

</Default>

</Switch>

</Default>

</Switch>

</Default>

</Switch>

</Default>

</Switch>

</Default>

<Expr>

</Expr>

</Case>

<Expr>

</Expr>

<Expr>

</Expr>

<HTML>"$Resources:core,501;</HTML>

</ScriptQuote>

</Case>

</Switch>

</Default>

</Switch>

<Expr>

</Expr>

</Case>

<Expr>

</Expr>

</Case>

<HTML>"$Resources:core,500;</HTML>

<HTML>$Resources:OpenMenuKeyAccessible;</HTML>

<Expr>

</Expr>

<HTML>$Resources:core,150;</HTML>

</Case>

<HTML>$Resources:core,151;</HTML>

</Case>

</Default>

</Switch>

</Default>

</Switch>

</Default>

</Switch>

</Default>

</Switch>

</Case>

</Switch>

</RenderPattern>

<Expr>

</Expr>

<Expr>

</Expr>

<Expr>

</Expr>

</Case>

</FieldSwitch>

</Case>

<Expr>

</Expr>

</Case>

</Default>

</FieldSwitch>

</Default>

</Switch>

</Case>

</Default>

</FieldSwitch>

</RenderPattern>

<HTML><![CDATA[<SCRIPT>fld = new Field(frm,]]></HTML>

</ScriptQuote>

</ScriptQuote>

<Expr>

</Expr>

</Case>

<HTML>$Resources:core,onetfldtypes03;</HTML>

</Default>

</Switch>

</RenderPattern>

<HTML><![CDATA[<SCRIPT>fld = new Field(frm,]]></HTML>

</ScriptQuote>

</ScriptQuote>

<Expr>

</Expr>

</Case>

<HTML>$Resources:core,onetfldtypes03;</HTML>

</Default>

</Switch>

</RenderPattern>

<HTML>"$Resources:core,fldtypes011;</HTML>

</RenderPattern>

<Expr>

</Expr>

</SetVar>

<Expr1>

</Expr1>

<Expr2>

</Expr2>

<Then>

</Then>

</IfEqual>

</ForEach>

<Expr>

</Expr>

<HTML>$Resources:core,fldtypes018;</HTML>

</Case>

</Switch>

</Case>

<Expr>

</Expr>

<HTML>"$Resources:core,fldtypes012;</HTML>

<HTML>$Resources:core,fldtypes018;</HTML>

</Case>

<HTML>"$Resources:core,fldtypes012;</HTML>

</Default>

</Switch>

</Default>

</Switch>

</RenderPattern>

<Expr>

</Expr>

</SetVar>

<Expr1>

</Expr1>

<Expr2>

</Expr2>

<Then>

</Then>

</IfEqual>

</ForEach>

<Expr>

</Expr>

<HTML>$Resources:core,fldtypes018;</HTML>

</Case>

</Switch>

</Case>

<Expr>

</Expr>

<HTML>"$Resources:core,fldtypes012;</HTML>

<HTML>$Resources:core,fldtypes018;</HTML>

</Case>

<HTML>"$Resources:core,fldtypes012;</HTML>

</Default>

</Switch>

</Default>

</Switch>

</RenderPattern>

</FieldType>

</FieldTypes>

Terminado o XML, ainda não definimos como o custom field irá automaticamente mostrar o nome do usuário logado. Vocês devem ter reparado que nesse xml ele cita uma classe. No trecho abaixo:

<Field Name="FieldTypeClass"> Test.Portal.TEMPLATE.CONTROLTEMPLATES.CurrentUserField.CurrentUserField, Test.Portal, Version=1.0.0.0, Culture=neutral, PublicKeyToken=e4f816fa35974913</Field>

O “FieldTypeclass” informa qual a classe do controle. Assim podemos trabalhar as informações do nosso custom field. Como no exemplo abaixo nossa classe irá buscar o usuário logado.

using Microsoft.SharePoint;

namespace Test.Portal.TEMPLATE.CONTROLTEMPLATES.CurrentUserField

{

public class CurrentUserField : SPFieldUser

{

#region Constructors

public CurrentUserField(SPFieldCollection fields, string fieldName)

: base(fields, fieldName)

{

}

public CurrentUserField(SPFieldCollection fields, string typeName, string displayName)

: base(fields, typeName, displayName)

{

}

#endregion

#region SPFieldUser

public override string DefaultValue

{

get

{

using (SPWeb web = SPContext.Current.Web)

{

//Busco o usuário logado.

SPUser user = web.CurrentUser;

//cria a string com o nome do usuário corrente.

string defaultValue = string.Format("{0};#{1}", user.ID.ToString(), user.Name);

//Verifica usuário e permissão

if (this.SelectionGroup > 0)

{

SPGroup group = web.Groups[this.SelectionGroup];

if ((group != null) && (group.ContainsCurrentUser))

{

return defaultValue;

}

else

{

return defaultValue;

}

return string.Empty;

}

set

{

base.DefaultValue = value;

}

#endregion

}

Pronto!!! nosso custom field está finalizado. Agora só fazer o Deploy. Para quem faz o deploy manual seguir os passos abaixo:

1. Copiar o XML para a pasta: “C:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\xml”

2. Copiar as dlls para o GAC.

3. Dar um iisreset.

Agora é só utilizar o custom field.

No próximo post vou ensinar como criar uma lista e utilizar o custom field, tanto direto pelo sharepoint como por uma feature.

Thaila´s Blog

sábado, 30 de outubro de 2010

Sharepoint - Trabalhando com Custom Fields II

sexta-feira, 29 de outubro de 2010

Ilha de boipeba - III

quarta-feira, 27 de outubro de 2010

Ilha de Boipeba - II

segunda-feira, 25 de outubro de 2010

Quebra-Cabeça

Sharepoint - Trabalhando com Custom Fields