অফার AIinBangla-র সব কোর্সে ২০% ছাড় ২৫ নভেম্বর পর্যন্ত

AI Champions কোর্স দেখুন
মূল অংশে যান
AIinBangla

n8n Execution Data ব্যবহার: এক্সিকিউশন খোঁজা, চিহ্ন দেওয়া আর ডিবাগ করা

n8n Execution Data দিয়ে প্রতিটি রানে ছোট চিহ্ন রাখুন: Code নোডে set ও get, Execution Data নোড, ১০টি ঘরের সীমা আর ব্যক্তিগত তথ্য ছাড়া রান খুঁজে পাওয়ার নিয়ম।

n8n execution custom data দিয়ে order reference ও workflow run খুঁজে বের করা

n8n Execution Data বা custom execution data প্রতিটি রানের সঙ্গে ছোট কিছু চাবি আর মান জুড়ে রাখে, যাতে Executions তালিকা থেকে অর্ডার রেফারেন্স, পরিবেশ বা দায়িত্বপ্রাপ্ত টিম দিয়ে রানটি খুঁজে পাওয়া যায়। Code নোড বা Execution Data নোড দিয়ে মান বসানো যায়, আর চলতি রানে মান পড়া যায় শুধু Code নোড থেকে। এটি পুরো ডেটা রাখার জায়গা নয়: সর্বোচ্চ ১০টি ঘর, চাবি ৫০ অক্ষর আর মান ২৫৫ অক্ষর পর্যন্ত, সবই লেখা হিসেবে।

এক নজরে

  • JavaScript Code নোডে $execution.customData.set(key, value), আর Python-এ _execution.customData.set ব্যবহার করুন।
  • setAll পুরো অবজেক্টটাই বদলে দেয়, তাই আগের মান রাখতে চাইলে আগে getAll করে সচেতনভাবে মিলিয়ে নিন।
  • চাবি সর্বোচ্চ ৫০ অক্ষর, মান ২৫৫ অক্ষর, ঘর সর্বোচ্চ ১০টি, আর সব মান লেখা বা string হতে হবে।
  • ফিচারটি Cloud Pro ও Enterprise এবং নিবন্ধিত self-hosted Community ও Enterprise-এ পাওয়ার কথা বলা আছে, নিজের প্ল্যান মিলিয়ে নিন।
  • কোন চাবিগুলো থাকবে তা আগেই ঠিক করুন এবং সব ওয়ার্কফ্লোতে একই নাম রাখুন, নইলে একসঙ্গে খোঁজা কাজ করে না।

Custom execution data কেন দরকার হয়?

n8n-এর এক্সিকিউশন ID একটি প্রযুক্তিগত নম্বর, কিন্তু সাপোর্টের মানুষটি সাধারণত জানেন আবেদন নম্বর, অর্ডার রেফারেন্স বা ক্যাম্পেইনের ব্যাচ। Custom execution data সেই নিরাপদ ব্যবসায়িক তথ্যটুকু রানের গায়ে লাগিয়ে রাখে, ফলে এক্সিকিউশনের তালিকা ছেঁকে ঠিক রানটি বের করা যায়। প্রতিটি রানের পুরো ইনপুট খুলে খুঁজতে হয় না।

তবে এটি লগ রাখার ডেটাবেস নয়। লম্বা stack trace, কাস্টমারের বার্তা, পুরো ইমেইল বা API-এর উত্তর ২৫৫ অক্ষরের ঘরে ঢোকানোর চেষ্টা করবেন না, রাখা উচিতও নয়। বিস্তারিত প্রমাণ থাকবে এক্সিকিউশনের নিজের ডেটায় বা অনুমোদিত লগ সিস্টেমে। Custom data কাজ করবে বইয়ের সূচিপত্রের মতো, যা দেখে ঠিক পাতায় পৌঁছানো যায়।

এই বিষয়টা হাতে-কলমে শিখতে চাইলে: AI অটোমেশন Masterclass (৳2,399)

Code নোড দিয়ে মান কীভাবে বসাবেন?

JavaScript Code নোডে একটি মান বসাতে set ব্যবহার করুন:

$execution.customData.set("admissionRef", "SA-26-1842");

অনেকগুলো মান একসঙ্গে বসাতে চাইলে setAll:

$execution.customData.setAll({"admissionRef":"SA-26-1842","environment":"production","owner":"admissions"});

Python Code নোডে একই কাজের অবজেক্ট হলো _execution.customData। এখানে একটা সতর্কতা জরুরি: setAll আগের পুরো অবজেক্টটাই মুছে নতুনটি বসায়। আগে অন্য কোনো নোড মান বসিয়ে থাকলে সেগুলো অজান্তে হারিয়ে যেতে পারে। তাই নাম রাখার একটা নিয়ম ঠিক করুন, আর চেষ্টা করুন একটি নোডই এই কাজের দায়িত্বে থাকুক।

Execution Data নোড কী পারে আর কী পারে না?

Execution Data নোড কোড না লিখেই custom data বসাতে দেয়, কিন্তু মান পড়ে আনতে পারে না। n8n-এর ডকুমেন্টেশনে এটা স্পষ্ট বলা আছে। চলতি রানে মান পড়তে হলে Code নোডে $execution.customData.getAll() বা get("key") ব্যবহার করুন। Python-এ এর সমতুল্য _execution.customData.getAll() আর get()।

কখন বসাবেন, সেটাও ভাবার বিষয়। ওয়ার্কফ্লোর শুরুতে বসালে একদম প্রথম দিকের ব্যর্থতাও খুঁজে পাওয়া যায়। কিন্তু ট্রিগারের ডেটা পড়ার আগে যদি ব্যবসায়িক রেফারেন্স হাতে না আসে, তাহলে ডেটা পড়ার নোডের ঠিক পরেই বসান।

স্কুলে ভর্তির ওয়ার্কফ্লোতে এটা কীভাবে কাজে লাগল?

কাল্পনিক Shapla Academy-তে অনলাইন ফর্ম থেকে ভর্তির আবেদন আসে। ওয়ার্কফ্লো কাগজপত্র যাচাই করে, পেমেন্টের রেফারেন্স মেলায়, তারপর অভিভাবককে নিশ্চিতকরণ ইমেইল পাঠায়। সমস্যা হলো, সাপোর্ট টিম অভিভাবকের ফোন নম্বর দিয়ে রান খুঁজতে চাইছিল, যা ব্যক্তিগত তথ্যের ঝুঁকি। টিম তাই একটি নিরীহ ভর্তি রেফারেন্স বানাল: SA-26-1842।

যাচাইয়ের পর Execution Data নোড পাঁচটি মান বসাল:

  • admissionRef=SA-26-1842
  • class=Six
  • route=online
  • environment=production
  • owner=admissions

আবেদনকারীর নাম, অভিভাবকের ফোন, জন্মরেজিস্ট্রেশন নম্বর বা পেমেন্টের গোপন তথ্য এখানে রাখা হলো না। একদিন নিশ্চিতকরণ ইমেইল ব্যর্থ হলো। সাপোর্টের কর্মী Executions তালিকায় ভর্তি রেফারেন্স দিয়ে ছেঁকে রানটি খুললেন এবং কোন নোডে আটকেছে দেখলেন। অভিভাবককে ভেতরের এক্সিকিউশন লিংক দেওয়া হয়নি।

আবার চালানোর আগে তিনি পেমেন্ট খোঁজার নোডের ফলাফল মিলিয়ে দেখলেন, আর বাইরের ডেটাবেসে ইমেইল পাঠানো হয়েছে কি না তার চিহ্ন আছে কি না যাচাই করলেন। Custom data খুঁজে পাওয়া সহজ করেছে ঠিকই, কিন্তু একই ইমেইল দুবার যাওয়া ঠেকানোর কাজ এর নয়।

সীমাগুলো ডিজাইনে কী প্রভাব ফেলে?

সব মান লেখা বা string হতে হবে, তাই সংখ্যা রাখতে চাইলে আগে লেখায় রূপান্তর করতে হয়, আর তখন ছাঁকনিও লেখা হিসেবেই কাজ করতে পারে। খুব লম্বা নম্বর, যেমন ১৪ অঙ্কের বেশি কোনো ID, সংখ্যা হিসেবে রাখলে নির্ভুলতা হারাতে পারে, তাই লেখা হিসেবেই রাখুন। চাবি সর্বোচ্চ ৫০ অক্ষর, মান ২৫৫ অক্ষর, আর ঘর ১০টি। কাজেই বড় JSON চেপে ঢোকানো ভুল পথ। ছোট আর স্থির কয়েকটি ঘর বেছে নিন।

