Share via

Instruções passo a passo: criar uma coluna de site, tipo de conteúdo e lista do SharePoint

  • Artigo

Os procedimentos a seguir demonstram como criar colunas, ou campos, personalizadas de site do SharePoint, bem como um tipo de conteúdo que usa as colunas de site. Ele também mostra como criar uma lista que usa o novo tipo de conteúdo.

Esta explicação passo a passo inclui as seguintes tarefas:

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

  • Edições com suporte do Windows e do SharePoint.

  • Visual Studio 2019

Criar colunas de site personalizadas

Este exemplo cria uma lista para gerenciar pacientes em um hospital. Primeiro, você deve criar um projeto do SharePoint no Visual Studio e adicionar colunas de site a ele, da seguinte maneira.

Para criar o projeto

  1. No menu Arquivo do Visual Studio, escolha Novo>Projeto.

  2. Na caixa de diálogo Criar um Novo Projeto, selecione o Projeto Vazio do SharePoint para a versão específica do SharePoint instalada. Por exemplo, se você tiver o SharePoint 2016 instalado, selecione o modelo SharePoint 2016 – Projeto Vazio.

    Observação

    Você também pode pesquisar modelos digitando SharePoint na caixa de texto Pesquisar na parte superior da caixa de diálogo Criar um Projeto. Você também pode filtrar a lista de modelos para mostrar apenas os modelos do Office e do SharePoint selecionando "Office" na caixa suspensa Tipo de projeto. Para obter mais informações, confira Criar um projeto no Visual Studio.

  3. Altere o nome do projeto para Clínica e pressione o botão Criar.

  4. Na caixa de diálogo Especificar o site e o nível de segurança para depuração, insira a URL do site local do SharePoint ao qual você deseja adicionar o novo item de campo personalizado ou use o local padrão (http://<SystemName>/)).

  5. Na seção Qual é o nível de confiança dessa solução do SharePoint? use o valor padrão Implantar como uma solução em área restrita.

    Para saber mais sobre soluções de área restrita e de farm, confira Considerações sobre soluções em área restrita.

  6. Escolha o botão Concluir. Agora, o projeto está listado em Gerenciador de Soluções.

Para adicionar colunas de site

  1. Adicione uma nova coluna de site. Para fazer isso, em Gerenciador de Soluções, clique com o botão direito no projeto Clínica e escolha Adicionar>Novo Item.

  2. Na caixa de diálogo Adicionar Novo Item, escolha Coluna do Site, altere o nome para PatientName e, em seguida, escolha o botão Adicionar.

  3. No arquivo Elements.xml da coluna do site, deixe a configuração Tipo como Texto, altere a configuração Grupo para Colunas de Site da Clínica. Quando concluído, o arquivo Elements.xml da coluna de site deverá ser semelhante ao exemplo a seguir.

    <Field
     ID="{f9ba60d1-5631-41fb-b016-a38cf48eef63}"
     Name="PatientName"
     DisplayName="Patient Name"
     Type="Text"
     Required="FALSE"
     Group="Clinic Site Columns">
</Field>

    Dica

    O Visual Studio adicionará automaticamente um espaço no DisplayName para você se você usar maiúsculas e minúsculas no nome da Coluna de Site. Recomendamos não usar espaços no nome da Coluna do Site, pois isso pode causar problemas ao tentar implantar a solução no SharePoint.

  4. Usando o mesmo procedimento, adicione mais duas colunas de site ao projeto: PatientID (Type = "Integer") e DoctorName (Type = "Text"). Defina o valor do Grupo como Colunas de Site da Clínica.

Criar um tipo de conteúdo personalizado

Em seguida, crie um tipo de conteúdo, com base no tipo de conteúdo Contatos, que inclua as colunas de site que você criou no procedimento anterior. Ao basear um tipo de conteúdo em um tipo de conteúdo existente, você pode poupar tempo, pois o tipo de conteúdo base fornece várias colunas de site para uso no novo tipo de conteúdo.

Para criar um tipo de conteúdo personalizado

  1. Adicione um tipo de conteúdo ao projeto. Para fazer isso, em Gerenciador de Soluções, escolha o nó do projeto

  2. Na barra de menus, escolha Projeto>Adicionar Novo Item.

  3. No Visual C# ou no Visual Basic, expanda o nó do SharePoint e, em seguida, o nó 2010.

  4. No painel Modelos, escolha o modelo Tipo de Conteúdo, altere o nome para Informações do Paciente e escolha o botão Adicionar.

    O Assistente de Personalização do SharePoint é aberto.

  5. Na lista Qual tipo de conteúdo base esse tipo de conteúdo deve herdar, escolha Contato como o tipo de conteúdo no qual basear o novo tipo de conteúdo e escolha o botão Concluir.

    Isso fornece acesso a outras colunas de site potencialmente úteis no tipo de conteúdo Contato, além das colunas de site que você definiu anteriormente.

  6. Depois que o designer de Tipo de Conteúdo for exibido, na guia Colunas, adicione as três colunas de site que você definiu anteriormente: Nome do Paciente, ID do Paciente e Nome do Médico. Para adicionar essas colunas, escolha a primeira caixa de listagem na lista de colunas de site em Nome de Exibição e escolha cada coluna do site na lista uma de cada vez.

    Dica

    Para escolher as colunas do site mais rapidamente, filtre a lista inserindo as primeiras letras do nome da coluna.

  7. Além das três colunas de site personalizadas, adicione a coluna de site Comentários da lista de colunas de site.

  8. Marque a caixa de seleção Necessário para as colunas de site Nome do Paciente e ID do Paciente para torná-las campos obrigatórios.

  9. Na guia Tipo de Conteúdo, verifique se o nome do tipo de conteúdo é Informações do Paciente e altere a descrição para Cartão de informações do paciente.

  10. Altere o Nome do Grupo para Tipos de Conteúdo da Clínica e deixe as outras configurações com os valores padrão.

  11. Na barra de menus, escolha Arquivo>Salvar Tudo e feche o designer de tipo de conteúdo.

Cria uma lista

Agora, crie uma lista que use o novo tipo de conteúdo e as colunas do site.

Para criar uma lista

  1. Adicione uma lista ao projeto. Para fazer isso, em Gerenciador de Soluções, escolha o nó do projeto.

  2. Na barra de menus, escolha Projeto>Adicionar Novo Item.

  3. Em Visual C# ou Visual Basic, expanda o nó do SharePoint.

  4. No painel Modelos, escolha o modelo Lista, altere o nome para Pacientes e, em seguida, escolha o botão Adicionar.

  5. Deixe a configuração Personalizar lista com base em como Padrão (Lista Personalizada) e pressione o botão Concluir.

  6. No Designer de Lista, escolha o botão Tipos de Conteúdo para exibir a caixa de diálogo Configurações de Tipo de Conteúdo.

  7. Escolha a nova linha, escolha o tipo de conteúdo Informações do Paciente na lista de tipos de conteúdo e escolha o botão OK.

    Isso adiciona todas as colunas de site do tipo de conteúdo Informações do Paciente à lista.

  8. Exclua todas as colunas de site da lista, exceto as seguintes:

    • ID do paciente

    • Nome do paciente

    • Telefone Residencial

    • Email

    • Nome do médico

    • Comentários

  9. Em Nome de Exibição da Coluna, escolha uma linha vazia, adicione uma coluna de lista personalizada e nomeie-a como Hospital. Deixe seu tipo de dados como Linha Única de Texto.

    A coluna de lista personalizada aplica-se somente a esta lista. Quando você adiciona uma coluna de lista personalizada a uma lista, um novo tipo de conteúdo de lista, incluindo todas as colunas adicionadas à lista, é criado e definido como a lista padrão.

    Dica

    Se você escolher uma coluna na lista de colunas do site, uma coluna de site existente será usada. No entanto, se você inserir um valor de nome de coluna sem escolher nenhuma coluna na lista, uma coluna de lista personalizada será criada, mesmo que uma coluna com o mesmo nome já exista na lista.

    Opcionalmente, em vez de definir o tipo de dados da coluna de lista personalizada como Linha Única de Texto, você poderia definir o tipo de dados dessa coluna como Pesquisa e seus valores seriam recuperados de uma tabela ou de outra lista. Para obter informações sobre colunas de Pesquisa, confira Relações de lista no SharePoint 2010 e Pesquisas e relações de lista.

  10. Ao lado das caixas ID do Paciente e Nome do Paciente, marque a caixa de seleção Obrigatório.

  11. Na guia Exibições, escolha uma linha vazia para criar uma exibição. Insira Detalhes do Paciente em uma linha em branco na coluna Nome da Exibição.

    Na guia Exibições, você pode especificar as colunas que aparecerão na lista do SharePoint.

  12. Escolha a nova linha Detalhes do Paciente e, em seguida, escolha o botão Definir como Padrão.

    A nova exibição agora é a exibição padrão da lista.

  13. Adicione as seguintes colunas à lista Colunas Selecionadas na seguinte ordem:

    • ID do paciente

    • Nome do paciente

    • Telefone Residencial

    • Email

    • Nome do médico

    • Hospital

    • Comentários

  14. Na lista Propriedades, escolha a propriedade Classificação e Agrupamento e, em seguida, escolha o botão de reticências Ellipsis Icon para exibir a caixa de diálogo Classificação e Agrupamento.

  15. Na lista Nome da Coluna, escolha Nome do Paciente, verifique se a coluna Classificação está definida como Crescente e escolha o botão OK.

Testar o aplicativo

Agora que as colunas de site personalizadas, tipo de conteúdo e lista estão prontos, implante-os no SharePoint e execute o aplicativo para testar.

Para testar o aplicativo

  1. Na barra de menus, escolha Arquivo>Salvar Todos.

  2. Escolha a tecla F5 para executar o aplicativo.

    O aplicativo é compilado e, em seguida, seus recursos são implantados no SharePoint e ativados.

  3. Na barra de Navegação Rápida, escolha o link Pacientes para exibir a lista Pacientes.

    Os nomes de coluna na lista devem corresponder aos que você inseriu na guia Exibições no Visual Studio.

  4. Escolha o link Adicionar novo item para criar um cartão de informações do paciente.

  5. Insira informações nos campos e escolha o botão Salvar.

    O novo registro aparece na lista.

Conteúdo relacionado