Compartilhar via


Elaborar um modelo de conectividade de dados de negócios

Você pode desenvolver um modelo para o serviço de (BDC) de conectividade de dados comerciais adicionando entidades e métodos para um arquivo de modelo.Uma entidade descreve uma coleção de campos de dados.por exemplo, uma entidade pode representar uma tabela em um banco de dados.Um método executa uma tarefa como adicionar, excluir, ou atualizar os dados representados pelas entidades.Para obter mais informações, consulte Integração de dados de negócios no SharePoint.

adicionando entidades

Você pode adicionar uma entidade arrastando ou copiando Entidade do Visual Studio Caixa de Ferramentas no designer de BDC.Para obter mais informações, consulte Como: adicionar uma entidade a um modelo.

Define os campos de entidade em uma classe.Por exemplo, você pode adicionar um campo denominado Address a uma classe de Customer .Você pode adicionar uma nova classe ao projeto ou usar uma classe existente criado usando outras ferramentas como o object relational designer (O/R designer).O nome do objeto e o nome da classe que representa a entidade não precisam coincidir.Você relacionam a classe para a entidade quando você define métodos no modelo.

adicionando métodos

Os métodos de chamadas técnicos de BDC no seu modelo quando a exibição de usuários, adicionar, atualizar, ou excluam informações em uma lista ou na Web parts que é baseado no modelo.você deve adicionar um método ao modelo para cada tarefa que o usuário pode executar.Crie métodos selecionando alguns dos cinco tipos básicos do método da janela de Detalhes do método de BDC .A tabela a seguir descreve os cinco métodos básicos de um modelo de BDC.

Método

Descrição

Localizador

Retorna uma coleção de instâncias de entidade.Chamado quando o usuário abrir a lista ou Web parts.Para obter mais informações, consulte Como: adicionar um método localizador.

Localizador específico

Retorna uma instância específica de entidade.Chamado quando um usuário visualiza os detalhes de um item específico em uma lista.Para obter mais informações, consulte Como: adicionar um método específico de localizador.

criador

Adicionar novos dados para a fonte de dados de uma entidade.Chamado quando os usuários escolherem o botão de Novo Item em fita de uma lista que é baseado no modelo.Para obter mais informações, consulte Como: adicionar um método criador.

Updater

Modifica os dados em uma lista.Chamado quando os usuários atualizarem informações em uma lista.Para obter mais informações, consulte Como: adicionar um método Updater.

Deleter

remove os dados.Chamado quando os usuários excluirem um item de lista.Para obter mais informações, consulte Como: adicionar um método Deleter.

Configurando parâmetros de método

Quando você cria um método, o Visual Studio adiciona a entrada e parâmetros de saída que são apropriadas para o tipo do método.Esses parâmetros são apenas espaços reservados.Em a maioria dos casos, você deve alterar as definições de modo que transmitam em ou retorna o tipo correto de dados.Por exemplo, por padrão, um método de localizador retorna uma cadeia de caracteres.Em a maioria dos casos, você deseja alterar o parâmetro de retorno do método de localizador de modo que retorna uma coleção das entidades.Você pode fazer isso modificando o descritor do tipo de parâmetro.Um descritor de tipo é uma coleção de atributos que descreve o tipo de dados de um parâmetro.Para obter mais informações, consulte Como: definir o descritor de tipo de um parâmetro.

O Visual Studio permite que você copie descritores do tipo entre parâmetros no modelo.Por exemplo, você pode definir um descritor de tipo nomeado CustomerTD para o parâmetro de retorno do método de GetCustomer .Você pode copiar o descritor do tipo de CustomerTD em BDC Explorer, e dimensionamento no descritor de tipo para o parâmetro de entrada do método de CreateCustomer .Isso impede que você defina mais de uma vez que o descritor do mesmo tipo.

Instâncias de método

Quando você cria um método, o Visual Studio adiciona uma instância padrão do método.Uma instância do método é uma referência a um método, mais valores padrão para os parâmetros.Um único método pode ter várias instâncias do método.Cada instância é uma combinação de assinatura de método e um conjunto de valores padrão.Para obter mais informações, consulte Como: definir o descritor de tipo de um parâmetro.

Quando você executar o projeto, instâncias do método aparecem em uma lista suspensa acima da lista do SharePoint.Os usuários podem optar instâncias do método para exibir os dados.

Para adicionar os valores padrão ao método de instância como exemplo, você tem que alterar.vstemplate diretamente.Para obter mais informações, consulte Valor padrão.

Adicionando descritores de filtro

Os consumidores de modelo podem desejar recuperar as instâncias de uma entidade que correspondem alguns critérios.Para habilitar essa funcionalidade, você pode adicionar um descritor de filtro a um método.Descritores de filtro permitem aos usuários modelo para filtrar conjuntos de resultados do método passando valores para os métodos antes de executar.Para obter mais informações, consulte Como: Adicionar parâmetros de filtro para as operações as instâncias do limite do sistema externo.

