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 : Si le mode de connexion de l’utilisateur est Classique Windows, la valeur est le nom de connexion Windows de l’utilisateur. Contient le nom de domaine et le nom d’utilisateur (par exemple nom_domaine/nom_utilisateur). Si le mode de connexion de l’utilisateur est basée sur les revendications, la valeur passée est la valeur unique qui identifie l’utilisateur (par exemple appartenance: nom_utilisateur, nom_utilisateur@fournisseur.com).
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 : Si la valeur de la propriété Format est RFC1766, la valeur passée au paramètre d’entrée est le nom de la culture. Pour plus d’informations, voir CultureInfo.Name. Si la valeur de la propriété Format est TwoLetterISO, la valeur passée au paramètre d’entrée est le nom de langue ISO à deux lettres de la culture. Pour plus d’informations, voir CultureInfo.TwoLetterISOLanguageName. Si la valeur de la propriété Format est ThreeLetterISO, la valeur passée au paramètre d’entrée est le nom de langue ISO à trois lettres de la culture. Pour plus d’informations, voir CultureInfo.ThreeLetterISOLanguageName. Si la valeur de la propriété Format est ThreeLetterWindows, la valeur passée au paramètre d’entrée est le nom de langue Windows à trois lettres de la culture. Pour plus d’informations, voir CultureInfo.ThreeLetterWindowsLanguageName. Si la valeur de la propriété Format est LCID, la valeur passée au paramètre d’entrée est le LCID de la culture. Pour plus d’informations, voir CultureInfo.LCID.
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é.