→ المدونة
شروحات14 د قراءةThe Taskfolk team6 مشاهدةحُدِّث في

كيفية إعداد نموذج طلب

XLinkedIn

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

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

لماذا يتفوّق نموذج استقبال يُنشئ تذاكر على صندوق وارد مشترك

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

يثبّت النموذج شكل الطلب من المنبع. أنت تقرّر ما تسأل عنه. يملأ المُرسِل حقولك، لا صندوق نص فارغ، ويحوّل Taskfolk كل إرسالية إلى مهمة حقيقية في المشروع. لا إعادة كتابة. النموذج عقد صغير حول شكل الطلب الجيد، ويُفرَض قبل أن يصل أي شيء إلى لوحتك.

يذهب Taskfolk خطوة أبعد من جمع الإجابة. كل إرسالية تُنشئ مهمة في المشروع الذي يعيش فيه النموذج، ثم تُشغّل أتمتات issue.created الخاصة بتلك المساحة فوقها، فتنطلق قواعد الإسناد التلقائي والفرز والتوجيه تمامًا كما تنطلق لتذكرة كُتبت يدويًا. المسار من البداية إلى النهاية:

flowchart LR
  A["Submitter opens /f/token"] --> B["Honeypot and rate limit checks"]
  B --> C["Issue created with mapped fields"]
  C --> D["Routing defaults applied"]
  D --> E["issue.created automations run"]
  E --> F["Ticket on your board"]

إذا أردت النسخة الأعمق من ذلك المسار، فإن تحويل نموذج الطلب إلى مهمة مفروزة يغطّيه من البداية إلى النهاية.

نقطتان لضبط التوقعات قبل أن تبدأ. تعيش النماذج لكل مشروع، لا لكل مساحة عمل، فتبنيها حيث يهبط العمل. وبناؤها مقيَّد: مالكو مساحة العمل ومدراؤها وحدهم يملكون form.manage، فهم وحدهم من يقدر على إنشاء نموذج أو تعديله. العضو الذي يملك issue.create يقدر على فتح أداة البناء واستخدام إرسال تجريبي، لكنه لا يقدر على تغيير النموذج. هذا مقصود. النموذج العام سطح هجوم، ولا تريد أن يصنعه الجميع.

أين تعيش النماذج وإنشاء أول واحد

افتح المشروع الذي تريد أن تهبط فيه الطلبات. في هذه الجولة أستخدم المشروع التجريبي WEB، الذي تعمل لوحته بأعمدة قائمة الانتظار وللتنفيذ وقيد التنفيذ وقيد المراجعة ومنجزة. في شريط تبويبات المشروع تجد تبويب النماذج. انقر عليه.

قائمة النماذج هي جردك. يُظهر كل نموذج حالته (مسودة أو منشور أو مغلق)، ووسم Public حين يكون رابطه حيًّا، وعدّاد إرساليات لترى بلمحة أي النماذج يجذب حركة فعلية. في مشروع جديد تكون القائمة فارغة عدا نقطة الدخول الوحيدة التي تحتاجها: نموذج جديد +.

‏تبويب النماذج في المشروع يعرض النماذج الموجودة بحالة مسودة أو منشور أو مغلق، ووسم Public، وعدّادات الإرساليات، وزر نموذج جديد +، ما يوضّح أين تعيش ميزة الاستقبال في المشروع.

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

لاستقبال دعم أو خطأ، ابدأ من قالب تقرير الخطأ. يأتي بالحقول التي تحتاجها تذكرة خطأ جيدة مرتَّبةً مسبقًا، وتعديل حقل موجود أسرع من اختراع واحد من العدم. أعطِ النموذج اسمًا في خانة «‏Form name, e.g. Bug report»، شيئًا لا يراه المُرسِل أبدًا لكنك ستتعرّف عليه في القائمة، ثم انقر إنشاء. تهبط في أداة البناء.

بناء النموذج: أنواع الأسئلة الأربعة عشر

