Uso di azioni di codice AL

Completato

L'estensione AL Language può aiutare gli utenti a risolvere problemi del codice. 

Azioni codice è una funzionalità di Visual Studio Code che fornisce all'utente possibili azioni correttive accanto a un errore o a un avviso. Se sono disponibili azioni, accanto all'errore o all'avviso compare una lampadina. Quando l'utente seleziona la lampadina (o preme CTRL+.), compare un elenco delle azioni di codice disponibili. È possibile applicare un'azione di codice a una singola istanza o a un ambito più ampio a seconda del tipo di azione.

Nell'estensione AL Language, nella versione corrente, sono disponibili le seguenti azioni di codice:

  • Azione di codice di conversione multipla da IF a CASE

  • Azione di codice di controllo ortografico

  • Strumento di implementazione interfaccia

  • Conversione del metodo in locale

  • Uso delle parentesi per la correzione della chiamata al metodo per istanza, documento, progetto o area di lavoro.

  • Correzione di istruzioni with di tipo esplicito

  • Correzione di istruzioni with di tipo implicito

  • Correzione del layout del report precedente e sostituzione con la sezione di layout di rendering

  • Correzione per AW0013

  • Conversione di pagine o di estensioni di pagina per l'uso della sintassi actionRef per le azioni alzate di livello nella barra delle azioni. Correzione per istanza, documento, progetto o area di lavoro. 

Abilitazione delle azioni di codice AL

  1. Aprire il riquadro comandi premendo CTRL+MAIUSC+P, quindi aprire il file settings.json.

  2. Immettere l'impostazione al.enableCodeActions e impostarla su true, come segue: "al.enableCodeActions": true

  3. Salvare il file delle impostazioni. Si sono abilitate le azioni di codice per il progetto.

In alternativa

  1. Aprire la pagina delle impostazioni premendo CTRL+, quindi selezionare Impostazioni utente o Impostazioni area di lavoro a seconda dell'ambito a cui si intende applicare le azioni di codice.

  2. Andare a Estensioni > Configurazione estensione AL Language.

  3. Selezionare la casella di controllo Abilita azioni di codice. Si sono abilitate le azioni di codice per il progetto.

Alcune azioni di codice sono più indicate per un contesto più ampio anziché per una sola istanza. Se l'azione di codice lo supporta, sarà disponibile l'opzione per eseguirla sulla manifestazione specifica da cui è attivata, nel documento da cui è attivata, nel progetto da cui è attivata o nell'intera area di lavoro. Ciò permette agli sviluppatori di effettuare il refactoring del codice più velocemente e in modo più efficiente su un ambito di origine più ampio senza dover andare a ogni specifica manifestazione per attivare l'azione di codice da tale posizione.

Nel ciclo di rilascio 2 del 2022 le seguenti azioni di codice supportano l'esecuzione in ambiti più ampi:

  • Conversione delle azioni alzate di livello

  • AA0008 - Aggiunta di parentesi

  • AA0241 - Conversione in minuscole

Esempi di azioni di codice AL

L'azione di codice controllo ortografico si attiva su determinati errori di sintassi:

Screenshot dell'azione di codice controllo ortografico.

L'azione di conversione del metodo in locale si attiva per correggere l'avviso CodeCop AA0207:

Screenshot dell'azione di conversione del metodo in locale.

Usare l'azione di codice per convertire la sintassi legacy per le azioni alzate di livello in sintassi actionref, introdotta con il ciclo di rilascio 2 del 2022 di Business Central. Le personalizzazioni in-client, la personalizzazione dell'utente e le configurazioni del profilo sono convertite automaticamente nella nuova sintassi, quindi questo è applicabile principalmente alle estensioni DEV. È possibile applicare l'azione di codice a una singola istanza, al documento, al progetto o all'area di lavoro.

Screenshot dell'azione di codice.

Per le estensioni della finestra di progettazione, usare F6 per aprire la pagina in cui è usata la sintassi legacy nella finestra di progettazione. Selezionare il simbolo del lucchetto e usare Sblocca pagina per convertire automaticamente la sintassi legacy per il codice in esecuzione. Premendo Alt+F6 si tornerà a Visual Studio Code e si visualizzerà il codice actionref convertito.