Ajouter une connexion de données à un service Web

Afficher tout

Masquer tout

Vous pouvez ajouter à votre modèle de formulaire une ou plusieurs connexions de données secondaires pouvant demander ou envoyer des données à un service Web.

• Présentation
• Problèmes de compatibilité
• Avant de commencer
• Ajouter une connexion de données de requête
• Ajouter une connexion de données d'envoi

Présentation

Une connexion de données secondaire est une connexion de données à une source de données externe que vous ajoutez à un formulaire de données. Cette connexion de données est différente d'une connexion de données principale qui est créée lorsque vous concevez un modèle de formulaire basé sur une base de données, un service Web ou les paramètres d'une bibliothèque de connexions. Vous ajoutez une connexion de données secondaire uniquement si vous ne pouvez pas interroger ou envoyer des données via la connexion de données principale.

Lorsque vous ajoutez une connexion de données secondaire à votre modèle de formulaire qui exécute une requête de données, Microsoft Office InfoPath crée une source de données (source de données : collection de champs et de groupes qui définissent et stockent les données d’un formulaire InfoPath. Les contrôles du formulaire sont liés aux champs et aux groupes de la source de données.) secondaire avec des champs de données (champ de données : champ qui contient le résultat d’une requête sur une source de données externe.) et des groupes (groupe : élément de la source de données qui peut contenir des champs et d’autres groupes. Les contrôles qui contiennent d’autres contrôles, tels que des tableaux extensibles et des sections, sont liés à des groupes.) qui correspond auschéma XML (schémas XML : spécification formelle, écrite en XML, qui définit la structure d’un document XML, notamment les noms d’éléments et les types de données, dont les éléments peuvent être associés et dont les attributs sont disponibles pour chaque élément.) du service Web. Étant donné que la structure des données dans la source de données secondaire doit correspondre au schéma XML, vous ne pouvez pas modifier des champs ou des groupes existants dans la source de données secondaire. Lorsque vous ajoutez une connexion de données d'envoi à votre modèle de formulaire, vous configurez le modèle de formulaire afin de permettre aux utilisateurs d'envoyer les données de leur formulaire et vous configurez les options d'envoi pour les formulaires qui sont basés sur votre modèle de formulaire.

Haut de la page

Problèmes de compatibilité

Vous ne pouvez pas configurer la connexion de données d'envoi dans un modèle de formulaire compatible avec le navigateur (modèle de formulaire compatible avec le navigateur : modèle de formulaire conçu dans InfoPath à l’aide d’un mode de compatibilité spécifique. Un modèle de formulaire compatible avec le navigateur peut être activé pour le navigateur lors de sa publication sur un serveur exécutant InfoPath Forms Services.) pour permettre aux utilisateurs d'envoyer des informations de modification avec les données de leur formulaire à un service Web qui accepte un jeu de données Microsoft ADO.NET DataSet. Les informations de modification se composent des modifications qu'un utilisateur apporte aux données stockées dans une base de données. La base de données utilise un service Web pour connecter les utilisateurs à la base de données. ADO.NET peut utiliser les informations de modification pour déterminer la manière de mettre à jour les informations dans la base de données. Demandez à votre administrateur du service Web si le service Web requiert des informations de modification pour mettre à jour une base de données. Le cas échéant, vous devrez créer un modèle de formulaire dont les formulaires peuvent uniquement être remplis à l'aide d'InfoPath.

Haut de la page

Avant de commencer

Avant d'ajouter une connexion de données secondaire à votre modèle de formulaire, vous devez obtenir les informations suivantes auprès de l'administrateur du service Web :

• L'emplacement du service Web.
• Vérification que le service Web utilise un codage de style document/littéral. InfoPath est uniquement compatible avec des services Web de style document/littéral.
• Le nom de l'opération du service Web qui enverra des données aux ou recevra des données des formulaires basés sur ce modèle de formulaire.

Haut de la page

Ajouter une connexion de données de requête

Pour permettre aux utilisateurs de demander des données d'un service Web en utilisant votre modèle de formulaire, vous devez suivre la procédure suivante dans le modèle de formulaire :

1. Ajouter une connexion de données secondaire.
2. Configurer le modèle de formulaire de manière à utiliser la connexion de données secondaire.

Étape 1 : Ajouter une connexion de données secondaire

