Demonstra Passo a passo: Criar um campo personalizado, o tipo de conteúdo, a definição de lista e a instância de lista

Artigo
08/08/2011

O procedimento a seguir ilustra como criar um campo personalizado no SharePoint, chamado de nome do paciente, bem como um tipo de conteúdo que usa o campo. Ele também demonstra como adicionar uma definição de lista para o projeto, juntamente com uma instância de lista com base na definição de lista, que usa o novo tipo de conteúdo e o campo.

Essa explicação passo a passo demonstra as seguintes tarefas:

Criando e personalizando um campo.
Criando e personalizando um tipo de conteúdo que usa o campo.
Criando e personalizando uma definição de lista.
Criando e personalizando uma instância de lista de definição de lista.
Exibindo o novo campo na instância de lista e o tipo de conteúdo.

Observação
Seu computador pode mostrar nomes ou locais diferentes para alguns dos elementos da interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, consulte Configurações do Visual Studio.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

Edições com suporte do Microsoft Windows e do SharePoint. Para obter mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.
Visual Studio 2010.

Criando um Item de campo personalizado

Primeiro, crie um item de campo personalizado como um projeto do SharePoint na Visual Studio chamado Nome do paciente.

Para criar um item de campo personalizado

Exibir o Novo projeto caixa de diálogo, apontando para novo na arquivo menu e, em seguida, clicando em Novo projeto.
Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.
Clique em Projeto vazio do SharePoint na modelos de painel, altere o nome do projeto para CustomField1 e clique em OK.

