كيف تعرّف وصلات المخطط الانسيابي في ملف CSV

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

في ملف CSV، الوصلة موضع صف في عمود «الخط إلى» واسمها هو المدخل المقابل في «نص الخط»: عمودان من النص الصِرف يُقرنان بالموضع، بلا معرّفات وبلا اقتباس يحميهما.

باختصار

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

عمودان يحملان كل سهم في الملف

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

هذه هي الآلية كلها. «5,4» في «الخط إلى» يرسم سهمين، إلى صف البيانات الخامس والرابع في الملف؛ و«نعم,لا» في «نص الخط» يضع نعم على الأول ولا على الثاني. والاقتران موضعي لا بالاسم، ما يعني أن على الخليتين أن تبقيا متوافقتين يدوياً وأن أياً منهما لا يستطيع التحقق من الأخرى. اعكس الترتيب فيُستورد الملف مع ذلك، ويُرسم المخطط مع ذلك، ويقول عكس ما قصدت.

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

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

«الخط إلى» و«نص الخط» على شجرة قرارات من 25 صفاً

شجرة أهلية استرداد في أربع مراحل. افتح لوحة جدول البيانات لتقرأ عمودَي الوصل في مقابل الأسهم التي يرسمانها.

  1. صفوف وأشكال بلا أسهم بعد

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

  2. «الخط إلى» يشير إلى مواضع صفوف

    الآن امتلأت المواضع. «هل الطلب موجود في النظام؟» يقرأ «الخط إلى» فيه 5,4 ويتفرّع اتجاهين؛ و«هل الصنف مادي أم رقمي؟» يقرأ 8,11 فيشطر الشجرة إلى فرع مادي وآخر رقمي. ولاحظ أن 5,4 غير مرتّبة تصاعدياً، فالترتيب داخل الخلية ترتيب المؤلف، وهو الترتيب الذي سيُطابَق به «نص الخط».

  3. «نص الخط» يسمّي المخارج

    «كم عمر الطلب؟» يقرن 7,6,21 بـ«خلال 30 يوماً,من 31 إلى 90 يوماً,أكثر من 90 يوماً»: ثلاثة مواضع وثلاثة أسماء، مطابَقة واحداً بواحد بالترتيب. ولا يحتوي أي من تلك الأسماء فاصلة، وذلك مقصود لا مصادفة. وفي الصف 14 يشير «استبدال أم استرداد؟» إلى 19,12، و12 فوقه: سهم خلفي إلى «حساب مبلغ الاسترداد الكامل» يبدو خطأً وهو صحيح تماماً.

  4. نقاط الإنهاء والمسارات

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

