Association-Element in MethodInstances (BDCMetadata-Schema)

Letzte Änderung: Donnerstag, 17. Juni 2010

Gilt für: SharePoint Server 2010

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

Schema: BDCMetadata

Mit dem Association-Element werden verwandte externe Inhaltstypen innerhalb eines Systems verknüpft. Beispielsweise ist ein Kunde im AdventureWorks-System einem Verkaufsauftrag zugeordnet: Ein Kunde erteilt Verkaufsaufträge. Eine Zuordnung enthält Zeiger auf die externen Quell- und Zielinhaltstypen sowie einen Zeiger auf die Geschäftslogik (ein MethodInstance-Objekt), mit dem ein Client den externen Zielinhaltstyp vom externen Quellinhaltstyp abrufen kann. Das Traversal einer Zuordnung ist ein Methodenaufruf an das externe System.

Im BDC-Modell kann die Zuordnungslogik (MethodInstance) für jeden externen Inhaltstyp (Quelle oder Ziel oder nicht verwandter externer Inhaltstyp) verwendet werden, sofern der externe Zielinhaltstyp zu dem LobSystem gehört, das die Zuordnungsmethodeninstanz enthält.

Vorsicht
Beachten Sie, dass Sie bei der Verwendung von SharePoint Designer 2010 den Zuordnungsvorgang für den externen Zielinhaltstyp erstellen müssen. Dies ist eine Anforderung von SharePoint Designer, und eine andere Modellierung (für die Quelle oder für einen anderen externen Inhaltstyp) ist nicht möglich.

Von BDC werden außerdem mehrere Szenarien für externe Quellinhaltstypen und ein Szenario für externe Zielinhaltstypen unterstützt.

Eine Zuordnungsmethodeninstanz enthält Positionen für die Bezeichnerwerte der SourceEntity-Instanz und eine Position für die Bezeichnerwerte der DestinationEntity-Instanzen. Daher müssen Sie genügend viele TypeDescriptor-Eingabeobjekte mit Bezeichnern versehen, die den Bezeichnern der einzelnen externen Inhaltstypen entsprechen, die in der Zuordnung in der Zuordnungsmethode als Quelle verwendet werden. Mit dem IdentifierName-Attribut für ein TypeDescriptor-Eingabeobjekt wird BDC signalisiert, dass der Bezeichnerwert der relevanten EntityInstance vor der Ausführung der Methode eingefügt werden soll. In einer AssociationMethodInstance beispielsweise hat der Benutzer wahrscheinlich die Bezeichnerwerte für die abzurufende Quell-EntityInstance bereitgestellt. Dieser Wert wird von BDC an dieser Position eingefügt, nachdem der Parameter unter Verwendung aller Standardwerte vollständig instanziiert wurde.

Von BDC werden außerdem Pseudozuordnungen für Fremdschlüssel unterstützt. Pseudozuordnungen für Fremdschlüssel sind keine Zuordnungen erster Klasse. Stellen Sie sich eine Webmethode vor, von der der Kunde zurückgegeben wird und bei der eines der Felder eines Kunden den Schlüssel für die Adresse des Kunden darstellt. Stellen Sie sich außerdem eine weitere Webmethode vor, von der anhand des Schlüssels die Adresse zurückgegeben wird. Ein Metadatenmodellierer kann diese Methode als Zuordnungsmethode für Kundenadressen verwenden (möglicherweise zusammen mit einer Suche nach einer bestimmten Adresse). Pseudozuordnungen für Fremdschlüssel erkennen, dass das Ziel dieser Methode eine Adresse ist, rufen den Schlüssel der Adresse vom zurückgegebenen Kunden ab und rufen dann diese Zuordnungsmethode auf, um die Adresse automatisch zurückzugeben.

Vorsicht
Beachten Sie, dass Pseudozuordnungen für Fremdschlüssel zwar vom BDC-Modell unterstützt werden, von SharePoint Designer 2010 jedoch nicht. Daher können Sie Pseudozuordnungen für Fremdschlüssel nicht mithilfe von SharePoint Designer modellieren.

