Introducción

  • 5 minutos

En este módulo veremos el objeto Codeunit. Junto con las tablas y páginas, una codeunit es un objeto principal de la aplicación Microsoft Dynamics 365 Business Central.

Las codeunits agrupan diferentes procedimientos en un solo objeto. Se puede tener acceso a estos procedimientos desde otros procedimientos y desencadenadores en páginas, tablas y otras codeunits.

Una codeunit incluye los siguientes elementos:

  • Desencadenadores

  • Funciones

  • Variables

  • Propiedades

  • Instrucciones

Una codeunit solo incluye un desencadenador: OnRun. Este desencadenador siempre está disponible y se implementa al ejecutar una codeunit.

Al usar fragmentos de código (tcodeunit) para crear una codeunit con Visual Studio Code, se generará automáticamente el desencadenador OnRun.

Propiedad Access

Puede usar la propiedad Access en la codeunit para especificar la codeunit como pública o interna. Se puede llamar a una codeunit pública desde la misma extensión, pero también desde otras extensiones. Solo se puede tener acceso a una codeunit interna desde la misma extensión.

Propiedad Subtype

La propiedad Subtype tiene cinco valores disponibles:

  • Normal: el valor predeterminado de cada codeunit nueva. Este subtipo es una codeunit normal. Solo tiene un desencadenador: OnRun.

  • Instalar: este tipo de codeunit solo se ejecuta durante la instalación del paquete de extensión. Este subtipo proporciona acceso a dos desencadenadores adicionales.

  • Actualizar: este tipo de codeunit solo se ejecuta durante el proceso de actualización de un paquete de extensión. Este subtipo proporciona acceso a cinco desencadenadores adicionales.

  • Prueba: este subtipo le permite escribir funciones de prueba de la unidad. No crea funciones normales en esta codeunit, ya que solo puede ejecutarse durante las pruebas de la unidad.

  • TestRunner: este subtipo ejecuta una o varias codeunits de prueba.