O O Assistente para personalização do SharePoint aparece. O modelo de projeto vazio é usado para itens de campo personalizado porque não há nenhum modelo para eles.
Sobre o especificar o site e o nível de segurança de depuração de página, digite a URL do site do SharePoint server ao qual você deseja adicionar o novo item de campo personalizado ou usar o local padrão (http://<system name>/).
No o que é o nível de confiança para essa solução do SharePoint? seção, use o valor padrão Deploy como uma solução em modo seguro.

Para obter mais informações sobre o modo seguro e soluções de farm, consulte Considerações sobre a solução no modo seguro.
Clique em Finish. Você deverá ver o projeto em Solution Explorer.
Adicione um item de projeto de elemento vazio para o projeto. Para fazer isso, clique no nó do projeto do campo (CustomField1) no Solution Explorer e clique Add New Item sobre o projeto menu.
Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.
No modelos de painel, selecione Elemento vazio, mantenha o nome padrão EmptyElement1 e, em seguida, clique em Add.

No arquivo elements em EmptyElement1, adicione o seguinte após o <Elements> marca:

<Field ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Type="Note" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Group="A Custom Group">
</Field>

Isso adiciona um campo chamado Nome do paciente.

Importante
Ao adicionar um campo personalizado, você deve especificar os atributos ID, tipo, nome, DisplayName e grupo do campo apareçam corretamente no SharePoint. Conclusão da instrução erroneamente indica que você precisa apenas as três primeiras desses atributos, quando na verdade, todos os cinco são necessários.

Pressione F5 para executar e implantar o projeto no SharePoint.

Se você receber uma mensagem de depuração de script está desativado, clique em Sim para continuar a depuração.
Se esta for a primeira vez que você tem depurado um aplicativo da Web em Visual Studio, você será solicitado se deseja modificar o arquivo de configuração da Web para ativar a depuração. Resposta Sim.
Na parte superior da página da Web do SharePoint, clique no Ações do Site botão e, em seguida, clique em Configurações do Site.
Sob o galerias seção a Configurações do Site página, clique no colunas de Site link.
No Galeria de coluna do Site de página, role a página para baixo até o Colunas personalizadas título e observe o campo novo item adicionado, Nome do paciente.
Feche o navegador.

Criando um tipo de conteúdo personalizado

Em seguida, crie um tipo de conteúdo, com base na lista de contatos do SharePoint, que usa o novo campo criado no procedimento anterior.

Para criar um tipo de conteúdo personalizado

Adicione um tipo de conteúdo ao projeto. Para fazer isso, clique no nó do projeto em Solution Explorer e, em seguida, clique em Add New Item sobre o projeto menu.
Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.
No modelos de painel, selecione Tipo de conteúdo e use o nome padrão, ContentType1.
No O Assistente para personalização do SharePoint, selecione contato como o tipo de conteúdo no qual basear o novo e, em seguida, clique em Concluir.

Isso abre o arquivo de elements do tipo de conteúdo para edição.
No <FieldRefs> seção elements, copiar e colar em:
```
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE"/>
```
A identificação de FieldRef usado aqui refere-se a identificação de campo que criamos para o campo personalizado.
Pressione F5 para executar e implantar o projeto.
Na parte superior da página da Web do SharePoint, clique no Ações do Site botão e, em seguida, clique em Configurações do Site.
Sob o galerias seção a Configurações do Site página, clique no tipos de conteúdo do Site link.
No Galeria de tipos de conteúdo do Site de página, observe o novo tipo de conteúdo que acabamos de criar, CustomField1 - ContentType1. Clique para exibir seus campos. Na lista de campos para CustomField1 - ContentType1, observe o campo Nome do paciente é adicionado.
Feche o navegador.

Criando uma definição de lista e uma instância de lista

Agora, crie uma definição de lista e a instância de lista que usará o novo tipo de conteúdo e o campo. Como queremos criar a definição de lista com base no tipo de conteúdo que acabou de criar, usaremos o modelo de item de projeto de definição de tipo de conteúdo da lista.

Para criar uma definição de lista e uma instância de lista

Adicione uma definição de lista para o projeto. Para fazer isso, clique no nó do projeto em Solution Explorer e, em seguida, clique em Add New Item sobre o projeto menu.
Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.
No modelos de painel, selecione Lista definição de tipo de conteúdo e use o nome padrão, ListDefinition1.
No o que é o nome de exibição da definição da lista? caixa, deixe o valor padrão, CustomField1 - ListDefinition1.
No o tipo de conteúdo você gostaria de usar para a definição de lista? lista, use o padrão (e somente) valor, CustomField1 - ContentType1.

Isso cria uma definição de lista personalizável baseada na lista de contatos nova e modificada.
Selecione o Adicionar uma instância de lista para a definição de lista caixa para adicionar um item de projeto de instância de lista para o projeto. A instância de lista será uma instância da nova definição de lista.
Clique em Finish. Você deverá ver a definição de lista em Solution Explorer.

Personalizando a definição de lista

Finalmente, personalizar a definição de lista, adicionando um novo campo, Nome do paciente.

Importante
O valor do Name atributo elements da definição de lista deve coincidir com o nome da pasta do item de projeto da definição da lista ou ocorrerá um erro quando o projeto é executar. Para certificar-se de que o Name atributo corresponde ao nome da pasta, o parâmetro de substituição (ou token) $ProjectItemName$ é usado. Quando o projeto do SharePoint é empacotado e implantado, esse token é convertido para o nome de pasta real de definição de lista. Se você alterar o valor de Name de atributo para algo diferente, por exemplo, esse símbolo, e em seguida, seu aplicativo pode não funcionar corretamente. Para obter mais informações, consulte Parâmetros substituíveis.

O valor do Name atributo elements da definição de lista deve coincidir com o nome da pasta do item de projeto da definição da lista ou ocorrerá um erro quando o projeto é executar. Para certificar-se de que o Name atributo corresponde ao nome da pasta, o parâmetro de substituição (ou token) $ProjectItemName$ é usado. Quando o projeto do SharePoint é empacotado e implantado, esse token é convertido para o nome de pasta real de definição de lista. Se você alterar o valor de Name de atributo para algo diferente, por exemplo, esse símbolo, e em seguida, seu aplicativo pode não funcionar corretamente. Para obter mais informações, consulte Parâmetros substituíveis.

Para adicionar um campo para a definição de lista

No Solution Explorer, clique duas vezes em Schema. XML em ListDefinition1 para exibi-lo.

Schema. xml define todos os campos e outros elementos da definição de lista, como, por exemplo, nome e endereço. Observe sob o <Fields> o elemento na parte superior do arquivo que a seguinte definição de campo foi adicionado pelo tipo de conteúdo:
```
<FieldRef ID="{5744d18c-305e-4632-8bd1-09d134f4830d}" 
    Name="PatientName" 
    DisplayName="Patient Name" 
    Required="TRUE" />
```
Pressione F5 para executar e implantar o projeto.
Sob o lista seção na barra Inicialização rápida do SharePoint, clique na CustomField1 - ListInstance1 link.

Esta é a instância de lista para a nova definição de lista. Observe que a nova Nome do paciente campo ainda não aparecer como uma coluna na instância de lista.
Clique em lista na Lista ferramentas menu na parte superior da página e na guia o Modificar o modo de exibição botão na barra de faixa de opções.
Na lista de nomes de coluna disponíveis, selecione Nome do paciente e, em seguida, clique em OK. Observe que o Nome do paciente campo aparecerá agora na instância de lista.