Personnaliser un modèle de formulaire à l’aide d’un script

Si vous êtes familiarisé avec l’écriture de script, vous pouvez ajouter un script à votre modèle de formulaire Microsoft Office InfoPath à l’aide du langage de script Microsoft JScript ou Microsoft Visual Basic Scripting Edition (VBScript). L’ajout d’un script vous permet de personnaliser votre modèle de formulaire au-delà de ce qui est disponible avec les règles, les formules, la validation des données ou la mise en forme conditionnelle. Par exemple, vous pouvez ajouter un script qui crée et envoie un message électronique lorsqu’un utilisateur change d’affichage dans un formulaire en fonction de votre modèle de formulaire. Vous pouvez configurer un modèle de formulaire pour créer et envoyer un message électronique uniquement à l’aide d’un script.

Contenu de cet article

• Présentation
• Considérations en matière de compatibilité
• Définir le langage de script pour un modèle de formulaire
• Afficher un message chaque fois qu’un événement se produit
• Ajouter un script qui s’exécute lorsqu’un utilisateur enregistre les données du formulaire
• Ajouter un script qui s’exécute lorsqu’un utilisateur envoie les données du formulaire
• Ajouter un script qui s’exécute lorsqu’un utilisateur clique sur un bouton
• Ajouter un script qui s’exécute lorsque des formulaires existants sont fusionnés
• Ajouter un script pour mettre à jour les formulaires existants
• Ajouter un script pour d’autres événements

Vue d’ensemble

Vous pouvez personnaliser votre modèle de formulaire InfoPath à l’aide de règles, de formules, de validation des données et de mise en forme conditionnelle. Bien que ces fonctionnalités soient très flexibles et puissent gérer une grande variété de tâches, certaines tâches dépassent les capacités de ces fonctionnalités. Par exemple, vous ne pouvez pas utiliser de règles pour envoyer un message électronique lorsqu’un utilisateur entre une valeur dans une zone de texte d’un formulaire. Si vous avez besoin de personnaliser votre modèle de formulaire d’une manière qui dépasse les fonctionnalités de ces fonctionnalités et que vous êtes familiarisé avec l’écriture de scripts à l’aide du langage de script JScript ou VBScript, vous pouvez ajouter un script qui s’exécute lorsqu’un utilisateur ouvre un nouveau formulaire ou modifie un formulaire existant basé sur votre modèle de formulaire.

Lorsque vous ajoutez un script à un modèle de formulaire, InfoPath démarre l’Microsoft Script Editor (MSE), ce qui vous permet d’ajouter, de modifier et de déboguer un script dans un modèle de formulaire et place le curseur dans l’événement que vous avez choisi. InfoPath ajoute automatiquement un gestionnaire d’événements au script. Un gestionnaire d’événements est le code de fonction dans un modèle de formulaire InfoPath qui répond à une action de l’utilisateur ou à une modification des données XML d’un formulaire. Par exemple, si vous souhaitez que vos utilisateurs enregistrent leurs formulaires dans plusieurs emplacements réseau, vous pouvez ajouter un script au gestionnaire d’événements OnSaveRequest . Lorsque vous ajoutez un script à exécuter lorsque l’utilisateur enregistre un formulaire basé sur votre modèle de formulaire, InfoPath démarre l’éditeur de script et ajoute l’un des codes suivants au script.

JScript

//=======
// The following function handler is created by Microsoft Office InfoPath.
// Do not modify the name of the function, or the name and number of arguments.
//=======
function XDocument::OnSaveRequest(eventObj)
{
   // Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation();
   // Write the code to be run after saving here.
   eventObj.ReturnStatus = true;
}

Vbscript

'=======
' The following function handler is created by Microsoft Office InfoPath.
' Do not modify the name of the function, or the name and number of arguments.
'=======
Sub XDocument_OnSaveRequest(eventObj)
' Write the code to be run before saving here.
eventObj.IsCancelled = eventObj.PerformSaveOperation
' Write the code to be run after saving here.
eventObj.ReturnStatus = True
End Sub

Vous pouvez ensuite ajouter du code aux emplacements appropriés dans le gestionnaire d’événements qui enregistre le formulaire à l’emplacement réseau différent. Lorsqu’un utilisateur enregistre un formulaire basé sur ce modèle de formulaire, InfoPath exécute le code dans le gestionnaire d’événements OnSaveRequest .

