MethodInstance-Element in "MethodInstances" (BDCMetadata-Schema)

Letzte Änderung: Freitag, 16. April 2010

Gilt für: SharePoint Server 2010

Gibt ein MethodInstance-Element an.

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

Schema: BDCMetadata

Die folgenden beiden Situationen in einem BDC-Modell führen zur Laufzeit zu InvalidOperationException:

• Zwei SpecificFinder-Methodeninstanzen, von denen dieselben Felder zurückgegeben werden.

• Zwei SpecificFinder-Methodeninstanzen, die die gleiche Anzahl von Feldern aufweisen und die gleiche Anzahl von Feldern mit einer anderen Methodeninstanz gemeinsam verwenden, wie z. B. die Finder-Methode.

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

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
Type	Erforderlich. Gibt den Typ des MethodInstance-Elements an. In der folgenden Tabelle werden die möglichen Werte für dieses Attribut aufgeführt. Wert Beschreibung Finder Ein MethodInstance-Typ, der aufgerufen werden kann, um eine Sammlung von null oder mehr EntityInstances-Elementen eines bestimmten Entity-Elements zurückzugeben. Eingaben für Finder werden durch die FilterDescriptors-Elemente im Method-Element definiert, in dem sich Finder befindet. SpecificFinder Ein MethodInstance-Typ, der aufgerufen werden kann, um anhand von EntityInstanceId ein spezielles EntityInstance-Element eines bestimmten Entity-Elements zurückzugeben. Eingaben für SpecificFinder werden durch die Identifiers-Elemente definiert und geordnet, die der Entity zugeordnet sind. GenericInvoker Ein MethodInstance-Typ, der aufgerufen werden kann, um eine bestimmte Aufgabe in einem externen System auszuführen. Die Eingaben und Ausgaben von GenericInvoker sind spezifisch für das Method-Element. IdEnumerator Ein MethodInstance-Typ, der aufgerufen werden kann, um die Werte von Field zurückzugeben, die die Identität des EntityInstances-Elements eines bestimmten Entity-Elements darstellen. Die Eingabe für IdEnumerator wird durch die FilterDescriptors-Elemente definiert, welche in der Methode enthalten sind, die das IdEnumerator-Element zum Abrufen der Liste der IDs enthält. Hierbei handelt es sich um die eindeutigen Schlüssel für jede Entität, die duchsuchbar sein soll. Diese Methodeninstanz ermöglicht die Suche nach externen Daten in Microsoft SharePoint Server 2010. ChangedIdEnumerator Ein MethodInstance-Typ, der aufgerufen werden kann, um EntityInstanceIds-Elemente von EntityInstances-Elementen abzurufen, die nach einem angegebenen Zeitpunkt in einem externen System geändert wurden. DeletedIdEnumerator Ein MethodInstance-Typ, der aufgerufen werden kann, um EntityInstanceIds-Elemente von EntityInstances-Elementen abzurufen, die nach dem angegebenen Zeitpunkt in einem externen System gelöscht wurden. Scalar Eine MethodInstance, die einen einzelnen Wert zurückgibt, den Sie im externen System aufrufen können. Beispielsweise können Sie mithilfe einer skalaren Methodeninstanz den Gesamtumsatz bis dato aus dem externen System abrufen. Entities-Elemente haben null oder mehr skalare Methodeninstanzen. AccessChecker Ein Typ von MethodInstance, durch dessen Aufruf die Berechtigungen abgerufen werden können, über die der aufrufende Sicherheitsprinzipal für die einzelnen Elemente einer Auflistung von EntityInstances verfügt, die durch die angegebenen EntityInstanceIds identifiziert werden. Ersteller Ein Typ von MethodInstance, durch dessen Aufruf eine EntityInstance erstellt werden kann. Die Menge der Felder, die zum Erstellen der EntityInstance erforderlich sind, wird als Creator-Ansicht bezeichnet. Deleter Ein Typ von MethodInstance, durch dessen Aufruf eine EntityInstance mit einer bestimmten EntityInstanceId gelöscht werden kann. Updater Ein Typ von MethodInstance, durch dessen Aufruf eine durch eine bestimmte EntityInstanceId identifizierte EntityInstance aktualisiert werden kann. Die Menge der Felder, die zum Aktualisieren der EntityInstance erforderlich sind, wird als Updater-Ansicht bezeichnet. Die Menge der Felder, deren Werte vor ihrer Änderung übergeben werden sollten, wird als PreUpdater-Ansicht bezeichnet. StreamAccessor Ein Typ von MethodInstance, durch dessen Aufruf ein Feld einer EntityInstance in Form eines Datenstroms von Bytes abgerufen werden kann. BinarySecurityDescriptorAccessor Ein Typ von MethodInstance, durch dessen Aufruf eine Bytesequenz von einem externen System abgerufen werden kann. Die systemspezifische Bytesequenz beschreibt einen Satz von Sicherheitsprinzipalen und die Berechtigungen, die jedem Sicherheitsprinzipal für die durch eine EntityInstanceId identifizierte EntityInstance zugeordnet sind. BulkSpecificFinder Ein Typ von MethodInstance, bei dessen Aufruf eine Menge spezifischer EntityInstances einer Entity, identifiziert durch eine Menge entsprechender EntityInstanceIds, zurückgegeben wird. BulkIdEnumerator Ein Typ von MethodInstance, durch dessen Aufruf minimale Informationen zu den externen Elementen abgerufen werden, die den angegebenen Identitäten entsprechen. Mit dieser Methodeninstanz kann die Synchronisierung zwischengespeicherter Daten optimiert werden. Die Methode sollte nur die Identitäten und Versionsinformationen der externen Elemente zurückgeben, die den angegebenen Identities entsprechen. Diese können von der aufrufenden Anwendung mit der lokalen Version verglichen werden, um Änderungen zu erkennen und ggf. die Aktualisierung der zwischengespeicherten Daten durch die geänderten externen Elemente anzufordern.
Default	Optional. Gibt an, ob MethodInstance der Standard für alle MethodInstances ist, die den gleichen Typ innerhalb des übergeordneten externen Inhaltstyps aufweisen (Entity). Standardwert: false Attributtyp: Boolean
ReturnParameterName	Optional. Der Name des Parameter-Elements, das den ReturnTypeDescriptor des MethodInstance-Elements enthält. Das Direction-Attribut von Parameter muss ein ParameterDirection-Attribut mit dem Wert Out, InOut oder Return sein. Dieses Attribut muss für alle Typen von MethodInstances außer GenericInvoker, Creator, Deleter und Updater angegeben werden. Attributtyp: String
ReturnTypeDescriptorLevel	Optional. Veraltet. Verwenden Sie stattdessen ReturnTypeDescriptorPath. Attributtyp: Integer
ReturnTypeDescriptorPath	Optional. Der Pfad in gepunkteter Schreibweise des TypeDescriptor-Elements der Zuordnung. Attributtyp: String
Name	Erforderlich. Gibt den Namen von MethodInstance an. Attributtyp: String
DefaultDisplayName	Optional. Gibt den Standardanzeigename für MethodInstance an. Attributtyp: String
IsCached	Optional. Gibt an, ob MethodInstance häufig verwendet wird. Standardwert: true Attributtyp: Boolean

Untergeordnete Elemente

Element	Beschreibung
LocalizedDisplayNames-Element in "MetadataObject" (BDCMetadata-Schema)	Die lokalisierten Anzeigenamen von MethodInstance.
Properties-Element in MetadataObject (BDCMetadata-Schema)	Die Eigenschaften des MethodInstance-Parameters.
AccessControlList-Element (BDCMetadata-Schema)	Die Zugriffssteuerungslisten (Access Control Lists, ACLs) von MethodInstance.

Übergeordnete Elemente

Element	Beschreibung
"MethodInstances"-Element in "Method" ("BDCMetadata"-Schema)	Das MethodInstances-Element, das diesen MethodInstance-Parameter enthält.