Partilhar via

Elemento association em MethodInstances (Esquema BDCMetadata)

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Namespace: http://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Esquema: BDCMetadata

O elemento de associação vincula a tipos de conteúdo externo relacionados dentro de um sistema. Por exemplo, um cliente é associado a uma ordem de venda no sistema AdventureWorks: um cliente faz pedidos de vendas. Uma associação contém ponteiros para a fonte e tipos de conteúdo externo de destino e um ponteiro para a lógica de negócios (um objeto MethodInstance ) que permite que um cliente obter o tipo de conteúdo externo de destino do tipo de conteúdo externo fonte. A passagem de uma Association é uma chamada de método no sistema externo.

No Modelo BDC, a lógica Association (MethodInstance) pode estar em qualquer tipo de conteúdo externo, seja de origem ou destino ou de um tipo de conteúdo externo não relacionado, desde que o tipo de conteúdo externo de destino pertença ao LobSystem que contém a instância do método Association.

Aviso

Observe que, ao usar o SharePoint Designer 2010, você deve criar a operação Association no tipo de conteúdo externo de destino. Esse é um requisito do Designer do SharePoint e modelá-lo de outra maneira (na origem ou em outro tipo de conteúdo externo) não funcionará.

O BDC também dá suporte a vários cenários de tipo de conteúdo externo de origem e um cenário de tipo de conteúdo externo de destino.

Uma instância do método Association contém slots para os valores do identificador da instância SourceEntity e um slot para os valores do identificador das instâncias de Entidade de Destino. Portanto, você deve marcar objetos TypeDescriptor de entrada suficientes com identificadores correspondentes a cada identificador de cada tipo de conteúdo externo que é uma fonte no método Association in the Association.

O atributo IdentifierName em um objeto TypeDescriptor de entrada sinaliza o BDC para inserir o valor do identificador da EntityInstance de relevância antes de executar o método. Por exemplo, em uma AssociationMethodInstance, o usuário provavelmente forneceu os valores do identificador para a EntityInstance de origem que ele ou ela deseja recuperar. O BDC inserirá esse valor nesse slot depois de instanciar totalmente esse parâmetro usando todos os valores padrão.

O BDC também dá suporte a pseudo-associações da Chave Estrangeira. Associações pseudo-associações da Chave Estrangeira não são associações de primeira classe. Considere um método Web que retorna o Cliente e que um dos campos de um cliente é a chave para o endereço do cliente. Considere também outro método Web que retorna Endereço dada a chave. Um modelador de metadados pode usar esse método como um método de Associação de Customer-Address (possivelmente junto com um localizador de endereço específico). Associações pseudo-chave estrangeiras veem que o destino desse método é um Endereço, buscar a chave do Endereço do Cliente Retornado e, em seguida, chamar esse método de associação para retornar o Endereço automaticamente.

Aviso

Observe que, embora o Modelo BDC dê suporte a pseudo-associações de chave estrangeira, o SharePoint Designer 2010 não dá suporte. Portanto, você não pode modelar pseudo-associações de chave estrangeira usando o Designer do SharePoint.

O elemento Association aceita a propriedade a seguir.

Importante

[!IMPORTANTE] Propriedades diferenciam maiúsculas de minúsculas.

Propriedades

Propriedade

Tipo

Descrição

Obrigatório

Valor padrão

Valores limites/aceitos

HideOnProfilePage

System.Boolean

Especifica se o tipo de conteúdo externo relacionado deve ser adicionado à página de perfil do tipo de conteúdo externo mestre.

Opcional

 


<Association Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>

As seções a seguir descrevem os atributos, os elementos filhos e os elementos pai.

Elementos e atributos

Atributos

Atributo

Descrição

**Tipo**

Obrigatório.

MethodInstanceType que especifica o tipo da associação.

A tabela a seguir lista os valores possíveis para este atributo.

Valor

Descrição

AssociationNavigator

O MethodInstance é um AssociationNavigator.

Associador

O MethodInstance é um Associator.

Desassociador

O MethodInstance é um Disassociator.

BulkAssociatedIdEnumerator

O MethodInstance é um BulkAssociatedIdEnumerator.

BulkAssociationNavigator

O MethodInstance é um BulkAssociationNavigator.

**Padrão**

Opcional.

Especifica se a associação é o padrão entre todas as associações de compartilhamento de seu tipo de tipo de conteúdo externo que o contém. Se definido como true, a associação é o padrão entre todas as associações de compartilhamento de seu tipo de tipo de conteúdo externo que o contém. Se definido como false, a associação não é o padrão entre todas as associações de compartilhamento de seu tipo de tipo de conteúdo externo que o contém.

Valor padrão: **false**

Tipo de atributo: **Boolean**

**ReturnParameterName**

Opcional.

O nome do parâmetro que contém o ReturnTypeDescriptor da associação. O atributo Direção do parâmetro deve conter um valor de **Out**, **InOut**ou **Return**.

Tipo de atributo: **String**

**ReturnTypeDescriptorName**

Opcional.

Isso foi preterido. Use o ReturnTypeDescriptorPath.

Tipo de atributo: **String**

**ReturnTypeDescriptorLevel**

Opcional.

Isso foi preterido. Use o ReturnTypeDescriptorPath.

Tipo de atributo: **Integer**

**ReturnTypeDescriptorPath**

Opcional.

O caminho pontilhado do TypeDescriptor da associação.

Tipo de atributo: **String**

**Nome**

Obrigatório.

O nome da associação.

Tipo de atributo: **String**

**DefaultDisplayName**

Opcional.

O nome de exibição padrão para a associação.

Tipo de atributo: **String**

**Iscached**

Opcional.

Especifica se esta associação é usada com frequência.

Valor padrão: **true**

Tipo de atributo: **Boolean**

Elementos filho

Elemento Descrição
Elemento LocalizedDisplayNames no MetadataObject (Esquema BDCMetadata) O elemento LocalizedDisplayNames especifica uma lista de nomes localizados para a Associação
Elemento Propriedades no MetadataObject (Esquema BDCMetadata) O elemento Properties Especifica as propriedades da associação.
Elemento AccessControlList (Esquema BDCMetadata) O elemento AccessControlList Especifica um conjunto de direitos de acesso para a associação.
Elemento SourceEntity em Association (Esquema BDCMetadata) O elemento SourceEntity Especifica o tipo de conteúdo externo de origem na associação.
Elemento DestinationEntity em Association (Esquema BDCMetadata) O elemento DestinationEntity Especifica o tipo de conteúdo externo de destino na associação.

Elementos pai

Elemento Descrição
Elemento MethodInstances no Método (Esquema BDCMetadata) O elemento MethodInstances que contém a associação.
  • Last updated on