একটি ম্যাক শর্টকাট নির্বাচিত অনুসন্ধানের টেক্সট এনকোড করে কিনা তা যাচাই করতে, চূড়ান্ত URL-এ পৌঁছানো মানটি পরীক্ষা করুন: শর্টকাটটি URL তৈরি করার পরে একটি Quick Look অ্যাকশন যোগ করুন, স্পেস এবং সংরক্ষিত অক্ষর রয়েছে এমন একটি পরীক্ষামূলক বাক্যাংশ দিয়ে এটি চালান, এবং সেই অক্ষরগুলি পারসেন্ট এস্কেপ হিসেবে প্রদর্শিত হয় কিনা তা পরীক্ষা করুন। শুধুমাত্র সফলভাবে রান হওয়া মানেই এই প্রমাণ নয় যে অনুসন্ধানের টেক্সটটি সঠিকভাবে এনকোড করা হয়েছে; দৃশ্যমান URL আপনাকে শর্টকাটটি আসলে কী একত্রিত করেছে তা পরীক্ষা করার একটি উপায় দেয়। অ্যাপল শর্টকাট অ্যাকশনগুলির মধ্যে স্থানান্তরিত বিষয়বস্তুর প্রিভিউ দেখার জন্য Quick Look-এর ব্যবহারের কথা উল্লেখ করে, এবং এর ম্যাক গাইডে URL-ভিত্তিক ওয়ার্কফ্লোগুলির বর্ণনা দেয় যেখানে টেক্সটকে URL-এনকোড করা প্রয়োজন। (Testing your actions in Shortcuts on Mac; Use another app’s URL scheme in Shortcuts on Mac)

যে টেক্সট এবং URL আপনার পরীক্ষা করা প্রয়োজন তা শনাক্ত করুন

একটি অনুসন্ধান শর্টকাট সাধারণত একটি নির্বাচিত বাক্যাংশ নেয়, সেটিকে একটি অনুসন্ধান URL-এ রাখে এবং সেই URLটি খোলে। পরীক্ষা করার মূল অংশটি হলো বাক্যাংশ ধারণকারী কোয়েরি মান (query value)—চূড়ান্ত URLটি কোনো ওয়েব ঠিকানা দিয়ে শুরু হয় কিনা কেবল সেটি নয়। উদাহরণস্বরূপ, অনুসন্ধান URLটির আকার যদি https://example.com/search?q=... হয়, তবে q=-এর পরের মানটি পরীক্ষা করুন। উদাহরণের ডোমেনটি কেবল বোঝানোর জন্য ব্যবহার করা হয়েছে; আপনার শর্টকাটটি যে প্রকৃত অনুসন্ধান পরিষেবা এবং প্যারামিটারের জন্য তৈরি করা হয়েছে সেটি ব্যবহার করুন।

শর্টকাট অ্যাকশনগুলি উপর থেকে নিচ পর্যন্ত ভালোভাবে দেখুন। নির্বাচিত টেক্সটটি কোথায় ওয়ার্কফ্লোতে প্রবেশ করছে, কোথায় URL বা অনুসন্ধানের কোয়েরি একত্রিত হচ্ছে এবং কোন অ্যাকশনটি URLটি খুলছে তা খুঁজে বের করুন। অ্যাপলের Shortcuts গাইড ব্যাখ্যা করে যে সংযুক্ত অ্যাকশনগুলি তাদের আউটপুট সামনের দিকে পাঠায়, এবং একটি Quick Look অ্যাকশন বিভিন্ন অ্যাকশনের মধ্যে চলমান বিষয়বস্তুর প্রিভিউ দেখতে পারে। (Action connections in Shortcuts on Mac; Testing your actions in Shortcuts on Mac)

ম্যাক শর্টকাটে নির্বাচিত টেক্সট ব্যবহারের উপযোগী করুন

আপনি যদি কোনো বিদ্যমান শর্টকাট পরীক্ষা করে থাকেন, তবে নিশ্চিত করুন যে এটি নির্বাচিত টেক্সট গ্রহণ করার জন্য কনফিগার করা আছে। Shortcuts-এ, শর্টকাটটি খুলুন, এর Details খুলুন এবং Use as Quick Action বা Show in Share Sheet সক্রিয় করুন। অ্যাপল জানায় যে এটি ওয়ার্কফ্লোর শুরুতে একটি ইনপুট অ্যাকশন যোগ করে। তারপর কোনো অ্যাপে একটি বাক্যাংশ নির্বাচন করুন এবং অ্যাপটির শেয়ার অপশন বা উপলব্ধ Quick Actions থেকে শর্টকাটটি চালু করুন। নির্দিষ্ট মেনুটি নির্ভর করে অ্যাপটি এবং শর্টকাটটি কীভাবে সক্রিয় করা হয়েছে তার ওপর। (Run a shortcut while working on your Mac)

