يرشدك هذا الدليل خلال عملية البحث عن مؤشر في JForex4 وإضافته وتهيئته وتطبيقه — سواء كان مؤشرًا مدمجًا أو مؤشرًا مخصصًا تم استيراده عبر JCloud — وإرفاقه بمخطط بياني (Chart) لتصور مخرجاته.

1. تحديد موقع المؤشرات

لا يحتوي JForex4 على "لوحة مؤشرات" مخصصة. بدلاً من ذلك، يمكن الوصول إلى المؤشرات من مكانين:

• لوحة المتصفح (Navigator) ← عقدة المؤشرات (Indicators). قم بتوسيع هذه العقدة لتصفح كتالوج المؤشرات المدمجة (منظمة في فئات) وعقدة فرعية باسم مخصص (Custom) تحتوي على أي مؤشرات مخصصة/مستوردة أضفتها. انقر بزر الماوس الأيمن على مؤشر هنا للوصول إلى إجراءات مثل تحرير (Edit) أو تجميع/كومبايل (Compile) (لمؤشرات .java المخصصة).
• مربع حوار إضافة مؤشر — يُفتح مباشرة من المخطط البياني. يعرض نفس الكتالوج الكامل (المدمج + المخصص)، ولكن في مربع حوار مخصص مُحسّن للتصفح والبحث وإضافة المؤشرات إلى المخطط النشط.

2. فتح مربع حوار إضافة مؤشر

من مخطط بياني مفتوح، افتح مربع حوار إضافة مؤشر (Add Indicator) باستخدام إحدى الطريقتين التاليتين:

• زر المؤشرات (Indicators) في شريط أدوات المخطط، أو
• اختصار لوحة المفاتيح F3.

يعرض مربع الحوار ما يلي:

• المفضلة (Favorites) — المؤشرات التي قمت بتمييزها بنجمة للوصول السريع إليها.
• الأخيرة (Recent) — المؤشرات التي استخدمتها مؤخرًا.
• أقسام الفئات — المؤشرات المدمجة مجمّعة حسب النوع، مثل أساليب الرسم البياني (Charting Techniques)، ومؤشرات الدورات (Cycle Indicators)، والرياضيات (Mathematical)، ومؤشرات الزخم (Momentum Indicators)، والأنماط (Patterns)، ومرجع السعر (Price Reference)، والمؤشرات الإحصائية (Statistical Indicators)، والدعم/المقاومة (Support/Resistance)، والأدوات (Tools)، وجلسات التداول (Trading Sessions)، ومؤشرات الاتجاه (Trend Indicators)، ومؤشرات التقلب (Volatility Indicators)، ومؤشرات الحجم (Volume Indicators). تعرض كل فئة عدد المؤشرات التي تحتوي عليها.

يأتي JForex4 مزودًا بـ أكثر من 250 مؤشرًا مدمجًا عبر هذه الفئات. نظرًا لطول القائمة:

• مرّر مؤشر الماوس فوق اسم المؤشر لرؤية تلميح يحتوي على وصفه (انظر لقطة الشاشة أدناه — تمرير المؤشر فوق "الانحدار الخطي (Linear Regression)" يُظهر "يُلائم خطًا اتجاهيًا مستقيمًا عبر بيانات السعر. يُستخدم لتحديد الاتجاه العام للترند.").
• استخدم مربع البحث أعلى مربع الحوار لتصفية القائمة حسب الاسم.
• اضغط F4 لفتح نافذة منبثقة للبحث السريع (Quick search) عن المؤشرات، مما يتيح لك الانتقال مباشرة إلى مؤشر عن طريق كتابة جزء من اسمه دون التنقل عبر شجرة الفئات.
• انقر على أيقونة النجمة بجانب المؤشر لإضافته إلى المفضلة لتسهيل الوصول إليه في المرة القادمة.

نصيحة: يحتوي كل صف مؤشر على مربع اختيار — يمكنك تحديد عدة مؤشرات قبل النقر على إضافة (ADD) في أسفل مربع الحوار لإضافة عدة مؤشرات دفعة واحدة إلى نفس المخطط.

3. إضافة مؤشرات مخصصة

تُدار المؤشرات المخصصة (ملفات .java/.jfx الخاصة بك أو التابعة لجهات خارجية) من خلال JCloud، بنفس الطريقة التي تُدار بها الاستراتيجيات المخصصة:

• من JCloud — تصفح المؤشرات التي تمت مشاركتها أو تحميلها مسبقًا إلى حساب JCloud الخاص بك.
• من التخزين المحلي — انقر على زر الاستيراد (Import) المخصص (الأيقونة الموجودة بجانب مربع البحث في مربع حوار إضافة مؤشر، أو في قائمة السياق الخاصة بـ "المؤشرات/مخصص" في المتصفح) لإحضار ملف .java أو .jfx من جهاز الكمبيوتر الخاص بك إلى JCloud.

مهم: لن يظهر المؤشر المخصص الذي تم استيراده أو إنشاؤه كملف مصدر .java في قسم مخصص (Custom) ضمن مربع حوار إضافة مؤشر — ولا يمكن إضافته إلى أي مخطط — إلى أن تتم عملية تجميعه (compile) بنجاح. فقط بعد نجاح التجميع يتم إدراجه ضمن قسم مخصص (سواء في عقدة المؤشرات بالمتصفح أو في مربع حوار إضافة مؤشر)، ويصبح متاحًا للاستخدام. أما ملف .jfx المُجمَّع مسبقًا، فيمكن استخدامه فور استيراده لأنه لا يتطلب أي تجميع إضافي.

4. تجميع (كومبايل) مؤشر مخصص

توجد المؤشرات المخصصة بصيغتين من الملفات:

للتجميع يدويًا، قم بأحد الإجراءين التاليين:

• في لوحة المتصفح (Navigator)، انقر بزر الماوس الأيمن على المؤشر المخصص ضمن المؤشرات ← مخصص، ثم اختر تجميع (Compile)، أو
• افتحه في محرر الأكواد (Code Editor) وانقر على تجميع (أو اضغط F5).

تحقق من علامة التبويب الرسائل (Messages) لتأكيد النتيجة:

• Compiling... OK — تم تجميع المؤشر بنجاح، وأصبح الآن يظهر في قسم مخصص ضمن عقدة المؤشرات في المتصفح ومربع حوار إضافة مؤشر، وجاهز لإضافته إلى مخطط.
• تفاصيل الخطأ — إذا فشل التجميع، يظل المؤشر غير متاح للاستخدام في أي مخطط إلى أن يتم إصلاح الأخطاء وتجميعه بنجاح.

ملاحظة: المؤشرات المدمجة تكون دائمًا مُجمَّعة مسبقًا ولا تحتاج أبدًا إلى هذه الخطوة — فهي متاحة فورًا في كل فئة من فئات مربع حوار إضافة مؤشر.

5. إضافة المؤشر إلى مخطط بياني

لا "يبدأ تشغيل" المؤشر أو "يعمل" بالطريقة التي تعمل بها الاستراتيجية — بل يُرفق بمخطط بياني حتى يتمكن من الحساب والرسم استنادًا إلى بيانات السعر.

1. افتح (أو حدد) المخطط البياني الذي تريد تحليله.
2. افتح مربع حوار إضافة مؤشر (زر في شريط أدوات المخطط أو F3).
3. ابحث عن المؤشر باستخدام شجرة الفئات، أو مربع البحث، أو البحث السريع F4، ومرّر الماوس للتأكد من وصفه إذا لزم الأمر.
   • بالنسبة لمؤشر مخصص، تأكد من أنه قد تم تجميعه بنجاح بالفعل (انظر القسم 4) — وإلا فلن يتم إدراجه ضمن مخصص ولن يمكن تحديده.
4. حدد مربع الاختيار بجانب المؤشر (أو المؤشرات) المطلوبة، ثم انقر على إضافة (ADD).
5. يفتح مربع حوار إعدادات المؤشر (Indicator Settings) تلقائيًا في المرة الأولى التي يُطبَّق فيها — قم بتهيئة معلماته (انظر القسم 6) وأكّد ذلك.

بعد التطبيق، سيقوم المؤشر إما بـ:

• التراكب مباشرة على مخطط السعر (مثل، المتوسط المتحرك، نطاقات بولينجر)، أو
• الرسم في نافذة فرعية منفصلة أسفل مخطط السعر (مثل، RSI، MACD، Stochastic).

نصيحة: يمكن تطبيق نفس المؤشر عدة مرات على نفس المخطط (مثلاً، متوسطان متحركان بفترتين مختلفتين) أو على عدة مخططات في آن واحد، كل منها بإعدادات معلمات مستقلة.

6. تهيئة معلمات المؤشر

1. انقر نقرًا مزدوجًا على اسم المؤشر في منطقة وسيلة الإيضاح/التسمية بالمخطط، أو انقر بزر الماوس الأيمن عليه واختر إعدادات (Settings)، لإعادة فتح مربع حوار إعدادات المؤشر في أي وقت.
2. حدد القيم لكل حقل مُتاح في كود المؤشر (مثل الفترة، ومصدر السعر، والإزاحة، والألوان، ونمط الخط) — وهذه تقابل الحقول المُعلَّمة بـ @Configurable في الكود المصدري (بالنسبة للمؤشرات المخصصة) أو مجموعة المعلمات القياسية (بالنسبة للمؤشرات المدمجة).
3. اضبط خيارات العرض مثل لون الخط وسمكه ونمطه في علامة التبويب النمط (Style) أو الألوان (Colors) بنفس مربع الحوار، إن وُجدت.
4. انقر على موافق (OK) أو تطبيق (Apply) لتحديث المخطط بالإعدادات الجديدة.

ملاحظة: لا توجد آلية "حفظ إعداد مسبق" للمؤشرات مماثلة لإعدادات الاستراتيجية المسبقة — يتذكر كل مخطط المؤشرات المُطبَّقة عليه وقيم معلماتها المُهيّأة كجزء من تخطيط المخطط/مساحة العمل.

7. إدارة المؤشرات على مخطط بياني

بمجرد تطبيق مؤشر على مخطط بياني، يمكنك:

• تحرير إعداداته — إعادة فتح مربع حوار إعدادات المؤشر (انظر القسم 6) لتغيير المعلمات دون إزالته وإعادة إضافته.
• الإخفاء/الإظهار — تبديل ظهوره على المخطط دون حذفه.
• الإزالة — انقر بزر الماوس الأيمن على المؤشر في وسيلة إيضاح المخطط واختر إزالة (Remove)، أو استخدم قائمة مؤشرات المخطط لحذفه.
• تحرير المصدر — بالنسبة للمؤشرات المخصصة، اختر تحرير (Edit) لفتح الملف المصدري .java في محرر الأكواد، إذا كان الملف المصدري متاحًا (انظر دليل محرر الأكواد للتفاصيل).

تذكير: إذا قمت بتحرير مؤشر مخصص مُطبَّق بالفعل على مخطط ثم حفظته من جديد، يجب عليك إعادة تجميعه ليصبح التغيير ساري المفعول. يستمر المؤشر على المخطط في العمل بآخر نسخة مُجمَّعة له حتى تتم إعادة التجميع بنجاح.

ملاحظات التنفيذ

لا تملك المؤشرات التمييز بين التشغيل المحلي / التشغيل عن بُعد الذي تملكه الاستراتيجيات:

نصيحة: إذا كان مؤشرك مخصصًا للاستخدام من قِبل استراتيجية تعمل عن بُعد، فيجب تضمين الكود المصدري الخاص به مباشرة داخل ملف .java الخاص بالاستراتيجية — لا يمكن لبيئة التشغيل عن بُعد تحميل ملف فئة مؤشر مُجمَّع بشكل منفصل.

أفضل الممارسات

• جمِّع المؤشرات المخصصة فور استيرادها أو تحريرها — تذكّر أنها لن تظهر ضمن مخصص في مربع حوار إضافة مؤشر، ولن يمكن إضافتها إلى أي مخطط، إلى أن يتم التجميع بنجاح.
• استخدم البحث السريع F4 عندما تعرف (أو يمكنك تخمين) اسم المؤشر — فهو أسرع من التصفح عبر الفئات، خاصة مع وجود أكثر من 250 خيارًا مدمجًا.
• ضع نجمة على المؤشرات المستخدمة بكثرة كمفضلة بحيث تكون مرئية فورًا أعلى مربع حوار إضافة مؤشر بدلًا من أن تكون مدفونة في فئة ما.
• مرّر الماوس قبل الإضافة — استخدم تلميح الوصف للتأكد من أن مؤشرًا غير مألوف يقوم بما تتوقعه قبل تطبيقه على مخطط، بدلًا من إضافته والتحقق لاحقًا.
• حافظ على قيم معلمات المؤشر مناسبة للإطار الزمني للمخطط — فترة تعمل جيدًا على مخطط يومي قد تكون بلا معنى على مخطط دقيقة واحدة.
• حدّ من عدد المؤشرات لكل مخطط — فالكثير من الطبقات المتراكبة أو مؤشرات النوافذ الفرعية يمكن أن يبطئ عرض المخطط ويجعل التحليل أصعب في القراءة.
• أعد تجميع المؤشرات المخصصة بعد كل تغيير في الكود المصدري وتحقق من ذلك في علامة تبويب الرسائل قبل إعادة تطبيق المؤشر.
• وثِّق منطق المؤشر المخصص (مثلاً، في تعليقات الكود) إذا كنت تخطط لتضمينه داخل ملفات الاستراتيجية لضمان التوافق مع التشغيل عن بُعد، إذ لن يظهر كمكوّن منفصل قابل للتحرير في ذلك السياق.