1. Dans le menu Outils, cliquez sur Connexions de données.

2. Dans la boîte de dialogue Connexions de données, cliquez sur Ajouter.

3. Dans l'Assistant Connexion de données, cliquez sur Créer une connexion dans, sur Réception des données, puis sur Suivant.

4. Sous Depuis où souhaitez-vous recevoir vos données, cliquez sur service Web puis sur Suivant.
5. Sur la page suivante, indiquez l'emplacement du service Web, puis cliquez sur Suivant.

 Remarque   Si vous souhaitez rechercher un service Web à l'aide d'un serveur UDDI (Universal Description Discovery and Integration), cliquez sur Rechercher sur UDDI, entrez l'URL du serveur UDDI que vous souhaitez rechercher, indiquez si vous souhaitez effectuer une recherche par fournisseur ou par service fourni, entrez un mot clé, puis cliquez sur Rechercher. Les services Web qui correspondent au mot clé recherché s'affichent dans la liste Résultat de la recherche. Sélectionnez le service Web que vous souhaitez utiliser, puis cliquez sur OK.

6. Dans la liste Sélectionner une opération, sur la page suivante de l'Assistant, cliquez sur l'opération du service Web qui renvoie des données au formulaire, puis cliquez sur Suivant.
7. Si l'Assistant de connexion de données rencontre un élément inconnu dans le schéma su service Web, la page suivante de l'assistant peut vous demander d'indiquer des exemples de valeur pour chaque paramètre, afin de déterminer les champs ou groupes à ajouter à la source de données principale.

Procédure

Détails techniques

8. Si vous souhaitez que les résultats de la requête soient disponibles lorsque le formulaire n'est pas connecté à un réseau, cochez la case Stocker une copie des données dans le modèle de formulaire.

Sécurité  L'activation de cette case à cocher stocke les résultats de la requête dans le modèle de formulaire. Dans la mesure où les données sont stockées dans le modèle de formulaire, elles sont disponibles dans les formulaires remplis par les utilisateurs, même si leurs ordinateurs ne sont pas connectés à un réseau. Si vous obtenez des données confidentielles de cette connexion de données, il est conseillé de désactiver cette fonctionnalité pour protéger les données en cas de perte ou de vol de l'ordinateur.

9. Cliquez sur Suivant.
10. Sur la page suivante de l'assistant, tapez un nom descriptif pour la connexion de données de requête.
11. Pour permettre aux formulaires qui sont basés sur ce modèle de formulaire de recevoir automatiquement des données à leur ouverture, activez la case à cocher Extraire automatiquement les données à l'ouverture du formulaire.

Étape 2 : Configurer le modèle de formulaire pour utiliser la connexion de données secondaire

Lorsque vous ajoutez une connexion de données de requête à un modèle de formulaire, par défaut les formulaires qui sont basés sur ce modèle de formulaire utilisent la connexion de données lorsqu'ils sont ouverts par un utilisateur. Vous pouvez également configurer votre modèle de formulaire pour qu'il utilise la connexion de données de requête de l'une des façons suivantes :

• Ajouter une règle    Vous pouvez configurer une règle pour utiliser la connexion de données de requête lorsque la condition de la règle se produit.
• Ajouter un bouton    Vous pouvez ajouter un bouton au modèle de formulaire sur lequel les utilisateurs peuvent cliquer pour obtenir les données en utilisant la connexion de données de requête.
• Utiliser du code personnalisé    Si vous ne pouvez pas ajouter une règle ou un bouton, vous pouvez utiliser du code personnalisé pour obtenir les données en utilisant la connexion de données de requête. L'utilisation de code personnalisé nécessite la création de code personnalisé par un développeur.

Ajouter une règle

Vous pouvez ajouter une règle au modèle de formulaire pour obtenir des données de la connexion de données de requête dès lors que la condition de la règle est respectée. La procédure suivante suppose que vous ayez créé une connexion de données de requête pour votre modèle de formulaire et que vous ayez configuré un contrôle sur votre modèle de formulaire pour afficher les données de cette connexion de données.

1. Si le modèle de formulaire a plusieurs vues, cliquez sur Nom de la vue dans le menu Vue pour ouvrir la vue qui contient le contrôle dans laquelle vous souhaitez afficher les données de la source de données secondaire.

