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 की बदलावों की सूची की प्रविष्टि ही इस बात का रिकॉर्ड बनी रहती है कि क्या जारी हुआ।