Élément FilterDescriptor dans FilterDescriptors (schéma BDCMetadata)
Article
S’applique à : SharePoint 2016 | SharePoint Foundation 2013 | | SharePoint Online SharePoint Server 2013
Spécifie un descripteur de filtre d’une méthode.
Espace de noms : http://schemas.microsoft.com/windows/2007/BusinessDataCatalog
Schéma : BDCMetadata
<FilterDescriptor Type = "String" FilterField = "String" Name = "String" DefaultDisplayName = "String" IsCached = "Boolean"> </FilterDescriptor>
Éléments et attributs
Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.
Attributs
Attribut
Description
**Type**
Obligatoire.
Type du descripteur de filtre.
Le tableau suivant répertorie les valeurs possibles pour cet attribut.
Valeur
Description
Limite
Utilisé lors de l’interrogation d’un système externe et dont la valeur peut être interprétée comme une limite sur le nombre d’éléments externes (**EntityInstances**) qui sont retournés lorsque la méthode à laquelle il appartient est appelée.
PageNumber
Wildcard
Utilisé lors de l’interrogation d’un système externe. Sa valeur représente un modèle de caractères ordinaires et génériques qui est comparé à la valeur d’un champ particulier de l’ensemble d’instances EntityInstances. Le système externe retourne uniquement les instances EntityInstances dont les valeurs de champ correspondent au modèle spécifié.
UserContext
Utilisé lors de l'interrogation d'un système externe. Sa valeur peut être définie automatiquement par n’importe quelle application cliente avec l’identité de l’utilisateur qui appelle le système externe. Cette valeur peut ensuite être utilisée par le système externe pour autoriser puis filtrer les résultats retournés.
UserCulture
Nom d'utilisateur
Password
LastId
SsoTicket
UserProfile
Utilisé lors de l'interrogation d'un système externe. Sa valeur peut être obtenue en examinant le profil de l’utilisateur actuel. Le système externe peut utiliser sa valeur pour filtrer les résultats retournés.
Comparison
Utilisée lors de l'interrogation d'un système externe. Un système externe peut comparer une valeur **ComparisonFilter** à la valeur d’un champ particulier d’un ensemble de **EntityInstances** et seules les **EntityInstances** où les valeurs de champ réussissent le test de comparaison peuvent être retournées.
Timestamp
Input
Utilisé lors de l'appel d'une opération dans un système externe. Un système externe peut utiliser la valeur d’un **InputFilter** comme arguments supplémentaires pour l’opération.
Sortie
Utilisé lors de l'appel d'une opération dans un système externe. Les résultats supplémentaires d’une opération qui ne peuvent pas être capturés par **ReturnTypeDescriptor** peuvent être récupérés en tant que valeur de **InputOutputFilter**.
InputOutput
Utilisé lors de l'appel d'une opération dans un système externe. Un système externe peut utiliser la valeur d’un **InputOutputFilter** comme arguments supplémentaires pour l’opération, et les résultats supplémentaires d’une opération qui ne peuvent pas être capturés par **ReturnTypeDescriptor** peuvent être récupérés en tant que valeur de **InputOutputFilter**.
Traitement par lots
BatchingTermination
Id d’activité
**ActivityId** est utilisé lors de l’appel d’une opération sur le système externe. Sa valeur est définie sur un GUID qui représente le contexte de l’opération en cours. Si cette valeur n’est pas disponible, ce filtre génère un GUID aléatoire. Sur SharePoint Foundation 2010, ce filtre utilise **CorrelationID**.
**FilterField**
Facultatif.
Type d’attribut : **String**
**Nom**
Obligatoire.
Nom du descripteur de filtre.
Type d’attribut : **String**
**DefaultDisplayName**
Facultatif.
Nom d’affichage par défaut du descripteur de filtre.
Type d’attribut : **String**
**IsCached**
Facultatif.
Spécifie si ce descripteur de filtre est utilisé fréquemment. S’il est défini sur **true**, le service Business Data Connectivity (BDC) met en cache ce descripteur de filtre en mémoire.