2. Double-cliquez sur le contrôle auquel vous souhaitez ajouter une règle.
3. Cliquez sur l'onglet Données.
4. Sous Validation et Règles, cliquez sur Règles.
5. Dans la boîte de dialogue Règles, cliquez sur Ajouter.
6. Dans la case Nom, tapez le nom de la règle.
7. Pour spécifier une condition pour l'exécution de la règle, cliquez sur Définir une condition, puis entrez la condition. La règle s'exécute lorsque la condition est remplie. Si vous ne définissez pas une condition, la règle s'exécute lorsque l'utilisateur change la valeur du contrôle, puis déplace son curseur loin du contrôle.

8. Cliquez sur Ajouter une action.
9. Dans la liste Action, cliquez sur Exécuter une requête via une connexion de données.
10. Dans la liste Connexion de données, cliquez sur la connexion de données de requête que vous souhaitez utiliser puis cliquez sur OK pour fermer toutes les boîtes de dialogue ouvertes.
11. Pour tester vos modifications, cliquez sur Aperçu du formulaire dans la barre d'outils Standard ou appuyez sur Ctrl+Maj+B.

Ajouter un bouton

Vous pouvez ajouter à votre modèle de formulaire un contrôle de bouton sur lequel vos utilisateurs peuvent cliquer pour recevoir des données de la connexion de données de requête. La procédure suivante suppose que vous ayez créé une connexion de données de requête pour votre modèle de formulaire.

1. Si le modèle de formulaire a plusieurs vues, cliquez sur Nom de la vue dans le menu Vue pour ouvrir la vue qui contient le contrôle dans laquelle vous souhaitez afficher les données de la source de données secondaire.

2. Si le volet Office Contrôles n'est pas visible, cliquez sur Autres contrôles dans le menu Insertion ou appuyez sur Alt+I, A.

3. Faites glisser un contrôle de bouton sur votre modèle de formulaire.
4. Double-cliquez sur le bouton que vous venez d'ajouter à votre modèle de formulaire.
5. Cliquez sur l'onglet Général.
6. Dans la liste Action, cliquez sur Actualiser.
7. Dans la zone Étiquette, tapez le nom qui doit apparaître sur le bouton de votre modèle de formulaire.
8. Cliquez sur Paramètres.
9. Dans la boîte de dialogue Actualiser, cliquez sur Une seule source de données secondaire.
10. Dans la liste Choisissez la source de données secondaire, cliquez sur la source de données secondaire qui est associée à la connexion de données de requête, puis cliquez sur OK pour fermer chaque boîte de dialogue ouverte.
11. Pour tester vos modifications, cliquez sur Aperçu du formulaire dans la barre d'outils Standard ou appuyez sur Ctrl+Maj+B.

Haut de la page

Ajouter une connexion de données d'envoi

Pour permettre aux utilisateurs d'envoyer des formulaires basés sur votre modèle de formulaire à un service Web, vous devez commencer par ajouter à votre modèle de formulaire une connexion de données secondaire qui envoie des données, puis vous devez configurer le modèle de formulaire pour permettre à vos utilisateurs d'envoyer les données de leur formulaire.

Étape 1 : Ajouter une connexion de données secondaire

1. Dans le menu Outils, cliquez sur Connexions de données.

2. Dans la boîte de dialogue Connexions de données, cliquez sur Ajouter.

3. Dans l'Assistant Connexion de données, cliquez sur Créer une nouvelle connexion, puis sur Envoyer les données et enfin, sur Suivant.
4. Sous Comment souhaitez-vous envoyer vos données, cliquez sur Vers un service Web puis sur Suivant.
5. Sur la page suivante de l'Assistant, tapez l'emplacement du service Web vers lequel les utilisateurs enverront leurs données, puis cliquez sur Suivant.

 Remarque   Si vous souhaitez rechercher un service Web à l'aide d'un serveur UDDI (Universal Description Discovery and Integration), cliquez sur Rechercher sur UDDI, entrez l'URL du serveur UDDI que vous souhaitez rechercher, indiquez si vous souhaitez effectuer une recherche par fournisseur ou par service fourni, entrez un mot clé, puis cliquez sur Rechercher. Les services Web qui correspondent au mot clé recherché s'affichent dans la liste Résultat de la recherche. Sélectionnez le service Web que vous souhaitez utiliser, puis cliquez sur OK.