كيف تعمل

  1. ثبّت ترتيب الصفوف قبل كتابة أي موضع

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

  2. رقّم صفوف البيانات بادئاً من 1 تحت الترويسة

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

  3. اكتب الخطوات وحيدة الخلَف أولاً

    امشِ في الملف من أعلى إلى أسفل وأعطِ كل خطوة مستقيمة رقماً واحداً في «الخط إلى». هذا سريع ويصعب الخطأ فيه، ولا يترك سوى التفرعات محتاجةً إلى تفكير. واترك الخلية فارغة في خطوة تنهي العملية فعلاً، فـ«الخط إلى» الفارغ هو ما يجعل الصف طرفياً.

  4. اكتب التفرعات مواضع مفصولة بفواصل

    في كل قرار، ضع كل الوجهات في خلية واحدة: 7,6,21 تعني ثلاثة مخارج. والمسافات حول الفواصل تُشذَّب، فـ«7, 6, 21» مقبولة. والذي يهم هو التسلسل، لأنك على وشك كتابة قائمة ثانية عليها أن تصطف معها مدخلاً بمدخل.

  5. اكتب «نص الخط» بالترتيب نفسه

    لـ«الخط إلى» بقيمة 7,6,21 اكتب «نص الخط» هكذا: خلال 30 يوماً,من 31 إلى 90 يوماً,أكثر من 90 يوماً. واقرأهما أزواجاً قبل أن تمضي: الموضع الأول مع الاسم الأول، والثاني مع الثاني. لا شيء يفحص هذا نيابةً عنك، والزوج المتقاطع ينتج مخططاً خاطئاً بثقة وبمظهر معقول.

  6. أفلِت الملف واقرأ الأسهم عائداً

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

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

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

    «نص الخط» يُقسَّم على الفواصل بعد أن يكون محلّل CSV قد نزع تغليف الحقل، فـ«نعم, باعتماد المشرف» تصير تفرّعين: «نعم» و«باعتماد المشرف». وتغليف الخلية باقتباسات لا يفيد، لأن التغليف استهلكته طبقة CSV والتقسيم يقع بعده. اكتب الاسم بلا فاصلة: «نعم باعتماد المشرف»، أو بشرطة.

  • إدراج صف دون إعادة ترقيم

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

  • قائمتان بطولين مختلفين

    ثلاثة مواضع واسمان يتركان السهم الثالث بلا اسم؛ وموضعان وثلاثة أسماء يُهملان الزائد. ولا شيء منهما يثير اعتراضاً. عُدّ الفواصل في الخليتين كلما كان لقرار أكثر من مخرجين، ففي هذه الشجرة أربعة صفوف تتفرّع ثلاثة اتجاهات، وهي مواضع وقوع ذلك.

  • افتراض أن الرقم الخلفي خطأ مطبعي

    قيمة «الخط إلى» الأصغر من رقم الصف الذي تجلس عليه ترسم سهماً عائداً إلى أعلى المخطط، وتلك حلقة طبيعية: مسار إعادة عمل، أو إعادة تقديم، أو حساب مشترك يُبلَغ من اتجاهين. و«استبدال أم استرداد؟» المشير إلى 12 في المثال واحد منها. لا تنظّف هذه لمجرد رؤيتها؛ وانظر /ar/guides/إنشاء-مخطط-انسيابي-من-csv لترى كيف يبدو الملف المكتمل.

افتح شجرة القرارات واقرأ عمود «الخط إلى» فيها

افتح شجرة الاسترداد كمخطط خاص بك، ثم استبدل الصفوف بصفوفك أنت وأبقِ عمودَي الوصل كما هما.

افتح شجرة القرارات واقرأ عمود «الخط إلى» فيها

أدلة ذات صلة

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

لماذا مواضع الصفوف بدل عمود معرّفات؟

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

هل أعدّ صف الترويسة حين أرقّم المواضع؟

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

هل تستطيع خطوة أن تشير إلى أكثر من صفين؟

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

ماذا يحدث إذا سمّى «الخط إلى» صفاً غير موجود؟

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

هل أستطيع استخدام اسم الخطوة في «الخط إلى» بدل رقم؟

لا: العمود يُقرأ مواضع. والأسماء ستكون ملتبسة في معظم الملفات الحقيقية: في هذه الشجرة أكثر من صف يقرأ بصيغة «هل يعتمد...؟» وعدة صفوف تقرأ صيغاً من السؤال نفسه. أما الرقم فلا لبس فيه بحكم بنائه، وهذا هو سبب كون الهوية موضعية لا نصية.

القالب الذي يقوم عليه هذا الدليل

قالب شجرة قرارات من CSV (أهلية الاسترداد) — شجرة قرارات لأهلية الاسترداد مبنية من تصدير CSV: 25 صفاً، و12 قراراً موسوماً، أربعة منها ثلاثية المخارج، وخمس نهايات منفصلة. تُظهر كيف يتطابق «الخط إلى» و«نص الخط» موضعاً بموضع.

شجرة قرارات أهلية الاسترداد (من الطلب حتى التسوية): الطلب → الأهلية → حالة الصنف → الفصل → الاعتماد → التسوية
كيف تعرّف وصلات المخطط الانسيابي في ملف CSV