Exemples et scénarios d’automatisation externe

Article
03/15/2024

Les membres fournis par l’assembly d’interopérabilité principale Microsoft Office InfoPath (Microsoft.Office.Interop.InfoPath.dll) et l’assembly d’interopérabilité XML InfoPath (Microsoft.Office.Interop.InfoPath.Xml.dll) prennent en charge l’écriture de code managé pour automatiser InfoPath.

Établissement de références aux assemblys d’interopérabilité principale et d’interopérabilité XML InfoPath De Microsoft Office

Pour écrire du code managé pour automatiser InfoPath, vous devez établir des références à l’interopérabilité principale Microsoft InfoPath et aux assemblys d’interopérabilité XML InfoPath. L’assembly d’interopérabilité principale Microsoft InfoPath prend en charge l’interopérabilité avec le modèle objet COM exposé par IPEDITOR.DLL à l’aide des membres de l’espace de noms Microsoft.Office.Interop.InfoPath . L’assembly d’interopérabilité XML InfoPath prend en charge l’interopérabilité avec le modèle objet COM exposé par Microsoft XML Core Services® (MSXML) à l’aide des membres de l’espace de nomsMicrosoft.Office.Interop.InfoPath.Xml.

Importante

Les utilisateurs d’applications en code managé qui automatisent InfoPath doivent disposer d’InfoPath, de l’assembly d’interopérabilité principal Microsoft Office InfoPath et de l’assembly d’interopérabilité XML InfoPath installés sur leurs ordinateurs. L’option Prise en charge de la programmabilité .NET dans le programme d’installation d’InfoPath est définie sur Exécuter à partir du poste de travail pour une installation classique d’InfoPath.

Par conséquent, tant que le .NET Framework 1.1 Redistributable ou le Kit de développement logiciel (SDK) .NET Framework 1.1 ou version ultérieure sont installés, ces assemblys d’interopérabilité sont également installés par défaut. Si ces assemblys d’interopérabilité ne sont pas disponibles sur l’ordinateur d’un utilisateur, vous devez vérifier que .NET Framework 1.1 ou version ultérieure est installé, puis exécuter Programmes et fonctionnalités à partir du Panneau de configuration pour modifier l’installation et définir l’option Prise en charge de la programmabilité .NET d’InfoPath sur Exécuter à partir du poste de travail.

Les procédures suivantes décrivent comment définir des références à l’interopérabilité principale Microsoft Office InfoPath et aux assemblys d’interopérabilité XML InfoPath dans un projet Visual Studio.

Pour définir une référence à l’assembly d’interopérabilité principale Microsoft.Office.Interop.InfoPath, définissez une référence à la bibliothèque de types Microsoft InfoPath 3.0 sous l’onglet COM de la boîte de dialogue Ajouter une référence . Même si vous définissez une référence à partir de l’onglet COM , une référence est établie à l’assembly d’interopérabilité principal Microsoft.Office.Interop.InfoPath.dll installé dans le Global Assembly Cache (GAC) par le programme d’installation d’InfoPath.

Définir une référence à l’assembly d’interopérabilité principale Microsoft.Office.Interop.InfoPath

Ouvrez un projet de code managé Visual Studio.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.
Sous l’onglet COM , double-cliquez sur Bibliothèque de types Microsoft InfoPath 3.0, puis cliquez sur OK.

Pour définir une référence à l’assembly d’interopérabilité Microsoft.Office.Interop.InfoPath.Xml, accédez au fichier Microsoft.Office.Interop.InfoPath.Xml.dll installé par défaut dans le < dossier lecteur> :\Program Files\Microsoft Office\OFFICE14. Même si vous spécifiez la copie de l’assembly dans le système de fichiers local, cette procédure établit une référence à l’assembly Microsoft.Office.Interop.InfoPath.Xml.dll installé dans le Global Assembly Cache (GAC) par le programme d’installation d’InfoPath.

Définir une référence à l’assembly d’interopérabilité Microsoft.Office.Interop.InfoPath.Xml

Ouvrez ou créez un projet de code managé Visual Studio, tel qu’une application console ou une application Windows.
Dans l’Explorateur de solutions, cliquez avec le bouton droit sur Références, puis cliquez sur Ajouter une référence.
Sous l’onglet .NET, cliquez sur Parcourir, accédez au < dossier drive> :\Program Files\Microsoft Office\OFFICE14, puis cliquez sur Microsoft.Office.Interop.InfoPath.Xml.dll.
Cliquez sur OK.

