التوثيق

مقدمة

HTML Table Exporter هي إضافة Chrome تكتشف الجداول في صفحات الويب وتصدرها إلى التنسيق الذي تفضله. على عكس أدوات استخراج الويب التي تتطلب إعداداً معقداً، هذه الأداة تعمل فوراً: انقر، اختر التنسيق، حمّل.

لمن هذا؟

• محللو البيانات الذين يحتاجون استخراج الجداول من التقارير المالية، المواقع الحكومية، أو قواعد بيانات البحث
• الباحثون الذين يجمعون بيانات منظمة من المصادر الأكاديمية أو ويكيبيديا
• المطورون الذين يحتاجون وصولاً سريعاً للبيانات الجدولية بدون بناء أداة استخراج
• أي شخص ملّ من نسخ ولصق الجداول خلية بخلية

متى تستخدم HTML Table Exporter

HTML Table Exporter مصمم لمجموعة محددة من حالات الاستخدام. فهم أين يتفوق — وأين قد تكون أدوات أخرى أنسب — سيساعدك على الاستفادة القصوى منه.

مثالي لـ

• تصديرات الجداول لمرة واحدة — التقارير المالية، مجموعات البيانات الحكومية، قواعد بيانات البحث، جداول ويكيبيديا، إحصائيات الرياضة
• بيانات تطبيقات الويب — العديد من منصات CRM ولوحات التحليلات وأنظمة ERP والأدوات المؤسسية تعرض البيانات كجداول HTML يمكن للإضافة اكتشافها
• التصديرات المتكررة — احفظ قواعد التنظيف وإعدادات الأعمدة كملف تعريف، وأعد استخدامه في كل مرة تصدّر من نفس المصدر
• البيئات الحساسة للخصوصية — كل المعالجة محلية، مما يجعلها مناسبة للسياقات المؤسسية والمالية والصحية حيث لا يمكن للبيانات مغادرة المتصفح
• البيانات التي تحتاج تنظيفاً — التواريخ والأرقام والعملات والقيم الفارغة تُطبّع تلقائياً قبل التصدير

غير مصمم لـ

• الاستخراج الآلي أو المجدول — هذه أداة يدوية وتفاعلية. إذا كنت تحتاج أداة استخراج headless أو خط أنابيب قائم على cron، فكر في أدوات مثل Scrapy أو Puppeteer أو Playwright
• البيانات غير الجدولية — الإضافة تكتشف عناصر HTML <table>. البطاقات والقوائم والتغذيات والتخطيطات غير المنظمة غير مدعومة
• الوصول للبيانات عبر API — إذا كانت البيانات التي تحتاجها متاحة عبر API، استخدامها مباشرة سيكون أكثر موثوقية من استخراجها من الصفحة المعروضة
• التوافق المضمون مع جميع المواقع — بنيات جداول الويب تتنوع بشكل واسع. الإضافة تعمل مع جداول HTML القياسية والعديد من تطبيقات الويب المعقدة، لكن بعض المواقع تستخدم عرضاً غير قياسي قد لا يكون متوافقاً بالكامل

التثبيت

1. زُر Chrome Web Store

   افتح صفحة HTML Table Exporter في متصفح Chrome.

2. انقر على "إضافة إلى Chrome"

   انقر على الزر الأزرق وأكّد في النافذة المنبثقة. التثبيت يستغرق حوالي 3 ثوانٍ.

3. ثبّت الإضافة (اختياري)

   انقر على أيقونة اللغز في شريط أدوات Chrome وثبّت HTML Table Exporter للوصول السريع.

تفعيل الترخيص

بعد شراء HTML Table Exporter PRO، ستتلقى مفتاح ترخيص بالبريد الإلكتروني. اتبع هذه الخطوات لفتح جميع ميزات PRO.

كيفية تفعيل PRO

1. انقر على "تفعيل" في الإضافة

   افتح نافذة الإضافة المنبثقة وانقر على زر "تفعيل" في الزاوية العلوية اليمنى. ستشاهد أيضاً ميزات PRO مدرجة في أسفل النسخة المجانية.

2. أدخل مفتاح الترخيص

   الصق مفتاح الترخيص بالتنسيق XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX وانقر على "تفعيل". المفتاح أُرسل إلى بريدك الإلكتروني بعد الشراء.

3. ابدأ باستخدام ميزات PRO

   بمجرد التفعيل، ستعرض الإضافة "HTML Table Exporter PRO" مع زر السجل. جميع ميزات PRO مفتوحة الآن.

دليل مرئي

1 انقر على زر "تفعيل"

انقر على زر "تفعيل" في الزاوية العلوية اليمنى. النسخة المجانية تعرض الميزات التي تفتحها مع PRO.

2 أدخل ترخيصك

الصق مفتاح الترخيص وانقر على "تفعيل". إذا لم يكن لديك مفتاح بعد، انقر على "احصل على HTML Table Exporter PRO".

حل مشاكل الترخيص

"مفتاح ترخيص غير صالح"

تأكد من نسخ مفتاح الترخيص كاملاً بما في ذلك جميع الشرطات. التنسيق يجب أن يكون XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. تحقق من عدم وجود مسافات إضافية قبل أو بعد المفتاح.

لم أستلم مفتاح الترخيص

تحقق من مجلد الرسائل غير المرغوب فيها. البريد يأتي من Lemon Squeezy (معالج الدفع لدينا). إذا لم تجده بعد، قم بزيارة صفحة الدعم مع رقم طلبك.

أحتاج نقل الترخيص لجهاز آخر

كل مفتاح ترخيص صالح لجهاز واحد فقط. إذا كنت تحتاج استخدام PRO على أجهزة إضافية، يمكنك شراء تراخيص إضافية أو النظر في خطط TEAM أو BUSINESS.

البدء السريع

صدّر أول جدول في أقل من 60 ثانية:

كيفية تصدير الجداول

الاختيار الذكي (الطريقة الأسرع)

هذا النهج يوفر الوقت بالسماح لك باختيار البيانات المستهدفة مباشرة. ببساطة انقر في أي مكان من الجدول في صفحة الويب ثم افتح أيقونة إضافة HTML Table Exporter PRO. الإضافة تُميّز وتركز تلقائياً على ذلك الجدول المحدد، مما يسمح بتصديره فوراً دون الحاجة للبحث بين النتائج المكتشفة الأخرى.

تنسيقات تصدير مرنة

كل جدول مكتشف يمكن تصديره بعدة تنسيقات احترافية بالنقر على الزر المقابل في بطاقة الجدول:

• Excel (XLSX) — مثالي للتحليل العميق للبيانات
• CSV — مثالي للاستخدام العام في جداول البيانات
• JSON أو NDJSON — مثالي لتطوير الويب وقواعد بيانات NoSQL
• SQL — يُولّد جمل INSERT جاهزة للاستخدام في قواعد البيانات

التحميل الجماعي

للمستخدمين الذين يريدون استخراج كل الجداول دفعة واحدة، التحميل الجماعي متاح. لهذا، حدد القائمة المنسدلة لتنسيق ZIP واختر التنسيق المفضل لديك (مثل CSV أو JSON) للملفات داخل الحزمة. بالنقر على "Export all tables (ZIP)"، كل الجداول في الصفحة تُحمّل معاً في حزمة منظمة.

Company,Revenue,Growth
Apple,394.33B,+7.8%
Microsoft,211.91B,+12.4%
Google,282.84B,+9.8%

تنسيقات التصدير

HTML Table Exporter يدعم خمسة تنسيقات للمخرجات، كل منها محسّن لحالات استخدام مختلفة.

CSV (Comma-Separated Values)

التنسيق العالمي. يعمل مع Excel, Google Sheets, قواعد البيانات وعملياً أي أداة بيانات. مستخدمو PRO يمكنهم تخصيص الفاصل (فاصلة، فاصلة منقوطة، tab) للتوافق الإقليمي.

Name,Email,Status
John Doe,[email protected],Active
Jane Smith,[email protected],Pending

JSON (JavaScript Object Notation)

مثالي للمطورين وAPIs. كل صف يتحول إلى كائن مع رؤوس الأعمدة كمفاتيح.

[
  {
    "Name": "John Doe",
    "Email": "[email protected]",
    "Status": "Active"
  }
]

Excel (XLSX)

تنسيق Excel الأصلي مع أنواع خلايا صحيحة. الأرقام أرقام، والتواريخ تواريخ.

NDJSON (Newline Delimited JSON)

مثالي لمعالجة البيانات المتدفقة وقواعد بيانات NoSQL. كل سطر هو كائن JSON منفصل، مما يجعله مثالياً لمجموعات البيانات الكبيرة ومعالجة السجلات.

{"Name":"John Doe","Email":"[email protected]","Status":"Active"}
{"Name":"Jane Smith","Email":"[email protected]","Status":"Pending"}

SQL (INSERT Statements)

يُولّد جمل INSERT جاهزة للاستيراد مباشرة إلى قواعد البيانات. مثالي لـ MySQL, PostgreSQL, SQLite وقواعد SQL الأخرى.

INSERT INTO table_name (Name, Email, Status) VALUES
('John Doe', '[email protected]', 'Active'),
('Jane Smith', '[email protected]', 'Pending');

تنظيف البيانات

بيانات الويب فوضوية: رموز العملات، تنسيقات التواريخ غير المتسقة، أحرف مخفية؛ هذه تكسر التحليلات والاستيرادات. HTML Table Exporter ينظّف بياناتك تلقائياً.

التنظيف التلقائي (مجاني)

• إزالة المسافات البيضاء من جميع الخلايا
• إزالة أحرف Unicode المخفية
• تطبيع فواصل الأسطر
• الحفاظ على بنية الخلايا المدمجة

ملفات تنظيف ذكية (PRO)

PRO يتضمن ملفات تنظيف مُعدة مسبقاً لأنواع البيانات الشائعة:

ملف العملات

يزيل رموز $، €، £ وفواصل الآلاف. يحوّل $1,234.56 إلى 1234.56.

