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

Dernière modification : vendredi 16 avril 2010

S’applique à : SharePoint Server 2010

Spécifie une MethodInstance.

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

Schéma : BDCMetadata

Les deux cas suivants dans un modèle BDC lèvent une exception InvalidOperationException au moment de l’exécution :

  • Deux instances de méthode SpecificFinder qui renvoient le même ensemble de champs.

  • Deux instances de méthode SpecificFinder qui ont le même nombre de champs et partagent le même nombre de champs avec une autre instance de méthode, telle que Finder.

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

Attributs et éléments

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

Attributs

Attribut

Description

Type

Obligatoire.

Spécifie le type de MethodInstance.

Le tableau suivant répertorie les valeurs possibles pour cet attribut.

Valeur

Description

Finder

Type de MethodInstance qui peut être appelé pour renvoyer une collection de zéro ou plusieurs EntityInstances d’une Entity particulière. L’entrée Finder est définie par les FilterDescriptors contenus dans la Method qui contient le Finder.

SpecificFinder

Type de MethodInstance qui peut être appelé pour renvoyer une EntityInstance spécifique d’une Entity spécifique étant donné son EntityInstanceId. L’entrée SpecificFinder est définie et ordonnancée par les Identifiers associés à l’Entity.

GenericInvoker

Type de MethodInstance qui peut être appelé pour effectuer une tâche spécifique dans un système externe. L’entrée et la sortie GenericInvoker sont spécifiques à la Method.

IdEnumerator

Type de MethodInstance qui peut être appelé pour renvoyer les valeurs de Field qui représentent l’identité d’EntityInstances d’une Entity spécifique. L’entrée IdEnumerator est définie par les FilterDescriptors contenus dans la méthode qui contient l’IdEnumerator pour obtenir la liste d’ID, qui sont les clés uniques pour chaque entité qui doit être accessible à la recherche. Cette instance de méthode autorise la recherche de données externes dans Microsoft SharePoint Server 2010.

ChangedIdEnumerator

Type de MethodInstance qui peut être appelé pour extraire des EntityInstanceIds d’EntityInstances qui ont été modifiés dans un système externe après une durée spécifiée.

DeletedIdEnumerator

Type de MethodInstance qui peut être appelé pour extraire des EntityInstanceIds d’EntityInstances qui ont été supprimés d’un système externe après une durée spécifiée.

Scalar

MethodInstance qui renvoie une valeur unique que vous pouvez appeler dans le système externe. Par exemple, vous pouvez utiliser une instance de méthode scalaire pour obtenir le total des ventes à ce jour à partir du système externe. Les Entities ont zéro ou plusieurs instances de méthodes scalaires.

AccessChecker

Type de MethodInstance qui peut être appelé pour extraire les autorisations dont dispose l’entité de sécurité appelante pour chacun des éléments d’une collection d’EntityInstances identifiés par les EntityInstanceIds spécifiés.

Creator

Type de MethodInstance qui peut être appelé pour créer un EntityInstance. L’ensemble des champs requis pour créer l’EntityInstance porte le nom d’Affichage créateur.

Deleter

Type de MethodInstance qui peut être appelé pour supprimer une EntityInstance avec un EntityInstanceId spécifié.

Updater

Type de MethodInstance qui peut être appelé pour mettre à jour une EntityInstance identifiée par un EntityInstanceId spécifié. L’ensemble des champs requis pour mettre à jour l’EntityInstance porte le nom d’Affichage de programme de mise à jour. L’ensemble des champs dont les valeurs doivent être passées avant d’être modifiées porte le nom d’Affichage de pré-mise à jour.

StreamAccessor

Type de MethodInstance qui peut être appelé pour extraire un champ d’une EntityInstance sous la forme d’un flux de données d’octets.

BinarySecurityDescriptorAccessor

Type de MethodInstance qui peut être appelé pour extraire une séquence d’octets à partir d’un système externe. La séquence d’octets spécifique au système décrit un ensemble d’entités de sécurité et les autorisations associées dont dispose chaque entité de sécurité pour l’EntityInstance identifiée par l’EntityInstanceId spécifié.

BulkSpecificFinder

Type de MethodInstance qui peut être appelé pour renvoyer un ensemble d’EntityInstances spécifiques d’une Entity, étant donné un ensemble d’EntityInstanceIds correspondants.

BulkIdEnumerator

Type de MethodInstance qui peut être appelé pour extraire des informations minimales concernant les éléments externes correspondant aux identités données. Cette instance de méthode peut être utilisée pour optimiser la synchronisation des données mises en cache. Cette méthode doit renvoyer uniquement les identités et informations de version des éléments externes qui correspondent aux Identities données, que l’application appelante peut comparer à la version locale afin de déterminer si quelque chose a changé et, si c’est le cas, demander les éléments externes modifiés afin de mettre à jour les données mises en cache.

Default

Facultatif.

Indique si la MethodInstance est celle par défaut parmi toutes les MethodInstances qui partagent son type dans le type de contenu externe contenant (Entity).

Valeur par défaut : false

Type d’attribut : Boolean

ReturnParameterName

Facultatif.

Nom du Parameter qui contient le ReturnTypeDescriptor de la MethodInstance. L’attribut Direction du Parameter doit être un attribut ParameterDirection avec la valeur Out, InOut ou Return.

Cet attribut doit être spécifié pour tous les types de MethodInstances à l’exception de GenericInvoker, Creator, Deleter et Updater.

Type d’attribut : String

ReturnTypeDescriptorLevel

Facultatif.

Ceci a été désapprouvé. Utilisez plutôt ReturnTypeDescriptorPath.

Type d’attribut : Integer

ReturnTypeDescriptorPath

Facultatif.

Chemin d’accès par points au TypeDescriptor de l’Association.

Type d’attribut : String

Name

Obligatoire.

Spécifie le nom de MethodInstance.

Type d’attribut : String

DefaultDisplayName

Facultatif.

Spécifie le nom complet par défaut de MethodInstance.

Type d’attribut : String

IsCached

Facultatif.

Spécifie si la MethodInstance est utilisée fréquemment.

Valeur par défaut : true

Type d’attribut : Boolean

Éléments enfants

Élément

Description

LocalizedDisplayNames, élément dans MetadataObject (schéma BDCMetadata)

Noms complets localisés de MethodInstance.

Properties, élément dans MetadataObject (schéma BDCMetadata)

Propriétés de MethodInstance.

Élément AccessControlList (schéma BDCMetadata)

Liste de contrôle d’accès de MethodInstance.

Éléments parents

Élément

Description

Élément MethodInstances dans une méthode (schéma BDCMetadata)

Élément MethodInstances qui contient cet objet MethodInstance.