Partilhar via

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

  • Artigo

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

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

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

  • Criando um projeto.

  • Adicionando uma entidade para o modelo.

  • Adicionando um método de localizador.

  • Adicionando um método específico de localizador.

  • Testar o projeto.

Pré-requisitos

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

Criando O que contém um modelo de BDC

Para criar um projeto que contém um modelo de BDC

  1. Na barra de menus do Visual Studio, escolha Arquivo, Novo, Projeto.

    A Caixa de diálogo Novo Projeto é exibida.

  2. Em Visual C# ou Visual Basic, expanda o nó de SharePoint , e então escolha o item de 2010 .

  3. No painel de Modelos , escolha Projeto do SharePoint 2010, nomeie o projeto AdventureWorksTest, e então escolha o botão de OK .

    Assistente de personalização do SharePoint aparece.No assistente, você pode especificar o site que você usará para depurar o projeto e para definir o nível de confiança de solução.

  4. Escolha o botão de opção de Implantar como uma solução de farm para definir o nível de confiança.

  5. Escolha o botão de Concluir para aceitar o site da web do SharePoint local padrão.

  6. Em Gerenciador de Soluções, escolha o nó de projeto do SharePoint.

  7. Na barra de menus, escolha Projeto, Adicionar novo item.

    A caixa de diálogo Add New Item aparece.

  8. No painel de, escolha ModelosModelo de conectividade de dados comerciais solução de farm (somente), nomeie o projeto AdventureWorksContacts, e então escolha o botão de Adicionar .

Adicionando classes de acesso a dados a Pack

Para adicionar classes de acesso a dados ao projeto

  1. Na barra de menu, escolha Ferramentas, Conectar ao Banco de Dados.

    A caixa de diálogo Add Reference é aberta.

  2. Adicionar uma conexão para o banco de dados de exemplo AdventureWorks do SQL Server.

    Para obter mais informações, consulte Adicionar/Modificar conexão (Microsoft SQL Server).

  3. Em Gerenciador de Soluções, escolha o nó de projeto.

  4. Na barra de menus, escolha Projeto, Adicionar novo item.

  5. No painel de Modelos Instalados , escolha o nó de Dados .

  6. No painel de Modelos , escolha Classes LINQ to SQL.

  7. Na caixa de Nome , especifique AdventureWorks, e então escolha o botão de Adicionar .

    Um arquivo .dbml é adicionado ao projeto, e o object relational designer (O/R designer) é aberta.

  8. Na barra de menu, escolha Modo de Visualização, Gerenciador de Servidores.

  9. Em Gerenciador de Servidores, expanda o nó que representa o banco de dados de exemplo AdventureWorks em seguida, expanda o nó de Tabelas .

  10. Adicione a tabela de Contate (pessoa) o O/R designer.

    Uma classe de entidade é criada e aparece na superfície de design.A classe de entidade tem propriedades que mapeiam as colunas na tabela de contatos pessoa ().

Remover a entidade padrão do modelo de BDC

O projeto Modelo de conectividade de dados corporativos adiciona uma entidade chamada Entity1 padrão ao modelo.Remover este objeto.Posteriormente, você adicionará um novo objeto.Começar com um modelo vazio reduz o número de etapas necessárias para concluir a explicação passo a passo.