প্রস্তাবিত চাবিগুলো হতে পারে businessRef, environment, tenant, owner, batch আর severity। একই ধারণার জন্য এক ওয়ার্কফ্লোতে env, আরেকটায় environmentName, তৃতীয়টায় stage লিখলে একসঙ্গে সব ওয়ার্কফ্লোতে খোঁজা দুর্বল হয়ে যায়। ১০টি ঘরের হিসাবও মাথায় রাখুন। ওয়ার্কফ্লো ID, কাস্টমারের নাম, ভুলের লেখা বা পুরো সময় আলাদা ঘরে রাখার দরকার নেই, যদি সেগুলো রেকর্ড থেকেই পাওয়া যায়।

setAll-এর মুছে ফেলার সমস্যা কীভাবে এড়াবেন?

একাধিক নোড মান বসালে প্রতিটিতে আলাদা set ব্যবহার করুন। একান্তই setAll দরকার হলে আগে চলতি অবজেক্ট পড়ুন, নিজে হাতে মিলিয়ে নতুন অবজেক্ট বানান, তারপর ফলাফল খুলে দেখুন। সমান্তরাল দুটি শাখা একই চাবি বদলালে কোনটার মান শেষে থাকবে তা অনিশ্চিত হতে পারে, তাই এই কাজের মালিক একটি নোডই রাখুন।

ভেতরের বা সংরক্ষিত মনে হয় এমন নাম এড়াতে টিমের একটা উপসর্গ ব্যবহার করতে পারেন, যেমন ops_owner। পরিকল্পনা ছাড়া চাবির নাম বদলাবেন না। পুরোনো রানগুলোতে পুরোনো নামই থেকে যায়, ফলে সেভ করা ছাঁকনি আর ড্যাশবোর্ড ভেঙে যায়।

সমস্যার সময় Executions তালিকা কীভাবে কাজে লাগাবেন?

কিছু ভাঙলে ওয়ার্কফ্লোর নাম, ব্যবসায়িক রেফারেন্স আর অবস্থা একসঙ্গে দিয়ে খোঁজার পরিসর ছোট করুন। environment চাবি থাকলে টেস্ট আর প্রোডাকশনের রান মিশে যায় না, আর batch চাবি পুরো ক্যাম্পেইনের ব্যর্থতা একসঙ্গে দেখায়। ফলাফল থেকে রানটি খুলে আসল ইনপুট, শেষ সফল নোড আর ভুলের বার্তা দেখুন। মনে রাখবেন, custom data নিজে ভুলের কারণ বলে না, শুধু পথ দেখায়।

খুঁজে কিছু না পেলে দেখুন, মান বসানোর নোডটি যে শাখায় আছে রানটি সেখানে পৌঁছেছিল কি না। মানটি লেখায় রূপান্তর হয়েছিল কি না, আর এক্সিকিউশন সেভ করার নিয়ম চালু আছে কি না, সেটাও নিশ্চিত হন। বিরামচিহ্ন বা বড় ছোট হাতের অক্ষর বদলালে খোঁজার ফলাফল বদলে যেতে পারে, তাই সাপোর্ট টিমকে একটি নমুনা রান খুঁজে দেখার অনুশীলন করিয়ে নিন।

ফিচারটি দেখা না গেলে কী যাচাই করবেন?

n8n-এর ডকুমেন্টেশন অনুযায়ী custom execution data পাওয়া যায় n8n Cloud-এর Pro ও Enterprise প্ল্যানে এবং নিবন্ধিত self-hosted Community ও Enterprise সংস্করণে। অপশনটি চোখে না পড়লে আপনার সংস্করণ, লাইসেন্স রেজিস্ট্রেশন আর ভার্সন দেখুন। Execution Data নোড দেখা গেলেও বর্তমান পরিবেশে ফিচারটি সত্যিই চালু কি না নিশ্চিত হন।

