zplCloud Blog

Google Sheets प्रिंट वर्कफ़्लो से छपे लेबल तक

प्रिंटर → डिज़ाइन → स्प्रेडशीट → Print View। साथ में वह Apps Script जो वाकई ऑथेंटिकेट करती है।

September 14, 2026 4 मिनट पढ़ने का समय zplCloud Team

उस डेटा स्रोत से शुरू करें जो आपके पास पहले से है

अधिकांश लेबल प्रोजेक्ट प्रिंटर या डिज़ाइन पर नहीं अटकते। वे डेटा पर अटकते हैं: किसी को आर्टिकल सूची का मालिक होना पड़ता है, और "हम ERP कनेक्ट करेंगे" छह सप्ताह के टिकट में बदल जाता है।

इसलिए Google स्प्रेडशीट से शुरू करें। यह एक वास्तविक डेटा स्रोत है, कार्यालय में हर कोई इसे संपादित कर सकता है, और वहाँ से छपे लेबल तक का रास्ता छोटा है। जब ERP कनेक्शन अंततः तैयार हो जाता है, तो लेबल और प्रिंट पथ नहीं बदलते - केवल पंक्तियों का स्रोत बदलता है।

यह पूरी श्रृंखला है, शुरू से अंत तक।

1 - प्रिंटर नेटवर्क पर और कनेक्टेड

अनबॉक्स करें, मीडिया लोड करें, पावर चालू करें, नेटवर्क पर लाएँ, फिर इसे Weblink वन-लाइनर या CLI एजेंट के साथ zplCloud से कनेक्ट करें, और एक प्रिंटर प्रोफ़ाइल लागू करें ताकि डार्कनेस और स्पीड मीडिया से मेल खाएँ। यह स्पीड-रन पोस्ट में चरण-दर-चरण कवर किया गया है; 10 मिनट का बजट रखें।

2 - लेबल डिज़ाइन करें

डिज़ाइनर में, टेम्पलेट या खाली से शुरू करें और वे फ़ील्ड जोड़ें जो हर लेबल पर बदलते हैं: आर्टिकल नंबर, नाम, मात्रा, गंतव्य। बाइंडिंग का नाम स्प्रेडशीट कॉलम हेडर के बिल्कुल समान रखें - यह एक निर्णय बाद का सारा मैपिंग कार्य समाप्त कर देता है।

PNG, PDF या SVG के रूप में पूर्वावलोकन जाँचें। यह सर्वर-साइड उसी इंजन द्वारा रेंडर होता है जो ZPL उत्पन्न करता है, इसलिए यह अनुमानित नहीं है।

डिज़ाइन ID नोट करें। यह <नाम>.<id> है, जैसे shipping-label.42; API के लिए इसकी आवश्यकता होती है।

3 - स्प्रेडशीट

प्रति लेबल एक पंक्ति, प्रति बाइंडिंग एक कॉलम:

artikel_nr	name	menge	ziel
4006381333930	Cable tie 200 mm	50	Ramp 4
4006381333947	Cable tie 300 mm	25	Ramp 2

पथ A - बिना कोड। पंक्तियों को डिज़ाइनर के परीक्षण डेटा टैब या बैच जॉब में कॉपी करें और प्रिंट करें। यह साप्ताहिक प्रिंट रन के लिए पर्याप्त है और इसमें कोई सेटअप नहीं लगता।

पथ B - Apps Script। शीट ट्रिगर बन जाती है। API कुंजी के साथ सार्वजनिक API के माध्यम से रेंडर करें:

// एक्सटेंशन → Apps Script। सक्रिय पंक्ति रेंडर करता है और ZPL लौटाता है।
const API_KEY   = 'sk_zplcloud_…';               // प्लेटफ़ॉर्म में API टैब
const DESIGN_ID = 'shipping-label.42';           // "<नाम>.<id>"

function renderActiveRow() {
  const sheet  = SpreadsheetApp.getActiveSheet();
  const header = sheet.getRange(1, 1, 1, sheet.getLastColumn()).getValues()[0];
  const row    = sheet.getRange(sheet.getActiveCell().getRow(), 1, 1, sheet.getLastColumn()).getValues()[0];

  // बॉडी रिकॉर्ड की एक सरणी है: कुंजियाँ डिज़ाइन की बाइंडिंग से मेल खानी चाहिए।
  const record = {};
  header.forEach((col, i) => record[col] = row[i]);

  const res = UrlFetchApp.fetch(
    'https://api.zplcloud.com/v1/zpl/render/design/' + DESIGN_ID,
    {
      method: 'post',
      contentType: 'application/json',
      headers: { 'X-API-Key': API_KEY },
      payload: JSON.stringify([record]),
      muteHttpExceptions: true          // अन्यथा 4xx संदेश पढ़ने से पहले फेंक देता है
    });

  if (res.getResponseCode() !== 200) throw new Error(res.getContentText());
  return res.getContentText();          // ZPL
}

दो सीमाएँ जिनके चारों ओर डिज़ाइन करना है, दोनों API द्वारा लागू:

प्रति अनुरोध 500 रिकॉर्ड - बड़े रन को हिस्सों में बाँटें।
1 MB अनुरोध बॉडी - सामान्य लेबल डेटा के साथ वह हज़ारों पंक्तियाँ हैं, इसलिए रिकॉर्ड कैप पहले बाँधती है।

एक कस्टम मेनू जोड़ें (onOpen → SpreadsheetApp.getUi().createMenu(...)) और आपके सहकर्मियों को शीट के अपने मेनू बार में एक प्रिंट प्रविष्टि मिलती है।

4 - ZPL को प्रिंटर तक पहुँचाना

रेंडर और प्रिंट जानबूझकर दो चरण हैं - आप अभी रेंडर कर सकते हैं और बाद में प्रिंट कर सकते हैं, या एक बार रेंडर करके तीन साइटों पर प्रिंट कर सकते हैं।

प्लेटफ़ॉर्म से: डिज़ाइन एक क्लिक में Weblink या एजेंट प्रिंटर पर प्रिंट होता है, बिना स्क्रिप्ट के।
अपने कोड से: एजेंट के माध्यम से TCP 9100 पर ZPL प्रिंटर को भेजें, या इसे ऑपरेटर की मशीन पर CloudToBrowserPrint को सौंप दें।
किसी व्यक्ति के लिए: स्क्रिप्ट को पूरी तरह छोड़ें और उन्हें Print View दें (अगला चरण)।

5 - उन लोगों के लिए Print View जो वास्तव में प्रिंट करते हैं

डिज़ाइन से Print View बनाएँ, menge और ziel को संपादन योग्य चिह्नित करें, artikel_nr लॉक करें, और दृश्य को स्प्रेडशीट डेटा या लुकअप से समर्थित करें। URL साझा करें या QR कोड प्रिंट करके प्रिंटर के पास चिपकाएँ।

ऑपरेटर फ़ोन पर लिंक खोलता है, आर्टिकल बारकोड को फ़ील्ड में स्कैन करता है, लाइव पूर्वावलोकन जाँचता है और प्रिंट दबाता है। कोई ऐप नहीं, कोई प्रशिक्षण नहीं।

पूरी श्रृंखला

चरण	क्या	समय
1	प्रिंटर + Weblink/एजेंट + प्रोफ़ाइल	~10 मिनट
2	कॉलम जैसे नाम वाली बाइंडिंग वाला डिज़ाइन	~5 मिनट
3	स्प्रेडशीट, वैकल्पिक रूप से Apps Script	~5 मिनट
4	प्रिंट पथ (प्लेटफ़ॉर्म, API या Print View)	~2 मिनट
5	ऑपरेटर स्कैन और प्रिंट करता है	सेकंड

स्प्रेडशीट एक बचाव योग्य विकल्प क्यों है

यह कोई समझौता नहीं है जिसके लिए आप माफ़ी माँगें। एक शीट आपको वर्जनिंग, टिप्पणियाँ, प्रति-उपयोगकर्ता पहुँच और ऑडिट ट्रेल तुरंत देती है, और किसी को ऑनबोर्डिंग की आवश्यकता नहीं। इसकी वास्तविक सीमाएँ समवर्ती और संदर्भात्मक अखंडता हैं - जब एक शिफ्ट के दौरान दो लोग एक ही पंक्ति संपादित करते हैं, या जब आर्टिकल सूची को ERP से बिल्कुल मेल खाना होता है, तो वह data hub पर जाकर सीधे SQL Server या MongoDB से पूछने का संकेत है।

माइग्रेशन सीमित है: वही डिज़ाइन, वही बाइंडिंग, वही Print View। केवल डेटा स्रोत बदलता है।