O SharePoint fornece vários recursos que permitem aos usuários para fornecer valores de filtro.Por exemplo, os dados comerciais Web Parts fornecem uma caixa de texto de filtro.Os usuários podem limitar os dados em uma lista inserindo um valor na caixa de texto.Para obter mais informações sobre como adicionar um descritor de filtragem para um método, consulte Como: adicionar um descritor de filtro a um método localizador.

Ee231528.collapse_all(pt-br,VS.110).gifFiltrar propriedades de descritor

Você deve definir o valor de Descritor associado de tipo, de Nome, e propriedades de Tipo de um descritor de filtro.Todas as propriedades restantes são opcionais.

A propriedade de Descritor associado de tipo relaciona com o descritor de filtragem para um parâmetro de entrada.Quando um usuário fornecer um valor de filtro, passa o serviço de BDC o valor no método usando o parâmetro de entrada.

A propriedade de Tipo descreve o padrão de filtragem que você deseja usar.Em o SharePoint, o padrão de filtragem você seleciona afeta o texto que aparece na interface de usuário (UI).Por exemplo, para um padrão de filtragem de comparador, o texto é igual a como um controle aparece acima dos dados comerciais Web parts.Para obter mais informações sobre cada padrão de filtragem, consulte Tipos de filtros suportados pelo BDC.

Para obter mais informações sobre as propriedades de um descritor de filtro, consulte FilterDescriptor.

Ee231528.collapse_all(pt-br,VS.110).gifFornecendo valores padrão

Em alguns casos, o usuário pode não fornecer um valor de filtro.Você pode fornecer um valor padrão adicionando um valor padrão para a instância do método, ou definindo o valor padrão no código do método.Para obter mais informações sobre como adicionar um valor padrão para a instância do método, consulte MethodInstance.Para um exemplo de como definir o valor padrão de um parâmetro de entrada no código do método, consulte Como: adicionar um descritor de filtro a um método localizador.

validando o modelo

você pode validar seu modelo durante o desenvolvimento.O Visual Studio identifica os problemas que podem impedir que seu modelo se comporta como esperado.Esses problemas aparecem no Visual Studio Lista de erros.

Você pode validar um modelo abrindo o menu de atalho para o designer e escolhendo de BDC em Validar.Se o modelo contém quaisquer erros, aparecem em Lista de erros.Você pode mover rapidamente o cursor para o código que contém um erro clicando duas vezes no erro na lista.Como alternativa, você pode escolher F8 ou chaves Shift+F8 repetidamente para passar para frente ou para trás com os erros na lista.

Erros de validação podem ocorrer quando as regras de modelo são violadas de alguma maneira.Por exemplo, se a propriedade de IsCollection de um descritor de tipo é definida como true, mas nenhum descritores filhos do tipo, existe um erro de validação aparecerá.Você pode ter que fazer referência às regras de um modelo de BDC para entender alguns erros que aparecem no Visual Studio Lista de erros.Para obter mais informações sobre regras de um modelo de BDC, consulte esquema de BDCMetadata.

Depurando a solução que contém o modelo

Você pode depurar seu código como você faria para depurar qualquer código em Visual Studio.Para depurar seu código, definir pontos de interrupção em qualquer lugar no seu código e inicia o depurador.O Visual Studio abrir o site do SharePoint.Em o SharePoint, crie uma lista ou Web parts que usa seus dados comerciais.Em seguida, você pode depurar seu código.Para obter mais informações sobre depuração de projetos do SharePoint, consulte Solucionando problemas de soluções do SharePoint.

Você também pode depurar o código em assemblies personalizados que você adiciona ao projeto.Em o entanto, para depurar o código em um conjunto personalizado, você deve adicionar o assembly ao pacote de solução.Para obter mais informações, consulte Como: adicionar e remover Assemblies adicionais.

Para obter mais informações sobre como adicionar um conjunto personalizado ao seu projeto, consulte Como: incluir um Assembly personalizado em um recurso do BDC.

Ee231528.collapse_all(pt-br,VS.110).gifconfigurando a segurança de BDC

Você pode ter que alterar as configurações de segurança no SharePoint antes que você possa depurar a solução.Para alterar essas configurações, abra o aplicativo de serviço de conectividade de dados comerciais no site de administração central do SharePoint 2010.Em a caixa de diálogo de Definir Permissões do Repositório de Metadados , adicione a conta de usuário, selecione qualquer uma das seguintes opções:

Tarefa 

Opção

Para implantar modelos para o serviço de BDC.

Editar

Para criar e listas Web Parts usando tipos de conteúdo externas (entidades) no modelo.

