مسح المستندات الورقية في تطبيق أندرويد: الصفحات والملف الناتج وجاهزية أول استخدام
تستحق ميزة مسح المستندات أن تُحدّد بوضوح عندما يحتاج الموظفون إلى تحويل صفحات ورقية إلى مرفق داخل تطبيق أندرويد. قرّر نوع الملف الناتج، والصفحات التي تنتمي إلى المستند نفسه، وما يحدث عندما لا يكون الماسح جاهزاً. اكتمال التصوير لا يعني الموافقة على مصروف، أو التحقق من توقيع، أو نجاح رفع السجل إلى الخادم.
تنشئ هذه الميزة مستنداً من الورق. أما اختيار PDF موجود، أو استيراد صورة من الهاتف، أو قراءة رمز شريطي، فمهام مختلفة. فصلها يساعد على وضوح نطاق التطوير والاختبار، بدلاً من جمعها كلها تحت كلمة «مسح».
ابدأ بالملف الذي يحتاجه المستلم
هل يحتاج المكتب إلى ملف PDF واحد يضم تقرير الزيارة كاملاً، أم إلى صور صفحات منفصلة بصيغة JPEG؟ هل يجب إرفاق وجهي النموذج؟ وهل يبقى الاحتفاظ بالأصل الورقي مطلوباً ضمن إجراءاتكم؟ هذه قرارات عمل لا تحسمها مكتبة المسح.
تصف وثائق ماسح المستندات من Google ML Kit مسار تصوير ومعاينة توفره المكتبة، مع خيارات لاستيراد الصور من المعرض وتحديد عدد الصفحات ووضع الماسح، ومخرجات بصيغتي PDF وJPEG. يستطيع المطوّر تقييم هذا المسار الجاهز قبل افتراض الحاجة إلى تصميم واجهة كاميرا كاملة من الصفر.
اطلب فقط صيغ الإخراج التي تستخدمونها فعلاً. تشير الوثائق إلى أن إنشاء الملفات يحتاج وقتاً وقدرة معالجة، وتوصي بطلب الصيغ اللازمة فقط. الحاجة إلى PDF لا تعني بالضرورة الاحتفاظ أيضاً بصورة مستقلة لكل صفحة.
اجعل الجاهزية جزءاً من المتطلبات
بحسب الوثائق، تنزّل خدمات Google Play النماذج ومنطق المسح والواجهة بصورة ديناميكية. وقد يحتاج المستخدم إلى انتظار التنزيل قبل أول استخدام. نجاح العرض على هاتف المطوّر المجهّز مسبقاً لا يثبت أن تثبيتاً جديداً سيكون جاهزاً فور الوصول إلى العميل.
وتحدد صفحة الدمج مستوى واجهة أندرويد 21 أو أعلى، وذاكرة جهاز إجمالية لا تقل عن 1.7 غيغابايت. اطلب فحص الأجهزة المستخدمة فعلاً، بما يشمل توفر خدمات Google Play. هذه حدود دنيا وليست وعداً بتساوي الأداء على كل هاتف يستوفيها.
اتفق على حالة تحضير ظاهرة ورسالة فشل مفهومة وطريقة بديلة إذا لم يبدأ الماسح. قد يكون إرفاق ملف موجود بديلاً مناسباً إن سمحت إجراءاتكم بذلك، لكنه ميزة مستقلة تحتاج إلى اختبار، وليس قدرة تُفترض تلقائياً من وجود الماسح.
راجع اكتمال الصفحات قبل الإرفاق
في مثال افتراضي لتقرير خدمة، ينبغي أن يستطيع الموظف فحص المستند الناتج قبل ربطه بالزيارة. يجب أن يتمكن من ملاحظة وجه خلفي مفقود، أو مبلغ غير مقروء، أو صفحة لا تخص المهمة. حدّد طريقة التصحيح، حتى لو استلزمت إعادة التصوير عندما لا يوفّر المسار المختار أداة التعديل المطلوبة.
اختر حد الصفحات من مستنداتك الواقعية، لا من قيمة في مثال برمجي. وقرّر هل يُسمح بالاستيراد من معرض الصور. إذا سمحت به، فقد يتضمن المستند صورة موجودة سابقاً، لا صفحة صُوّرت الآن. لا تصف كل الصفحات بأنها ملتقطة حديثاً ما لم يُفرض ذلك ويُختبر.
صيغة الملف وحدها لا تثبت وجود نص قابل للبحث، أو استخراج حقول الفاتورة، أو أصالة الورقة، أو قبولها قانونياً. إذا احتجت إلى التعرف على النص أو استخراج البيانات، فاطلب هذه النتائج واختبرها بصورة منفصلة. قد يكون PDF الذي يحتوي صور الصفحات مفيداً من دون هذه الوعود الإضافية.
افصل التصوير عن اكتمال إجراء العمل
يحتاج المستند بعد إنشائه إلى الحساب والزيارة أو طلب التعويض الصحيح، ثم إلى خطوة التخزين المتفق عليها. ميّز بين التقاط المستند، وربطه محلياً، وتأكيد الخادم حفظه. يجب أن يتيح الإلغاء الخروج من دون تقديم طلب جديد. وتبقى صلاحيات الملفات والاحتفاظ بها وفحصها على الخادم متطلبات مستقلة.
اطلب عرضاً على أجهزة حقيقية يشمل تثبيتاً جديداً، وتعذّر التنزيل الأول، وحالة جهاز غير مدعومة، والإلغاء، ومستنداً متعدد الصفحات، والحد المضبوط للصفحات. افتح الملف الناتج في البرنامج الذي يستخدمه المكتب وافحص كل صفحة، لا الصورة المصغرة وحدها.
دوّن النتائج المطلوبة ضمن معايير القبول. وأحضر مستندات نموذجية غير حساسة عند مناقشة تطبيق الأعمال. النتيجة المفيدة مستند مقروء مرتبط بالسجل الصحيح مع حالات جاهزية وحفظ صادقة، وليست مجرد زر كاميرا.
المصدر والحدود
تدعم وثائق دمج ماسح المستندات من Google ML Kit على أندرويد الحقائق المتعلقة بالمسار الجاهز والمكونات المنزّلة والحدود الدنيا وصيغ الإخراج. أما المراجعة والبديل والتخزين فهي متطلبات مقترحة لتطبيقك. لا يعتمد المقال على شيفرة تكرار الصفحات في المثال، ولا يصدّق على تنفيذ مكتمل أو إضافة التعرف على النصوص.