Association-Element in MethodInstances (BDCMetadata-Schema)

Gilt für: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online-| SharePoint Server 2013

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

Schema: BDCMetadata

Das Association-Element verknüpft verwandte externe Inhaltstypen in einem System. 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.

Warnung

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 das Modellieren auf die andere Weise (für die Quelle oder einen anderen externen Inhaltstyp) funktioniert nicht.

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). Fremdschlüssel-Pseudozuordnungen sehen, dass das Ziel dieser Methode eine Adresse ist, rufen den Schlüssel von Address aus dem zurückgegebenen Kunden ab und rufen dann diese Zuordnungsmethode auf, um die Adresse automatisch zurückzugeben.

Warnung

Beachten Sie, dass das BDC-Modell zwar Pseudozuordnungen von Fremdschlüsseln unterstützt, 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>

In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.

Elemente und Attribute

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.
**Standard**	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**
**Namen**	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)	Das LocalizedDisplayNames-Element gibt eine Liste lokalisierter Namen für die Zuordnung an.
Properties-Element in MetadataObject (BDCMetadata-Schema)	The Properties element specifies the properties of the Association.
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.