Einführung

  • 5 Minuten

In diesem Modul wird das Objekt Codeunit behandelt. Eine Codeunit ist neben Tabellen und Seiten ein Kernobjekt der Microsoft Dynamics 365 Business Central-Anwendung.

Codeunits gruppieren verschiedene Prozeduren in einem Objekt. Auf diese Prozeduren kann über andere Prozeduren und Trigger auf Seiten, Tabellen und anderen Codeunits zugegriffen werden.

Eine Codeunit enthält die folgenden Elemente:

  • Trigger

  • Funktionen

  • Variablen

  • Eigenschaften

  • Anweisungen

Eine Codeunit enthält nur einen Trigger: OnRun. Dieser Trigger ist immer verfügbar und wird implementiert, wenn Sie eine Codeunit ausführen.

Durch Verwendung der Codeausschnitte (tcodeunit) zum Erstellen einer Codeunit mit Visual Studio Code, wird der Trigger OnRun automatisch generiert.

Eigenschaft „Access“

Sie können die Eigenschaft Access in der Codeunit verwenden, um Ihre Codeunit als öffentlich oder intern anzugeben. Eine öffentliche Codeunit kann innerhalb derselben Erweiterung, aber auch innerhalb anderer Erweiterungen aufgerufen werden. Auf eine interne Codeunit kann nur innerhalb derselben Erweiterung zugegriffen werden.

Eigenschaft „Subtype“

Die Eigenschaft Subtyp hat fünf verfügbare Werte:

  • Normal – Der Standardwert für jede neue Codeunit. Dieser Untertyp ist eine reguläre Codeunit. Sie hat nur einen Trigger: OnRun.

  • Installieren – Diese Art von Codeunit wird nur während der Installation des Erweiterungspakets ausgeführt. Dieser Untertyp bietet Zugriff auf zwei zusätzliche Trigger.

  • Upgrade – Diese Art von Codeunit wird nur während des Upgradeprozesses eines Erweiterungspakets ausgeführt. Dieser Untertyp bietet Zugriff auf fünf zusätzliche Trigger.

  • Test – Mit diesem Untertyp können Sie Testfunktionen für Einheiten schreiben. Sie erstellen in dieser Codeunit keine normalen Funktionen, da sie nur während des Einheitentests ausgeführt werden kann.

  • TestRunner – Dieser Untertyp führt eine oder mehrere Test-Codeunits aus.