InfoPath ajoute automatiquement des gestionnaires d’événements pour tous les événements sauf l’un des événements suivants.

Haut de la page

Considérations en matière de compatibilité

Vous ne pouvez pas ajouter de script à un modèle de formulaire compatible avec le navigateur. Vous pouvez ajouter un script uniquement à un modèle de formulaire dont les formulaires seront remplis dans InfoPath. Vous pouvez personnaliser un modèle de formulaire compatible avec le navigateur uniquement à l’aide de code managé.

Haut de la page

Définir le langage de script pour un modèle de formulaire

Pour personnaliser un modèle de formulaire à l’aide d’un script, vous pouvez utiliser Microsoft JScript ou Microsoft Visual Basic Scripting Edition (VBScript). Par défaut, InfoPath est configuré pour ajouter un script à l’aide de JScript. Si votre modèle de formulaire ne contient pas de script ou de code managé et que vous préférez utiliser VBScript comme langage de script, vous pouvez remplacer le langage de script de votre modèle de formulaire par VBScript. Vous ne pouvez pas utiliser les deux langages de script dans le même modèle de formulaire.

Si le modèle de formulaire contient déjà un script dans une langue et que vous souhaitez utiliser l’autre langage, vous devez enregistrer le script existant afin de pouvoir convertir le script dans l’autre langue, supprimer le script du modèle de formulaire via la boîte de dialogue Options de formulaire, puis rajouter le script converti au modèle de formulaire. InfoPath ne peut pas convertir des scripts en un nouveau langage de script. La modification de la langue de script dans la boîte de dialogue Options de formulaire affecte uniquement ce modèle de formulaire. Les autres modèles de formulaire auront JScript comme langage de script par défaut.

1. Dans le menu Outils , cliquez sur Options de formulaire.

2. Dans la liste Catégorie , dans la boîte de dialogue Options de formulaire , cliquez sur Programmation.

3. Dans la liste Langage du code du modèle de formulaire , sous Langage de programmation, cliquez sur VBScript.

   Remarque

   • Après avoir défini la langue de script et créé un ou plusieurs gestionnaires d’événements pour un modèle de formulaire, vous ne pouvez pas modifier la langue de script du modèle de formulaire.
   • Si vous avez installé Microsoft Visual Studio 2005 Tools for Applications, le langage par défaut est Microsoft Visual Basic .NET. Vous pouvez toujours utiliser cette procédure pour remplacer le langage de script par VBScript.

Haut de la page

Afficher un message chaque fois qu’un événement se produit

Si vous souhaitez savoir quels gestionnaires d’événements s’exécutent en réponse à une action ou à un autre événement, vous pouvez ajouter du code temporaire pour afficher une boîte de message chaque fois que le gestionnaire d’événements s’exécute. Vous devez utiliser ce code uniquement pour déterminer quand un gestionnaire d’événements s’exécute. Après avoir ajouté ce code, vous pouvez utiliser l’aperçu pour afficher un formulaire basé sur ce modèle de formulaire ou pour publier le modèle de formulaire, puis créer un nouveau modèle de formulaire. Certains gestionnaires d’événements s’exécutent uniquement si vous créez un formulaire après avoir publié le modèle de formulaire. Vous pouvez ensuite effectuer une action susceptible d’exécuter le gestionnaire d’événements. Lorsque le gestionnaire d’événements s’exécute, une boîte de message s’affiche.

Une fois que vous avez déterminé les actions ou événements qui exécutent le gestionnaire d’événements, supprimez le code, puis reprenez la conception du modèle de formulaire. Si vous ne supprimez pas ce code et que vous publiez ensuite le modèle de formulaire, vos utilisateurs verront cette boîte de message lorsque le gestionnaire d’événements s’exécute.

1. Ajoutez votre gestionnaire d’événements.

2. Pour ajouter du code dans JScript, tapez XDocument.UI.Alert(« The Event name event just ran ») ; Remplacez par le nom de votre gestionnaire d’événements. Par exemple, si vous ajoutez ce code au gestionnaire d’événements OnValidate , vous devez taper XDocument.UI.Alert(« Le gestionnaire d’événements OnValidate vient d’être exécuté ») ;