6. Dans la liste Sélectionner une opération, cliquez sur l'opération du service Web qui recevra les données du formulaire, puis cliquez sur Suivant.
7. Sur la page suivante de l'Assistant, pour sélectionner les données du formulaire à envoyer pour chaque paramètre du service Web, effectuez l'une des opérations suivantes :

Envoyer les données dans un champ ou groupe

Envoyer toutes les données du formulaire

Envoyer les données sous forme de chaîne

Spécificités des objets Microsoft ADO.NET DataSet

1. Cliquez sur Suivant.
2. Sur la page suivante de l'Assistant, tapez un nom pour la connexion de données d'envoi, puis cliquez sur Terminer.

Après avoir ajouté la connexion de données d'envoi secondaire, vous devez configurer votre modèle de formulaire afin de permettre aux utilisateurs d'envoyer les données de leur formulaire à l'aide de cette connexion de données d'envoi.

Étape 2 : Autoriser l'envoi sur le modèle de formulaire

Lorsque vous configurez le modèle de formulaire afin de permettre aux utilisateurs d'envoyer les données de leur formulaire, InfoPath ajoute un bouton Envoyer à la barre d'outils Standard et une commande Envoyer dans le menu Fichier du formulaire. Vous pouvez également personnaliser les options d'envoi de votre modèle de formulaire de la façon suivante :

• en modifiant le texte qui apparaît sur le bouton Envoyer et sur la commande Envoyer ;
• en modifiant le raccourci clavier du bouton Envoyer et de la commande Envoyer ;
• en créant des messages personnalisés que les utilisateurs recevront lorsqu'ils enverront les formulaires ;
• en indiquant s'il convient de laisser le formulaire ouvert, de le fermer ou d'en ouvrir un autre (vide) une fois le formulaire envoyé.

1. Dans le menu Outils, cliquez sur Options d'envoi.

2. Dans la boîte de dialogue Options d'envoi, activez la case à cocher Permettre aux utilisateurs d'envoyer ce formulaire, cliquez sur Envoyer les données du formulaire vers une destination unique, puis, dans la liste, cliquez sur Service Web.
3. Dans la liste Choisir une connexion de données à envoyer, cliquez sur le nom de la connexion de données d'envoi vers le service Web créé aux étapes précédentes.

Pour changer le nom du bouton Envoyer qui s'affiche dans la barre d'outils Standard et de la commande Envoyer qui s'affiche dans le menu Fichier lorsque les utilisateurs remplissent le formulaire, tapez le nouveau nom dans la zone Légende de la boîte de dialogue Options d'envoi.

 Conseil   Pour affecter un raccourci clavier à ce bouton et à cette commande, tapez un et commercial (&) avant le caractère à utiliser comme raccourci clavier. Par exemple, pour affecter Alt+V comme raccourci clavier du bouton et de la commande Envoyer, tapez En&voyer.

4. Si vous ne souhaitez pas que les utilisateurs puissent utiliser une commande Envoyer ou le bouton Envoyer de la barre d'outils Standard lors du remplissage d'un formulaire, désactivez la case à cocher Afficher l'option de menu Envoyer et le bouton Envoyer de la barre d'outils.

Par défaut, une fois envoyé par l'utilisateur, le formulaire reste ouvert dans InfoPath et un message indiquant si l'envoi a réussi s'affiche. Pour modifier ce comportement par défaut, cliquez sur Avancé, puis effectuez l'une des opérations suivantes :

• Pour fermer le formulaire ou en créer un vierge une fois le formulaire rempli envoyé, cliquez sur l'option de votre choix dans la liste Après envoi.
• Pour créer un message personnalisé indiquant si l'envoi du formulaire a réussi, activez la case à cocher Utiliser des messages personnalisés, puis tapez vos messages dans les zones En cas de réussite et En cas d'échec.

 Conseil   Utilisez un message de la zone En cas d'échec pour indiquer aux utilisateurs ce qu'ils doivent faire s'ils ne parviennent pas à envoyer leur formulaire. Vous pouvez par exemple leur suggérer d'enregistrer le formulaire et de contacter une tierce personne pour plus d'informations.

• Si vous ne souhaitez pas afficher de message à l'issue de l'envoi d'un formulaire, désactivez la case à cocher Afficher les messages de réussite et d'échec.

Haut de la page