Les procédures peuvent être de deux types :

• Procédure globale : utilisable dans tous les traitements du projet. Cette procédure globale est mémorisée dans le projet.
• Procédure locale : utilisable dans tous les traitements dépendant de l'objet (fenêtre, page, état, champ) dans lequel cette procédure a été déclarée. Cette procédure locale est mémorisée dans l'objet.

• En WLangage, il n'existe pas de distinction entre les procédures et les fonctions. Les syntaxes de déclaration et d'utilisation décrites pour les procédures sont les mêmes pour les fonctions.
• Il est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype.

Création depuis l'éditeur de code

Pour créer une procédure globale depuis l'éditeur de code :

• Méthode 1 :
  1. Affichez l'éditeur de code (touche F2 sur un élément de votre fenêtre ou de votre page).
  2. Sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure globale" (raccourci clavier Shift F4).
  3. Indiquez le nom de la collection de procédures contenant la procédure globale et validez.
     Remarque : Si le projet contient déjà une collection de procédure, il est possible de sélectionner la collection de procédures existante.
  4. Dans la fenêtre qui s'affiche :
     • Indiquez le nom de la procédure globale à créer.
     • L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure.
       Pour plus de détails, consultez Documentation automatique des procédures.
     • Indiquez la portée de la procédure (visibilité). Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure globale publique ou privée.
     • Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini".
  5. Validez. L'éditeur de code affiche le code de la procédure qui vient d'être créée.
  Remarque : Il est également possible d'utiliser l'option "Nouveau .. Nouvelle procédure globale vide" du menu contextuel d'une ligne de code.
• Méthode 2 :
  1. Affichez l'éditeur de code (touche F2 sur un élément de votre fenêtre ou de votre page).
  2. Positionnez-vous à la fin du code d'une procédure globale.
  3. Tapez le prototype de la procédure à créer.
  4. Validez. La procédure est automatiquement créée.

Pour transformer une partie de code déjà saisi dans une procédure globale en une procédure globale :

1. Sélectionnez le code correspondant.
2. Utilisez l'option "Nouveau .. Créer une procédure globale contenant le code sélectionné" du menu contextuel.
3. Saisissez le nom de la nouvelle collection de procédures ou sélectionnez la collection de procédures utilisée.
4. Dans la fenêtre qui s'affiche :
   • Indiquez le nom de la procédure globale à créer.
   • L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure.
     Pour plus de détails, consultez Documentation automatique des procédures.
   • Indiquez la portée de la procédure (visibilité). Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure globale publique ou privée.
   • Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini".
5. Validez. La procédure est créée, le code correspondant est remplacé par l'appel de la procédure avec les paramètres nécessaires.

Création depuis le volet "Explorateur de projet"

Pour créer une procédure globale depuis le volet "Explorateur de projet" :

1. Sélectionnez le dossier "Procédures".
2. Choisissez la collection de procédure dans laquelle la procédure doit être créée :
   • Créez si nécessaire une nouvelle collection de procédures (option "Nouveau" du dossier "Procédures").
   • Sélectionnez la collection de procédures voulue.
     
3. Dans le menu contextuel de la collection de procédures, sélectionnez l'option "Nouvelle procédure globale".
4. Dans la fenêtre qui s'affiche :
   • Indiquez le nom de la nouvelle procédure globale.
   • L'option "Générer un commentaire d'en-tête" permet de générer automatiquement le commentaire du prototype de la procédure.
     Pour plus de détails, consultez Documentation automatique des procédures.
   • Indiquez la portée de la procédure (visibilité). Par défaut, la procédure créée est publique. Pour plus de détails, consultez le paragraphe Procédure globale publique ou privée.
   • Indiquez le rôle de la procédure : Non défini, Métier, UI. Par défaut, une procédure a un rôle "Non défini".
5. Validez.

Afficher la liste des procédures globales

Pour afficher la liste des procédures globales, utilisez la combinaison de touches Ctrl + F8 de l'éditeur de code.

Suppression depuis le volet "Explorateur de projet"

Pour supprimer une procédure globale depuis le volet "Explorateur de projet" :

1. Sélectionnez le dossier "Procédures".
2. Sélectionnez la collection de procédures voulue.
3. Sélectionnez la procédure globale voulue.
4. Affichez le menu contextuel de la procédure et sélectionnez l'option "Supprimer".

Depuis l'éditeur de code

Pour tester une procédure globale :

1. Affichez la procédure globale sous l'éditeur de code.
2. Cliquez sur le bouton "GO" présent parmi les boutons d'accès rapide.
3. La fenêtre de description du test de la procédure s'affiche. Cette fenêtre permet de :
   • Saisir les différents paramètres de la procédure.
   • Lancer le test de la procédure (bouton "Tester la procédure").
   • Vérifier la valeur de retour.

Depuis le volet "Explorateur de projet"

Pour tester une procédure globale :

1. Sélectionnez le dossier "Procédures" dans le volet "Explorateur de projet".
2. Sélectionnez le nom de la procédure globale à tester.
3. Sélectionnez l'option "Tester la procédure" du menu contextuel.
4. La fenêtre de description du test de la procédure s'affiche. Cette fenêtre permet de :
   • Saisir les différents paramètres de la procédure.
   • Lancer le test de la procédure (bouton "Tester la procédure").
   • Vérifier la valeur de retour.

Une procédure globale est publique par défaut : elle est accessible depuis n'importe quel code.

1. Sélectionnez la procédure globale dans le volet "Explorateur de projet".
2. Dans le menu contextuel de la procédure, sélectionnez le nouveau mode d'accès :
   • publique.
   • privé.

La couleur du bandeau de la procédure change en fonction de son mode d'accès :

• début de bandeau rouge : procédure privée.
• début de bandeau habituel : procédure publique.

Remarque : Composant externe et procédures globales privées :
L'utilisation de procédures globales privées ou publiques a un impact notamment dans les composants externes. En effet, seules les procédures explicitement privées (utilisant le mot-clé PRIVEE dans leur prototype) présentes dans un composant externe ne pourront pas être utilisées directement par le projet intégrant ce composant.