Compartir a través de


Elemento Association en MethodInstances (esquema BDCMetadata)

Última modificación: jueves, 17 de junio de 2010

Hace referencia a: SharePoint Server 2010

Espacio de nombres: https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Esquema: BDCMetadata

El elemento Association vincula tipos de contenido externo relacionados dentro de un sistema. Por ejemplo, un cliente está asociado a un pedido de ventas en el sistema AdventureWorks: un cliente realiza pedidos de ventas. Association contiene punteros a los tipos de contenido externo de origen y destino, así como un puntero a la lógica de negocios (un objeto MethodInstance), que permite que un cliente capture el tipo de contenido externo de destino desde el tipo de contenido externo de origen. El recorrido de Association es una llamada de método en el sistema externo.

En el modelo BDC, la lógica de Association (MethodInstance) puede estar en cualquier tipo de contenido externo, sea éste de origen o de destino, o en un tipo de contenido externo no relacionado, si el tipo de contenido externo de destino pertenece al LobSystem que contiene la instancia de método Association.

Nota de precauciónPrecaución

Tenga en cuenta que, cuando se usa SharePoint Designer 2010, debe crear la operación de Association en el tipo de contenido externo de destino. Se trata de un requisito de SharePoint Designer; si lo modela de otra manera (en el origen o en otro tipo de contenido externo), no funcionará.

BDC también admite varios escenarios de tipo de contenido externo de origen y un escenario de tipo de contenido externo de destino.

Una instancia del método Association contiene ranuras para los valores de identificador de la instancia SourceEntity y una ranura para los valores de identificador de las instancias DestinationEntity. Por lo tanto, debe etiquetar suficientes objetos TypeDescriptor de entrada con identificadores que correspondan a cada identificador de cada tipo de contenido externo que sea un origen en el método Association. El atributo IdentifierName o un objeto TypeDescriptor de entrada indica a BDC que debe insertar el valor de identificador de EntityInstance adecuado antes de ejecutar el método. Por ejemplo, en una AssociationMethodInstance, probablemente el usuario haya proporcionado los valores de identificador para la EntityInstance de origen que desea recuperar. BDC insertará ese valor en la ranura después de crear una instancia de todo el parámetro mediante todos los valores predeterminados.

BDC también admite seudoasociaciones de clave externa, que no son de primera clase. Considere un método web que devuelve un cliente y que uno de los campos del cliente es la clave para su dirección. Asimismo, piense en otro método web que devuelve una dirección a partir de su clave. Un modelador de metadatos podría usar este método como un método de asociación de cliente y dirección (posiblemente junto con un SpecificFinder para la dirección). Las seudoasociaciones de clave externa perciben que el destino de este método es una dirección, capturan la clave de la dirección del cliente devuelto y, a continuación, llaman a este método de asociación para devolver la dirección automáticamente.

Nota de precauciónPrecaución

No olvide que el modelo BDC admite seudoasociaciones de clave externa, pero SharePoint Designer 2010 no. Por lo tanto, no puede modelar seudoasociaciones de clave externa con SharePoint Designer.

El elemento Association acepta la siguiente propiedad.

Nota importanteImportante

Las propiedades distinguen mayúsculas de minúsculas.

Propiedades

Propiedad

Tipo

Descripción

Requerida

Valor predeterminado

Límites y valores aceptados

HideOnProfilePage

System.Boolean

Especifica si el tipo de contenido externo relacionado se debe agregar a la página de perfil del tipo de contenido externo maestro.

Opcional

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

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos primarios.

Atributos

Atributo

Descripción

Type

Requerido.

MethodInstanceType que especifica el tipo de asociación.

En la siguiente tabla se muestran los valores posibles para este atributo.

Valor

Descripción

AssociationNavigator

MethodInstance es un AssociationNavigator.

Associator

MethodInstance es un Associator.

Disassociator

MethodInstance es un Disassociator.

BulkAssociatedIdEnumerator

MethodInstance es un BulkAssociatedIdEnumerator.

BulkAssociationNavigator

MethodInstance es un BulkAssociationNavigator.

Default

Opcional.

Especifica si Association es el valor predeterminado entre todos los elementos Association que comparten su tipo dentro del tipo de contenido externo que las contiene. Si se establece en true, Association es el valor predeterminado entre los elementos Association que comparten su tipo dentro del tipo de contenido externo que las contiene. Si se establece en false, no lo es.

Valor predeterminado: false

Tipo de atributo: Boolean

ReturnParameterName

Opcional.

Nombre del parámetro que contiene el ReturnTypeDescriptor de Association. El atributo Direction del parámetro debe contener un valor "Out", "InOut o "Return".

Tipo de atributo: String

ReturnTypeDescriptorName

Opcional.

Esto se ha desusado. Use ReturnTypeDescriptorPath en su lugar.

Tipo de atributo: String

ReturnTypeDescriptorLevel

Opcional.

Esto se ha desusado. Use ReturnTypeDescriptorPath en su lugar.

Tipo de atributo: Integer

ReturnTypeDescriptorPath

Opcional.

Ruta de acceso con puntos del TypeDescriptor de Association.

Tipo de atributo: String

Name

Requerido.

Nombre de Association.

Tipo de atributo: String

DefaultDisplayName

Opcional.

Nombre para mostrar predeterminado para Association.

Tipo de atributo: String

IsCached

Opcional.

Especifica si esta Association se usa a menudo.

Valor predeterminado: true

Tipo de atributo: Boolean

Elementos secundarios

Elemento

Descripción

Elemento LocalizedDisplayNames en MetadataObject (esquema BDCMetadata)

El elemento LocalizedDisplayNames especifica una lista de nombres localizados para Association.

Elemento Properties en MetadataObject (esquema BDCMetadata)

El elemento Properties especifica las propiedades de Association.

Elemento AccessControlList (esquema BDCMetadata)

El elemento AccessControlList especifica un conjunto de derechos de acceso para Association.

Elemento SourceEntity en Association (esquema BDCMetadata)

El elemento SourceEntity especifica el tipo de contenido externo de origen en Association.

Elemento DestinationEntity en Association (esquema BDCMetadata)

El elemento DestinationEntity especifica el tipo de contenido externo de destino en Association.

Elementos primarios

Elemento

Descripción

Elemento MethodInstances en el método (esquema BDCMetadata)

Elemento MethodInstance que contiene a Association.