অ্যাপলের মতে, ডক (Dock) থেকে চালু করা কোনো শর্টকাট বর্তমান অ্যাপ থেকে বিষয়বস্তু গ্রহণ করে না। আপনি যদি সেভাবে এটি চালু করেন, তবে আপনি যে অংশটি পরীক্ষা করতে চান সেই নির্বাচন ছাড়াই এটি চলতে পারে। শর্টকাটের ইনপুট অ্যাকশনটি পরীক্ষা করুন এবং টেক্সট সিলেক্ট থাকা অবস্থায় একটি সমর্থিত সোর্স অ্যাপ থেকে এটি চালান। (Run a shortcut while working on your Mac; Limit the input for a shortcut when run from another app on Mac)

সম্পূর্ণ URLটি খোলার আগে প্রিভিউ দেখুন

শর্টকাট এডিটরে, চূড়ান্ত URL তৈরির অ্যাকশন এবং এটি খোলার অ্যাকশনের মাঝে Quick Look ঢোকান। red & blue sky-এর মতো একটি ক্ষতিহীন পরীক্ষামূলক বাক্যাংশ দিয়ে শর্টকাটটি চালান। Quick Look-এর পূর্ববর্তী অ্যাকশনের আউটপুট দেখানো উচিত। এটি ওপেন অ্যাকশন পাওয়ার আগেই আপনাকে তৈরি করা URLটি পরীক্ষা করার সুযোগ দেয়; অনুসন্ধান প্রদানকারী URLটি গ্রহণ করবে কি না বা উদ্দেশ্য অনুযায়ী কোয়েরিটি ব্যাখ্যা করবে কি না, তা এটি নিজে থেকে যাচাই করে না। অ্যাপল শর্টকাট অ্যাকশনগুলির মধ্যে কী বিষয়বস্তু প্রবাহিত হচ্ছে তা শনাক্ত করার একটি উপায় হিসেবে Quick Look-এর সুপারিশ করে। (Testing your actions in Shortcuts on Mac)

প্রিভিউতে কোয়েরির মানটি পড়ুন। একটি সাধারণ পারসেন্ট-এনকোডেড কোয়েরি উপাদানে, একটি স্পেস %20 হিসেবে প্রদর্শিত হতে পারে এবং অনুসন্ধানের বাক্যাংশের অন্তর্গত একটি অ্যাম্পারস্যান্ড (&) %26 হিসেবে প্রদর্শিত হতে পারে। অ্যাম্পারস্যান্ডটি যদি মানের ভেতরে আক্ষরিক & হিসেবে থেকে যায়, তবে একটি URL পার্সার এটিকে অন্য একটি প্যারামিটারের সূচনা হিসেবে বিবেচনা করতে পারে। এটি একটি ডায়াগনস্টিক উদাহরণ, প্রতিটি অনুসন্ধান পরিষেবার কোয়েরি ফরম্যাট সম্পর্কে কোনো নিশ্চয়তা নয়। অ্যাপলের নিজস্ব Shortcuts URL-স্কিম উদাহরণগুলিতে স্পেসের জন্য %20 ব্যবহার করা হয় এবং স্পষ্টভাবে প্রদত্ত টেক্সটকে URL-এনকোডেড হিসেবে বর্ণনা করা হয়। (Run a shortcut using a URL scheme on Mac)

কোন অ্যাকশনটি এনকোডিং সম্পাদন করে তা পরীক্ষা করুন

এডিটরে URL Encode লিখে অ্যাকশনগুলি খুঁজুন এবং কোয়েরিতে মানটি সন্নিবেশ করার আগে এটি নির্বাচিত টেক্সটের ভ্যারিয়েবলটি পায় কিনা তা পরীক্ষা করুন। পারসেন্ট এস্কেপ যোগ বা সরানোর মাধ্যমে URL-এ ব্যবহারের জন্য টেক্সট এনকোড বা ডিকোড করা হলো এই অ্যাকশনটির নথিভুক্ত উদ্দেশ্য। (URL Encode) অ্যাপল URL অ্যাকশনের মাধ্যমে URL তৈরি করা এবং Open URLs বা Open X-Callback URL দিয়ে সেগুলি খোলার বিষয়েও নির্দেশিকা প্রদান করে, তবে এর গাইডে সতর্ক করা হয়েছে যে URL স্কিমগুলির জন্য এনকোড করা টেক্সটের প্রয়োজন হতে পারে এবং সেগুলি ডিবাগ করা কঠিন হতে পারে। (Use another app’s URL scheme in Shortcuts on Mac)

প্রয়োজনীয় পরীক্ষা হলো অ্যাকশনটির অবস্থান এবং প্রিভিউ দেখা, শুধুমাত্র নামের মধ্যে “URL” থাকা কোনো অ্যাকশনের উপস্থিতি নয়। নিশ্চিত করুন যে নির্বাচিত টেক্সটটি এনকোডিং ধাপে পৌঁছাচ্ছে, এবং মূল নির্বাচনের পরিবর্তে এনকোড করা ফলাফলটি কোয়েরি মান হিসেবে সন্নিবেশিত হচ্ছে। তারপর নিশ্চিত করুন যে Quick Look প্রিভিউতে প্রত্যাশিত এস্কেপগুলি দেখা যাচ্ছে। ইতিমধ্যে এনকোড করা কোনো মান দ্বিতীয়বার এনকোড করা এড়িয়ে চলুন: পারসেন্ট চিহ্নগুলি নিজেরাই এনকোড হয়ে যেতে পারে, যার ফলে %20 পরিবর্তিত হয়ে %2520 হতে পারে। প্রিভিউতে এই ধরণের প্যাটার্ন দেখা গেলে বুঝতে হবে যে ওয়ার্কফ্লোতে বারবার এনকোডিং হচ্ছে কিনা তা খতিয়ে দেখা দরকার।

ফলাফল এবং এর সীমাবদ্ধতা বিশ্লেষণ করুন

প্রিভিউতে যদি কোয়েরি মানের ভেতরে এস্কেপ করা স্পেস এবং সংরক্ষিত অক্ষর দেখা যায়, তবে সেটি প্রমাণ করে যে একত্রিত URL-এ এনকোড করা টেক্সট রয়েছে। যদি এটি অপরিবর্তিত স্পেস দেখায়, তবে নির্বাচিত টেক্সটটি হয়তো কোনো এনকোডারের মধ্য দিয়ে যায়নি, ভুল ভ্যারিয়েবল সন্নিবেশ করা হয়ে থাকতে পারে, অথবা আপনি হয়তো আগের কোনো অ্যাকশনের আউটপুট প্রিভিউ করছেন। বাক্যাংশটি অনুপস্থিত থাকলে, URL কাঠামো পরিবর্তন করার আগে শর্টকাটের ইনপুট এবং ভ্যারিয়েবলের সংযোগগুলি পরীক্ষা করুন।

একটি প্রিভিউ শর্টকাটের তৈরি করা URL স্ট্রিংটি দেখাতে পারে; কিন্তু কোনো নির্দিষ্ট অনুসন্ধান পরিষেবা কীভাবে কোয়েরিটি প্রক্রিয়া করবে, URLটি সফলভাবে খোলে কিনা, বা পরিষেবাটি নিজস্ব নিয়ম প্রয়োগ করে কিনা তা এটি নিশ্চিত করতে পারে না। চূড়ান্ত কার্যকারিতা পরীক্ষার জন্য, ডায়াগনস্টিক Quick Look অ্যাকশনটি সরিয়ে ফেলুন বা স্থান পরিবর্তন করুন এবং একটি সংবেদনশীল নয় এমন নমুনা বাক্যাংশ দিয়ে শর্টকাটটি ব্যবহার করুন। অ্যাপল বিষয়বস্তু গ্রহণ এবং URL খোলার জন্য ম্যাক কন্ট্রোলগুলির বিবরণ দেয়, তবে সমস্ত অনুসন্ধান পরিষেবা জুড়ে একই ধরণের কোয়েরি আচরণের নিশ্চয়তা দেয় না। (Run a shortcut while working on your Mac; Use another app’s URL scheme in Shortcuts on Mac)

সূত্রসমূহ