تُفتح أداة البناء على تبويب البناء، حيث يتشكّل النموذج. ترى القائمة المرتّبة للأسئلة، وفوقها زر إضافة سؤال +. انقره لتجد القائمة مجمَّعة كي لا تتصفّح لائحة مسطّحة من ثلاثين شيئًا:

  • نص: نص قصير، فقرة
  • اختيار: قائمة منسدلة، اختيار واحد، مربعات اختيار
  • رقم وتقييم: رقم، تقييم
  • تواصل: بريد إلكتروني، هاتف، رابط
  • تاريخ: تاريخ
  • ملف: رفع ملف
  • تخطيط: قسم، نعم / لا

‏كيفية إعداد نموذج طلب - تبويب البناء في أداة البناء

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

لكل سؤال لوحة إعداد خاصة به. تضبط التسمية (السؤال الذي يقرؤه المُرسِل)، ونص مساعدة اختياريًا، ونصًّا نائبًا لحقول النص. مفتاح مطلوب يقرّر ما إذا كان يمكن إرسال النموذج دونه. لأنواع الاختيار الثلاثة (قائمة منسدلة، اختيار واحد، مربعات اختيار) تكتب الخيارات واحدًا لكل سطر. حسب النوع تحصل أيضًا على تحقّق: الحد الأدنى والحد الأقصى في الرقم، والطول الأقصى في النص، والنجوم في التقييم، وقيمة افتراضية حيث يكون لها معنى.

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

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

ربط الحقول ليصبح الإرسال مهامّ منظَّمة

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

ثلاث وجهات حقيقية، إضافةً إلى «إبقاؤه في الإرسالية»:

  • عنوان المهمة. أول حقل مربوط بالعنوان يفوز، فالترتيب مهم. يقبل العنوان نصًّا قصيرًا أو طويلًا أو بريدًا إلكترونيًا أو رابطًا أو هاتفًا أو رقمًا.
  • وصف المهمة. نص قصير أو طويل.
  • أولوية المهمة. هذه دقيقة عن قصد. القائمة المنسدلة أو الاختيار الواحد وحدهما يقدران على الربط بالأولوية، وفقط حين تكون خياراتهما أسماء الأولوية الحرفية: lowest، low، medium، high، highest، critical. يوجد مساعد «‏Use priority options» يملؤها لك، كي لا تخطئ في كتابة «‏hihg» فتكسر الربط بهدوء.

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

flowchart TD
  Q["Form field answer"] --> M{"Maps to"}
  M --> T["Issue title"]
  M --> D["Issue description"]
  M --> P["Issue priority"]
  M --> N["Not mapped"]
  N --> L["Detail list at the bottom of the description"]

في نموذج تقرير الخطأ، اربط الملخص بعنوان المهمة، واربط اختيار الخطورة الواحد بأولوية المهمة (مع خيارات بأسماء الأولوية). الآن الإرسالية التي تقرأ خطورتها «‏high» تفتح مهمة عند أولوية High مسبقًا، ويصبح سطر الملخص عنوان التذكرة بدل جدار نص.

مقبضان آخران يعيشان على مستوى النموذج لا مستوى الحقل: نوع مهمة النموذج (مهمة أو قصة أو خطأ) وأولويته الافتراضية (من lowest إلى critical). كل مهمة يُنشئها النموذج ترث هذين. اضبط نوع نموذج تقرير الخطأ على خطأ ولن تعيد التصنيف أبدًا.

هذا هو سطح الربط كله، بصراحة: عنوان، أو وصف، أو أولوية، أو لا شيء. لا يوجد ربط حقل-بالمُسند-إليه ولا حقل-بالوسم. إن احتجت ضبط هذين لكل تذكرة، فذلك افتراض توجيه، نصل إليه أدناه. لمعرفة كيف تُقرأ المهمة المُنشأة حين تهبط، فإن كيفية إنشاء مهمة هي القطعة المرافقة.

المنطق الشرطي مع «‏Show only if»

النماذج الطويلة تفقد الناس. الحل أن تسأل كل سؤال فقط حين يكون وجيهًا، ولكل حقل عنصر تحكّم «‏Show only if» لهذا بالضبط. تختار حقل شرط (سؤالًا آخر في النموذج)، ومُعامِلًا، وقيمة، ثم تنقر إضافة شرط.

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

