Este manual le guía a través de la búsqueda, incorporación, configuración y aplicación de un indicador en JForex4 —ya sea un indicador integrado o uno personalizado importado mediante JCloud— y su vinculación a un gráfico para visualizar su resultado.

1. Localizar los indicadores

JForex4 no cuenta con un "panel de Indicadores" dedicado. En cambio, los indicadores se pueden acceder desde dos lugares:

• Panel Navigator → nodo Indicadores. Expanda este nodo para explorar el catálogo de indicadores integrados (organizados en categorías) y un subnodo Personalizado que contiene cualquier indicador personalizado/importado que haya agregado. Haga clic derecho sobre un indicador aquí para acceder a acciones como Editar o Compilar (para indicadores .java personalizados).
• Cuadro de diálogo Agregar indicador —se abre directamente desde un gráfico. Muestra el mismo catálogo general (integrados + personalizados), pero en un cuadro de diálogo dedicado, optimizado para explorar, buscar y agregar indicadores al gráfico activo.

2. Abrir el cuadro de diálogo Agregar indicador

Desde un gráfico abierto, abra el cuadro de diálogo Agregar indicador mediante cualquiera de estas dos formas:

• El botón Indicadores en la barra de herramientas del gráfico, o
• El atajo de teclado F3.

El cuadro de diálogo muestra:

• Favoritos —indicadores que ha marcado con estrella para un acceso rápido.
• Recientes —indicadores que ha usado recientemente.
• Secciones de categoría —indicadores integrados agrupados por tipo, por ejemplo Charting Techniques, Cycle Indicators, Mathematical, Momentum Indicators, Patterns, Price Reference, Statistical Indicators, Support/Resistance, Tools, Trading Sessions, Trend Indicators, Volatility Indicators, Volume Indicators. Cada categoría muestra el número de indicadores que contiene.

JForex4 incluye más de 250 indicadores integrados distribuidos en estas categorías. Dado que la lista es larga:

• Pase el cursor sobre el nombre de un indicador para ver una información sobre herramientas con su descripción (véase la captura de pantalla más abajo —pasar el cursor sobre "Linear Regression" muestra "Ajusta una línea de tendencia recta a los datos de precios. Se utiliza para determinar la dirección general de una tendencia.").
• Use el cuadro de búsqueda en la parte superior del diálogo para filtrar la lista por nombre.
• Pulse F4 para abrir una ventana emergente de búsqueda rápida de indicadores, que le permite ir directamente a uno escribiendo parte de su nombre, sin necesidad de navegar por el árbol de categorías.
• Haga clic en el icono de estrella junto a un indicador para agregarlo a Favoritos y acceder a él más rápido la próxima vez.

Consejo: cada fila de indicador tiene una casilla de verificación —puede marcar varios indicadores antes de hacer clic en AGREGAR, al final del cuadro de diálogo, para añadir varios a la vez al mismo gráfico.

3. Agregar indicadores personalizados

Los indicadores personalizados (archivos .java/.jfx propios o de terceros) se gestionan mediante JCloud, de la misma forma que las estrategias personalizadas:

• Desde JCloud —explore los indicadores compartidos o subidos previamente a su cuenta de JCloud.
• Desde el almacenamiento local —haga clic en el botón dedicado Importar (el icono junto al cuadro de búsqueda en el cuadro de diálogo Agregar indicador, o en el menú contextual de Indicadores/Personalizado del Navigator) para transferir un archivo .java o .jfx desde su ordenador a JCloud.

Importante: un indicador personalizado importado o creado como código fuente .java no aparecerá en la sección Personalizado del cuadro de diálogo Agregar indicador —ni podrá agregarse a ningún gráfico— hasta que haya sido compilado con éxito. Solo después de una compilación exitosa se listará en Personalizado (tanto en el nodo Indicadores del Navigator como en el cuadro de diálogo Agregar indicador) y estará disponible para su uso. Un archivo .jfx precompilado, en cambio, se puede usar inmediatamente después de importarlo, ya que no requiere compilación adicional.

4. Compilar un indicador personalizado

Los indicadores personalizados existen en dos formatos de archivo:

Para compilar manualmente, realice una de las siguientes acciones:

• En el panel Navigator, haga clic derecho sobre el indicador personalizado en Indicadores → Personalizado y seleccione Compilar, o
• Ábralo en el Editor de código y haga clic en Compilar (o pulse F5).

Compruebe la pestaña Mensajes para confirmar el resultado:

• Compiling... OK —el indicador se compiló correctamente y ahora aparece en la sección Personalizado del nodo Indicadores del Navigator y del cuadro de diálogo Agregar indicador, listo para agregarse a un gráfico.
• Detalles del error —si la compilación falla, el indicador permanece no disponible para su uso en un gráfico hasta que se corrijan los errores y se compile con éxito.

Nota: los indicadores integrados siempre están precompilados y nunca necesitan este paso —están disponibles de inmediato en cada categoría del cuadro de diálogo Agregar indicador.

5. Agregar el indicador a un gráfico

Un indicador no se "inicia" ni se "ejecuta" de la manera en que lo hace una estrategia; se vincula a un gráfico para que pueda calcular y graficar en función de los datos de precio.

