الدالة IMPORTTEXT

ينطبق على
Excel لـ Microsoft 365

تتيح لك الدالة IMPORTTEXT استيراد البيانات من ملف مستند إلى نص (مثل CSV أو TXT أو TSV) مباشرة إلى Excel. يمكنك تعيين المحددات، وتخطي الصفوف أو أخذها، وتطبيق إعدادات الترميز أو الإعدادات المحلية لتمكين تحكم دقيق في المحتوى الذي تم استيراده.

ملاحظة

تتوفر هذه الميزة حاليا بشكل عام لمشتركي Microsoft 365 المسجلين في قناة Insiders Beta التي تعمل بالإصدار 2502 (النسخة 18604.20002) أو إصدار أحدث في Excel for Windows.

بناء الجملة

تستورد الدالة IMPORTTEXT البيانات من ملف نصي إلى Excel كصفيف ديناميكي.

بناء جملة الدالة IMPORTTEXT هو:

IMPORTTEXT(path, [delimiter], [skip_rows], [take_rows], [encodeding], [locale])

الوسيطة الوصف
مسار
(مطلوب)
مسار الملف المحلي أو عنوان URL للملف النصي الذي تريد استيراده.
محدد حرف أو سلسلة تحدد كيفية فصل الأعمدة في الملف. في حالة حذف هذه الوسيطة، تستخدم الدالة tab كمحدد.
skip_rows رقم يحدد عدد الصفوف التي يجب تخطيها. تتخطى القيمة السالبة الصفوف من نهاية الصفيف.
take_rows رقم يحدد عدد الصفوف التي سيتم إرجاعها. تأخذ القيمة السالبة صفوفا من نهاية الصفيف.
ترميز ترميز الملف. بشكل افتراضي، يتم استخدام UTF-8.
الإعدادات المحلية تحديد التنسيق الإقليمي (على سبيل المثال، تنسيقات التاريخ والأرقام). بشكل افتراضي، يتم استخدام الإعدادات المحلية لنظام التشغيل.

ملاحظة

  • لا يتم تحديث دالات الاستيراد تلقائيا. لتحديث البيانات المستوردة، استخدم الزر "تحديث الكل " على علامة التبويب "بيانات ".
  • يمكنك تحديد أعمدة ذات عرض ثابت من خلال تمرير صفيف مفصول بفاصلة من الأعداد الصحيحة التصاعدية في وسيطة المحدد.
    على سبيل المثال: =IMPORTTEXT("C:\Data\fixedwidth.txt", {1,3})
  • يمكنك استخدام الدالة CHAR لتحديد أحرف خاصة لوسيطة المحدد.
  • يمكنك استخدام الدالة IMPORTCSV كبديل سهل لاستيراد ملفات CSV.

الاتصال بالملفات النصية على الويب

عند استيراد ملف من الويب، قد تحتاج إلى توفير بيانات الاعتماد أو تسجيل الدخول للوصول إلى الملف المصدر. في مثل هذه الحالات، ستتم مطالبتك بتحديد أسلوب المصادقة المراد استخدامه لعنوان URL المقدم من خلال مربع حوار المصادقة.

استيراد الدالات Dialog.pngالمصادقة

طرق المصادقة المتوفرة هي:

  • مجهول: حدد طريقة المصادقة هذه عندما يكون المحتوى متاحا للجمهور ولا يتطلب تسجيل الدخول.
  • Windows: حدد أسلوب المصادقة هذا عند الوصول إلى مورد يتطلب بيانات اعتماد Windows.
  • أساسي: حدد طريقة المصادقة هذه عندما يتطلب المورد اسم مستخدموكلمة مرور.
  • واجهة برمجة تطبيقات الويب: حدد هذه الطريقة إذا كان مورد الويب الذي تتصل به يستخدم مفتاح واجهة برمجة التطبيقات لأغراض المصادقة.
  • حساب المؤسسة: حدد طريقة المصادقة هذه إذا تطلب المورد بيانات اعتماد حساب المؤسسة.

لمسح الأذونات الممنوحة أثناء عملية المصادقة، انقر فوق "إعدادات> مصدر البيانات>...". بعد ذلك ، ضمن علامة التبويب "الأذونات العمومية" ، حدد مسار عنوان URL ذي الصلة وانقر فوق "مسح الأذونات"

استيراد الدالات إعدادات DS

أمثلة

تستند الأمثلة التالية إلى مسار ملف نصي وهمي : "C:\Data\example.txt".

‏المثال 1‏

إرجاع أول صفين من الملف المصدر

بيانات

المنتج الفئة السعر
A 1 10
B 2 20
C 3 30
الصيغ
=IMPORTTEXT("C:\Data\example.txt",,,2)

يبين الرسم التوضيحي التالي النتيجة:

نتيجة IMPORTTEXT مع صف بيانات مستورد واحد

المثال 2

تخطي الصف الأول من الملف المصدر

بيانات

المنتج الفئة السعر
A 1 10
B 2 20
C 3 30
الصيغ
=IMPORTTEXT("C:\Data\example.txt",,1)

يبين الرسم التوضيحي التالي النتيجة:

نتيجة IMPORTTEXT بعد تخطي الصف المصدر الأول