Ce manuel vous guide à travers la recherche, l'ajout, la configuration et l'application d'un indicateur dans JForex4 — qu'il s'agisse d'un indicateur intégré ou d'un indicateur personnalisé importé via JCloud — et son attachement à un graphique afin de visualiser ses résultats.

1. Localiser les indicateurs

JForex4 ne dispose pas d'un « panneau Indicateurs » dédié. Les indicateurs sont plutôt accessibles à deux endroits :

• Panneau Navigateur → Nœud Indicateurs. Développez ce nœud pour parcourir le catalogue des indicateurs intégrés (organisés en catégories) ainsi qu'un sous-nœud Personnalisé contenant tous les indicateurs personnalisés/importés que vous avez ajoutés. Faites un clic droit sur un indicateur ici pour accéder à des actions telles que Modifier ou Compiler (pour les indicateurs .java personnalisés).
• Boîte de dialogue Ajouter un indicateur — ouverte directement depuis un graphique. Elle affiche le même catalogue global (intégré + personnalisé), mais dans une boîte de dialogue dédiée, optimisée pour parcourir, rechercher et ajouter des indicateurs au graphique actif.

2. Ouvrir la boîte de dialogue Ajouter un indicateur

À partir d'un graphique ouvert, ouvrez la boîte de dialogue Ajouter un indicateur de l'une des deux façons suivantes :

• Le bouton Indicateurs dans la barre d'outils du graphique, ou
• Le raccourci clavier F3.

La boîte de dialogue affiche :

• Favoris — les indicateurs que vous avez marqués d'une étoile pour un accès rapide.
• Récents — les indicateurs que vous avez utilisés récemment.
• Sections par catégorie — les indicateurs intégrés regroupés par type, par exemple Charting Techniques, Cycle Indicators, Mathematical, Momentum Indicators, Patterns, Price Reference, Statistical Indicators, Support/Resistance, Tools, Trading Sessions, Trend Indicators, Volatility Indicators, Volume Indicators. Chaque catégorie affiche le nombre d'indicateurs qu'elle contient.

JForex4 est livré avec plus de 250 indicateurs intégrés répartis dans ces catégories. La liste étant longue :

• Survolez le nom d'un indicateur avec la souris pour voir une infobulle contenant sa description (voir la capture d'écran ci-dessous — survoler « Linear Regression » affiche « Ajuste une ligne de tendance droite aux données de prix. Utilisé pour déterminer la direction générale d'une tendance. »).
• Utilisez la zone de recherche en haut de la boîte de dialogue pour filtrer la liste par nom.
• Appuyez sur F4 pour ouvrir une fenêtre contextuelle de recherche rapide des indicateurs, vous permettant d'accéder directement à un indicateur en tapant une partie de son nom, sans avoir à naviguer dans l'arborescence des catégories.
• Cliquez sur l'icône en forme d'étoile à côté d'un indicateur pour l'ajouter à vos Favoris, afin d'y accéder plus rapidement la prochaine fois.

Astuce : chaque ligne d'indicateur comporte une case à cocher — vous pouvez cocher plusieurs indicateurs avant de cliquer sur AJOUTER en bas de la boîte de dialogue afin d'en ajouter plusieurs à la fois au même graphique.

3. Ajouter des indicateurs personnalisés

Les indicateurs personnalisés (vos propres fichiers .java/.jfx ou ceux de tiers) sont gérés via JCloud, de la même manière que les stratégies personnalisées :

• Depuis JCloud — parcourez les indicateurs partagés ou précédemment téléchargés sur votre compte JCloud.
• Depuis le stockage local — cliquez sur le bouton dédié Importer (l'icône à côté de la zone de recherche dans la boîte de dialogue Ajouter un indicateur, ou dans le menu contextuel Indicateurs/Personnalisé du Navigateur) pour transférer un fichier .java ou .jfx depuis votre ordinateur vers JCloud.

Important : un indicateur personnalisé importé ou créé en tant que source .java n'apparaît pas dans la section Personnalisé de la boîte de dialogue Ajouter un indicateur — et ne peut être ajouté à aucun graphique — tant qu'il n'a pas été compilé avec succès. Ce n'est qu'après une compilation réussie qu'il est répertorié sous Personnalisé (à la fois dans le nœud Indicateurs du Navigateur et dans la boîte de dialogue Ajouter un indicateur) et devient disponible à l'utilisation. En revanche, un fichier .jfx précompilé est utilisable immédiatement après son importation, car il ne nécessite aucune compilation supplémentaire.

4. Compiler un indicateur personnalisé

Les indicateurs personnalisés existent sous deux formats de fichiers :

Pour compiler manuellement, effectuez l'une des actions suivantes :

• Dans le panneau Navigateur, faites un clic droit sur l'indicateur personnalisé sous Indicateurs → Personnalisé et sélectionnez Compiler, ou
• Ouvrez-le dans l'Éditeur de code et cliquez sur Compiler (ou appuyez sur F5).

Vérifiez l'onglet Messages pour confirmer le résultat :

• Compiling... OK — l'indicateur a été compilé avec succès et apparaît désormais dans la section Personnalisé du nœud Indicateurs du Navigateur ainsi que dans la boîte de dialogue Ajouter un indicateur, prêt à être ajouté à un graphique.
• Détails de l'erreur — en cas d'échec de la compilation, l'indicateur reste indisponible pour une utilisation sur un graphique tant que les erreurs n'ont pas été corrigées et qu'il n'a pas été compilé avec succès.

Remarque : les indicateurs intégrés sont toujours précompilés et n'ont jamais besoin de cette étape — ils sont disponibles immédiatement dans chaque catégorie de la boîte de dialogue Ajouter un indicateur.

5. Ajouter l'indicateur à un graphique

Un indicateur n'est pas « démarré » ou « exécuté » comme l'est une stratégie — il est attaché à un graphique afin de pouvoir calculer et tracer ses résultats en fonction des données de prix.

1. Ouvrez (ou sélectionnez) le graphique que vous souhaitez analyser.
2. Ouvrez la boîte de dialogue Ajouter un indicateur (bouton de la barre d'outils du graphique ou F3).
3. Trouvez l'indicateur à l'aide de l'arborescence des catégories, de la zone de recherche, ou de la recherche rapide F4, et survolez-le pour confirmer sa description si nécessaire.
   • Pour un indicateur personnalisé, assurez-vous qu'il a déjà été compilé avec succès (voir la section 4) — sinon, il ne sera pas répertorié sous Personnalisé et ne pourra pas être sélectionné.
4. Cochez la case à côté du ou des indicateurs souhaités, puis cliquez sur AJOUTER.
5. La boîte de dialogue Paramètres de l'indicateur s'ouvre automatiquement lors de la première application — configurez ses paramètres (voir la section 6) et confirmez.

Une fois appliqué, l'indicateur soit :

• se superpose directement sur le graphique de prix (par exemple, Moyenne mobile, Bandes de Bollinger), ou
• se trace dans une fenêtre secondaire distincte sous le graphique de prix (par exemple, RSI, MACD, Stochastique).

Astuce : le même indicateur peut être appliqué plusieurs fois au même graphique (par exemple, deux moyennes mobiles avec des périodes différentes) ou à plusieurs graphiques simultanément, chacun avec des paramètres indépendants.

6. Configurer les paramètres de l'indicateur

1. Double-cliquez sur le nom de l'indicateur dans la légende du graphique, ou faites un clic droit dessus et sélectionnez Paramètres, pour rouvrir à tout moment la boîte de dialogue Paramètres de l'indicateur.
2. Définissez les valeurs de chaque champ exposé dans le code de l'indicateur (par exemple, période, source de prix, décalage, couleurs, style de ligne) — ceux-ci correspondent aux champs marqués @Configurable dans le code source (pour les indicateurs personnalisés) ou à l'ensemble de paramètres standard (pour les indicateurs intégrés).
3. Ajustez les options d'affichage telles que la couleur, l'épaisseur et le style de ligne dans l'onglet Style ou Couleurs de la même boîte de dialogue, si disponible.
4. Cliquez sur OK ou Appliquer pour mettre à jour le graphique avec les nouveaux paramètres.

Remarque : il n'existe pas de mécanisme d'« enregistrement de préréglage » pour les indicateurs, équivalent aux préréglages de stratégie — chaque graphique mémorise ses indicateurs appliqués et leurs valeurs de paramètres configurées dans le cadre de la disposition du graphique/de l'espace de travail.

7. Gérer les indicateurs sur un graphique

Une fois un indicateur appliqué à un graphique, vous pouvez :

• Modifier ses paramètres — rouvrir la boîte de dialogue Paramètres de l'indicateur (voir section 6) pour modifier les paramètres sans le supprimer et le rajouter.
• Masquer/Afficher — basculer sa visibilité sur le graphique sans le supprimer.
• Supprimer — faites un clic droit sur l'indicateur dans la légende du graphique et sélectionnez Supprimer, ou utilisez la liste des indicateurs du graphique pour le supprimer.
• Modifier la source — pour les indicateurs personnalisés, sélectionnez Modifier pour ouvrir la source .java dans l'Éditeur de code, si le fichier source est disponible (voir le manuel Éditeur de code pour plus de détails).

Rappel : si vous modifiez et réenregistrez un indicateur personnalisé déjà appliqué à un graphique, vous devez le recompiler pour que les modifications prennent effet. Un indicateur sur le graphique continue de fonctionner avec sa dernière version compilée jusqu'à une recompilation réussie.

Notes sur l'exécution

Les indicateurs ne disposent pas de la distinction Exécution locale / Exécution à distance qu'ont les Stratégies :

Astuce : si votre indicateur est destiné à être utilisé par une stratégie s'exécutant à distance, son code source doit être inclus directement dans le fichier .java de la stratégie — l'environnement distant ne peut pas charger une classe d'indicateur compilée séparément.

Bonnes pratiques

• Compilez les indicateurs personnalisés immédiatement après l'importation ou la modification — rappelez-vous qu'ils n'apparaîtront pas sous Personnalisé dans la boîte de dialogue Ajouter un indicateur, et ne pourront être ajoutés à aucun graphique, tant que la compilation n'aura pas réussi.
• Utilisez la recherche rapide F4 lorsque vous connaissez déjà (ou pouvez deviner) le nom d'un indicateur — c'est plus rapide que de parcourir les catégories, surtout avec plus de 250 options intégrées.
• Marquez d'une étoile les indicateurs fréquemment utilisés afin qu'ils soient immédiatement visibles en haut de la boîte de dialogue Ajouter un indicateur plutôt qu'enfouis dans une catégorie.
• Survolez avant d'ajouter — utilisez l'infobulle de description pour confirmer qu'un indicateur peu familier fait bien ce que vous attendez, plutôt que de l'ajouter puis de vérifier après coup.
• Adaptez les valeurs des paramètres de l'indicateur à l'échelle temporelle du graphique — une période qui fonctionne bien sur un graphique journalier peut être dénuée de sens sur un graphique en 1 minute.
• Limitez le nombre d'indicateurs par graphique — un nombre excessif de superpositions ou d'indicateurs en fenêtre secondaire peut ralentir le rendu du graphique et rendre l'analyse plus difficile à lire.
• Recompilez les indicateurs personnalisés après chaque modification du code source et vérifiez le résultat dans l'onglet Messages avant de réappliquer l'indicateur.
• Documentez la logique des indicateurs personnalisés (par exemple, dans des commentaires de code) si vous prévoyez de les intégrer dans des fichiers de stratégie pour la compatibilité avec l'exécution à distance, car ils n'apparaîtront pas comme un composant distinct et modifiable dans ce contexte.