استيراد CSV إلى دفتر التداول: صادرات الوسطاء، وربط الأعمدة، ومنع التكرار
خيار استيراد الصفقات من CSV يقرأ صادرات وسيط، ويكشف الفاصل والأعمدة تلقائيًّا، ويعرض معاينة للصفقات المُحلَّلة، ثم يكتبها في دفتر التداول. وإعادة استيراد الملفّ نفسه تحدّث الصفوف الموجودة بدل تكرارها.
Senzoukria · التوثيق · آخر تحديث: سبتمبر 2026
أين تجده
- الموضع
- Journal ← Trades ← زرّ «Import CSV»
- المصادر
- Apex Trader Funding (الافتراضي)، وRithmic Trader، وNinjaTrader، وTradingView، وOther CSV
- الفاصل
- فاصلة أو فاصلة منقوطة أو جدولة، يُختار من السطر الأول
- مفتاح منع التكرار
- عمود معرّف الصفقة حين يوجد، وإلا فـ «{source}-row-{n}»
ما الذي يفعله
يقول الحوار: «Export from your broker dashboard, drop the file here. Re-imports dedupe automatically.». اختر مصدر الوسيط، ثم أفلت الملفّ أو استعمل «Browse file» (ملفّ csv أو نصّ). والمُحلِّل يزيل علامة ترتيب البايتات UTF-8، ويعالج الحقول المقتبَسة التي تتضمّن فواصل وعلامات اقتباس وأسطرًا جديدة، ويختار الفاصل الأكثر ظهورًا في سطر الترويسة.
وتعرض المعاينة اسم الملفّ، وعدد الصفوف المُحلَّلة والمتخطّاة، وعدد الأعمدة، وقائمةً قابلة للطيّ باسم «Column auto-mapping»، وأول 8 صفقات (Time وSymbol وSide وQty وEntry وExit وP&L). ونصّ الزرّ «Import N trades». وتطبع لوحة النتيجة «+N new · N updated» وعدد الصفوف الفاشلة إن وُجدت، مع «Import another» و«Done».
ربط الأعمدة
| الحقل | الترويسات المقبولة | مطلوب |
|---|---|---|
| symbol | symbol, instrument, contract, ticker | نعم |
| side | side, buy/sell, b/s, direction, type | نعم |
| entryPrice | entry price, open price, buy price, avg entry price, fill price | نعم |
| exitPrice | exit price, close price, sell price, avg exit price | لا |
| quantity | qty, quantity, size, contracts, shares, lots | لا (الافتراضي 1) |
| pnl | pnl, p/l, p&l, profit, net pnl, realized pnl, pl | لا |
| entryTime | entry time, open time, buy time, time, datetime, trade time, fill time | لا (الافتراضي هو الآن) |
| exitTime | exit time, close time, sell time | لا |
| commission | commission(s), fee(s) | لا |
| accountId | account, account id, account number | لا |
| externalId | trade id, order id, ticket id, execution id, id, fill id | لا |
| notes | notes, comment, memo, tag | لا |
تحليل القيم
- الجهة: B وBUY وLONG وL تصير LONG؛ وS وSELL وSHORT وSH تصير SHORT. وأي قيمة أخرى تتخطّى الصفّ.
- الأعداد: تُزال علامات الدولار والمسافات وفواصل الآلاف؛ والقيمة بين قوسين تُقرأ سالبة.
- الكمية تُقرَّب إلى عدد صحيح.
- التواريخ: كل ما يقبله محلّل Date في JavaScript (ISO، وMM/DD/YYYY…)، إضافةً إلى الصيغة المضغوطة YYYYMMDD HH:MM[:SS] التي تُقرأ بتوقيت UTC. والمخرَج بصيغة ISO 8601 بتوقيت UTC.
- والصفّ بلا رمز أو جهة أو سعر دخول يُعدّ متخطًّى؛ والصفوف الفارغة تُتجاهَل.
كيف تستعمله
صدّر قائمة الصفقات من لوحة الوسيط أو شركة التمويل، وأبقِ سطر الترويسة، وأفلت الملفّ. وافحص قائمة الربط التلقائي: فالحقل المربوط بـ «—» لم يُعثر عليه، وستكون الصفقات الناتجة بذلك الحقل فارغًا. وعمودا الوقت والحساب هما الأهمّ: فالصفقات المستورَدة بلا رقم حساب تحطّ في سلّة «No account recorded» في مُحدِّد الحساب.
والاستيراد إدراج أو تحديث مفهرَس بالمصدر وبالمعرّف الخارجي. فإعادة استيراد صادرات محدَّثة تنعش الصفوف المطابقة وتبلّغ عنها بوصفها «updated» بدل إنشاء نسخ مكرَّرة. وحين لا يحمل الملفّ عمود معرّف، يُستعمل رقم الصفّ، فتغيير ترتيب الصفوف بين صادرين يغيّر أي صفقة تُحدَّث.
الحدود والمزالق
- تحتفظ الصفقات المستورَدة بـ P&L الموجودة في الملفّ؛ ولا يُعاد حساب شيء من الأسعار وقيم النقاط.
- ولا تُقرأ من CSV الأطر الزمنية ولا الـ setup ولا التقييم ولا الانفعال ولا لقطات الشاشة؛ فأضفها بعد ذلك من نموذج الصفقة.
- وملفّ واحد في المرّة. واختيار المصدر يؤثّر في بادئة المعرّف الاحتياطية، لا في ربط الأعمدة.
- والتواريخ بلا منطقة زمنية يفسّرها محلّل Date بالمنطقة المحلّية للجهاز؛ أما الصيغة المضغوطة فتُعامَل بتوقيت UTC.
صفحات ذات صلة
- دفتر التداول: لسان الصفقات
- نظرة عامة على دفتر التداول ونطاق الحساب
- مزامنة دفتر التداول من Rithmic
- دليل الاختبار الرجعي للعقود الآجلة
هذه الصفحة بلغات أخرى
أسئلة شائعة
- لماذا تُخطّيت صفوف؟
- يُتخطّى الصفّ حين يتعذّر قراءة الرمز أو الجهة أو سعر الدخول. افتح قائمة «Column auto-mapping» لترى أي أعمدة لم تُكتشَف.
- هل يكرّر الاستيراد مرّتين صفقاتي؟
- لا، ما دام الملفّ يحمل عمود معرّف أو يحافظ على ترتيب الصفوف نفسه. فالصفوف المطابقة تُحدَّث وتُعدّ «updated».
- هل يحتاج الاستيراد اتصال وسيط؟
- لا. فهو يقرأ ملفًّا محلّيًّا ويكتب في قاعدة بيانات دفتر التداول المحلّية.