Questo manuale illustra come trovare, aggiungere, configurare e applicare un indicatore in JForex4 — sia esso un indicatore integrato o un indicatore personalizzato importato tramite JCloud — e come collegarlo a un grafico per visualizzarne l'output.

1. Individuare gli indicatori

JForex4 non dispone di un "pannello Indicatori" dedicato. Gli indicatori sono invece accessibili in due punti:

• Pannello Navigator → Nodo Indicatori. Espandi questo nodo per sfogliare il catalogo degli indicatori integrati (organizzati in categorie) e un sotto-nodo Personalizzati contenente qualsiasi indicatore personalizzato/importato che hai aggiunto. Fai clic destro su un indicatore qui per accedere ad azioni come Modifica o Compila (per gli indicatori .java personalizzati).
• Finestra di dialogo Aggiungi indicatore — aperta direttamente da un grafico. Mostra lo stesso catalogo complessivo (integrati + personalizzati), ma in una finestra di dialogo dedicata, ottimizzata per sfogliare, cercare e aggiungere indicatori al grafico attivo.

2. Aprire la finestra di dialogo Aggiungi indicatore

Da un grafico aperto, apri la finestra di dialogo Aggiungi indicatore in uno dei seguenti modi:

• Il pulsante Indicatori nella barra degli strumenti del grafico, oppure
• La scorciatoia da tastiera F3.

La finestra di dialogo mostra:

• Preferiti — indicatori che hai contrassegnato con una stella per un accesso rapido.
• Recenti — indicatori usati di recente.
• Sezioni per categoria — indicatori integrati raggruppati per tipo, ad esempio Charting Techniques, Cycle Indicators, Mathematical, Momentum Indicators, Patterns, Price Reference, Statistical Indicators, Support/Resistance, Tools, Trading Sessions, Trend Indicators, Volatility Indicators, Volume Indicators. Ogni categoria mostra il numero di indicatori che contiene.

JForex4 include oltre 250 indicatori integrati suddivisi in queste categorie. Poiché l'elenco è lungo:

• Posiziona il puntatore del mouse sul nome di un indicatore per visualizzare un tooltip con la sua descrizione (vedi screenshot sotto — passando il mouse su "Linear Regression" viene mostrato "Adatta una linea di tendenza retta ai dati di prezzo. Utilizzato per determinare la direzione generale di un trend.").
• Usa il campo di ricerca in alto nella finestra di dialogo per filtrare l'elenco per nome.
• Premi F4 per aprire un popup di Ricerca rapida per gli indicatori, che ti permette di passare direttamente a un indicatore digitando parte del suo nome senza dover navigare nell'albero delle categorie.
• Fai clic sull'icona a stella accanto a un indicatore per aggiungerlo ai Preferiti, così da accedervi più velocemente la prossima volta.

Suggerimento: ogni riga dell'indicatore ha una casella di controllo — puoi selezionare più indicatori prima di fare clic su AGGIUNGI in fondo alla finestra di dialogo, per aggiungerne diversi contemporaneamente allo stesso grafico.

3. Aggiungere indicatori personalizzati

Gli indicatori personalizzati (file .java/.jfx propri o di terze parti) vengono gestiti tramite JCloud, allo stesso modo delle strategie personalizzate:

• Da JCloud — sfoglia gli indicatori condivisi o precedentemente caricati sul tuo account JCloud.
• Dall'archiviazione locale — fai clic sul pulsante dedicato Importa (l'icona accanto al campo di ricerca nella finestra di dialogo Aggiungi indicatore, oppure nel menu contestuale Indicatori/Personalizzati del Navigator) per trasferire un file .java o .jfx dal tuo computer a JCloud.

Importante: un indicatore personalizzato importato o creato come sorgente .java non compare nella sezione Personalizzati della finestra di dialogo Aggiungi indicatore — e non può essere aggiunto ad alcun grafico — finché non è stato compilato con successo. Solo dopo che la compilazione ha esito positivo viene elencato in Personalizzati (sia nel nodo Indicatori del Navigator sia nella finestra di dialogo Aggiungi indicatore) e diventa disponibile per l'uso. Un file .jfx precompilato, invece, è utilizzabile immediatamente dopo l'importazione poiché non richiede ulteriore compilazione.

4. Compilare un indicatore personalizzato

Gli indicatori personalizzati esistono in due formati di file:

Per compilare manualmente, procedi in uno dei seguenti modi:

• Nel pannello Navigator, fai clic destro sull'indicatore personalizzato sotto Indicatori → Personalizzati e seleziona Compila, oppure
• Aprilo nel Code Editor e fai clic su Compila (oppure premi F5).

Controlla la scheda Messaggi per confermare il risultato:

• Compiling... OK — l'indicatore è stato compilato con successo e ora compare nella sezione Personalizzati del nodo Indicatori nel Navigator e nella finestra di dialogo Aggiungi indicatore, pronto per essere aggiunto a un grafico.
• Dettagli dell'errore — se la compilazione fallisce, l'indicatore rimane non disponibile per l'uso su un grafico finché gli errori non vengono corretti e la compilazione non ha successo.

Nota: gli indicatori integrati sono sempre precompilati e non necessitano mai di questo passaggio — sono disponibili immediatamente in ogni categoria della finestra di dialogo Aggiungi indicatore.

5. Aggiungere l'indicatore a un grafico

Un indicatore non viene "avviato" o "eseguito" come una strategia — viene collegato a un grafico in modo che possa calcolare e disegnare in base ai dati di prezzo.