Para remover a entidade padrão de modelo

  1. Em Gerenciador de Soluções, expanda o nó de BdcModel1 , e abra o arquivo de BdcModel1.bdcm.

  2. O arquivo de modelo de conectividade de dados comerciais abre no designer de BDC.

  3. No designer, abra o menu de atalho para Entity1, e então escolha Excluir.

  4. Em Gerenciador de Soluções, abra o menu de atalho para Entity1.vb (no Visual Basic) ou Entity1.cs (em C#), e depois escolha Excluir.

  5. Abra o menu de atalho para Entity1Service.vb (no Visual Basic) ou Entity1Service.cs (em C#), e depois escolha Excluir.

Adicionando uma entidade ao modelo

Adicione uma entidade para o modelo.Você pode adicionar entidades do Visual Studio Caixa de Ferramentas no designer de BDC.

Para adicionar uma entidade ao modelo

  1. Na barra de menu, escolha Modo de Visualização, Caixa de Ferramentas.

  2. Na guia de BusinessDataConnectivity de Caixa de Ferramentas, adicione Entidade no designer de BDC.

    A entidade novo aparece no designer.O Visual Studio adiciona um arquivo denominado EntityService.vb (no Visual Basic) ou EntityService.cs (em C#) para o projeto.

  3. Na barra de menu, escolha Modo de Visualização, Propriedades, Janela.

  4. Na janela de Propriedades , defina o valor da propriedade de Nome para contactar.

  5. No designer, abra o menu de atalho para a entidade Adicionar, escolha, e escolha Identificador.

    Um novo identificador aparece no objeto.

  6. Na janela de Propriedades , altere o nome do identificador a ContactID.

  7. Na lista de Nome do Tipo , escolha System.Int32.

Adicionando um método específico de localizador

Para ativar o serviço de BDC para exibir um contato específico, você deve adicionar um método específico de localizador.Chamadas de BDC o método específico de localizador quando um usuário escolhe um item em uma lista e então clique no botão de Exibir Item em fita.

Adicione um método específico de localizador para a entidade de contato usando a janela de Detalhes do método de BDC .Para retornar uma entidade específica, adicione código ao método.

Para adicionar um método específico de localizador

  1. No designer de BDC, escolha a entidade de Contato .

  2. Na barra de menu, escolha Modo de Visualização, Outras Janelas, Detalhes do método de BDC.

    A janela dos detalhes do método de BDC abre.

  3. Na lista de Adicionar um método , escolha Crie o método específico de localizador.

    O Visual Studio adiciona os seguintes elementos para o modelo.Esses elementos aparecem na janela de Detalhes do método de BDC .

    • Um método ReadItem chamado.

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

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

    • Um descritor de tipo para cada parâmetro.

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

  4. Na janela de Detalhes do método de BDC , abra a lista que aparece para o descritor do tipo de Contato , e então escolha Editar.

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

  5. Na janela de Propriedades , abra a caixa de listagem ao lado da propriedade TypeName , escolha a guia de Projeto Atual , e escolha a propriedade de Contato .

  6. Em BDC Explorer, abra o menu de atalho de Contato, escolha e então Adicione o descritor de tipo.

    Um descritor de tipo que é chamado TypeDescriptor1 aparece em BDC Explorer.

  7. Na janela de Propriedades , defina o valor da propriedade de Nome a ContactID.

  8. Abra a caixa de listagem ao lado da propriedade TypeName , e então escolha Int32.

  9. Abra a caixa de listagem ao lado da propriedade de Identificador , e então escolha ContactID.

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

    Nome

    Digite o nome

    Nome

    System.String

    Sobrenome

    System.String

    Telefone

    System.String

    EmailAddress

    System.String

    EmailPromotion

    System.Int32

    NameStyle

    System.Boolean

    PasswordHash

    System.String

    PasswordSalt

    System.String

  11. No designer de BDC, no entidade de Contato , abra o método de ReadItem .

    O arquivo de código do serviço de contatos abre na editor de códigos.

  12. Na classe de ContactService , substituir o método de ReadItem com o código a seguir.Esse código executa as seguintes tarefas:

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

    • Retorna uma entidade de contato com o serviço de BDC.

    ObservaçãoObservação

    Substitua o valor do campo de ServerName 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 de localizador

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

Para adicionar um método de localizador

  1. No designer de BDC, escolha a entidade de Contato .

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

  3. Na lista de Adicionar um método no método de ReadList , escolha Crie o método de localizador.

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

  4. No designer de BDC, no entidade de Contato , abra o método de ReadList .

    O arquivo de código para o serviço de contatos abre na editor de códigos.

  5. Na classe de ContactService , substituir o método de ReadList com o código a seguir.Esse código executa as seguintes tarefas:

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

    • Retorna uma lista das entidades de contato com o serviço de BDC.

    ObservaçãoObservação

    Substitua o valor do campo de ServerName 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 da web do SharePoint e abre o Visual Studio adiciona o modelo para o serviço de conectividade de dados comerciais.Crie uma lista externa no SharePoint que faz referência a entidade contato.Os dados para contatos no banco de dados AdventureWorks aparecem na lista.

ObservaçãoObservação

Você pode ter que alterar as configurações de segurança no SharePoint antes que você possa depurar a solução.Para obter mais informações, consulte Elaborar um modelo de conectividade de dados de negócios.

Para testar o projeto

  1. Escolha a chave de F5 .

    O site da web do SharePoint aparece.

  2. No menu de Ações do Site , escolha o comando de Mais opções .

  3. Na página de Criar , escolha o modelo de Lista externa , e então escolha o botão de Criar .

  4. Nomeie os lista de contatos personalizados.

  5. Escolha o botão procurar o lado do campo de Tipo de Conteúdo Externo .

  6. Na caixa de diálogo de Selecionador de Tipos de Conteúdo Externo , escolha o item de AdventureWorksContacts.BdcModel1.Contact , e então escolha o botão de Criar .

    O SharePoint cria uma lista de contatos externo que contém o banco de dados de exemplo AdventureWorks.

  7. Para testar o método específico de localizador, escolha um contato na lista.

  8. Em fita, escolha a guia de Itens , e então escolha o comando de Exibir Item .

    Os detalhes de contatos que você escolheu aparecem em um formulário.

Próximas etapas

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

Consulte também

Conceitos

Visão geral de ferramentas de Design do BDC modelo

Outros recursos

Elaborar 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