Types de filtres pris en charge par le service Business Data Connectivity
Dernière modification : vendredi 16 juillet 2010
S’applique à : SharePoint Server 2010
Les filtres constituent le moyen fondamental par lequel le Service BDC (Business Data Connectivity) capture l’entrée utilisateur (ou système) et la transmet à l’appel d’API principal. Ils décrivent l’emplacement où une valeur de filtre doit être insérée dans une série complexe de paramètres. Cette opération est accomplie en « balisant » les paramètres d’entrée ou de retour d’une définition de méthode afin d’indiquer où l’insertion doit avoir lieu. L’appel d’API principal doit fournir la fonctionnalité pour le filtrage. Les filtres constituent uniquement un mécanisme d’exposition à l’utilisateur final.
Les systèmes externes fournissent différents mécanismes de filtrage. Le service BDC fait abstraction des modèles communs afin de pouvoir fournir aux utilisateurs la même sémantique de filtrage, quelle que soit la source de données. Le service BDC prend en charge plusieurs filtres et modèles de filtrage. Les filtres utilisateur, tels que Comparison, déclarent les entrées qui peuvent être remplacées par les utilisateurs. Les filtres système, tels que UserContext et UserProfile, permettent au service BDC de définir de manière sécurisée des valeurs telles que des jetons utilisateur. Pour plus de détails, voir le Tableau 1. Les clients interrogent le référentiel de métadonnées pour déterminer les filtres pris en charge par le système et établir le rendu de leurs interfaces utilisateur en conséquence.
Important
Si un auteur de métadonnées crée des métadonnées qui prennent un nom d’utilisateur comme filtre contrôlable par l’utilisateur et renvoient des données confidentielles, il se peut qu’un utilisateur puisse visualiser les données d’un autre utilisateur. Pour éviter ce risque, utilisez UserContextFilter pour passer le nom d’utilisateur à l’appel de méthode.
Le Tableau 1 décrit les filtres pris en charge par le service BDC.
Tableau 1. Valeurs de filtres
Valeur |
Type de filtre |
Description |
|---|---|---|
ActivityId |
Filtre système |
Utilisé en cas d’appel d’une opération sur un système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter une identité de contexte de l’opération appelante. Business Connectivity Services définit un GUID qui représente le contexte d’opération actuel comme valeur sur le paramètre d’entrée associé au filtre ActivityId. |
Batching |
Filtre utilisateur |
Utilisé lors de l’interrogation du système externe. Toute application cliente peut lui assigner automatiquement la dernière valeur du filtre obtenue à partir du système externe. Cette valeur peut ensuite être utilisée par le système externe pour reprendre une énumération d’éléments ou de modifications. |
BatchingTermination |
Filtre utilisateur |
Utilisé lors de l’interrogation du système externe. La valeur renvoyée par le système externe indique si des appels supplémentaires sont nécessaires pour obtenir les données restantes. |
Comparison |
Filtre utilisateur |
Utilisée lors de l’interrogation d’un système externe. Un système externe peut comparer une valeur de ComparisonFilter avec la valeur d’un champ particulier d’un ensemble d’EntityInstances et peut renvoyer uniquement ces EntityInstances où les valeurs de champs satisfont au test de comparaison. |
Input |
Filtre utilisateur |
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 argument supplémentaire pour l’opération. |
InputOutput |
Filtre utilisateur |
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 argument supplémentaire 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 extraits en tant que valeur d’InputOutputFilter. |
LastId |
Filtre utilisateur |
Utilisée lors de l’interrogation d’un système externe. Toute application cliente peut lui assigner automatiquement les valeurs d’identificateurs du dernier élément lu à partir du système externe dans un finder qui renvoie les données en plusieurs segments. Cette valeur peut ensuite être utilisée par le système externe pour renvoyer les éléments restants, à compter de l’élément suivant. |
Limit |
Filtre utilisateur |
Utilisé lors de l’interrogation d’un système externe. Sa valeur peut être interprétée en tant que limite du nombre d’éléments externes (EntityInstances) renvoyés lorsque la méthode auquel il appartient est appelée. |
Output |
Filtre utilisateur |
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 extraits comme valeur de l’InputOutputFilter. |
PageNumber |
Filtre utilisateur |
Utilisé lors de l’interrogation du système externe. Sa valeur représente l’index de base zéro de la page que le système externe doit renvoyer pour un résultat multipage. |
Password |
Filtre système |
Utilisé en cas d’appel d’opérations sur un système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter un mot de passe stocké dans la Banque d’informations sécurisée. Business Connectivity Services obtient les informations d’identification qui mappent à la propriété SecondarySsoApplicationId et la propriété SsoProviderImplementation de l’instance de système externe (LobSystemInstance). Il utilise le mot de passe obtenu à partir des informations d’identification comme valeur du paramètre d’entrée associé au filtre Password. Notes SecondarySSOApplicationId diffère de SSOApplicationId. SecondarySSOApplicationId est utilisé par le filtre UserName et le filtre Password. Pour plus d’informations, voir Propriétés personnalisées BDC et LobSystemInstance, élément de LobSystemInstances (schéma BDCMetadata). |
SSOTicket |
Filtre système |
Utilisé en cas d’appel d’une opération sur un système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter un ticket d’authentification de la Banque d’informations sécurisée pour l’utilisateur. Le service ou l’application cible peut ensuite échanger ce ticket pour obtenir les informations d’identification utilisateur. La Banque d’informations sécurisée utilise la propriété SSOProviderImplementation spécifiée dans l’instance de système externe et demande à ce fournisseur d’émettre un SSOTicket. Ce SSOTicket est passé comme paramètre d’entrée associé au filtre SSOTicket. |
Timestamp |
Filtre utilisateur |
Utilisé lors de l’appel d’une opération sur le système externe. Sa valeur représente l’heure à laquelle le client a appelé cette fonction pour la dernière fois. Cette valeur peut ensuite être utilisée par le système externe pour signaler les modifications apportées après l’heure spécifiée. |
UserContext |
Filtre système |
Utilisé en cas d’appel d’une opération sur le système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter le contexte utilisateur. Dans ce cas, Business Connectivity Services utilise la propriété UserContextType sur le filtre (FilterDescriptor) pour rechercher une valeur à définir sur le paramètre d’entrée. Si le UserContextType spécifié est MachineId, la valeur passée au paramètre d’entrée est l’ID unique de l’installation de système d’exploitation de l’ordinateur. Si le UserContextType spécifié est QualifiedUserName, la valeur passée au paramètre d’entrée est l’une des suivantes :
|
UserCulture |
Filtre système |
Utilisé en cas d’appel d’une opération sur le système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter la culture de l’environnement utilisateur qui appelle l’opération. Business Connectivity Services utilise la propriété Format sur le filtre pour rechercher une valeur à définir sur le paramètre d’entrée :
|
UserName |
Filtre système |
Utilisé en cas d’appel d’une opération sur un système externe lorsque la valeur à passer comme paramètre d’entrée doit représenter le nom d’utilisateur stocké dans la Banque d’informations sécurisée. Business Connectivity Services obtient les informations d’identification qui mappent à la propriété SecondarySsoApplicationId et la propriété SsoProviderImplementation de l’instance de système externe. Il utilise le nom d’utilisateur obtenu à partir des informations d’identification comme valeur du paramètre d’entrée associé au filtre système UserName. Notes SecondarySSOApplicationId diffère de SSOApplicationId. SecondarySSOApplicationId est utilisé par le filtre UserName et le filtre Password. Pour plus d’informations, voir Propriétés personnalisées BDC et LobSystemInstance, élément de LobSystemInstances (schéma BDCMetadata). |
UserProfile |
Filtre système |
Utilisé en cas d’appel d’une opération sur un système externe lorsque la valeur à passer comme paramètre d’entrée doit être une propriété sur le profil de l’utilisateur actuel. Business Connectivity Services utilise la propriété UserProfileProvider et la propriété UserProfilePropertyName spécifiée sur le filtre pour rechercher une valeur à définir sur le paramètre d’entrée. UserProfileProvider est utilisé pour extraire le profil de l’utilisateur actuel et UserProfilePropertyName contient le nom de la propriété dont la valeur sur le profil utilisateur doit être passée au paramètre d’entrée. |
Wildcard |
Filtre utilisateur |
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’EntityInstances. Le système externe renvoie uniquement les EntityInstances dont les valeurs de champs correspondent au modèle spécifié. |