استورد العملاء والفروع والأصناف والأسعار
حمّل سجلات كثيرة من جدول بيانات محفوظ بصيغة CSV. يفحص Slflo الملف كله أولاً، ولا يستورده إلا إذا كان كل سطر فيه سليماً. لمن: مدير النظام · أين في الدورة: الإعداد.
قبل أن تبدأ
Section titled “قبل أن تبدأ”- صلاحية إضافة العملاء وتعديلهم (CUSTOMER_MANAGE) لتبويبي العملاء والفروع؛ وصلاحية إدارة المنتجات والأسعار (CATALOG_MANAGE) لتبويبي الأصناف والأسعار. ووضع الفروع على خطوط السير يحتاج أيضاً إلى إدارة الأشخاص (USER_MANAGE).
- استورد بهذا الترتيب: العملاء قبل فروعهم؛ والوحدات قبل الأصناف؛ والأصناف وقوائم الأسعار قبل الأسعار.
- خط السير المذكور في الملف يجب أن يكون موجوداً (تكفي المسودة)؛ أنشئه أولاً من خطوط السير. الاستيراد لا ينشئ خطوط سير.
- احفظ الملف بصيغة CSV UTF-8 مفصول بفواصل، مع سطر عناوين في أوله.
الأعمدة
Section titled “الأعمدة”تعرض الشاشة أعمدة كل تبويب وما يُكتب فيها. أسماء الأعمدة لا تتأثر بحالة الأحرف ولا بالمسافات ولا بالشرطات.
| التبويب | إلزامي | اختياري |
|---|---|---|
| العملاء | name |
code، namear، creditlimit، currency، pricelist، latitude، longitude، geofenceradius، address، blocked، channel، paymentterms، deliverydays، contact، phone، opendays، area، route، visitdays، visitevery، effectivefrom |
| الفروع | customer، code، name |
مثل العملاء، لذلك الفرع |
| الأصناف | name، baseuom |
code، namear، category |
| الأسعار | pricelist، product، uom، unitprice، validfrom |
validto |
الخلية الفارغة تُبقي ما هو مخزّن. والـcode الموجود يحدّث سجله، فالملف الذي فيه أكواد يمكن
استيراده مرتين دون أن يتغيّر شيء؛ أما السطر بلا كود فينشئ سجلاً جديداً دائماً، فاستيراده مرة
ثانية يصنع تكراراً. والعميل الجديد الذي creditlimit له فارغ يكون نقداً فقط (0)؛ واكتب no limit
لتجعله بلا حد. تُكتب الأيام هكذا Sat Wed (أو بالعربية)؛
وقيمة visitevery هي week أو 2 weeks أو weeks 1 3 أو month.
الخطوات
Section titled “الخطوات”- افتح الإعداد › استيراد واختر التبويب.
- اختر ملف CSV.
- اضغط افحص الملف. لا يُحفظ شيء بعد.
- اقرأ النتيجة. جاهز للاستيراد يعرض الأعداد (الأسطر، سيُنشأ، سيُعدَّل، دون تغيير)، وخطوط السير التي يمسّها هذا الملف، وما يفعله كل سطر. أما لم يتم الاستيراد فيعرض كل مشكلة مع رقم سطرها في جدول البيانات.
- أصلح الأسطر التي فيها مشكلات في جدول البيانات، واحفظه، واختر الملف مرة أخرى، ثم افحص الملف من جديد.
- حين يخلو الفحص من المشكلات، اضغط استيراد. تظهر رسالة “تم. تستلم الأجهزة هذا في المزامنة التالية.”

- ما الذي تستورده