Vom Association-Element wird die folgende Eigenschaft akzeptiert.

Wichtig
Bei Eigenschaften wird die Groß-/Kleinschreibung beachtet.

Eigenschaften

Eigenschaft	Typ	Beschreibung	Erforderlich	Standardwert	Grenzwerte/akzeptierte Werte
HideOnProfilePage	System.Boolean	Gibt an, ob der verwandte externe Inhaltstyp der Profilseite des externen Masterinhaltstyps hinzugefügt werden soll.	Optional

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
Typ	Erforderlich. Der MethodInstanceType, der den Typ der Zuordnung angibt. In der folgenden Tabelle werden die möglichen Werte für dieses Attribut aufgeführt. Wert Beschreibung AssociationNavigator Die MethodInstance ist ein AssociationNavigator. Associator Die MethodInstance ist eine Zuordnung. Disassociator Die MethodInstance ist eine aufgehobene Zuordnung. BulkAssociatedIdEnumerator Die MethodInstance ist ein BulkAssociatedIdEnumerator. BulkAssociationNavigator Die MethodInstance ist ein BulkAssociationNavigator.
Default	Optional. Gibt an, ob die Zuordnung unter allen Zuordnungen gleichen Typs innerhalb des externen Inhaltstyps, in dem die Zuordnungen enthalten sind, als Standard verwendet wird. Wenn True festgelegt ist, wird die Zuordnung unter allen Zuordnungen gleichen Typs innerhalb des externen Inhaltstyps, in dem die Zuordnungen enthalten sind, als Standard verwendet. Wenn False festgelegt ist, wird die Zuordnung nicht unter allen Zuordnungen gleichen Typs innerhalb des externen Inhaltstyps, in dem die Zuordnungen enthalten sind, als Standard verwendet Standardwert: False Attributtyp: Boolean
ReturnParameterName	Optional. Der Name des Parameters, der den ReturnTypeDescriptor der Zuordnung enthält. Das Direction-Attribut des Parameters muss den Wert Out, InOut oder Return enthalten. Attributtyp: String
ReturnTypeDescriptorName	Optional. Veraltet. Verwenden Sie stattdessen ReturnTypeDescriptorPath. Attributtyp: String
ReturnTypeDescriptorLevel	Optional. Veraltet. Verwenden Sie stattdessen ReturnTypeDescriptorPath. Attributtyp: Integer
ReturnTypeDescriptorPath	Optional. Der gepunktete Pfad des TypeDescriptors der Zuordnung. Attributtyp: String
Name	Erforderlich. Der Name der Zuordnung. Attributtyp: String
DefaultDisplayName	Optional. Der Standardanzeigename der Zuordnung. Attributtyp: String
IsCached	Optional. Gibt an, ob diese Zuordnung häufig verwendet wird. Standardwert: True Attributtyp: Boolean

Untergeordnete Elemente

Element	Beschreibung
LocalizedDisplayNames-Element in "MetadataObject" (BDCMetadata-Schema)	Mit dem LocalizedDisplayNames-Element wird eine Liste von lokalisierten Namen für die Zuordnung angegeben.
Properties-Element in MetadataObject (BDCMetadata-Schema)	Mit dem Properties-Element werden die Eigenschaften der Zuordnung angegeben.
AccessControlList-Element (BDCMetadata-Schema)	Mit dem AccessControlList-Element wird ein Satz von Zugriffsrechten für die Zuordnung angegeben.
SourceEntity-Element in "Association" (BDCMetadata-Schema)	Mit dem SourceEntity-Element wird der externe Quellinhaltstyp in der Zuordnung angegeben.
DestinationEntity-Element in "Association" (BDCMetadata-Schema)	Mit dem DestinationEntity-Element wird der externe Zielinhaltstyp in der Zuordnung angegeben.

Übergeordnete Elemente

Element	Beschreibung
"MethodInstances"-Element in "Method" ("BDCMetadata"-Schema)	Das MethodInstances-Element, das die Zuordnung enthält.