Procédure : incorporer un contrôle de sélecteur d’éléments externes dans un formulaire InfoPath

Dernière modification : vendredi 16 avril 2010

S’applique à : SharePoint Server 2010

Microsoft InfoPath 2010 met à votre disposition un contrôle Sélecteur d’éléments externes qui vous permet d’incorporer un sélecteur dans un formulaire pour les scénarios où un utilisateur doit sélectionner un élément externe dans une liste SharePoint, tel que le client Jean dans une liste Clients. Un Sélecteur d’éléments externes offre des fonctionnalités de sélection et de résolution pour les éléments externes sur le serveur et dans les applications Microsoft Office clientes enrichies.

Si vous avez configuré des associations pour les types de contenu externes dans le magasin de métadonnées BDC et que le type de contenu externe contient une clé étrangère, Microsoft Business Connectivity Services (BCS) ajoute automatiquement un contrôle de sélecteur au formulaire pour ce champ. Par exemple, imaginons un scénario client/commande. Supposons que les types de contenu externes et l’association sont configurés. Si vous personnalisez le formulaire de liste externe Commande dans InfoPath, Business Connectivity Services place par défaut un contrôle Sélecteur d’éléments externes pour le champ ID_client dans le formulaire Commande. Cela permet aux utilisateurs de rechercher facilement le client de leur choix lorsqu’ils manipulent les commandes.

Toutefois, si votre formulaire InfoPath généré automatiquement est vide du fait que la SpecificFinder possède un ou plusieurs types complexes, vous devez faire glisser un contrôle Sélecteur d’éléments externes à partir du Ruban serveur et définir les propriétés requises. Vous pouvez également activer ces fonctionnalités de sélection et de résolution à partir d’un formulaire InfoPath personnalisé.

Pour incorporer un contrôle Sélecteur d’éléments externes, faites glisser celui-ci sur l’aire de conception dans InfoPath 2010, puis définissez les propriétés sous l’onglet Général et sous l’onglet Autres paramètres. Le tableau 1 répertorie les paramètres que vous pouvez être amené à renseigner lors de l’utilisation d’un sélecteur dans un formulaire.

Tableau 1. Paramètres à fournir lors de l’utilisation d’un sélecteur dans un formulaire

Onglet	Champ	Description
Général	Espace de noms du type de contenu externe	Espace de noms d’entité dans le modèle BDC.
	Nom du type de contenu externe	Nom du type de contenu externe, tel qu’il apparaît dans le modèle BDC.
	Nom de l’instance système	Nom LOBSystemInstance dans le modèle BDC.
	Nom de recherche	Nom de la méthode Finder à utiliser pour remplir la boîte de dialogue du sélecteur. Ce champ est facultatif et, s’il n’est pas spécifié, Business Connectivity Services utilise la recherche par défaut dans le modèle BDC.
	Afficher le nom du champ	Champ à afficher dans le sélecteur. Il doit s’agir du nom d’un TypeDescriptor retourné par la Finder.
	URL du site SharePoint	Champ d’URL de site facultatif. Il n’est pas nécessaire de renseigner ce champ si ce formulaire est publié sur un site SharePoint.
	Titre de la boîte de dialogue	Titre de la boîte de dialogue qui affiche les éléments externes et qui permet aux utilisateurs de sélectionner un ou plusieurs éléments.
	Afficher plus de résultats	Si cette case à cocher est activée, Business Connectivity Services affiche un bouton Afficher plus de résultats dans la boîte de dialogue.
	Nombre maximal de résultats	Nombre maximal de résultats à afficher dans la boîte de dialogue. La valeur par défaut est 100.
	Intervalle d’actualisation (en minutes)	Fréquence à laquelle actualiser le cache. Le comportement par défaut consiste à effectuer une actualisation toutes les 360 minutes.
	Nombre maximal de lignes	Lignes visibles dans le contrôle de sélecteur pour une sélection multiple.
Autres paramètres	Requête par défaut	Valeur de filtre Business Connectivity Services à utiliser chaque fois que la boîte de dialogue du sélecteur est ouverte. Si cette valeur n’est pas spécifiée, tous les éléments sont récupérés à chaque ouverture de la boîte de dialogue.
	Requête par défaut	Requête à exécuter par défaut chaque fois que la boîte de dialogue du sélecteur est ouverte.
	Autoriser les sélections multiples	Si cette case à cocher est activée, permet aux utilisateurs de sélectionner plusieurs éléments. Vous pouvez être amené à écrire du code-behind pour que cette fonctionnalité soit prise en charge dans votre formulaire.
	Actualiser lors de l’ouverture	Si cette case à cocher est activée, les données sont actualisées à partir du système externe au chargement du formulaire.
	Mode de sélecteur	La valeur par défaut est Par défaut (cache Business Connectivity Services local en premier ; s’il est vide, se connecter à une source de données externes). Les autres options disponibles sont les suivantes : Cache local uniquement Se connecter à la source de données externes directement Se connecter à la source de données externes via SharePoint

La figure 1 montre l’aspect que peut présenter l’onglet Général pour l’obtention du type de contenu externe Customer dans AdventureWorks.

Figure 1. Onglet Général du sélecteur d’élément externe dans InfoPath

La figure 2 montre l’onglet Autres paramètres. Vous pouvez ignorer les champs qui ne sont pas mis en évidence dans cette figure.

Figure 2. Onglet Autres paramètres du sélecteur d’élément externe dans InfoPath