Automatiser la modification de la valeur d’un champ

Supposons que l’un des clients de l’utilisateur d’un modèle de formulaire de rapport de ventes InfoPath a récemment changé son nom de « Société A » en « Société B ». Un développeur est invité à écrire du code qui met automatiquement à jour les formulaires de rapport de ventes enregistrés à partir de ce modèle de formulaire pour refléter le changement de nom. Le scénario suivant suppose un formulaire qui contient une zone de texte liée à un champ nommé customerName.

Créer l’exemple de modèle de formulaire et de formulaire

Ouvrez InfoPath et créez un modèle de formulaire vide.
Ajoutez un contrôle Zone de texte au formulaire et nommez le champ lié au contrôle customerName.
Dans le volet Office Champs , cliquez avec le bouton droit sur le dossier myFields , puis cliquez sur Propriétés.
Sous l’onglet Détails , sélectionnez et copiez la valeur suivante Espace de noms :, puis collez-la dans le Bloc-notes ou à un autre emplacement où vous pouvez la récupérer. Vous aurez besoin de cette valeur ultérieurement pour définir la valeur de la propriété SelectionNamespaces dans votre code.
Publiez le modèle de formulaire dans un dossier nommé C :\Test et acceptez le nom par défaut, Template1.
Ouvrez le modèle de formulaire, ajoutez le nom « Company A » à la zone de texte liée au champ customerName, puis enregistrez le formulaire sous le nom « Form1 ».

Créer une application console en code managé pour remplacer le nom « Company A » par « Company B »

Ouvrez Visual Studio et créez une application console Visual C# ou Visual Basic nommée UpdateCustomer.
Établissez des références aux assemblys d’interopérabilité principale et d’interopérabilité XML InfoPath de Microsoft Office InfoPath, comme décrit ci-dessus.

