v1.29: “نمٹا دیا گیا” کی حالت ایکسپورٹ اور API تک پہنچ گئی

FormFlow v1.29.0، جو 2026-10-02 کو جاری ہوا، “نمٹا دیا گیا” کی حالت کو اِن باکس سے باہر لاتا ہے۔ اب تک کسی سبمشن کو “نمٹا دیا گیا” نشان زد کرنا صرف FormFlow کے اندر نظر آتا تھا۔ اس ریلیز سے CSV، Excel اور JSON ایکسپورٹ یہ درج کرتے ہیں کہ ایسا کب ہوا، اور مینجمنٹ API وہی وقت لوٹاتا ہے اور اس پر فلٹر بھی کر سکتا ہے۔

کیا بدلا

• CSV اور Excel ایکسپورٹ میں “نمٹا دیا گیا” کالم شامل ہوتا ہے۔ فائل میں اس کا ہیڈر _handled_at ہے، جو سبمشن کے دیگر تفصیلی کالموں کی طرح لکھا جاتا ہے (مثلاً _id)۔

• JSON ایکسپورٹ میں ہر سبمشن پر handled_at کلید ہوتی ہے۔

• مینجمنٹ API ہر سبمشن پر handled_at لوٹاتا ہے، فہرست میں بھی اور اکیلے سبمشن میں بھی۔

• سبمشنز کی فہرست handled=true یا handled=false قبول کرتی ہے، تاکہ صرف نمٹائے گئے یا صرف کھلے سبمشنز حاصل ہوں۔

• ایکسپورٹ پکر میں یہ کالم درج ہوتا ہے، اس لیے آپ اسے غیر منتخب کر سکتے ہیں۔

یہ وقت کیا درج کرتا ہے

یہ قدر وہ لمحہ ہے جب ٹیم نے سبمشن کو “نمٹا دیا گیا” نشان زد کیا، ISO 8601 ٹائم اسٹیمپ کی صورت میں، جیسے 2026-10-02T09:30:00+00:00۔ FormFlow کی ایپلیکیشن گھڑی UTC پر سیٹ ہے، اس لیے آفسیٹ +00:00 ہے۔ یہ حالت ٹیم کی ہوتی ہے، کسی ایک رکن کی نہیں: کوئی تفویض شدہ شخص نہیں ہوتا، اور ایکسپورٹ میں وقت ہوتا ہے، شخص نہیں۔

حالت جس طرح لکھی جاتی ہے اس سے تین رویے نکلتے ہیں۔ پہلے سے نمٹائے گئے سبمشن کو دوبارہ نشان زد کرنے سے کچھ نہیں ہوتا، اس لیے پہلا وقت برقرار رہتا ہے۔ سبمشن دوبارہ کھولنے سے وقت مٹ جاتا ہے، اور جب تک وہ کھلا ہے خانہ خالی رہتا ہے۔ اگر آپ اسے دوبارہ کھول کر بعد میں پھر “نمٹا دیا گیا” نشان زد کریں تو کالم نیا وقت دکھاتا ہے اور پچھلا چلا جاتا ہے۔ FormFlow سے فارم بھرنے والے کو جواب بھیجنے پر بھی سبمشن “نمٹا دیا گیا” نشان زد ہو جاتا ہے، اس لیے وقت کلک کے بجائے جواب سے بھی آ سکتا ہے۔

ایکسپورٹ پکر میں

CSV اور Excel کے لیے ایکسپورٹ پکر وہ کالم درج کرتا ہے جنہیں آپ شامل کر سکتے ہیں۔ جس ایکسپورٹ میں تمام کالم منتخب ہوں اس میں اب “نمٹا دیا گیا” کالم ہوتا ہے۔ اسے غیر منتخب کریں تو فائل وہی ترتیب رکھتی ہے جو پہلے تھی، جو تب اہم ہے جب کوئی دوسرا ٹول فائل کو مقام کے لحاظ سے پڑھتا ہو۔ پھر بھی فائل کو ہیڈر کے نام سے پڑھنا زیادہ محفوظ ہے۔

JSON کے لیے پکر نہیں دکھایا جاتا۔ JSON ایکسپورٹ میں handled_at ہمیشہ شامل ہوتا ہے، اور جب تک سبمشن کھلا ہے وہ null ہوتا ہے۔ قطار میں لگا ہوا ایکسپورٹ کسی ایک لمحے کی کاپی ہوتا ہے، اس لیے v1.29.0 سے پہلے ڈاؤن لوڈ کی گئی فائلیں نہیں بدلتیں اور نیا ایکسپورٹ اس وقت کی حالت دکھاتا ہے جب وہ قطار میں لگایا گیا تھا۔

API کیا دکھاتا ہے

مینجمنٹ API میں، نمٹائے گئے سبمشن میں اسی ٹائم اسٹیمپ فارمیٹ میں handled_at شامل ہوتا ہے۔ کھلا سبمشن کلید کو مکمل طور پر چھوڑ دیتا ہے، جیسے read_at پہلے ہی اس وقت چھوڑا جاتا ہے جب سبمشن نہ پڑھا گیا ہو۔ یہ JSON ایکسپورٹ سے مختلف ہے، جو کلید رکھتا ہے اور اسے null کر دیتا ہے، اس لیے دونوں کو سنبھالنے والے کوڈ کو غائب کلید اور null کو ایک ہی بات سمجھنا چاہیے۔

فہرست پر handled=true صرف وہ سبمشنز لوٹاتا ہے جن کا نمٹائے جانے کا وقت ہو، اور handled=false صرف کھلے سبمشنز۔ اگر آپ پیرامیٹر چھوڑ دیں تو دونوں ملتے ہیں۔ یہ موجودہ is_spam اور unread فلٹرز اور q تلاش کے ساتھ ملایا جا سکتا ہے۔

اس کی حدود

• یہ وقت ہے، تاریخچہ نہیں۔ صرف تازہ ترین وقت ایکسپورٹ ہوتا ہے، اس لیے آپ یہ نہیں دیکھ سکتے کہ کوئی سبمشن دوبارہ کھولا گیا تھا۔

• یہ کسی کا نام نہیں بتاتا۔ ارکان کا موازنہ کرنے کے لیے اس کالم کو استعمال نہ کریں۔

• “نمٹا دیا گیا” کا مطلب ہے کہ معاملہ نمٹ گیا، ضروری نہیں کہ جواب دیا گیا ہو۔ کسی سبمشن کو فارم بھرنے والے کو کچھ لکھے بغیر بھی نمٹایا جا سکتا ہے۔

• یہ بذاتِ خود جوابی وقت کا پیمانہ نہیں ہے۔ آپ موصول ہونے کے وقت اور نمٹائے جانے کے وقت سے فرق نکال سکتے ہیں، مگر اس فرق میں وہ ہر وجہ شامل ہے جس سے سبمشن کھلا رہا، اور دوبارہ کھولنے سے وہ ری سیٹ ہو جاتا ہے۔

• یہ پہلے سے ایکسپورٹ کی گئی کسی چیز کو دوبارہ نہیں لکھتا۔

یہ مضمون ریلیز کی وضاحت کرتا ہے۔ v1.29.0 کے لیے “تبدیلیوں کا ریکارڈ” کا اندراج ہی اس بات کا ریکارڈ رہتا ہے کہ کیا جاری ہوا۔