Personnaliser un modèle de formulaire en utilisant un script

Contenu de cet article

• Vue d’ensemble

• Considérations relatives à la 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 lors de la fusionnent de formulaires existants

• Ajouter un script pour mettre à jour les formulaires existants

• Ajouter un script pour d’autres événements

Présentation

Vous pouvez personnaliser votre modèle de formulaire InfoPath à l’aide de règles, les formules, la validation des données et mise en forme conditionnelle. Bien que ces fonctionnalités sont très flexibles et peuvent gérer un large éventail de tâches, certaines tâches sont au-delà des capacités de ces fonctionnalités. Par exemple, vous ne pouvez pas utiliser des règles pour envoyer un message électronique lorsqu’un utilisateur entre une valeur dans une zone de texte dans un formulaire. Si vous avez besoin personnaliser votre modèle de formulaire d’une manière qui se trouve au-delà des capacités de ces fonctionnalités et que vous êtes habitué à l’écriture de scripts en utilisant le 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 ex formulaire istant basé sur votre modèle de formulaire.

Lorsque vous ajoutez un script à un modèle de formulaire, InfoPath démarre le Microsoft Script Editor (MSE), qui vous permet d’ajouter, modifier et déboguer le script dans un modèle de formulaire et place le curseur dans votre événement choisi. InfoPath ajoute automatiquement un gestionnaire d’événements au script. Un gestionnaire d’événements est le code de la fonction dans un modèle de formulaire InfoPath qui répond à une action utilisateur ou une modification de données XML dans un formulaire. Par exemple, si vous souhaitez que vos utilisateurs enregistrent leurs formulaires sur 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 un des codes suivants au script.

//=======
// 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;
}

'=======
' 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

Considérations en matière de compatibilité

Vous ne pouvez pas ajouter de script à un modèle de formulaire compatible avec les navigateurs web. Vous pouvez ajouter le script uniquement à un modèle de formulaire dont les formulaires sont remplis dans InfoPath. Vous pouvez personnaliser un modèle de formulaire compatible avec le navigateur uniquement à l’aide du 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 en utilisant le 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 modifier le langage de script pour votre modèle de formulaire à 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 voulez utiliser l’autre langue, vous devez enregistrer le script existant afin que vous pouvez convertir le script à l’autre langue, supprimez le script à partir du modèle de formulaire via les Options du formulaire boîte de dialogue zone et ajoutez le script converti le modèle de formulaire. InfoPath Impossible de convertir les scripts une nouvelle langue d’écriture de script. Modifier le langage de script dans la boîte de dialogue Options de formulaire n’affecte que ce modèle de formulaire. 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 de code de modèle de formulaire, sous le langage de programmation, cliquez sur VBScript.

   Remarques : 

   • Après avoir défini le langage de script et créer un ou plusieurs gestionnaires d’événements pour un modèle de formulaire, vous ne pouvez pas modifier le langage de script du modèle de formulaire.

   • Si vous avez installé Microsoft Visual Studio 2005 Tools for Applications, la langue par défaut est Microsoft Visual Basic .NET. Vous pouvez toujours utiliser cette procédure pour changer la langue d’écriture de script VBScript.

Haut de la Page

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

Si vous voulez connaître les gestionnaires d’événements qui s’exécutent en réponse à une action ou un autre événement, vous pouvez ajouter un code temporaire pour afficher un message à chaque fois que le Gestionnaire d’événements s’exécute. Vous devez utiliser ce code uniquement pour savoir 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 et créez un nouveau modèle de formulaire. Certains gestionnaires d’événements s’exécutent uniquement si vous créez un formulaire une fois que vous publiez le modèle de formulaire. Vous pouvez ensuite effectuer une action que vous pensez qu’elle lancera le Gestionnaire d’événements. Lorsque le Gestionnaire d’événements s’exécute, vous voyez une zone de message.

Une fois que vous déterminez quelles actions ou événements exécutent le Gestionnaire d’événements, supprimez le code et puis reprenez la création du modèle de formulaire. Si vous ne supprimez pas ce code et que vous publiez 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 ( » de l’événement événement nom venez d’exécuter ») ; Remplacez le nom de votre gestionnaire d’événements. Par exemple, si vous ajoutez ce code au gestionnaire d’événements OnValidate , vous taperez XDocument.UI.Alert (« The OnValidate Gestionnaire d’événements venez d’exécuter ») ;

3. Pour ajouter du code dans VBScript, tapez XDocument.UI.Alert ( » de l’événement événement nom venez d’exécuter ») , par exemple, si vous ajoutez ce code au gestionnaire d’événements OnSaveRequest , vous taperez XDocument.UI.Alert (« The OnSaveRequest Gestionnaire d’événements venez d’exécuter »)

4. Pour tester le code, cliquez sur Aperçu dans le menu fichier, ou appuyez sur CTRL + MAJ + B, puis exécuter une action utilisateur qui peut démarrer l’événement. En cas de l’événement avec la ligne de code, une zone de message doit afficher votre message.

   Remarque : Certains événements peuvent nécessiter vous publier le modèle de formulaire, puis créer un formulaire basé sur ce modèle de formulaire avant de pouvoir effectuer une action de l’utilisateur pour lancer l’événement.

5. Avant de publier le modèle de formulaire et permettre à vos utilisateurs à 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 comportement à l’enregistrement, activez la case à cocher Enregistrer au moyen d’un code personnalisé, puis cliquez sur Modifier. Microsoft Script Editor démarre avec le curseur au 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 que InfoPath enregistre le formulaire, 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 et puis terminez l’Assistant Publication. Une fois que vous publiez le modèle de formulaire, créer un formulaire, puis effectuez une action pour lancer 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, activez la case à cocher Autoriser les utilisateurs à envoyer ce formulaire.

3. Cliquez sur effectuer une action personnalisée à l’aide de Code, puis cliquez sur Modifier le Code. Microsoft Script Editor démarre avec le curseur au 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. Ajouter 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.

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

3. Cliquez sur Modifier le Code du formulaire. Microsoft Script Editor démarre avec le curseur au gestionnaire d’événements OnClick de 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 lors de la fusionnent de formulaires existants

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, activez la case à cocher Activer la fusion de formulaires.

4. Activez la case à cocher Fusionner à l’aide de code personnalisé, puis cliquez sur Modifier. Microsoft Script Editor démarre avec le curseur sur le 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 ce cas, publier le modèle de formulaire, créez plusieurs formulaires basés sur ce modèle de formulaire, puis de fusionner les modèles de formulaire.

   Remarque : Vous trouverez des liens vers des informations supplémentaires 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 mis à jour un modèle de formulaire publié précédemment et que vous souhaitez mettre à jour les formulaires existants basés sur ce modèle de formulaire, vous pouvez ajouter le script dans le modèle de formulaire mis à jour qui s’exécute lorsqu’un utilisateur ouvre une des formes existantes. Lorsqu’un utilisateur ouvre un formulaire existant, InfoPath vérifie le numéro de version du modèle de formulaire à 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 dans le 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 le contrôle de version.

3. Dans la liste sur une version mise à niveau, cliquez sur utiliser un événement personnalisé, puis cliquez sur Modifier. Microsoft Script Editor démarre avec le curseur sur le 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, modifier et publier une version mise à jour du modèle de formulaire et ouvrez un formulaire existant en fonction de l’ancienne version de ce modèle de formulaire.

   Remarque : Vous trouverez des liens vers des informations supplémentaires 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. Microsoft Script Editor démarre avec le curseur sur le Gestionnaire d’événements que vous avez sélectionné.

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

Haut de la Page