سلوك واحد هنا يستحق أن تستوعبه، لأنه ينقذك من خطأ كلاسيكي. الحقل المخفي لا يُعرَض، ولا يكون مطلوبًا، وتُسقَط إجابته من جهة الخادم. لا يمكنك عن طريق الخطأ أن تجعل حقلًا يخفيه شرطٌ مطلوبًا. لن يعلق النموذج أبدًا في حالة يُحجَب فيها المُرسِل بسؤال لا يراه. مفتاح مطلوب وشرط «‏Show only if» ببساطة لا يقدران على التصارع حتى الوقوع في فخ.

توسيم النموذج العام على تبويب التصميم

انتقل إلى تبويب التصميم، المُسمّى Branding في أداة البناء. هذا هو الوجه الذي يراه المُرسِلون الخارجيون، وبما أن نصفهم قد لا يعرف أن Taskfolk موجود، فهو يستحق ثلاثين ثانية من العناية.

يمكنك ضبط لون تمييز كقيمة hex، ورفع شعار، وإضافة صورة غلاف. يقبل الغلاف PNG أو JPG أو WebP أو GIF حتى 5 MB، مرفوعًا عبر مسار مُوقَّع مسبقًا كأي رفع آخر في Taskfolk. يوجد حقل نص رأسي، ومفتاح إظهار اسم المشروع إن أردت اسم المشروع على الصفحة العامة.

أبقه خفيفًا. لون تمييز واحد يطابق علامتك، وشعار، وربما غلاف، وانتهيت. لاحظ حدَّي الحجم كي لا تخلط بينهما لاحقًا: أصول العلامة التجارية (الشعار والغلاف) تُحدَّد بـ 5 MB، بينما الملفات التي يرفقها المُرسِل عبر حقل رفع الملف تُحدَّد بـ 10 MB. حدود مختلفة، أغراض مختلفة.

التوجيه والتسليم والوصول ضمن الإعدادات

تبويب الإعدادات يؤدّي العمل الثقيل، وينقسم إلى بضع مجموعات.

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

‏قائمة أتمتات المشروع، حيث تعمل قواعد issue.created فوق أي افتراضات توجيه يطبّقها النموذج.

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

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

الوصول يقرّر من يقدر أصلًا على فتح النموذج. ثلاثة جماهير:

الجمهور من يدخل
أي شخص لديه الرابط عام تمامًا، لا حاجة إلى حساب
أعضاء المشروع عضو مساحة عمل مسجّل الدخول، إضافةً إلى عضو مشروع حين يكون المشروع مقيَّدًا
البُرد المدعوّة فقط مسجّل الدخول، مع بريده على قائمة السماح التي تلصقها واحدًا لكل سطر

بمعزل عن الجمهور، يمكنك إضافة كلمة مرور، مُجزّأة بـ scrypt، مطلوبة لفتح النموذج.

الآن الحدود الصريحة، لأن هنا يعضّ الإفراط في الإعداد. التوجيه آمن على مستوى المستأجر بالتصميم، ما يعني أن قيمة حالة أو سبرنت أو مُسند إليه أو وسوم مفرطة التحديد لم تعد تنتمي إلى المشروع تُسقَط بصمت بدل أن تُطبَّق خطأً. احذف وسمًا وانسَ أن النموذج لا يزال يشير إليه، ولن يخطئ النموذج؛ بل يطبّق افتراضًا واحدًا أقل.

يجب أن يكون رابط إعادة التوجيه رابط http أو https مطلقًا؛ ومخططا javascript: وdata: مرفوضان تمامًا. وفتح كلمة المرور كوكي مدته 12 ساعة مربوط بتجزئة كلمة المرور الحالية، فتدوير كلمة المرور يُبطل كل فتح سابق. لا يوجد «حساب نموذج» منفصل. الجماهير المقيَّدة تعيد استخدام تسجيل الدخول الطبيعي بالرابط السحري في Taskfolk.

نشر الرابط ومشاركته

كل ما سبق كان مسودة. للانتقال إلى المباشر، جد مفتاح الرابط العام وفعّله. ذلك يسكّ رمزًا من 40 محرفًا ست عشريًا، ويضبط حالة النموذج على منشور، ويصبح النموذج حيًّا فورًا على /f/<token>. استخدم نسخ الرابط لأخذ الرابط، أو فتح النموذج لرؤيته. لجمهور «أي شخص لديه الرابط»، من ترسله إليه لا يحتاج حسابًا.

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