1. Abra (o seleccione) el gráfico que desea analizar.
2. Abra el cuadro de diálogo Agregar indicador (botón en la barra de herramientas del gráfico o F3).
3. Busque el indicador utilizando el árbol de categorías, el cuadro de búsqueda o la búsqueda rápida F4, y pase el cursor sobre él para confirmar su descripción si es necesario.
   • En el caso de un indicador personalizado, asegúrese de que ya se haya compilado con éxito (véase la Sección 4) —de lo contrario, no aparecerá en Personalizado y no podrá seleccionarse.
4. Marque la casilla junto al/los indicador(es) que desee y luego haga clic en AGREGAR.
5. El cuadro de diálogo Configuración del indicador se abre automáticamente la primera vez que se aplica —configure sus parámetros (véase la Sección 6) y confirme.

Una vez aplicado, el indicador:

• se superpone directamente sobre el gráfico de precios (por ejemplo, Media Móvil, Bandas de Bollinger), o
• se traza en una subventana separada debajo del gráfico de precios (por ejemplo, RSI, MACD, Estocástico).

Consejo: el mismo indicador puede aplicarse varias veces al mismo gráfico (por ejemplo, dos Medias Móviles con distintos períodos) o a varios gráficos simultáneamente, cada uno con configuraciones de parámetros independientes.

6. Configurar los parámetros del indicador

1. Haga doble clic en el nombre del indicador en el área de la leyenda/etiqueta del gráfico, o haga clic derecho sobre él y seleccione Configuración, para volver a abrir el cuadro de diálogo Configuración del indicador en cualquier momento.
2. Establezca los valores de cada campo expuesto en el código del indicador (por ejemplo, período, fuente de precio, desplazamiento, colores, estilo de línea) —estos corresponden a los campos marcados como @Configurable en el código fuente (para indicadores personalizados) o al conjunto estándar de parámetros (para indicadores integrados).
3. Ajuste las opciones de visualización, como el color, grosor y estilo de línea, en la pestaña Estilo o Colores del mismo cuadro de diálogo, si está disponible.
4. Haga clic en Aceptar o Aplicar para actualizar el gráfico con la nueva configuración.

Nota: no existe un mecanismo de "guardado de ajustes predefinidos" para los indicadores equivalente a los ajustes predefinidos de Estrategia —cada gráfico recuerda los indicadores aplicados y sus valores de parámetros configurados como parte del diseño del gráfico/espacio de trabajo.

7. Gestionar los indicadores en un gráfico

Una vez aplicado un indicador a un gráfico, puede:

• Editar su configuración —volver a abrir el cuadro de diálogo Configuración del indicador (véase la Sección 6) para cambiar los parámetros sin eliminarlo ni volver a agregarlo.
• Ocultar/Mostrar —alternar su visibilidad en el gráfico sin eliminarlo.
• Eliminar —haga clic derecho sobre el indicador en la leyenda del gráfico y seleccione Eliminar, o use la lista de indicadores del gráfico para borrarlo.
• Editar el código fuente —para indicadores personalizados, seleccione Editar para abrir el código fuente .java en el Editor de código, si el archivo fuente está disponible (véase el manual del Editor de código para más detalles).

Recordatorio: si edita y vuelve a guardar un indicador personalizado que ya está aplicado a un gráfico, debe recompilarlo para que los cambios surtan efecto. Un indicador en el gráfico continúa funcionando con su última versión compilada hasta que se produzca una recompilación exitosa.

Notas sobre la ejecución

Los indicadores no tienen la distinción de ejecución local / ejecución remota que sí tienen las Estrategias:

Consejo: si su indicador está destinado a ser utilizado por una estrategia que se ejecuta de forma remota, su código fuente debe incluirse directamente dentro del archivo .java de la estrategia —el entorno remoto no puede cargar una clase de indicador compilada por separado.

Buenas prácticas

• Compile los indicadores personalizados inmediatamente después de importarlos o editarlos —recuerde que no aparecerán en Personalizado dentro del cuadro de diálogo Agregar indicador, ni podrán agregarse a ningún gráfico, hasta que la compilación se realice con éxito.
• Use la búsqueda rápida F4 cuando ya conozca (o pueda adivinar) el nombre de un indicador —es más rápido que explorar las categorías, especialmente con más de 250 opciones integradas.
• Marque con estrella los indicadores de uso frecuente como Favoritos para que estén visibles de inmediato en la parte superior del cuadro de diálogo Agregar indicador, en lugar de estar ocultos en una categoría.
• Pase el cursor antes de agregar —use la información sobre herramientas de descripción para confirmar que un indicador poco familiar hace lo que espera, en lugar de agregarlo y comprobarlo después.
• Mantenga los valores de los parámetros del indicador adecuados al marco temporal del gráfico —un período que funciona bien en un gráfico diario puede carecer de sentido en un gráfico de 1 minuto.
• Limite el número de indicadores por gráfico —demasiadas superposiciones o indicadores en subventana pueden ralentizar el renderizado del gráfico y dificultar la lectura del análisis.
• Recompile los indicadores personalizados después de cada cambio en el código fuente y verifique el resultado en la pestaña Mensajes antes de volver a aplicar el indicador.
• Documente la lógica de los indicadores personalizados (por ejemplo, en comentarios de código) si planea incorporarlos en archivos de estrategia para compatibilidad con la ejecución remota, ya que en ese contexto no aparecerán como un componente independiente y editable.