تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DataSourceFormula

الوصول إلى صيغ مصدر البيانات الحالية وتعديلها لإنشاء صيغة جديدة لمصدر البيانات، استخدِم Range.setFormula(formula).

لا تستخدم هذا الصف إلا مع البيانات المرتبطة بقاعدة بيانات.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`forceRefreshData()`	`DataSourceFormula`	يُعيد تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية.
`getAnchorCell()`	`Range`	تعرض `Range` التي تمثل الخلية التي ترتكز فيها صيغة مصدر البيانات هذه.
`getDataSource()`	`DataSource`	الحصول على مصدر البيانات المرتبط بالكائن.
`getDisplayValue()`	`String`	تعرض القيمة المعروضة لصيغة مصدر البيانات.
`getFormula()`	`String`	تعرض الصيغة لصيغة مصدر البيانات هذه.
`getStatus()`	`DataExecutionStatus`	للحصول على حالة تنفيذ البيانات للكائن.
`refreshData()`	`DataSourceFormula`	يُعيد تحميل بيانات العنصر.
`setFormula(formula)`	`DataSourceFormula`	لتعديل الصيغة
`waitForCompletion(timeoutInSeconds)`	`DataExecutionStatus`	للانتظار حتى اكتمال عملية التنفيذ الحالية، تنتهي المهلة بعد عدد الثواني المحدد.

الوثائق التفصيلية

`forceRefreshData()`

يُعيد تحميل بيانات هذا العنصر بغض النظر عن الحالة الحالية. يمكنك الاطّلاع على refreshData() لمزيد من التفاصيل.

ينشئ استثناء إذا لم يكن نوع مصدر البيانات مفعَّلاً. استخدِم طرق SpreadsheetApp#enable...Execution() لتفعيل تنفيذ البيانات لنوع معيّن من مصدر البيانات.

استرجاع الكرة

DataSourceFormula: كائن البيانات

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getAnchorCell()`

تعرض Range التي تمثل الخلية التي ترتكز فيها صيغة مصدر البيانات هذه.

استرجاع الكرة

Range - خلية الارتساء

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSource()`

الحصول على مصدر البيانات المرتبط بالكائن.

استرجاع الكرة

DataSource: مصدر البيانات

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDisplayValue()`

تعرض القيمة المعروضة لصيغة مصدر البيانات.

استرجاع الكرة

String — قيمة العرض

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormula()`

تعرض الصيغة لصيغة مصدر البيانات هذه.

استرجاع الكرة

String — الصيغة.

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getStatus()`

للحصول على حالة تنفيذ البيانات للكائن.

استرجاع الكرة

DataExecutionStatus — حالة تنفيذ البيانات

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshData()`

يُعيد تحميل بيانات العنصر.

يضع استثناءً إذا كان في حالة error حاليًا. استخدِم DataSource#updateSpec() لتعديل المواصفات. ويُفضَّل استخدام الطريقة على forceRefreshData() لمنع التعديلات غير المتوقّعة على مصدر البيانات.

استرجاع الكرة

DataSourceFormula: كائن البيانات

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFormula(formula)`

لتعديل الصيغة

المَعلمات

الاسم	Type	الوصف
`formula`	`String`	الصيغة الجديدة.

استرجاع الكرة

DataSourceFormula: صيغة مصدر البيانات للسلاسل.

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForCompletion(timeoutInSeconds)`

للانتظار حتى اكتمال عملية التنفيذ الحالية، تنتهي المهلة بعد عدد الثواني المحدد. توفّر استثناءً إذا لم تكتمل عملية التنفيذ عند انتهاء المهلة، ولكنها لا تُلغي تنفيذ البيانات.

المَعلمات

الاسم	Type	الوصف
`timeoutInSeconds`	`Integer`	وقت انتظار تنفيذ البيانات بالثواني. الحدّ الأقصى هو 300 ثانية.

استرجاع الكرة

DataExecutionStatus — حالة تنفيذ البيانات

التفويض

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

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets