Partilhar via

Demonstra Passo a passo: Criando uma lista no SharePoint usando dados de negócios

  • Artigo

O serviço de conectividade de dados de negócios (BDC) permite que o SharePoint exibir dados de negócios de aplicativos de servidor back-end, serviços da Web e bancos de dados.

Esta explicação passo a passo mostra como criar um modelo para o serviço do BDC retorna informações sobre contatos em um banco de dados de exemplo. Você irá criar uma lista no SharePoint usando este modelo.

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

  • Criando um projeto.

  • Adicionando uma entidade no modelo.

  • Adicionando um método localizador.

  • Adicionando um método localizador específico.

  • Testar o projeto.

Pré-requisitos

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

Criando um projeto

Primeiro, crie um projeto que contém um modelo do BDC.

Para criar um projeto

  1. Inicie o Visual Studio 2010

  2. Abrir o Novo projeto caixa de diálogo caixa, expanda o SharePoint nó sob o idioma que você deseja usar e clique em 2010.

  3. No modelos de painel, selecione Modelo de conectividade de dados de negócios. Nomeie o projeto AdventureWorksContacts e clique em OK.

    O O Assistente para personalização do SharePoint aparece. Este assistente permite que você selecione o site que você usará para depurar o projeto e o nível de confiança da solução.

  4. Clique em Concluir para aceitar o site local padrão do SharePoint e o nível de confiança padrão da solução.

Adicionar Classes de acesso a dados para o projeto

Para adicionar classes de acesso a dados para o projeto.

  1. Sobre o Ferramentas menu, clique em Connect to Database.

    A caixa de diálogo Add Reference é aberta.

  2. Adicione uma conexão ao banco de dados de exemplo AdventureWorks de SQL Server. Para obter mais informações, consulte Adicionar/modificar conexão (Microsoft SQL Server).

  3. Em Solution Explorer, clique no nó do projeto.

  4. No menu Project, clique em Add New Item.

  5. No Modelos instalados painel, selecione o dados nó.

  6. No modelos de painel, selecione LINQ to SQL Classes de.

  7. No nome digite AdventureWorks e então clique em Add.

    Um arquivo. dbml é adicionado ao projeto e o Object Relational Designer (O/R Designer) é aberta.

  8. No menu View, clique em Server Explorer.

  9. Em Server Explorer, expanda o nó que representa o banco de dados de exemplo AdventureWorks e o tabelas nó.

  10. Arraste o o contato (pessoa) tabela para O/R Designer.

    Uma classe de entidade é criada e aparece na superfície de design. A classe de entidade tem propriedades que correspondem às colunas na tabela Contact (pessoa).

Removendo a entidade padrão do modelo BDC

O Modelo de conectividade de dados de negócios projeto adiciona uma entidade padrão chamada Entity1 para o modelo. Remova esta entidade. Posteriormente, você adicionará uma nova entidade. Começando com um modelo vazio reduz o número de etapas necessárias para concluir o passo a passo.

Para remover a entidade padrão do modelo

  1. Em Solution Explorer, expanda o BdcModel1 nó e então clique duas vezes o BdcModel1.bdcm arquivo.

  2. O arquivo de modelo de conectividade de dados de negócios se abre no designer do BDC.

  3. No designer, clique com o botão direito Entity1e em seguida, clique em Excluir.

  4. Em Solution Explorer, o botão direito do mouse Entity1.vb (em Visual Basic) ou Entity1.cs (em C#) e clique em Excluir.

  5. Clique com o botão direito Entity1Service.vb (em Visual Basic) ou Entity1Service.cs (em C#) e clique em Excluir.

A adição de uma entidade no modelo

Adicione uma entidade no modelo. Você pode arrastar entidades de Visual Studio caixa de ferramentas para o designer do BDC.

Para adicionar uma entidade no modelo

  1. No menu Exibir, clique em Caixa de Ferramentas.

  2. Da BusinessDataConnectivity guia da caixa de ferramentas, arraste um entidade para o designer do BDC.

    A nova entidade aparece no designer. Visual Studio adiciona um arquivo ao projeto chamado EntityService.vb (em Visual Basic) ou EntityService.cs (em C#).

  3. Sobre o Exibir menu, clique em Propriedades janela.

  4. No Propriedades janela, defina nome para o contato.

  5. No designer, clique com o botão direito a entidade, clique em Adde em seguida, clique em identificador.

    Um novo identificador de erro é exibida na entidade.

  6. No Propriedades janela, altere o nome do identificador para o ID de contato.

  7. No Nome do tipo lista suspensa, selecione Int32.

Adicionando um método específico de localizador

Para ativar o serviço BDC exibir um contato específico, você deve adicionar um método localizador específico. O serviço do BDC chama o método de localização específico quando um usuário seleciona um item em uma lista e, em seguida, clica o Exibir Item o botão na faixa de opções.

Adicionar um método localizador específicos à entidade contato usando o Detalhes do método BDC janela. Para retornar a uma entidade específica, adicione código ao método.

Para adicionar um método de localização específico

  1. No designer do BDC, selecione o contato entidade.

  2. No Exibir menu, clique em Other Windowse em seguida, clique em Detalhes do método BDC.

  3. No Detalhes do método BDC janela, da Adicionar um método lista suspensa, selecione Criar método específico de localizador.

    Visual Studio adiciona os seguintes elementos ao modelo. Esses elementos aparecem na Detalhes do método BDC janela.

    • Um método chamado ReadList.

    • Um parâmetro de entrada para o método.

    • Um parâmetro de retorno do método.

    • Um descritor de tipo para cada parâmetro.

    • Uma instância de método para o método.

  4. No Detalhes do método BDC janela, clique na lista suspensa que aparece para o contato digite descritor e, em seguida, clique em Editar.

    O Explorer do BDC abre. O Explorer do BDC fornece uma exibição hierárquica do modelo.

  5. No Propriedades janela, clique na lista suspensa que aparece ao lado do TypeName propriedade, clique no Projeto atual guia e, em seguida, selecione contato.

  6. No Explorer do BDC, com o botão direito do contatoe, em seguida, clique em Adicionar descritor de tipo.

    Um novo descritor de tipo chamado TypeDescriptor1 consta o Explorer do BDC.

  7. No Propriedades janela, defina a nome propriedade para accountidname.

  8. Clique na lista suspensa ao lado do TypeName propriedade e selecione Int32.

  9. Clique na lista suspensa ao lado do identificador propriedade e selecione accountidname.

  10. Repita a etapa 6 para criar um descritor de tipo para cada um dos seguintes campos.

    Nome

    Digite um nome

    FirstName

    System. String

    Sobrenome

    System. String

    Telefone

    System. String

    EmailAddress

    System. String

    EmailPromotion

    Int32

    NameStyle

    System. Boolean

    PasswordHash

    System. String

    PasswordSalt

    System. String

  11. No designer BDC, sobre o contato entidade, clique duas vezes o ReadItem método.

    O arquivo de código de serviço do contato é aberto no Editor de código.

  12. No ContactService da classe, substituir o ReadItem método com o código a seguir. Esse código realiza as seguintes tarefas:

    • Recupera um registro da tabela de contato do banco de dados AdventureWorks.

    • Retorna uma entidade de contato para o serviço do BDC.

    ObservaçãoObservação

    Substitua o valor da ServerName campo com o nome do servidor.

    		 
    Public Shared Function ReadItem(ByVal contactID As Integer) As Contact
    Const ServerName As String = "MySQLServerName"
    Dim dataContext As AdventureWorksDataContext = _
        New AdventureWorksDataContext("Data Source=" & ServerName & _
            ";Initial Catalog=AdventureWorks;Integrated Security=True")

    Dim Contact As Contact = _
        (From TempContacts In dataContext.Contacts.AsEnumerable().Take(20) _
        Where TempContacts.ContactID = contactID _
        Select TempContacts).[Single]()
    Return Contact
End Function

    public static Contact ReadItem(int contactID)
{
    const string ServerName = "MySQLServerName";
    AdventureWorksDataContext dataContext = new AdventureWorksDataContext
          ("Data Source=" + ServerName + ";" +
           "Initial Catalog=AdventureWorks;Integrated Security=True");

    Contact Contact =
        (from contacts in dataContext.Contacts.AsEnumerable().Take(20)
         where contacts.ContactID == contactID
         select contacts).Single();
    return Contact;
}

Adicionando um método localizador

Para ativar o serviço BDC exibir os contatos em uma lista, você deve adicionar um método localizador. Adicionar um método localizador à entidade contato usando o Detalhes do método BDC janela. Para retornar uma coleção de entidades para o serviço do BDC, adicione código ao método.

Para adicionar um método localizador

  1. No designer BDC, selecione o contato entidade.

  2. No Detalhes do método BDC janela, recolher o ReadItem nó.

  3. Do Adicionar um método na lista suspensa que aparece abaixo do ReadItem método, selecione Criar o método de localizador.

    Visual Studio adiciona um método, um parâmetro de retorno e um descritor de tipo.

  4. No designer BDC, sobre o contato entidade, clique duas vezes o ReadList método.

    O arquivo de código de serviço do contato é aberto no Editor de código.

  5. No ContactService da classe, substituir o ReadList método com o código a seguir. Esse código realiza as seguintes tarefas:

    • Recupera dados da tabela de contatos do banco de dados AdventureWorks.

    • Retorna uma lista de entidades de contato para o serviço do BDC.

    ObservaçãoObservação

    Substitua o valor da ServerName campo com o nome do servidor.

    		 
    Public Shared Function ReadList() As IEnumerable(Of Contact)
    Const ServerName As String = "MySQLServerName"
    Dim dataContext As AdventureWorksDataContext = _
        New AdventureWorksDataContext("Data Source=" & ServerName & _
            ";Initial Catalog=AdventureWorks;Integrated Security=True")

    Dim Contacts As IEnumerable(Of Contact) = _
        From TempContacts In dataContext.Contacts.Take(20) _
              Select TempContacts
    Return Contacts
End Function

    public static IEnumerable<Contact> ReadList()
{
    const string ServerName = "MySQLServerName";
    AdventureWorksDataContext dataContext = new AdventureWorksDataContext
          ("Data Source=" + ServerName + ";" +
           "Initial Catalog=AdventureWorks;Integrated Security=True");

    IEnumerable<Contact> Contacts =
        from contacts in dataContext.Contacts.Take(20)
        select contacts;
    return Contacts;

}

Testar o projeto.

Quando você executar o projeto, o site do SharePoint é aberto e Visual Studio adiciona a seu modelo para o serviço de conectividade de dados de negócios. Crie uma lista de externa no SharePoint que faz referência a entidade do contato. Os dados de contatos no banco de dados AdventureWorks aparecem na lista.

ObservaçãoObservação

Talvez você precise modificar as configurações de segurança no SharePoint antes de você pode depurar sua solução. Para obter mais informações, consulte Criando um modelo de conectividade de dados de negócios.

Para testar o projeto.

  1. Pressione F5.

    O site do SharePoint é aberta.

  2. Sobre o Ações do Site menu, clique em Mais opções

  3. No criar página, clique em Lista externoe em seguida, clique em criar.

  4. Os contatos da lista personalizada de nome.

  5. Clique no botão Procurar ao lado de Tipo de conteúdo externo campo.

  6. No Selecionador de tipo de conteúdo externo caixa de diálogo, selecione AdventureWorksContacts.BdcModel1.Contacte em seguida, clique em criar.

  7. Clique em criar para criar a lista de contatos.

    O SharePoint cria uma lista. Contatos do banco de dados de exemplo AdventureWorks aparecem nessa lista.

  8. Para testar o método localizador específico, clique em um contato na lista.

  9. Na faixa de opções, clique no itens guia.

  10. No itens , clique em Exibir Item.

    Os detalhes do contato que você selecionou aparecem em um formulário.

Próximas etapas

Você pode aprender mais sobre como criar modelos para o serviço do BDC no SharePoint com estes tópicos:

Consulte também

Conceitos

Visão geral de ferramentas de Design do BDC modelo

Outros recursos

Criando um modelo de conectividade de dados de negócios

Criando um modelo de conectividade de dados de negócios

Integração de dados de negócios no SharePoint