ما يراه المُرسِل صفحة موسومة نظيفة: لون تمييزك، وشعارك أو غلافك، ونص الرأس، ثم حقولك. إن لم تفعّل استجابة واحدة لكل بريد إلكتروني، فيوجد حقل اختياري «بريدك الإلكتروني». وزر إرسال الطلب. بعد أن يرسلوا، إما رسالة الشكر أو إعادة التوجيه. في الأسفل، سطر صغير «‏Powered by Taskfolk». هذا كل شيء.

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

ملاحظة حول قابلية الاكتشاف: صفحة /f/<token> عمدًا noindex وnofollow. لن تظهر في Google، وهذا مقصود. هي رابط مشاركة، لا صفحة هبوط. إن أردت العثور على النموذج، تربط إليه بنفسك.

مراجعة الإرساليات وإثبات الحلقة

افتح تبويب الإرساليات. هنا يُثبَت وعد «يُنشئ تذاكر»، لا يُدَّعى فقط. تحصل على قائمة قابلة للبحث بكل استجابة. يربط كل صف بمهمة KEY-NUM التي فتحها ويُظهر حالتها الراهنة، فتشاهد إرسالية عامة خامًا تصير، لنقل، WEB-142 جالسة في قائمة الانتظار، مُسندة، موسومة، أولويتها مضبوطة من قائمة الخطورة المنسدلة. لوحة عرض التفاصيل تُظهر الإرسالية الكاملة خلف أي صف. تصدير CSV يعطيك ملفًا برأس موسوم وصف لكل إرسالية حين تريد البيانات خارج Taskfolk.

‏لوحة كانبان بأعمدة مثل قائمة الانتظار وقيد التنفيذ، حيث تهبط إرساليات النموذج المُوجَّهة كتذاكر عادية تفرزها كأي تذكرة أخرى.

مرفقات الملفات تُغلق الحلقة ماديًا. يقدر المُرسِل المجهول على إرفاق ملف واحد لكل حقل رفع ملف، مُوقَّع مباشرةً إلى مساحة التخزين. الأنواع المسموحة هي PNG وJPG وGIF وWebP وPDF وDOC وDOCX وXLS وXLSX وTXT وCSV وZIP، حتى 10 MB لكل واحد، وعند الإرسال يُرفَق الملف بالمهمة المُنشأة. فلقطة الشاشة التي رفعها المُبلِّغ موجودة هناك على WEB-142، لا مدفونة في سلسلة بريد.

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

سحب الإرساليات عبر REST API

الإصدار v1 من الـ API بلا سقف 100 صف: GET /v1/workspaces/{slug}/projects/{key}/forms/{id}/submissions يتصفّح كل شيء بمؤشّر، من الأحدث، حتى 200 صف لكل صفحة. يحتاج مفتاح API بنطاق forms:read. احصل على معرّف النموذج من نقطة قائمة النماذج أولًا، ثم تصفّح:

curl "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/forms/<form-id>/submissions?limit=200" \
  -H "Authorization: Bearer tfk_live_a1b2..."
const res = await fetch(
  "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/forms/<form-id>/submissions?limit=200",
  { headers: { Authorization: "Bearer tfk_live_a1b2..." } },
);
const { data, pagination } = await res.json();
// pass pagination.next_cursor back as ?cursor= for the next page
import requests

res = requests.get(
    "https://taskfolk.ai/api/v1/workspaces/taskfolk/projects/WEB/forms/<form-id>/submissions",
    headers={"Authorization": "Bearer tfk_live_a1b2..."},
    params={"limit": 200},
)
body = res.json()
rows, next_cursor = body["data"], body["pagination"]["next_cursor"]

يحمل كل صف الإجابات الخام إضافةً إلى المهمة التي أنشأتها الإرسالية:

{
  "id": "0197c2ae-...",
  "answers": { "field-id-1": "Checkout button does nothing", "field-id-2": "high" },
  "submitter_email": "[email protected]",
  "source": "public",
  "created_issue_id": "0197c2ae-...",
  "created_issue_key": "WEB-142",
  "created_at": "2026-07-15T09:12:44.000Z"
}

