Criando um modelo de conectividade de dados de negócios

Você pode desenvolver um modelo para o serviço de conectividade de dados de negócios (BDC) adicionando a entidades e os 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, por exemplo, adicionando, excluindo ou atualizando 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 uma entidade partir do Visual Studio caixa de ferramentas para o Designer do BDC. Para obter mais informações, consulte Como: Adicionar uma entidade a um modelo.

Defina os campos da entidade em uma classe. Por exemplo, você pode adicionar um campo chamado Address para um Customer classe. Você pode adicionar uma nova classe ao projeto ou usar uma classe existente, criada usando outras ferramentas, como o Object Relational Designer (O/R Designer). O nome da entidade e o nome da classe que representa a entidade não precisa corresponder ao. Você pode relacionar a classe à entidade quando você define os métodos no seu modelo.

Adicionando métodos

O serviço do BDC chama métodos no seu modelo quando os usuários exibir, adicionar, atualizar ou excluir informações em uma lista ou uma Web Part que se baseia em seu modelo. Você deve adicionar um método para o modelo para cada tarefa que o usuário pode executar. Criar métodos selecionando qualquer um dos cinco tipos básicos de método do Detalhes do método BDC janela. A tabela a seguir descreve os cinco métodos básicos de um modelo do BDC.

Definindo parâmetros de método

Quando você cria um método, o Visual Studio adiciona os parâmetros de entrada e saídos que são apropriados para o tipo de método. Esses parâmetros são apenas espaços reservados. Na maioria dos casos, você deve modificar os parâmetros para que passe ou retornar o tipo correto de dados. Por exemplo, por padrão, um método localizador retorna uma seqüência de caracteres. Na maioria dos casos, você deseja modificar o parâmetro de retorno do método Finder para que ele retorne uma coleção de entidades. Você pode fazer que modificando o descritor de tipo do 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.

Visual Studio permite que você copie os descritores de tipo entre os parâmetros do modelo. Por exemplo, você pode definir um descritor de tipo chamado CustomerTD para o parâmetro de retorno de GetCustomer método. Você pode copiar o CustomerTD Digite descritor na bdc Explorere cole esse descritor de tipo para o parâmetro de entrada do CreateCustomer método. Isso evita a necessidade que definir o descritor de tipo mesmo mais de uma vez.

Instâncias do método

Quando você cria um método, o Visual Studio adiciona uma instância de método padrão. Uma instância de método é uma referência a um método, mais os 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 do 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, as instâncias do método aparecem em uma lista suspensa acima da lista do SharePoint. Os usuários podem selecionar instâncias de método para exibir os dados.

Para adicionar os valores padrão para a instância de método, você precisará modificar o XML do modelo diretamente. Para obter mais informações, consulte ValorPadrão.

Adicionando os descritores de filtro

Os consumidores do modelo talvez queira recuperar instâncias de uma entidade que alguns critérios de correspondência. Para habilitar essa funcionalidade, você pode adicionar um descritor de filtro para um método. Descritores de filtro permitem que os consumidores do modelo Filtrar conjuntos de resultados do método passando valores para métodos antes de serem executados. Para obter mais informações, consulte como: Adicionar parâmetros de filtro para as operações de instâncias de limite do sistema externo.

O SharePoint oferece vários recursos que permitem aos usuários fornecer valores de filtro. Por exemplo, de Web Parts de dados de negócios oferecem uma caixa de texto do filtro. Os usuários podem limitar os dados em uma lista digitando um valor na caixa de texto. Para obter mais informações sobre como adicionar um descritor de filtro para um método, consulte Como: Adicionar um descritor de filtro para um método localizador.

Propriedades do descritor de filtro

Você deve definir o valor de Associada ao descritor de tipo, nome, e tipo propriedades de um descritor de filtro. Todas as outras propriedades são opcionais.

O Associada ao descritor de tipo propriedade relaciona o descritor de filtro para um parâmetro de entrada. Quando um usuário fornece um valor de filtro, o serviço BDC passa esse valor para o método usando o parâmetro de entrada.

O tipo de propriedade descreve o padrão de filtragem que você deseja usar. No SharePoint, o padrão de filtragem selecionado 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 aparece como um controle acima de uma Web Part de dados de negócios. 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.

Fornecer valores padrão

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

Validando o modelo.

Você pode validar o seu modelo durante o desenvolvimento. Visual Studio identifica problemas que podem impedir que seu modelo se comportando como esperado. Esses problemas aparecem na Visual Studio Error List.

Você pode validar um modelo clicando com o botão direito no Designer do BDC e, em seguida, em seguida, clicando em Validar. Para corrigir um erro, clique duas vezes em um erro na lista. Visual Studio define o foco da interface do usuário para o campo adequado.

Erros de validação podem ocorrer quando as regras do modelo são violadas, de alguma maneira. Por exemplo, se a IsCollection de um descritor de tipo for definida como true, mas nenhum descritores de tipo de filho existirem, aparecerão um erro de validação. Talvez você precise se referem às regras de um modelo BDC para compreender alguns erros que aparecem na Visual Studio Error List. Para obter mais informações sobre as regras de um modelo do BDC, consulte O esquema de BDCMetadata.

A solução que contém o modelo de depuração.

Você pode depurar seu código, como você faria depurar qualquer código de Visual Studio. Para depurar seu código, definir pontos de interrupção em qualquer lugar no seu código e inicie o depurador. Visual Studio abre o site do SharePoint. No SharePoint, crie uma lista ou uma Web Part que utilize dados de sua empresa. 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 código em assemblies personalizados que você adicionar ao projeto. No entanto, para depurar o código em um conjunto personalizado, adicione o assembly para o 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 assembly personalizado ao seu projeto, consulte Como: Incluir um Assembly personalizado em um recurso do BDC.

Configurando a segurança do BDC

Talvez você precise modificar as configurações de segurança no SharePoint antes de você pode depurar sua solução. Para modificar essas configurações, abra o aplicativo de serviço de conectividade de dados de negócios no site do SharePoint 2010 Central Administration. No Definir permissões de armazenamento de metadados caixa de diálogo Adicionar sua conta de usuário e, em seguida, selecione qualquer uma das seguintes opções:

Para obter mais informações sobre essas configurações, consulte o gerenciamento de serviços de conectividade de dados de negócios.

Você também pode definir permissões de segurança para 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 do BDC. Para obter mais informações sobre como definir as permissões de segurança de um tipo de conteúdo externo, consulte o gerenciamento de tipo de conteúdo externo.

Observação
Use estas configurações para depurar uma solução de servidor local do SharePoint. Para obter mais informações sobre como configurar as configurações de segurança relacionados a BDC no servidor do SharePoint de produção, consulte Visão geral de segurança de serviços de conectividade de dados de negócios.

Cancelamento de modelos que estão corrompidos

Na primeira vez que você iniciar o depurador Visual Studio implanta todo o modelo do SharePoint. Cada vez que daí em diante, o Visual Studio atualiza o modelo do SharePoint com quaisquer alterações feitas entre as implantações.

Pode haver situações onde você deseja Visual Studio para cancelar o modelo do SharePoint completamente. Por exemplo, um modelo pode ser corrompido. Para reimplantar o modelo para o SharePoint, definir o Atualização Incremental a propriedade do modelo para False, e inicie o depurador. O Atualização Incremental propriedade aparece na Propriedades janela quando você seleciona o nó que representa o modelo a bdc Explorer. Por padrão, o nome do modelo é BdcModel1.

Alterando os nomes de identificador de entidades no modelo

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

Localizar a documentação para elementos de modelo do BDC

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

Tópicos relacionados