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.
• Versions 16 et supérieures
  Il est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype.
  Nouveauté 16
  Il est possible de créer des procédures multisyntaxes. Pour plus de détails, consultez Surcharge de prototype.
  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 :
  • Sous le volet "Code", dans le groupe "Procédures", déroulez "Nouveau" et sélectionnez "Nouvelle procédure globale" (raccourci clavier Shift F4).
  • Dans la fenêtre qui s'affiche :
    • Indiquez le nom de la procédure à créer.
    • Versions 21 et supérieures
      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.
      Nouveauté 21
      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.
      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.
    • Versions 19 et supérieures
      Indiquez la portée de la procédure. 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.
      Nouveauté 19
      Indiquez la portée de la procédure. 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 la portée de la procédure. 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.
• Méthode 2 :
  • Sélectionnez l'option "Nouveau .. Nouvelle procédure globale vide" du menu contextuel.
  • Dans la fenêtre qui s'affiche :
    • Indiquez le nom de la procédure à créer.
    • Versions 21 et supérieures
      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.
      Nouveauté 21
      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.
      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.
    • Versions 19 et supérieures
      Indiquez la portée de la procédure. 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.
      Nouveauté 19
      Indiquez la portée de la procédure. 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 la portée de la procédure. 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.
• Versions 22 et supérieures
  Méthode 3 :

  • Positionnez-vous à la fin du code d'une procédure.
  • Tapez le prototype de la procédure à créer.
  • Validez. La procédure est automatiquement créé.
  Nouveauté 22
  Méthode 3 :

  • Positionnez-vous à la fin du code d'une procédure.
  • Tapez le prototype de la procédure à créer.
  • Validez. La procédure est automatiquement créé.
  Méthode 3 :
  • Positionnez-vous à la fin du code d'une procédure.
  • Tapez le prototype de la procédure à créer.
  • Validez. La procédure est automatiquement créé.

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. Indiquez :
   • le nom de la procédure.
   • Versions 19 et supérieures
     la portée de la procédure. 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.
     Nouveauté 19
     la portée de la procédure. 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.
     la portée de la procédure. 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.
4. 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. Sélectionnez la collection de procédures voulue.
3. Affichez le menu contextuel de la collection de procédures et 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.
   • Versions 21 et supérieures
     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.
     Nouveauté 21
     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.
     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.
   • Versions 19 et supérieures
     Indiquez la portée de la procédure. 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.
     Nouveauté 19
     Indiquez la portée de la procédure. 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 la portée de la procédure. 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.
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. Affichez le menu contextuel de la collection de procédures 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.