Ajoutez le code suivant au fichier Program.cs ou Module1.vb, en veillant à mettre à jour la valeur de l’espace de noms dans le paramètre de la propriété SelectionNamespaces avec la valeur que vous avez copiée lors de la création de l’exemple de formulaire.

 using System;
 using System.Collections.Generic;
 using System.Text;
 using Microsoft.Office.Interop.InfoPath;
 using Microsoft.Office.Interop.InfoPath.Xml;
 namespace UpdateCustomer
 {
   class Program
   {
       static void Main(string[] args)
       {
         // Create an InfoPath Application object.
         Application myApp = 
             new Microsoft.Office.Interop.InfoPath.Application();
         // Get a reference the XDocuments collection 
         // and open the sample form.
         XDocumentsCollection myXDocs = myApp.XDocuments;
         XDocument myXDoc = myXDocs.Open("C:\\Test\\Form1.xml",
             (int) XdDocumentVersionMode.xdFailOnVersionOlder);

         // Access the XML DOM for the underlying XML document using
         // the DOM property. Note that you must cast to the 
         // IXMLDOMDocument2 type from the
         // Microsoft.Office.Interop.InfoPath.Xml namespace
         // to access the XML DOM.
         IXMLDOMDocument2 myXMLDoc = myXDoc.DOM as IXMLDOMDocument2;
         // Set the MSXML SelectionNamespaces property to the my
         // namespace of the form. IMPORTANT:Replace the namespace 
         // value below with that of your sample form.
         myXMLDoc.setProperty("SelectionNamespaces",
 "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2006-09-06T23:17:34'");
         // Select all instances of customerName that contain 
         //'Company A'.
         IXMLDOMNodeList myNames = 
             myXMLDoc.selectNodes(
             "//my:customerName[. = 'Company A']");
         // Check to determine if any nodes were returned.
         if (myNames.length < 1)
         Console.WriteLine(
             "No elements containing 'Company A' were found.");
         // Loop through the list updating to 'Company B'.
         IXMLDOMNode myName = myNames.nextNode();
         while (myName != null)
         {
             myName.text = "Company B";
             myName = myNames.nextNode();
         }
         // Save the updated form as Form2.xml and close out.
         myXDoc.SaveAs("C:\\Test\\Form2.xml");
         myXDocs.Close(0);
         myApp.Quit(false);
         Console.WriteLine("Finished!");
       }
   }
 }

 Imports Microsoft.Office.Interop.InfoPath
 Imports Microsoft.Office.Interop.InfoPath.Xml
 Module Module1
   Sub Main()
       ' Create an InfoPath Application object.
       Dim myApp As Application = _
         New Microsoft.Office.Interop.InfoPath.Application()
       ' Get a reference the XDocuments collection 
       ' and open the sample form.
       Dim myXDocs As XDocumentsCollection = myApp.XDocuments
       Dim myXDoc As XDocument = myXDocs.Open( _
         "C:\\Test\\Form1.xml", _
         XdDocumentVersionMode.xdFailOnVersionOlder)
       ' Access the XML DOM for the underlying XML document using
       ' the DOM property. Note that you must cast to the 
       ' IXMLDOMDocument2 type from the
       ' Microsoft.Office.Interop.InfoPath.Xml namespace
       ' to access the XML DOM.
       Dim myXMLDoc As IXMLDOMDocument2 = _
         DirectCast(myXDoc.DOM, IXMLDOMDocument2)
       ' Set the MSXML SelectionNamespaces property to the my
       ' namespace of the form. IMPORTANT:Replace the namespace 
       ' value below with that of your sample form.
       myXMLDoc.setProperty("SelectionNamespaces", _
 "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2006-09-06T23:17:34'")
       ' Select all instances of customerName that contain 
       ''Company A'.
       Dim myNames As IXMLDOMNodeList = _
   myXMLDoc.selectNodes("//my:customerName[. = 'Company A']")
       ' Check to determine if any nodes were returned.
       If (myNames.length < 1) Then
         Console.WriteLine( _
             "No elements containing 'Company A' were found.")
       Else
         ' Loop through the list updating to 'Company B'.
         Dim myName As IXMLDOMNode = myNames.nextNode()
         While (myName IsNot Nothing)
             myName.text = "Company B"
             myName = myNames.nextNode()
         End While
       End If
       ' Save the updated form as Form2.xml and close out.
       myXDoc.SaveAs("C:\\Test\\Form2.xml")
       myXDocs.Close(0)
       myApp.Quit(False)
       Console.WriteLine("Finished!")
   End Sub
 End Module

Cliquez sur Démarrer le débogage dans le menu Déboguer pour compiler et exécuter l’application console.

L’application ouvre le formulaire enregistré en tant que Form1.xml et effectue une boucle dans tous les éléments customerName qui contiennent la valeur Company A et remplace cette valeur par Company B. Une fois l’opération terminée, une nouvelle copie du formulaire est enregistrée en tant que Form2.xml dans le dossier C :\Test.

Automatiser l’ouverture d’un formulaire et le remplissage des valeurs de champ

L’exemple suivant automatise l’ouverture d’un formulaire vide et le remplissage des champs prénom, nom et adresse dans le formulaire. Ce scénario suppose un formulaire qui contient trois zones de texte liées à des champs nommés FirstName, LastName et Address.

Créer l’exemple de modèle de formulaire et de formulaire

Ouvrez InfoPath et créez un formulaire vide.
Ajoutez trois contrôles de zone de texte au formulaire et nommez les champs liés aux contrôles : FirstName, LastName et Address. Ajoutez les autres champs de votre choix.
Dans le volet Office Champs , cliquez avec le bouton droit sur le dossier myFields , puis cliquez sur Propriétés.
Sous l’onglet Détails , sélectionnez et copiez la valeur suivante Espace de noms :, puis collez-la dans le Bloc-notes ou à un autre emplacement où vous pouvez la récupérer. Vous aurez besoin de cette valeur ultérieurement pour définir la valeur de la propriété SelectionNamespaces dans votre code.
Publiez le modèle de formulaire dans un dossier nommé C :\Temp et acceptez le nom par défaut, Template1.
Ouvrez le modèle de formulaire et enregistrez un formulaire vide en tant que « Form1 » dans C :\Temp.

Créer une application console de code managé pour ouvrir le formulaire et remplir les champs