ملف النسب المئوية

يزيل رمز %. يحوّل 45.5% إلى 0.455 أو 45.5.

ملف التواريخ

يوحّد التواريخ إلى تنسيق ISO. يحوّل Jan 15, 2024 إلى 2024-01-15.

// Raw data from website
"  $1,234.56  ", "Jan 15, 2024", "45.5%"

// After cleaning profiles
1234.56, "2024-01-15", 0.455

التصدير الدفعي

عندما تحتوي الصفحة على جداول متعددة (أو تحتاج تنسيقات متعددة)، التصدير الدفعي يوفر ساعات.

تصدير كل الجداول

انقر على "Export All" في نافذة الإضافة. كل جدول يصبح ملفاً منفصلاً.

تحميل ZIP

احصل على ملف ZIP واحد يحتوي كل الجداول بالتنسيق الذي تختاره.

tables-export.zip
├── table-1-revenue-summary.csv
├── table-2-revenue-summary.csv
└── table-3-revenue-summary.csv

الجداول المعقدة

جداول العالم الحقيقي نادراً ما تكون شبكات بسيطة. HTML Table Exporter يتعامل مع التعقيد الذي يكسر أدوات أخرى.

الخلايا المدمجة (Rowspan/Colspan)

عندما تمتد الخلايا عبر صفوف أو أعمدة متعددة، البيانات المصدرة تملأ الخلايا المقابلة للحفاظ على البنية.

الجداول المتداخلة

الجداول داخل جداول شائعة في مواقع الويب القديمة. التمييز عند التمرير يساعدك على التحقق قبل التصدير.

الجداول الديناميكية/JavaScript

العديد من تطبيقات الويب الحديثة تعرض الجداول باستخدام إطارات JavaScript. إذا كان الجدول مرئياً في متصفحك، الإضافة عادةً تستطيع اكتشافه. ومع ذلك، النتائج قد تتفاوت حسب كيفية هيكلة الموقع لـ DOM — بعض التطبيقات تستخدم عناصر غير قياسية قد لا يتم التعرف عليها كجداول.

التقاط التمرير (PRO)

التقاط التمرير هي ميزة PRO مصممة للجداول المقسمة والافتراضية التي تعرض فقط مجموعة فرعية من الصفوف في وقت واحد. تعمل بالتقاط الصفوف المرئية أثناء تمريرك عبر الجدول، وتجميعها وإزالة التكرارات في مجموعة بيانات كاملة.

كيف تعمل: تُفعّل التقاط التمرير ثم تتمرر عبر الجدول بسرعتك الخاصة. الإضافة تقرأ الصفوف المعروضة في DOM المتصفح في تلك اللحظة — لا تُجري طلبات شبكة إضافية، ولا تحاكي نقرات، ولا تتفاعل مع أدوات التحكم في التقسيم. بمجرد أن تمر على البيانات التي تحتاجها، توقف الالتقاط وصدّر مجموعة البيانات المتراكمة.

الاختلافات الرئيسية مع أدوات التقسيم التلقائي: على عكس إضافات المتصفح التي تنقر تلقائياً على أزرار "الصفحة التالية" أو تحاكي التمرير اللانهائي، التقاط التمرير هو قارئ سلبي. يراقب ما عرضه متصفحك بالفعل دون تفعيل التنقل بين الصفحات أو طلبات الخادم. هذا يجعله أقل عرضة لتفعيل حدود السرعة أو حمايات مكافحة الروبوتات، ويعمل مع الشبكات الافتراضية التي تستبدل عقد DOM أثناء التمرير.

مقارنة المجاني vs PRO

النسخة المجانية مفيدة حقاً، بدون قيود مصطنعة. PRO يضيف ميزات متقدمة للمستخدمين المتكررين.

حل المشكلات

"لم يتم اكتشاف جداول"

بعض المواقع تستخدم تخطيطات <div> تبدو كجداول لكنها ليست جداول HTML دلالية. الإضافة تكتشف بشكل رئيسي عناصر <table> وتتوافق أيضاً مع بعض مكونات الشبكات المبنية على JavaScript. تأكد من أن الصفحة حُمّلت بالكامل قبل التصدير.

بيانات مفقودة في التصدير

تحقق مما إذا كان الجدول يستخدم التحميل المؤجل. مرر عبر الجدول بأكمله أولاً، ثم صدّره.

التصدير يحتوي على ترميز خاطئ

الإضافة تستخدم ترميز UTF-8. إذا رأيت أحرفاً غير مقروءة في Excel، استخدم بيانات ← من نص/CSV للاستيراد.

الإضافة لا تعمل على موقع ما

بعض المواقع (مثل Chrome Web Store نفسه) تحظر الإضافات لأسباب أمنية. هذا قيد من Chrome. إذا كنت تعتقد أن الإضافة يجب أن تعمل على موقع معين لكنها لا تعمل، أو إذا لاحظت أخطاء في الاستخراج، أبلغ عن ذلك عبر نموذج الدعم حتى نتمكن من التحقيق.