- السطر
- المشكلة
- التفاصيل
تحفظ نايل فريش أولاً خط السير CAIRO-03 مسودةً، ثم تستورد عملاءها الأربعة في ملف واحد:
name,creditlimit,pricelist,channel,geofenceradius,route,visitdays,visiteveryNile Market,5000,RETAIL,Retail,150,CAIRO-03,Sat Wed,weekDelta Kiosk,300,RETAIL,Retail,150,CAIRO-03,Sat Wed,weekZamalek Corner,3000,RETAIL,Retail,150,CAIRO-03,Sat Wed,weekGarden City Grocer,2000,RETAIL,Retail,150,CAIRO-03,Sat Wed,weekافحص الملف ← جاهز للاستيراد: الأسطر 4، سيُنشأ 4؛ خطوط السير التي يمسّها هذا الملف:
CAIRO-03، أُضيف 4. استيراد ← يُنشأ العملاء من CUST-00001 إلى CUST-00004، ولكل منهم فرعه
الرئيسي على CAIRO-03. (أضف عمودي latitude وlongitude لتحدد مواقعهم على الخريطة.)
ماذا يحدث بعد ذلك
Section titled “ماذا يحدث بعد ذلك”- تُنشأ السجلات أو تُحدَّث معاً دفعة واحدة؛ والفروع الموضوعة على خطوط سير تحصل على خطط أيام من تاريخها.
- يحصل المندوبون على التغييرات في مزامنتهم التالية.
- صف واحد في سجل التغييرات لكل ملف مستورد (“استورد ملفاً”).
إذا حدث خطأ
Section titled “إذا حدث خطأ”سطر واحد خاطئ يوقف الملف كله: لا يُستورد شيء حتى تسلم كل الأسطر في الفحص.
| ما تراه | ما تفعله |
|---|---|
لا يوجد خط سير بهذا الرمز. أنشئ خط السير من صفحة خطوط السير أولاً ثم استورد مرة أخرى. UNKNOWN_ROUTE | أنشئ خط السير من العملاء › خطوط السير أولاً (تكفي المسودة)، ثم افحص الملف من جديد. |
لا يوجد عميل بهذا الرمز. استورد العملاء أولاً ثم فروعهم. UNKNOWN_CUSTOMER | استورد ملف العملاء قبل ملف الفروع. |
هذا السطر يكرر رمز سطر سابق في الملف. أبقِ واحداً منهما. DUPLICATE_IN_FILE | سطران يحملان الكود نفسه. أبقِ واحداً. |
تعذّرت قراءة رقم. اكتب أرقاماً فقط، مثل 5000. INVALID_NUMBER | اكتب أرقاماً فقط في أعمدة الأرقام. |
تعذّرت قراءة أيام الزيارة. اكتب الأيام مثل Sat Tue أو السبت الثلاثاء، والتكرار: week أو 2 weeks أو month أو weeks 1 3. IMPORT_VISIT_PATTERN | اكتب الأيام هكذا Sat Wed، وعدد المرات week أو 2 weeks أو weeks 1 3 أو month. |
لا توجد قائمة أسعار بهذا الرمز. راجع الرمز في الكتالوج، قوائم الأسعار. UNKNOWN_PRICE_LIST | استخدم كود قائمة الأسعار كما يظهر في كتالوج الأصناف › قوائم الأسعار. |
وضع الفروع على خطوط السير يحتاج صلاحية إدارة المستخدمين. اطلبها من المسؤول، أو اترك أعمدة خط السير فارغة. IMPORT_ROUTE_NOT_ALLOWED | وضع الفروع على خطوط السير يحتاج إلى إدارة الأشخاص. اترك أعمدة خط السير فارغة، أو اطلب ذلك من مدير النظام. |
عمود مطلوب فارغ في هذا السطر. املأه وافحص الملف مرة أخرى. MISSING | عمود إلزامي فارغ في ذلك السطر. |
هذا الملف مفصول بفواصل منقوطة… | احفظه مرة أخرى بصيغة CSV UTF-8 مفصول بفواصل. |
تعذرت قراءة هذا الملف | احفظه نصاً بترميز UTF-8. الملفات الكبيرة جداً (نحو 1 MB فأكثر) قد تُرفض: قسّمها. |
عاد عميل محذوف | الكود الذي كان لعميل محذوف يعيده بسجله كاملاً. استخدم كوداً جديداً للمحل الجديد. |
مستخدمو الكتالوج وحده (بدون إضافة العملاء وتعديلهم) لا يرون استيراد في القائمة؛ ويفتحونه من
/admin/import.