পুরোনো self-hosted ইনস্ট্যান্সে বর্তমান ডকুমেন্টেশনের লেখার নিয়ম নাও মিলতে পারে, তাই আপগ্রেড আগে টেস্ট পরিবেশে করুন। Code নোডের চালানোর নীতি বা নিরাপত্তার বিধিনিষেধও এই সুবিধায় প্রভাব ফেলতে পারে।

গোপনীয়তার সীমারেখা কোথায় টানবেন?

ধরে নিন, যার Executions তালিকা দেখার অনুমতি আছে, তিনি custom data-ও দেখতে পারবেন। তাই ইমেইল, ফোন নম্বর, NID, access token, API-এর উত্তর বা পাসওয়ার্ড এখানে রাখবেন না। ব্যবসায়িক রেফারেন্স বাইরের কেউ আন্দাজ করতে পারলে সেটিকে কোনো অনুমতির চাবি হিসেবেও ব্যবহার করবেন না। অ্যালার্টের লিংক আর এক্সিকিউশনের তথ্য প্রতিষ্ঠানের ভেতরেই রাখুন, আর কাস্টমারের টিকিটে লিংক দেওয়ার আগে প্রাপকের অনুমতি আছে কি না দেখুন।

প্রতিষ্ঠান বা ক্লায়েন্টের পরিচয় রাখতে হলে ভেতরের একটি অর্থহীন ID নিন। কোম্পানির নাম নিজেই সংবেদনশীল হলে ছোট একটি অনুমোদিত কোড ব্যবহার করুন। ন্যূনতম তথ্য রাখার নীতি চাবি বাছাইয়ের সময় থেকেই শুরু হয়।

রানের তথ্য কতদিন থাকবে, সেটা কে ঠিক করবেন?

এক্সিকিউশন সেভ রাখার নীতি এখানে খুব গুরুত্বপূর্ণ, কারণ রান মুছে গেলে তার custom data-ও চলে যেতে পারে। সফল রান রাখা দরকার কি না, ব্যর্থ রান কতদিন থাকবে, কে খুলতে পারবেন আর কবে মোছা হবে, এগুলো লিখে রাখুন। খুঁজে পাওয়ার সুবিধার জন্য ব্যক্তিগত তথ্য অনির্দিষ্টকাল রেখে দেবেন না। দীর্ঘমেয়াদি ব্যবসায়িক রেকর্ড রাখুন অনুমোদিত ডেটাবেস বা CRM-এ, custom data কোনো হিসাবের খাতা নয়।

মেয়াদ শেষে রেকর্ড মোছার দায়িত্ব ওয়ার্কফ্লোর মালিকের নাকি ইনস্ট্যান্সের অ্যাডমিনের, সেটিও লিখে রাখুন। গোপনীয়তার কোনো অনুরোধ এলে custom data-তে ব্যক্তিগত তথ্য আছে কি না খুঁজে দেখুন। কোন তথ্য কোথায় থাকে, তা রানবুকে লেখা থাকলে এমন অনুরোধ দ্রুত সামলানো যায়।

কোন ভুলগুলো ডিবাগ করা কঠিন করে তোলে?

  • Custom data-কে পুরো লগ রাখার জায়গা বানানো।
  • setAll দিয়ে আগের মান মুছে ফেলা।
  • ১০টি ঘরের সীমা না ভেবে নতুন ঘর যোগ করা।
  • সংখ্যা বা অবজেক্ট সরাসরি বসানোর চেষ্টা করা।
  • Execution Data নোড দিয়ে মান পড়া যাবে ধরে নেওয়া।
  • খোঁজার সুবিধার জন্য ফোন বা ইমেইল রেখে দেওয়া।
  • চিহ্ন আছে বলে আবার চালানো নিরাপদ ধরে নেওয়া।
  • ওয়ার্কফ্লোভেদে চাবির নাম বদলে সব জায়গায় একসঙ্গে খোঁজা নষ্ট করা।

ওয়ার্কফ্লো নিয়ে হাতেকলমে শুরু করতে Google Form জমা পড়লেই Telegram এ অ্যালার্ট: Make.com, n8n আর ফ্রি Apps Script দিয়ে লেখাটি দেখুন। AI-এর ভিন্ন একটি কাজ জানতে চাইলে AI ভয়েসে Emotion, Pacing আর Expression দেওয়ার নিয়ম: Audio Tag দিয়ে রোবটিক গলা মানুষের মতো পড়তে পারেন।

