كيف تبني ملف CSV ليُستورد مخططاً انسيابياً

باختصار

• صف الترويسة يجب أن يكون السطر الأول من الملف: لا الثالث تحت عنوان تقرير.
• أسماء الترويسة هي ما يُطابَق لا مواضع الأعمدة؛ والأعمدة غير المعروفة تُنقل وتُتجاهل.
• صف لكل خطوة لا صف لكل سجل. والتصدير في العادة سجل وقائع لا تعريف.
• مفصول بفواصل وبترميز UTF-8. والملف بفاصلة منقوطة من إعداد إقليمي أوروبي يصل عموداً واحداً.
• غلّف أي حقل يحتوي فاصلة أو علامة اقتباس أو سطراً جديداً؛ واكتب علامة الاقتباس الحرفية علامتين.

الملف هو الواجهة، فالملف يجب أن يكون صحيحاً

ملف CSV ليس جدول بيانات. هو ملف نصي صِرف بسطر لكل صف وفاصل بين الحقول، ولا يحمل أنواع خلايا ولا تنسيقاً ولا صيغاً ولا تبويباً ثانياً. ولهذا يصدّره كل نظام: مكتب المساعدة ونظام ERP ونظام الموارد البشرية وواجهة قاعدة البيانات جميعها تنتجه، ولا يتفق أي منها على شيء يتجاوز الفواصل. وهذا أيضاً سبب أن الاستيراد إما ينجح فوراً أو يخفق على نحو يبدو كأن شيئاً لم يحدث.