حين يعود pagination.next_cursor بقيمة null، تكون قد حصلت على كل شيء.

أخطاء شائعة وحدود وحذف نموذج

بضع ملاحظات من الممارسة توفّر عليك تذكرة دعم خاصة بك.

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

ربط الأولوية يوقع الناس لأنه لا يعمل إلا على قائمة منسدلة أو اختيار واحد خياراتهما أسماء أولوية حرفية. اربط نصًّا قصيرًا بالأولوية ولن يُقبَل. استخدم مساعد «‏Use priority options» وتتخطّى صنف الأخطاء المطبعية كله.

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

تعمل حدود المعدّل ومصيدة النحل تلقائيًا لإبقاء الروبوتات والفيضانات خارجًا. أنت لا تضبطها، وبالتأكيد لا تخبر المُرسِلين بالالتفاف عليها. هي موجودة وحسب.

الحذف لطيف. «احذف هذا النموذج» يحذفه حذفًا ناعمًا ويعطّل الرابط العام، فيتوقّف رابط /f/<token> عن العمل، لكن كل مهمة أنشأها النموذج بالفعل تُحفَظ. تخسر سطح الاستقبال، لا العمل.

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

أسئلة شائعة

كيف أعدّ نموذج استقبال يُنشئ تذاكر في Taskfolk؟

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

هل يحتاج من يملأ النموذج إلى حساب Taskfolk؟

لا، إن اخترت جمهور «أي شخص لديه الرابط». عندها يكون النموذج عامًا تمامًا وأي شخص لديه رابط /f/ يقدر على الإرسال دون حساب. الجمهوران الآخران، أعضاء المشروع والبُرد المدعوّة فقط، يتطلّبان تسجيل الدخول عبر الرابط السحري الطبيعي في Taskfolk.

كيف تُربط إجابات النموذج بمهمة؟

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

هل يقدر النموذج على ضبط الأولوية تلقائيًا؟

نعم، لكن فقط عبر قائمة منسدلة أو اختيار واحد خياراتهما أسماء الأولوية الحرفية: lowest، low، medium، high، highest، critical. يوجد مساعد Use priority options يملؤها لك كي لا يكسر خطأ مطبعي الربط. ربط نص قصير بالأولوية لن يُقبَل.

أين أرى الإرساليات والتذاكر التي أنشأتها؟

في تبويب الإرساليات. تحصل على قائمة قابلة للبحث بكل استجابة، ويربط كل صف بمهمة KEY-NUM التي فتحها ويُظهر حالتها الراهنة، مع لوحة عرض تفاصيل وتصدير CSV. تُحدَّد كل من القائمة والتصدير بأحدث 100 استجابة؛ لسحب أكثر استخدم الـ v1 API الذي لا سقف صفوف له.

هل يقدر المُرسِلون على إرفاق ملفات مثل لقطات الشاشة؟

نعم، إذا احتوى النموذج على حقل رفع ملف. يقدر المُرسِل المجهول على إرفاق ملف واحد لكل حقل، والأنواع المسموحة PNG وJPG وGIF وWebP وPDF وDOC وDOCX وXLS وXLSX وTXT وCSV وZIP حتى 10 MB لكل واحد، ويُرفَق الملف بالمهمة المُنشأة عند الإرسال.

من المسموح له ببناء نموذج؟

مالكو مساحة العمل ومدراؤها وحدهم، لأنهم من يملك صلاحية form.manage. العضو الذي يملك issue.create يقدر على فتح أداة البناء واستخدام إرسال تجريبي، لكنه لا يقدر على إنشاء نموذج أو تعديله. هذا مقصود، لأن النموذج العام سطح هجوم.

ماذا يحدث للتذاكر الموجودة إن حذفت النموذج؟

الحذف لطيف: «احذف هذا النموذج» يحذفه حذفًا ناعمًا ويعطّل الرابط العام فيتوقّف رابط /f/ عن العمل، لكن كل مهمة أنشأها النموذج بالفعل تُحفَظ. تخسر سطح الاستقبال، لا العمل.

قراءات ذات صلة

أضف تعليقًا

ابدأ النقاش.