Codice Sorgente
Il codice sorgente è un insieme di istruzioni che viene eseguito in modo sequenziale secondo l’ordine in cui viene inserito, a meno di avere istruzioni di tipo IF o CONFIRM che sono disponibili nella codeunit delle funzioni standard DEA.
Il codice sorgente è utile quando si vuole assegnare valori alle variabili o quando si vuole richiamare delle funzionalità di Business Central, come ad esempio la registrazione di una rettifica o di un documento.
Dove può essere inserito il codice sorgente
Esistono diversi punti in cui si può inserire il codice sorgente e ognuno di essi ha uno scopo preciso.
Inizializzazione variabili di processo - è possibile inserire del codice nel campo "Valore iniziale" di una variabile di processo. Il codice inserito in questo campo scatta nel momento in cui l'utente visualizza la prima pagina del processo DEA in cui è definita la variabile.
Validazione di una variabile - si inserisce usando il bottone "Codice sorgente" nella schermata delle variabili DEA. Il codice inserito in questo modo scatta nel momento in cui viene dato un valore alla variabile.
Apertura di una pagina - si inserisce posiziondosi sul controllo di tipo Repeater/Group di una pagina e usando il bottone "Codice sorgente". Questo codice scatta quando vengono recuperati i dati da visualizzare nella pagina web (simile al trigger OnAfterGetRecord in Business Central).
Click di un bottone - si inserisce nelle azioni di tipo Execute navigando il campo "Action What". Il codice scatta quando viene cliccato il bottone corrispondente (anche tramite shortcut, vedi Azioni).
Creazione del codice sorgente
Usando uno dei modi sopra descritti si accede alla schermata Business Central in cui è possibile inserire la lista di istruzioni da eseguire.
Per generare la singola riga di codice basta navigare il campo "Cod. sorgente" e specificare varie impostazioni per creare l'istruzione.
La prima impostazione richiede di specificare la tipologia del'istruzione, chiamata Tipo sorgente.
| Tipo sorgente | |
|---|---|
| Function | L'istruzione rappresenta la chiamata ad una funzione. |
| Parameter | L'istruzione rappresenta l'assegnazione di un valore ad una variabile DEA. |
Tipo sorgente Function
Nel caso l'istruzione da inserire sia la semplice chiamata ad una funzione, verrà aperto un wizard per guidare l'utente nella selezione della funzione desiderata e nell'assegnazione dei parametri per chiamare tale codice.
Le funzioni proposte dal wizard saranno quelle delle codeunit specificate nel setup Codeunit Disponibili.
L'utente verrà guidato anche nella selezione dei parametri da passare alle funzioni chiamate.
I parametri potranno essere definiti come testo fisso, valori di variabili o campi di una tabella presente nel processo.
Tipo sorgente Parameter
Nel caso di assegnazione di una variabile verrà richiesto di inserire le informazioni relative al valore da assegnare, che dovrà essere specificato tramite un tipo e un valore.
| Tipo | |
|---|---|
| Text | Il valore è fisso. |
| Field | Il valore è quello contenuto nel campo di una tabella specificata nel processo. |
| Function | Il valore è quello restituito da una funzione accessibile al DEA. |
| Parameter | Il valore è quello contenuto in un'altra variabile. |
A seconda del tipo scelto sarà possibile definire il campo "Valore" desiderato.
Nel caso in cui il valore venga restituito da una funzione, il wizard guiderà l'utente nella selezione delle funzioni disponibili come spiegato precedentemente. In questo caso le funzioni presentate all'utente verranno filtrate in modo che si vedano solo quelle con un valore di ritorno compatibile con la variabile.
Nota. Il codice di validazione di una variabile scatta sia quando l'assegnazione del valore è esplicita (tramite codice con il "Tipo sorgente" = Parameter o tramite input dell'utente) sia quando avviene in modo implicito usando la variabile come parametro ByVar di una funzione.
Nota. Nella creazione di un'istruzione del codice sorgente con "Tipo sorgente" = Parameter è possibile specificare con un flag che si vuole evitare la validazione della variabile.