يقرأ QueryChart الملف باسم الترويسة. فالسطر الأول يجب أن يكون صف الترويسة، والأسماء التي عليه تُطابَق بأعمدة المحرر نفسه (#، و«الشكل»، و«نص المربّع»، و«الخط إلى»، و«نص الخط»، و«المسار الأفقي»، و«المسار الرأسي») لا بالمواضع، فترتيب أعمدتك لا يهم، والعمود الذي لا يتعرّف عليه QueryChart يُنقل كما هو ويُتجاهل. أفلِت ملف ‎.csv على منطقة جدول البيانات في مخطط، أو الصق الصفوف فيها. لا معالج استيراد ولا شاشة ربط أعمدة تمرّ بها، وهذه هي المقايضة: الربط يسكن في صف ترويستك بدل أن يسكن في نافذة حوار.

أما البقية فهي ما يضيّع الناس فيه بعد الظهر كاملاً، ولا شيء منها يخصّ المخططات. الملف المحفوظ على جهاز فاصل قوائمه فاصلة منقوطة ليس ملفاً مفصولاً بفواصل. والحقل الذي يحمل فاصلة يجب تغليفه وإلا صار حقلين. وعلامة ترتيب البايتات غير مرئية في كل محرر ومع ذلك تركب مع أول اسم ترويسة. والإشارة إلى خطوة بالرقم 007 تعود من رحلة ذهاب وإياب عبر جدول بيانات على هيئة 7. هذه مشكلات ملفات، وتستحق الإصلاح قبل التفكير في الأشكال أصلاً، ويغطي /ar/guides/تعريف-وصلات-المخطط-في-csv ما يوضع في أعمدة الوصل متى صار الملف نفسه مقروءاً.

المثال أدناه فرز تذاكر دعم مصدَّر على الوجه الصحيح: ثمانية عشر صفاً، صف لكل خطوة، مبنيّ عموداً تلو الآخر. اقرأه ملفاً لا صورة، فالمخطط هو ما تحصل عليه حين تكون الأعمدة صحيحة، لا شيء عليك أن تكدح فيه. وإن أردت ملفاً صحيحاً سلفاً تنسخ بنيته، فخذ واحداً من قوالب CSV مثل /ar/templates/شجرة-قرارات-من-csv.

ملف CSV واحد، مقروءاً عموداً تلو الآخر

فرز تذاكر الدعم في ثمانية عشر صفاً. افتح لوحة جدول البيانات لترى أي عمود من الملف تملؤه كل مرحلة.

1. صف ترويسة وسطر لكل خطوة

   السطر الأول من الملف يسمّي الأعمدة، وكل سطر تحته خطوة واحدة. والصفوف من 1 إلى 6 تمتد من «رفع تذكرة» حتى «تحديد الأولوية من الأثر والإلحاح»، كل منها على سطره ولا شيء فيه غير عنوان. هذا أدنى ما يحتاجه ملف ليُستورد أصلاً، وهو أيضاً الموضع الذي تكون فيه معظم التصديرات خاطئة سلفاً، لأنها تحمل سطراً لكل تذكرة لا سطراً لكل خطوة.

2. عمود «الشكل»

   «الشكل» قيمة يطابقها المحلّل، فتُكتب بدقة: بداية في الصف 1، وخطوة إجرائية في الصف 2، وقرار في الصفوف 3 و5 و7 و9. و«هل التفاصيل كافية للعمل على التذكرة؟» و«هل نجح الحل؟» معيّنان لأن الخلية تقول «قرار»، لا بسبب علامة الاستفهام. والقيمة التي لا يتعرّف عليها المحلّل ترتد إلى خطوة إجرائية بصمت، وهكذا ينتهي القرار مرسوماً مستطيلاً وأسماء تفرعاته لا تزال ملحقة به.

3. «الخط إلى» و«نص الخط»، مُغلَّفين

   الصف 5، «هل وصل الرد قبل انتهاء مهلة المتابعة؟»، يحمل في «الخط إلى» القيمة 6,18 وفي «نص الخط» القيمة «وصل الرد,لا رد»: قائمتان تُقرنان بالموضع، وكلتاهما تحتوي فاصلة، فالحقلان مُغلَّفان في الملف. و«نص المربّع» في الصف 13، «إصلاح كامل أم حل بديل مؤقت؟»، يخضع للقاعدة نفسها: أي فاصلة داخل عنوان تخصّ العنوان لا الصيغة، فيجب تغليف الحقل. انزع تلك الاقتباسات فيكسب الصف حقلاً وينزاح السطر كله عموداً واحداً.

4. عمودا المسار والملف المكتمل

   آخر عمودين يُطابَقان بالاسم كغيرهما تماماً: «المسار الأفقي» يحمل الرفع والفرز والخط الأول والتصعيد والإغلاق، و«المسار الرأسي» يحمل مقدّم الطلب ومكتب الخدمة والفريق المتخصص. وبملئهما تُرسم الأسطر الثمانية عشر نفسها مخطط مسارات، ينتهي عند «أُغلقت التذكرة» في الصف 17 و«أُغلقت دون رد من مقدّم الطلب» في الصف 18. ولم يتغيّر في الملف شيء سوى عمودين آخرين من النص الصِرف.

كيف تعمل

1. صدّر جدولاً واحداً بسيطاً

   أياً كان النظام الذي أتت منه البيانات، صدّر الشبكة ولا شيء غيرها. فعناوين التقارير، والختم الزمني، وسطر الشعار، والترويسات المدمجة، وصفوف المجاميع الجزئية، والسطر الفارغ في النهاية، تنتهي كلها أسطراً في الملف، ويُقرأ كل منها خطوةً. وإن كان في التصدير خيار «بيانات خام» أو «بلا تنسيق» فهو المطلوب.

2. اجعل صف الترويسة السطر الأول

   افتح الملف في محرر نصوص لا في جدول بيانات وانظر إلى السطر الأول. يجب أن يكون الترويسة. والتصديرات التي تبدأ بسطرين أو ثلاثة من البيانات الوصفية شائعة بما يكفي لجعل هذا أول ما تفحصه، وحذف تلك الأسطر هو الإصلاح كله.

3. أعد تسمية الترويسات بأسماء أعمدة QueryChart

   اضبط خلايا الترويسة على «الشكل» و«نص المربّع» و«الخط إلى» و«نص الخط» و«المسار الأفقي» و«المسار الرأسي». والمطابقة بالاسم، فيمكن للأعمدة أن تكون بأي ترتيب، ويمكنك ترك أعمدتك أنت (رقم التذكرة، والنظام، وزمن الدورة) في الملف دون مساس؛ فهي تُنقل وتُتجاهل لا تُرفض.

4. اختصر الصفوف إلى صف لكل خطوة

   التصدير في العادة سجل وقائع: سطر لكل تذكرة أو طلب أو حالة. والمخطط الانسيابي يحتاج سطراً لكل خطوة متمايزة، فحوِّل أو أزِل المكرر أولاً واحتفظ بالأحجام لتحليل لاحق. فالملف بأربعة آلاف سطر مجموعة بيانات لا عملية، واستيراده ينتج أربعة آلاف مربع.

5. رقّم الخطوات واملأ «الخط إلى»

   «الخط إلى» يحمل موضع سطر الوجهة بادئاً من 1، بعدّ أسطر البيانات وحدها، فأول خطوة تحت الترويسة موضعها 1. وليس رقم التذكرة ولا رمز الخطوة ولا أي شيء من النظام المصدر. وحيث تقود خطوة إلى موضعين، ضع الرقمين في الحقل الواحد مفصولين بفاصلة وغلّف الحقل.

6. أصلح الفاصل والترميز، ثم أفلِت الملف

   احفظ بترميز UTF-8 وبفواصل، ثم أفلِت ملف ‎.csv على منطقة جدول البيانات في مخطط جديد. واقرأ أول رسم فحصاً للملف: عدد الصفوف يجب أن يطابق عدد خطواتك، وكل عمود يجب أن يكون قد حطّ حيث تتوقع. والملف الذي يصل عموداً واحداً عريضاً مشكلة فاصل لا إخفاق استيراد.

أخطاء ينبغي تجنّبها

• ملف بفاصلة منقوطة وامتداده ‎.csv

  على جهاز فاصل قوائمه الإقليمي فاصلة منقوطة، يكتب «حفظ باسم CSV» فواصل منقوطة ويظل الملف منتهياً بـ‎.csv. فيصل عموداً واحداً وكل القيم داخله. أعد التصدير بفواصل، أو استبدل الفواصل في محرر نصوص قبل الاستيراد.

• صف الترويسة ليس السطر الأول

  تصديرات التقارير تضع عادةً عنواناً ونطاق تاريخ وسطراً فارغاً فوق البيانات. وQueryChart يقرأ السطر الأول ترويسةً، فتصير تلك الأسطر أسماء الأعمدة وتصير ترويستك الحقيقية خطوة. احذف كل ما فوق الترويسة.

• فاصلة داخل اسم تفرّع

  التغليف يحمي الحقل من محلّل CSV، لكن «نص الخط» يُقسَّم هو نفسه على الفواصل ليقرن الأسماء بالوجهات. فالتفرّع المسمّى «نعم, بعد الاعتماد» يصير اسمين مهما غُلّف. أعد تسمية التفرّع بدلاً من ذلك، والأسماء القصيرة أفضل على المخطط على أي حال.

• الأصفار البادئة والأرقام الطويلة بعد رحلة ذهاب وإياب

  ملف CSV بلا أنواع، فما تفتحه به هو الذي يقرّر. افتح وأعد الحفظ في جدول بيانات فيصير 007 هو 7، ويصير مرجع من ستة عشر رقماً ‎4.12346E+15‎، ويصير 3/4 تاريخاً. حرّر الملف في محرر نصوص، أو استورد العمود نصاً، وافحص القيم التي كانت رموزاً لا أرقاماً.

استورد ملف CSV مخططاً انسيابياً

افتح مثال فرز الدعم، ونزّل ملف CSV الخاص به لترى أسماء الأعمدة والتغليف بدقة، ثم أفلِت ملفك أنت فوقه.

استورد ملف CSV مخططاً انسيابياً

أدلة ذات صلة

• كيف تنشئ مخطط مسارات من ملف CSV
• CSV أم Excel للمخططات الانسيابية: من أي ملف تبني
• مخطط انسيابي لعملية تأهيل الموظفين الجدد — Excel

الأسئلة الشائعة

هل يهم ترتيب الأعمدة في ملف CSV عندي؟

لا. المطابقة على اسم الترويسة، فيمكن أن يكون «نص المربّع» العمود الرابع و«الشكل» الأخير. والذي يهم أن تكون الأسماء هي التي يستخدمها المحرر («الشكل» و«نص المربّع» و«الخط إلى» و«نص الخط» و«المسار الأفقي» و«المسار الرأسي») وأن تجلس على السطر الأول من الملف. أما الأعمدة التي لا يتعرّف عليها QueryChart فتُنقل وتُتجاهل، فلا حاجة إلى نزع أرقام تذاكرك أو أنظمتك أو أزمنتك أولاً.

أي فاصل وأي ترميز ينبغي أن يستخدم الملف؟

فواصل وترميز UTF-8. والفاصلة المنقوطة هي الإخفاق المعتاد: على جهاز فاصل قوائمه أوروبي، يكون «CSV» الخارج من إكسل مفصولاً بفواصل منقوطة، فيُستورد الملف عموداً واحداً. أما الترميز فيظهر على هيئة محارف مشوّهة: احفظ بصيغة «CSV UTF-8» لا CSV العادي. وإذا طابقت كل الأعمدة إلا الأول، فاشتبه بعلامة ترتيب البايتات: هي غير مرئية في المحرر لكنها ملتصقة بأول اسم ترويسة، فلم يعد ذلك الاسم يطابق شيئاً.

كيف أكتب حقلاً يحتوي فاصلة؟

غلّف الحقل كله بعلامتَي اقتباس مزدوجتين. وعلامة الاقتباس المزدوجة الحرفية داخل حقل مغلَّف تُكتب علامتين. وفواصل الأسطر داخل حقل مغلَّف مشروعة أيضاً، وإن كان عنوان مربع نادراً ما يحتاجها. وعمودا الوصل يحتاجان التغليف في الغالب دائماً، لأن «6,18» و«وصل الرد,لا رد» يحتويان الفاصل بحكم التصميم، وهذا بالضبط ما يقرن الأسماء بالوجهات.

تصديري فيه صف لكل تذكرة لا صف لكل خطوة. هل أستطيع استخدامه؟

ليس مباشرةً. سجل المعاملات يصف ما حدث آلاف المرات؛ والمخطط الانسيابي يصف ما يُفترض أن يحدث مرة واحدة. اختصره إلى الخطوات المتمايزة أولاً (وجدول محوري على عمود النشاط أو الحالة يكفي عادةً) واحتفظ بالأحجام على حدة، لأنها النصف المثير في تحليل أي عملية. ويمشي /ar/guides/تحويل-csv-إلى-خريطة-عمليات خلال هذا الاختصار على تصدير بهذا الشكل تماماً.

ما الأعمدة المطلوبة فعلاً؟

«نص المربّع» وحده يُستورد: تحصل على عمود من مربعات غير موصولة. أضف «الخط إلى» فيصير مخططاً انسيابياً، لأنه العمود الذي يحمل العلاقات. أما «الشكل» و«نص الخط» وعمودا المسار فتحسينات: قرارات مرسومة معيّنات، وتفرعات مسمّاة، وخطوات مسندة إلى مراحل ومسؤولين. وإن كنت تفضّل الانطلاق من ملف مبنيّ بنيةً صحيحة سلفاً، ففي قوالب CSV مثل /ar/templates/خريطة-رحلة-العميل-من-csv ملفات قابلة للتنزيل لمخططات تعمل.