Procédures personnalisées

  • 7 minutes

Voici les raisons de la création de procédures personnalisées :

  • Organiser le programme

  • Créer un code auto-explicatif

  • Simplifier le processus de développement

  • Rendre le code réutilisable, ce qui réduit le travail

  • Réduire les erreurs

  • Faciliter les modifications

  • Réduire la taille des objets

Une procédure est un composant nommé d’un programme. Vous pouvez regrouper plusieurs lignes, leur donner un nom, puis appeler ce bloc de code par son nom.

L’extrait de code tprocedure vous permet de créer une procédure personnalisée.

local procedure MyProcedure()
begin
   // Some logic goes here.
end;

Une procédure, qu’elle soit personnalisée ou existante, peut être appelée depuis des expressions ou instructions.

Appel de procédure depuis une expression

Dans l’exemple suivant, la procédure personnalisée CalculatePrice est appelée depuis une expression qui multiplie le prix calculé par une certaine quantité. La procédure CalculatePrice exécute une logique de calcul et renvoie le résultat sous forme décimale.

trigger OnRun()
begin
  TotalCost := Quantity * CalculatePrice();
end;

procedure CalculatePrice() : Decimal
begin
   // Some calculation logic goes here.
end;

Appel de procédure depuis une instruction

Dans l’exemple suivant, la procédure personnalisée MyCustomFunction est appelée depuis une instruction.

trigger OnRun()
begin
  if Quantity > 5 then
    MyCustomFunction();
end;

procedure MyCustomFunction()
begin
   // Some logic goes here.
end;

Fonction GuiAllowed

Lors de la création de procédures personnalisées, vous devez envisager d’utiliser la fonction GuiAllowed. Cette fonction vous permet de déterminer quand certains composants de votre code doivent être exécutés, selon qu’une interface graphique utilisateur (GUI) est disponible ou non.

Une interface utilisateur n’est pas utilisée lorsque votre code est exécuté par un service web. Si votre code attend une entrée utilisateur ou affiche un message, cela entraîne une erreur. La fonction GuiAllowed vous permet de tester si une GUI est disponible ou non avant de demander une entrée utilisateur.

if GuiAllowed then
   Message('Hello');

Cette fonction est utilisée dans Business Central lorsque votre procédure peut être appelée au moyen du service API.