Ouvrez Visual Studio et créez une application console Visual C# ou Visual Basic nommée OpenForm.
Établissez des références aux assemblys d’interopérabilité principale et d’interopérabilité XML InfoPath de Microsoft Office InfoPath, comme décrit ci-dessus.

 using System;
 using System.Collections.Generic;
 using System.Text;
 using Microsoft.Office.Interop.InfoPath;
 using Microsoft.Office.Interop.InfoPath.Xml;
 namespace OpenForm
 {
   class Program
   {
       static void Main(string[] args)
       {
         // Create an InfoPath Application object.
         Application myApp=
             new Microsoft.Office.Interop.InfoPath.Application();
         // Create an InfoPath XDocument variable and open 
         // the blank form.
         XDocument myXDoc = myApp.XDocuments.Open(
             "c:\\temp\\Form1.xml",
             (int) XdDocumentVersionMode.xdFailOnVersionOlder);

         // Create an IXMLDOMDocument2 variable and access 
         // the XML DOM from the underlying XML document
         // using the DOM property of the XDocument object. 
         // Note that you must cast to IXMLDOMDocument2 to do so.
         IXMLDOMDocument2 doc= myXDoc.DOM as IXMLDOMDocument2;
         // Set the MSXML SelectionNamespaces property to the my
         // namespace of the form. IMPORTANT:Replace the namespace
         // value below with that of your sample form.
         doc.setProperty("SelectionNamespaces","xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2006-09-06T23:17:34'");
         // Pre-populate the fields with specified values.
         doc.selectSingleNode("//my:FirstName").text="My Name";
         doc.selectSingleNode("//my:LastName").text="My LastName";
         doc.selectSingleNode("//my:Address").text="My Address";
         // Save the form, leaving InfoPath open.
         myXDoc.Save();

       }
   }
 }

 Imports Microsoft.Office.Interop.InfoPath
 Imports Microsoft.Office.Interop.InfoPath.Xml
 Module Module1
   Sub Main()
       ' Create an InfoPath Application object.
       Dim myApp As Application = _
         New Microsoft.Office.Interop.InfoPath.Application
       ' Create an InfoPath XDocument variable and open 
       ' the blank form.
       Dim myXDoc As XDocument = myApp.XDocuments.Open( _
         "c:\\temp\\Form1.xml", _
         XdDocumentVersionMode.xdFailOnVersionOlder)
       ' Create an IXMLDOMDocument2 variable and access 
       ' the XML DOM from the underlying XML document
       ' using the DOM property of the XDocument object.
       Dim doc As IXMLDOMDocument2 = myXDoc.DOM
       ' Set the MSXML SelectionNamespaces property to the my
       ' namespace of the form. IMPORTANT:Replace the namespace
       ' value below with that of your sample form.
       doc.setProperty("SelectionNamespaces", "xmlns:my='http://schemas.microsoft.com/office/infopath/2003/myXSD/2006-09-06T23:17:34'")
       ' Pre-populate the fields with specified values.
       doc.selectSingleNode("//my:FirstName").text = "My Name"
       doc.selectSingleNode("//my:LastName").text = "My LastName"
       doc.selectSingleNode("//my:Address").text = "My Address"
       ' Save the form, leaving InfoPath open.
       myXDoc.Save()
   End Sub
 End Module

Dans le menu Déboguer , cliquez sur Démarrer le débogage pour compiler et exécuter l’application console.

L’application ouvre le formulaire enregistré en tant que Form1.xml et renseigne les champs FirstName, LastName et Address avec les valeurs spécifiées dans le code, puis enregistre le formulaire, en laissant InfoPath ouvert.

Partager via

Exemples et scénarios d’automatisation externe

Établissement de références aux assemblys d’interopérabilité principale et d’interopérabilité XML InfoPath De Microsoft Office

Définir une référence à l’assembly d’interopérabilité principale Microsoft.Office.Interop.InfoPath

Définir une référence à l’assembly d’interopérabilité Microsoft.Office.Interop.InfoPath.Xml

Automatiser la modification de la valeur d’un champ

Créer l’exemple de modèle de formulaire et de formulaire

Créer une application console en code managé pour remplacer le nom « Company A » par « Company B »

Automatiser l’ouverture d’un formulaire et le remplissage des valeurs de champ

Créer l’exemple de modèle de formulaire et de formulaire

Créer une application console de code managé pour ouvrir le formulaire et remplir les champs

Voir aussi

Ressources supplémentaires