Élément Association dans MethodInstances (schéma BDCMetadata)
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
Espace de noms : http://schemas.microsoft.com/windows/2007/BusinessDataCatalog
Schéma : BDCMetadata
L'élément Association lie les types de contenu externes associés au sein d'un système. Par exemple, un client est associé à une commande dans le système AdventureWorks : un client crée des commandes client. Une Association conserve des pointeurs vers la source et les types de contenu externe de destination et un pointeur vers la logique métier (un objet MethodInstance ) qui permet à un client obtenir le type de contenu externe de destination à partir du type de contenu externe source. Le parcours d'un Association est un appel de méthode sur le système externe.
Dans le modèle BDC, la logique d’association (MethodInstance) peut se trouver sur n’importe quel type de contenu externe, source ou destination, ou sur un type de contenu externe non lié, à condition que le type de contenu externe de destination appartienne au LobSystem qui contient l’instance de méthode Association.
Avertissement
Notez que lorsque vous utilisez SharePoint Designer 2010, vous devez créer l’opération Association sur le type de contenu externe de destination. Il s’agit d’une exigence de SharePoint Designer, et la modélisation inverse (sur la source ou un autre type de contenu externe) ne fonctionnera pas.
Bdc prend également 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 baliser suffisamment d’objets TypeDescriptor d’entrée avec des identificateurs correspondant à chaque identificateur de chaque type de contenu externe qui est 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’EntityInstance de pertinence avant d’exécuter la méthode . Par exemple, dans une AssociationMethodInstance, l’utilisateur a probablement fourni les valeurs d’identificateur de l’EntityInstance source qu’il souhaite récupérer. BDC insère cette valeur dans cet emplacement après avoir instancié entièrement ce paramètre en utilisant toutes les valeurs par défaut.
BDC prend également en charge les pseudo-associations de clés étrangères. Les pseudo-associations de clés étrangères ne sont pas des associations de première classe. Supposons par exemple qu'une méthode Web renvoie un client, et que l'un des champs du client est la clé vers l'adresse du client. Considérez également une autre méthode web qui retourne Address en fonction de sa clé. Un modéliseur de métadonnées peut utiliser cette méthode comme méthode d’association Customer-Address (éventuellement avec une recherche d’adresse spécifique). Les pseudo-associations de clés étrangères voient que la cible de cette méthode est une adresse, extrayez la clé d’adresse à partir du client retourné, puis appelez cette méthode d’association pour renvoyer automatiquement l’adresse.
Avertissement
Notez que bien que le modèle BDC prenne en charge les pseudo-associations de clés étrangères, SharePoint Designer 2010 ne le fait pas. Par conséquent, vous ne pouvez pas modéliser de pseudo-associations de clés étrangères à l’aide de SharePoint Designer.
L’élément Association accepte la propriété suivante.
Importante
Les propriétés respectent la casse.
Propriétés
Propriété |
Type |
Description |
Obligatoire |
Valeur par défaut |
Limites / Valeurs possibles |
|---|---|---|---|---|---|
HideOnProfilePage |
System.Boolean |
Spécifie si le type de contenu externe connexe doit être ajouté à la page de profil du type de contenu externe principal. |
Facultatif |
<Association Type = "String" Default = "Boolean" ReturnParameterName = "String" ReturnTypeDescriptorName = "String" ReturnTypeDescriptorLevel = "Integer" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </Association>
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Éléments et attributs
Attributs
Attribut |
Description |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
**Type** |
Obligatoire. MethodInstanceType qui spécifie le type de l'Association. Le tableau suivant répertorie les valeurs possibles pour cet attribut.
|
||||||||||||
**Par défaut** |
Facultatif. Spécifie si l'Association est la valeur par défaut parmi toutes les Associations de partage son type dans le type de contenu externe qui le contient. Si la valeur true, l'Association est la valeur par défaut parmi toutes les Associations de son type dans le type de contenu externe contenant le partage. Si la valeur false, l'Association n'est pas la valeur par défaut parmi toutes les Associations de son type dans le type de contenu externe contenant le partage. Valeur par défaut : **false** Type d’attribut : **Boolean** |
||||||||||||
**ReturnParameterName** |
Facultatif. Le nom du paramètre qui contient le ReturnTypeDescriptor de l'Association. L’attribut Direction du paramètre doit contenir une valeur **Out**, **InOut**, ou **Return**. Type d’attribut : **String** |
||||||||||||
**ReturnTypeDescriptorName** |
Facultatif. Cela a été abandonné. Utilisez la ReturnTypeDescriptorPath à la place. Type d’attribut : **String** |
||||||||||||
**ReturnTypeDescriptorLevel** |
Facultatif. Cela a été abandonné. Utilisez la ReturnTypeDescriptorPath à la place. Type d’attribut : **Integer** |
||||||||||||
**ReturnTypeDescriptorPath** |
Facultatif. Le chemin d'accès en pointillés de l' TypeDescriptor de l'Association. Type d’attribut : **String** |
||||||||||||
**Nom** |
Obligatoire. Nom de l'Association. Type d’attribut : **String** |
||||||||||||
**DefaultDisplayName** |
Facultatif. Le nom complet par défaut pour l'Association. Type d’attribut : **String** |
||||||||||||
**IsCached** |
Facultatif. Spécifie si cette Association est fréquemment utilisée. Valeur par défaut : **true** Type d’attribut : **Boolean** |
Éléments enfants
| Élément | Description |
|---|---|
| Élément LocalizedDisplayNames dans MetadataObject (schéma BDCMetadata) | L’élément LocalizedDisplayNames spécifie une liste de noms localisés pour l’association |
| Élément Properties 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 ensemble de droits d'accès pour l'Association. |
| Élément SourceEntity dans Association (schéma BDCMetadata) | L'élément SourceEntity Spécifie le type de contenu externe source dans l'association. |
| Élément DestinationEntity 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 Method (schéma BDCMetadata) | L'élément MethodInstances qui contient l'Association. |