3. Pour ajouter du code dans VBScript, tapez XDocument.UI.Alert(« The Event name event just ran ») Par exemple, si vous ajoutez ce code au gestionnaire d’événements OnSaveRequest , vous devez taper XDocument.UI.Alert(« Le gestionnaire d’événements OnSaveRequest vient d’être exécuté »)

4. Pour tester le code, cliquez sur Aperçu dans le menu Fichier , ou appuyez sur Ctrl+Maj+B, puis effectuez une action utilisateur qui peut démarrer l’événement. Lorsque l’événement avec la ligne de code se produit, une boîte de message doit afficher votre message.

   Remarque

   Certains événements peuvent nécessiter la publication du modèle de formulaire, puis la création d’un formulaire basé sur ce modèle de formulaire avant de pouvoir effectuer une action utilisateur pour démarrer l’événement.

5. Avant de publier le modèle de formulaire et de permettre à vos utilisateurs de remplir des formulaires basés sur ce modèle de formulaire, supprimez le code que vous avez utilisé pour afficher la boîte de message.

Haut de la page

Ajouter un script qui s’exécute lorsqu’un utilisateur enregistre les données du formulaire

1. Dans le menu Outils , cliquez sur Options de formulaire.

2. Dans la liste Catégorie , dans la boîte de dialogue Options de formulaire , cliquez sur Ouvrir et enregistrer.

3. Sous Enregistrer le comportement, sélectionnez la zone Enregistrer à l’aide d’un code personnalisé case activée, puis cliquez sur Modifier. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements OnSaveRequest.
   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSaveRequest(eventObj)
   {
      // Write the code to be run before saving here.
      eventObj.IsCancelled = eventObj.PerformSaveOperation();
      // Write the code to be run after saving here.
      eventObj.ReturnStatus = true;
   }
   
   

   Vbscript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSaveRequest(eventObj)
   ' Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation
   ' Write the code to be run after saving here.
   eventObj.ReturnStatus = True
   End Sub
   
   

4. Effectuez l’une des actions suivantes, ou les deux :

   • Pour ajouter un script qui s’exécute avant qu’InfoPath enregistre le formulaire, remplacez le commentaire Write the code to be run before saving here.par votre code.
   • Pour ajouter un script qui s’exécute après l’enregistrement du formulaire par InfoPath, remplacez le commentaire Write the code to be run after saving here. par votre code.

5. Pour tester vos modifications, cliquez sur Aperçu dans la barre d’outils Standard, ou appuyez sur Ctrl+Maj+B.

   Remarque

   Si le gestionnaire d’événements s’exécute uniquement après avoir créé un formulaire basé sur votre modèle de formulaire, publiez le modèle de formulaire en cliquant sur Publier dans le menu Fichier , puis terminez l’Assistant Publication. Après avoir publié le modèle de formulaire, créez un formulaire, puis effectuez une action pour exécuter le gestionnaire d’événements.

Haut de la page

Ajouter un script qui s’exécute lorsqu’un utilisateur envoie les données du formulaire

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

2. Dans la boîte de dialogue Options d’envoi, sélectionnez la zone Autoriser les utilisateurs à envoyer ce formulaire case activée.

3. Cliquez sur Effectuer une action personnalisée à l’aide du code, puis cliquez sur Modifier le code. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements OnSubmitRequest.
   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSubmitRequest(eventObj)
   {
      // If the submit operation is successful, set
      // eventObj.ReturnStatus = true;
      // Write your code here
   }
   
   

   Vbscript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSubmitRequest(eventObj)
   ' If the submit operation is successful, set
   ' eventObj.ReturnStatus = True
   ' Write your code here
   End Sub
   
   

4. Remplacez le commentaire If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here par votre code.

5. Pour tester vos modifications, cliquez sur Aperçu dans la barre d’outils Standard, ou appuyez sur Ctrl+Maj+B.

Haut de la page

Ajouter un script qui s’exécute lorsqu’un utilisateur clique sur un bouton

1. Ajoutez un nouveau bouton à une vue dans le modèle de formulaire, puis double-cliquez sur le bouton.

   Remarque

   Si vous ajoutez un script à un bouton existant, double-cliquez sur le bouton existant à la place.

