Introdução

  • 5 minutos

Neste módulo, você aprenderá sobre o objeto Codeunit. Juntamente com tabelas e páginas, uma codeunit é um objeto principal do aplicativo Microsoft Dynamics 365 Business Central.

As codeunits agrupam procedimentos diferentes em um objeto. Esses procedimentos podem ser acessados de dentro de outros procedimentos e gatilhos em páginas, tabelas e outras codeunits.

Uma codeunit contém os seguintes elementos:

  • Gatilhos

  • Funções

  • Variáveis

  • Propriedades

  • Instruções

Uma codeunit contém somente um gatilho: OnRun. Esse gatilho está sempre disponível e é implementado quando você executa uma codeunit.

Usando os trechos de código (tcodeunit) para criar uma codeunit com o Visual Studio Code, o gatilho OnRun é gerado automaticamente.

Propriedade Access

Você pode usar a propriedade Acesso na codeunit para especificar sua codeunit como pública ou interna. Uma codeunit pública pode ser chamada de dentro da mesma extensão, mas também em outras extensões. Uma codeunit interna só pode ser acessada de dentro da mesma extensão.

Propriedade "Subtipo"

A propriedade Subtipo tem cinco valores disponíveis:

  • Normal: o valor padrão de cada nova codeunit. Esse subtipo é uma codeunit regular. Ele tem apenas um gatilho: OnRun.

  • Instalação: este tipo de codeunit será executado somente durante a instalação do pacote de extensão. Esse subtipo fornece acesso a dois gatilhos adicionais.

  • Atualização: este tipo de codeunit será executado somente durante o processo de atualização de um pacote de extensão. Esse subtipo fornece acesso a cinco gatilhos adicionais.

  • Teste: esse subtipo permite escrever funções de teste de unidade. Você não cria funções normais nessa codeunit porque ela só pode ser executada durante o teste de unidade.

  • TestRunner: este subtipo executa uma ou mais Codeunits de teste.