IMPORTRANGE

لاستيراد نطاق من الخلايا من جدول بيانات محدد.

مثال للاستخدام

IMPORTRANGE("https://docs.google.com/spreadsheets/d/abcd123abcd123", "sheet1!A1:C10")

IMPORTRANGE(A2,"B2")‎

البنية

IMPORTRANGE(spreadsheet_url, range_string)‎

• spreadsheet_url - عنوان URL لجدول البيانات الذي سيتم استيراد البيانات منه.

  • يجب أن تكون قيمة spreadsheet_url إما بين علامتي اقتباس أو تكون مرجعًا لخلية تحتوي على عنوان URL لجدول بيانات.

• سلسلة_نطاق - سلسلة بالتنسيق "[اسم_الورقة!]النطاق" (على سبيل المثال "الورقة1!A2:B6" أو "A2:B6") مع تحديد النطاق المطلوب استيراده.

  • المكوّن اسم_الورقة لـ سلسلة_النطاق اختياري، سيتم استيراد IMPORTRANGE من النطاق المعني لأول ورقة تلقائيًا.

  • يجب إما تضمين قيمة range_string بين علامتَي اقتباس أو تكون مرجعًا لخلية تحتوي على النص المناسب.

التفاصيل الفنية وأفضل الممارسات

سيؤدي أي تعديل لدالة IMPORTRANGE في المستند المصدر إلى إعادة تحميل كل المستندات المُستلِمة المفتوحة وظهور شريط تحميل أخضر. تنتظر أيضًا دالة IMPORTRANGE اكتمال العمليات الحسابية في المستند المصدر قبل أن تعرض النتائج في المستند المُستلِم، حتى إذا لم يكن هناك عملية حسابية يتم إجراؤها في النطاق المصدر.

أفضل الممارسات

• تقييد أوراق البيانات المُستلِمة لأن كل ورقة بيانات مُستلِمة يجب أن تقرأ من ورقة البيانات المصدر
• إعادة تنظيم النتيجة واختصارها قبل استخدام IMPORTRANGE، خاصةً عند الاستيراد من ورقة بيانات يتم تعديلها بشكلٍ متكرر
  • على سبيل المثال، هدفك هو حساب مجموع 1,000,000 صف من جدول بيانات آخر. الطريقة الأسرع هي حساب المجموع في جدول البيانات ذلك ثم استخدام IMPORTRANGE لجلب المجموع المكوّن من رقم واحد بدلاً من استخدام IMPORTRANGE لنقل كل صفوف البيانات البالغ عددها 1,000,000 وحساب المجموع الإجمالي مباشرةً في جدول البيانات. تختصر هذه الطريقة المعلومات وتجمعها لدالة IMPORTRANGE قبل نقلها.

يمكن نشر تعديلات IMPORTRANGE في أوراق بيانات أخرى عند ربط أوراق البيانات معًا في سلسلة. إذا كانت ورقة البيانات "ب" تحتوي على IMPORTRANGE(ورقة البينات "أ") وكانت ورقة البينات "ج" تحتوي على IMPORTRANGE(ورقة البينات "ب")، يؤدي ذلك إلى ربطها في سلسلة. يؤدي إجراء أي تعديل على ورقة البيانات "أ" إلى إعادة تحميل ورقة البيانات "ب" وورقة البيانات "ج".

أفضل الممارسات

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

تتم إعادة تحميل IMPORTRANGE عند فتح مستند لأول مرة أو فتحه خلال الدقائق الخمس الماضية. وكما هو الحال مع سلسلة التعديلات، يتطلب هذا من دالة IMPORTRANGE "تنشيط" كل المستندات التي يتم الاستيراد منها.

أفضل الممارسات

• من الممكن أن تستغرق عملية تعديل المستندات بعض الوقت حتى يتم تفعيلها. ننصحك بتقييد سلاسل IMPORTRANGE. 

الإذن والوصول

يجب منح جداول البيانات الإذن صراحةً لسحب البيانات من جداول البيانات الأخرى باستخدام IMPORTRANGE. في أول مرة تسحب فيها ورقة البيانات الوجهة البيانات من ورقة بيانات مصدر جديدة، سيُطلَب من المستخدم منح الإذن.

إذا حاولت استخدام IMPORTRANGE لنقل البيانات من جدول بيانات تملكه، ستظهر لك هذه الرسالة:

1. انتظِر بضع ثوانٍ بعد إكمال دالة IMPORTRANGE.
2. تظهر رسالة خطأ ‎#REF!‎ وتطلب أنه "يجب ربط أوراق البيانات هذه. عليك السماح بالوصول".
3. لمنح الإذن لجدول البيانات المصدر، انقر على السماح بالوصول.

إذا حاولت استخدام IMPORTRANGE لنقل بيانات من جدول بيانات لا تملكه، ستظهر لك هذه الرسالة خلال بضع ثوانٍ: 

1. أدخِل عنوان URL لجدول البيانات المصدر في المتصفح.
2. اطلب الإذن بالوصول إلى جدول البيانات.
3. انتظِر حتى يمنحك مالك جدول البيانات الإذن بالوصول إليه.

بعد منح الإذن بالوصول، يمكن لأي محرِّر في جدول البيانات الوجهة استخدام دالة IMPORTRANGE لسحب البيانات من أي جزء من جدول البيانات المصدر. ويظل الإذن بالوصول ساريًا إلى أن تتم إزالة المستخدم، الذي منح هذا الإذن، من المصدر. تجدر الإشارة إلى أن الإذن بالوصول الممنوح لورقة البيانات الوجهة يتم احتسابه ضمن الحد الأقصى المسموح به لمشاركة الملفات والذي يبلغ 600 مستخدم لورقة البيانات المصدر.

