Debug

Ci sono vari modi di fare debug in Sage X3.

Calcolatrice

Il modo più semplice e immediato per verificare il valore di una variabile, di un campo di una maschera o di un file è l'utilizzo della calcolatrice: dal menu

? → Help diagnostici → Calcolatrice

basta inserire il nome della variabile o campo desiderato e premere Invio.

Esempi:

• GFONCTION1 → funzione
• GFLAG → transazione

Istruzione Affdbg

Inserire nel punto voluto del codice sorgente l'istruzione Dbgaff e ricompilare (F7): quando il codice arriverà a questa istruzione si aprirà la finestra "Debugger":

• premere il pulsante Riga per entrare nelle subroutine (anche del verticale e del DX, se ci sono i sorgenti)
• premere il pulsante Continua per vedere solo le chiamate del programma principale
• premere il pulsante Fine per terminare il debug.

Dalla finestra, cliccare pulsante "Dettagli", sul tab "Selezione Classi" scrivere per esempio "[M:RPT]" (senza virgolette), per vederne il contenuto.

File di traccia

Ottenere un file di traccia V6

Per ottenere un file di traccia con tutte le chiamate effettuate da Sage, comprese quelle di sistema, seguire i seguenti passi:

1. Porsi nella situazione di inizio di cui si vuole ottenere una traccia di log (per esempio scrivere all'interno di un campo senza dare TAB o INVIO per tracciare gli eventi del tipo "Post Campo")
2. Premere Ctrl-ALt-F, oppure da menù ? → Help diagnostici → Debug ON\Off
3. Sulla finestra "Debugger" che esce spuntare il flag Traccia in basso e premere TAB: comparirà il percorso del file che verrà salvato (volendo si può modificare)
4. A questo punto si può avviare il debug:
   • premere il pulsante Riga per entrare nelle subroutine (anche del verticale e del DX, se ci sono i sorgenti)
   • premere il pulsante Continua per vedere solo le chiamate del programma principale
5. Effettuare le azioni da tracciare
6. Terminare il debug premendo nuovamente Ctrl-ALt-F: sulla finestra "Debugger" togliere la spunta al flag Traccia e premere il pulsante Fine.

Nel riquadro "Variabili" della finestra "Debugger" è possibile inserire i nomi di variabili locali o globali, di maschera o file, nella colonna "Espressione" per ispezionarne il valore.

Ottenere un file di traccia di sessione V7

In Sage X3 è possibile recuperare la traccia di tutte le chiamate che il sistema esegue mentre usiamo l'interfaccia.

Per ottenere questa traccia basta andare alla voce USO\Tracce\x3 sessione configurazione del menu Administrator.

Nel campo flag metti 1 (maggiori info sul pulsante Aiuto), come directory metti "tmp" (che sta ad indicare la cartella del dossier corrente dove salvare il file), clicca su "Invia" e su "Activate X3 log". Esci dalla finestra.

A questo punto qualunque funzione aprirai il sistema comincerà a scrivere le chiamate eseguite su un file CARTELLA_DOSSIER\tmp\x3diary_UTENTE_xxxxx.tra

Lì dentro troverai la traccia indentata della sequenza di chiamate, con tanto di numero riga eseguita (tra parentesi tonde) e riferimento temporale "tick".

Per la traccia di un preciso momento, basta, appena prima di quel momento, aprire il file, cancellare il contenuto e salvarlo. Poi nell'interfaccia compiere l'azione da analizzare. A questo punto sul file troverai le chiamate che ti interessano.

Recuperare un file di traccia

Dal menù Stampe → Lettura tracce (F7 LECTRACE), Selezione o F12 per ricercare il file voluto