Selecionável os clientes

Para criar, leitura, update, e delete entidade de dados.

Executar

Para obter mais informações sobre essas configurações, consulte Gerenciamento de serviço de conectividade de dados corporativos.

Você também pode definir permissões de segurança para os modelos individuais ou tipos de conteúdo externos.Para obter mais informações sobre como definir as permissões de segurança de um modelo, consulte Gerenciamento de modelo de BDC.Para obter mais informações sobre como definir as permissões de segurança de um tipo de conteúdo externo, consulte Gerenciamento externo de tipo de conteúdo.

ObservaçãoObservação

Use essas configurações para depurar uma solução em seu servidor do SharePoint local.Para obter mais informações sobre como configurar configurações de segurança BDC- relacionadas no servidor do SharePoint de produção, consulte Conectividade de dados comerciais visão geral dos serviços de aplicativos de segurança.

Ee231528.collapse_all(pt-br,VS.110).gifRetraindo modelos que forem corrompidos

Em a primeira vez que você inicia o depurador Visual Studio, implantar o modelo inteiro ao SharePoint.Para cada vez de isso, após o Visual Studio atualiza o modelo no SharePoint com as alterações feitas entre implantações.

Pode haver situações onde você deseja que o Visual Studio para retrair completamente o modelo do SharePoint.Por exemplo, um modelo pode se tornar corrompido.Para reimplantar o modelo ao SharePoint, defina a propriedade de Atualização Incremental de modelo a False, e inicia o depurador.A propriedade de Atualização Incremental aparece na janela de Propriedades quando você seleciona o nó que representa o modelo em BDC Explorer.Por padrão, o nome do modelo é BdcModel1.

Ee231528.collapse_all(pt-br,VS.110).gifAlterando identificador de nomes das entidades no modelo

Se você alterar o nome de um identificador depois que você implantar o modelo, você pode receber um erro de implantação.Você não pode resolver esse erro definindo a propriedade de Atualização Incremental de modelo a False.Você deve retrair o modelo manualmente, e implantar na solução novamente.Para obter mais informações, consulte Solucionando problemas de soluções do SharePoint.Você pode evitar esse erro definindo a propriedade de Atualização Incremental a False antes de implantar inicialmente o modelo.

Localizando a documentação para elementos modelo de BDC

O Visual Studio adiciona um elemento XML para o modelo para cada entidade, o método, ou outro item que você criar.Os atributos do elemento aparecem como propriedades na janela de Propriedades .Para obter informações sobre elementos e atributos que o Visual Studio gera quando você cria o modelo, consulte esquema de BDCMetadata.

Tópicos relacionados

Nome

Descrição

Visão geral de ferramentas de Design do BDC modelo

descreve as ferramentas que você pode usar para criar visualmente um modelo para o BDC.

Como: adicionar uma entidade a um modelo

Mostra a você como adicionar tipos de conteúdo externos, ou a entidades, o modelo.

Como: adicionar um método localizador

Mostra como adicionar um método que permite aos usuários exibir uma lista de entidades em uma lista ou na Web parts.

Como: adicionar um método específico de localizador

Mostra como adicionar um método que permite aos usuários exibir os detalhes de uma entidade específica.

Como: adicionar um método criador

Mostra como adicionar um método que permite aos usuários adicionar registros em uma fonte de dados diretamente de uma lista ou de Web parts.

Como: adicionar um método Deleter

Mostra como adicionar um método que permite aos usuários para remover os dados de uma fonte de dados usando opções na interface de usuário (UI) de uma lista ou de Web parts.

Como: adicionar um método Updater

Mostra como adicionar um método que permite aos usuários modificar registros de dados em uma fonte de dados diretamente de uma lista ou de Web parts.

Como: adicionar um parâmetro para um método.

Mostra como usar a janela dos detalhes do método no Visual Studio para adicionar a entrada e retorna-os parâmetros para um método.

Como: definir o descritor de tipo de um parâmetro

Mostra como definir tipos de dados do parâmetro no modelo.

Como: definir um instância de método

Mostra como criar uma instância de um método que executa o BDC.

Como: adicionar um descritor de filtro a um método localizador

Mostra como permitir que os usuários para limitar o número de instâncias retornadas pelo método de localizador.

Criação de uma associação entre entidades

Descreve como você pode definir relacionamentos entre entidades no modelo.Os dados comerciais Web Parts, listas externos, e os aplicativos personalizados podem exibir estas relações de dados em uma interface de usuário (UI).

Como: criar uma associação entre entidades

Mostra como definir relacionamentos entre entidades no modelo.

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

Fornece instruções passo a passo que mostram como criar e testar um modelo que exibe uma lista de contatos externo do SharePoint.

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

Fornece uma visão geral da criação e criando modelos para o serviço de BDC.