MethodInstance, élément dans MethodInstances (schéma BDCMetadata)
Article
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
Spécifie un MethodInstance.
Espace de noms : http://schemas.microsoft.com/windows/2007/BusinessDataCatalog
Schéma : BDCMetadata
Remarque
Les deux cas suivants dans un modèle BDC entraînent une invalidOperationException au moment de l’exécution :
Instances de méthode SpecificFinder deux qui renvoient le même jeu de champs.
Deux SpecificFinder instances de méthode qui ont le même nombre de champs et qui partagent le même nombre de champs avec une autre instance de méthode, par exemple un Finder.
Les sections suivantes décrivent les attributs, les éléments enfants et les é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 retourner une collection de zéro ou plus **EntityInstances** d’une **Entity**particulière. L’entrée **Finder** est définie par les **FilterDescriptors** qui sont contenus dans la **Method** qui contient le **Finder**.
SpecificFinder
Type de **MethodInstance** qui peut être appelé pour retourner un **EntityInstance** spécifique d’une **Entity** spécifique en fonction de son **EntityInstanceId**. L’entrée **SpecificFinder** est définie et triée par les **Identificateurs** associés à l'**Entité**.
GenericInvoker
Type **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 retourner les valeurs **Field** qui représentent l’identité de **EntityInstances** d’une **Entity**spécifique. L’entrée **IdEnumerator** est définie par les **FilterDescriptors** qui sont contenus dans la méthode qui contient **IdEnumerator** pour obtenir la liste des ID, qui sont les clés uniques pour chaque entité qui doivent faire l’objet d’une recherche. Cette instance de méthode active la recherche de données externes dans Microsoft SharePoint Server 2010.
ChangedIdEnumerator
Type de **MethodInstance** qui peut être appelé pour récupérer **EntityInstanceIds** de **EntityInstances** qui ont été modifiés dans un système externe après un délai spécifié.
DeletedIdEnumerator
Type de **MethodInstance** qui peut être appelé pour récupérer **EntityInstanceIds** de **EntityInstances** qui ont été supprimés d’un système externe après l’heure spécifiée.
Scalaire
**MethodInstance** qui retourne une valeur unique que vous pouvez appeler dans le système externe. Par exemple, vous pouvez utiliser une instance de méthode scalaires pour obtenir le total des ventes effectuées à ce jour à partir du système externe. **Les entités** ont zéro ou plusieurs instances de méthode scalaire.
AccessChecker
Type de **MethodInstance** qui peut être appelé pour récupérer les autorisations dont dispose le principal de sécurité appelant pour chacune d’une collection de **EntityInstances** identifiées par les **EntityInstanceIds** spécifiés.
Creator
Type **MethodInstance** qui peut être appelé pour créer une **EntityInstance**. L’ensemble de champs requis pour créer l'**EntityInstance** est appelé Mode Créateur.
Suppression
Type de **MethodInstance** qui peut être appelé pour supprimer un **EntityInstance** avec un **EntityInstanceId** spécifié.
Mise à jour
Type **MethodInstance** qui peut être appelé pour mettre à jour un **EntityInstance** identifié par un **EntityInstanceId**spécifié. L’ensemble de champs requis pour mettre à jour l'**EntityInstance** est appelé vue updater. La vue PreUpdater est appelé le jeu de champs dont les valeurs doivent être passés avant leur modification.
StreamAccessor
Type **MethodInstance** qui peut être appelé pour récupérer un champ d’un **EntityInstance** sous la forme d’un flux de données d’octets.
BinarySecurityDescriptorAccessor
Type **MethodInstance** qui peut être appelé pour récupérer une séquence d’octets d’un système externe. La séquence d’octets spécifique au système décrit un ensemble de principaux de sécurité et les autorisations associées à chaque principal de sécurité pour l'**EntityInstance** identifiée par un **EntityInstanceId** spécifié.
BulkSpecificFinder
Type de **MethodInstance** qui peut être appelé pour retourner un ensemble de **EntityInstances** spécifiques d’une **Entity**, en fonction d’un ensemble de **EntityInstanceIds**.
BulkIdEnumerator
Type **MethodInstance** qui peut être appelé pour récupérer des informations minimales sur 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 retourner uniquement les identités et les informations de version des éléments externes qui correspondent à **Identités**, que l’application appelante peut comparer à la version locale pour déterminer si quelque chose a changé et, si c’est le cas, demander aux éléments externes modifiés de mettre à jour les données mises en cache.
**Par défaut**
Facultatif.
Spécifie si **MethodInstance** est la valeur 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** du **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.
Cela a été abandonné. Utilisez le **ReturnTypeDescriptorPath** à la place.
Type d’attribut : **Integer**
**ReturnTypeDescriptorPath**
Facultatif.
Chemin pointillé du **TypeDescriptor** de l’association.
Type d’attribut : **String**
**Nom**
Obligatoire.
Spécifie le nom de **MethodInstance**.
Type d’attribut : **String**
**DefaultDisplayName**
Facultatif.
Spécifie le nom d’affichage par défaut pour **MethodInstance**.
Type d’attribut : **String**
**IsCached**
Facultatif.
Spécifie si **MethodInstance** est fréquemment utilisé.