Présentation

  • 5 minutes

Dans ce module, vous découvrirez l’objet Codeunit. Avec les tables et les pages, un codeunit est un objet central de l’application Microsoft Dynamics 365 Business Central.

Les codeunits regroupent différentes procédures en un seul objet. Ces procédures sont accessibles à partir d’autres procédures et déclencheurs sur des pages, des tables et d’autres codeunits.

Un codeunit contient les éléments suivants :

  • Déclencheurs

  • Fonctions

  • Variables

  • Propriétés

  • Instructions

Un codeunit ne contient qu’un seul déclencheur : OnRun. Ce déclencheur est toujours disponible et est mis en œuvre lorsque vous exécutez un codeunit.

En utilisant les extraits de code (tcodeunit) pour créer un codeunit avec Visual Studio Code, le déclencheur OnRun est généré automatiquement.

Propriété Access

Vous pouvez utiliser la propriété Access sur le codeunit pour spécifier votre codeunit comme public ou internal. Un codeunit public peut être appelé au sein de la même extension mais également à partir d’autres extensions. Un codeunit interne n’est accessible qu’à partir de la même extension.

Propriété Subtype

La propriété Subtype a cinq valeurs disponibles :

  • Normal : la valeur par défaut pour chaque nouveau codeunit. Ce sous-type est un codeunit régulier. Il n’a qu’un seul déclencheur : OnRun.

  • Install : ce type de codeunit est exécuté uniquement lors de l’installation du package d’extension. Ce sous-type donne accès à deux déclencheurs supplémentaires.

  • Upgrade : ce type de codeunit est exécuté uniquement lors du processus de mise à niveau du package d’extension. Ce sous-type donne accès à cinq déclencheurs supplémentaires.

  • Test : ce sous-type vous permet d’écrire des fonctions de test unitaire. Vous ne créez pas de fonctions normales dans ce codeunit, car il ne peut s’exécuter que pendant les tests unitaires.

  • TestRunner : ce sous-type exécute un ou plusieurs codeunits de test.