Association, élément dans MethodInstances (schéma BDCMetadata)

Dernière modification : jeudi 17 juin 2010

S’applique à : SharePoint Server 2010

Espace de noms : https://schemas.microsoft.com/windows/2007/BusinessDataCatalog

Schéma : BDCMetadata

L’élément Association lie les types de contenu externe associés dans un système. Par exemple, un client est associé à une commande dans le système AdventureWorks : un client passe des commandes. Une association contient des pointeurs aux types de contenu externe source et de destination, et un pointeur à la logique métier (objet MethodInstance) qui permet à un client d’obtenir le type de contenu externe de destination à partir du type de contenu externe source. La traversée d’une association est un appel de méthode sur le système externe.

Dans le modèle BDC, la logique Association (MethodInstance) peut figurer sur n’importe quel type de contenu externe (source, destination ou un type de contenu externe non associé), à condition que le type de contenu externe de destination appartienne au LobSystem contenant l’instance de la méthode Association

Attention
Notez que dans SharePoint Designer 2010, vous devez créer l’opération Association sur le type de contenu externe de destination. Il s’agit d’une condition requise de SharePoint Designer, toute autre modélisation (sur le type de contenu externe source ou autre) étant vouée à l’échec.

BDC prend aussi en charge plusieurs scénarios de type de contenu externe source et un scénario de type de contenu externe de destination.

Une instance de méthode Association contient des emplacements pour les valeurs d’identificateur de l’instance SourceEntity et un emplacement pour les valeurs d’identificateur des instances DestinationEntity. Par conséquent, vous devez marquer suffisamment d’objets TypeDescriptor d’entrée avec des identificateurs correspondant à chaque identificateur de chaque type de contenu externe constituant une source dans l’association de la méthode Association. L’attribut IdentifierName sur un objet TypeDescriptor d’entrée indique à BDC d’insérer la valeur d’identificateur de l’instance EntityInstance appropriée avant d’exécuter la méthode. Par exemple, dans une instance AssociationMethodInstance, il est fort probable que l’utilisateur a fourni les valeurs d’identificateur pour l’instance EntityInstance source qu’il souhaite récupérer. BDC insère cette valeur à cet emplacement après avoir entièrement instancié ce paramètre au moyen de toutes les valeurs par défaut.

BDC prend également en charge les pseudo-associations de clé étrangère. Les pseudo-associations de clé étrangère ne sont pas des associations de première classe. Prenons l’exemple d’une méthode Web qui retourne un client, en supposant que l’un des champs d’un client est la clé de l’adresse du client. Imaginons également une autre méthode Web qui retourne l’adresse en fonction de sa clé. Un modélisateur de métadonnées peut utiliser cette méthode en tant que méthode d’association client-adresse (avec éventuellement une recherche d’adresse spécifique). Les pseudo-associations de clé étrangère détectent que la cible de cette méthode est une adresse, récupèrent la clé de l’adresse du client retourné, puis appellent cette méthode d’association pour retourner l’adresse automatiquement.

Attention
Notez que le modèle BDC prend en charge les pseudo-associations de clé étrangère, contrairement à SharePoint Designer 2010. Par conséquent, vous ne pouvez pas modéliser des pseudo-associations de clé étrangère à l’aide de SharePoint Designer.

L’élément Association accepte la propriété suivante.

Important

Les propriétés respectent la casse.

Propriétés

Propriété	Type	Description	Obligatoire	Valeur par défaut	Limites/valeurs acceptées
HideOnProfilePage	System.Boolean	Spécifie si le type de contenu externe associé doit être ajouté à la page de profil du type de contenu externe maître.	Facultatif

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

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
Type	Obligatoire. MethodInstanceType qui spécifie le type d’association. Le tableau suivant répertorie les valeurs possibles pour cet attribut. Valeur Description AssociationNavigator MethodInstance est un AssociationNavigator. Associator MethodInstance est un Associator. Disassociator MethodInstance est un Disassociator. BulkAssociatedIdEnumerator MethodInstance est un BulkAssociatedIdEnumerator. BulkAssociationNavigator MethodInstance est un BulkAssociationNavigator.
Default	Facultatif. Spécifie si l’association est l’association par défaut parmi toutes les associations partageant son type dans le type de contenu externe contenant. Si la valeur est true, l’association est la valeur par défaut parmi toutes les associations partageant son type dans le type de contenu externe contenant. Si la valeur est false, l’association n’est pas la valeur par défaut parmi toutes les associations partageant son type dans le type de contenu externe contenant. Valeur par défaut : false Type d’attribut : Booléen
ReturnParameterName	Facultatif. Nom du paramètre qui contient le ReturnTypeDescriptor de l’association. L’attribut Direction du paramètre doit contenir la valeur « Out », « InOut » ou « Return ». Type d’attribut : Chaîne
ReturnTypeDescriptorName	Facultatif. Ceci a été désapprouvé. Utilisez plutôt ReturnTypeDescriptorPath. Type d’attribut : Chaîne
ReturnTypeDescriptorLevel	Facultatif. Ceci a été désapprouvé. Utilisez plutôt ReturnTypeDescriptorPath. Type d’attribut : Entier
ReturnTypeDescriptorPath	Facultatif. Le chemin d’accès en pointillés du TypeDescriptor de l’association. Type d’attribut : Chaîne
Name	Obligatoire. Nom de l’association. Type d’attribut : Chaîne
DefaultDisplayName	Facultatif. Nom d’affichage par défaut de l’association. Type d’attribut : Chaîne
IsCached	Facultatif. Spécifie si cette association est utilisée fréquemment. Valeur par défaut : true Type d’attribut : Booléen

Éléments enfants

Élément	Description
LocalizedDisplayNames, élément dans MetadataObject (schéma BDCMetadata)	L’élément LocalizedDisplayNames spécifie une liste de noms localisés pour l’association.
Properties, élément dans MetadataObject (schéma BDCMetadata)	L’élément Properties spécifie les propriétés de l’association.
Élément AccessControlList (schéma BDCMetadata)	L’élément AccessControlList spécifie un jeu de droits d’accès pour l’association.
SourceEntity, élément dans Association (schéma BDCMetadata)	L’élément SourceEntity spécifie le type de contenu externe source dans l’association.
DestinationEntity, élément dans Association (schéma BDCMetadata)	L’élément DestinationEntity spécifie le type de contenu externe de destination dans l’association.

Éléments parents

Élément	Description
Élément MethodInstances dans une méthode (schéma BDCMetadata)	Élément MethodInstances qui contient l’association.