الأداء

IMPORTRANGE هي دالة بيانات خارجية، مثل IMPORTXML وGOOGLEFINANCE. ويعني ذلك أنه يجب الاتصال بالإنترنت كي تعمل هذه الدالة. يجب أن ينزّل تطبيق "جداول بيانات Google" النطاق بأكمله على جهاز الكمبيوتر وسيتأثر بالشبكة البطيئة، والحد الأقصى هو 10 ميغابايت من البيانات المستلَمة لكل طلب. إذا كان أداء IMPORTRANGE بطيئًا، ننصحك بتقييد حجم النطاقات المستورَدة. وبدلاً من ذلك، يمكنك تلخيص العمليات الحسابية في المستند المصدر، بحيث يتم نقل بيانات أقل إلى ورقة البيانات على جهازك وإجراء المزيد من العمليات الحسابية عن بُعد.

ملاحظة: يمكنك استخدام أدوات أخرى. يمكن لبرمجة التطبيقات القراءة من المستندات الأخرى ويمكن تفعيلها عند التعديل ووفقًا لجدول زمني محدّد مسبقًا. تمت جدولة عملية إعادة تحميل لأوراق البيانات المرتبطة وهي أيضًا مُصمَّمة بشكلٍ أفضل لعمليات تحميل واستيراد مجموعات البيانات الأكبر حجمًا.

الحدود القصوى للاستخدام

عندما تصبح حركة البيانات كبيرة جدًا بسبب دوال IMPORTRANGE، قد تظهر لك الرسالة "جارٍ التحميل…" في الخلية مع ظهور رسالة الخطأ التفصيلية "خطأ: قد يستغرق تحميل البيانات بعض الوقت بسبب العدد الكبير للطلبات. جرِّب تقليل مقدار دوال IMPORTHTML أو IMPORTDATA أو IMPORTFEED أو IMPORTXML في جداول البيانات التي أنشأتها". 

يتم فرض الحدود على منشئ المستند. على المستخدم مراعاة مجموع استخدامات كل دوال الاستيراد في كل المستندات المفتوحة التي ينشئها. إنّ أي تعديل يجريه أحد المتعاونين يتم احتسابه أيضًا ضمن حصتك.

لحل رسالة الخطأ، ننصح المستخدمين بتقليل معدل إعادة تحميل البيانات باستخدام دوال الاستيراد. على سبيل المثال، إذا كانت القيمة التي تم التعامل معها بشكل نهائي لوسيطة في =IMPORTRANGE(وسيطة) تتغيّر بشكلٍ متكرر، قد يتم إصدار العديد من الاتصالات الخارجية، ما قد يؤدي إلى تقييد نقل البيانات. 

حداثة البيانات

يضمن تطبيق "جداول بيانات Google" لمستخدميه الحصول على أحدث البيانات مع الحفاظ على الاستخدام المعقول للبيانات. تبحث دالة IMPORTRANGE عن التحديثات تلقائيًا كل ساعة عندما يكون المستند مفتوحًا، حتى إذا لم تتغيّر الصيغة وجدول البيانات إذا حذفت الخلايا أو قرأتها أو استبدلتها باستخدام الصيغة نفسها، سيؤدي ذلك إلى إعادة تحميل الدوال. إذا فتحت المستند وأعدت تحميله، لا يؤدي ذلك إلى إعادة التحميل في دالة IMPORTRANGE.

عدم الثبات

عند استخدام IMPORTRANGE، قد يظهر لك الخطأ "‎#ERROR!‎" في الخلية مع ظهور رسالة الخطأ التفصيلية "خطأ: لا يُسمح لهذه الدالة بالإشارة إلى خلية تحتوي على NOW أو RAND أو RANDBETWEEN". لا يمكن لدوال الاستيراد الإشارة بشكل مباشر أو غير مباشر إلى دالة متغيّرة، مثل NOW أو RAND أو RANDBETWEEN. وهذا يمنع حِمل البيانات الزائد في جدول بيانات المستخدمين لأنه يتم تعديل هذه الدوال المتغيّرة بشكل متكرّر.

ملاحظة: الاستثناء الوحيد هو الدالة TODAY، وهي متغيّرة، ولكن لا يتم تعديلها أكثر من مرة واحدة في اليوم.

ننصحك بما يلي:

1. نسخ نتيجة تلك الدوال المتغيّرة
2. استخدام الخيار لصق خاص القيم فقط
3. الإشارة إلى تلك القيم الثابتة 

وفي حال تنفيذ ذلك، ستصبح جميع القيم ثابتة. على سبيل المثال، في حال النسخ واللصق الخاص لنتائج دالة NOW كقيم، لن تتغير بعد ذلك القيم التي لصقتها.

إذا كان لديك أي أسئلة، يمكنك الانتقال إلى منتدى مساعدة "أدوات تحرير مستندات Google" لطلب المساعدة.

راجع أيضًا

IMPORTXML: لاستيراد البيانات من أي نوع من أنواع البيانات المنسقة المختلفة من بينها خلاصات XML وHTML وCSV وTSV وRSS وATOM XML.

IMPORTHTML: لاستيراد البيانات من جدول أو قائمة داخل صفحة HTML.

IMPORTFEED: لاستيراد خلاصة بتنسيق RSS أو ATOM.

IMPORTDATA: لاستيراد البيانات بعنوان URL معين بتنسيق csv. (القيم المفصولة بفواصل)، أو tsv. (القيم المفصولة بعلامات تبويب).

تعرَّف على كيفية تحسين مرجع البيانات.