তথ্যসূত্র: n8n Docs: Customize executions data এবং Execution Data node (দেখা হয়েছে: নভেম্বর ২০২৬)।

সচরাচর যা জিজ্ঞেস করা হয়

n8n custom execution data কী?
প্রতিটি এক্সিকিউশনের সঙ্গে রাখা ছোট লেখাভিত্তিক চাবি আর মান, যা Executions তালিকা ছাঁকতে আর চলতি রানে পড়তে কাজে লাগে।
কয়টি ঘর রাখা যায়?
সর্বোচ্চ ১০টি। চাবি ৫০ অক্ষর আর মান ২৫৫ অক্ষর পর্যন্ত হতে পারে, এবং সব মান লেখা বা string হতে হয়।
Execution Data নোড দিয়ে কি মান পড়া যায়?
না। এই নোড শুধু মান বসায়। পড়তে হলে Code নোডে customData-এর get বা getAll ব্যবহার করুন।
setAll কী করে?
চলতি এক্সিকিউশনের পুরো custom data অবজেক্টটি নতুন করে বসায়। আগের মান রাখতে চাইলে আলাদা set বা সাবধানে মিলিয়ে নেওয়া ব্যবহার করুন।
ফোন নম্বর কি custom data-তে রাখা ঠিক?
না। ব্যক্তিগত তথ্যের বদলে একটি নিরীহ ব্যবসায়িক রেফারেন্স ব্যবহার করুন, যা দিয়ে রান খোঁজা যায় কিন্তু কারও পরিচয় বোঝা যায় না।

কোড ছাড়া অটোমেশন শিখতে চাইলে

AI অটোমেশন Masterclass এ মেসেঞ্জার আর হোয়াটসঅ্যাপের উত্তর, Google Form থেকে শিট, Make.com আর n8n দিয়ে অটোমেশন বাংলায় দেখানো আছে।

AI অটোমেশন কোর্সটা দেখুন

Workflow-তে credential কীভাবে নিরাপদে ব্যবহার করবেন, তার পাশাপাশি n8n শেখার গাইডও দেখুন।

AI টুলস হেভেন বইয়ের কভার
এই লেখার পরের ধাপ, ফ্রি বাংলা বই

AI টুলস হেভেন

কোন কাজে কোন ধরনের টুল লাগে তার মানচিত্র, বাছাইয়ের চেকলিস্ট, আর খরচ ও নিরাপত্তা নিয়ন্ত্রণের নিয়ম।

বইটা ফ্রি নিন

অন্য কাজের বই খুঁজছেন? পুরো লাইব্রেরি, ১৩টা বই

বিষয়
নাসির উদ্দিন শামীম
লেখক

নাসির উদ্দিন শামীম

ঢাকা থেকে বলছি। ইন্টারনেট মার্কেটিং করি, আর নতুন কোনো এআই টুল বের হলেই সেটা ধরে দেখি কাজে লাগে কি না। যেটা সত্যিই কাজের, সেটা নিয়ে ফেসবুক আর ইউটিউবে কথা বলি। এখানে সেই জিনিসগুলোই গুছিয়ে শেখানোর চেষ্টা করি, যাতে আপনি নিজেও কাজে লাগাতে পারেন।

পরের ধাপ

বিষয়টা বুঝেছেন, এবার হাতে কলমে শিখে কাজ শুরু করুন।

৩০ সেকেন্ডের কুইজ বলে দেবে আপনার অবস্থায় কোন কোর্সটা লাগবে।

Nasir Uddin Shamim

Nasir Uddin Shamim

সাধারণত কয়েক ঘণ্টার মধ্যে উত্তর দিই, সর্বোচ্চ ২৪ ঘণ্টা।

এখন অফলাইনে আছি। মেসেজ রেখে যান, কয়েক ঘণ্টার মধ্যে উত্তর দেব, সর্বোচ্চ ২৪ ঘণ্টা।

Nasir Uddin Shamim
আসসালামু আলাইকুম 👋
আমি নাসির উদ্দিন শামীম। কীভাবে সাহায্য করতে পারি?