For the complete documentation index, see llms.txt. This page is also available as Markdown.

Keyboard/Barcode Reader

تقوم هذه الوظيفة بقراءة مدخلات لوحة المفاتيح والباركود وإتاحتها لباقي التدفق لديك. تكون مفيدة لالتقاط النص المكتوب، وأجهزة قراءة الباركود التي تُحاكي إدخال لوحة المفاتيح، أو الإدخالات اليدوية البسيطة أثناء التشغيل.

📥 المدخلات

لا يحتوي هذا البلوك على أية مدخلات.

📤 المخرجات

Text أحدث سطر نصي مُقروء من لوحة المفاتيح أو جهاز الباركود.

Check إشارة منطقية تشير إلى توفر قيمة نصية جديدة (مفيدة كمُحفز أو مشغّل).

🕹️ عناصر التحكم

Mode قائمة منسدلة لاختيار سلوك الإدخال. الخيارات الشائعة هي "Key Press" و "Barcode Reading".

🎯 الميزات

  • الاستماع في الخلفية لمدخلات على شكل لوحة مفاتيح بحيث يوفر البلوك أحدث نص مكتوب أو ممسوح دون تفاعل إضافي من المستخدم.

  • يوفر كل من المحتوى النصي (Text) وإشارة منطقية على شكل مُحفّز (Check) لمساعدتك على التفاعل فقط عند وصول بيانات جديدة.

  • تبديل وضع بسيط لمعاملة الأحداث الواردة كضغطة مفتاح عادية أو كمدخلات باركود (مفيد لأجهزة الماسح التي ترسل الكود الكامل دفعة واحدة).

📝 تعليمات الاستخدام

  1. اضبط السلوك المطلوب باستخدام Mode.

  2. قم بربط مخرجات هذا البلوك إلى البلوكات اللاحقة التي تعالج أو تخزن النص.

  3. استخدم المخرج Check لتشغيل إجراءات (مثلاً: تسجيل أو حفظ النص المقروء فقط عند وصول بيانات جديدة).

📊 التقييم

أثناء التشغيل، يستمع هذا البلوك لأحداث لوحة المفاتيح/الماسح التي تُحاكي لوحة المفاتيح ويحدّث مخرجاته بأحدث قيمة مقروءة ومؤشر وجود بيانات جديدة.

💡 نصائح وحيل

  • للحفاظ على الإدخالات الممسوحة في ملف، اربط Text (أو استخدم Check كمُحفّز) إلى CSV Export أو Data Write Local.

  • استخدم Debug Input لفحص القيم أثناء التطوير عندما تريد تسجيلًا سريعًا لما يتم قراءته.

  • إذا أردت الجمع بين قراءة الباركود القائمة على الصورة وأجهزة الماسح الماديّة، استخدم هذا البلوك مع Barcode Reader: يمكن أن تعمل قراءة الكاميرا كخيار احتياطي أو تحقق متقاطع.

  • للاختبار اليدوي أو حقن القيم بدون أجهزة، اقترن بـ String Input لتغذية قيم معروفة في التدفق.

  • لبدء تدفقات العمل فقط عند قراءة رمز، قم بإدخال Check إلى بلوكات منطقية مثل Logic Input أو استخدمه لتشغيل Image Logger أو Image Write لربط صور بمعرّفات الممسوحة.

🛠️ استكشاف الأخطاء وإصلاحها

  • لا يظهر نص: تأكد من تكوين قارئ الباركود كـ keyboard wedge (العديد من الماسحات تُرسل ضغطات مفاتيح).

  • الماسح يرسل أحرفًا غير متوقعة: افحص إعدادات البادئات/اللاحقات في الماسح (مثل carriage return أو newline).

  • قراءات مكررة أو مفقودة: جرّب تبديل Mode بين "Key Press" و "Barcode Reading" لمطابقة طريقة إرسال جهازك، واستخدم مخرج Check لتصفية التكرارات.

  • مشاكل في الأذونات أو الوصول إلى الجهاز: تحقق من أن نظام التشغيل يتعرف على لوحة المفاتيح/الماسح وأنه لا يوجد تطبيق آخر يلتقط الإدخال حصريًا.

آخر تحديث