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.

Precaució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.

Precaució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.

Importante
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.