Introduzione

Completato

Questo modulo contiene informazioni sull'oggetto Codeunit. Insieme a tabelle e pagine, una codeunit è un oggetto di base dell'applicazione Microsoft Dynamics 365 Business Central.

Gli oggetti codeunit raggruppano procedure diverse in un unico oggetto. È possibile accedere a queste procedure da altri trigger e procedure in pagine, tabelle e altre codeunit.

Un oggetto codeunit contiene i seguenti elementi:

  • Trigger

  • Funzioni

  • Variabili

  • Proprietà

  • Istruzioni

Una codeunit contiene un solo trigger: OnRun. Questo trigger è sempre disponibile e viene implementato quando si esegue una codeunit.

Usando i frammenti di codice (tcodeunit) per creare una codeunit con Visual Studio Code, il trigger OnRun viene generato automaticamente.

Proprietà Access

È possibile usare la proprietà Access nella codeunit per specificare la codeunit come pubblica o interna. Una codeunit pubblica può essere chiamata all'interno della stessa estensione ma anche da altre estensioni. A una codeunit interna è possibile accedere solo dall'interno della stessa estensione.

Proprietà Subtype

La proprietà Subtype ha cinque valori disponibili:

  • Normal - Valore predefinito per ogni nuova codeunit. Questo sottotipo indica una codeunit normale. È presente un solo trigger: OnRun.

  • Install - Questo tipo di codeunit viene eseguito soltanto durante l'installazione del pacchetto di estensione. Questo sottotipo fornisce l'accesso a due trigger aggiuntivi.

  • Upgrade - Questo tipo di codeunit viene eseguito soltanto durante il processo di aggiornamento di un pacchetto di estensione. Questo sottotipo fornisce l'accesso a cinque trigger aggiuntivi.

  • Test - Questo sottotipo consente di scrivere funzioni di unit test. In questa codeunit non si creano funzioni normali perché può essere eseguita solo durante gli unit test.

  • TestRunner - Questo sottotipo esegue una o più codeunit di test.