1. Apri (o seleziona) il grafico che desideri analizzare.
2. Apri la finestra di dialogo Aggiungi indicatore (pulsante nella barra degli strumenti del grafico oppure F3).
3. Trova l'indicatore usando l'albero delle categorie, il campo di ricerca oppure la Ricerca rapida F4, e passa il mouse sopra per confermarne la descrizione, se necessario.
   • Per un indicatore personalizzato, assicurati che sia già stato compilato con successo (vedi Sezione 4) — altrimenti non sarà elencato in Personalizzati e non potrà essere selezionato.
4. Seleziona la casella accanto agli indicatori desiderati, quindi fai clic su AGGIUNGI.
5. La finestra di dialogo Impostazioni indicatore si apre automaticamente la prima volta che viene applicato — configura i suoi parametri (vedi Sezione 6) e conferma.

Una volta applicato, l'indicatore:

• si sovrappone direttamente al grafico dei prezzi (ad esempio, Media Mobile, Bande di Bollinger), oppure
• viene disegnato in una sotto-finestra separata sotto il grafico dei prezzi (ad esempio, RSI, MACD, Stocastico).

Suggerimento: lo stesso indicatore può essere applicato più volte allo stesso grafico (ad esempio, due Medie Mobili con periodi diversi) oppure a più grafici contemporaneamente, ciascuno con impostazioni dei parametri indipendenti.

6. Configurare i parametri dell'indicatore

1. Fai doppio clic sul nome dell'indicatore nell'area della legenda/etichetta del grafico, oppure fai clic destro su di esso e seleziona Impostazioni, per riaprire in qualsiasi momento la finestra di dialogo Impostazioni indicatore.
2. Imposta i valori per ciascun campo esposto nel codice dell'indicatore (ad esempio, periodo, sorgente del prezzo, spostamento, colori, stile della linea) — questi corrispondono ai campi contrassegnati come @Configurable nel codice sorgente (per gli indicatori personalizzati) o all'insieme di parametri standard (per gli indicatori integrati).
3. Regola le opzioni di visualizzazione come colore, spessore e stile della linea nella scheda Stile o Colori della stessa finestra di dialogo, se disponibile.
4. Fai clic su OK o Applica per aggiornare il grafico con le nuove impostazioni.

Nota: non esiste un meccanismo di "salvataggio preset" per gli indicatori equivalente ai preset delle Strategie — ogni grafico memorizza gli indicatori applicati e i relativi valori dei parametri configurati come parte del layout del grafico/workspace.

7. Gestire gli indicatori su un grafico

Una volta applicato un indicatore a un grafico, puoi:

• Modificarne le impostazioni — riaprire la finestra di dialogo Impostazioni indicatore (vedi Sezione 6) per modificare i parametri senza rimuoverlo e riaggiungerlo.
• Nascondere/Mostrare — attivare/disattivare la sua visibilità sul grafico senza eliminarlo.
• Rimuovere — fai clic destro sull'indicatore nella legenda del grafico e seleziona Rimuovi, oppure usa l'elenco degli indicatori del grafico per eliminarlo.
• Modificare il sorgente — per gli indicatori personalizzati, seleziona Modifica per aprire il sorgente .java nel Code Editor, se il file sorgente è disponibile (vedi il manuale Code Editor per i dettagli).

Promemoria: se modifichi e risalvi un indicatore personalizzato già applicato a un grafico, devi ricompilarlo affinché le modifiche abbiano effetto. Un indicatore sul grafico continua a funzionare con la sua ultima versione compilata finché non avviene una ricompilazione con successo.

Note sull'esecuzione

Gli indicatori non hanno la distinzione tra esecuzione locale / esecuzione remota che hanno le Strategie:

Suggerimento: se il tuo indicatore deve essere utilizzato da una strategia in esecuzione remota, il suo codice sorgente deve essere incluso direttamente nel file .java della strategia — l'ambiente remoto non può caricare una classe di indicatore compilata separatamente.

Best practice

• Compila gli indicatori personalizzati immediatamente dopo l'importazione o la modifica — ricorda che non compariranno in Personalizzati nella finestra di dialogo Aggiungi indicatore, e non potranno essere aggiunti ad alcun grafico, finché la compilazione non avrà successo.
• Usa la Ricerca rapida F4 quando conosci già (o puoi indovinare) il nome di un indicatore — è più veloce che sfogliare le categorie, soprattutto con oltre 250 opzioni integrate.
• Contrassegna con una stella gli indicatori usati di frequente come Preferiti, in modo che siano immediatamente visibili in cima alla finestra di dialogo Aggiungi indicatore anziché nascosti in una categoria.
• Passa il mouse prima di aggiungere — usa il tooltip di descrizione per confermare che un indicatore poco familiare faccia ciò che ti aspetti, invece di aggiungerlo e verificarlo in seguito.
• Mantieni i valori dei parametri dell'indicatore adeguati all'intervallo temporale del grafico — un periodo che funziona bene su un grafico giornaliero può essere privo di significato su un grafico a 1 minuto.
• Limita il numero di indicatori per grafico — troppi overlay o indicatori in sotto-finestra possono rallentare il rendering del grafico e rendere l'analisi più difficile da leggere.
• Ricompila gli indicatori personalizzati dopo ogni modifica del codice sorgente e verifica nella scheda Messaggi prima di riapplicare l'indicatore.
• Documenta la logica degli indicatori personalizzati (ad esempio, nei commenti del codice) se prevedi di incorporarli nei file di strategia per la compatibilità con l'esecuzione remota, poiché in quel contesto non compariranno come componente separato e modificabile.