यह जांचने के लिए कि कोई Mac शॉर्टकट चयनित खोज टेक्स्ट को एन्कोड करता है या नहीं, उस मान का निरीक्षण करें जो उसके अंतिम URL तक पहुँचता है: शॉर्टकट द्वारा URL बनाने के बाद एक Quick Look क्रिया जोड़ें, इसे रिक्त स्थानों (स्पेस) और आरक्षित वर्णों वाले एक परीक्षण वाक्यांश के साथ चलाएं, और जांचें कि क्या वे वर्ण प्रतिशत एस्केप के रूप में दिखाई देते हैं। केवल एक सफल निष्पादन यह साबित नहीं करता है कि खोज टेक्स्ट सही ढंग से एन्कोड किया गया था; दिखाई देने वाला URL आपको यह निरीक्षण करने का एक तरीका देता है कि शॉर्टकट ने वास्तव में क्या संयोजित (assemble) किया है। Apple शॉर्टकट क्रियाओं के बीच पास की गई सामग्री का पूर्वावलोकन करने के लिए Quick Look का दस्तावेज़ीकरण करता है, और इसकी Mac मार्गदर्शिका उन 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 खोलती है। Apple की शॉर्टकट मार्गदर्शिका बताती है कि कनेक्टेड क्रियाएं अपने आउटपुट को आगे भेजती हैं, और Quick Look क्रिया उन क्रियाओं के बीच स्थानांतरित होने वाली सामग्री का पूर्वावलोकन कर सकती है। (Action connections in Shortcuts on Mac; Testing your actions in Shortcuts on Mac)

चयनित टेक्स्ट को Mac शॉर्टकट के लिए उपलब्ध कराएं

यदि आप किसी मौजूदा शॉर्टकट की जांच कर रहे हैं, तो पुष्टि करें कि यह चयनित टेक्स्ट प्राप्त करने के लिए कॉन्फ़िगर किया गया है। Shortcuts में, शॉर्टकट खोलें, उसका विवरण (Details) खोलें, और Use as Quick Action या Show in Share Sheet को सक्षम करें। Apple का कहना है कि यह वर्कफ़्लो की शुरुआत में एक इनपुट क्रिया जोड़ता है। फिर किसी ऐप में एक वाक्यांश चुनें और ऐप के शेयर विकल्पों या उपलब्ध Quick Actions से शॉर्टकट को इनवोक (शुरू) करें। सटीक मेनू ऐप पर और शॉर्टकट कैसे सक्षम है, इस पर निर्भर करता है। (Run a shortcut while working on your Mac)

Apple के अनुसार, 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 को स्वीकार करता है या क्वेरी की इच्छित व्याख्या करता है। Apple यह पहचानने के तरीके के रूप में Quick Look की अनुशंसा करता है कि शॉर्टकट क्रियाओं के बीच कौन सी सामग्री प्रवाहित होती है। (Testing your actions in Shortcuts on Mac)

पूर्वावलोकन में क्वेरी मान पढ़ें। एक सामान्य प्रतिशत-एन्कोडेड क्वेरी घटक में, एक स्पेस %20 के रूप में दिखाई दे सकता है, और एक एम्परसेंड (&) जो खोज वाक्यांश से संबंधित है, %26 के रूप में दिखाई दे सकता है। यदि मान के अंदर एम्परसेंड एक शाब्दिक & बना रहता है, तो एक URL पार्सर इसे किसी अन्य पैरामीटर की शुरुआत मान सकता है। यह एक नैदानिक (डायग्नोस्टिक) उदाहरण है, प्रत्येक खोज सेवा के क्वेरी प्रारूप के बारे में कोई गारंटी नहीं है। Apple के अपने शॉर्टकट URL-स्कीम उदाहरण स्पेस के लिए %20 का उपयोग करते हैं और प्रदान किए गए टेक्स्ट को स्पष्ट रूप से URL-एन्कोडेड के रूप में वर्णित करते हैं। (Run a shortcut using a URL scheme on Mac)

जांचें कि कौन सी क्रिया एन्कोडिंग करती है

संपादक में URL Encode के लिए क्रियाएं खोजें और निरीक्षण करें कि क्या यह मान को क्वेरी में डालने से पहले चयनित-टेक्स्ट वैरिएबल प्राप्त करती है। प्रतिशत एस्केप जोड़कर या हटाकर किसी URL में उपयोग के लिए टेक्स्ट को एन्कोड या डिकोड करना इस क्रिया का दस्तावेजी उद्देश्य है। (URL Encode) Apple 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 क्रिया को हटाएं या स्थानांतरित करें और एक गैर-संवेदनशील नमूना वाक्यांश के साथ शॉर्टकट का उपयोग करें। Apple सामग्री प्राप्त करने और URL खोलने के लिए Mac नियंत्रणों का दस्तावेजीकरण करता है, लेकिन खोज सेवाओं में समान क्वेरी व्यवहार का वादा नहीं करता है। (Run a shortcut while working on your Mac; Use another app’s URL scheme in Shortcuts on Mac)

स्रोत