2. Cliquez sur l’onglet Général.

3. Cliquez sur Modifier le code du formulaire. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements OnClick pour ce bouton.
   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function Button Name::OnClick(eventObj)
   {
   // Write your code here
   }
   
   

   Vbscript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub Button Name_OnClick(eventObj)
   ' Write your code here
   End Sub
   
   

4. Remplacez le commentaire Write your code here par votre code.

5. Pour tester vos modifications, cliquez sur Aperçu dans la barre d’outils Standard, ou appuyez sur Ctrl+Maj+B.

Haut de la page

Ajouter un script qui s’exécute lorsque des formulaires existants sont fusionnés

1. Dans le menu Outils , cliquez sur Options de formulaire.

2. Dans la liste Catégorie , dans la boîte de dialogue Options de formulaire , cliquez sur Avancé.

3. Sous Fusionner les formulaires, sélectionnez la zone Activer la fusion de formulaires case activée.

4. Sélectionnez la zone Fusionner à l’aide d’un code personnalisé case activée, puis cliquez sur Modifier. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements OnMergeRequest.
   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnMergeRequest(eventObj)
   {
   // Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM);
   eventObj.ReturnStatus = true;
   }
   
   

   Vbscript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnMergeRequest(eventObj)
   ' Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM)
   eventObj.ReturnStatus = True
   End Sub
   
   

5. Remplacez le commentaire Write the code that handles each form being merged here. par votre code.

6. Pour tester le code dans cet événement, publiez le modèle de formulaire, créez plusieurs formulaires basés sur ce modèle de formulaire, puis fusionnez les modèles de formulaire.

   Remarque

   Vous trouverez des liens vers plus d’informations sur la publication de votre modèle de formulaire dans la section Voir aussi .

Haut de la page

Ajouter un script pour mettre à jour les formulaires existants

Si vous avez mis à jour un modèle de formulaire précédemment publié et que vous souhaitez mettre à jour les formulaires existants en fonction de ce modèle de formulaire, vous pouvez ajouter un script au modèle de formulaire mis à jour qui s’exécute lorsqu’un utilisateur ouvre l’un des formulaires existants. Lorsqu’un utilisateur ouvre un formulaire existant, InfoPath vérifie le numéro de version de son modèle de formulaire associé à l’emplacement de publication. Si le numéro de version du modèle de formulaire à l’emplacement de publication est plus récent que le numéro de version du formulaire existant, indiquant qu’il a été mis à jour, InfoPath exécute le code dans cet événement pour mettre à jour le formulaire existant.

1. Dans le menu Outils , cliquez sur Options de formulaire.

2. Dans la liste Catégorie , dans la boîte de dialogue Options de formulaire , cliquez sur Contrôle de version.

3. Dans la liste Sur la mise à niveau de version , cliquez sur Utiliser l’événement personnalisé, puis sur Modifier. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements OnVersionUpgrade.
   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnVersionUpgrade(eventObj)
   {
   // Write your code here
   }
   
   

   Vbscript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnVersionUpgrade(eventObj)
   ' Write your code here
   End Sub
   
   

4. Remplacez le commentaire Write your code here par votre code.

5. Pour tester le code dans cet événement, publiez le modèle de formulaire, créez plusieurs formulaires basés sur ce modèle de formulaire, modifiez et publiez une version mise à jour du modèle de formulaire, puis ouvrez un formulaire existant basé sur l’ancienne version de ce modèle de formulaire.

   Remarque

   Vous trouverez des liens vers plus d’informations sur la publication de votre modèle de formulaire dans la section Voir aussi .

Haut de la page

Ajouter un script pour d’autres événements

Cette procédure peut être utilisée pour ajouter les gestionnaires d’événements suivants à votre modèle de formulaire :

• OnAfterChange
• OnBeforeChange
• OnContextChange
• Onload
• OnSwitchView
• OnSign
• OnValidate
• Dans le menu Outils , pointez sur Programmation, puis cliquez sur l’événement à ajouter au gestionnaire d’événements. Le Microsoft Script Editor commence par le curseur au niveau du gestionnaire d’événements que vous avez sélectionné.
• Remplacez le commentaire Write your code here par votre code.

Haut de la page