الوصول إلى صِيَغ مصادر البيانات الحالية وتعديلها لإنشاء صيغة مصدر بيانات جديدة، استخدِم Range.setFormula(formula)
.
لا تستخدِم هذه الفئة إلا مع البيانات المرتبطة بقاعدة بيانات BigQuery.
الطُرق
الطريقة | نوع القيمة التي يتم عرضها | وصف قصير |
---|---|---|
cancel | Data | تلغي إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كانت قيد التنفيذ حاليًا. |
force | Data | تؤدي هذه الطريقة إلى إعادة تحميل بيانات هذا العنصر بصرف النظر عن حالته الحالية. |
get | Range | تعرِض Range التي تمثّل الخلية التي تم تثبيت صيغة مصدر البيانات هذه فيها. |
get | Data | تحصل على مصدر البيانات المرتبط بالعنصر. |
get | String | لعرض قيمة صيغة مصدر البيانات. |
get | String | تعرِض هذه السمة صيغة مصدر البيانات هذا. |
get | Data | تحصل على حالة تنفيذ البيانات للكائن. |
refresh | Data | تؤدي هذه الطريقة إلى إعادة تحميل بيانات الكائن. |
set | Data | تعديل الصيغة |
wait | Data | تنتظر هذه الدالة حتى اكتمال التنفيذ الحالي، وتنتهي مهلة الانتظار بعد عدد الثواني المقدَّم. |
مستندات تفصيلية
cancel Data Refresh()
تلغي إعادة تحميل البيانات المرتبطة بهذا العنصر إذا كانت قيد التنفيذ حاليًا.
يوضِّح هذا المثال كيفية إلغاء إعادة تحميل صيغة.
const spreadsheet = SpreadsheetApp.getActive(); const formula = spreadsheet.getDataSourceFormulas()[0]; // Cancel the ongoing refresh on the formula. formula.cancelDataRefresh();
يُعرِض استثناءً إذا لم يكن نوع مصدر البيانات مفعّلاً. استخدِم طرق Spreadsheet
لتفعيل تنفيذ البيانات لنوع محدّد من مصادر البيانات.
الإرجاع
Data
: عنصر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
force Refresh Data()
تؤدي هذه الطريقة إلى إعادة تحميل بيانات هذا العنصر بصرف النظر عن حالته الحالية. يُرجى الاطّلاع على refresh
للحصول على
مزيد من التفاصيل. إذا أردت إلغاء عملية إعادة تحميل هذا العنصر التي يتم تنفيذها حاليًا، اطّلِع على cancel
.
يُعرِض استثناءً إذا لم يكن نوع مصدر البيانات مفعّلاً. استخدِم طرق Spreadsheet
لتفعيل تنفيذ البيانات لنوع محدّد من مصادر البيانات.
الإرجاع
Data
: عنصر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Anchor Cell()
تعرِض Range
التي تمثّل الخلية التي تم تثبيت صيغة مصدر البيانات هذه فيها.
الإرجاع
Range
: خلية الربط
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source()
تحصل على مصدر البيانات المرتبط بالعنصر.
الإرجاع
Data
: مصدر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Display Value()
لعرض قيمة صيغة مصدر البيانات.
الإرجاع
String
: القيمة المعروضة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Formula()
تعرِض هذه السمة صيغة مصدر البيانات هذا.
الإرجاع
String
: الصيغة
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Status()
تحصل على حالة تنفيذ البيانات للكائن.
الإرجاع
Data
: حالة تنفيذ البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refresh Data()
تؤدي هذه الطريقة إلى إعادة تحميل بيانات الكائن.
يُعرِض استثناءً إذا كان حاليًا في الحالة error
. استخدِم Data
لتعديل المواصفة. ويُفضَّل استخدام هذه الطريقة بدلاً من force
لمنع إجراء تعديلات غير متوقّعة على مصدر البيانات.
يُعرِض استثناءً إذا لم يكن نوع مصدر البيانات مفعّلاً. استخدِم طرق Spreadsheet
لتفعيل تنفيذ البيانات لنوع محدّد من مصادر البيانات.
الإرجاع
Data
: عنصر البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula(formula)
تعديل الصيغة
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
formula | String | الصيغة الجديدة |
الإرجاع
Data
: صيغة مصدر البيانات لتسلسلها.
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
wait For Completion(timeoutInSeconds)
تنتظر هذه الدالة حتى اكتمال التنفيذ الحالي، وتنتهي مهلة الانتظار بعد عدد الثواني المقدَّم. يُعرِض استثناءً إذا لم يكتمل التنفيذ عند انتهاء المهلة، ولكنّه لا يلغي تنفيذ البيانات.
المعلَمات
الاسم | النوع | الوصف |
---|---|---|
timeout | Integer | وقت الانتظار لتشغيل البيانات، بالثواني ويبلغ الحد الأقصى 300 ثانية. |
الإرجاع
Data
: حالة تنفيذ البيانات
التفويض
تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets